@stowkit/three-loader 0.1.21 → 0.1.23

package/README.md

@@ -40,6 +40,7 @@ function animate() {
 - ✅ **Animations** - Skeletal animations with automatic mixer setup
 - ✅ **Textures** - KTX2/Basis Universal GPU-compressed textures
 - ✅ **Audio** - OGG/MP3 audio with Three.js Audio integration
+- ✅ **Multiple Packs** - Load multiple .stow files simultaneously with isolated state
 - ✅ **WASM Parsing** - All binary parsing done in WASM for performance
 - ✅ **Type Safe** - Full TypeScript support
 - ✅ **Zero Config** - Works out of the box
@@ -304,6 +305,39 @@ function animate() {
 animate();
 ```
 
+## Loading Multiple Packs
+
+Each pack is fully isolated with its own state. You can load multiple packs simultaneously without any interference:
+
+```typescript
+// Load multiple packs at once
+const [environmentPack, characterPack, audioPack] = await Promise.all([
+    StowKitLoader.load('environment.stow'),
+    StowKitLoader.load('characters.stow'),
+    StowKitLoader.load('audio.stow')
+]);
+
+// Load assets from different packs
+const level = await environmentPack.loadMesh('level1');
+const player = await characterPack.loadSkinnedMesh('player');
+const bgm = await audioPack.loadAudio('theme', listener);
+
+scene.add(level);
+scene.add(player);
+bgm.play();
+
+// Each pack maintains its own asset catalog
+console.log(`Environment: ${environmentPack.getAssetCount()} assets`);
+console.log(`Characters: ${characterPack.getAssetCount()} assets`);
+console.log(`Audio: ${audioPack.getAssetCount()} assets`);
+```
+
+**Note:** Each pack creates its own WASM instance for isolated state. Dispose packs when no longer needed:
+
+```typescript
+environmentPack.dispose();
+```
+
 ## Asset Types
 
 ```typescript

package/dist/MeshParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MeshParser.d.ts","sourceRoot":"","sources":["../src/MeshParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,UAAU;IAEnB;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY;IAyBxD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG;QAClE,QAAQ,EAAE,YAAY,CAAC;QACvB,UAAU,EAAE,gBAAgB,EAAE,CAAC;QAC/B,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5B,YAAY,EAAE,YAAY,EAAE,CAAC;QAC7B,KAAK,EAAE,IAAI,EAAE,CAAC;QACd,WAAW,EAAE,WAAW,CAAC;KAC5B;IA4LD;;OAEG;WACU,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;IAyCrI;;OAEG;WACU,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IA2FtJ;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;CAK5B"}
+{"version":3,"file":"MeshParser.d.ts","sourceRoot":"","sources":["../src/MeshParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,UAAU;IAEnB;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY;IAyBxD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG;QAClE,QAAQ,EAAE,YAAY,CAAC;QACvB,UAAU,EAAE,gBAAgB,EAAE,CAAC;QAC/B,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5B,YAAY,EAAE,YAAY,EAAE,CAAC;QAC7B,KAAK,EAAE,IAAI,EAAE,CAAC;QACd,WAAW,EAAE,WAAW,CAAC;KAC5B;IAwLD;;OAEG;WACU,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;IAwCrI;;OAEG;WACU,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAuFtJ;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;CAK5B"}

package/dist/StowKitLoader.d.ts

@@ -28,10 +28,10 @@ export interface StowKitLoaderOptions {
  * ```
  */
 export declare class StowKitLoader {
-    private static reader;
     private static ktx2Loader;
     private static dracoLoader;
     private static initialized;
+    private static wasmPath;
     /**
      * Load a .stow pack file from a URL
      */

package/dist/StowKitLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StowKitLoader.d.ts","sourceRoot":"","sources":["../src/StowKitLoader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,MAAM,CAA8B;IACnD,OAAO,CAAC,MAAM,CAAC,UAAU,CAA2B;IACpD,OAAO,CAAC,MAAM,CAAC,WAAW,CAA4B;IACtD,OAAO,CAAC,MAAM,CAAC,WAAW,CAAS;IAEnC;;OAEG;WACU,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqBpF;;OAEG;WACU,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAyBlH;;OAEG;mBACkB,UAAU;CAwBlC"}
+{"version":3,"file":"StowKitLoader.d.ts","sourceRoot":"","sources":["../src/StowKitLoader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,UAAU,CAA2B;IACpD,OAAO,CAAC,MAAM,CAAC,WAAW,CAA4B;IACtD,OAAO,CAAC,MAAM,CAAC,WAAW,CAAS;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0C;IAEjE;;OAEG;WACU,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAuBpF;;OAEG;WACU,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IA2BlH;;OAEG;mBACkB,UAAU;CAoBlC"}

package/dist/stowkit-three-loader.esm.js

@@ -123,18 +123,14 @@ class MeshParser {
         }
         // Parse mesh indices
         const totalMeshRefs = nodes.reduce((sum, node) => sum + node.meshCount, 0);
-        console.log(`Parsing ${totalMeshRefs} mesh indices at offset ${offset}`);
         const meshIndices = new Uint32Array(totalMeshRefs);
         for (let i = 0; i < totalMeshRefs; i++) {
             if (offset + (i + 1) * 4 > sourceBlob.length) {
-                console.warn(`Data truncated at mesh index ${i}/${totalMeshRefs}`);
                 break;
             }
             meshIndices[i] = metaView.getUint32(offset + i * 4, true);
-            console.log(`  meshIndices[${i}] = ${meshIndices[i]}`);
         }
         offset += totalMeshRefs * 4;
-        console.log(`After mesh indices, offset = ${offset}`);
         // Second pass: read material properties
         // MaterialPropertyValue: field_name[64] + value[4*4=16] + texture_id[64] = 144 bytes
         for (let i = 0; i < materialData.length; i++) {
@@ -213,7 +209,6 @@ class MeshParser {
                 resolve(decoded);
             }, undefined, (error) => {
                 URL.revokeObjectURL(url);
-                console.error('Draco decode failed:', error);
                 reject(new Error(`Failed to decode Draco geometry: ${error}`));
             });
         });
@@ -251,7 +246,6 @@ class MeshParser {
                         material = materials[geoInfo.materialIndex];
                     }
                     else {
-                        console.warn(`  Material index ${geoInfo.materialIndex} out of bounds, using default`);
                         material = new THREE.MeshStandardMaterial({
                             color: new THREE.Color(0.8, 0.8, 0.8),
                             roughness: 0.5,
@@ -262,9 +256,6 @@ class MeshParser {
                     const mesh = new THREE.Mesh(geometry, material);
                     obj.add(mesh);
                 }
-                else {
-                    console.error(`Mesh index ${meshIndex} out of bounds (${geometries.length} geometries available)`);
-                }
             }
             nodeObjects.push(obj);
         }
@@ -290,7 +281,6 @@ class MeshParser {
                     material = materials[geoInfo.materialIndex];
                 }
                 else {
-                    console.warn(`  Material index ${geoInfo.materialIndex} out of bounds, using default`);
                     material = new THREE.MeshStandardMaterial({
                         color: new THREE.Color(0.8, 0.8, 0.8),
                         roughness: 0.5,
@@ -1063,10 +1053,12 @@ class StowKitLoader {
             throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
         }
         const arrayBuffer = await response.arrayBuffer();
-        // Open pack
-        await this.reader.open(arrayBuffer);
-        // Return pack wrapper
-        return new StowKitPack(this.reader, this.ktx2Loader, this.dracoLoader);
+        // Create a new reader instance for this pack
+        const reader = new StowKitReader(this.wasmPath);
+        await reader.init();
+        await reader.open(arrayBuffer);
+        // Return pack wrapper with its own dedicated reader
+        return new StowKitPack(reader, this.ktx2Loader, this.dracoLoader);
     }
     /**
      * Load a .stow pack from memory (ArrayBuffer, Blob, or File)
@@ -1090,25 +1082,24 @@ class StowKitLoader {
         else {
             throw new Error('Data must be ArrayBuffer, Blob, or File');
         }
-        // Open pack
-        await this.reader.open(arrayBuffer);
-        // Return pack wrapper
-        return new StowKitPack(this.reader, this.ktx2Loader, this.dracoLoader);
+        // Create a new reader instance for this pack
+        const reader = new StowKitReader(this.wasmPath);
+        await reader.init();
+        await reader.open(arrayBuffer);
+        // Return pack wrapper with its own dedicated reader
+        return new StowKitPack(reader, this.ktx2Loader, this.dracoLoader);
     }
     /**
      * Initialize the loader (called automatically on first load)
      */
     static async initialize(options) {
-        const wasmPath = options?.wasmPath || '/stowkit/stowkit_reader.wasm';
+        this.wasmPath = options?.wasmPath || '/stowkit/stowkit_reader.wasm';
         const basisPath = options?.basisPath || '/stowkit/basis/';
         const dracoPath = options?.dracoPath || '/stowkit/draco/';
-        // Initialize reader
-        this.reader = new StowKitReader(wasmPath);
-        await this.reader.init();
-        // Setup KTX2 loader
+        // Setup KTX2 loader (shared across all packs)
         this.ktx2Loader = new KTX2Loader();
         this.ktx2Loader.setTranscoderPath(basisPath);
-        // Setup Draco loader
+        // Setup Draco loader (shared across all packs)
         this.dracoLoader = new DRACOLoader();
         this.dracoLoader.setDecoderPath(dracoPath);
         // Detect support
@@ -1118,10 +1109,10 @@ class StowKitLoader {
         this.initialized = true;
     }
 }
-StowKitLoader.reader = null;
 StowKitLoader.ktx2Loader = null;
 StowKitLoader.dracoLoader = null;
 StowKitLoader.initialized = false;
+StowKitLoader.wasmPath = '/stowkit/stowkit_reader.wasm';
 
 export { StowKitLoader, StowKitPack };
 //# sourceMappingURL=stowkit-three-loader.esm.js.map