@certe/atmos-assets 0.1.0

package/dist/gltf-parser.js

@@ -0,0 +1,155 @@
+/**
+ * Minimal glTF 2.0 / GLB parser.
+ * Handles the binary container format and accessor/bufferView resolution.
+ * No external dependencies.
+ */
+/* ------------------------------------------------------------------ */
+/*  GLB magic / constants                                             */
+/* ------------------------------------------------------------------ */
+const GLB_MAGIC = 0x46546C67; // 'glTF'
+const GLB_CHUNK_JSON = 0x4E4F534A;
+const GLB_CHUNK_BIN = 0x004E4942;
+/* ------------------------------------------------------------------ */
+/*  Component type → TypedArray mapping                               */
+/* ------------------------------------------------------------------ */
+const COMPONENT_TYPES = {
+    5120: { BYTES: 1, Array: Int8Array },
+    5121: { BYTES: 1, Array: Uint8Array },
+    5122: { BYTES: 2, Array: Int16Array },
+    5123: { BYTES: 2, Array: Uint16Array },
+    5125: { BYTES: 4, Array: Uint32Array },
+    5126: { BYTES: 4, Array: Float32Array },
+};
+const TYPE_COUNTS = {
+    SCALAR: 1,
+    VEC2: 2,
+    VEC3: 3,
+    VEC4: 4,
+    MAT2: 4,
+    MAT3: 9,
+    MAT4: 16,
+};
+/* ------------------------------------------------------------------ */
+/*  Public API                                                        */
+/* ------------------------------------------------------------------ */
+/** Parse a GLB binary container into JSON + binary buffer(s). */
+export function parseGlb(data) {
+    const view = new DataView(data);
+    const magic = view.getUint32(0, true);
+    if (magic !== GLB_MAGIC)
+        throw new Error('Not a valid GLB file');
+    const version = view.getUint32(4, true);
+    if (version !== 2)
+        throw new Error(`Unsupported glTF version: ${version}`);
+    let offset = 12; // skip header (magic + version + length)
+    let json = null;
+    const buffers = [];
+    while (offset < data.byteLength) {
+        const chunkLength = view.getUint32(offset, true);
+        const chunkType = view.getUint32(offset + 4, true);
+        const chunkData = data.slice(offset + 8, offset + 8 + chunkLength);
+        if (chunkType === GLB_CHUNK_JSON) {
+            const decoder = new TextDecoder();
+            json = JSON.parse(decoder.decode(chunkData));
+        }
+        else if (chunkType === GLB_CHUNK_BIN) {
+            buffers.push(chunkData);
+        }
+        offset += 8 + chunkLength;
+    }
+    if (!json)
+        throw new Error('GLB file missing JSON chunk');
+    return { json, buffers };
+}
+/** Parse a standalone .gltf JSON file with external buffer(s). */
+export function parseGltfJson(json, buffers) {
+    return { json, buffers: buffers ?? [] };
+}
+/** DataView readers indexed by componentType. */
+const DV_READ = {
+    5120: (dv, o) => dv.getInt8(o),
+    5121: (dv, o) => dv.getUint8(o),
+    5122: (dv, o) => dv.getInt16(o, true),
+    5123: (dv, o) => dv.getUint16(o, true),
+    5125: (dv, o) => dv.getUint32(o, true),
+    5126: (dv, o) => dv.getFloat32(o, true),
+};
+/** Normalization divisors for integer component types (signed / unsigned). */
+const NORM_DIVISOR = {
+    5120: 127, // INT8   → [-1,1]
+    5121: 255, // UINT8  → [0,1]
+    5122: 32767, // INT16  → [-1,1]
+    5123: 65535, // UINT16 → [0,1]
+    5125: 4294967295, // UINT32
+};
+/** Read a typed array from an accessor. */
+export function readAccessor(doc, accessorIndex) {
+    const accessor = doc.json.accessors?.[accessorIndex];
+    if (!accessor)
+        throw new Error(`Accessor ${accessorIndex} not found`);
+    const ct = COMPONENT_TYPES[accessor.componentType];
+    if (!ct)
+        throw new Error(`Unknown component type: ${accessor.componentType}`);
+    const typeCount = TYPE_COUNTS[accessor.type];
+    if (typeCount === undefined)
+        throw new Error(`Unknown accessor type: ${accessor.type}`);
+    const elementCount = accessor.count * typeCount;
+    const normalized = accessor.normalized === true;
+    if (accessor.bufferView === undefined) {
+        return normalized ? new Float32Array(elementCount) : new ct.Array(elementCount);
+    }
+    const bufferView = doc.json.bufferViews?.[accessor.bufferView];
+    if (!bufferView)
+        throw new Error(`BufferView ${accessor.bufferView} not found`);
+    const buffer = doc.buffers[bufferView.buffer];
+    if (!buffer)
+        throw new Error(`Buffer ${bufferView.buffer} not found`);
+    const byteOffset = (bufferView.byteOffset ?? 0) + (accessor.byteOffset ?? 0);
+    const elementBytes = ct.BYTES * typeCount;
+    const stride = bufferView.byteStride ?? elementBytes;
+    // Fast path: tightly packed floats, no normalization — direct view
+    if (!normalized && stride === elementBytes && accessor.componentType === 5126) {
+        return new Float32Array(buffer, byteOffset, elementCount);
+    }
+    // Fast path: tightly packed non-float, no normalization, aligned
+    if (!normalized && stride === elementBytes && byteOffset % ct.BYTES === 0) {
+        return new ct.Array(buffer, byteOffset, elementCount);
+    }
+    // General path: DataView handles any alignment and stride
+    const dv = new DataView(buffer);
+    const read = DV_READ[accessor.componentType];
+    if (!read)
+        throw new Error(`No reader for componentType ${accessor.componentType}`);
+    if (normalized) {
+        // Normalized integer → float output
+        const divisor = NORM_DIVISOR[accessor.componentType] ?? 1;
+        const result = new Float32Array(elementCount);
+        for (let i = 0; i < accessor.count; i++) {
+            const elemStart = byteOffset + i * stride;
+            for (let j = 0; j < typeCount; j++) {
+                result[i * typeCount + j] = read(dv, elemStart + j * ct.BYTES) / divisor;
+            }
+        }
+        return result;
+    }
+    // Non-normalized strided copy
+    const result = new ct.Array(elementCount);
+    for (let i = 0; i < accessor.count; i++) {
+        const elemStart = byteOffset + i * stride;
+        for (let j = 0; j < typeCount; j++) {
+            result[i * typeCount + j] = read(dv, elemStart + j * ct.BYTES);
+        }
+    }
+    return result;
+}
+/** Read raw bytes from a bufferView (for embedded images). */
+export function readBufferView(doc, bufferViewIndex) {
+    const bv = doc.json.bufferViews?.[bufferViewIndex];
+    if (!bv)
+        throw new Error(`BufferView ${bufferViewIndex} not found`);
+    const buffer = doc.buffers[bv.buffer];
+    if (!buffer)
+        throw new Error(`Buffer ${bv.buffer} not found`);
+    return new Uint8Array(buffer, bv.byteOffset ?? 0, bv.byteLength);
+}
+//# sourceMappingURL=gltf-parser.js.map

package/dist/gltf-parser.js.map

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

package/dist/gltf-scene.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Assemble a complete ModelAsset from a glTF document.
+ * Orchestrates parser, mesh, material, texture, skin, and animation extraction.
+ */
+import type { ModelAsset } from './types.js';
+/**
+ * Parse a GLB buffer into a format-agnostic ModelAsset.
+ * This is CPU-only – no GPU access needed.
+ */
+export declare function parseGltfModel(data: ArrayBuffer, name?: string): ModelAsset;
+//# sourceMappingURL=gltf-scene.d.ts.map

package/dist/gltf-scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-scene.d.ts","sourceRoot":"","sources":["../src/gltf-scene.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AAExD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAG3E"}

package/dist/gltf-scene.js

@@ -0,0 +1,171 @@
+/**
+ * Assemble a complete ModelAsset from a glTF document.
+ * Orchestrates parser, mesh, material, texture, skin, and animation extraction.
+ */
+import { parseGlb } from './gltf-parser.js';
+import { extractMeshes } from './gltf-mesh.js';
+import { extractMaterials } from './gltf-material.js';
+import { extractTextures } from './gltf-texture.js';
+import { extractSkins } from './gltf-skin.js';
+import { extractAnimations } from './gltf-animation.js';
+/**
+ * Parse a GLB buffer into a format-agnostic ModelAsset.
+ * This is CPU-only – no GPU access needed.
+ */
+export function parseGltfModel(data, name) {
+    const doc = parseGlb(data);
+    return buildModelAsset(doc, name ?? 'model');
+}
+function buildModelAsset(doc, name) {
+    const meshes = extractMeshes(doc);
+    const materials = extractMaterials(doc);
+    const textures = extractTextures(doc);
+    const skins = extractSkins(doc);
+    const animations = extractAnimations(doc);
+    const rootNodes = buildNodeTree(doc);
+    // Propagate skin indices from nodes to meshes
+    propagateSkinIndices(doc, meshes, rootNodes);
+    return { name, meshes, materials, textures, rootNodes, skins, animations };
+}
+/**
+ * Walk the node tree and propagate skin index from nodes to their meshes.
+ */
+function propagateSkinIndices(doc, meshes, _rootNodes) {
+    const gltfNodes = doc.json.nodes ?? [];
+    const meshIndexMap = buildMeshIndexMap(doc);
+    for (const node of gltfNodes) {
+        if (node.skin !== undefined && node.mesh !== undefined) {
+            const flatIndices = meshIndexMap.get(node.mesh) ?? [];
+            for (const mi of flatIndices) {
+                const mesh = meshes[mi];
+                if (mesh) {
+                    mesh.skinIndex = node.skin;
+                }
+            }
+        }
+    }
+}
+function buildNodeTree(doc) {
+    const gltfNodes = doc.json.nodes ?? [];
+    const sceneIndex = doc.json.scene ?? 0;
+    const scene = doc.json.scenes?.[sceneIndex];
+    const rootIndices = scene?.nodes ?? [];
+    const meshIndexMap = buildMeshIndexMap(doc);
+    return rootIndices
+        .map(i => buildNode(gltfNodes, i, meshIndexMap))
+        .filter((n) => n !== null);
+}
+function buildNode(nodes, index, meshIndexMap) {
+    const node = nodes[index];
+    if (!node)
+        return null;
+    let position = [0, 0, 0];
+    let rotation = [0, 0, 0, 1];
+    let scale = [1, 1, 1];
+    if (node.matrix) {
+        const m = node.matrix;
+        position = [m[12] ?? 0, m[13] ?? 0, m[14] ?? 0];
+        scale = decomposeScale(m);
+        rotation = decomposeRotation(m, scale);
+    }
+    else {
+        if (node.translation) {
+            position = [
+                node.translation[0] ?? 0,
+                node.translation[1] ?? 0,
+                node.translation[2] ?? 0,
+            ];
+        }
+        if (node.rotation) {
+            rotation = [
+                node.rotation[0] ?? 0,
+                node.rotation[1] ?? 0,
+                node.rotation[2] ?? 0,
+                node.rotation[3] ?? 1,
+            ];
+        }
+        if (node.scale) {
+            scale = [
+                node.scale[0] ?? 1,
+                node.scale[1] ?? 1,
+                node.scale[2] ?? 1,
+            ];
+        }
+    }
+    const meshIndices = node.mesh !== undefined
+        ? (meshIndexMap.get(node.mesh) ?? [])
+        : [];
+    const children = (node.children ?? [])
+        .map(ci => buildNode(nodes, ci, meshIndexMap))
+        .filter((n) => n !== null);
+    const result = {
+        name: node.name ?? `node_${index}`,
+        meshIndices,
+        position,
+        rotation,
+        scale,
+        children,
+    };
+    if (node.skin !== undefined) {
+        result.skinIndex = node.skin;
+    }
+    return result;
+}
+function buildMeshIndexMap(doc) {
+    const map = new Map();
+    const gltfMeshes = doc.json.meshes ?? [];
+    let flatIndex = 0;
+    for (let mi = 0; mi < gltfMeshes.length; mi++) {
+        const primCount = gltfMeshes[mi].primitives.length;
+        const indices = [];
+        for (let p = 0; p < primCount; p++) {
+            indices.push(flatIndex++);
+        }
+        map.set(mi, indices);
+    }
+    return map;
+}
+function decomposeScale(m) {
+    const sx = Math.sqrt((m[0] ?? 0) ** 2 + (m[1] ?? 0) ** 2 + (m[2] ?? 0) ** 2);
+    const sy = Math.sqrt((m[4] ?? 0) ** 2 + (m[5] ?? 0) ** 2 + (m[6] ?? 0) ** 2);
+    const sz = Math.sqrt((m[8] ?? 0) ** 2 + (m[9] ?? 0) ** 2 + (m[10] ?? 0) ** 2);
+    return [sx, sy, sz];
+}
+function decomposeRotation(m, s) {
+    const sx = s[0] || 1, sy = s[1] || 1, sz = s[2] || 1;
+    const r00 = (m[0] ?? 0) / sx, r01 = (m[4] ?? 0) / sy, r02 = (m[8] ?? 0) / sz;
+    const r10 = (m[1] ?? 0) / sx, r11 = (m[5] ?? 0) / sy, r12 = (m[9] ?? 0) / sz;
+    const r20 = (m[2] ?? 0) / sx, r21 = (m[6] ?? 0) / sy, r22 = (m[10] ?? 0) / sz;
+    const trace = r00 + r11 + r22;
+    let x, y, z, w;
+    if (trace > 0) {
+        const s2 = 0.5 / Math.sqrt(trace + 1);
+        w = 0.25 / s2;
+        x = (r21 - r12) * s2;
+        y = (r02 - r20) * s2;
+        z = (r10 - r01) * s2;
+    }
+    else if (r00 > r11 && r00 > r22) {
+        const s2 = 2 * Math.sqrt(1 + r00 - r11 - r22);
+        w = (r21 - r12) / s2;
+        x = 0.25 * s2;
+        y = (r01 + r10) / s2;
+        z = (r02 + r20) / s2;
+    }
+    else if (r11 > r22) {
+        const s2 = 2 * Math.sqrt(1 + r11 - r00 - r22);
+        w = (r02 - r20) / s2;
+        x = (r01 + r10) / s2;
+        y = 0.25 * s2;
+        z = (r12 + r21) / s2;
+    }
+    else {
+        const s2 = 2 * Math.sqrt(1 + r22 - r00 - r11);
+        w = (r10 - r01) / s2;
+        x = (r02 + r20) / s2;
+        y = (r12 + r21) / s2;
+        z = 0.25 * s2;
+    }
+    return [x, y, z, w];
+}
+//# sourceMappingURL=gltf-scene.js.map

package/dist/gltf-scene.js.map

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

package/dist/gltf-skin.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Extract skin data from a glTF document.
+ * Reads inverse bind matrices, joint node indices, parent hierarchy, and names.
+ */
+import type { GltfDocument } from './gltf-parser.js';
+import type { ModelSkin } from './types.js';
+/**
+ * Extract all skins from the glTF document.
+ * Each skin maps joint nodes → inverse bind matrices + pre-computed parent chain.
+ */
+export declare function extractSkins(doc: GltfDocument): ModelSkin[];
+//# sourceMappingURL=gltf-skin.d.ts.map

package/dist/gltf-skin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-skin.d.ts","sourceRoot":"","sources":["../src/gltf-skin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,EAAE,CAoG3D"}

package/dist/gltf-skin.js

@@ -0,0 +1,108 @@
+/**
+ * Extract skin data from a glTF document.
+ * Reads inverse bind matrices, joint node indices, parent hierarchy, and names.
+ */
+import { readAccessor } from './gltf-parser.js';
+import { Mat4 } from '@certe/atmos-math';
+/**
+ * Extract all skins from the glTF document.
+ * Each skin maps joint nodes → inverse bind matrices + pre-computed parent chain.
+ */
+export function extractSkins(doc) {
+    const gltfSkins = doc.json.skins ?? [];
+    const gltfNodes = doc.json.nodes ?? [];
+    const skins = [];
+    // Build a global nodeIndex → parentNodeIndex map from glTF children arrays
+    const nodeParentMap = new Map();
+    for (let ni = 0; ni < gltfNodes.length; ni++) {
+        for (const childIdx of gltfNodes[ni].children ?? []) {
+            nodeParentMap.set(childIdx, ni);
+        }
+    }
+    for (let i = 0; i < gltfSkins.length; i++) {
+        const skin = gltfSkins[i];
+        const jointCount = skin.joints.length;
+        let inverseBindMatrices;
+        if (skin.inverseBindMatrices !== undefined) {
+            const raw = readAccessor(doc, skin.inverseBindMatrices);
+            if (raw instanceof Float32Array) {
+                inverseBindMatrices = raw;
+            }
+            else {
+                inverseBindMatrices = new Float32Array(raw.length);
+                for (let j = 0; j < raw.length; j++) {
+                    inverseBindMatrices[j] = raw[j];
+                }
+            }
+        }
+        else {
+            inverseBindMatrices = new Float32Array(jointCount * 16);
+            const identity = Mat4.create();
+            Mat4.identity(identity);
+            for (let j = 0; j < jointCount; j++) {
+                inverseBindMatrices.set(identity, j * 16);
+            }
+        }
+        // Build a set for quick lookup: which glTF node indices are joints in this skin
+        const jointNodeSet = new Set(skin.joints);
+        // Compute parent joint index and rest-pose TRS for each joint
+        const jointParents = [];
+        const jointNames = [];
+        const restT = new Float32Array(jointCount * 3);
+        const restR = new Float32Array(jointCount * 4);
+        const restS = new Float32Array(jointCount * 3);
+        for (let ji = 0; ji < jointCount; ji++) {
+            const nodeIdx = skin.joints[ji];
+            const node = gltfNodes[nodeIdx];
+            jointNames.push(node?.name ?? `joint_${ji}`);
+            // Rest-pose TRS from node
+            if (node?.translation) {
+                restT[ji * 3] = node.translation[0] ?? 0;
+                restT[ji * 3 + 1] = node.translation[1] ?? 0;
+                restT[ji * 3 + 2] = node.translation[2] ?? 0;
+            }
+            if (node?.rotation) {
+                restR[ji * 4] = node.rotation[0] ?? 0;
+                restR[ji * 4 + 1] = node.rotation[1] ?? 0;
+                restR[ji * 4 + 2] = node.rotation[2] ?? 0;
+                restR[ji * 4 + 3] = node.rotation[3] ?? 1;
+            }
+            else {
+                restR[ji * 4 + 3] = 1; // identity quaternion
+            }
+            if (node?.scale) {
+                restS[ji * 3] = node.scale[0] ?? 1;
+                restS[ji * 3 + 1] = node.scale[1] ?? 1;
+                restS[ji * 3 + 2] = node.scale[2] ?? 1;
+            }
+            else {
+                restS[ji * 3] = 1;
+                restS[ji * 3 + 1] = 1;
+                restS[ji * 3 + 2] = 1;
+            }
+            // Walk up the node hierarchy to find the first ancestor that's also a joint
+            let current = nodeParentMap.get(nodeIdx);
+            let parentJointIdx = -1;
+            while (current !== undefined) {
+                if (jointNodeSet.has(current)) {
+                    parentJointIdx = skin.joints.indexOf(current);
+                    break;
+                }
+                current = nodeParentMap.get(current);
+            }
+            jointParents.push(parentJointIdx);
+        }
+        skins.push({
+            name: skin.name ?? `skin_${i}`,
+            jointNodeIndices: [...skin.joints],
+            inverseBindMatrices,
+            jointParents,
+            jointNames,
+            restT,
+            restR,
+            restS,
+        });
+    }
+    return skins;
+}
+//# sourceMappingURL=gltf-skin.js.map

package/dist/gltf-skin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-skin.js","sourceRoot":"","sources":["../src/gltf-skin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAiB;IAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IACvC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,2EAA2E;IAC3E,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;QAC7C,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,EAAE,CAAE,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACrD,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAEtC,IAAI,mBAAiC,CAAC;QACtC,IAAI,IAAI,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACxD,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;gBAChC,mBAAmB,GAAG,GAAG,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,mBAAmB,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACpC,mBAAmB,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,mBAAmB,GAAG,IAAI,YAAY,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,gFAAgF;QAChF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1C,8DAA8D;QAC9D,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAE/C,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC;YACjC,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YAChC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS,EAAE,EAAE,CAAC,CAAC;YAE7C,0BAA0B;YAC1B,IAAI,IAAI,EAAE,WAAW,EAAE,CAAC;gBACtB,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACzC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7C,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC;gBACnB,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACtC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC1C,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC1C,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,sBAAsB;YAC/C,CAAC;YACD,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;gBAChB,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACnC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACvC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;gBAAC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;gBAAC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YAClE,CAAC;YAED,4EAA4E;YAC5E,IAAI,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,cAAc,GAAG,CAAC,CAAC,CAAC;YACxB,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC7B,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC9B,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAC9C,MAAM;gBACR,CAAC;gBACD,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,EAAE;YAC9B,gBAAgB,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YAClC,mBAAmB;YACnB,YAAY;YACZ,UAAU;YACV,KAAK;YACL,KAAK;YACL,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/gltf-texture.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Extract embedded textures from a glTF document.
+ * Supports bufferView-embedded images and data URIs.
+ * Actual RGBA decoding happens at instantiation time (requires DOM).
+ */
+import type { GltfDocument } from './gltf-parser.js';
+import type { ModelTexture } from './types.js';
+/**
+ * Extract all images from the document as raw bytes.
+ * Returns one ModelTexture per glTF image.
+ * width/height are set to 0 here – they're resolved during GPU upload
+ * via decodeImageToRGBA().
+ */
+export declare function extractTextures(doc: GltfDocument): ModelTexture[];
+//# sourceMappingURL=gltf-texture.d.ts.map

package/dist/gltf-texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-texture.d.ts","sourceRoot":"","sources":["../src/gltf-texture.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,EAAE,CAkCjE"}

package/dist/gltf-texture.js

@@ -0,0 +1,59 @@
+/**
+ * Extract embedded textures from a glTF document.
+ * Supports bufferView-embedded images and data URIs.
+ * Actual RGBA decoding happens at instantiation time (requires DOM).
+ */
+import { readBufferView } from './gltf-parser.js';
+/**
+ * Extract all images from the document as raw bytes.
+ * Returns one ModelTexture per glTF image.
+ * width/height are set to 0 here – they're resolved during GPU upload
+ * via decodeImageToRGBA().
+ */
+export function extractTextures(doc) {
+    const images = doc.json.images ?? [];
+    const textures = [];
+    for (let i = 0; i < images.length; i++) {
+        const img = images[i];
+        const mimeType = img.mimeType ?? 'image/png';
+        let data;
+        if (img.bufferView !== undefined) {
+            // Embedded in GLB binary chunk
+            data = readBufferView(doc, img.bufferView);
+        }
+        else if (img.uri) {
+            if (img.uri.startsWith('data:')) {
+                data = decodeDataUri(img.uri);
+            }
+            else {
+                // External URI – not supported in MVP, skip
+                continue;
+            }
+        }
+        else {
+            continue;
+        }
+        textures.push({
+            name: `texture_${i}`,
+            data,
+            width: 0, // resolved at decode time
+            height: 0,
+            mimeType,
+        });
+    }
+    return textures;
+}
+/** Decode a base64 data URI to raw bytes. */
+function decodeDataUri(uri) {
+    const commaIndex = uri.indexOf(',');
+    if (commaIndex === -1)
+        throw new Error('Invalid data URI');
+    const base64 = uri.slice(commaIndex + 1);
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+//# sourceMappingURL=gltf-texture.js.map

package/dist/gltf-texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-texture.js","sourceRoot":"","sources":["../src/gltf-texture.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAiB;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,WAAW,CAAC;QAE7C,IAAI,IAAgB,CAAC;QAErB,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACjC,+BAA+B;YAC/B,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;YACnB,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,4CAA4C;gBAC5C,SAAS;YACX,CAAC;QACH,CAAC;aAAM,CAAC;YACN,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,WAAW,CAAC,EAAE;YACpB,IAAI;YACJ,KAAK,EAAE,CAAC,EAAG,0BAA0B;YACrC,MAAM,EAAE,CAAC;YACT,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,6CAA6C;AAC7C,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { parseGltfModel } from './gltf-scene.js';
+export { instantiateModel } from './model-instantiate.js';
+export type { InstantiateOptions, InstantiateContext } from './model-instantiate.js';
+export type { ModelAsset, ModelMesh, ModelMaterial, ModelTexture, ModelNode, ModelSkin, ModelAnimation, ModelAnimationTrack, } from './types.js';
+export { parseGlb, parseGltfJson, readAccessor, readBufferView } from './gltf-parser.js';
+export type { GltfDocument, GltfJson } from './gltf-parser.js';
+export { extractSkins } from './gltf-skin.js';
+export { extractAnimations } from './gltf-animation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACrF,YAAY,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,SAAS,EACT,SAAS,EACT,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACzF,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { parseGltfModel } from './gltf-scene.js';
+export { instantiateModel } from './model-instantiate.js';
+export { parseGlb, parseGltfJson, readAccessor, readBufferView } from './gltf-parser.js';
+export { extractSkins } from './gltf-skin.js';
+export { extractAnimations } from './gltf-animation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAY1D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEzF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/model-instantiate.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Instantiate a ModelAsset into the engine's GameObject hierarchy.
+ * Uploads textures to the GPU and creates Meshes + Materials + MeshRenderers.
+ * Supports skeletal animation via SkinnedMeshRenderer + AnimationMixer.
+ */
+import { GameObject } from '@certe/atmos-core';
+import type { MeshRendererContext, SkinnedRendererContext } from '@certe/atmos-renderer';
+import type { ModelAsset } from './types.js';
+/** Minimal interface so callers can pass a RenderSystem without importing it. */
+export interface InstantiateContext extends MeshRendererContext, SkinnedRendererContext {
+}
+export interface InstantiateOptions {
+    renderSystem: InstantiateContext;
+}
+/**
+ * Create a GameObject tree from a ModelAsset.
+ * Decodes and uploads textures, creates GPU meshes and materials.
+ * Automatically sets up SkinnedMeshRenderer + AnimationMixer for skinned models.
+ * Returns the root GameObject (caller adds to scene).
+ */
+export declare function instantiateModel(asset: ModelAsset, options: InstantiateOptions): Promise<GameObject>;
+//# sourceMappingURL=model-instantiate.d.ts.map

package/dist/model-instantiate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-instantiate.d.ts","sourceRoot":"","sources":["../src/model-instantiate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAU/C,OAAO,KAAK,EAAoC,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAQ3H,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AAExD,iFAAiF;AACjF,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB,EAAE,sBAAsB;CAAG;AAE1F,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAiDrB"}