@stowkit/three-loader 0.1.22 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stowkit/three-loader",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "Three.js loader for StowKit asset packs",
   "main": "dist/stowkit-three-loader.js",
   "module": "dist/stowkit-three-loader.esm.js",