@skewedaspect/sage 0.9.0-beta.0 → 0.9.0-beta.10

package/dist/behaviors/sound.d.ts

@@ -1,5 +1,6 @@
-import { Scene } from '@babylonjs/core';
+import { TransformNode } from '@babylonjs/core';
 import { GameEntityBehavior } from "../classes/entity.d.ts";
+import { GameEngine } from "../classes/gameEngine.d.ts";
 import { GameEvent } from "../classes/eventBus.d.ts";
 /**
  * Configuration for a single sound.
@@ -17,6 +18,8 @@ export interface SoundConfig {
     maxDistance?: number;
     /** Whether to autoplay when registered, default false */
     autoplay?: boolean;
+    /** Audio channel name (e.g., 'sfx', 'music'). Used with AudioManager. */
+    channel?: string;
 }
 /**
  * State interface for entities using SoundBehavior.
@@ -30,8 +33,10 @@ export interface SoundEntityState {
  * Behavior for managing sounds on an entity.
  *
  * Sounds are configured in the entity's state under the `sounds` property.
- * The behavior creates Sound instances based on the configuration and provides
- * runtime control methods.
+ * The behavior creates sounds via AudioManager (BabylonJS AudioV2).
+ *
+ * Requires AudioManager to be configured on the GameEngine. If no AudioManager is found,
+ * a warning is logged and no sounds are created.
  *
  * @example
  * ```typescript
@@ -41,8 +46,8 @@ export interface SoundEntityState {
  *     behaviors: [SoundBehavior, ...],
  *     defaultState: {
  *         sounds: {
- *             jump: { url: 'sounds/jump.mp3', volume: 0.8 },
- *             footstep: { url: 'sounds/footstep.mp3', loop: true }
+ *             jump: { url: 'sounds/jump.mp3', volume: 0.8, channel: 'sfx' },
+ *             footstep: { url: 'sounds/footstep.mp3', loop: true, channel: 'sfx' }
  *         }
  *     }
  * }
@@ -55,26 +60,18 @@ export interface SoundEntityState {
 export declare class SoundBehavior extends GameEntityBehavior<SoundEntityState> {
     name: string;
     eventSubscriptions: string[];
-    /** Map of sound name to Sound instance */
+    /** Map of sound name to StaticSound instance */
     private _sounds;
-    /** Reference to the scene for creating sounds */
-    private _scene;
     /** Whether sounds have been initialized */
     private _initialized;
-    /**
-     * Initialize the behavior with a scene reference.
-     * This creates all Sound instances based on the entity's state.sounds configuration.
-     *
-     * @param scene
-     */
-    initialize(scene: Scene): void;
-    /**
-     * Process events. Override to handle action events that should trigger sounds.
-     */
+    /** AudioManager reference */
+    private _audioManager;
+    /** Node reference for spatial detach on cleanup */
+    private _node;
+    private _log;
+    onNodeAttached(node: TransformNode, gameEngine: GameEngine): void;
     processEvent(_event: GameEvent, _state: SoundEntityState): boolean;
-    /**
-     * Called when the entity is destroyed.
-     */
+    onReset(_state: SoundEntityState): void;
     destroy(): Promise<void>;
     private _createSound;
     private _disposeSounds;

package/dist/classes/bindings/toggle.d.ts

@@ -1,7 +1,7 @@
 import { GameEventBus } from "../eventBus.d.ts";
 import { Action } from "../../interfaces/action.d.ts";
 import { Binding, ToggleBindingDefinition } from "../../interfaces/binding.d.ts";
-import { DeviceValueReader, InputState } from "../../interfaces/input.d.ts";
+import { DeviceType, DeviceValueReader, InputState } from "../../interfaces/input.d.ts";
 /**
  * Options for configuring a toggle binding
  */
@@ -49,6 +49,7 @@ export declare class ToggleBinding implements Binding {
     readonly action: Action;
     readonly context?: string;
     readonly deviceID: string;
+    readonly deviceType: DeviceType;
     readonly reader: DeviceValueReader;
     private readonly _invert;
     private readonly _threshold;
@@ -87,10 +88,11 @@ export declare class ToggleBinding implements Binding {
      *
      * @param action
      * @param deviceID
+     * @param deviceType
      * @param reader
      * @param options
      */
-    constructor(action: Action, deviceID: string, reader: DeviceValueReader, options?: ToggleBindingOptions);
+    constructor(action: Action, deviceID: string, deviceType: DeviceType, reader: DeviceValueReader, options?: ToggleBindingOptions);
     /**
      * Process input state and emit an action event if the toggle flipped.
      *
@@ -99,9 +101,10 @@ export declare class ToggleBinding implements Binding {
      */
     process(state: InputState, eventBus: GameEventBus): void;
     /**
-     * Reset edge-detection state so the next input is evaluated from a clean baseline.
+     * Reset edge-detection state for a context activation. When a state is provided, primes from the current physical
+     * input so that already-held inputs don't produce phantom edges in the newly activated context.
      */
-    resetEdgeState(): void;
+    resetEdgeState(state?: InputState): void;
     /**
      * Reset toggle to its initial state
      */

package/dist/classes/bindings/trigger.d.ts

@@ -1,7 +1,7 @@
 import { GameEventBus } from "../eventBus.d.ts";
 import { Action } from "../../interfaces/action.d.ts";
 import { Binding, TriggerBindingDefinition } from "../../interfaces/binding.d.ts";
-import { DeviceValueReader, InputState } from "../../interfaces/input.d.ts";
+import { DeviceType, DeviceValueReader, InputState } from "../../interfaces/input.d.ts";
 /**
  * All supported edge modes for validation
  */
@@ -43,6 +43,7 @@ export declare class TriggerBinding implements Binding {
     readonly action: Action;
     readonly context?: string;
     readonly deviceID: string;
+    readonly deviceType: DeviceType;
     readonly reader: DeviceValueReader;
     private readonly _edgeMode;
     private readonly _threshold;
@@ -56,10 +57,11 @@ export declare class TriggerBinding implements Binding {
      *
      * @param action
      * @param deviceID
+     * @param deviceType
      * @param reader
      * @param options
      */
-    constructor(action: Action, deviceID: string, reader: DeviceValueReader, options?: TriggerBindingOptions);
+    constructor(action: Action, deviceID: string, deviceType: DeviceType, reader: DeviceValueReader, options?: TriggerBindingOptions);
     /**
      * Process input state and emit an action event on the configured edge transition(s).
      *
@@ -68,9 +70,10 @@ export declare class TriggerBinding implements Binding {
      */
     process(state: InputState, eventBus: GameEventBus): void;
     /**
-     * Reset edge-detection state so the next input is evaluated from a clean baseline.
+     * Reset edge-detection state for a context activation. When a state is provided, primes from the current physical
+     * input so that already-held inputs don't produce phantom rising edges in the newly activated context.
      */
-    resetEdgeState(): void;
+    resetEdgeState(state?: InputState): void;
     /**
      * Returns a JSON-serializable representation of this trigger binding.
      */

package/dist/classes/bindings/value.d.ts

@@ -1,7 +1,7 @@
 import { GameEventBus } from "../eventBus.d.ts";
 import { Action } from "../../interfaces/action.d.ts";
 import { Binding, ValueBindingDefinition } from "../../interfaces/binding.d.ts";
-import { DeviceValueReader, InputState } from "../../interfaces/input.d.ts";
+import { DeviceType, DeviceValueReader, InputState } from "../../interfaces/input.d.ts";
 /**
  * Options for configuring a value binding
  */
@@ -61,6 +61,7 @@ export declare class ValueBinding implements Binding {
     readonly action: Action;
     readonly context?: string;
     readonly deviceID: string;
+    readonly deviceType: DeviceType;
     readonly reader: DeviceValueReader;
     private readonly _scale;
     private readonly _offset;
@@ -84,7 +85,7 @@ export declare class ValueBinding implements Binding {
      * @param reader
      * @param options
      */
-    constructor(action: Action, deviceID: string, reader: DeviceValueReader, options?: ValueBindingOptions);
+    constructor(action: Action, deviceID: string, deviceType: DeviceType, reader: DeviceValueReader, options?: ValueBindingOptions);
     /**
      * Process input state, apply scaling/deadzone/clamping, and emit an action event if the value changed.
      *
@@ -95,7 +96,7 @@ export declare class ValueBinding implements Binding {
     /**
      * No-op for value bindings — they have no edge-detection state to reset.
      */
-    resetEdgeState(): void;
+    resetEdgeState(_state?: InputState): void;
     /**
      * Returns a JSON-serializable representation of this value binding.
      */

package/dist/classes/entity.d.ts

@@ -2,6 +2,27 @@ import { TransformNode } from '@babylonjs/core';
 import { GameEntityBehaviorConstructor } from "../interfaces/entity.d.ts";
 import { Destroyable } from "../interfaces/lifecycle.d.ts";
 import { GameEvent, GameEventBus } from "./eventBus.d.ts";
+import { GameEngine } from "./gameEngine.d.ts";
+/**
+ * Result of a request sent to an entity's behaviors.
+ * `success: true` means a behavior handled the request and returned a value.
+ * `success: false` means no behavior handled it, or a behavior threw an error.
+ */
+export type RequestResult<T> = {
+    success: true;
+    value: T;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Narrow interface for entity-to-manager messaging delegation.
+ * Avoids a circular import between entity.ts and managers/entity.ts.
+ */
+interface EntityMessenger {
+    send(target: string, type: string, payload?: unknown, senderID?: string): Promise<void>;
+    request<T>(target: string, type: string, payload?: unknown, senderID?: string): Promise<RequestResult<T>>;
+}
 /**
  * Options for attaching a behavior at a specific position.
  * Only one positioning option should be specified.
@@ -26,6 +47,8 @@ interface SimpleGameEntity<EntityState extends object = object> {
     state: EntityState;
     eventBus: GameEventBus;
     tags: ReadonlySet<string>;
+    send(target: string, type: string, payload?: unknown): Promise<void>;
+    request<T>(target: string, type: string, payload?: unknown): Promise<RequestResult<T>>;
 }
 /**
  * Base class for game entity behaviors. Subclass this to define how an entity reacts to events
@@ -35,7 +58,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.
@@ -49,8 +72,16 @@ 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;
+    /**
+     * Handles a direct request sent to this entity. Return a value to respond,
+     * or `undefined` to pass the request to the next behavior.
+     *
+     * @param event - The request event (type, payload, senderID, targetID)
+     * @param state - Current entity state
+     */
+    processRequest?(event: GameEvent, state: RequiredState): Promise<unknown> | unknown | undefined;
     update?(dt: number, state: RequiredState): void;
     destroy?(): Promise<void>;
     /**
@@ -60,8 +91,9 @@ export declare abstract class GameEntityBehavior<RequiredState extends object =
      * The scene is accessible via `node.getScene()`.
      *
      * @param node - The TransformNode (typically a Mesh) the entity is attached to.
+     * @param gameEngine - The game engine instance for accessing managers and engines.
      */
-    onNodeAttached?(node: TransformNode): void;
+    onNodeAttached?(node: TransformNode, gameEngine: GameEngine): void;
     /**
      * Called when the entity is detached from its scene node.
      * Override to clean up node-dependent resources.
@@ -100,6 +132,8 @@ export declare class GameEntity<EntityState extends object = object> implements
     /** Array of behaviors attached to the entity. Order determines event processing priority. */
     behaviors: GameEntityBehavior[];
     eventBus: GameEventBus;
+    private _gameEngine;
+    private _entityManager;
     private _tags;
     private subscriptions;
     /**
@@ -144,9 +178,10 @@ export declare class GameEntity<EntityState extends object = object> implements
      * Internal method for EntityManager to attach entity to a node.
      * Do not call directly - use EntityManager.attachToNode() instead.
      * @param node
+     * @param gameEngine
      * @internal
      */
-    $attachToNode(node: TransformNode): void;
+    $attachToNode(node: TransformNode, gameEngine: GameEngine): void;
     /**
      * Internal method for EntityManager to detach entity from its node.
      * Do not call directly - use EntityManager.detachFromNode() instead.
@@ -165,6 +200,47 @@ export declare class GameEntity<EntityState extends object = object> implements
      * @param child
      */
     $removeChild(child: GameEntity): void;
+    /**
+     * Sets the entity manager reference for cross-entity messaging.
+     * Called by the EntityManager after entity creation.
+     * @param manager
+     * @internal
+     */
+    $setEntityManager(manager: EntityMessenger): void;
+    /**
+     * Sends a fire-and-forget event directly to a specific entity's behaviors, bypassing the event bus.
+     * If the target matches this entity's own ID, dispatches locally.
+     *
+     * @param target - Entity ID or name
+     * @param type - Event type string
+     * @param payload - Optional event payload
+     */
+    send(target: string, type: string, payload?: unknown): Promise<void>;
+    /**
+     * Sends a request to a specific entity's behaviors and returns the first response.
+     * If the target matches this entity's own ID, dispatches locally.
+     *
+     * @param target - Entity ID or name
+     * @param type - Request type string
+     * @param payload - Optional request payload
+     */
+    request<T>(target: string, type: string, payload?: unknown): Promise<RequestResult<T>>;
+    /**
+     * Sends a fire-and-forget event directly to this entity's own behaviors.
+     *
+     * @param type - Event type string
+     * @param payload - Optional event payload
+     * @internal
+     */
+    $send(type: string, payload?: unknown, senderID?: string): Promise<void>;
+    /**
+     * Sends a request to this entity's own behaviors and returns the first response.
+     *
+     * @param type - Request type string
+     * @param payload - Optional request payload
+     * @internal
+     */
+    $request<T>(type: string, payload?: unknown, senderID?: string): Promise<RequestResult<T>>;
     /**
      * Resets the entity for object pool recycling.
      * Restores state and tags to defaults, detaches from node, notifies behaviors, and resets children.

package/dist/classes/gameEngine.d.ts

@@ -2,6 +2,7 @@ import { AbstractEngine, HavokPlugin } from '@babylonjs/core';
 import { GameCanvas } from "../interfaces/game.d.ts";
 import { Disposable } from "../interfaces/lifecycle.d.ts";
 import { SceneEngine } from "../engines/scene.d.ts";
+import { AudioEngine } from "../engines/audio.d.ts";
 import { AssetManager } from "../managers/asset.d.ts";
 import { BindingManager } from "../managers/binding.d.ts";
 import { GameManager } from "../managers/game.d.ts";
@@ -9,6 +10,7 @@ import { GameEntityManager } from "../managers/entity.d.ts";
 import { LevelManager } from "../managers/level.d.ts";
 import { SaveManager } from "../managers/save.d.ts";
 import { UserInputManager } from "../managers/input.d.ts";
+import { AudioManager } from "../managers/audio.d.ts";
 import { GameEvent, GameEventBus, GameEventCallback, Unsubscribe } from "./eventBus.d.ts";
 import { ActionPayload, LibraryEventPayloadMap } from "../events/payloads.d.ts";
 import { WildcardPattern } from "../events/types.d.ts";
@@ -23,14 +25,15 @@ export type GameHook = (gameEngine: GameEngine) => Promise<void>;
  * Interface representing the engines used in the game.
  * All engines must implement Disposable for proper cleanup.
  */
-interface Engines extends Record<string, Disposable> {
+interface Engines extends Record<string, Disposable | undefined> {
     sceneEngine: SceneEngine;
+    audioEngine?: AudioEngine;
 }
 /**
  * Interface representing the managers used in the game.
  * All managers must implement Disposable for proper cleanup.
  */
-interface Managers extends Record<string, Disposable> {
+interface Managers extends Record<string, Disposable | undefined> {
     assetManager: AssetManager;
     bindingManager: BindingManager;
     gameManager: GameManager;
@@ -38,6 +41,7 @@ interface Managers extends Record<string, Disposable> {
     inputManager: UserInputManager;
     levelManager: LevelManager;
     saveManager: SaveManager;
+    audioManager?: AudioManager;
 }
 /**
  * Central hub that owns the render loop, physics, event bus, and all managers.

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,43 @@ 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.
+     */
+    private _processCameras;
+    /**
+     * Create a new camera from a YAML definition.
+     */
+    private _createCamera;
+    /**
+     * Apply shared camera properties from a config to an existing camera.
+     */
+    private _applyCameraConfig;
+    /**
+     * Process lights: apply YAML overrides to imported lights and create new ones.
+     * If no YAML lights config exists, imported lights are left unchanged.
+     */
+    private _processLights;
+    /**
+     * Create a new light from a YAML definition.
+     */
+    private _createLight;
+    /**
+     * Apply shared light properties from a config to an existing light.
+     */
+    private _applyLightConfig;
+    private _toVector3;
+    private _toColor3;
     /**
      * Configure and enable the Havok physics plugin with the level's gravity settings.
      */
@@ -97,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/classes/level.d.ts

@@ -1,10 +1,7 @@
 import { Scene } from '@babylonjs/core';
 import { LoggerInterface } from "../interfaces/logger.d.ts";
 import { LevelConfig, LevelContext, LevelInstance, PropertyHandler } from "../interfaces/level.d.ts";
-import { AssetManager } from "../managers/asset.d.ts";
-import { SceneEngine } from "../engines/scene.d.ts";
-import { GameEventBus } from "./eventBus.d.ts";
-import { GameEntityManager } from "../managers/entity.d.ts";
+import { GameEngine } from "./gameEngine.d.ts";
 /**
  * Abstract base class for game levels.
  *
@@ -37,10 +34,7 @@ export declare abstract class Level implements LevelInstance {
     constructor(config: LevelConfig, context: LevelContext);
     get scene(): Scene | null;
     get isLoaded(): boolean;
-    get eventBus(): GameEventBus;
-    get assetManager(): AssetManager;
-    get entityManager(): GameEntityManager;
-    get sceneEngine(): SceneEngine;
+    get gameEngine(): GameEngine;
     get propertyHandlers(): Map<string, PropertyHandler>;
     /**
      * Emit a progress event during loading
@@ -58,8 +52,7 @@ export declare abstract class Level implements LevelInstance {
      * Abstract method for building the scene content.
      * Concrete levels must implement this to create their specific content.
      *
-     * All dependencies (sceneEngine, entityManager, eventBus) are available via
-     * `this.sceneEngine`, `this.entityManager`, etc.
+     * All dependencies are available via `this.gameEngine`.
      *
      */
     protected abstract buildScene(): Promise<Scene>;

package/dist/engines/audio.d.ts

@@ -0,0 +1,19 @@
+import { AudioBus } from '@babylonjs/core/AudioV2/abstractAudio/audioBus';
+import { IStaticSoundOptions, StaticSound } from '@babylonjs/core/AudioV2/abstractAudio/staticSound';
+import { Disposable } from "../interfaces/lifecycle.d.ts";
+import { LoggingUtility } from "../utils/logger.d.ts";
+export declare class AudioEngine implements Disposable {
+    private _engine;
+    private _mainBus;
+    private _buses;
+    private _log;
+    constructor(logger: LoggingUtility);
+    initialize(): Promise<void>;
+    $teardown(): Promise<void>;
+    createBus(name: string): Promise<AudioBus>;
+    getBus(name: string): AudioBus | undefined;
+    createSound(name: string, url: string, bus?: AudioBus, options?: Partial<IStaticSoundOptions>): Promise<StaticSound>;
+    setMasterVolume(volume: number): void;
+    getMasterVolume(): number;
+    setBusVolume(bus: AudioBus, volume: number): void;
+}

package/dist/engines/scene.d.ts

@@ -1,4 +1,4 @@
-import { AbstractEngine, AbstractMesh, AssetContainer, DirectionalLight, FreeCamera, HemisphericLight, Light, Mesh, PhysicsAggregate, PhysicsShapeType, PointLight, Scene, Sound, SpotLight, Vector3 } from '@babylonjs/core';
+import { AbstractEngine, AbstractMesh, AssetContainer, DirectionalLight, FreeCamera, HemisphericLight, Light, Mesh, PhysicsAggregate, PhysicsShapeType, PointLight, RectAreaLight, Scene, SpotLight, Vector3 } from '@babylonjs/core';
 import { HavokPhysicsWithBindings } from '@babylonjs/havok';
 import { GameCanvas } from "../interfaces/game.d.ts";
 import { Disposable } from "../interfaces/lifecycle.d.ts";
@@ -58,6 +58,16 @@ export declare class SceneEngine implements Disposable {
      * @param intensity - Default: 1.0
      */
     createSpotLight(name: string, position: Vector3, direction: Vector3, angle: number, exponent: number, scene: Scene, intensity?: number): SpotLight;
+    /**
+     * Creates a rectangular area light (emits from a flat rectangle in the -Z direction)
+     * @param name
+     * @param position
+     * @param width
+     * @param height
+     * @param scene
+     * @param intensity - Default: 1.0
+     */
+    createRectAreaLight(name: string, position: Vector3, width: number, height: number, scene: Scene, intensity?: number): RectAreaLight;
     /**
      * Creates a sphere mesh. Defaults: diameter 1, 32 segments.
      * @param name
@@ -114,19 +124,6 @@ export declare class SceneEngine implements Disposable {
         restitution?: number;
         friction?: number;
     } | undefined, scene: Scene): PhysicsAggregate;
-    /**
-     * Creates and loads a sound. Defaults: no loop, no autoplay, volume 1.0, playbackRate 1.0.
-     * @param name
-     * @param url
-     * @param scene
-     * @param options
-     */
-    createSound(name: string, url: string, scene: Scene, options?: {
-        loop?: boolean;
-        autoplay?: boolean;
-        volume?: number;
-        playbackRate?: number;
-    }): Sound;
     /**
      * Loads a 3D model/asset into an AssetContainer without adding it to the scene automatically.
      * @param sceneFilename

package/dist/events/payloads.d.ts

@@ -1,5 +1,5 @@
 import { AbstractMesh } from '@babylonjs/core';
-import { InputDevice, InputState } from "../interfaces/input.d.ts";
+import { DeviceType, InputDevice, InputState } from "../interfaces/input.d.ts";
 /** Payload for input:device:connected events */
 export interface DeviceConnectedPayload {
     device: InputDevice;
@@ -14,6 +14,11 @@ export interface InputChangedPayload {
     device: InputDevice;
     state: InputState;
 }
+/** Payload for input:device-type:changed events */
+export interface DeviceTypeChangedPayload {
+    deviceType: DeviceType;
+    previousDeviceType: DeviceType | null;
+}
 /** Payload for level:progress events */
 export interface LevelProgressPayload {
     levelName: string;
@@ -111,6 +116,7 @@ export interface LibraryEventPayloadMap {
     'input:device:connected': DeviceConnectedPayload;
     'input:device:disconnected': DeviceDisconnectedPayload;
     'input:changed': InputChangedPayload;
+    'input:device-type:changed': DeviceTypeChangedPayload;
     'level:progress': LevelProgressPayload;
     'level:complete': LevelCompletePayload;
     'level:error': LevelErrorPayload;

package/dist/handlers/collider.d.ts

@@ -5,6 +5,9 @@ import { LevelManager } from "../managers/level.d.ts";
  * Supports the following properties on scene nodes:
  * - `collider` (string): Collider type - "box", "sphere", "mesh", or "none"
  * - `collider_mesh` (boolean): On a child node, marks it as the collision source for parent's "mesh" collider
+ * - `collider_mass` (number): Mass for the physics body. Defaults to 0 (static). Set > 0 for dynamic bodies.
+ * - `collider_kinematic` (boolean): When true, sets `disablePreStep = false` so the physics body
+ *   tracks mesh transform each frame. Required for animated colliders (doors, elevators, platforms).
  *
  * For "mesh" colliders, if a child node has `collider_mesh: true`, that child's geometry
  * is used for collision and the child is made invisible.

package/dist/handlers/sound.d.ts

@@ -9,6 +9,7 @@ import { LevelManager } from "../managers/level.d.ts";
  * - `sound_spatial` (boolean): Whether to use 3D spatial audio, default true
  * - `sound_distance` (number): Maximum distance for spatial audio, default 100
  * - `sound_autoplay` (boolean): Whether to autoplay, default true
+ * - `sound_channel` (string): Audio channel name, default 'ambient'
  *
  * @param levelManager
  */

package/dist/interfaces/action.d.ts

@@ -4,6 +4,7 @@
 export interface DigitalAction {
     type: 'digital';
     name: string;
+    label?: string;
 }
 /**
  * Analog action (numeric)
@@ -11,6 +12,7 @@ export interface DigitalAction {
 export interface AnalogAction {
     type: 'analog';
     name: string;
+    label?: string;
     minValue?: number;
     maxValue?: number;
 }