@skewedaspect/sage 0.9.0-beta.4 → 0.9.0-beta.5

package/dist/classes/entity.d.ts

@@ -36,7 +36,7 @@ interface SimpleGameEntity<EntityState extends object = object> {
 export declare abstract class GameEntityBehavior<RequiredState extends object = object> {
     abstract name: string;
     abstract eventSubscriptions: string[];
-    protected entity: SimpleGameEntity | null;
+    protected entity: SimpleGameEntity<RequiredState> | null;
     $emit(event: GameEvent): void;
     /**
      * Emits an entity:state-changed event to notify UI or other observers of state changes.
@@ -50,7 +50,7 @@ export declare abstract class GameEntityBehavior<RequiredState extends object =
      * Sets the entity for this behavior.
      * @param entity
      */
-    $setEntity(entity: SimpleGameEntity | null): void;
+    $setEntity(entity: SimpleGameEntity<RequiredState> | null): void;
     abstract processEvent(event: GameEvent, state: RequiredState): Promise<boolean> | boolean;
     update?(dt: number, state: RequiredState): void;
     destroy?(): Promise<void>;

package/dist/classes/gameLevel.d.ts

@@ -1,4 +1,5 @@
 import { Scene, TransformNode, Vector3 } from '@babylonjs/core';
+import { StaticSound } from '@babylonjs/core/AudioV2/abstractAudio/staticSound';
 import { LevelConfig, LevelContext } from "../interfaces/level.d.ts";
 import { GameEntity } from "./entity.d.ts";
 import { Level } from "./level.d.ts";
@@ -32,6 +33,10 @@ export declare class GameLevel extends Level {
     protected _entityNodes: EntityNodeData[];
     /** Entities spawned by this level */
     protected _spawnedEntities: GameEntity[];
+    /** Level-scoped sounds created from config */
+    protected _levelSounds: Map<string, StaticSound>;
+    /** Sounds that were playing before deactivation (for resume on activate) */
+    private _playingSoundsBeforeDeactivate;
     /**
      * Create a GameLevel from a configuration object
      *
@@ -49,6 +54,15 @@ export declare class GameLevel extends Level {
      * Import all meshes from the configured scene file (GLB/GLTF/Babylon) into the scene.
      */
     private _loadSceneFile;
+    /**
+     * Set up the scene environment: IBL (image-based lighting) for PBR reflections and/or a visible skybox.
+     */
+    private _processEnvironment;
+    /**
+     * Create an environment texture from an HDR or env file.
+     */
+    private _createEnvironmentTexture;
+    private _getFileExtension;
     /**
      * Process cameras: apply YAML overrides to imported cameras, create new ones, and set the active camera.
      * If no YAML cameras config exists, the first imported camera (if any) is activated.
@@ -125,6 +139,21 @@ export declare class GameLevel extends Level {
      * Create a game entity for an entity-tagged node, attaching the existing scene node to it.
      */
     private _processEntityNode;
+    /**
+     * Create level-scoped sounds from YAML config. Sounds are tracked for lifecycle management
+     * (pause on deactivate, resume on activate, dispose on unload).
+     */
+    private _processLevelSounds;
+    /**
+     * Pause all playing level sounds when the level is deactivated.
+     * Subclasses that override this must call `super.onDeactivate()`.
+     */
+    onDeactivate(): Promise<void>;
+    /**
+     * Resume previously playing level sounds when the level is reactivated.
+     * Subclasses that override this must call `super.onActivate()`.
+     */
+    onActivate(): Promise<void>;
     /**
      * Dispose of this level's resources
      */

package/dist/interfaces/level.d.ts

@@ -79,10 +79,14 @@ export interface LevelConfig {
     };
     /** Asset paths to preload before building the scene */
     preload?: string[];
+    /** Environment configuration (skybox and IBL lighting) */
+    environment?: EnvironmentConfig;
     /** Camera configuration. Keys match Blender camera names (override) or define new cameras (create). */
     cameras?: Record<string, CameraDefinition>;
     /** Light configuration. Keys match Blender light names (override) or define new lights (create). */
     lights?: Record<string, LightDefinition>;
+    /** Level-scoped sound configuration. Sounds are paused/resumed with level lifecycle. */
+    sounds?: Record<string, LevelSoundConfig>;
     /** Post-processing effects configuration */
     postProcessing?: PostProcessingConfig;
 }
@@ -148,6 +152,42 @@ export interface LightDefinition {
     angle?: number;
     exponent?: number;
 }
+/**
+ * Configuration for the scene environment: skybox visuals and IBL (image-based lighting) for PBR reflections.
+ *
+ * - `ibl` alone: sets PBR reflection source, no visible skybox
+ * - `skybox` alone with HDR/env: used for both IBL and visible skybox
+ * - `skybox` alone with JPG/PNG: visible skybox sphere, no IBL
+ * - Both `ibl` and `skybox`: separate IBL source and visible skybox (recommended for quality)
+ */
+export interface EnvironmentConfig {
+    /** HDR or env file for PBR reflections (IBL) */
+    ibl?: string;
+    /** IBL cubemap resolution in pixels (default 256) */
+    iblResolution?: number;
+    /** Skybox texture path. HDR/env creates a cubemap skybox; JPG/PNG creates a textured sphere. */
+    skybox?: string;
+    /** Skybox sphere diameter (default 1000). Only applies to JPG/PNG sphere skyboxes. */
+    skyboxSize?: number;
+    /** Y-axis rotation in radians for the environment texture */
+    rotation?: number;
+}
+/**
+ * Configuration for a level-scoped sound. Sounds are created when the level loads,
+ * paused on deactivate, resumed on activate, and disposed on unload.
+ */
+export interface LevelSoundConfig {
+    /** Path to the audio file */
+    url: string;
+    /** Audio channel name (e.g., 'music', 'sfx', 'ambient') */
+    channel?: string;
+    /** Whether to loop the sound (default false) */
+    loop?: boolean;
+    /** Whether to start playing when the level loads (default false) */
+    autoplay?: boolean;
+    /** Volume level 0-1 (default 1) */
+    volume?: number;
+}
 /**
  * Configuration for post-processing effects applied to a level's scene.
  */