@series-inc/rundot-3d-engine 0.6.7 → 0.6.9

package/README.md

@@ -1,80 +1,80 @@
-# Run.3DEngine
-
-A Three.js-based game engine with ECS architecture, physics, navigation, and comprehensive game systems.
-
-## Features
-
-- **ECS Architecture**: Component-based GameObject system
-- **Physics**: Rapier3D integration with RigidBody components
-- **Navigation**: Dynamic navigation system with A* pathfinding
-- **Animation**: Advanced animation system with blending and retargeting
-- **Audio**: 2D/3D audio system with music management
-- **UI**: Comprehensive UI system with utilities
-- **Camera**: Follow camera, free camera with smooth transitions
-- **Asset Loading**: FBX, GLB, OBJ loaders with skeleton caching
-- **Particles**: Flexible particle system
-- **Input**: Cross-platform input management with mobile support
-
-## Installation
-
-### As npm workspace dependency
-```json
-{
-  "dependencies": {
-    "@series-inc/rundot-3d-engine": "^0.2.0"
-  }
-}
-```
-
-### As git submodule
-```bash
-git submodule add https://github.com/series-ai/Run.3DEngine.git rundot-3D-engine
-git submodule update --init --recursive
-```
-
-## Usage
-
-```typescript
-import { VenusGame, GameObject, Component } from "@series-inc/rundot-3d-engine"
-import { PhysicsSystem, UISystem } from "@series-inc/rundot-3d-engine/systems"
-
-class MyGame extends VenusGame {
-  async onCreate(): Promise<void> {
-    // Initialize game
-  }
-  
-  async onStart(): Promise<void> {
-    // Start game logic
-  }
-}
-```
-
-## Dependencies
-
-- **three** ^0.180.0
-- **@dimforge/rapier3d** ^0.11.2
-- **@series-inc/rundot-game-sdk** 5.0.4
-- **@series-inc/stowkit-reader** ^0.1.42
-- **@series-inc/stowkit-three-loader** ^0.1.40
-
-## Development
-
-```bash
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Watch mode
-npm run dev
-
-# Lint
-npm run lint
-```
-
-## License
-
-See LICENSE file in root repository.
-
-
+# Run.3DEngine
+
+A Three.js-based game engine with ECS architecture, physics, navigation, and comprehensive game systems.
+
+## Features
+
+- **ECS Architecture**: Component-based GameObject system
+- **Physics**: Rapier3D integration with RigidBody components
+- **Navigation**: Dynamic navigation system with A* pathfinding
+- **Animation**: Advanced animation system with blending and retargeting
+- **Audio**: 2D/3D audio system with music management
+- **UI**: Comprehensive UI system with utilities
+- **Camera**: Follow camera, free camera with smooth transitions
+- **Asset Loading**: FBX, GLB, OBJ loaders with skeleton caching
+- **Particles**: Flexible particle system
+- **Input**: Cross-platform input management with mobile support
+
+## Installation
+
+### As npm workspace dependency
+```json
+{
+  "dependencies": {
+    "@series-inc/rundot-3d-engine": "^0.2.0"
+  }
+}
+```
+
+### As git submodule
+```bash
+git submodule add https://github.com/series-ai/Run.3DEngine.git rundot-3D-engine
+git submodule update --init --recursive
+```
+
+## Usage
+
+```typescript
+import { VenusGame, GameObject, Component } from "@series-inc/rundot-3d-engine"
+import { PhysicsSystem, UISystem } from "@series-inc/rundot-3d-engine/systems"
+
+class MyGame extends VenusGame {
+  async onCreate(): Promise<void> {
+    // Initialize game
+  }
+  
+  async onStart(): Promise<void> {
+    // Start game logic
+  }
+}
+```
+
+## Dependencies
+
+- **three** ^0.180.0
+- **@dimforge/rapier3d** ^0.11.2
+- **@series-inc/rundot-game-sdk** 5.0.4
+- **@series-inc/stowkit-reader** ^0.1.42
+- **@series-inc/stowkit-three-loader** ^0.1.40
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Lint
+npm run lint
+```
+
+## License
+
+See LICENSE file in root repository.
+
+

package/dist/{chunk-SCNHMGS3.js → chunk-UDJVZHS6.js}

@@ -5701,6 +5701,28 @@ var StowKitSystem = class _StowKitSystem {
     );
     return results;
   }
+  /**
+   * Pre-decode audio clips so they're ready before the loading screen hides.
+   * Decoded audio is cached in IndexedDB — subsequent loads are near-instant.
+   */
+  async preloadAudio(audioNames) {
+    const start = performance.now();
+    const results = /* @__PURE__ */ new Map();
+    await Promise.allSettled(
+      audioNames.map(async (name) => {
+        try {
+          const audio = await this.getAudio(name);
+          results.set(name, audio);
+        } catch (e) {
+          console.warn(`[StowKitSystem] Failed to preload audio "${name}":`, e);
+        }
+      })
+    );
+    console.log(
+      `[StowKitSystem] Preloaded ${results.size}/${audioNames.length} audio clips in ${(performance.now() - start).toFixed(0)}ms`
+    );
+    return results;
+  }
   // ============================================
   // Pack Access
   // ============================================
@@ -6220,4 +6242,4 @@ export {
   PrefabLoader,
   StowKitSystem
 };
-//# sourceMappingURL=chunk-SCNHMGS3.js.map
+//# sourceMappingURL=chunk-UDJVZHS6.js.map