@adobe/data-gpu 0.9.69

package/dist/graphics/scene/model/model-loader-plugin.js

@@ -0,0 +1,120 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { pbrCore } from "../../rendering/pbr-core-plugin.js";
+import { animation } from "../../animation/animation-plugin.js";
+import { core } from "../../../core/core-plugin.js";
+import { Model } from "./model.js";
+import { loadGltfPrimitives } from "./gltf/load-gltf-model.js";
+/**
+ * modelLoader
+ *   query: Geometry-_bounds
+ *   read:
+ *     modelUrl
+ *   write:
+ *     _bounds: Aabb
+ *     _skinJointTemplate: JointTemplate[]
+ *     _skinInverseBindMatrices: Float32Array | null
+ *     _animationClipRefs: EntityId[]
+ *     _VisibleMaterial
+ *     _PbrPrimitive
+ *     AnimationClip                       // when the glTF carries animations
+ */
+export const modelLoader = Database.Plugin.create({
+    extends: Database.Plugin.combine(pbrCore, Model.plugin, core, animation),
+    components: {
+        _bounds: { default: null },
+        _skinJointTemplate: { default: [] },
+        _skinInverseBindMatrices: { default: null },
+        _animationClipRefs: { default: [] },
+        // CPU-retained model-space collision geometry (auto-collider source).
+        _cpuPositions: { default: null },
+        _cpuIndices: { default: null },
+        // CPU-retained skin (mesh-bind positions + 4 joints + 4 weights per vertex),
+        // for fitting per-bone ragdoll capsules.
+        _cpuSkin: { default: null },
+    },
+    transactions: {
+        insertLoadedPrimitives(t, args) {
+            for (const p of args.primitives) {
+                const materialId = t.archetypes._VisibleMaterial.insert({
+                    ephemeral: true,
+                    _materialBindGroup: p.pbrMaterialBindGroup,
+                    _geometry: args.geometry,
+                });
+                t.archetypes._PbrPrimitive.insert({
+                    ephemeral: true,
+                    _geometry: args.geometry,
+                    _material: materialId,
+                    _vertexBuffer: p.pbrVertexBuffer,
+                    _skinVertexBuffer: p.pbrSkinVertexBuffer,
+                    _indexBuffer: p.pbrIndexBuffer,
+                    _indexCount: p.pbrIndexCount,
+                    _indexFormat: p.pbrIndexFormat,
+                    _nodeLocalMatrix: p.pbrNodeLocalMatrix,
+                });
+            }
+            const clipRefs = [];
+            for (const anim of args.animations) {
+                if (anim.tracks.length === 0)
+                    continue;
+                const clipId = t.archetypes.AnimationClip.insert({
+                    animationClipTracks: anim.tracks,
+                    animationClipDuration: anim.duration,
+                });
+                clipRefs.push(clipId);
+            }
+            t.update(args.geometry, {
+                _bounds: args.bounds,
+                _skinJointTemplate: args.skinJointTemplate,
+                _skinInverseBindMatrices: args.skinInverseBindMatrices,
+                _animationClipRefs: clipRefs,
+                _cpuPositions: args.collision?.positions ?? null,
+                _cpuIndices: args.collision?.indices ?? null,
+                _cpuSkin: args.skinVertices,
+            });
+        },
+    },
+    systems: {
+        modelLoadSystem: {
+            create: db => {
+                const inFlight = new Set();
+                return () => {
+                    const { device } = db.store.resources;
+                    if (!device)
+                        return;
+                    for (const arch of db.store.queryArchetypes(["modelUrl"])) {
+                        const ids = arch.columns.id;
+                        const urls = arch.columns.modelUrl;
+                        for (let i = 0; i < arch.rowCount; i++) {
+                            const id = ids.get(i);
+                            if (inFlight.has(id))
+                                continue;
+                            const url = urls.get(i);
+                            if (!url)
+                                continue; // procedural geometries (shapes) carry no URL
+                            inFlight.add(id);
+                            loadGltfPrimitives(device, url)
+                                .then(loaded => {
+                                db.transactions.insertLoadedPrimitives({
+                                    geometry: id,
+                                    bounds: loaded.bounds,
+                                    primitives: loaded.primitives,
+                                    skinJointTemplate: loaded.skin?.jointTemplate ?? [],
+                                    skinInverseBindMatrices: loaded.skin?.inverseBindMatrices ?? null,
+                                    animations: loaded.animations,
+                                    collision: loaded.collision,
+                                    skinVertices: loaded.skinVertices,
+                                });
+                            })
+                                .catch(err => {
+                                console.error("[modelLoader] Failed to load model", urls.get(i), err);
+                            });
+                        }
+                    }
+                };
+            },
+            schedule: { during: ["preUpdate"] },
+        },
+    },
+});
+//# sourceMappingURL=model-loader-plugin.js.map

package/dist/graphics/scene/model/model-loader-plugin.js.map

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

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

@@ -0,0 +1,352 @@
+import { Quat, type Vec3 } from "@adobe/data/math";
+/**
+ * Authored renderable scene. A `Geometry` is an asset identified by URL; a
+ * `Model` is a placed instance of a Geometry — a Node plus a reference to
+ * the Geometry it draws.
+ *
+ * Loading is performed by `modelLoader`, which reads the `modelUrl` and
+ * produces the GPU primitives the renderers consume.
+ */
+export declare const model: {
+    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 resources: {};
+    readonly archetypes: {
+        readonly Node: readonly ["position", "rotation", "scale", "parent", "visible"];
+    } & {} & {
+        readonly Geometry: readonly ["modelUrl"];
+        readonly Model: readonly ["geometry", "position", "rotation", "scale", "visible", "parent"];
+    };
+    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?: Vec3;
+            rotation?: Quat;
+            scale?: Vec3;
+            parent?: number;
+        }) => number;
+    };
+    readonly systems: import("@adobe/data/ecs").SystemDeclarations<"transformCreateWorldMatrix" | "transformSystem">;
+    readonly actions: {};
+    readonly services: {};
+    readonly computed: {};
+    readonly indexes: {} & {} & {};
+};

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

@@ -0,0 +1,39 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database, Entity } from "@adobe/data/ecs";
+import { Quat } from "@adobe/data/math";
+import { Node } from "../node/node.js";
+/**
+ * Authored renderable scene. A `Geometry` is an asset identified by URL; a
+ * `Model` is a placed instance of a Geometry — a Node plus a reference to
+ * the Geometry it draws.
+ *
+ * Loading is performed by `modelLoader`, which reads the `modelUrl` and
+ * produces the GPU primitives the renderers consume.
+ */
+export const model = Database.Plugin.create({
+    extends: Node.plugin,
+    components: {
+        modelUrl: { type: "string" },
+        geometry: Entity.schema,
+    },
+    archetypes: {
+        Geometry: ["modelUrl"],
+        Model: ["geometry", "position", "rotation", "scale", "visible", "parent"],
+    },
+    transactions: {
+        insertGeometry(t, args) {
+            return t.archetypes.Geometry.insert({ modelUrl: args.modelUrl });
+        },
+        insertModel(t, args) {
+            return t.archetypes.Model.insert({
+                geometry: args.geometry,
+                position: args.position ?? [0, 0, 0],
+                rotation: args.rotation ?? Quat.identity,
+                scale: args.scale ?? [1, 1, 1],
+                visible: true,
+                parent: args.parent ?? 0,
+            });
+        },
+    },
+});
+//# sourceMappingURL=model-plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-plugin.js","sourceRoot":"","sources":["../../../../src/graphics/scene/model/model-plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAa,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,IAAI,CAAC,MAAM;IACpB,UAAU,EAAE;QACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM;KAC1B;IACD,UAAU,EAAE;QACR,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,KAAK,EAAK,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC;KAC/E;IACD,YAAY,EAAE;QACV,cAAc,CAAC,CAAC,EAAE,IAA0B;YACxC,OAAO,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,WAAW,CAAC,CAAC,EAAE,IAMd;YACG,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;gBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACpC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ;gBACxC,KAAK,EAAK,IAAI,CAAC,KAAK,IAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACpC,OAAO,EAAG,IAAI;gBACd,MAAM,EAAI,IAAI,CAAC,MAAM,IAAM,CAAC;aAC/B,CAAC,CAAC;QACP,CAAC;KACJ;CACJ,CAAC,CAAC"}

package/dist/graphics/scene/model/model.d.ts

@@ -0,0 +1,11 @@
+import type { Entity } from "@adobe/data/ecs";
+import type { Node } from "../node/node.js";
+/**
+ * One row of the `Model` archetype — a placed instance of a Geometry. A
+ * Node (transform + visibility + parent) plus a reference to the Geometry
+ * the renderer should draw.
+ */
+export interface Model extends Node {
+    geometry: Entity;
+}
+export * as Model from "./public.js";

package/dist/graphics/scene/model/model.js

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

package/dist/graphics/scene/model/model.js.map

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

package/dist/graphics/scene/model/public.d.ts

@@ -0,0 +1 @@
+export { model as plugin } from "./model-plugin.js";

package/dist/graphics/scene/model/public.js

@@ -0,0 +1,2 @@
+export { model as plugin } from "./model-plugin.js";
+//# sourceMappingURL=public.js.map

package/dist/graphics/scene/model/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../../src/graphics/scene/model/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/graphics/scene/model/shape/convex-hull.d.ts

@@ -0,0 +1,36 @@
+import type { ShapeMesh } from "./shape-mesh.js";
+/**
+ * Faceted render mesh of the convex hull of a point cloud (flat per-face normals,
+ * StandardVertex layout). A convex collider is *authored* as a point cloud — the
+ * physics engine builds the collision hull from the same points — but rendering
+ * needs a triangulated surface, which this computes. Phase-2 auto-hull (hull of a
+ * render mesh's vertices) reuses it.
+ *
+ * Incremental 3D hull: seed a tetrahedron, then fold each remaining point in by
+ * deleting the faces it can see and bridging the horizon to it. Every face's
+ * normal is oriented away from a fixed interior point (the seed centroid, always
+ * strictly inside a convex hull) — so orientation is robust without half-edge
+ * bookkeeping. Authored hulls are small (tens of points), so the simple O(n·f)
+ * form is plenty fast. Degenerate input (< 4 points or coplanar) → empty mesh.
+ */
+interface Face {
+    a: number;
+    b: number;
+    c: number;
+    nx: number;
+    ny: number;
+    nz: number;
+}
+export declare function convexHullMesh(points: Float32Array): ShapeMesh;
+/**
+ * The deduplicated hull vertices (the extreme points) of a cloud — a minimal
+ * point set whose convex hull equals the cloud's. Used to feed a physics engine's
+ * convex-hull builder a *simplified* collider from a detailed mesh (thousands of
+ * verts → a few dozen). Empty for degenerate input.
+ */
+export declare function hullVertices(points: Float32Array): Float32Array;
+/** The hull's triangular faces, each normal oriented outward, or null if the
+ *  point cloud is degenerate (fewer than 4 points, or all coplanar). Exported
+ *  for tests; rendering goes through {@link convexHullMesh}. */
+export declare function hullFaces(points: Float32Array): Face[] | null;
+export {};