@skewedaspect/sage 0.9.0-beta.1 → 0.9.0-beta.2

package/dist/abstractAudioBus-C4O1vkCH.js

@@ -0,0 +1,15 @@
+import { A as o } from "./webAudioBaseSubGraph-KtziJf_K.js";
+class A extends o {
+  constructor(s, t) {
+    super(
+      s,
+      t,
+      3
+      /* AudioNodeType.HAS_INPUTS_AND_OUTPUTS */
+    );
+  }
+}
+export {
+  A
+};
+//# sourceMappingURL=abstractAudioBus-C4O1vkCH.js.map

package/dist/abstractAudioBus-C4O1vkCH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractAudioBus-C4O1vkCH.js","sources":["../node_modules/@babylonjs/core/AudioV2/abstractAudio/abstractAudioBus.js"],"sourcesContent":["import { AbstractAudioOutNode } from \"./abstractAudioOutNode.js\";\n/**\n * Abstract class representing an audio bus with volume control.\n *\n * An audio bus is a node in the audio graph that can have multiple inputs and outputs. It is typically used to group\n * sounds together and apply effects to them.\n */\nexport class AbstractAudioBus extends AbstractAudioOutNode {\n    constructor(name, engine) {\n        super(name, engine, 3 /* AudioNodeType.HAS_INPUTS_AND_OUTPUTS */);\n    }\n}\n//# sourceMappingURL=abstractAudioBus.js.map"],"names":["AbstractAudioBus","AbstractAudioOutNode","name","engine"],"mappings":";AAOO,MAAMA,UAAyBC,EAAqB;AAAA,EACvD,YAAYC,GAAMC,GAAQ;AACtB;AAAA,MAAMD;AAAA,MAAMC;AAAA,MAAQ;AAAA;AAAA,IAAC;AAAA,EACzB;AACJ;","x_google_ignoreList":[0]}

package/dist/abstractSoundInstance-Ojv9HUsA.js

@@ -0,0 +1,156 @@
+import { O as i, A as r } from "./sage-xiX6P4Dl.js";
+import { A as o } from "./abstractSoundSource-B4K-9snf.js";
+class _ extends o {
+  constructor(t, s, e) {
+    super(
+      t,
+      s,
+      e,
+      3
+      /* AudioNodeType.HAS_INPUTS_AND_OUTPUTS */
+    ), this._newestInstance = null, this._privateInstances = /* @__PURE__ */ new Set(), this._state = 1, this._instances = this._privateInstances, this.onEndedObservable = new i(), this._onInstanceEnded = (n) => {
+      this._newestInstance === n && (this._newestInstance = null), this._privateInstances.delete(n), this._instances.size === 0 && (this._state = 1, this.onEndedObservable.notifyObservers(this)), n.dispose();
+    };
+  }
+  /**
+   * The number of active instances of the sound that are currently playing.
+   */
+  get activeInstancesCount() {
+    return this._instances.size;
+  }
+  /**
+   * Whether the sound should start playing automatically. Defaults to `false`.
+   */
+  get autoplay() {
+    return this._options.autoplay;
+  }
+  /**
+   * The current playback time of the sound, in seconds.
+   */
+  get currentTime() {
+    const t = this._getNewestInstance();
+    return t ? t.currentTime : 0;
+  }
+  set currentTime(t) {
+    this.startOffset = t;
+    const s = this._getNewestInstance();
+    s && (s.currentTime = t);
+  }
+  /**
+   * Whether the sound should loop. Defaults to `false`.
+   */
+  get loop() {
+    return this._options.loop;
+  }
+  set loop(t) {
+    this._options.loop = t;
+  }
+  /**
+   * The maximum number of instances that can play at the same time. Defaults to `Infinity`.
+   */
+  get maxInstances() {
+    return this._options.maxInstances;
+  }
+  set maxInstances(t) {
+    this._options.maxInstances = t;
+  }
+  /**
+   * The time within the sound buffer to start playing at, in seconds. Defaults to `0`.
+   */
+  get startOffset() {
+    return this._options.startOffset;
+  }
+  set startOffset(t) {
+    this._options.startOffset = t;
+  }
+  /**
+   * The state of the sound.
+   */
+  get state() {
+    return this._state;
+  }
+  /**
+   * Releases associated resources.
+   */
+  dispose() {
+    super.dispose(), this.stop(), this._newestInstance = null, this._privateInstances.clear(), this.onEndedObservable.clear();
+  }
+  /**
+   * Pauses the sound.
+   */
+  pause() {
+    const t = this._instances.values();
+    for (let s = t.next(); !s.done; s = t.next())
+      s.value.pause();
+    this._state = 5;
+  }
+  /**
+   * Resumes the sound.
+   */
+  resume() {
+    if (this._state !== 5)
+      return;
+    const t = this._instances.values();
+    for (let s = t.next(); !s.done; s = t.next())
+      s.value.resume();
+    this._state = 3;
+  }
+  _beforePlay(t) {
+    if (this.state === 5 && this._instances.size > 0) {
+      this.resume();
+      return;
+    }
+    t.onEndedObservable.addOnce(this._onInstanceEnded), this._privateInstances.add(t), this._newestInstance = t;
+  }
+  _afterPlay(t) {
+    this._state = t.state;
+  }
+  _getNewestInstance() {
+    if (this._instances.size === 0)
+      return null;
+    if (!this._newestInstance) {
+      const t = this._instances.values();
+      for (let s = t.next(); !s.done; s = t.next())
+        this._newestInstance = s.value;
+    }
+    return this._newestInstance;
+  }
+  _setState(t) {
+    this._state = t;
+  }
+  _stopExcessInstances() {
+    if (this.maxInstances < 1 / 0) {
+      const t = Array.from(this._instances).filter(
+        (e) => e.state === 3
+        /* SoundState.Started */
+      ).length - this.maxInstances, s = this._instances.values();
+      for (let e = 0; e < t; e++)
+        s.next().value.stop();
+    }
+  }
+}
+class l extends r {
+  constructor(t) {
+    super(
+      t.engine,
+      2
+      /* AudioNodeType.HAS_OUTPUTS */
+    ), this._state = 1, this.onEndedObservable = new i(), this.onErrorObservable = new i(), this.onStateChangedObservable = new i(), this._sound = t;
+  }
+  /** The playback state of the sound instance */
+  get state() {
+    return this._state;
+  }
+  /** @internal */
+  dispose() {
+    super.dispose(), this.stop(), this.onEndedObservable.clear(), this.onStateChangedObservable.clear();
+  }
+  _setState(t) {
+    this._state !== t && (this._state = t, this.onStateChangedObservable.notifyObservers(this), this._state === 1 && this.onEndedObservable.notifyObservers(this));
+  }
+}
+export {
+  _ as A,
+  l as _
+};
+//# sourceMappingURL=abstractSoundInstance-Ojv9HUsA.js.map

package/dist/abstractSoundInstance-Ojv9HUsA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractSoundInstance-Ojv9HUsA.js","sources":["../node_modules/@babylonjs/core/AudioV2/abstractAudio/abstractSound.js","../node_modules/@babylonjs/core/AudioV2/abstractAudio/abstractSoundInstance.js"],"sourcesContent":["import { Observable } from \"../../Misc/observable.js\";\nimport { AbstractSoundSource } from \"./abstractSoundSource.js\";\n/**\n * Abstract class representing a sound in the audio engine.\n */\nexport class AbstractSound extends AbstractSoundSource {\n    constructor(name, engine, options) {\n        super(name, engine, options, 3 /* AudioNodeType.HAS_INPUTS_AND_OUTPUTS */); // Inputs are for instances.\n        this._newestInstance = null;\n        this._privateInstances = new Set();\n        this._state = 1 /* SoundState.Stopped */;\n        this._instances = this._privateInstances;\n        /**\n         * Observable for when the sound stops playing.\n         */\n        this.onEndedObservable = new Observable();\n        this._onInstanceEnded = (instance) => {\n            if (this._newestInstance === instance) {\n                this._newestInstance = null;\n            }\n            this._privateInstances.delete(instance);\n            if (this._instances.size === 0) {\n                this._state = 1 /* SoundState.Stopped */;\n                this.onEndedObservable.notifyObservers(this);\n            }\n            instance.dispose();\n        };\n    }\n    /**\n     * The number of active instances of the sound that are currently playing.\n     */\n    get activeInstancesCount() {\n        return this._instances.size;\n    }\n    /**\n     * Whether the sound should start playing automatically. Defaults to `false`.\n     */\n    get autoplay() {\n        return this._options.autoplay;\n    }\n    /**\n     * The current playback time of the sound, in seconds.\n     */\n    get currentTime() {\n        const instance = this._getNewestInstance();\n        return instance ? instance.currentTime : 0;\n    }\n    set currentTime(value) {\n        this.startOffset = value;\n        const instance = this._getNewestInstance();\n        if (instance) {\n            instance.currentTime = value;\n        }\n    }\n    /**\n     * Whether the sound should loop. Defaults to `false`.\n     */\n    get loop() {\n        return this._options.loop;\n    }\n    set loop(value) {\n        this._options.loop = value;\n    }\n    /**\n     * The maximum number of instances that can play at the same time. Defaults to `Infinity`.\n     */\n    get maxInstances() {\n        return this._options.maxInstances;\n    }\n    set maxInstances(value) {\n        this._options.maxInstances = value;\n    }\n    /**\n     * The time within the sound buffer to start playing at, in seconds. Defaults to `0`.\n     */\n    get startOffset() {\n        return this._options.startOffset;\n    }\n    set startOffset(value) {\n        this._options.startOffset = value;\n    }\n    /**\n     * The state of the sound.\n     */\n    get state() {\n        return this._state;\n    }\n    /**\n     * Releases associated resources.\n     */\n    dispose() {\n        super.dispose();\n        this.stop();\n        this._newestInstance = null;\n        this._privateInstances.clear();\n        this.onEndedObservable.clear();\n    }\n    /**\n     * Pauses the sound.\n     */\n    pause() {\n        const it = this._instances.values();\n        for (let next = it.next(); !next.done; next = it.next()) {\n            next.value.pause();\n        }\n        this._state = 5 /* SoundState.Paused */;\n    }\n    /**\n     * Resumes the sound.\n     */\n    resume() {\n        if (this._state !== 5 /* SoundState.Paused */) {\n            return;\n        }\n        const it = this._instances.values();\n        for (let next = it.next(); !next.done; next = it.next()) {\n            next.value.resume();\n        }\n        this._state = 3 /* SoundState.Started */;\n    }\n    _beforePlay(instance) {\n        if (this.state === 5 /* SoundState.Paused */ && this._instances.size > 0) {\n            this.resume();\n            return;\n        }\n        instance.onEndedObservable.addOnce(this._onInstanceEnded);\n        this._privateInstances.add(instance);\n        this._newestInstance = instance;\n    }\n    _afterPlay(instance) {\n        this._state = instance.state;\n    }\n    _getNewestInstance() {\n        if (this._instances.size === 0) {\n            return null;\n        }\n        if (!this._newestInstance) {\n            const it = this._instances.values();\n            for (let next = it.next(); !next.done; next = it.next()) {\n                this._newestInstance = next.value;\n            }\n        }\n        return this._newestInstance;\n    }\n    _setState(state) {\n        this._state = state;\n    }\n    _stopExcessInstances() {\n        if (this.maxInstances < Infinity) {\n            const numberOfInstancesToStop = Array.from(this._instances).filter((instance) => instance.state === 3 /* SoundState.Started */).length - this.maxInstances;\n            const it = this._instances.values();\n            for (let i = 0; i < numberOfInstancesToStop; i++) {\n                const instance = it.next().value;\n                instance.stop();\n            }\n        }\n    }\n}\n//# sourceMappingURL=abstractSound.js.map","import { Observable } from \"../../Misc/observable.js\";\nimport { AbstractAudioNode } from \"./abstractAudioNode.js\";\n/** @internal */\nexport class _AbstractSoundInstance extends AbstractAudioNode {\n    constructor(sound) {\n        super(sound.engine, 2 /* AudioNodeType.HAS_OUTPUTS */);\n        this._state = 1 /* SoundState.Stopped */;\n        /** Observable triggered when the sound instance's playback ends */\n        this.onEndedObservable = new Observable();\n        /** Observable triggered if the sound instance encounters an error and can not be played */\n        this.onErrorObservable = new Observable();\n        /** Observable triggered when the sound instance's state changes */\n        this.onStateChangedObservable = new Observable();\n        this._sound = sound;\n    }\n    /** The playback state of the sound instance */\n    get state() {\n        return this._state;\n    }\n    /** @internal */\n    dispose() {\n        super.dispose();\n        this.stop();\n        this.onEndedObservable.clear();\n        this.onStateChangedObservable.clear();\n    }\n    _setState(value) {\n        if (this._state === value) {\n            return;\n        }\n        this._state = value;\n        this.onStateChangedObservable.notifyObservers(this);\n        if (this._state === 1 /* SoundState.Stopped */) {\n            this.onEndedObservable.notifyObservers(this);\n        }\n    }\n}\n//# sourceMappingURL=abstractSoundInstance.js.map"],"names":["AbstractSound","AbstractSoundSource","name","engine","options","Observable","instance","value","it","next","state","numberOfInstancesToStop","i","_AbstractSoundInstance","AbstractAudioNode","sound"],"mappings":"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","x_google_ignoreList":[0,1]}

package/dist/abstractSoundSource-B4K-9snf.js

@@ -0,0 +1,49 @@
+import { A as e } from "./webAudioBaseSubGraph-KtziJf_K.js";
+class p extends e {
+  constructor(t, i, s, a = 2) {
+    super(t, i, a), this._spatialAutoUpdate = !0, this._spatialMinUpdateTime = 0, this._outBus = null, this._spatial = null, this._onOutBusDisposed = null, typeof s.spatialAutoUpdate == "boolean" && (this._spatialAutoUpdate = s.spatialAutoUpdate), typeof s.spatialMinUpdateTime == "number" && (this._spatialMinUpdateTime = s.spatialMinUpdateTime);
+  }
+  /**
+   * The output bus for the sound.
+   * @see {@link AudioEngineV2.defaultMainBus}
+   */
+  get outBus() {
+    return this._outBus;
+  }
+  set outBus(t) {
+    if (this._outBus !== t) {
+      if (this._outBus && (this._onOutBusDisposed && (this._outBus.onDisposeObservable.removeCallback(this._onOutBusDisposed), this._onOutBusDisposed = null), !this._disconnect(this._outBus)))
+        throw new Error("Disconnect failed");
+      if (this._outBus = t, this._outBus && (this._onOutBusDisposed = () => {
+        this._outBus = null;
+      }, this._outBus.onDisposeObservable.add(this._onOutBusDisposed), !this._connect(this._outBus)))
+        throw new Error("Connect failed");
+    }
+  }
+  /**
+   * The spatial audio features.
+   */
+  get spatial() {
+    return this._spatial ? this._spatial : this._initSpatialProperty();
+  }
+  /**
+   * Releases associated resources.
+   */
+  dispose() {
+    super.dispose(), this._spatial?.dispose(), this._spatial = null, this._outBus && this._onOutBusDisposed && (this._outBus.onDisposeObservable.removeCallback(this._onOutBusDisposed), this._onOutBusDisposed = null), this._outBus = null;
+  }
+  _initSpatialProperty() {
+    return this._spatial = this._createSpatialProperty(this._spatialAutoUpdate, this._spatialMinUpdateTime);
+  }
+  /** @internal */
+  get _isSpatial() {
+    return this._spatial !== null;
+  }
+  set _isSpatial(t) {
+    t && !this._spatial ? this._initSpatialProperty() : !t && this._spatial && (this._spatial.dispose(), this._spatial = null);
+  }
+}
+export {
+  p as A
+};
+//# sourceMappingURL=abstractSoundSource-B4K-9snf.js.map

package/dist/abstractSoundSource-B4K-9snf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractSoundSource-B4K-9snf.js","sources":["../node_modules/@babylonjs/core/AudioV2/abstractAudio/abstractSoundSource.js"],"sourcesContent":["import { AbstractAudioOutNode } from \"./abstractAudioOutNode.js\";\n/**\n * Abstract class representing a sound in the audio engine.\n */\nexport class AbstractSoundSource extends AbstractAudioOutNode {\n    constructor(name, engine, options, nodeType = 2 /* AudioNodeType.HAS_OUTPUTS */) {\n        super(name, engine, nodeType);\n        this._spatialAutoUpdate = true;\n        this._spatialMinUpdateTime = 0;\n        this._outBus = null;\n        this._spatial = null;\n        this._onOutBusDisposed = null;\n        if (typeof options.spatialAutoUpdate === \"boolean\") {\n            this._spatialAutoUpdate = options.spatialAutoUpdate;\n        }\n        if (typeof options.spatialMinUpdateTime === \"number\") {\n            this._spatialMinUpdateTime = options.spatialMinUpdateTime;\n        }\n    }\n    /**\n     * The output bus for the sound.\n     * @see {@link AudioEngineV2.defaultMainBus}\n     */\n    get outBus() {\n        return this._outBus;\n    }\n    set outBus(outBus) {\n        if (this._outBus === outBus) {\n            return;\n        }\n        if (this._outBus) {\n            if (this._onOutBusDisposed) {\n                this._outBus.onDisposeObservable.removeCallback(this._onOutBusDisposed);\n                this._onOutBusDisposed = null;\n            }\n            if (!this._disconnect(this._outBus)) {\n                throw new Error(\"Disconnect failed\");\n            }\n        }\n        this._outBus = outBus;\n        if (this._outBus) {\n            this._onOutBusDisposed = () => {\n                this._outBus = null;\n            };\n            this._outBus.onDisposeObservable.add(this._onOutBusDisposed);\n            if (!this._connect(this._outBus)) {\n                throw new Error(\"Connect failed\");\n            }\n        }\n    }\n    /**\n     * The spatial audio features.\n     */\n    get spatial() {\n        if (this._spatial) {\n            return this._spatial;\n        }\n        return this._initSpatialProperty();\n    }\n    /**\n     * Releases associated resources.\n     */\n    dispose() {\n        super.dispose();\n        this._spatial?.dispose();\n        this._spatial = null;\n        if (this._outBus && this._onOutBusDisposed) {\n            this._outBus.onDisposeObservable.removeCallback(this._onOutBusDisposed);\n            this._onOutBusDisposed = null;\n        }\n        this._outBus = null;\n    }\n    _initSpatialProperty() {\n        return (this._spatial = this._createSpatialProperty(this._spatialAutoUpdate, this._spatialMinUpdateTime));\n    }\n    /** @internal */\n    get _isSpatial() {\n        return this._spatial !== null;\n    }\n    set _isSpatial(value) {\n        if (value && !this._spatial) {\n            this._initSpatialProperty();\n        }\n        else if (!value && this._spatial) {\n            this._spatial.dispose();\n            this._spatial = null;\n        }\n    }\n}\n//# sourceMappingURL=abstractSoundSource.js.map"],"names":["AbstractSoundSource","AbstractAudioOutNode","name","engine","options","nodeType","outBus","value"],"mappings":";AAIO,MAAMA,UAA4BC,EAAqB;AAAA,EAC1D,YAAYC,GAAMC,GAAQC,GAASC,IAAW,GAAmC;AAC7E,UAAMH,GAAMC,GAAQE,CAAQ,GAC5B,KAAK,qBAAqB,IAC1B,KAAK,wBAAwB,GAC7B,KAAK,UAAU,MACf,KAAK,WAAW,MAChB,KAAK,oBAAoB,MACrB,OAAOD,EAAQ,qBAAsB,cACrC,KAAK,qBAAqBA,EAAQ,oBAElC,OAAOA,EAAQ,wBAAyB,aACxC,KAAK,wBAAwBA,EAAQ;AAAA,EAE7C;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,SAAS;AACT,WAAO,KAAK;AAAA,EAChB;AAAA,EACA,IAAI,OAAOE,GAAQ;AACf,QAAI,KAAK,YAAYA,GAGrB;AAAA,UAAI,KAAK,YACD,KAAK,sBACL,KAAK,QAAQ,oBAAoB,eAAe,KAAK,iBAAiB,GACtE,KAAK,oBAAoB,OAEzB,CAAC,KAAK,YAAY,KAAK,OAAO;AAC9B,cAAM,IAAI,MAAM,mBAAmB;AAI3C,UADA,KAAK,UAAUA,GACX,KAAK,YACL,KAAK,oBAAoB,MAAM;AAC3B,aAAK,UAAU;AAAA,MACnB,GACA,KAAK,QAAQ,oBAAoB,IAAI,KAAK,iBAAiB,GACvD,CAAC,KAAK,SAAS,KAAK,OAAO;AAC3B,cAAM,IAAI,MAAM,gBAAgB;AAAA;AAAA,EAG5C;AAAA;AAAA;AAAA;AAAA,EAIA,IAAI,UAAU;AACV,WAAI,KAAK,WACE,KAAK,WAET,KAAK,qBAAoB;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAIA,UAAU;AACN,UAAM,QAAO,GACb,KAAK,UAAU,QAAO,GACtB,KAAK,WAAW,MACZ,KAAK,WAAW,KAAK,sBACrB,KAAK,QAAQ,oBAAoB,eAAe,KAAK,iBAAiB,GACtE,KAAK,oBAAoB,OAE7B,KAAK,UAAU;AAAA,EACnB;AAAA,EACA,uBAAuB;AACnB,WAAQ,KAAK,WAAW,KAAK,uBAAuB,KAAK,oBAAoB,KAAK,qBAAqB;AAAA,EAC3G;AAAA;AAAA,EAEA,IAAI,aAAa;AACb,WAAO,KAAK,aAAa;AAAA,EAC7B;AAAA,EACA,IAAI,WAAWC,GAAO;AAClB,IAAIA,KAAS,CAAC,KAAK,WACf,KAAK,qBAAoB,IAEpB,CAACA,KAAS,KAAK,aACpB,KAAK,SAAS,QAAO,GACrB,KAAK,WAAW;AAAA,EAExB;AACJ;","x_google_ignoreList":[0]}

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/entity.d.ts

@@ -2,6 +2,7 @@ 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";
 /**
  * Options for attaching a behavior at a specific position.
  * Only one positioning option should be specified.
@@ -60,8 +61,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 +102,7 @@ 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 _tags;
     private subscriptions;
     /**
@@ -144,9 +147,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.

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/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, 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";
@@ -114,19 +114,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/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/game.d.ts

@@ -23,4 +23,6 @@ export interface SageOptions {
     bindings?: BindingDefinition[];
     /** Logging level for the engine */
     logLevel?: LogLevel;
+    /** Audio channel names. If provided, SAGE initializes AudioV2 with one bus per channel. */
+    audioChannels?: string[];
 }

package/dist/interfaces/level.d.ts

@@ -1,8 +1,5 @@
 import { Scene, TransformNode } from '@babylonjs/core';
-import { GameEventBus } from "../classes/eventBus.d.ts";
-import { SceneEngine } from "../engines/scene.d.ts";
-import { AssetManager } from "../managers/asset.d.ts";
-import { GameEntityManager } from "../managers/entity.d.ts";
+import { GameEngine } from "../classes/gameEngine.d.ts";
 import { LoggingUtility } from "../utils/logger.d.ts";
 /**
  * Minimal interface for Level that property handlers receive.
@@ -10,9 +7,6 @@ import { LoggingUtility } from "../utils/logger.d.ts";
  */
 export interface LevelInstance {
     readonly name: string;
-    readonly eventBus: GameEventBus;
-    readonly sceneEngine: SceneEngine;
-    readonly entityManager: GameEntityManager;
     /** The current scene for this level (null if not loaded) */
     readonly scene: Scene | null;
     /**
@@ -23,20 +17,14 @@ export interface LevelInstance {
 /**
  * Handler function for processing custom properties on scene nodes.
  */
-export type PropertyHandler = (node: TransformNode, value: unknown, level: LevelInstance) => void | Promise<void>;
+export type PropertyHandler = (node: TransformNode, value: unknown, level: LevelInstance, gameEngine: GameEngine) => void | Promise<void>;
 /**
  * Runtime context containing all dependencies needed by a Level.
  * Passed to Level constructor by LevelManager during instantiation.
  */
 export interface LevelContext {
-    /** The game event bus for publishing events */
-    eventBus: GameEventBus;
-    /** The scene engine for creating and managing scenes */
-    sceneEngine: SceneEngine;
-    /** The entity manager for spawning entities */
-    entityManager: GameEntityManager;
-    /** The asset manager for loading and caching assets */
-    assetManager: AssetManager;
+    /** The game engine instance providing access to all subsystems */
+    gameEngine: GameEngine;
     /** Map of property handlers for processing scene node metadata */
     propertyHandlers: Map<string, PropertyHandler>;
     /** Optional logging utility for creating level-specific loggers */

package/dist/managers/audio.d.ts

@@ -0,0 +1,31 @@
+import { IStaticSoundOptions, StaticSound } from '@babylonjs/core/AudioV2/abstractAudio/staticSound';
+import { AudioEngine } from "../engines/audio.d.ts";
+import { Disposable } from "../interfaces/lifecycle.d.ts";
+import { LoggingUtility } from "../utils/logger.d.ts";
+/**
+ * Public channel info exposed to consumers (no BabylonJS internals).
+ */
+export interface ChannelInfo {
+    volume: number;
+    muted: boolean;
+}
+export declare class AudioManager implements Disposable {
+    private _audioEngine;
+    private _channels;
+    private _masterMuted;
+    private _masterVolumeBeforeMute;
+    private _log;
+    constructor(audioEngine: AudioEngine, logger: LoggingUtility);
+    initialize(channels: string[]): Promise<void>;
+    $teardown(): Promise<void>;
+    createSound(name: string, url: string, channel?: string, options?: Partial<IStaticSoundOptions>): Promise<StaticSound>;
+    setMasterVolume(volume: number): void;
+    getMasterVolume(): number;
+    setMasterMuted(muted: boolean): void;
+    isMasterMuted(): boolean;
+    setChannelVolume(channel: string, volume: number): void;
+    getChannelVolume(channel: string): number;
+    setChannelMuted(channel: string, muted: boolean): void;
+    isChannelMuted(channel: string): boolean;
+    getChannels(): string[];
+}

package/dist/managers/entity.d.ts

@@ -1,6 +1,7 @@
 import { TransformNode } from '@babylonjs/core';
 import { GameEntity } from "../classes/entity.d.ts";
 import { GameEventBus } from "../classes/eventBus.d.ts";
+import { GameEngine } from "../classes/gameEngine.d.ts";
 import { GameEntityDefinition } from "../interfaces/entity.d.ts";
 import { Disposable } from "../interfaces/lifecycle.d.ts";
 import { BindingManager } from "../managers/binding.d.ts";
@@ -25,6 +26,8 @@ export declare class GameEntityManager implements Disposable {
     private entities;
     /** A map of entity definitions registered with the entity manager. */
     private entityDefinitions;
+    /** Late-bound GameEngine reference */
+    private _gameEngine;
     /** Reference to the binding manager for registering actions */
     private bindingManager;
     /** Logger instance */
@@ -46,6 +49,12 @@ export declare class GameEntityManager implements Disposable {
      * @param bindingManager
      */
     constructor(eventBus: GameEventBus, logger: LoggingUtility | undefined, bindingManager: BindingManager);
+    /**
+     * Late-bind the GameEngine after construction.
+     * Called by createGameEngine() after the GameEngine instance is created.
+     */
+    $setGameEngine(gameEngine: GameEngine): void;
+    private get _engine();
     /**
      * Gets or creates a Set in a Map, returning the Set.
      */

package/dist/managers/level.d.ts

@@ -2,9 +2,7 @@ import { LevelConfig, LevelConstructor, PropertyHandler } from "../interfaces/le
 import { Disposable } from "../interfaces/lifecycle.d.ts";
 import { Level } from "../classes/level.d.ts";
 import { GameEventBus } from "../classes/eventBus.d.ts";
-import { SceneEngine } from "../engines/scene.d.ts";
-import { AssetManager } from "./asset.d.ts";
-import { GameEntityManager } from "./entity.d.ts";
+import { GameEngine } from "../classes/gameEngine.d.ts";
 import { LoggingUtility } from "../utils/logger.d.ts";
 /**
  * Options for level transitions.
@@ -38,9 +36,7 @@ export interface TransitionOptions {
  */
 export declare class LevelManager implements Disposable {
     private _eventBus;
-    private _sceneEngine;
-    private _assetManager;
-    private _entityManager;
+    private _gameEngine;
     private _log;
     private _logger?;
     /** Map of registered level configurations by name */
@@ -63,7 +59,12 @@ export declare class LevelManager implements Disposable {
      * Gets the registered property handlers
      */
     get propertyHandlers(): Map<string, PropertyHandler>;
-    constructor(eventBus: GameEventBus, sceneEngine: SceneEngine, assetManager: AssetManager, entityManager: GameEntityManager, logger?: LoggingUtility);
+    constructor(eventBus: GameEventBus, logger?: LoggingUtility);
+    /**
+     * Late-bind the GameEngine after construction.
+     * Called by createGameEngine() after the GameEngine instance is created.
+     */
+    $setGameEngine(gameEngine: GameEngine): void;
     private _handleProgress;
     private _handleComplete;
     private _handleError;