@series-inc/rundot-3d-engine 0.6.13 → 0.6.15

package/dist/systems/index.d.ts

@@ -322,7 +322,9 @@ declare class MeshColliderComponent extends Component {
     private readonly isSensor?;
     private readonly enableCollisionEvents?;
     private readonly excludeChildren;
-    constructor(meshName: string | null, colliderType?: MeshColliderType, bodyType?: RigidBodyType, isSensor?: boolean, enableCollisionEvents?: boolean, excludeChildren?: boolean);
+    /** When set, compute collider only from this named group in the mesh. */
+    private readonly subMeshName;
+    constructor(meshName: string | null, colliderType?: MeshColliderType, bodyType?: RigidBodyType, isSensor?: boolean, enableCollisionEvents?: boolean, excludeChildren?: boolean, subMeshName?: string);
     /** Iterate meshes, optionally only direct children */
     private static forEachMesh;
     /**
@@ -338,6 +340,8 @@ declare class MeshColliderComponent extends Component {
      */
     private static computeBounds;
     protected onCreate(): void;
+    /** Depth-first search for a named Group. */
+    private static findGroupByName;
     private createCollider;
     protected onCleanup(): void;
     getRigidBody(): RigidBodyComponentThree | null;
@@ -3263,6 +3267,26 @@ interface StowKitLoadConfig {
     onTimingStart?: (label: string) => void;
     onTimingEnd?: (label: string) => void;
 }
+interface PreloadAllOptions {
+    meshes?: string[];
+    skinnedMeshes?: {
+        names: string[];
+        scale?: number;
+    };
+    textures?: string[];
+    audio?: string[];
+    animations?: {
+        name: string;
+        meshName: string;
+    }[];
+}
+interface PreloadAllResult {
+    meshes: Map<string, THREE.Group>;
+    skinnedMeshes: Map<string, THREE.Group>;
+    textures: Map<string, THREE.Texture>;
+    audio: Map<string, THREE.Audio>;
+    animations: Map<string, THREE.AnimationClip>;
+}
 /**
  * StowKitSystem - Simple asset loading from build.json.
  *
@@ -3347,6 +3371,13 @@ declare class StowKitSystem {
      * Decoded audio is cached in IndexedDB — subsequent loads are near-instant.
      */
     preloadAudio(audioNames: string[]): Promise<Map<string, THREE.Audio>>;
+    /**
+     * Preload multiple asset types concurrently.
+     * All categories load in parallel via Promise.all, eliminating sequential blocking.
+     */
+    preloadAll(options: PreloadAllOptions): Promise<PreloadAllResult>;
+    private preloadTexturesInternal;
+    private preloadAnimationsInternal;
     /**
      * Get a loaded pack by alias.
      */
@@ -3448,4 +3479,4 @@ declare class StowKitSystem {
     dispose(): void;
 }
 
-export { type AABB, type ActiveTransition, AmbientLightComponent, AnimationConsoleFilter, AnimationControllerComponent, AnimationCullingManager, type AnimationCurve, AnimationEvent, AnimationGraphComponent, AnimationLibrary, AnimationLibraryComponent, AnimationPerformance, AnimationVisualizerComponent, Animatrix, AnimatrixVisualizer, Audio2D, type AudioBank2D, type AudioBank3D, type AudioClip2DConfig, type AudioClip3DConfig, AudioSystem, type AudioSystemInstance, type BlendTreeConfig, BlendType, BoxColliderComponent, type BurstConfig, CharacterAnimationController, type ClipInfo, ComparisonOperator, ComponentJSON, CrossfadeToMusic, type CurveKeyframe, CurvePresets, type CurveableValue, DEFAULT_KEY_BINDINGS, DebugPanelThree, DirectionalLightComponent, DynamicNavSystem, Easing, type EmissionConfig, type EmitterAssets, type EmitterConfig, EmitterShape, type EmitterShapeKey, type FlipConfig, type Footprint, GetMasterVolume, GetMusicSystemState, Input, InputAction, InputManager, IsAudioMuted, IsMusicReady, Main2DAudioBank, Main3DAudioBank, MaterialUtils, MathUtil, MeshColliderComponent, MusicBank, type MusicBankType, MusicSystem, type MusicSystemState, NavAgent, NavigationGrid, type NoiseConfig, type NumRange, type Parameter, ParameterType, Particle, type ParticleSystem, ParticleSystemPrefabComponent, PathVisualizationThree, type PathfindingResult, PauseMusic, PhysicsSystem, PlayAudioOneShot2D, PlayAudioOneShot3D, PlayAudioRandom2D, PlayMusic, PopulateAudioBank2D, PopulateAudioBank3D, PopulateMusicBank, Prefab, PrefabCollection, PrefabCollectionJSON, PrefabComponent, PrefabComponentConstructor, PrefabInstance, type PrefabInstantiateOptions, PrefabJSON, PrefabLoader, PrefabNode, RandomAudio2D, type RenderMode, RenderingDebugger, ResumeMusic, RigidBodyComponentThree, RigidBodyType, SecondOrderDynamics, SecondOrderDynamics1D, SetAudioMuted, SetMasterVolume, SetMusicVolume, SharedAnimationManager, SphereColliderComponent, type SplineConfigThree, type SplineDebugConfig, SplineDebugManager, type SplineDebugOptionsThree, SplineDebugRendererThree, type SplinePointThree, type SplineSegmentThree, SplineThree, SplineTypeThree, StartMusicWithAutoplayHandling, StartPlaylist, StartPlaylistWithAutoplayHandling, StopMusic, StopPlaylist, type StowKitLoadConfig, StowKitSystem, ToggleMusic, type TransitionCondition, type TransitionConfig$1 as TransitionConfig, Tween, TweenSystem, type UIElement, UILoadingScreen, type UIProgressBar, UISystem, UIUtils, type UIWorldElement, type Waypoint, addKeyframe, cloneCurve, createCurveFromPoints, createKeyframe, createParticleEmitter, evaluateCurve, evaluateCurveableValue, range, removeKeyframe, updateKeyframe };
+export { type AABB, type ActiveTransition, AmbientLightComponent, AnimationConsoleFilter, AnimationControllerComponent, AnimationCullingManager, type AnimationCurve, AnimationEvent, AnimationGraphComponent, AnimationLibrary, AnimationLibraryComponent, AnimationPerformance, AnimationVisualizerComponent, Animatrix, AnimatrixVisualizer, Audio2D, type AudioBank2D, type AudioBank3D, type AudioClip2DConfig, type AudioClip3DConfig, AudioSystem, type AudioSystemInstance, type BlendTreeConfig, BlendType, BoxColliderComponent, type BurstConfig, CharacterAnimationController, type ClipInfo, ComparisonOperator, ComponentJSON, CrossfadeToMusic, type CurveKeyframe, CurvePresets, type CurveableValue, DEFAULT_KEY_BINDINGS, DebugPanelThree, DirectionalLightComponent, DynamicNavSystem, Easing, type EmissionConfig, type EmitterAssets, type EmitterConfig, EmitterShape, type EmitterShapeKey, type FlipConfig, type Footprint, GetMasterVolume, GetMusicSystemState, Input, InputAction, InputManager, IsAudioMuted, IsMusicReady, Main2DAudioBank, Main3DAudioBank, MaterialUtils, MathUtil, MeshColliderComponent, MusicBank, type MusicBankType, MusicSystem, type MusicSystemState, NavAgent, NavigationGrid, type NoiseConfig, type NumRange, type Parameter, ParameterType, Particle, type ParticleSystem, ParticleSystemPrefabComponent, PathVisualizationThree, type PathfindingResult, PauseMusic, PhysicsSystem, PlayAudioOneShot2D, PlayAudioOneShot3D, PlayAudioRandom2D, PlayMusic, PopulateAudioBank2D, PopulateAudioBank3D, PopulateMusicBank, Prefab, PrefabCollection, PrefabCollectionJSON, PrefabComponent, PrefabComponentConstructor, PrefabInstance, type PrefabInstantiateOptions, PrefabJSON, PrefabLoader, PrefabNode, type PreloadAllOptions, type PreloadAllResult, RandomAudio2D, type RenderMode, RenderingDebugger, ResumeMusic, RigidBodyComponentThree, RigidBodyType, SecondOrderDynamics, SecondOrderDynamics1D, SetAudioMuted, SetMasterVolume, SetMusicVolume, SharedAnimationManager, SphereColliderComponent, type SplineConfigThree, type SplineDebugConfig, SplineDebugManager, type SplineDebugOptionsThree, SplineDebugRendererThree, type SplinePointThree, type SplineSegmentThree, SplineThree, SplineTypeThree, StartMusicWithAutoplayHandling, StartPlaylist, StartPlaylistWithAutoplayHandling, StopMusic, StopPlaylist, type StowKitLoadConfig, StowKitSystem, ToggleMusic, type TransitionCondition, type TransitionConfig$1 as TransitionConfig, Tween, TweenSystem, type UIElement, UILoadingScreen, type UIProgressBar, UISystem, UIUtils, type UIWorldElement, type Waypoint, addKeyframe, cloneCurve, createCurveFromPoints, createKeyframe, createParticleEmitter, evaluateCurve, evaluateCurveableValue, range, removeKeyframe, updateKeyframe };

package/dist/systems/index.js

@@ -58,7 +58,7 @@ import {
   VenusGame,
   createCollisionGroup,
   isTransformComponent
-} from "../chunk-QESAUQPW.js";
+} from "../chunk-5YJZ36HT.js";
 import {
   __decorateClass,
   __publicField
@@ -176,7 +176,7 @@ var MeshColliderComponent = class extends Component {
       console.warn("MeshColliderComponent requires a stow_mesh component on the same node");
       return null;
     }
-    return new MeshColliderComponent(stowMeshComponent.mesh.assetId, colliderType, bodyType, isSensor, enableCollisionEvents, excludeChildren);
+    return new MeshColliderComponent(stowMeshComponent.mesh.assetId, colliderType, bodyType, isSensor, enableCollisionEvents, excludeChildren, stowMeshComponent.subMesh);
   }
   rigidBody = null;
   meshName;
@@ -185,7 +185,9 @@ var MeshColliderComponent = class extends Component {
   isSensor;
   enableCollisionEvents;
   excludeChildren;
-  constructor(meshName, colliderType = "bounding_box", bodyType = "static" /* STATIC */, isSensor, enableCollisionEvents, excludeChildren = false) {
+  /** When set, compute collider only from this named group in the mesh. */
+  subMeshName;
+  constructor(meshName, colliderType = "bounding_box", bodyType = "static" /* STATIC */, isSensor, enableCollisionEvents, excludeChildren = false, subMeshName) {
     super();
     this.meshName = meshName;
     this.colliderType = colliderType;
@@ -193,6 +195,7 @@ var MeshColliderComponent = class extends Component {
     this.isSensor = isSensor;
     this.enableCollisionEvents = enableCollisionEvents;
     this.excludeChildren = excludeChildren;
+    this.subMeshName = subMeshName;
   }
   /** Iterate meshes, optionally only direct children */
   static forEachMesh(root, excludeChildren, fn) {
@@ -266,12 +269,22 @@ var MeshColliderComponent = class extends Component {
       const stowkit = StowKitSystem.getInstance();
       stowkit.getMesh(this.meshName).then((meshGroup) => {
         if (!this.isAttached()) return;
-        this.createCollider(meshGroup);
+        const target = this.subMeshName ? MeshColliderComponent.findGroupByName(meshGroup, this.subMeshName) ?? meshGroup : meshGroup;
+        this.createCollider(target);
       });
     } else {
       this.createCollider(this.gameObject);
     }
   }
+  /** Depth-first search for a named Group. */
+  static findGroupByName(root, name) {
+    for (const child of root.children) {
+      if (child.type === "Group" && child.name === name) return child;
+      const found = MeshColliderComponent.findGroupByName(child, name);
+      if (found) return found;
+    }
+    return null;
+  }
   createCollider(meshRoot) {
     const scale = this.gameObject.scale.clone();
     if (this.colliderType === "convex_hull") {