@stowkit/three-loader 0.1.11 → 0.1.12

package/README.md

@@ -69,87 +69,46 @@ const pack = await StowKitLoader.load('game.stow', {
 });
 ```
 
-### Opening Packs
+### StowKitPack Methods
 
-#### `openPack(url: string): Promise<void>`
-
-Open a .stow pack file from a URL. Call this once, then load multiple assets.
-
-```typescript
-await loader.openPack('assets.stow');
-```
-
-#### `open(fileOrBuffer: ArrayBuffer | File): Promise<boolean>`
-
-Open a pack from a File or ArrayBuffer.
-
-```typescript
-// From file input
-const file = input.files[0];
-await loader.open(file);
-
-// From fetch
-const response = await fetch('assets.stow');
-const buffer = await response.arrayBuffer();
-await loader.open(buffer);
-```
+Once you have a pack loaded, use these methods to load assets:
 
 ### Loading Meshes
 
-#### `loadMesh(url: string, assetPath: string, onLoad?, onProgress?, onError?): Promise<THREE.Group>`
-
-Load a mesh asset with automatic texture and material loading.
+#### `pack.loadMesh(assetPath: string): Promise<THREE.Group>`
 
-**Parameters:**
-- `url` - URL to .stow file (empty string if already opened)
-- `assetPath` - Canonical path to mesh within pack
-- `onLoad` - Optional callback when loading completes
-- `onProgress` - Optional progress callback  
-- `onError` - Optional error callback
+Load a mesh by its canonical path/name. Automatically loads and applies textures and materials.
 
-**Returns:** `THREE.Group` containing the mesh hierarchy
-
-**Example:**
 ```typescript
-// Simple async/await
-const mesh = await loader.loadMesh('', 'models/character.mesh');
-scene.add(mesh);
+const character = await pack.loadMesh('models/character');
+const tree = await pack.loadMesh('models/tree');
+const building = await pack.loadMesh('models/building');
 
-// With callbacks (Three.js style)
-loader.loadMesh('assets.stow', 'models/tree.mesh', 
-  (scene) => {
-    threeScene.add(scene);
-  },
-  (progress) => console.log('Loading...', progress),
-  (error) => console.error('Failed:', error)
-);
+scene.add(character);
+scene.add(tree);
+scene.add(building);
 ```
 
 **What you get:**
-- Complete scene hierarchy with nodes
-- All geometries (vertices, normals, UVs, indices)
-- Materials with properties applied (colors, etc.)
-- Textures automatically loaded and applied to materials
-- Transforms (position, rotation, scale) preserved
+- ✅ Complete scene hierarchy with nodes
+- ✅ Draco-decompressed geometry (vertices, normals, UVs, indices)  
+- ✅ Materials with colors, properties applied
+- ✅ Textures automatically loaded and applied
+- ✅ Transforms (position, rotation, scale) preserved
 
 ### Loading Textures
 
-#### `loadTexture(url: string, assetPath: string, onLoad?, onProgress?, onError?): Promise<THREE.CompressedTexture>`
+#### `pack.loadTexture(assetPath: string): Promise<THREE.CompressedTexture>`
 
-Load a texture asset (KTX2 format).
+Load a KTX2 texture by its canonical path/name.
 
 ```typescript
-const texture = await loader.loadTexture('', 'textures/wood.ktx2');
-material.map = texture;
-material.needsUpdate = true;
-```
-
-#### `loadTextureByIndex(index: number, onLoad?, onProgress?, onError?): Promise<THREE.CompressedTexture>`
+const wood = await pack.loadTexture('textures/wood');
+const metal = await pack.loadTexture('textures/metal');
 
-Load a texture by its asset index (when you don't have the path).
-
-```typescript
-const texture = await loader.loadTextureByIndex(5);
+material.map = wood;
+material.roughnessMap = metal;
+material.needsUpdate = true;
 ```
 
 ### Loading Audio

package/package.json

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