@stowkit/three-loader 0.1.10 → 0.1.12

package/README.md

@@ -11,24 +11,20 @@ npm install @stowkit/three-loader three
 ## Quick Start
 
 ```typescript
-import * as THREE from 'three';
 import { StowKitLoader } from '@stowkit/three-loader';
 
-// Create loader (auto-configured with defaults)
-// Basis transcoder: /stowkit/basis/ (auto-included)
-// Draco decoder: /stowkit/draco/ (auto-included)
-const loader = new StowKitLoader();
+// Load a pack (auto-initializes with defaults)
+const pack = await StowKitLoader.load('assets.stow');
 
-// Optional: Override paths only if you have custom locations
-// loader.setTranscoderPath('/custom-basis-path/');
-// loader.setDracoDecoderPath('/custom-draco-path/');
+// Load assets by name - simple and clean!
+const mesh = await pack.loadMesh('models/character');
+const texture = await pack.loadTexture('textures/wood');
+const audio = await pack.loadAudio('sounds/bgm', audioListener);
 
-// Open a .stow pack file
-await loader.openPack('assets.stow');
-
-// Load a mesh with automatic textures and materials
-const scene = await loader.loadMesh('', 'models/character.mesh');
-threeScene.add(scene);
+// Use in Three.js
+scene.add(mesh);
+material.map = texture;
+audio.play();
 ```
 
 ## Features
@@ -45,114 +41,74 @@ threeScene.add(scene);
 
 ## API Reference
 
-### Constructor
+### Loading Packs
 
-```typescript
-new StowKitLoader(manager?: THREE.LoadingManager, parameters?: StowKitLoaderParameters)
-```
+#### `StowKitLoader.load(url: string, options?: StowKitLoaderOptions): Promise<StowKitPack>`
 
-**Parameters (all optional):**
+Load a .stow pack file. Returns a `StowKitPack` instance for loading assets.
+
+**Options (all optional):**
 ```typescript
-interface StowKitLoaderParameters {
-  transcoderPath?: string;  // Path to Basis Universal transcoder (default: '/basis/')
-  wasmPath?: string;        // Path to WASM reader module (default: '/stowkit_reader.wasm')
-  reader?: StowKitReader;   // Custom reader instance (advanced)
+interface StowKitLoaderOptions {
+  basisPath?: string;   // Path to Basis Universal transcoder (default: '/stowkit/basis/')
+  dracoPath?: string;   // Path to Draco decoder (default: '/stowkit/draco/')
+  wasmPath?: string;    // Path to WASM reader module (default: '/stowkit_reader.wasm')
 }
 ```
 
-**Example:**
+**Examples:**
 ```typescript
-// Default configuration
-const loader = new StowKitLoader();
+// Default paths (recommended)
+const pack = await StowKitLoader.load('assets.stow');
 
 // Custom paths
-const loader = new StowKitLoader(undefined, {
-  transcoderPath: '/my-basis-path/',
+const pack = await StowKitLoader.load('game.stow', {
+  basisPath: '/custom/basis/',
+  dracoPath: '/custom/draco/',
   wasmPath: '/custom/stowkit_reader.wasm'
 });
 ```
 
-### Opening Packs
-
-#### `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>`
+### StowKitPack Methods
 
-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;
-```
+const wood = await pack.loadTexture('textures/wood');
+const metal = await pack.loadTexture('textures/metal');
 
-#### `loadTextureByIndex(index: number, onLoad?, onProgress?, onError?): Promise<THREE.CompressedTexture>`
-
-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/dist/StowKitLoader.d.ts

@@ -1,219 +1,44 @@
-import * as THREE from 'three';
-import { StowKitReader } from '@stowkit/reader';
-export interface StowKitLoaderParameters {
+import { StowKitPack } from './StowKitPack';
+export interface StowKitLoaderOptions {
     /**
      * Path to basis transcoder for KTX2 texture loading
-     * @default '/basis/'
+     * @default '/stowkit/basis/'
      */
-    transcoderPath?: string;
+    basisPath?: string;
+    /**
+     * Path to Draco decoder for mesh decompression
+     * @default '/stowkit/draco/'
+     */
+    dracoPath?: string;
     /**
      * Path to WASM reader module
      * @default '/stowkit_reader.wasm'
      */
     wasmPath?: string;
-    /**
-     * Custom StowKitReader instance (optional)
-     */
-    reader?: StowKitReader;
 }
 /**
- * Three.js loader for StowKit asset packs (.stow files)
+ * Three.js loader for StowKit asset packs
  *
  * Usage:
  * ```typescript
- * const loader = new StowKitLoader();
- * loader.setTranscoderPath('/basis/');
- *
- * // Load a mesh asset
- * loader.loadMesh('assets.stow', 'path/to/mesh', (scene) => {
- *   threeScene.add(scene);
- * });
+ * const pack = await StowKitLoader.load('assets.stow');
+ * const mesh = await pack.loadMesh('models/character');
+ * const texture = await pack.loadTexture('textures/diffuse');
+ * const audio = await pack.loadAudio('sounds/bgm', listener);
  * ```
  */
-export declare class StowKitLoader extends THREE.Loader {
-    private reader;
-    private ktx2Loader;
-    private dracoLoader;
-    private ownedReader;
-    constructor(manager?: THREE.LoadingManager, parameters?: StowKitLoaderParameters);
-    /**
-     * Set the path to the Draco decoder
-     */
-    setDracoDecoderPath(path: string): this;
-    /**
-     * Set the path to the Basis Universal transcoder
-     */
-    setTranscoderPath(path: string): this;
-    /**
-     * Detect WebGL support for compressed textures
-     */
-    detectSupport(renderer: THREE.WebGLRenderer): this;
-    /**
-     * Open a .stow pack file (call this first if loading multiple assets)
-     * @param url - URL to the .stow file
-     */
-    openPack(url: string): Promise<void>;
-    /**
-     * Load and parse a mesh asset by its index
-     * @param index - Asset index
-     * @param onLoad - Callback when loading completes
-     * @param onProgress - Progress callback
-     * @param onError - Error callback
-     */
-    loadMeshByIndex(index: number, onLoad?: (scene: THREE.Group) => void, onProgress?: (event: ProgressEvent) => void, onError?: (error: Error) => void): Promise<THREE.Group>;
-    /**
-     * Load and parse a mesh asset from a StowKit pack
-     * @param url - URL to the .stow file (or omit if already opened with openPack)
-     * @param assetPath - Path to the mesh asset within the pack
-     * @param onLoad - Callback when loading completes
-     * @param onProgress - Progress callback
-     * @param onError - Error callback
-     */
-    loadMesh(url: string, assetPath: string, onLoad?: (scene: THREE.Group) => void, onProgress?: (event: ProgressEvent) => void, onError?: (error: Error) => void): Promise<THREE.Group>;
-    /**
-     * Load textures for materials
-     */
-    private loadMaterialTextures;
-    /**
-     * Load a KTX2 texture from binary data
-     */
-    private loadKTX2Texture;
-    /**
-     * Apply texture to appropriate material property
-     */
-    private applyTextureToMaterial;
-    /**
-     * Load a texture asset from a StowKit pack
-     * @param url - URL to the .stow file (or omit if already opened with openPack)
-     * @param assetPath - Path to the texture asset within the pack
-     * @param onLoad - Callback when loading completes
-     * @param onProgress - Progress callback
-     * @param onError - Error callback
-     */
-    loadTexture(url: string, assetPath: string, onLoad?: (texture: THREE.CompressedTexture) => void, onProgress?: (event: ProgressEvent) => void, onError?: (error: Error) => void): Promise<THREE.CompressedTexture>;
-    /**
-     * Load a texture asset by its index in the pack
-     * @param index - Asset index
-     * @param onLoad - Callback when loading completes
-     * @param onProgress - Progress callback
-     * @param onError - Error callback
-     */
-    loadTextureByIndex(index: number, onLoad?: (texture: THREE.CompressedTexture) => void, onProgress?: (event: ProgressEvent) => void, onError?: (error: Error) => void): Promise<THREE.CompressedTexture>;
-    /**
-     * Load an audio asset from a StowKit pack
-     * @param url - URL to the .stow file (or omit if already opened with openPack)
-     * @param assetPath - Path to the audio asset within the pack
-     * @param listener - THREE.AudioListener to attach to
-     * @param onLoad - Callback when loading completes
-     * @param onProgress - Progress callback
-     * @param onError - Error callback
-     */
-    loadAudio(url: string, assetPath: string, listener: THREE.AudioListener, onLoad?: (audio: THREE.Audio) => void, onProgress?: (event: ProgressEvent) => void, onError?: (error: Error) => void): Promise<THREE.Audio>;
-    /**
-     * Get metadata for an audio asset
-     * @param assetPath - Path to the audio asset within the pack
-     */
-    getAudioMetadata(assetPath: string): {
-        stringId: string;
-        sampleRate: number;
-        channels: number;
-        durationMs: number;
-    } | null;
-    /**
-     * Get metadata for a texture asset
-     * @param assetPath - Path to the texture asset within the pack
-     */
-    getTextureMetadata(assetPath: string): {
-        width: number;
-        height: number;
-        channels: number;
-        isKtx2: boolean;
-        channelFormat: number;
-        stringId: string;
-    } | null;
-    /**
-     * Load material schema information by index
-     * @param index - Asset index
-     */
-    loadMaterialSchemaByIndex(index: number): {
-        stringId: string;
-        schemaName: string;
-        fields: Array<{
-            name: string;
-            type: 'Texture' | 'Color' | 'Float' | 'Vec2' | 'Vec3' | 'Vec4' | 'Int';
-            previewFlag: 'None' | 'MainTex' | 'Tint';
-            defaultValue: [number, number, number, number];
-        }>;
-    } | null;
-    /**
-     * Load material schema information by path
-     * @param assetPath - Path to the material schema asset
-     */
-    loadMaterialSchema(assetPath: string): {
-        stringId: string;
-        schemaName: string;
-        fields: Array<{
-            name: string;
-            type: 'Texture' | 'Color' | 'Float' | 'Vec2' | 'Vec3' | 'Vec4' | 'Int';
-            previewFlag: 'None' | 'MainTex' | 'Tint';
-            defaultValue: [number, number, number, number];
-        }>;
-    } | null;
-    /**
-     * Get material information from a loaded mesh
-     * Returns material data including properties and texture references
-     */
-    getMeshMaterials(assetPath: string): Array<{
-        name: string;
-        schemaId: string;
-        properties: Array<{
-            fieldName: string;
-            value: [number, number, number, number];
-            textureId: string;
-        }>;
-    }> | null;
-    /**
-     * Open a .stow file from a File or ArrayBuffer
-     */
-    open(fileOrBuffer: ArrayBuffer | File): Promise<boolean>;
-    /**
-     * Get the total number of assets
-     */
-    getAssetCount(): number;
-    /**
-     * Get info about a specific asset
-     */
-    getAssetInfo(index: number): any;
-    /**
-     * Read asset data by index
-     */
-    readAssetData(index: number): Uint8Array | null;
-    /**
-     * Read asset metadata by index
-     */
-    readAssetMetadata(index: number): Uint8Array | null;
-    /**
-     * Parse texture metadata
-     */
-    parseTextureMetadata(metadataBytes: Uint8Array): any;
-    /**
-     * Create an HTML audio element for preview
-     * @param index - Asset index
-     */
-    createAudioPreview(index: number): Promise<HTMLAudioElement>;
+export declare class StowKitLoader {
+    private static reader;
+    private static ktx2Loader;
+    private static dracoLoader;
+    private static initialized;
     /**
-     * List all assets in the opened pack
+     * Load a .stow pack file
      */
-    listAssets(): Array<{
-        index: number;
-        name?: string;
-        type: number;
-        dataSize: number;
-        metadataSize: number;
-    }>;
+    static load(url: string, options?: StowKitLoaderOptions): Promise<StowKitPack>;
     /**
-     * Dispose of resources
+     * Initialize the loader (called automatically on first load)
      */
-    dispose(): void;
+    private static initialize;
 }
 //# sourceMappingURL=StowKitLoader.d.ts.map

package/dist/StowKitLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StowKitLoader.d.ts","sourceRoot":"","sources":["../src/StowKitLoader.ts"],"names":[],"mappings":"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"}
+{"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;mBACkB,UAAU;CAwBlC"}

package/dist/StowKitPack.d.ts

@@ -0,0 +1,132 @@
+import * as THREE from 'three';
+import { KTX2Loader } from 'three/examples/jsm/loaders/KTX2Loader.js';
+import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
+import { StowKitReader } from '@stowkit/reader';
+/**
+ * Represents an opened StowKit pack with methods to load assets by name
+ */
+export declare class StowKitPack {
+    private reader;
+    private ktx2Loader;
+    private dracoLoader;
+    constructor(reader: StowKitReader, ktx2Loader: KTX2Loader, dracoLoader: DRACOLoader);
+    /**
+     * Load a mesh by its canonical path/name
+     */
+    loadMesh(assetPath: string): Promise<THREE.Group>;
+    /**
+     * Load a texture by its canonical path/name
+     */
+    loadTexture(assetPath: string): Promise<THREE.CompressedTexture>;
+    /**
+     * Load audio by its canonical path/name
+     */
+    loadAudio(assetPath: string, listener: THREE.AudioListener): Promise<THREE.Audio>;
+    /**
+     * Get list of all assets in pack
+     */
+    listAssets(): import("@stowkit/reader").AssetListItem[];
+    /**
+     * Get asset count
+     */
+    getAssetCount(): number;
+    /**
+     * Get asset info by index
+     */
+    getAssetInfo(index: number): any;
+    /**
+     * Read asset data by index
+     */
+    readAssetData(index: number): Uint8Array | null;
+    /**
+     * Read asset metadata by index
+     */
+    readAssetMetadata(index: number): Uint8Array | null;
+    /**
+     * Parse texture metadata
+     */
+    parseTextureMetadata(metadataBytes: Uint8Array): any;
+    /**
+     * Load mesh by index
+     */
+    loadMeshByIndex(index: number): Promise<THREE.Group>;
+    /**
+     * Load texture by index
+     */
+    loadTextureByIndex(index: number): Promise<THREE.CompressedTexture>;
+    /**
+     * Create HTML audio preview element
+     */
+    createAudioPreview(index: number): Promise<HTMLAudioElement>;
+    /**
+     * Get audio metadata by path
+     */
+    getAudioMetadata(assetPath: string): {
+        stringId: string;
+        sampleRate: number;
+        channels: number;
+        durationMs: number;
+    } | null;
+    /**
+     * Load material schema by index
+     */
+    loadMaterialSchemaByIndex(index: number): {
+        stringId: string;
+        schemaName: string;
+        fields: {
+            name: string;
+            type: "Texture" | "Color" | "Float" | "Vec2" | "Vec3" | "Vec4" | "Int";
+            previewFlag: "None" | "MainTex" | "Tint";
+            defaultValue: [number, number, number, number];
+        }[];
+    } | null;
+    /**
+     * Get mesh materials by index
+     */
+    getMeshMaterialsByIndex(index: number): {
+        name: string;
+        schemaId: string;
+        propertyCount: number;
+        properties: Array<{
+            fieldName: string;
+            value: [number, number, number, number];
+            textureId: string;
+        }>;
+    }[] | null;
+    /**
+     * Get material schema information
+     */
+    getMaterialSchema(assetPath: string): {
+        stringId: string;
+        schemaName: string;
+        fields: {
+            name: string;
+            type: "Texture" | "Color" | "Float" | "Vec2" | "Vec3" | "Vec4" | "Int";
+            previewFlag: "None" | "MainTex" | "Tint";
+            defaultValue: [number, number, number, number];
+        }[];
+    } | null;
+    /**
+     * Get mesh materials information
+     */
+    getMeshMaterials(assetPath: string): {
+        name: string;
+        schemaId: string;
+        propertyCount: number;
+        properties: Array<{
+            fieldName: string;
+            value: [number, number, number, number];
+            textureId: string;
+        }>;
+    }[] | null;
+    /**
+     * Close the pack and free resources
+     */
+    dispose(): void;
+    private loadMaterialTextures;
+    private loadKTX2Texture;
+    private applyTextureToMaterial;
+    private loadMaterialSchemaByIndex_internal;
+    private getMeshMaterialsByIndex_internal;
+}
+//# sourceMappingURL=StowKitPack.d.ts.map

package/dist/StowKitPack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StowKitPack.d.ts","sourceRoot":"","sources":["../src/StowKitPack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW;IAMnF;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IA+BvD;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAiBtE;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IA0BvF;;OAEG;IACH,UAAU;IAIV;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG;IAIhC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAI/C;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAInD;;OAEG;IACH,oBAAoB,CAAC,aAAa,EAAE,UAAU,GAAG,GAAG;IAIpD;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAY1D;;OAEG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAMzE;;OAEG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiBlE;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM;;;;;;IAsBlC;;OAEG;IACH,yBAAyB,CAAC,KAAK,EAAE,MAAM;;;;;;;;;;IAIvC;;OAEG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM;cA6KvB,MAAM;kBACF,MAAM;uBACD,MAAM;oBACT,KAAK,CAAC;YACd,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACxC,SAAS,EAAE,MAAM,CAAC;SACrB,CAAC;;IAhLV;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;IAOnC;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM;cA4JpB,MAAM;kBACF,MAAM;uBACD,MAAM;oBACT,KAAK,CAAC;YACd,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACxC,SAAS,EAAE,MAAM,CAAC;SACrB,CAAC;;IA5JV;;OAEG;IACH,OAAO,IAAI,IAAI;YAKD,oBAAoB;YA8BpB,eAAe;IA2B7B,OAAO,CAAC,sBAAsB;IAuB9B,OAAO,CAAC,kCAAkC;IA8C1C,OAAO,CAAC,gCAAgC;CA+D3C"}

package/dist/index.d.ts

@@ -3,6 +3,7 @@
  * Three.js loader for StowKit asset packs
  */
 export { StowKitLoader } from './StowKitLoader';
-export { MeshParser } from './MeshParser';
+export { StowKitPack } from './StowKitPack';
+export type { StowKitLoaderOptions } from './StowKitLoader';
 export type { MeshGeometryInfo, MaterialPropertyValue, MaterialData, Node, MeshMetadata } from './MeshParser';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACR,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,IAAI,EACJ,YAAY,EACf,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EACR,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,IAAI,EACJ,YAAY,EACf,MAAM,cAAc,CAAC"}