@certe/atmos-assets 0.1.0

package/README.md

@@ -0,0 +1,122 @@
+# 📦 @certe/atmos-assets
+
+glTF 2.0 / GLB asset pipeline for the Atmos Engine. Parses binary glTF into a CPU-only `ModelAsset`, then instantiates it as a live `GameObject` hierarchy with GPU resources — meshes, materials, textures, skeletal skins, and animation clips.
+
+---
+
+## 🔑 Two-Stage Pipeline
+
+```
+ArrayBuffer  →  parseGltfModel()  →  ModelAsset (CPU-only)
+                                          ↓
+                                   instantiateModel()  →  GameObject (GPU-ready)
+```
+
+**Stage 1** is thread-safe (no GPU access). **Stage 2** uploads to the GPU and creates engine components.
+
+---
+
+## 🚀 Quick Start
+
+```ts
+import { parseGltfModel, instantiateModel } from '@certe/atmos-assets';
+
+// Load a .glb file
+const buffer = await fetch('/models/character.glb').then(r => r.arrayBuffer());
+
+// Parse (CPU-only, no GPU needed)
+const asset = parseGltfModel(buffer, 'Character');
+
+// Instantiate into the scene
+const root = await instantiateModel(asset, { renderSystem });
+scene.add(root);
+```
+
+For skinned meshes, `instantiateModel` automatically creates `SkinnedMeshRenderer` and `AnimationMixer` components, and auto-plays the first animation clip.
+
+---
+
+## 📖 API Overview
+
+### Core Functions
+
+| Function | Description |
+|---|---|
+| `parseGltfModel(buffer, name?)` | Parse GLB → `ModelAsset` |
+| `instantiateModel(asset, options)` | Create GameObject tree with GPU resources |
+
+### ModelAsset Contents
+
+| Field | Description |
+|---|---|
+| `meshes: ModelMesh[]` | Geometry data (32B standard or 52B skinned stride) |
+| `materials: ModelMaterial[]` | PBR params + texture indices |
+| `textures: ModelTexture[]` | CPU-side image bytes |
+| `rootNodes: ModelNode[]` | Scene hierarchy with TRS |
+| `skins: ModelSkin[]` | Joint hierarchies + inverse bind matrices |
+| `animations: ModelAnimation[]` | Keyframe tracks per joint |
+
+### Skinned Mesh Support
+
+When a mesh has `JOINTS_0` and `WEIGHTS_0` attributes:
+
+- Vertices are interleaved into a **52-byte format**: position(3) + normal(3) + uv(2) + joints(u8×4) + weights(f32×4)
+- `ModelMesh.skinned = true` and `skinIndex` links to the skin data
+- `instantiateModel()` creates a `SkinnedMeshRenderer` with a bone buffer, and an `AnimationMixer` pre-loaded with all clips
+
+### Low-Level Parser API
+
+For advanced use cases:
+
+```ts
+import { parseGlb, readAccessor, readBufferView } from '@certe/atmos-assets';
+
+const doc = parseGlb(buffer);              // { json, buffers }
+const positions = readAccessor(doc, 0);     // Float32Array
+const imageBytes = readBufferView(doc, 2);  // Uint8Array
+```
+
+| Function | Description |
+|---|---|
+| `parseGlb(buffer)` | Parse GLB container |
+| `parseGltfJson(json, buffers?)` | Wrap standalone .gltf |
+| `readAccessor(doc, index)` | Read typed array from accessor |
+| `readBufferView(doc, index)` | Read raw bytes from buffer view |
+| `extractSkins(doc)` | Extract skin data (joints, IBM, rest pose) |
+| `extractAnimations(doc)` | Extract animation clips |
+
+---
+
+## 🧠 Design Notes
+
+- **Custom parser** (~350 lines) — no external glTF dependencies
+- Interleaves vertex attributes into engine-native stride formats
+- Supports indexed meshes with both `Uint16Array` and `Uint32Array` indices
+- PBR metallic-roughness workflow with embedded texture extraction
+- Node hierarchy preserved with TRS decomposition
+
+---
+
+## 📁 Structure
+
+```
+packages/assets/src/
+  index.ts             # Public API
+  types.ts             # ModelAsset, ModelMesh, ModelSkin, etc.
+  gltf-parser.ts       # GLB/glTF binary parser
+  gltf-mesh.ts         # Mesh extraction + vertex interleaving
+  gltf-material.ts     # Material extraction
+  gltf-scene.ts        # Scene graph assembly
+  gltf-skin.ts         # Skin extraction (joints, IBM, rest pose)
+  gltf-animation.ts    # Animation channel extraction
+  model-instantiate.ts # GPU instantiation + component creation
+```
+
+---
+
+## 🔗 Dependencies
+
+- `@certe/atmos-core` — GameObject, Component, Transform
+- `@certe/atmos-math` — Vec3, Mat4, Quat
+- `@certe/atmos-renderer` — Mesh, Material, MeshRenderer, SkinnedMeshRenderer, textures
+- `@certe/atmos-animation` — Skeleton, AnimationClip, AnimationMixer

package/dist/gltf-animation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extract animation data from a glTF document.
+ * Reads animation channels and samplers into ModelAnimation format.
+ */
+import type { GltfDocument } from './gltf-parser.js';
+import type { ModelAnimation } from './types.js';
+/**
+ * Extract all animations from the glTF document.
+ */
+export declare function extractAnimations(doc: GltfDocument): ModelAnimation[];
+//# sourceMappingURL=gltf-animation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-animation.d.ts","sourceRoot":"","sources":["../src/gltf-animation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AAEtE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc,EAAE,CAgDrE"}

package/dist/gltf-animation.js

@@ -0,0 +1,50 @@
+/**
+ * Extract animation data from a glTF document.
+ * Reads animation channels and samplers into ModelAnimation format.
+ */
+import { readAccessor } from './gltf-parser.js';
+/**
+ * Extract all animations from the glTF document.
+ */
+export function extractAnimations(doc) {
+    const gltfAnimations = doc.json.animations ?? [];
+    const animations = [];
+    for (let i = 0; i < gltfAnimations.length; i++) {
+        const anim = gltfAnimations[i];
+        const tracks = [];
+        for (const channel of anim.channels) {
+            if (channel.target.node === undefined)
+                continue;
+            const path = channel.target.path;
+            if (path !== 'translation' && path !== 'rotation' && path !== 'scale')
+                continue;
+            const sampler = anim.samplers[channel.sampler];
+            if (!sampler)
+                continue;
+            const timesRaw = readAccessor(doc, sampler.input);
+            const valuesRaw = readAccessor(doc, sampler.output);
+            const times = timesRaw instanceof Float32Array
+                ? timesRaw
+                : new Float32Array(timesRaw);
+            const values = valuesRaw instanceof Float32Array
+                ? valuesRaw
+                : new Float32Array(valuesRaw);
+            const interpolation = sampler.interpolation === 'STEP' ? 'STEP' : 'LINEAR';
+            tracks.push({
+                targetNode: channel.target.node,
+                path,
+                interpolation,
+                times,
+                values,
+            });
+        }
+        if (tracks.length > 0) {
+            animations.push({
+                name: anim.name ?? `animation_${i}`,
+                tracks,
+            });
+        }
+    }
+    return animations;
+}
+//# sourceMappingURL=gltf-animation.js.map

package/dist/gltf-animation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-animation.js","sourceRoot":"","sources":["../src/gltf-animation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,MAAM,cAAc,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IACjD,MAAM,UAAU,GAAqB,EAAE,CAAC;IAExC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAE,CAAC;QAChC,MAAM,MAAM,GAA0B,EAAE,CAAC;QAEzC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;gBAAE,SAAS;YAEhD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YACjC,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,OAAO;gBAAE,SAAS;YAEhF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAClD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAEpD,MAAM,KAAK,GAAG,QAAQ,YAAY,YAAY;gBAC5C,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;YAE/B,MAAM,MAAM,GAAG,SAAS,YAAY,YAAY;gBAC9C,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;YAEhC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC,MAAe,CAAC,CAAC,CAAC,QAAiB,CAAC;YAE7F,MAAM,CAAC,IAAI,CAAC;gBACV,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;gBAC/B,IAAI;gBACJ,aAAa;gBACb,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,aAAa,CAAC,EAAE;gBACnC,MAAM;aACP,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/gltf-material.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extract materials from a glTF document.
+ * Maps PBR metallic-roughness to engine MaterialParams.
+ */
+import type { GltfDocument } from './gltf-parser.js';
+import type { ModelMaterial } from './types.js';
+/** Extract all materials from the document. */
+export declare function extractMaterials(doc: GltfDocument): ModelMaterial[];
+//# sourceMappingURL=gltf-material.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-material.d.ts","sourceRoot":"","sources":["../src/gltf-material.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,aAAa,EAAE,CA8CnE"}

package/dist/gltf-material.js

@@ -0,0 +1,49 @@
+/**
+ * Extract materials from a glTF document.
+ * Maps PBR metallic-roughness to engine MaterialParams.
+ */
+/** Extract all materials from the document. */
+export function extractMaterials(doc) {
+    const gltfMaterials = doc.json.materials ?? [];
+    if (gltfMaterials.length === 0) {
+        // Default material when none defined
+        return [{
+                name: 'default',
+                params: { albedo: [1, 1, 1, 1], metallic: 0, roughness: 0.5 },
+                albedoTextureIndex: null,
+            }];
+    }
+    return gltfMaterials.map((gltfMat, i) => {
+        const pbr = gltfMat.pbrMetallicRoughness;
+        const baseColor = pbr?.baseColorFactor ?? [1, 1, 1, 1];
+        // Resolve texture: glTF material → texture → image source index
+        let albedoTextureIndex = null;
+        const texInfo = pbr?.baseColorTexture;
+        if (texInfo !== undefined) {
+            const gltfTex = doc.json.textures?.[texInfo.index];
+            if (gltfTex?.source !== undefined) {
+                albedoTextureIndex = gltfTex.source;
+            }
+        }
+        // glTF alphaMode: "MASK" uses alphaCutoff (default 0.5 per spec)
+        const alphaCutoff = gltfMat.alphaMode === 'MASK'
+            ? (gltfMat.alphaCutoff ?? 0.5)
+            : 0;
+        return {
+            name: gltfMat.name ?? `material_${i}`,
+            params: {
+                albedo: [
+                    baseColor[0] ?? 1,
+                    baseColor[1] ?? 1,
+                    baseColor[2] ?? 1,
+                    baseColor[3] ?? 1,
+                ],
+                metallic: pbr?.metallicFactor ?? 0,
+                roughness: pbr?.roughnessFactor ?? 0.5,
+                alphaCutoff,
+            },
+            albedoTextureIndex,
+        };
+    });
+}
+//# sourceMappingURL=gltf-material.js.map

package/dist/gltf-material.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-material.js","sourceRoot":"","sources":["../src/gltf-material.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,+CAA+C;AAC/C,MAAM,UAAU,gBAAgB,CAAC,GAAiB;IAChD,MAAM,aAAa,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IAC/C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,qCAAqC;QACrC,OAAO,CAAC;gBACN,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;gBAC7D,kBAAkB,EAAE,IAAI;aACzB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;QACtC,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC;QACzC,MAAM,SAAS,GAAG,GAAG,EAAE,eAAe,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEvD,gEAAgE;QAChE,IAAI,kBAAkB,GAAkB,IAAI,CAAC;QAC7C,MAAM,OAAO,GAAG,GAAG,EAAE,gBAAgB,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;gBAClC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;YACtC,CAAC;QACH,CAAC;QAED,iEAAiE;QACjE,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,KAAK,MAAM;YAC9C,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;YAC9B,CAAC,CAAC,CAAC,CAAC;QAEN,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC,EAAE;YACrC,MAAM,EAAE;gBACN,MAAM,EAAE;oBACN,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;oBACjB,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;oBACjB,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;oBACjB,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;iBACkB;gBACrC,QAAQ,EAAE,GAAG,EAAE,cAAc,IAAI,CAAC;gBAClC,SAAS,EAAE,GAAG,EAAE,eAAe,IAAI,GAAG;gBACtC,WAAW;aACZ;YACD,kBAAkB;SACnB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/gltf-mesh.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Extract meshes from a glTF document.
+ * Interleaves vertex data into the engine's format:
+ *   Static:  position(3) + normal(3) + uv(2) = 8 floats = 32 bytes
+ *   Skinned: position(3) + normal(3) + uv(2) + joints_u8x4(1) + weights(4) = 13 floats = 52 bytes
+ */
+import type { GltfDocument } from './gltf-parser.js';
+import type { ModelMesh } from './types.js';
+/**
+ * Extract all meshes from the document.
+ * Each glTF mesh may have multiple primitives; we flatten them into separate ModelMeshes.
+ */
+export declare function extractMeshes(doc: GltfDocument): ModelMesh[];
+//# sourceMappingURL=gltf-mesh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-mesh.d.ts","sourceRoot":"","sources":["../src/gltf-mesh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,kBAAkB,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,EAAE,CAe5D"}

package/dist/gltf-mesh.js

@@ -0,0 +1,189 @@
+/**
+ * Extract meshes from a glTF document.
+ * Interleaves vertex data into the engine's format:
+ *   Static:  position(3) + normal(3) + uv(2) = 8 floats = 32 bytes
+ *   Skinned: position(3) + normal(3) + uv(2) + joints_u8x4(1) + weights(4) = 13 floats = 52 bytes
+ */
+import { VERTEX_STRIDE_FLOATS, SKINNED_VERTEX_STRIDE_FLOATS } from '@certe/atmos-renderer';
+import { computeBoundingSphere } from '@certe/atmos-renderer';
+import { readAccessor } from './gltf-parser.js';
+/**
+ * Extract all meshes from the document.
+ * Each glTF mesh may have multiple primitives; we flatten them into separate ModelMeshes.
+ */
+export function extractMeshes(doc) {
+    const meshes = [];
+    const gltfMeshes = doc.json.meshes ?? [];
+    for (let mi = 0; mi < gltfMeshes.length; mi++) {
+        const gltfMesh = gltfMeshes[mi];
+        for (let pi = 0; pi < gltfMesh.primitives.length; pi++) {
+            const prim = gltfMesh.primitives[pi];
+            const name = gltfMesh.primitives.length === 1
+                ? (gltfMesh.name ?? `mesh_${mi}`)
+                : `${gltfMesh.name ?? `mesh_${mi}`}_prim${pi}`;
+            meshes.push(extractPrimitive(doc, prim, name));
+        }
+    }
+    return meshes;
+}
+function extractPrimitive(doc, prim, name) {
+    // Read position (required)
+    const posAccessor = prim.attributes['POSITION'];
+    if (posAccessor === undefined)
+        throw new Error(`Mesh "${name}" missing POSITION attribute`);
+    const positions = readAccessor(doc, posAccessor);
+    const vertexCount = positions.length / 3;
+    // Read normals (optional – generate flat normals if missing)
+    let normals;
+    const normalAccessor = prim.attributes['NORMAL'];
+    if (normalAccessor !== undefined) {
+        normals = readAccessor(doc, normalAccessor);
+    }
+    else {
+        normals = generateFlatNormals(positions, vertexCount);
+    }
+    // Read UVs (optional – zero if missing)
+    let uvs;
+    const uvAccessor = prim.attributes['TEXCOORD_0'];
+    if (uvAccessor !== undefined) {
+        uvs = readAccessor(doc, uvAccessor);
+    }
+    else {
+        uvs = new Float32Array(vertexCount * 2);
+    }
+    // Detect skinning attributes
+    const jointsAccessor = prim.attributes['JOINTS_0'];
+    const weightsAccessor = prim.attributes['WEIGHTS_0'];
+    const skinned = jointsAccessor !== undefined && weightsAccessor !== undefined;
+    let vertices;
+    let stride;
+    if (skinned) {
+        stride = SKINNED_VERTEX_STRIDE_FLOATS; // 13
+        vertices = interleaveSkinnedVertices(doc, positions, normals, uvs, vertexCount, jointsAccessor, weightsAccessor);
+    }
+    else {
+        stride = VERTEX_STRIDE_FLOATS; // 8
+        vertices = new Float32Array(vertexCount * stride);
+        for (let i = 0; i < vertexCount; i++) {
+            const vo = i * stride;
+            const p = i * 3;
+            const u = i * 2;
+            vertices[vo] = positions[p];
+            vertices[vo + 1] = positions[p + 1];
+            vertices[vo + 2] = positions[p + 2];
+            vertices[vo + 3] = normals[p];
+            vertices[vo + 4] = normals[p + 1];
+            vertices[vo + 5] = normals[p + 2];
+            vertices[vo + 6] = uvs[u];
+            vertices[vo + 7] = uvs[u + 1];
+        }
+    }
+    // Read indices
+    let indices;
+    if (prim.indices !== undefined) {
+        const raw = readAccessor(doc, prim.indices);
+        if (raw instanceof Uint32Array) {
+            indices = raw;
+        }
+        else if (raw instanceof Uint16Array) {
+            indices = raw;
+        }
+        else {
+            indices = new Uint16Array(raw.length);
+            for (let i = 0; i < raw.length; i++)
+                indices[i] = raw[i];
+        }
+        if (indices instanceof Uint16Array && vertexCount > 65535) {
+            const u32 = new Uint32Array(indices.length);
+            for (let i = 0; i < indices.length; i++)
+                u32[i] = indices[i];
+            indices = u32;
+        }
+    }
+    else {
+        indices = vertexCount > 65535
+            ? new Uint32Array(vertexCount)
+            : new Uint16Array(vertexCount);
+        for (let i = 0; i < vertexCount; i++)
+            indices[i] = i;
+    }
+    const bounds = computeBoundingSphere(vertices, stride);
+    return {
+        name,
+        geometry: { vertices, indices, bounds },
+        materialIndex: prim.material ?? 0,
+        skinned,
+    };
+}
+/**
+ * Interleave skinned vertex data into 56-byte format.
+ * Layout: pos(3f) + normal(3f) + uv(2f) + joints_u16x4(2f) + weights(4f)
+ */
+function interleaveSkinnedVertices(doc, positions, normals, uvs, vertexCount, jointsAccessorIdx, weightsAccessorIdx) {
+    const stride = SKINNED_VERTEX_STRIDE_FLOATS; // 14
+    const jointsRaw = readAccessor(doc, jointsAccessorIdx);
+    const weightsRaw = readAccessor(doc, weightsAccessorIdx);
+    const vertices = new Float32Array(vertexCount * stride);
+    // Uint16 view overlaid on same buffer for packing joint indices
+    const verticesU16 = new Uint16Array(vertices.buffer);
+    for (let i = 0; i < vertexCount; i++) {
+        const vo = i * stride;
+        const p = i * 3;
+        const u = i * 2;
+        const j = i * 4;
+        // Position
+        vertices[vo] = positions[p];
+        vertices[vo + 1] = positions[p + 1];
+        vertices[vo + 2] = positions[p + 2];
+        // Normal
+        vertices[vo + 3] = normals[p];
+        vertices[vo + 4] = normals[p + 1];
+        vertices[vo + 5] = normals[p + 2];
+        // UV
+        vertices[vo + 6] = uvs[u];
+        vertices[vo + 7] = uvs[u + 1];
+        // Joint indices: 4 × u16 at byte offset 32 (= float offset 8 × 4 bytes)
+        const u16Offset = (vo * 4 + 32) / 2; // byte offset → u16 index
+        verticesU16[u16Offset] = jointsRaw[j] & 0xFFFF;
+        verticesU16[u16Offset + 1] = jointsRaw[j + 1] & 0xFFFF;
+        verticesU16[u16Offset + 2] = jointsRaw[j + 2] & 0xFFFF;
+        verticesU16[u16Offset + 3] = jointsRaw[j + 3] & 0xFFFF;
+        // Weights: 4 × f32 at float offset 10 (byte offset 40)
+        vertices[vo + 10] = weightsRaw[j];
+        vertices[vo + 11] = weightsRaw[j + 1];
+        vertices[vo + 12] = weightsRaw[j + 2];
+        vertices[vo + 13] = weightsRaw[j + 3];
+    }
+    return vertices;
+}
+/** Generate flat normals from triangle positions. */
+function generateFlatNormals(positions, vertexCount) {
+    const normals = new Float32Array(vertexCount * 3);
+    const triCount = Math.floor(vertexCount / 3);
+    for (let t = 0; t < triCount; t++) {
+        const i0 = t * 9;
+        const ax = positions[i0 + 3] - positions[i0];
+        const ay = positions[i0 + 4] - positions[i0 + 1];
+        const az = positions[i0 + 5] - positions[i0 + 2];
+        const bx = positions[i0 + 6] - positions[i0];
+        const by = positions[i0 + 7] - positions[i0 + 1];
+        const bz = positions[i0 + 8] - positions[i0 + 2];
+        let nx = ay * bz - az * by;
+        let ny = az * bx - ax * bz;
+        let nz = ax * by - ay * bx;
+        const len = Math.sqrt(nx * nx + ny * ny + nz * nz);
+        if (len > 0) {
+            nx /= len;
+            ny /= len;
+            nz /= len;
+        }
+        const n0 = t * 9;
+        for (let v = 0; v < 3; v++) {
+            normals[n0 + v * 3] = nx;
+            normals[n0 + v * 3 + 1] = ny;
+            normals[n0 + v * 3 + 2] = nz;
+        }
+    }
+    return normals;
+}
+//# sourceMappingURL=gltf-mesh.js.map

package/dist/gltf-mesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-mesh.js","sourceRoot":"","sources":["../src/gltf-mesh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAiB;IAC7C,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IAEzC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,CAAE,CAAC;QACjC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;YACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAE,CAAC;YACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;gBAC3C,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,EAAE,EAAE,CAAC;gBACjC,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CACvB,GAAiB,EACjB,IAAmB,EACnB,IAAY;IAEZ,2BAA2B;IAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,WAAW,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,8BAA8B,CAAC,CAAC;IAC5F,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,EAAE,WAAW,CAAiB,CAAC;IACjE,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAEzC,6DAA6D;IAC7D,IAAI,OAAqB,CAAC;IAC1B,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,cAAc,CAAiB,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACxD,CAAC;IAED,wCAAwC;IACxC,IAAI,GAAiB,CAAC;IACtB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,UAAU,CAAiB,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,IAAI,YAAY,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,6BAA6B;IAC7B,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,cAAc,KAAK,SAAS,IAAI,eAAe,KAAK,SAAS,CAAC;IAE9E,IAAI,QAAsB,CAAC;IAC3B,IAAI,MAAc,CAAC;IAEnB,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,4BAA4B,CAAC,CAAC,KAAK;QAC5C,QAAQ,GAAG,yBAAyB,CAClC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EACzC,cAAe,EAAE,eAAgB,CAClC,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,oBAAoB,CAAC,CAAC,IAAI;QACnC,QAAQ,GAAG,IAAI,YAAY,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;YAC7B,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACrC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACrC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;YAC/B,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACnC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACnC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;YAC3B,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACjC,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,OAAkC,CAAC;IACvC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,OAAO,GAAG,GAAG,CAAC;QAChB,CAAC;aAAM,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YACtC,OAAO,GAAG,GAAG,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QAC5D,CAAC;QACD,IAAI,OAAO,YAAY,WAAW,IAAI,WAAW,GAAG,KAAK,EAAE,CAAC;YAC1D,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;YAC9D,OAAO,GAAG,GAAG,CAAC;QAChB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,WAAW,GAAG,KAAK;YAC3B,CAAC,CAAC,IAAI,WAAW,CAAC,WAAW,CAAC;YAC9B,CAAC,CAAC,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEvD,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE;QACvC,aAAa,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;QACjC,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,yBAAyB,CAChC,GAAiB,EACjB,SAAuB,EACvB,OAAqB,EACrB,GAAiB,EACjB,WAAmB,EACnB,iBAAyB,EACzB,kBAA0B;IAE1B,MAAM,MAAM,GAAG,4BAA4B,CAAC,CAAC,KAAK;IAClD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,EAAE,kBAAkB,CAAiB,CAAC;IAEzE,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC;IACxD,gEAAgE;IAChE,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAErD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEhB,WAAW;QACX,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;QAC7B,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACrC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACrC,SAAS;QACT,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACnC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACnC,KAAK;QACL,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QAC3B,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QAE/B,wEAAwE;QACxE,MAAM,SAAS,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,0BAA0B;QAC/D,WAAW,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAAC,CAAE,GAAG,MAAM,CAAC;QAChD,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,MAAM,CAAC;QACxD,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,MAAM,CAAC;QACxD,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,MAAM,CAAC;QAExD,uDAAuD;QACvD,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QACnC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACvC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACvC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;IACzC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qDAAqD;AACrD,SAAS,mBAAmB,CAAC,SAAuB,EAAE,WAAmB;IACvE,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IAE7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAE,GAAG,SAAS,CAAC,EAAE,CAAE,CAAC;QAC/C,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAE,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAE,CAAC;QACnD,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAE,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAE,CAAC;QACnD,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAE,GAAG,SAAS,CAAC,EAAE,CAAE,CAAC;QAC/C,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAE,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAE,CAAC;QACnD,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAE,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAE,CAAC;QAEnD,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC3B,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC3B,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QACnD,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YAAC,EAAE,IAAI,GAAG,CAAC;YAAC,EAAE,IAAI,GAAG,CAAC;YAAC,EAAE,IAAI,GAAG,CAAC;QAAC,CAAC;QAEjD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,OAAO,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACzB,OAAO,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAC7B,OAAO,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/gltf-parser.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Minimal glTF 2.0 / GLB parser.
+ * Handles the binary container format and accessor/bufferView resolution.
+ * No external dependencies.
+ */
+export interface GltfAccessor {
+    bufferView?: number;
+    byteOffset?: number;
+    componentType: number;
+    normalized?: boolean;
+    count: number;
+    type: string;
+    min?: number[];
+    max?: number[];
+}
+export interface GltfBufferView {
+    buffer: number;
+    byteOffset?: number;
+    byteLength: number;
+    byteStride?: number;
+}
+export interface GltfBuffer {
+    byteLength: number;
+    uri?: string;
+}
+export interface GltfImage {
+    bufferView?: number;
+    mimeType?: string;
+    uri?: string;
+}
+export interface GltfTexture {
+    source?: number;
+}
+export interface GltfMaterialPbr {
+    baseColorFactor?: number[];
+    baseColorTexture?: {
+        index: number;
+    };
+    metallicFactor?: number;
+    roughnessFactor?: number;
+}
+export interface GltfMaterial {
+    name?: string;
+    pbrMetallicRoughness?: GltfMaterialPbr;
+    alphaMode?: string;
+    alphaCutoff?: number;
+}
+export interface GltfPrimitive {
+    attributes: Record<string, number>;
+    indices?: number;
+    material?: number;
+}
+export interface GltfMesh {
+    name?: string;
+    primitives: GltfPrimitive[];
+}
+export interface GltfNode {
+    name?: string;
+    mesh?: number;
+    skin?: number;
+    children?: number[];
+    translation?: number[];
+    rotation?: number[];
+    scale?: number[];
+    matrix?: number[];
+}
+export interface GltfSkin {
+    name?: string;
+    inverseBindMatrices?: number;
+    skeleton?: number;
+    joints: number[];
+}
+export interface GltfAnimationSampler {
+    input: number;
+    output: number;
+    interpolation?: string;
+}
+export interface GltfAnimationChannel {
+    sampler: number;
+    target: {
+        node?: number;
+        path: string;
+    };
+}
+export interface GltfAnimation {
+    name?: string;
+    channels: GltfAnimationChannel[];
+    samplers: GltfAnimationSampler[];
+}
+export interface GltfScene {
+    nodes?: number[];
+}
+export interface GltfJson {
+    asset: {
+        version: string;
+    };
+    accessors?: GltfAccessor[];
+    bufferViews?: GltfBufferView[];
+    buffers?: GltfBuffer[];
+    images?: GltfImage[];
+    textures?: GltfTexture[];
+    materials?: GltfMaterial[];
+    meshes?: GltfMesh[];
+    nodes?: GltfNode[];
+    scenes?: GltfScene[];
+    scene?: number;
+    skins?: GltfSkin[];
+    animations?: GltfAnimation[];
+}
+/** Parsed glTF document with resolved binary buffers. */
+export interface GltfDocument {
+    json: GltfJson;
+    buffers: ArrayBuffer[];
+}
+/** Parse a GLB binary container into JSON + binary buffer(s). */
+export declare function parseGlb(data: ArrayBuffer): GltfDocument;
+/** Parse a standalone .gltf JSON file with external buffer(s). */
+export declare function parseGltfJson(json: GltfJson, buffers?: ArrayBuffer[]): GltfDocument;
+/** Read a typed array from an accessor. */
+export declare function readAccessor(doc: GltfDocument, accessorIndex: number): Float32Array | Uint16Array | Uint32Array | Int16Array | Uint8Array | Int8Array;
+/** Read raw bytes from a bufferView (for embedded images). */
+export declare function readBufferView(doc: GltfDocument, bufferViewIndex: number): Uint8Array;
+//# sourceMappingURL=gltf-parser.d.ts.map

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

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