@adobe/data-gpu 0.9.69

package/dist/graphics/rendering/skinning/skinning-plugin.js

@@ -0,0 +1,207 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database, Entity } from "@adobe/data/ecs";
+import { Mat4x4 } from "@adobe/data/math";
+import { modelLoader } from "../../scene/model/model-loader-plugin.js";
+import { pbrCore } from "../pbr-core-plugin.js";
+import { transform } from "../../scene/node/transform-plugin.js";
+import { animation } from "../../animation/animation-plugin.js";
+/**
+ * pbrSkinning
+ *   query: Model+geometry, _Skeleton
+ *   read:
+ *     geometry
+ *     _skinJointTemplate          (from Geometry)
+ *     _skinInverseBindMatrices    (from Geometry)
+ *     _animationClipRefs          (from Geometry)
+ *     _worldMatrix                (from Model + joint Nodes)
+ *   write:
+ *     _Skeleton                   // new ephemeral entity, one per skinned Model
+ *     Node                        // joint entities (TRS hierarchy)
+ *     Animation                   // optional, when geometry has clips
+ *     _skeletonInstanceBuffer
+ *     _skeletonJointMatrixBuffer
+ *     _skeletonJointMatrixBindGroup
+ */
+export const pbrSkinning = Database.Plugin.create({
+    extends: Database.Plugin.combine(modelLoader, pbrCore, transform, animation),
+    components: {
+        _skeletonJoints: { default: [] },
+        _skeletonGeometry: Entity.schema,
+        /** 64 bytes — the Model's world matrix, refreshed each frame. */
+        _skeletonInstanceBuffer: { default: null },
+        /** N × 64 bytes — joint skinning matrices, refreshed each frame. */
+        _skeletonJointMatrixBuffer: { default: null },
+    },
+    archetypes: {
+        _Skeleton: [
+            "_skeletonJoints",
+            "_skeletonGeometry",
+            "_skeletonModelRef",
+            "_skeletonInstanceBuffer",
+            "_skeletonJointMatrixBuffer",
+            "_skeletonJointMatrixBindGroup",
+        ],
+    },
+    transactions: {
+        initSkeleton(t, args) {
+            const jointIds = new Array(args.jointTemplate.length);
+            // jointTemplate is in glTF skin.joints[] order. Parents can come
+            // after children in glTF, so resolve parent entity ids in two passes:
+            // first insert with parent=0, then update each joint's parent.
+            for (let i = 0; i < args.jointTemplate.length; i++) {
+                const j = args.jointTemplate[i];
+                jointIds[i] = t.archetypes.Node.insert({
+                    position: j.position,
+                    rotation: j.rotation,
+                    scale: j.scale,
+                    visible: true,
+                    parent: 0,
+                });
+            }
+            for (let i = 0; i < args.jointTemplate.length; i++) {
+                const parentJoint = args.jointTemplate[i].parentJointIndex;
+                const parentId = parentJoint >= 0 ? jointIds[parentJoint] : args.modelRef;
+                t.update(jointIds[i], { parent: parentId });
+            }
+            t.archetypes._Skeleton.insert({
+                _skeletonJoints: jointIds,
+                _skeletonGeometry: args.geometryRef,
+                _skeletonModelRef: args.modelRef,
+                _skeletonInstanceBuffer: args.instanceBuffer,
+                _skeletonJointMatrixBuffer: args.jointMatrixBuffer,
+                _skeletonJointMatrixBindGroup: args.jointMatrixBindGroup,
+            });
+            if (args.clipRef !== null) {
+                t.archetypes.Animation.insert({
+                    animationClipRef: args.clipRef,
+                    animationTargets: jointIds,
+                    animationTime: 0,
+                    animationSpeed: 1,
+                    animationLoop: true,
+                    animationPlaying: true,
+                });
+            }
+        },
+    },
+    systems: {
+        skinningInitSystem: {
+            create: db => {
+                const initialized = new Set();
+                let layoutCache = null;
+                return () => {
+                    const { device } = db.store.resources;
+                    if (!device)
+                        return;
+                    if (!layoutCache) {
+                        layoutCache = device.createBindGroupLayout({
+                            entries: [
+                                { binding: 0, visibility: GPUShaderStage.VERTEX, buffer: { type: "read-only-storage" } },
+                                { binding: 1, visibility: GPUShaderStage.VERTEX, buffer: { type: "read-only-storage" } },
+                            ],
+                        });
+                    }
+                    for (const arch of db.store.queryArchetypes(["geometry"])) {
+                        const ids = arch.columns.id;
+                        const geoRefs = arch.columns.geometry;
+                        for (let i = 0; i < arch.rowCount; i++) {
+                            const modelId = ids.get(i);
+                            if (initialized.has(modelId))
+                                continue;
+                            const geoId = geoRefs.get(i);
+                            const geo = db.store.read(geoId);
+                            const template = geo?._skinJointTemplate;
+                            if (!template || template.length === 0)
+                                continue;
+                            initialized.add(modelId);
+                            const instanceBuffer = device.createBuffer({
+                                size: 64,
+                                usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+                            });
+                            const matrixBuffer = device.createBuffer({
+                                size: template.length * 64,
+                                usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+                            });
+                            const matrixBindGroup = device.createBindGroup({
+                                layout: layoutCache,
+                                entries: [
+                                    { binding: 0, resource: { buffer: instanceBuffer } },
+                                    { binding: 1, resource: { buffer: matrixBuffer } },
+                                ],
+                            });
+                            db.transactions.initSkeleton({
+                                modelRef: modelId,
+                                geometryRef: geoId,
+                                jointTemplate: template,
+                                instanceBuffer,
+                                jointMatrixBuffer: matrixBuffer,
+                                jointMatrixBindGroup: matrixBindGroup,
+                                clipRef: geo?._animationClipRefs?.[0] ?? null,
+                            });
+                        }
+                    }
+                };
+            },
+            schedule: { during: ["preUpdate"] },
+        },
+        skinningMatrixSystem: {
+            create: db => {
+                let scratch = new Float32Array(0);
+                return () => {
+                    const { device } = db.store.resources;
+                    if (!device)
+                        return;
+                    for (const arch of db.store.queryArchetypes([
+                        "_skeletonJoints",
+                        "_skeletonGeometry",
+                        "_skeletonModelRef",
+                        "_skeletonInstanceBuffer",
+                        "_skeletonJointMatrixBuffer",
+                    ])) {
+                        const jointsCol = arch.columns._skeletonJoints;
+                        const geoCol = arch.columns._skeletonGeometry;
+                        const modelCol = arch.columns._skeletonModelRef;
+                        const instBufCol = arch.columns._skeletonInstanceBuffer;
+                        const bufCol = arch.columns._skeletonJointMatrixBuffer;
+                        for (let i = 0; i < arch.rowCount; i++) {
+                            const joints = jointsCol.get(i);
+                            const geoId = geoCol.get(i);
+                            const modelId = modelCol.get(i);
+                            const instanceBuffer = instBufCol.get(i);
+                            const buffer = bufCol.get(i);
+                            if (!buffer || !instanceBuffer)
+                                continue;
+                            const ibm = db.store.get(geoId, "_skinInverseBindMatrices");
+                            if (!ibm)
+                                continue;
+                            const modelWorld = db.store.get(modelId, "_worldMatrix");
+                            if (!modelWorld)
+                                continue;
+                            // The vertex shader's `instances[0]` slot.
+                            device.queue.writeBuffer(instanceBuffer, 0, new Float32Array(modelWorld));
+                            const invModelWorld = Mat4x4.inverse(modelWorld);
+                            if (scratch.length < joints.length * 16) {
+                                scratch = new Float32Array(joints.length * 16);
+                            }
+                            for (let j = 0; j < joints.length; j++) {
+                                const jw = db.store.get(joints[j], "_worldMatrix") ?? Mat4x4.identity;
+                                // inverse(modelWorld) × jointWorld × IBM — leaves vertices in
+                                // model-local space; vertex shader applies modelWorld separately.
+                                const ibmJoint = [
+                                    ibm[j * 16 + 0], ibm[j * 16 + 1], ibm[j * 16 + 2], ibm[j * 16 + 3],
+                                    ibm[j * 16 + 4], ibm[j * 16 + 5], ibm[j * 16 + 6], ibm[j * 16 + 7],
+                                    ibm[j * 16 + 8], ibm[j * 16 + 9], ibm[j * 16 + 10], ibm[j * 16 + 11],
+                                    ibm[j * 16 + 12], ibm[j * 16 + 13], ibm[j * 16 + 14], ibm[j * 16 + 15],
+                                ];
+                                const m = Mat4x4.multiply(Mat4x4.multiply(invModelWorld, jw), ibmJoint);
+                                scratch.set(m, j * 16);
+                            }
+                            device.queue.writeBuffer(buffer, 0, scratch, 0, joints.length * 16);
+                        }
+                    }
+                };
+            },
+            schedule: { during: ["preRender"], after: ["transformSystem"] },
+        },
+    },
+});
+//# sourceMappingURL=skinning-plugin.js.map

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

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

package/dist/graphics/rendering/standard-vertex/layout.d.ts

@@ -0,0 +1,2 @@
+export declare const layout: GPUVertexBufferLayout;
+export declare const stride: number;

package/dist/graphics/rendering/standard-vertex/layout.js

@@ -0,0 +1,16 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { getStructLayout } from "@adobe/data/typed-buffer";
+import { schema } from "./schema.js";
+const sl = getStructLayout(schema);
+export const layout = {
+    arrayStride: sl.size,
+    stepMode: "vertex",
+    attributes: [
+        { format: "float32x3", offset: sl.fields["position"].offset, shaderLocation: 0 },
+        { format: "float32x3", offset: sl.fields["normal"].offset, shaderLocation: 1 },
+        { format: "float32x4", offset: sl.fields["tangent"].offset, shaderLocation: 2 },
+        { format: "float32x2", offset: sl.fields["uv"].offset, shaderLocation: 3 },
+    ],
+};
+export const stride = sl.size;
+//# sourceMappingURL=layout.js.map

package/dist/graphics/rendering/standard-vertex/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/standard-vertex/layout.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAEnC,MAAM,CAAC,MAAM,MAAM,GAA0B;IACzC,WAAW,EAAE,EAAE,CAAC,IAAI;IACpB,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE;QACR,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAE,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE;QACjF,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAE,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE;QAC/E,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAE,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE;QAChF,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAE,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE;KAC9E;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC"}

package/dist/graphics/rendering/standard-vertex/public.d.ts

@@ -0,0 +1,2 @@
+export * from "./schema.js";
+export * from "./layout.js";

package/dist/graphics/rendering/standard-vertex/public.js

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

package/dist/graphics/rendering/standard-vertex/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/standard-vertex/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/graphics/rendering/standard-vertex/schema.d.ts

@@ -0,0 +1,52 @@
+export declare const schema: {
+    readonly type: "object";
+    readonly properties: {
+        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 normal: {
+            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 tangent: {
+            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, 0];
+        };
+        readonly uv: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 2;
+            readonly maxItems: 2;
+            readonly default: readonly [0, 0];
+        };
+    };
+    readonly required: readonly ["position", "normal", "tangent", "uv"];
+    readonly additionalProperties: false;
+    readonly layout: "packed";
+};

package/dist/graphics/rendering/standard-vertex/schema.js

@@ -0,0 +1,15 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Vec2, Vec3, Vec4 } from "@adobe/data/math";
+export const schema = {
+    type: "object",
+    properties: {
+        position: Vec3.schema,
+        normal: Vec3.schema,
+        tangent: Vec4.schema,
+        uv: Vec2.schema,
+    },
+    required: ["position", "normal", "tangent", "uv"],
+    additionalProperties: false,
+    layout: "packed",
+};
+//# sourceMappingURL=schema.js.map

package/dist/graphics/rendering/standard-vertex/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/standard-vertex/schema.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,MAAM;QACpB,EAAE,EAAE,IAAI,CAAC,MAAM;KAClB;IACD,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC;IACjD,oBAAoB,EAAE,KAAK;IAC3B,MAAM,EAAE,QAAQ;CACO,CAAC"}

package/dist/graphics/rendering/standard-vertex/standard-vertex.d.ts

@@ -0,0 +1,4 @@
+import { Schema } from "@adobe/data/schema";
+import { schema } from "./schema.js";
+export type StandardVertex = Schema.ToType<typeof schema>;
+export * as StandardVertex from "./public.js";

package/dist/graphics/rendering/standard-vertex/standard-vertex.js

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

package/dist/graphics/rendering/standard-vertex/standard-vertex.js.map

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

package/dist/graphics/rendering/visible-material/color-material-options.d.ts

@@ -0,0 +1,7 @@
+import type { Vec3 } from "@adobe/data/math";
+export interface ColorMaterialOptions {
+    color: readonly [number, number, number, number];
+    emissive?: Vec3;
+    metallic?: number;
+    roughness?: number;
+}

package/dist/graphics/rendering/visible-material/color-material-options.js

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

package/dist/graphics/rendering/visible-material/color-material-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-material-options.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/visible-material/color-material-options.ts"],"names":[],"mappings":"AAAA,uDAAuD"}

package/dist/graphics/rendering/visible-material/create-bind-group-layout.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Bind group layout for a visible (PBR-style) material: a uniform buffer
+ * with the material factors, five 2D textures (baseColor, metallicRoughness,
+ * normal, occlusion, emissive), and a filtering sampler. Stable across
+ * renderer pipeline creation and the bind-group builders in `_modelLoader`
+ * and `VisibleMaterial.createColorBindGroup`.
+ */
+export declare function createBindGroupLayout(device: GPUDevice): GPUBindGroupLayout;

package/dist/graphics/rendering/visible-material/create-bind-group-layout.js

@@ -0,0 +1,35 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * Bind group layout for a visible (PBR-style) material: a uniform buffer
+ * with the material factors, five 2D textures (baseColor, metallicRoughness,
+ * normal, occlusion, emissive), and a filtering sampler. Stable across
+ * renderer pipeline creation and the bind-group builders in `_modelLoader`
+ * and `VisibleMaterial.createColorBindGroup`.
+ */
+export function createBindGroupLayout(device) {
+    const textureEntry = (binding) => ({
+        binding,
+        visibility: GPUShaderStage.FRAGMENT,
+        texture: { sampleType: "float", viewDimension: "2d" },
+    });
+    return device.createBindGroupLayout({
+        entries: [
+            {
+                binding: 0,
+                visibility: GPUShaderStage.FRAGMENT,
+                buffer: { type: "uniform" },
+            },
+            textureEntry(1),
+            textureEntry(2),
+            textureEntry(3),
+            textureEntry(4),
+            textureEntry(5),
+            {
+                binding: 6,
+                visibility: GPUShaderStage.FRAGMENT,
+                sampler: { type: "filtering" },
+            },
+        ],
+    });
+}
+//# sourceMappingURL=create-bind-group-layout.js.map

package/dist/graphics/rendering/visible-material/create-bind-group-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bind-group-layout.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/visible-material/create-bind-group-layout.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACnD,MAAM,YAAY,GAAG,CAAC,OAAe,EAA2B,EAAE,CAAC,CAAC;QAChE,OAAO;QACP,UAAU,EAAE,cAAc,CAAC,QAAQ;QACnC,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE;KACxD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,qBAAqB,CAAC;QAChC,OAAO,EAAE;YACL;gBACI,OAAO,EAAE,CAAC;gBACV,UAAU,EAAE,cAAc,CAAC,QAAQ;gBACnC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAC9B;YACD,YAAY,CAAC,CAAC,CAAC;YACf,YAAY,CAAC,CAAC,CAAC;YACf,YAAY,CAAC,CAAC,CAAC;YACf,YAAY,CAAC,CAAC,CAAC;YACf,YAAY,CAAC,CAAC,CAAC;YACf;gBACI,OAAO,EAAE,CAAC;gBACV,UAAU,EAAE,cAAc,CAAC,QAAQ;gBACnC,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;aACjC;SACJ;KACJ,CAAC,CAAC;AACP,CAAC"}

package/dist/graphics/rendering/visible-material/create-color-bind-group.d.ts

@@ -0,0 +1,10 @@
+import type { ColorMaterialOptions } from "./color-material-options.js";
+/**
+ * Builds a PBR material bind group from a flat color spec. The layout,
+ * sampler, and fallback textures are cached per-device, so calling this
+ * once per sphere/cube is cheap.
+ *
+ * The returned bind group is layout-compatible with the standard PBR
+ * pipeline (same layout structure as glTF-loaded materials).
+ */
+export declare function createColorBindGroup(device: GPUDevice, options: ColorMaterialOptions): GPUBindGroup;

package/dist/graphics/rendering/visible-material/create-color-bind-group.js

@@ -0,0 +1,26 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { createBindGroupLayout } from "./create-bind-group-layout.js";
+import { createColorMaterial } from "../../scene/model/gltf/create-color-material.js";
+import { createFallbackTextures } from "../../scene/model/gltf/decode-images.js";
+const cacheByDevice = new WeakMap();
+/**
+ * Builds a PBR material bind group from a flat color spec. The layout,
+ * sampler, and fallback textures are cached per-device, so calling this
+ * once per sphere/cube is cheap.
+ *
+ * The returned bind group is layout-compatible with the standard PBR
+ * pipeline (same layout structure as glTF-loaded materials).
+ */
+export function createColorBindGroup(device, options) {
+    let cache = cacheByDevice.get(device);
+    if (!cache) {
+        cache = {
+            layout: createBindGroupLayout(device),
+            sampler: device.createSampler({ magFilter: "linear", minFilter: "linear", mipmapFilter: "linear" }),
+            fallback: createFallbackTextures(device),
+        };
+        cacheByDevice.set(device, cache);
+    }
+    return createColorMaterial(device, cache.layout, cache.sampler, cache.fallback, options);
+}
+//# sourceMappingURL=create-color-bind-group.js.map

package/dist/graphics/rendering/visible-material/create-color-bind-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-color-bind-group.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/visible-material/create-color-bind-group.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AASjF,MAAM,aAAa,GAAG,IAAI,OAAO,EAA0B,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAChC,MAAiB,EACjB,OAA6B;IAE7B,IAAI,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,KAAK,GAAG;YACJ,MAAM,EAAI,qBAAqB,CAAC,MAAM,CAAC;YACvC,OAAO,EAAG,MAAM,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;YACpG,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC;SAC3C,CAAC;QACF,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC7F,CAAC"}

package/dist/graphics/rendering/visible-material/public.d.ts

@@ -0,0 +1,4 @@
+export * from "./schema.js";
+export { createBindGroupLayout } from "./create-bind-group-layout.js";
+export { createColorBindGroup } from "./create-color-bind-group.js";
+export type { ColorMaterialOptions } from "./color-material-options.js";

package/dist/graphics/rendering/visible-material/public.js

@@ -0,0 +1,5 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export * from "./schema.js";
+export { createBindGroupLayout } from "./create-bind-group-layout.js";
+export { createColorBindGroup } from "./create-color-bind-group.js";
+//# sourceMappingURL=public.js.map

package/dist/graphics/rendering/visible-material/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/visible-material/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/graphics/rendering/visible-material/schema.d.ts

@@ -0,0 +1,49 @@
+export declare const schema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly baseColorFactor: {
+            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, 0];
+        };
+        readonly emissiveFactor: {
+            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 metallicFactor: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly roughnessFactor: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly normalScale: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly occlusionStrength: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+    };
+    readonly required: readonly ["baseColorFactor", "emissiveFactor", "metallicFactor", "roughnessFactor", "normalScale", "occlusionStrength"];
+    readonly additionalProperties: false;
+};

package/dist/graphics/rendering/visible-material/schema.js

@@ -0,0 +1,23 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { F32, Vec3, Vec4 } from "@adobe/data/math";
+export const schema = {
+    type: "object",
+    properties: {
+        baseColorFactor: Vec4.schema,
+        emissiveFactor: Vec3.schema,
+        metallicFactor: F32.schema,
+        roughnessFactor: F32.schema,
+        normalScale: F32.schema,
+        occlusionStrength: F32.schema,
+    },
+    required: [
+        "baseColorFactor",
+        "emissiveFactor",
+        "metallicFactor",
+        "roughnessFactor",
+        "normalScale",
+        "occlusionStrength",
+    ],
+    additionalProperties: false,
+};
+//# sourceMappingURL=schema.js.map

package/dist/graphics/rendering/visible-material/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/visible-material/schema.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGnD,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,eAAe,EAAE,IAAI,CAAC,MAAM;QAC5B,cAAc,EAAE,IAAI,CAAC,MAAM;QAC3B,cAAc,EAAE,GAAG,CAAC,MAAM;QAC1B,eAAe,EAAE,GAAG,CAAC,MAAM;QAC3B,WAAW,EAAE,GAAG,CAAC,MAAM;QACvB,iBAAiB,EAAE,GAAG,CAAC,MAAM;KAChC;IACD,QAAQ,EAAE;QACN,iBAAiB;QACjB,gBAAgB;QAChB,gBAAgB;QAChB,iBAAiB;QACjB,aAAa;QACb,mBAAmB;KACtB;IACD,oBAAoB,EAAE,KAAK;CACJ,CAAC"}

package/dist/graphics/rendering/visible-material/visible-material.d.ts

@@ -0,0 +1,4 @@
+import { Schema } from "@adobe/data/schema";
+import { schema } from "./schema.js";
+export type VisibleMaterial = Schema.ToType<typeof schema>;
+export * as VisibleMaterial from "./public.js";

package/dist/graphics/rendering/visible-material/visible-material.js

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

package/dist/graphics/rendering/visible-material/visible-material.js.map

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

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

@@ -0,0 +1,30 @@
+import type { Light } from "./light.js";
+/**
+ * Authored lighting state — a directional light plus optional image-based
+ * lighting from an HDR environment.
+ *
+ * The `sceneUniforms` system packs these into the GPU uniform buffer the
+ * renderers consume; the `iblInitSystem` fetches and bakes the IBL textures
+ * from `light.environmentUrl`.
+ */
+export declare const light: {
+    readonly components: {};
+    readonly resources: {
+        readonly light: {
+            readonly default: Light;
+        };
+    };
+    readonly archetypes: {};
+    readonly transactions: {
+        readonly setLight: (t: import("@adobe/data/ecs").TransactionContext<import("@adobe/data/schema").FromSchemas<{}>, import("@adobe/data/schema").FromSchemas<{
+            readonly light: {
+                readonly default: Light;
+            };
+        }>, {}, {}>, args: Partial<Light>) => void;
+    };
+    readonly systems: import("@adobe/data/ecs").SystemDeclarations<never>;
+    readonly actions: {};
+    readonly services: {};
+    readonly computed: {};
+    readonly indexes: {};
+};

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

@@ -0,0 +1,35 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { Vec3 } from "@adobe/data/math";
+/**
+ * Authored lighting state — a directional light plus optional image-based
+ * lighting from an HDR environment.
+ *
+ * The `sceneUniforms` system packs these into the GPU uniform buffer the
+ * renderers consume; the `iblInitSystem` fetches and bakes the IBL textures
+ * from `light.environmentUrl`.
+ */
+export const light = Database.Plugin.create({
+    resources: {
+        light: {
+            default: {
+                direction: Vec3.normalize([-1, -3, -10]),
+                color: [1.0, 1.0, 1.0],
+                ambientStrength: 0.5,
+                environmentUrl: null,
+            },
+        },
+    },
+    transactions: {
+        setLight(t, args) {
+            const cur = t.resources.light;
+            t.resources.light = {
+                direction: args.direction !== undefined ? Vec3.normalize(args.direction) : cur.direction,
+                color: args.color ?? cur.color,
+                ambientStrength: args.ambientStrength ?? cur.ambientStrength,
+                environmentUrl: args.environmentUrl !== undefined ? args.environmentUrl : cur.environmentUrl,
+            };
+        },
+    },
+});
+//# sourceMappingURL=light-plugin.js.map