@adobe/data-gpu 0.9.69

package/dist/graphics/scene/model/gltf/load-gltf-model.d.ts

@@ -0,0 +1,42 @@
+import { Mat4x4, type Aabb } from "@adobe/data/math";
+import { type LoadedSkin } from "./parse-skin.js";
+import { type LoadedAnimation } from "./parse-animations.js";
+export interface GpuPrimitiveData {
+    pbrVertexBuffer: GPUBuffer;
+    /** Secondary VBO with skinning attributes (joints u32×4, weights f32×4).
+     *  Null for non-skinned primitives. Drives the renderer's pipeline choice. */
+    pbrSkinVertexBuffer: GPUBuffer | null;
+    pbrIndexBuffer: GPUBuffer;
+    pbrIndexCount: number;
+    pbrIndexFormat: GPUIndexFormat;
+    pbrMaterialBindGroup: GPUBindGroup;
+    /** Node's model-root-local matrix. Renderers pre-multiply this with the
+     *  per-instance model-root world matrix at draw time. Identity for
+     *  single-node and skinned-mesh primitives (skin owns the deformation). */
+    pbrNodeLocalMatrix: Mat4x4;
+}
+export interface LoadedGltfData {
+    primitives: GpuPrimitiveData[];
+    bounds: Aabb;
+    /** Present when the glTF declares a `skins[0]`. */
+    skin: LoadedSkin | null;
+    /** Parsed `animations[]`; jointIndex on each track is into `skin.jointTemplate`. */
+    animations: LoadedAnimation[];
+    /** Model-space collision geometry retained on the CPU for auto-generating
+     *  physics colliders (convex hull / trimesh) — the non-skinned primitives'
+     *  positions (each baked by its node matrix) + indices, aggregated. Null when
+     *  the model has no static geometry (e.g. skin-only). */
+    collision: {
+        positions: Float32Array;
+        indices: Uint32Array;
+    } | null;
+    /** Skinned vertices retained on the CPU (mesh-bind positions + 4 joint
+     *  indices + 4 weights per vertex), for fitting per-bone ragdoll capsules.
+     *  Null for non-skinned models. */
+    skinVertices: {
+        positions: Float32Array;
+        joints: Uint32Array;
+        weights: Float32Array;
+    } | null;
+}
+export declare function loadGltfPrimitives(device: GPUDevice, url: string): Promise<LoadedGltfData>;

package/dist/graphics/scene/model/gltf/load-gltf-model.js

@@ -0,0 +1,175 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Mat4x4 } from "@adobe/data/math";
+import { VisibleMaterial } from "../../../rendering/visible-material/visible-material.js";
+import { readAccessor } from "./accessor-view.js";
+import { buildMaterialBindGroup } from "./build-material-bind-group.js";
+import { computeWorldMatrices } from "./compute-world-matrices.js";
+import { createFallbackTextures, decodeAllImages } from "./decode-images.js";
+import { packPrimitiveVertices } from "./pack-vertex-buffer.js";
+import { parseGlb } from "./parse-glb.js";
+import { parseGltfSkin } from "./parse-skin.js";
+import { parseGltfAnimations } from "./parse-animations.js";
+function expandBounds(m, localMin, localMax, outMin, outMax) {
+    const xs = [localMin[0], localMax[0]];
+    const ys = [localMin[1], localMax[1]];
+    const zs = [localMin[2], localMax[2]];
+    for (const lx of xs)
+        for (const ly of ys)
+            for (const lz of zs) {
+                const wx = m[0] * lx + m[4] * ly + m[8] * lz + m[12];
+                const wy = m[1] * lx + m[5] * ly + m[9] * lz + m[13];
+                const wz = m[2] * lx + m[6] * ly + m[10] * lz + m[14];
+                if (wx < outMin[0])
+                    outMin[0] = wx;
+                if (wx > outMax[0])
+                    outMax[0] = wx;
+                if (wy < outMin[1])
+                    outMin[1] = wy;
+                if (wy > outMax[1])
+                    outMax[1] = wy;
+                if (wz < outMin[2])
+                    outMin[2] = wz;
+                if (wz > outMax[2])
+                    outMax[2] = wz;
+            }
+}
+function pickIndexFormat(raw) {
+    if (raw instanceof Uint32Array)
+        return { indices: raw, format: "uint32" };
+    if (raw instanceof Uint16Array)
+        return { indices: raw, format: "uint16" };
+    if (raw instanceof Uint8Array) {
+        const u16 = new Uint16Array(raw.length);
+        for (let i = 0; i < raw.length; i++)
+            u16[i] = raw[i];
+        return { indices: u16, format: "uint16" };
+    }
+    throw new Error("Index accessor must be an integer type");
+}
+export async function loadGltfPrimitives(device, url) {
+    const response = await fetch(url);
+    if (!response.ok)
+        throw new Error(`Failed to fetch ${url}: ${response.status}`);
+    const buffer = await response.arrayBuffer();
+    const { json, bin } = parseGlb(buffer);
+    const materialLayout = VisibleMaterial.createBindGroupLayout(device);
+    const sourceTextures = await decodeAllImages(device, json, bin);
+    const fallback = createFallbackTextures(device);
+    const sampler = device.createSampler({
+        magFilter: "linear",
+        minFilter: "linear",
+        addressModeU: "repeat",
+        addressModeV: "repeat",
+    });
+    const worldMatrices = computeWorldMatrices(json);
+    const skin = parseGltfSkin(json, bin);
+    const animations = skin ? parseGltfAnimations(json, bin, json.skins[0].joints) : [];
+    const boundsMin = [Infinity, Infinity, Infinity];
+    const boundsMax = [-Infinity, -Infinity, -Infinity];
+    const primitives = [];
+    // CPU-retained collision geometry (model space, non-skinned primitives only).
+    const collPositions = [], collIndices = [];
+    // CPU-retained skin vertices (mesh-bind space, skinned primitives only).
+    const skinPos = [], skinJoints = [], skinWeights = [];
+    for (let nodeIdx = 0; nodeIdx < (json.nodes ?? []).length; nodeIdx++) {
+        const node = json.nodes[nodeIdx];
+        if (node.mesh === undefined)
+            continue;
+        const mesh = json.meshes[node.mesh];
+        // For skinned primitives the joint transforms own the deformation;
+        // the mesh node's own transform must not be baked in. For non-skinned
+        // primitives we pre-bake the node's world matrix as before.
+        const skinned = node.skin !== undefined;
+        const pbrNodeLocalMatrix = skinned ? Mat4x4.identity : worldMatrices[nodeIdx];
+        for (const prim of mesh.primitives) {
+            const packed = packPrimitiveVertices(json, bin, prim);
+            expandBounds(pbrNodeLocalMatrix, packed.boundsMin, packed.boundsMax, boundsMin, boundsMax);
+            const vertexBuffer = device.createBuffer({
+                size: packed.vertices.byteLength,
+                usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+            });
+            device.queue.writeBuffer(vertexBuffer, 0, packed.vertices);
+            let skinVertexBuffer = null;
+            if (packed.skinningAttributes) {
+                skinVertexBuffer = device.createBuffer({
+                    size: packed.skinningAttributes.byteLength,
+                    usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+                });
+                device.queue.writeBuffer(skinVertexBuffer, 0, packed.skinningAttributes);
+            }
+            // Non-indexed primitives are valid in glTF — synthesize sequential indices.
+            let indices;
+            let format;
+            if (prim.indices === undefined) {
+                if (packed.vertexCount <= 0xffff) {
+                    indices = new Uint16Array(packed.vertexCount);
+                    for (let k = 0; k < packed.vertexCount; k++)
+                        indices[k] = k;
+                    format = "uint16";
+                }
+                else {
+                    indices = new Uint32Array(packed.vertexCount);
+                    for (let k = 0; k < packed.vertexCount; k++)
+                        indices[k] = k;
+                    format = "uint32";
+                }
+            }
+            else {
+                const raw = readAccessor(json, bin, prim.indices);
+                ({ indices, format } = pickIndexFormat(raw));
+            }
+            const indexBuffer = device.createBuffer({
+                size: indices.byteLength,
+                usage: GPUBufferUsage.INDEX | GPUBufferUsage.COPY_DST,
+            });
+            device.queue.writeBuffer(indexBuffer, 0, indices);
+            // Retain collision geometry for non-skinned primitives: deinterleave the
+            // positions (stride = floats/vertex, position at offset 0), bake the node
+            // matrix into model space, and append with index offset. Skinned primitives
+            // deform at runtime, so a static collider from their bind pose is meaningless.
+            if (!skinned) {
+                const m = pbrNodeLocalMatrix, verts = packed.vertices;
+                const stride = packed.vertices.length / packed.vertexCount;
+                const vbase = collPositions.length / 3;
+                for (let v = 0; v < packed.vertexCount; v++) {
+                    const o = v * stride, x = verts[o], y = verts[o + 1], z = verts[o + 2];
+                    collPositions.push(m[0] * x + m[4] * y + m[8] * z + m[12], m[1] * x + m[5] * y + m[9] * z + m[13], m[2] * x + m[6] * y + m[10] * z + m[14]);
+                }
+                for (let k = 0; k < indices.length; k++)
+                    collIndices.push(indices[k] + vbase);
+            }
+            else if (packed.skinningAttributes) {
+                // Retain skin vertices (mesh-bind positions + joints/weights) for
+                // fitting per-bone ragdoll capsules. Skinning attributes pack 8 words
+                // per vertex: joints (u32×4) in words 0–3, weights (f32×4) in 4–7.
+                const verts = packed.vertices, stride = packed.vertices.length / packed.vertexCount;
+                const sj = new Uint32Array(packed.skinningAttributes), sw = new Float32Array(packed.skinningAttributes);
+                for (let v = 0; v < packed.vertexCount; v++) {
+                    const o = v * stride, s = v * 8;
+                    skinPos.push(verts[o], verts[o + 1], verts[o + 2]);
+                    skinJoints.push(sj[s], sj[s + 1], sj[s + 2], sj[s + 3]);
+                    skinWeights.push(sw[s + 4], sw[s + 5], sw[s + 6], sw[s + 7]);
+                }
+            }
+            const materialBindGroup = buildMaterialBindGroup(device, json, sourceTextures, fallback, sampler, materialLayout, prim.material);
+            primitives.push({
+                pbrVertexBuffer: vertexBuffer,
+                pbrSkinVertexBuffer: skinVertexBuffer,
+                pbrIndexBuffer: indexBuffer,
+                pbrIndexCount: indices.length,
+                pbrIndexFormat: format,
+                pbrMaterialBindGroup: materialBindGroup,
+                pbrNodeLocalMatrix,
+            });
+        }
+    }
+    return {
+        primitives,
+        bounds: { min: boundsMin, max: boundsMax },
+        skin,
+        animations,
+        collision: collPositions.length ? { positions: new Float32Array(collPositions), indices: new Uint32Array(collIndices) } : null,
+        skinVertices: skinPos.length ? { positions: new Float32Array(skinPos), joints: new Uint32Array(skinJoints), weights: new Float32Array(skinWeights) } : null,
+    };
+}
+//# sourceMappingURL=load-gltf-model.js.map

package/dist/graphics/scene/model/gltf/load-gltf-model.js.map

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

package/dist/graphics/scene/model/gltf/pack-vertex-buffer.d.ts

@@ -0,0 +1,21 @@
+import type { Vec3 } from "@adobe/data/math";
+import type { GltfAsset, GltfPrimitive } from "./gltf-schema.js";
+export interface PackedPrimitive {
+    vertices: Float32Array;
+    /** Packed skinning attributes (uint32×4 joints, float32×4 weights). Null
+     *  for non-skinned primitives. Size = vertexCount × {@link SKINNING_STRIDE}. */
+    skinningAttributes: ArrayBuffer | null;
+    vertexCount: number;
+    boundsMin: Vec3;
+    boundsMax: Vec3;
+}
+/**
+ * Reads POSITION/NORMAL/TANGENT/TEXCOORD_0 from a primitive and interleaves
+ * them into the packed StandardVertex layout (48 bytes / vertex).
+ *
+ * If JOINTS_0 and WEIGHTS_0 are present, also packs them into a separate
+ * skinning attribute buffer with stride {@link SKINNING_STRIDE}.
+ *
+ * Vertices are kept in node-local space — no world transform is applied here.
+ */
+export declare function packPrimitiveVertices(gltf: GltfAsset, bin: ArrayBuffer, prim: GltfPrimitive): PackedPrimitive;

package/dist/graphics/scene/model/gltf/pack-vertex-buffer.js

@@ -0,0 +1,106 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { stride as vertexStride } from "../../../rendering/standard-vertex/layout.js";
+import { SKINNING_STRIDE } from "../../../rendering/skinning/skinning-attributes/layout.js";
+import { readAccessor } from "./accessor-view.js";
+const FLOATS_PER_VERTEX = vertexStride / 4; // 48 / 4 = 12
+/**
+ * Reads POSITION/NORMAL/TANGENT/TEXCOORD_0 from a primitive and interleaves
+ * them into the packed StandardVertex layout (48 bytes / vertex).
+ *
+ * If JOINTS_0 and WEIGHTS_0 are present, also packs them into a separate
+ * skinning attribute buffer with stride {@link SKINNING_STRIDE}.
+ *
+ * Vertices are kept in node-local space — no world transform is applied here.
+ */
+export function packPrimitiveVertices(gltf, bin, prim) {
+    const positions = readAccessor(gltf, bin, prim.attributes.POSITION);
+    // Normals and UVs are optional in glTF — fall back to defaults when absent.
+    // Skinned demo meshes (e.g. Fox) frequently omit NORMAL.
+    const normals = prim.attributes.NORMAL !== undefined
+        ? readAccessor(gltf, bin, prim.attributes.NORMAL)
+        : null;
+    const uvs = prim.attributes.TEXCOORD_0 !== undefined
+        ? readAccessor(gltf, bin, prim.attributes.TEXCOORD_0)
+        : null;
+    const tangents = prim.attributes.TANGENT !== undefined
+        ? readAccessor(gltf, bin, prim.attributes.TANGENT)
+        : null;
+    // glTF JOINTS_0 is unsigned byte vec4 or unsigned short vec4; readAccessor
+    // returns either Uint8Array or Uint16Array. WEIGHTS_0 is usually float32x4.
+    const joints = prim.attributes.JOINTS_0 !== undefined
+        ? readAccessor(gltf, bin, prim.attributes.JOINTS_0)
+        : null;
+    const weights = prim.attributes.WEIGHTS_0 !== undefined
+        ? readAccessor(gltf, bin, prim.attributes.WEIGHTS_0)
+        : null;
+    const skinned = joints !== null && weights !== null;
+    const vertexCount = positions.length / 3;
+    const out = new Float32Array(vertexCount * FLOATS_PER_VERTEX);
+    const skin = skinned ? new ArrayBuffer(vertexCount * SKINNING_STRIDE) : null;
+    const skinJointsView = skin ? new Uint32Array(skin) : null;
+    const skinWeightsView = skin ? new Float32Array(skin) : null;
+    const min = [Infinity, Infinity, Infinity];
+    const max = [-Infinity, -Infinity, -Infinity];
+    for (let i = 0; i < vertexCount; i++) {
+        const px = positions[i * 3], py = positions[i * 3 + 1], pz = positions[i * 3 + 2];
+        const nx = normals ? normals[i * 3] : 0;
+        const ny = normals ? normals[i * 3 + 1] : 1;
+        const nz = normals ? normals[i * 3 + 2] : 0;
+        let tx = 1, ty = 0, tz = 0, tw = 1;
+        if (tangents) {
+            tx = tangents[i * 4];
+            ty = tangents[i * 4 + 1];
+            tz = tangents[i * 4 + 2];
+            tw = tangents[i * 4 + 3];
+        }
+        const u = uvs ? uvs[i * 2] : 0;
+        const v = uvs ? uvs[i * 2 + 1] : 0;
+        const o = i * FLOATS_PER_VERTEX;
+        out[o + 0] = px;
+        out[o + 1] = py;
+        out[o + 2] = pz;
+        out[o + 3] = nx;
+        out[o + 4] = ny;
+        out[o + 5] = nz;
+        out[o + 6] = tx;
+        out[o + 7] = ty;
+        out[o + 8] = tz;
+        out[o + 9] = tw;
+        out[o + 10] = u;
+        out[o + 11] = v;
+        if (skinned) {
+            // 32-byte stride / 4-byte words = 8 words per skinned vertex:
+            //   words 0..3: joints (u32 each)
+            //   words 4..7: weights (f32 each)
+            const so = i * 8;
+            skinJointsView[so + 0] = joints[i * 4 + 0];
+            skinJointsView[so + 1] = joints[i * 4 + 1];
+            skinJointsView[so + 2] = joints[i * 4 + 2];
+            skinJointsView[so + 3] = joints[i * 4 + 3];
+            skinWeightsView[so + 4] = weights[i * 4 + 0];
+            skinWeightsView[so + 5] = weights[i * 4 + 1];
+            skinWeightsView[so + 6] = weights[i * 4 + 2];
+            skinWeightsView[so + 7] = weights[i * 4 + 3];
+        }
+        if (px < min[0])
+            min[0] = px;
+        if (px > max[0])
+            max[0] = px;
+        if (py < min[1])
+            min[1] = py;
+        if (py > max[1])
+            max[1] = py;
+        if (pz < min[2])
+            min[2] = pz;
+        if (pz > max[2])
+            max[2] = pz;
+    }
+    return {
+        vertices: out,
+        skinningAttributes: skin,
+        vertexCount,
+        boundsMin: min,
+        boundsMax: max,
+    };
+}
+//# sourceMappingURL=pack-vertex-buffer.js.map

package/dist/graphics/scene/model/gltf/pack-vertex-buffer.js.map

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

package/dist/graphics/scene/model/gltf/parse-animations.d.ts

@@ -0,0 +1,18 @@
+import type { AnimationTrack } from "../../../animation/animation-track/animation-track.js";
+import type { GltfAsset } from "./gltf-schema.js";
+export interface LoadedAnimation {
+    name?: string;
+    duration: number;
+    tracks: AnimationTrack[];
+}
+/**
+ * Parses glTF `animations[]` into clip data sized for our AnimationClip
+ * archetype. Each `track.targetIndex` is the **joint index** (position in
+ * `skin.joints`) — the skinning init system places joint entity IDs at those
+ * indices in the AnimationPlayer's `animationTargets` so the clip is portable
+ * across instances.
+ *
+ * Tracks targeting non-joint nodes or unsupported paths (e.g. morph weights)
+ * are skipped.
+ */
+export declare function parseGltfAnimations(gltf: GltfAsset, bin: ArrayBuffer, jointNodeIndices: readonly number[]): LoadedAnimation[];

package/dist/graphics/scene/model/gltf/parse-animations.js

@@ -0,0 +1,51 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { readAccessor } from "./accessor-view.js";
+const PATH_TO_COMPONENT = {
+    translation: "position",
+    rotation: "rotation",
+    scale: "scale",
+};
+const INTERP_MAP = {
+    LINEAR: "linear",
+    STEP: "step",
+    CUBICSPLINE: "cubicSpline",
+};
+/**
+ * Parses glTF `animations[]` into clip data sized for our AnimationClip
+ * archetype. Each `track.targetIndex` is the **joint index** (position in
+ * `skin.joints`) — the skinning init system places joint entity IDs at those
+ * indices in the AnimationPlayer's `animationTargets` so the clip is portable
+ * across instances.
+ *
+ * Tracks targeting non-joint nodes or unsupported paths (e.g. morph weights)
+ * are skipped.
+ */
+export function parseGltfAnimations(gltf, bin, jointNodeIndices) {
+    if (!gltf.animations || gltf.animations.length === 0)
+        return [];
+    const nodeToJoint = new Map();
+    for (let j = 0; j < jointNodeIndices.length; j++)
+        nodeToJoint.set(jointNodeIndices[j], j);
+    return gltf.animations.map(anim => {
+        const tracks = [];
+        let duration = 0;
+        for (const channel of anim.channels) {
+            const component = PATH_TO_COMPONENT[channel.target.path];
+            if (!component)
+                continue; // skip morph "weights" etc.
+            const jointIdx = nodeToJoint.get(channel.target.node);
+            if (jointIdx === undefined)
+                continue;
+            const sampler = anim.samplers[channel.sampler];
+            const times = new Float32Array(readAccessor(gltf, bin, sampler.input));
+            const values = new Float32Array(readAccessor(gltf, bin, sampler.output));
+            const interpolation = INTERP_MAP[sampler.interpolation ?? "LINEAR"] ?? "linear";
+            tracks.push({ targetIndex: jointIdx, component, times, values, interpolation });
+            const lastTime = times[times.length - 1] ?? 0;
+            if (lastTime > duration)
+                duration = lastTime;
+        }
+        return { name: anim.name, duration, tracks };
+    });
+}
+//# sourceMappingURL=parse-animations.js.map

package/dist/graphics/scene/model/gltf/parse-animations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-animations.js","sourceRoot":"","sources":["../../../../../src/graphics/scene/model/gltf/parse-animations.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAIvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASlD,MAAM,iBAAiB,GAA2B;IAC9C,WAAW,EAAE,UAAU;IACvB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;CACjB,CAAC;AAEF,MAAM,UAAU,GAAsC;IAClD,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;CAC7B,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAC/B,IAAe,EACf,GAAgB,EAChB,gBAAmC;IAEnC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1F,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAC9B,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzD,IAAI,CAAC,SAAS;gBAAE,SAAS,CAAC,4BAA4B;YACtD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtD,IAAI,QAAQ,KAAK,SAAS;gBAAE,SAAS;YAErC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,CAAiB,CAAC,CAAC;YACvF,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAiB,CAAC,CAAC;YACzF,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,IAAI,QAAQ,CAAC,IAAI,QAAQ,CAAC;YAEhF,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;YAChF,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,QAAQ,GAAG,QAAQ;gBAAE,QAAQ,GAAG,QAAQ,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/graphics/scene/model/gltf/parse-glb.d.ts

@@ -0,0 +1,6 @@
+import type { GltfAsset } from "./gltf-schema.js";
+export interface ParsedGlb {
+    json: GltfAsset;
+    bin: ArrayBuffer;
+}
+export declare function parseGlb(buffer: ArrayBuffer): ParsedGlb;

package/dist/graphics/scene/model/gltf/parse-glb.js

@@ -0,0 +1,40 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+const MAGIC_GLTF = 0x46546c67; // "glTF"
+const CHUNK_JSON = 0x4e4f534a; // "JSON"
+const CHUNK_BIN = 0x004e4942; // "BIN\0"
+export function parseGlb(buffer) {
+    if (buffer.byteLength < 12) {
+        throw new Error("GLB too short to contain header");
+    }
+    const view = new DataView(buffer);
+    const magic = view.getUint32(0, true);
+    if (magic !== MAGIC_GLTF) {
+        throw new Error(`Not a GLB file (magic = 0x${magic.toString(16)})`);
+    }
+    const version = view.getUint32(4, true);
+    if (version !== 2) {
+        throw new Error(`Unsupported GLB version ${version}`);
+    }
+    let offset = 12;
+    let json = null;
+    let bin = null;
+    while (offset < buffer.byteLength) {
+        const chunkLength = view.getUint32(offset, true);
+        const chunkType = view.getUint32(offset + 4, true);
+        const chunkStart = offset + 8;
+        const chunkEnd = chunkStart + chunkLength;
+        if (chunkType === CHUNK_JSON) {
+            const bytes = new Uint8Array(buffer, chunkStart, chunkLength);
+            const text = new TextDecoder().decode(bytes);
+            json = JSON.parse(text);
+        }
+        else if (chunkType === CHUNK_BIN) {
+            bin = buffer.slice(chunkStart, chunkEnd);
+        }
+        offset = chunkEnd;
+    }
+    if (!json)
+        throw new Error("GLB missing JSON chunk");
+    return { json, bin: bin ?? new ArrayBuffer(0) };
+}
+//# sourceMappingURL=parse-glb.js.map

package/dist/graphics/scene/model/gltf/parse-glb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-glb.js","sourceRoot":"","sources":["../../../../../src/graphics/scene/model/gltf/parse-glb.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAIvD,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,SAAS;AACxC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,SAAS;AACxC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,UAAU;AAOxC,MAAM,UAAU,QAAQ,CAAC,MAAmB;IACxC,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,IAAI,GAAqB,IAAI,CAAC;IAClC,IAAI,GAAG,GAAuB,IAAI,CAAC;IAEnC,OAAO,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;QAE1C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;QACzC,CAAC;aAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,GAAG,QAAQ,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACrD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC"}

package/dist/graphics/scene/model/gltf/parse-skin.d.ts

@@ -0,0 +1,19 @@
+import type { Quat, Vec3 } from "@adobe/data/math";
+import type { GltfAsset } from "./gltf-schema.js";
+export interface JointTemplate {
+    /** Local-space TRS in glTF node space (relative to joint parent). */
+    position: Vec3;
+    rotation: Quat;
+    scale: Vec3;
+    /** Index into the same joint-template array of this joint's parent joint,
+     *  or -1 when the joint is the rig root (parented to the Model entity). */
+    parentJointIndex: number;
+    /** Human-readable name from the glTF (debug aid). */
+    name?: string;
+}
+export interface LoadedSkin {
+    jointTemplate: JointTemplate[];
+    /** Flat N × 16 floats — bind-pose inverse matrices in joint order. */
+    inverseBindMatrices: Float32Array;
+}
+export declare function parseGltfSkin(gltf: GltfAsset, bin: ArrayBuffer): LoadedSkin | null;

package/dist/graphics/scene/model/gltf/parse-skin.js

@@ -0,0 +1,43 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { readAccessor } from "./accessor-view.js";
+/**
+ * Builds a node-index → joint-index map and walks the glTF node hierarchy to
+ * find each joint's parent joint (or -1 if its parent is not itself a joint).
+ */
+function buildJointParentMap(gltf, jointNodeIndices) {
+    const nodeToJoint = new Map();
+    for (let j = 0; j < jointNodeIndices.length; j++)
+        nodeToJoint.set(jointNodeIndices[j], j);
+    const nodeParent = new Map(); // child node → parent node
+    for (let n = 0; n < (gltf.nodes ?? []).length; n++) {
+        for (const child of gltf.nodes[n].children ?? [])
+            nodeParent.set(child, n);
+    }
+    return jointNodeIndices.map(nodeIdx => {
+        const parentNode = nodeParent.get(nodeIdx);
+        if (parentNode === undefined)
+            return -1;
+        return nodeToJoint.get(parentNode) ?? -1;
+    });
+}
+export function parseGltfSkin(gltf, bin) {
+    const skin = gltf.skins?.[0];
+    if (!skin)
+        return null;
+    const parentIndices = buildJointParentMap(gltf, skin.joints);
+    const jointTemplate = skin.joints.map((nodeIdx, jointIdx) => {
+        const node = gltf.nodes[nodeIdx];
+        return {
+            position: (node.translation ?? [0, 0, 0]),
+            rotation: (node.rotation ?? [0, 0, 0, 1]),
+            scale: (node.scale ?? [1, 1, 1]),
+            parentJointIndex: parentIndices[jointIdx],
+            name: node.name,
+        };
+    });
+    const inverseBindMatrices = skin.inverseBindMatrices !== undefined
+        ? new Float32Array(readAccessor(gltf, bin, skin.inverseBindMatrices))
+        : new Float32Array(skin.joints.length * 16).fill(0).map((_, i) => i % 17 === 0 ? 1 : 0);
+    return { jointTemplate, inverseBindMatrices };
+}
+//# sourceMappingURL=parse-skin.js.map

package/dist/graphics/scene/model/gltf/parse-skin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-skin.js","sourceRoot":"","sources":["../../../../../src/graphics/scene/model/gltf/parse-skin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAqBlD;;;GAGG;AACH,SAAS,mBAAmB,CAAC,IAAe,EAAE,gBAAmC;IAC7E,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1F,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,2BAA2B;IACzE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE;YAAE,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAClC,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,CAAC;QACxC,OAAO,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,GAAgB;IAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAE7D,MAAM,aAAa,GAAoB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAM,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO;YACH,QAAQ,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAS;YACjD,QAAQ,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAS;YACjD,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAS;YACxC,gBAAgB,EAAE,aAAa,CAAC,QAAQ,CAAC;YACzC,IAAI,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,KAAK,SAAS;QAC9D,CAAC,CAAC,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,mBAAmB,CAAiB,CAAC;QACrF,CAAC,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5F,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;AAClD,CAAC"}