@skewedaspect/sage 0.5.0 → 0.6.0

package/dist/sage.es.js

@@ -1,9 +1,9 @@
-var I = Object.defineProperty;
-var k = (a, e, t) => e in a ? I(a, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : a[e] = t;
-var n = (a, e, t) => k(a, typeof e != "symbol" ? e + "" : e, t);
-import { FreeCamera as V, Vector3 as b, HemisphericLight as G, MeshBuilder as D, PhysicsAggregate as E, PhysicsShapeType as C, Scene as L, NullEngine as B, WebGPUEngine as K, Engine as U, HavokPlugin as R } from "@babylonjs/core";
-import T from "@babylonjs/havok";
-const m = "0.5.0";
+var A = Object.defineProperty;
+var I = (r, e, t) => e in r ? A(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
+var n = (r, e, t) => I(r, typeof e != "symbol" ? e + "" : e, t);
+import { FreeCamera as G, Vector3 as b, HemisphericLight as V, MeshBuilder as E, PhysicsAggregate as C, PhysicsShapeType as D, Scene as B, NullEngine as L, WebGPUEngine as K, Engine as T, HavokPlugin as U } from "@babylonjs/core";
+import R from "@babylonjs/havok";
+const m = "0.6.0";
 class z {
   /**
    * Creates an instance of SkewedAspectGameEngine.
@@ -15,7 +15,7 @@ class z {
    * @param engines - The engines used in the game.
    * @param managers - The managers used in the game.
    */
-  constructor(e, t, s, i, o, r, c) {
+  constructor(e, t, i, s, o, c, a) {
     n(this, "canvas");
     n(this, "renderEngine");
     n(this, "physics");
@@ -24,25 +24,91 @@ class z {
     n(this, "eventBus");
     n(this, "logger");
     n(this, "_log");
-    this.canvas = e, this.renderEngine = t, this.physics = s, this.eventBus = i, this.logger = o, this.engines = r, this.managers = c, this._log = o.getLogger("GameEngine");
+    // Lifecycle hooks
+    n(this, "_beforeStartHook", null);
+    n(this, "_onStartHook", null);
+    n(this, "_onTeardownHook", null);
+    this.canvas = e, this.renderEngine = t, this.physics = i, this.eventBus = s, this.logger = o, this.engines = c, this.managers = a, this._log = o.getLogger("GameEngine");
   }
   //------------------------------------------------------------------------------------------------------------------
   // Public API
   //------------------------------------------------------------------------------------------------------------------
+  /**
+   * Register a function to be called before the game engine starts
+   * @param hook - Async function to be called before start
+   * @throws Error if a hook is already registered
+   */
+  onBeforeStart(e) {
+    if (this._beforeStartHook !== null)
+      throw new Error("A beforeStart hook is already registered. Only one hook is allowed per lifecycle event.");
+    this._beforeStartHook = e;
+  }
+  /**
+   * Register a function to be called after the game engine starts
+   * @param hook - Async function to be called after start
+   * @throws Error if a hook is already registered
+   */
+  onStart(e) {
+    if (this._onStartHook !== null)
+      throw new Error("An onStart hook is already registered. Only one hook is allowed per lifecycle event.");
+    this._onStartHook = e;
+  }
+  /**
+   * Register a function to be called when the game engine stops
+   * @param hook - Async function to be called during teardown
+   * @throws Error if a hook is already registered
+   */
+  onTeardown(e) {
+    if (this._onTeardownHook !== null)
+      throw new Error("An onTeardown hook is already registered. Only one hook is allowed per lifecycle event.");
+    this._onTeardownHook = e;
+  }
   /**
    * Starts the game engine.
    */
   async start() {
-    this._log.info(`Starting SkewedAspect Game Engine (Version: ${m})...`), await this.managers.gameManager.start(this.canvas), this._log.info("Game engine started successfully");
+    this._log.info(`Starting SkewedAspect Game Engine (Version: ${m})...`), this._beforeStartHook && (this._log.debug("Executing beforeStart hook..."), await this._beforeStartHook(this)), await this.managers.gameManager.start(this.canvas), this._log.info("Game engine started successfully"), this._onStartHook && (this._log.debug("Executing onStart hook..."), await this._onStartHook(this));
   }
   /**
    * Stops the game engine.
    */
   async stop() {
-    this._log.info(`Stopping SkewedAspect Game Engine (Version: ${m})...`), await this.managers.gameManager.stop(), this._log.info("Game engine stopped successfully");
+    this._log.info(`Stopping SkewedAspect Game Engine (Version: ${m})...`);
+    let e = null;
+    if (this._onTeardownHook)
+      try {
+        this._log.debug("Executing onTeardown hook..."), await this._onTeardownHook(this);
+      } catch (t) {
+        this._log.error(`Error in onTeardown hook: ${t}`), e = e || t;
+      }
+    for (const t of Object.keys(this.managers)) {
+      const i = this.managers[t];
+      if (typeof i.$teardown == "function")
+        try {
+          this._log.debug(`Tearing down manager: ${t}`), await i.$teardown();
+        } catch (s) {
+          this._log.error(`Error tearing down manager ${t}: ${s}`), e = e || s;
+        }
+    }
+    for (const t of Object.keys(this.engines)) {
+      const i = this.engines[t];
+      if (typeof i.$teardown == "function")
+        try {
+          this._log.debug(`Tearing down engine: ${t}`), await i.$teardown();
+        } catch (s) {
+          this._log.error(`Error tearing down engine ${t}: ${s}`), e = e || s;
+        }
+    }
+    try {
+      await this.managers.gameManager.stop();
+    } catch (t) {
+      this._log.error(`Error stopping game manager: ${t}`), e = e || t;
+    }
+    if (this._log.info("Game engine stopped successfully"), e)
+      throw e;
   }
 }
-class W {
+class P {
   constructor() {
     n(this, "timers");
     this.timers = /* @__PURE__ */ new Map();
@@ -73,9 +139,9 @@ class W {
    * Format a log message with category, timestamp and log level
    */
   formatMessage(e, t) {
-    const s = /* @__PURE__ */ new Date(), i = s.getHours() % 12 || 12, o = s.getMinutes().toString().padStart(2, "0"), r = s.getSeconds().toString().padStart(2, "0"), c = s.getHours() >= 12 ? "PM" : "AM", h = `[${i}:${o}:${r} ${c}]`, u = t.toUpperCase();
+    const i = /* @__PURE__ */ new Date(), s = i.getHours() % 12 || 12, o = i.getMinutes().toString().padStart(2, "0"), c = i.getSeconds().toString().padStart(2, "0"), a = i.getHours() >= 12 ? "PM" : "AM", h = `[${s}:${o}:${c} ${a}]`, d = t.toUpperCase();
     return [
-      `${h} %c${u}%c (${e}): `,
+      `${h} %c${d}%c (${e}): `,
       // Format string with placeholders
       this.getStyleForLevel(t),
       // Level style
@@ -85,69 +151,74 @@ class W {
       // Reset style
     ];
   }
-  trace(e, t, ...s) {
-    const [i, o, r, c] = this.formatMessage(e, "trace");
-    console.debug(i, o, r, c, t, ...s);
+  trace(e, t, ...i) {
+    const [s, o, c, a] = this.formatMessage(e, "trace");
+    console.debug(s, o, c, a, t, ...i);
   }
-  debug(e, t, ...s) {
-    const [i, o, r, c] = this.formatMessage(e, "debug");
-    console.debug(i, o, r, c, t, ...s);
+  debug(e, t, ...i) {
+    const [s, o, c, a] = this.formatMessage(e, "debug");
+    console.debug(s, o, c, a, t, ...i);
   }
-  info(e, t, ...s) {
-    const [i, o, r, c] = this.formatMessage(e, "info");
-    console.info(i, o, r, c, t, ...s);
+  info(e, t, ...i) {
+    const [s, o, c, a] = this.formatMessage(e, "info");
+    console.info(s, o, c, a, t, ...i);
   }
-  warn(e, t, ...s) {
-    const [i, o, r, c] = this.formatMessage(e, "warn");
-    console.warn(i, o, r, c, t, ...s);
+  warn(e, t, ...i) {
+    const [s, o, c, a] = this.formatMessage(e, "warn");
+    console.warn(s, o, c, a, t, ...i);
   }
-  error(e, t, ...s) {
-    const [i, o, r, c] = this.formatMessage(e, "error");
-    console.error(i, o, r, c, t, ...s);
+  error(e, t, ...i) {
+    const [s, o, c, a] = this.formatMessage(e, "error");
+    console.error(s, o, c, a, t, ...i);
   }
   /**
    * Start a timer with the specified label.
    */
   time(e, t) {
-    const s = `${e}:${t}`;
-    this.timers.set(s, performance.now());
+    const i = `${e}:${t}`;
+    this.timers.set(i, performance.now());
   }
   /**
    * End a timer and log the elapsed time.
    */
   timeEnd(e, t) {
-    const s = `${e}:${t}`, i = this.timers.get(s);
-    if (i !== void 0) {
-      const o = performance.now() - i;
-      this.timers.delete(s);
-      const [r, c, h, u] = this.formatMessage(e, "timer");
-      console.info(`${r} Timer '${t}' completed in ${o.toFixed(2)}ms`, c, h, u);
+    const i = `${e}:${t}`, s = this.timers.get(i);
+    if (s !== void 0) {
+      const o = performance.now() - s;
+      this.timers.delete(i);
+      const [c, a, h, d] = this.formatMessage(e, "timer");
+      console.info(
+        `${c} Timer '${t}' completed in ${o.toFixed(2)}ms`,
+        a,
+        h,
+        d
+      );
     } else
       console.warn(`[${e}]: Timer '${t}' does not exist`);
   }
 }
-class P {
-  trace(e, t, ...s) {
+class H {
+  trace(e, t, ...i) {
   }
-  debug(e, t, ...s) {
+  debug(e, t, ...i) {
   }
-  info(e, t, ...s) {
+  info(e, t, ...i) {
   }
-  warn(e, t, ...s) {
+  warn(e, t, ...i) {
   }
-  error(e, t, ...s) {
+  error(e, t, ...i) {
   }
   time(e, t) {
   }
   timeEnd(e, t) {
   }
 }
-class l {
-  constructor(e, t = "none", s = new P()) {
+class g {
+  constructor(e, t = "none", i = new H()) {
     n(this, "category");
     n(this, "backend");
     n(this, "minLevel");
-    this.category = e, this.backend = s, this.minLevel = t;
+    this.category = e, this.backend = i, this.minLevel = t;
   }
   /**
    * Update the logger's backend and minimum level
@@ -198,14 +269,14 @@ class l {
     }
   }
 }
-class F {
+class O {
   /**
    * Create a new LoggingUtility.
    *
    * @param level - The minimum logging level (defaults to INFO)
    * @param backend - The logging backend to use (defaults to ConsoleBackend)
    */
-  constructor(e = "debug", t = new W()) {
+  constructor(e = "debug", t = new P()) {
     n(this, "backend");
     n(this, "level");
     n(this, "loggers");
@@ -218,7 +289,7 @@ class F {
    */
   setBackend(e) {
     this.backend = e, this.loggers.forEach((t) => {
-      t instanceof l && t.updateSettings(this.backend, this.level);
+      t instanceof g && t.updateSettings(this.backend, this.level);
     });
   }
   /**
@@ -228,7 +299,7 @@ class F {
    */
   setLevel(e) {
     this.level = e, this.loggers.forEach((t) => {
-      t instanceof l && t.updateSettings(this.backend, this.level);
+      t instanceof g && t.updateSettings(this.backend, this.level);
     });
   }
   /**
@@ -244,14 +315,14 @@ class F {
    * @returns A Logger instance for the specified category
    */
   getLogger(e) {
-    this.loggers.has(e) || this.loggers.set(e, new l(e, this.level, this.backend));
+    this.loggers.has(e) || this.loggers.set(e, new g(e, this.level, this.backend));
     const t = this.loggers.get(e);
     if (t === void 0)
       throw new Error(`Failed to create logger for category: ${e}`);
     return t;
   }
 }
-class O {
+class W {
   /**
    * Creates a new GameEventBus instance
    *
@@ -272,7 +343,7 @@ class O {
      * Logger instance
      */
     n(this, "_log");
-    this._log = (e == null ? void 0 : e.getLogger("EventBus")) || new l("EventBus");
+    this._log = (e == null ? void 0 : e.getLogger("EventBus")) || new g("EventBus");
   }
   /**
    * Subscribe with automatic detection:
@@ -297,14 +368,14 @@ class O {
    */
   subscribeExact(e, t) {
     this._log.debug(`Adding exact subscription for: ${e}`);
-    let s = this.directMap.get(e);
-    s || (s = /* @__PURE__ */ new Set(), this.directMap.set(e, s));
-    const i = {
+    let i = this.directMap.get(e);
+    i || (i = /* @__PURE__ */ new Set(), this.directMap.set(e, i));
+    const s = {
       callback: (o) => t(o)
       // runtime "type-lie" cast
     };
-    return s.add(i), () => {
-      this._log.debug(`Removing exact subscription for: ${e}`), s.delete(i), s.size === 0 && this.directMap.delete(e);
+    return i.add(s), () => {
+      this._log.debug(`Removing exact subscription for: ${e}`), i.delete(s), i.size === 0 && this.directMap.delete(e);
     };
   }
   /**
@@ -318,18 +389,20 @@ class O {
    * @returns {Unsubscribe} function that unsubscribes this pattern-based subscription.
    */
   subscribePattern(e, t) {
-    let s;
+    let i;
     if (typeof e == "string") {
       const o = e.replace(/[-/\\^$+?.()|[\]{}]/g, "\\$&").replace(/\*/g, ".*");
-      s = new RegExp(`^${o}$`), this._log.debug(`Adding pattern subscription for string: ${e}, regex: ${s.toString()}`);
+      i = new RegExp(`^${o}$`), this._log.debug(
+        `Adding pattern subscription for string: ${e}, regex: ${i.toString()}`
+      );
     } else
-      s = e, this._log.debug(`Adding pattern subscription for regex: ${s.toString()}`);
-    const i = {
-      pattern: s,
+      i = e, this._log.debug(`Adding pattern subscription for regex: ${i.toString()}`);
+    const s = {
+      pattern: i,
       callback: (o) => t(o)
     };
-    return this.patternSubs.add(i), () => {
-      this._log.debug(`Removing pattern subscription: ${s.toString()}`), this.patternSubs.delete(i);
+    return this.patternSubs.add(s), () => {
+      this._log.debug(`Removing pattern subscription: ${i.toString()}`), this.patternSubs.delete(s);
     };
   }
   /**
@@ -342,48 +415,59 @@ class O {
   publish(e) {
     this._log.trace(`Publishing event: ${e.type}`, e);
     let t = 0;
-    const s = this.directMap.get(e.type);
-    if (s) {
-      t += s.size;
-      for (const i of s)
-        Promise.resolve().then(() => i.callback(e));
+    const i = this.directMap.get(e.type);
+    if (i) {
+      t += i.size;
+      for (const s of i)
+        Promise.resolve().then(() => s.callback(e));
     }
-    for (const i of this.patternSubs)
-      i.pattern && i.pattern.test(e.type) && (t++, Promise.resolve().then(() => i.callback(e)));
+    for (const s of this.patternSubs)
+      s.pattern && s.pattern.test(e.type) && (t++, Promise.resolve().then(() => s.callback(e)));
     t === 0 ? this._log.debug(`No subscribers found for event: ${e.type}`) : this._log.trace(`Event ${e.type} dispatched to ${t} subscribers`);
   }
 }
-class N {
-  constructor(e, t, s) {
+class F {
+  constructor(e, t, i) {
     n(this, "_engine");
     n(this, "_physics");
     n(this, "_log");
-    this._engine = e, this._physics = t, this._log = (s == null ? void 0 : s.getLogger("SceneEngine")) || new l("SceneEngine");
+    this._engine = e, this._physics = t, this._log = (i == null ? void 0 : i.getLogger("SceneEngine")) || new g("SceneEngine");
   }
   async _buildDemoScene(e, t) {
     this._log.debug("Building demo scene..."), this._log.trace("Creating camera...");
-    const s = new V("camera1", new b(0, 5, -10), e);
-    s.setTarget(b.Zero()), s.attachControl(t, !0), this._log.trace("Creating light...");
-    const i = new G("light", new b(0, 1, 0), e);
-    i.intensity = 0.7, this._log.trace("Creating sphere...");
-    const o = D.CreateSphere("sphere", { diameter: 2, segments: 32 }, e);
+    const i = new G("camera1", new b(0, 5, -10), e);
+    i.setTarget(b.Zero()), i.attachControl(t, !0), this._log.trace("Creating light...");
+    const s = new V("light", new b(0, 1, 0), e);
+    s.intensity = 0.7, this._log.trace("Creating sphere...");
+    const o = E.CreateSphere("sphere", { diameter: 2, segments: 32 }, e);
     o.position.y = 4, this._log.trace("Creating ground...");
-    const r = D.CreateGround("ground", { width: 10, height: 10 }, e);
-    this._log.trace("Adding physics to sphere..."), new E(o, C.SPHERE, { mass: 1, restitution: 0.75 }, e), this._log.trace("Adding physics to ground..."), new E(r, C.BOX, { mass: 0 }, e), this._log.debug("Demo scene built successfully");
+    const c = E.CreateGround("ground", { width: 10, height: 10 }, e);
+    this._log.trace("Adding physics to sphere..."), new C(
+      o,
+      D.SPHERE,
+      { mass: 1, restitution: 0.75 },
+      e
+    ), this._log.trace("Adding physics to ground..."), new C(c, D.BOX, { mass: 0 }, e), this._log.debug("Demo scene built successfully");
   }
   // TODO: This needs more logic to handle different scenes
   async loadScene(e) {
     this._log.info("Loading scene..."), this._log.time("sceneLoad"), this._log.debug("Creating new scene...");
-    const t = new L(this._engine);
+    const t = new B(this._engine);
     return this._log.debug("Enabling physics with gravity (0, -9.8, 0)..."), t.enablePhysics(new b(0, -9.8, 0), this._physics), await this._buildDemoScene(t, e), this._log.timeEnd("sceneLoad"), this._log.info("Scene loaded successfully"), t;
   }
+  /**
+   * Tears down the scene engine and cleans up any resources
+   */
+  async $teardown() {
+    return this._log.info("Tearing down SceneEngine"), this._log.info("SceneEngine torn down successfully"), Promise.resolve();
+  }
 }
-const J = [
+const N = [
   "trigger",
   "toggle",
   "value"
 ];
-class Y {
+class J {
   //------------------------------------------------------------------------------------------------------------------
   /**
    * Create a new trigger binding
@@ -393,7 +477,7 @@ class Y {
    * @param reader - Input reader to read values from
    * @param options - Binding configuration options
    */
-  constructor(e, t, s, i = {}) {
+  constructor(e, t, i, s = {}) {
     n(this, "type", "trigger");
     n(this, "action");
     n(this, "context");
@@ -404,7 +488,7 @@ class Y {
     n(this, "_threshold");
     // State tracking
     n(this, "_lastDigitalState", !1);
-    this.action = e, this.deviceID = t, this.reader = s, this.context = i.context, this._edgeMode = i.edgeMode ?? "rising", this._threshold = i.threshold ?? 0.5;
+    this.action = e, this.deviceID = t, this.reader = i, this.context = s.context, this._edgeMode = s.edgeMode ?? "rising", this._threshold = s.threshold ?? 0.5;
   }
   //------------------------------------------------------------------------------------------------------------------
   // Public Getters
@@ -431,39 +515,39 @@ class Y {
    * @returns True if an action was triggered, false otherwise
    */
   process(e, t) {
-    const s = this.reader.getValue(e) ?? !1, i = typeof s == "boolean" ? s : s >= this._threshold;
+    const i = this.reader.getValue(e) ?? !1, s = typeof i == "boolean" ? i : i >= this._threshold;
     let o = !1;
     switch (this._edgeMode) {
       case "rising":
-        o = i && !this._lastDigitalState;
+        o = s && !this._lastDigitalState;
         break;
       case "falling":
-        o = !i && this._lastDigitalState;
+        o = !s && this._lastDigitalState;
         break;
       case "both":
-        o = i !== this._lastDigitalState;
+        o = s !== this._lastDigitalState;
         break;
     }
-    if (this._lastDigitalState = i, o) {
-      let r;
+    if (this._lastDigitalState = s, o) {
+      let c;
       if (this.action.type === "analog") {
-        let h = typeof s == "number" ? s : s ? 1 : 0;
+        let h = typeof i == "number" ? i : i ? 1 : 0;
         if (this.action.minValue !== void 0 || this.action.maxValue !== void 0) {
-          const u = this.action.minValue ?? 0, g = this.action.maxValue ?? 1;
-          h = u + h * (g - u);
+          const d = this.action.minValue ?? 0, _ = this.action.maxValue ?? 1;
+          h = d + h * (_ - d);
         }
-        r = h;
+        c = h;
       } else
-        r = !0;
-      const c = {
+        c = !0;
+      const a = {
         type: `action:${this.action.name}`,
         payload: {
-          value: r,
+          value: c,
           deviceId: this.deviceID,
           context: this.context
         }
       };
-      t.publish(c);
+      t.publish(a);
     }
   }
   /**
@@ -484,7 +568,7 @@ class Y {
     };
   }
 }
-class H {
+class Y {
   //------------------------------------------------------------------------------------------------------------------
   /**
    * Create a new toggle binding
@@ -494,7 +578,7 @@ class H {
    * @param reader - Input reader to read values from
    * @param options - Binding configuration options
    */
-  constructor(e, t, s, i = {}) {
+  constructor(e, t, i, s = {}) {
     n(this, "type", "toggle");
     n(this, "action");
     n(this, "context");
@@ -509,7 +593,7 @@ class H {
     // State tracking
     n(this, "_lastDigitalState", !1);
     n(this, "_toggleState");
-    this.action = e, this.deviceID = t, this.reader = s, this.context = i.context, this._invert = i.invert ?? !1, this._threshold = i.threshold ?? 0.5, this._initialState = i.initialState ?? !1, this._toggleState = this._initialState, this._onValue = i.onValue ?? !0, this._offValue = i.offValue ?? !1;
+    this.action = e, this.deviceID = t, this.reader = i, this.context = s.context, this._invert = s.invert ?? !1, this._threshold = s.threshold ?? 0.5, this._initialState = s.initialState ?? !1, this._toggleState = this._initialState, this._onValue = s.onValue ?? !0, this._offValue = s.offValue ?? !1;
   }
   //------------------------------------------------------------------------------------------------------------------
   // Public Getters
@@ -578,8 +662,8 @@ class H {
    * @param eventBus - Event bus to emit action events to
    */
   process(e, t) {
-    const s = this.reader.getValue(e) ?? !1, i = typeof s == "boolean" ? s : s >= this._threshold, o = this._invert ? !i && this._lastDigitalState : i && !this._lastDigitalState;
-    this._lastDigitalState = i, o && (this._toggleState = !this._toggleState, t.publish({
+    const i = this.reader.getValue(e) ?? !1, s = typeof i == "boolean" ? i : i >= this._threshold, o = this._invert ? !s && this._lastDigitalState : s && !this._lastDigitalState;
+    this._lastDigitalState = s, o && (this._toggleState = !this._toggleState, t.publish({
       type: `action:${this.action.name}`,
       payload: {
         value: this.value,
@@ -613,7 +697,7 @@ class H {
     };
   }
 }
-class X {
+class j {
   //------------------------------------------------------------------------------------------------------------------
   /**
    * Create a new value binding
@@ -623,7 +707,7 @@ class X {
    * @param reader - Input reader to read values from
    * @param options - Binding configuration options
    */
-  constructor(e, t, s, i = {}) {
+  constructor(e, t, i, s = {}) {
     n(this, "type", "value");
     n(this, "action");
     n(this, "context");
@@ -641,11 +725,11 @@ class X {
     n(this, "_max");
     // State tracking
     n(this, "_lastValue");
-    this.action = e, this.deviceID = t, this.reader = s, this.context = i.context, this._scale = i.scale ?? 1, this._offset = i.offset ?? 0, this._invert = i.invert ?? !1, this._emitOnChange = i.emitOnChange ?? !0, this._deadzone = i.deadzone ?? 0, this._onValue = i.onValue ?? !0, this._offValue = i.offValue ?? !1;
+    this.action = e, this.deviceID = t, this.reader = i, this.context = s.context, this._scale = s.scale ?? 1, this._offset = s.offset ?? 0, this._invert = s.invert ?? !1, this._emitOnChange = s.emitOnChange ?? !0, this._deadzone = s.deadzone ?? 0, this._onValue = s.onValue ?? !0, this._offValue = s.offValue ?? !1;
     const o = this.action.type === "analog" ? this.action.minValue ?? Number.NEGATIVE_INFINITY : Number.NEGATIVE_INFINITY;
-    this._min = i.min ?? o;
-    const r = this.action.type === "analog" ? this.action.maxValue ?? Number.POSITIVE_INFINITY : Number.POSITIVE_INFINITY;
-    this._max = i.max ?? r;
+    this._min = s.min ?? o;
+    const c = this.action.type === "analog" ? this.action.maxValue ?? Number.POSITIVE_INFINITY : Number.POSITIVE_INFINITY;
+    this._max = s.max ?? c;
   }
   //------------------------------------------------------------------------------------------------------------------
   /**
@@ -677,13 +761,13 @@ class X {
    * @returns True if a value was emitted, false otherwise
    */
   process(e, t) {
-    const s = this.reader.getValue(e);
-    if (s === void 0)
-      return;
-    const i = typeof s == "boolean" ? s ? 1 : 0 : s;
+    const i = this.reader.getValue(e);
     if (i === void 0)
       return;
-    let o = this._deadzone > 0 && Math.abs(i) < this._deadzone ? 0 : i;
+    const s = typeof i == "boolean" ? i ? 1 : 0 : i;
+    if (s === void 0)
+      return;
+    let o = this._deadzone > 0 && Math.abs(s) < this._deadzone ? 0 : s;
     o = (this._invert ? -o : o) * this._scale + this._offset, o = Math.max(this._min, Math.min(this._max, o)), !(this._emitOnChange && this._lastValue === o) && (this._lastValue = o, t.publish({
       type: `action:${this.action.name}`,
       payload: {
@@ -711,7 +795,7 @@ class X {
     };
   }
 }
-class w {
+class S {
   /**
    * Creates a new KeyboardValueReader
    *
@@ -753,7 +837,7 @@ class w {
    * @returns A new KeyboardValueReader instance
    */
   static fromString(e, t = {}) {
-    return new w(e, t);
+    return new S(e, t);
   }
   /**
    * Returns a JSON-serializable representation of this keyboard value reader
@@ -803,8 +887,8 @@ class x {
           return t ? t.pressed : void 0;
         }
         case "position": {
-          const [t, s] = this.sourceKey.split(":");
-          return !t || !s || t !== "absolute" && t !== "relative" || s !== "x" && s !== "y" ? void 0 : e.position[t][s];
+          const [t, i] = this.sourceKey.split(":");
+          return !t || !i || t !== "absolute" && t !== "relative" || i !== "x" && i !== "y" ? void 0 : e.position[t][i];
         }
         case "wheel": {
           const t = this.sourceKey === "deltaX" || this.sourceKey === "deltaY" || this.sourceKey === "deltaZ";
@@ -821,10 +905,13 @@ class x {
    * @returns A new MouseValueReader instance
    */
   static fromString(e) {
-    const [t, ...s] = e.split(":"), i = s.join(":");
-    if (!t || !i)
+    const [t, ...i] = e.split(":"), s = i.join(":");
+    if (!t || !s)
       throw new Error(`Invalid mouse source format: ${e}`);
-    return new x(t, i);
+    return new x(
+      t,
+      s
+    );
   }
   /**
    * Returns a JSON-serializable representation of this mouse value reader
@@ -839,7 +926,7 @@ class x {
     };
   }
 }
-class S {
+class $ {
   /**
    * Creates a new GamepadValueReader
    *
@@ -847,7 +934,7 @@ class S {
    * @param sourceKey - The specific key for this input type
    * @param options - Configuration options
    */
-  constructor(e, t, s = {}) {
+  constructor(e, t, i = {}) {
     /**
      * The type of gamepad input
      */
@@ -868,7 +955,7 @@ class S {
      * Whether to invert axis values
      */
     n(this, "invert");
-    this.sourceType = e, this.sourceKey = t, this.useAnalogValue = s.useAnalogValue || !1, this.deadzone = s.deadzone || 0.1, this.invert = s.invert || !1;
+    this.sourceType = e, this.sourceKey = t, this.useAnalogValue = i.useAnalogValue || !1, this.deadzone = i.deadzone || 0.1, this.invert = i.invert || !1;
   }
   /**
    * Gets the value of the input source based on the current state
@@ -899,10 +986,14 @@ class S {
    * @returns A new GamepadValueReader instance
    */
   static fromString(e, t = {}) {
-    const [s, i] = e.split(":");
-    if (!s || !i)
+    const [i, s] = e.split(":");
+    if (!i || !s)
       throw new Error(`Invalid gamepad source format: ${e}`);
-    return new S(s, i, t);
+    return new $(
+      i,
+      s,
+      t
+    );
   }
   /**
    * Returns a JSON-serializable representation of this gamepad value reader
@@ -922,7 +1013,7 @@ class S {
     };
   }
 }
-class j {
+class X {
   /**
    * Creates an instance of BindingManager.
    *
@@ -944,9 +1035,9 @@ class j {
     n(this, "_eventBus");
     /** Logger instance */
     n(this, "_log");
-    this._eventBus = e, this._eventBus.subscribe("input:changed", (s) => {
-      s.payload && this.$handleInput(s.payload.device, s.payload.state);
-    }), this._log = (t == null ? void 0 : t.getLogger("BindingManager")) || new l("BindingManager"), this._log.debug("BindingManager initialized");
+    this._eventBus = e, this._eventBus.subscribe("input:changed", (i) => {
+      i.payload && this.$handleInput(i.payload.device, i.payload.state);
+    }), this._log = (t == null ? void 0 : t.getLogger("BindingManager")) || new g("BindingManager"), this._log.debug("BindingManager initialized");
   }
   //------------------------------------------------------------------------------------------------------------------
   // Private Methods
@@ -968,11 +1059,11 @@ class j {
    * @returns The context object
    */
   _getOrCreateContext(e, t = !0) {
-    let s = this._contexts.get(e);
-    return s || (s = {
+    let i = this._contexts.get(e);
+    return i || (i = {
       name: e,
       exclusive: t
-    }, this._contexts.set(e, s), this._log.debug(`Auto-created context "${e}" (exclusive: ${t})`)), s;
+    }, this._contexts.set(e, i), this._log.debug(`Auto-created context "${e}" (exclusive: ${t})`)), i;
   }
   /**
    * Deactivate all exclusive contexts except the specified one
@@ -982,11 +1073,11 @@ class j {
    */
   _deactivateExclusiveContexts(e) {
     const t = [];
-    for (const s of this._activeContexts) {
-      if (s === e)
+    for (const i of this._activeContexts) {
+      if (i === e)
         continue;
-      const i = this._contexts.get(s);
-      i != null && i.exclusive && (this._activeContexts.delete(s), t.push(s));
+      const s = this._contexts.get(i);
+      s != null && s.exclusive && (this._activeContexts.delete(i), t.push(i));
     }
     return t;
   }
@@ -1000,23 +1091,38 @@ class j {
     const t = this._actions.get(e.action);
     if (!t)
       return this._log.warn(`Cannot create binding: Action "${e.action}" not found.`), null;
-    const { deviceID: s, ...i } = e.input;
+    const { deviceID: i, ...s } = e.input;
     switch (e.type) {
       case "trigger":
-        return new Y(t, s, this._createInputSourceFromDefinition(i), {
-          ...e.options || {},
-          context: e.context
-        });
+        return new J(
+          t,
+          i,
+          this._createInputSourceFromDefinition(s),
+          {
+            ...e.options || {},
+            context: e.context
+          }
+        );
       case "toggle":
-        return new H(t, s, this._createInputSourceFromDefinition(i), {
-          ...e.options || {},
-          context: e.context
-        });
+        return new Y(
+          t,
+          i,
+          this._createInputSourceFromDefinition(s),
+          {
+            ...e.options || {},
+            context: e.context
+          }
+        );
       case "value":
-        return new X(t, s, this._createInputSourceFromDefinition(i), {
-          ...e.options || {},
-          context: e.context
-        });
+        return new j(
+          t,
+          i,
+          this._createInputSourceFromDefinition(s),
+          {
+            ...e.options || {},
+            context: e.context
+          }
+        );
       default:
         return this._log.error(`Binding type not implemented: ${e.type}`), null;
     }
@@ -1031,18 +1137,28 @@ class j {
   _createInputSourceFromDefinition(e) {
     switch (e.type) {
       case "keyboard":
-        return new w(e.sourceKey, e.options);
+        return new S(
+          e.sourceKey,
+          e.options
+        );
       case "mouse": {
         const t = e.sourceType;
         if (!(t === "button" || t === "position" || t === "wheel"))
           throw new Error(`Invalid mouse source type: ${t}`);
-        return new x(t, e.sourceKey);
+        return new x(
+          t,
+          e.sourceKey
+        );
       }
       case "gamepad": {
         const t = e.sourceType;
         if (!(t === "button" || t === "axis"))
           throw new Error(`Invalid gamepad source type: ${t}`);
-        return new S(t, e.sourceKey, e.options);
+        return new $(
+          t,
+          e.sourceKey,
+          e.options
+        );
       }
       default:
         throw new Error(`Unsupported input source type: ${e.type}`);
@@ -1058,10 +1174,10 @@ class j {
    * @param state - Current input state
    */
   $handleInput(e, t) {
-    const s = this._bindings.get(e.id);
-    if (!(!s || s.length === 0) && !(this._activeContexts.size === 0 && s.some((i) => i.context)))
-      for (const i of s)
-        this._isBindingContextActive(i) && i.process(t, this._eventBus);
+    const i = this._bindings.get(e.id);
+    if (!(!i || i.length === 0) && !(this._activeContexts.size === 0 && i.some((s) => s.context)))
+      for (const s of i)
+        this._isBindingContextActive(s) && s.process(t, this._eventBus);
   }
   //------------------------------------------------------------------------------------------------------------------
   // Action Management API
@@ -1101,8 +1217,8 @@ class j {
    * @returns The registered context
    */
   registerContext(e, t = !0) {
-    const s = this._getOrCreateContext(e, t);
-    return s.exclusive !== t && (s.exclusive = t, this._log.info(`Updated context "${e}" exclusivity: ${t}`)), s;
+    const i = this._getOrCreateContext(e, t);
+    return i.exclusive !== t && (i.exclusive = t, this._log.info(`Updated context "${e}" exclusivity: ${t}`)), i;
   }
   /**
    * Activates a context, enabling all bindings associated with it.
@@ -1111,14 +1227,14 @@ class j {
    * @param contextName - The name of the context to activate
    */
   activateContext(e) {
-    const s = this._getOrCreateContext(e).exclusive;
-    this._log.debug(`Activating context "${e}" (exclusive: ${s})`);
-    const i = this._activeContexts.has(e);
-    if (s) {
+    const i = this._getOrCreateContext(e).exclusive;
+    this._log.debug(`Activating context "${e}" (exclusive: ${i})`);
+    const s = this._activeContexts.has(e);
+    if (i) {
       const o = this._deactivateExclusiveContexts(e);
       o.length > 0 && this._log.info(`Deactivated exclusive contexts: ${o.join(", ")}`);
     }
-    i || (this._activeContexts.add(e), this._log.info(`Context "${e}" activated${s ? " as exclusive" : ""}`));
+    s || (this._activeContexts.add(e), this._log.info(`Context "${e}" activated${i ? " as exclusive" : ""}`));
   }
   /**
    * Deactivates a context, disabling all bindings associated with it
@@ -1165,7 +1281,7 @@ class j {
    */
   $registerBinding(e) {
     var t;
-    if (!J.includes(e.type))
+    if (!N.includes(e.type))
       throw new Error(`Invalid binding type: ${e.type}`);
     e.context && !this._contexts.has(e.context) && this.registerContext(e.context), this._bindings.has(e.deviceID) || this._bindings.set(e.deviceID, []), (t = this._bindings.get(e.deviceID)) == null || t.push(e), this._log.debug(`Registered ${e.type} binding for "${e.action.name}" in context "${e.context || null}"`);
   }
@@ -1186,15 +1302,15 @@ class j {
    */
   unregisterBindings(e, t = null) {
     this._log.debug(`Unregistering all bindings for action "${e}" in context "${t}"`);
-    let s = 0;
-    for (const [i, o] of this._bindings.entries()) {
-      const r = o.filter((c) => {
-        const h = c.context || null, u = c.action.name !== e || h !== t;
-        return u || s++, u;
+    let i = 0;
+    for (const [s, o] of this._bindings.entries()) {
+      const c = o.filter((a) => {
+        const h = a.context || null, d = a.action.name !== e || h !== t;
+        return d || i++, d;
       });
-      r.length !== o.length && this._bindings.set(i, r);
+      c.length !== o.length && this._bindings.set(s, c);
     }
-    this._log.info(`Removed ${s} bindings for action "${e}" in context "${t}"`);
+    this._log.info(`Removed ${i} bindings for action "${e}" in context "${t}"`);
   }
   /**
    * Gets all bindings for a specific action
@@ -1204,13 +1320,13 @@ class j {
    * @returns Array of bindings that match the criteria
    */
   getBindingsForAction(e, t) {
-    const s = [];
-    for (const i of this._bindings.values())
-      for (const o of i) {
-        const r = o.context || null;
-        o.action.name === e && (!t || r === t) && s.push(o);
+    const i = [];
+    for (const s of this._bindings.values())
+      for (const o of s) {
+        const c = o.context || null;
+        o.action.name === e && (!t || c === t) && i.push(o);
       }
-    return s;
+    return i;
   }
   //------------------------------------------------------------------------------------------------------------------
   // Configuration Management API
@@ -1222,24 +1338,24 @@ class j {
    */
   exportConfiguration() {
     this._log.debug("Exporting binding configuration");
-    const e = [...this._actions.values()].map((i) => i.type === "analog" ? {
-      name: i.name,
-      type: i.type,
-      minValue: i.minValue ?? 0,
-      maxValue: i.maxValue ?? 1
-    } : i), t = [];
-    for (const i of this._bindings.values())
-      for (const o of i)
+    const e = [...this._actions.values()].map((s) => s.type === "analog" ? {
+      name: s.name,
+      type: s.type,
+      minValue: s.minValue ?? 0,
+      maxValue: s.maxValue ?? 1
+    } : s), t = [];
+    for (const s of this._bindings.values())
+      for (const o of s)
         t.push(o.toJSON());
-    const s = [...this._contexts.values()].map((i) => ({
-      name: i.name,
-      exclusive: i.exclusive,
-      active: this._activeContexts.has(i.name)
+    const i = [...this._contexts.values()].map((s) => ({
+      name: s.name,
+      exclusive: s.exclusive,
+      active: this._activeContexts.has(s.name)
     }));
-    return this._log.info(`Configuration exported: ${e.length} actions, ${t.length} bindings, ${s.length} contexts`), {
+    return this._log.info(`Configuration exported: ${e.length} actions, ${t.length} bindings, ${i.length} contexts`), {
       actions: e,
       bindings: t,
-      contexts: s
+      contexts: i
     };
   }
   /**
@@ -1256,29 +1372,36 @@ class j {
     for (const t of e.bindings)
       try {
         this.registerBinding(t);
-      } catch (s) {
-        s instanceof Error && this._log.error(`Failed to import binding for action "${t.action}": ${s.message}`);
+      } catch (i) {
+        i instanceof Error && this._log.error(`Failed to import binding for action "${t.action}": ${i.message}`);
       }
     this._log.info(`Configuration imported: ${e.actions.length} actions, ${e.bindings.length} bindings, ${e.contexts.length} contexts`);
   }
+  /**
+   * Tears down the binding manager and cleans up any resources
+   */
+  async $teardown() {
+    return this._log.info("Tearing down BindingManager"), this._bindings.clear(), this._actions.clear(), this._contexts.clear(), this._activeContexts.clear(), this._log.info("BindingManager torn down successfully"), Promise.resolve();
+  }
 }
-function A() {
+function w() {
   return typeof window < "u" && typeof window.document < "u";
 }
-function $() {
-  return A() && !!window.navigator.gpu;
+function k() {
+  return w() && !!window.navigator.gpu;
 }
 class Z {
   //------------------------------------------------------------------------------------------------------------------
-  constructor(e, t, s, i, o) {
+  constructor(e, t, i, s, o) {
     n(this, "_engine");
     n(this, "_entityManager");
     n(this, "_inputManager");
     n(this, "_sceneEngine");
     n(this, "_currentScene", null);
     n(this, "_log");
+    n(this, "_boundResizeHandler");
     n(this, "started", !1);
-    this._engine = e, this._sceneEngine = t, this._entityManager = s, this._inputManager = i, this._log = (o == null ? void 0 : o.getLogger("GameManager")) || new l("GameManager"), A() && window.addEventListener("resize", this._resizeHandler.bind(this));
+    this._engine = e, this._sceneEngine = t, this._entityManager = i, this._inputManager = s, this._log = (o == null ? void 0 : o.getLogger("GameManager")) || new g("GameManager"), this._boundResizeHandler = this._resizeHandler.bind(this), w() && window.addEventListener("resize", this._boundResizeHandler);
   }
   _renderLoop() {
     const e = this._engine.getDeltaTime();
@@ -1296,8 +1419,15 @@ class Z {
   async stop() {
     this.started = !1, this._engine.stopRenderLoop(), this._log.info("SkewedAspect Game Engine stopped successfully");
   }
+  /**
+   * Tears down any resources held by the GameManager
+   * This handles unregistering event listeners and any other cleanup
+   */
+  async $teardown() {
+    this._log.info("Tearing down GameManager"), this.started && await this.stop(), w() && window.removeEventListener("resize", this._boundResizeHandler), this._log.info("GameManager torn down successfully");
+  }
 }
-class ue {
+class de {
   constructor() {
     n(this, "entity", null);
   }
@@ -1325,7 +1455,7 @@ class q {
    * @param behaviors - An array of behaviors to attach to the entity.
    * @param eventBus
    */
-  constructor(e, t, s, i) {
+  constructor(e, t, i, s) {
     /** The unique identifier of the entity. */
     n(this, "id");
     /** The type of the entity. */
@@ -1338,8 +1468,8 @@ class q {
     n(this, "eventBus");
     /** The event subscriptions for the entity. */
     n(this, "subscriptions", /* @__PURE__ */ new Map());
-    this.id = crypto.randomUUID(), this.type = e, this.state = s, this.eventBus = t;
-    for (const o of i)
+    this.id = crypto.randomUUID(), this.type = e, this.state = i, this.eventBus = t;
+    for (const o of s)
       this.attachBehavior(new o());
   }
   //------------------------------------------------------------------------------------------------------------------
@@ -1361,8 +1491,8 @@ class q {
    */
   $update(e) {
     var t;
-    for (const s of this.behaviors.values())
-      (t = s.update) == null || t.call(s, e, this.state);
+    for (const i of this.behaviors.values())
+      (t = i.update) == null || t.call(i, e, this.state);
   }
   /**
    * Destroys the entity by calling the destroy method of its behaviors.
@@ -1388,12 +1518,12 @@ class q {
     if (this.behaviors.has(e.name))
       throw new Error(`Behavior ${e.name} is already attached to this entity.`);
     for (const t of e.eventSubscriptions) {
-      const s = this.subscriptions.get(t);
-      if (s)
-        s.count++;
+      const i = this.subscriptions.get(t);
+      if (i)
+        i.count++;
       else {
-        const i = this.eventBus.subscribe(t, this.$processEvent.bind(this));
-        this.subscriptions.set(t, { count: 1, unsubscribe: i });
+        const s = this.eventBus.subscribe(t, this.$processEvent.bind(this));
+        this.subscriptions.set(t, { count: 1, unsubscribe: s });
       }
     }
     this.behaviors.set(e.name, e), e.$setEntity(this);
@@ -1405,9 +1535,9 @@ class q {
   detachBehavior(e) {
     const t = this.behaviors.get(e);
     if (t) {
-      for (const s of t.eventSubscriptions) {
-        const i = this.subscriptions.get(s);
-        i && (i.count--, i.count <= 0 && (i.unsubscribe(), this.subscriptions.delete(s)));
+      for (const i of t.eventSubscriptions) {
+        const s = this.subscriptions.get(i);
+        s && (s.count--, s.count <= 0 && (s.unsubscribe(), this.subscriptions.delete(i)));
       }
       this.behaviors.delete(t.name), t.$setEntity(null);
     }
@@ -1420,7 +1550,7 @@ class Q {
    * @param logger - The logging utility to use
    * @param bindingManager - The binding manager for registering actions
    */
-  constructor(e, t, s) {
+  constructor(e, t, i) {
     /** The event bus for the entity manager. */
     n(this, "eventBus");
     /** A map of entities managed by the entity manager. */
@@ -1431,7 +1561,7 @@ class Q {
     n(this, "bindingManager");
     /** Logger instance */
     n(this, "_log");
-    this.eventBus = e, this.bindingManager = s, this._log = (t == null ? void 0 : t.getLogger("EntityManager")) || new l("EntityManager"), this._log.info("EntityManager initialized");
+    this.eventBus = e, this.bindingManager = i, this._log = (t == null ? void 0 : t.getLogger("EntityManager")) || new g("EntityManager"), this._log.info("EntityManager initialized");
   }
   //------------------------------------------------------------------------------------------------------------------
   // Private Methods
@@ -1442,21 +1572,25 @@ class Q {
    * @param newAction - The action being registered
    * @returns true if the actions are compatible, false if they have conflicting options
    */
-  areActionsCompatible(e, t) {
+  _areActionsCompatible(e, t) {
     return !(e.type !== t.type || e.type === "analog" && t.type === "analog" && (t.minValue !== void 0 && e.minValue !== t.minValue || t.maxValue !== void 0 && e.maxValue !== t.maxValue));
   }
   /**
    * Registers actions defined in the entity definition with the binding manager
    * @param entityDef - The entity definition containing actions to register
    */
-  registerEntityActions(e) {
+  _registerEntityActions(e) {
     if (e.actions)
       for (const t of e.actions)
         try {
-          const s = this.bindingManager.getAction(t.name);
-          s ? this.areActionsCompatible(s, t) ? this._log.trace(`Action "${t.name}" already registered with compatible options, skipping registration`) : this._log.warn(`Action "${t.name}" already registered with different options. Entity "${e.type}" requires: ${JSON.stringify(t)}, but found: ${JSON.stringify(s)}`) : (this._log.debug(`Registering action "${t.name}" from entity type "${e.type}"`), this.bindingManager.registerAction(t));
-        } catch (s) {
-          this._log.debug(`Failed to register action "${t.name}": ${s instanceof Error ? s.message : String(s)}`);
+          const i = this.bindingManager.getAction(t.name);
+          i ? this._areActionsCompatible(i, t) ? this._log.trace(
+            `Action "${t.name}" already registered with compatible options, skipping registration`
+          ) : this._log.warn(
+            `Action "${t.name}" already registered with different options. Entity "${e.type}" requires: ${JSON.stringify(t)}, but found: ${JSON.stringify(i)}`
+          ) : (this._log.debug(`Registering action "${t.name}" from entity type "${e.type}"`), this.bindingManager.registerAction(t));
+        } catch (i) {
+          this._log.debug(`Failed to register action "${t.name}": ${i instanceof Error ? i.message : String(i)}`);
         }
   }
   $frameUpdate(e) {
@@ -1472,7 +1606,7 @@ class Q {
    * @param entityDef - The definition of the entity.
    */
   registerEntityDefinition(e) {
-    this._log.debug(`Registering entity definition: ${e.type}`), this.registerEntityActions(e), this.entityDefinitions.set(e.type, e);
+    this._log.debug(`Registering entity definition: ${e.type}`), this._registerEntityActions(e), this.entityDefinitions.set(e.type, e);
   }
   /**
    * Creates a new entity of the given type.
@@ -1480,26 +1614,51 @@ class Q {
    * @param initialState - The initial state of the entity.
    * @returns The created entity.
    */
-  createEntity(e, t = {}) {
-    var r;
+  async createEntity(e, t = {}) {
+    var c;
     this._log.debug(`Creating entity of type: ${e}`);
-    const s = this.entityDefinitions.get(e);
-    if (!s) {
-      const c = `Entity type ${e} is not registered.`;
-      throw this._log.error(c), new Error(c);
+    const i = this.entityDefinitions.get(e);
+    if (!i) {
+      const a = `Entity type ${e} is not registered.`;
+      throw this._log.error(a), new Error(a);
     }
-    this._log.trace(`Using entity definition with ${((r = s.behaviors) == null ? void 0 : r.length) || 0} behaviors`);
-    const i = { ...s.defaultState, ...t }, o = new q(s.type, this.eventBus, i, s.behaviors);
-    return this.entities.set(o.id, o), this._log.debug(`Entity created with ID: ${o.id}`), o;
+    this._log.trace(`Using entity definition with ${((c = i.behaviors) == null ? void 0 : c.length) || 0} behaviors`);
+    let s = { ...i.defaultState, ...t };
+    if (i.onBeforeCreate) {
+      this._log.trace(`Calling onBeforeCreate hook for entity type: ${e}`);
+      const a = await i.onBeforeCreate(s);
+      a !== void 0 && (s = a);
+    }
+    const o = new q(
+      i.type,
+      this.eventBus,
+      s,
+      i.behaviors
+    );
+    if (this.entities.set(o.id, o), this._log.debug(`Entity created with ID: ${o.id}`), i.onCreate) {
+      this._log.trace(`Calling onCreate hook for entity type: ${e}`);
+      const a = await i.onCreate(o.state);
+      a !== void 0 && (o.state = a);
+    }
+    return o;
   }
   /**
    * Destroys the entity with the given ID.
    * @param entityID - The ID of the entity to destroy.
    */
-  destroyEntity(e) {
+  async destroyEntity(e) {
     this._log.debug(`Destroying entity: ${e}`);
     const t = this.entities.get(e);
-    t ? (t.$destroy(), this.entities.delete(e), this._log.debug(`Entity ${e} destroyed`)) : this._log.warn(`Attempted to destroy non-existent entity: ${e}`);
+    if (t) {
+      const i = this.entityDefinitions.get(t.type);
+      if (i != null && i.onBeforeDestroy) {
+        this._log.trace(`Calling onBeforeDestroy hook for entity: ${e}`);
+        const s = await i.onBeforeDestroy(t.state);
+        s !== void 0 && (t.state = s);
+      }
+      await t.$destroy(), i != null && i.onDestroy && (this._log.trace(`Calling onDestroy hook for entity: ${e}`), await i.onDestroy(t.state)), this.entities.delete(e), this._log.debug(`Entity ${e} destroyed`);
+    } else
+      this._log.warn(`Attempted to destroy non-existent entity: ${e}`);
   }
   /**
    * Gets the entity with the given ID.
@@ -1523,6 +1682,21 @@ class Q {
   removeEntity(e) {
     this._log.debug(`Removing entity: ${e}`), this.entities.get(e) ? (this.entities.delete(e), this._log.debug(`Entity ${e} removed`)) : this._log.warn(`Attempted to remove non-existent entity: ${e}`);
   }
+  /**
+   * Tears down all entities and releases resources
+   * @returns A promise that resolves when all entities have been destroyed
+   */
+  async $teardown() {
+    this._log.info(`Tearing down EntityManager with ${this.entities.size} entities`);
+    const e = [...this.entities.keys()];
+    for (const t of e)
+      try {
+        await this.destroyEntity(t);
+      } catch (i) {
+        this._log.error(`Error destroying entity ${t}: ${i}`);
+      }
+    this.entityDefinitions.clear(), this._log.info("EntityManager torn down successfully");
+  }
 }
 class ee {
   //------------------------------------------------------------------------------------------------------------------
@@ -1578,10 +1752,10 @@ class ee {
     return { ...this._keyboardDevice };
   }
   /**
-   * Destroy the keyboard resource access and clean up event listeners
+   * Tears down the keyboard resource access and cleans up event listeners
    */
-  destroy() {
-    window.removeEventListener("keydown", this._handleKeyDown), window.removeEventListener("keyup", this._handleKeyUp);
+  $teardown() {
+    return window.removeEventListener("keydown", this._handleKeyDown), window.removeEventListener("keyup", this._handleKeyUp), Promise.resolve();
   }
   //------------------------------------------------------------------------------------------------------------------
   // Private Methods
@@ -1599,13 +1773,13 @@ class ee {
     this._keysState[e.code] = !0;
     const t = {};
     t[e.code] = !0;
-    const s = {
+    const i = {
       type: "keyboard",
       keys: { ...this._keysState },
       delta: t,
       event: e
     };
-    this._notifyInputChanged(s);
+    this._notifyInputChanged(i);
   }
   /**
    * Handle keyboard key up events
@@ -1614,13 +1788,13 @@ class ee {
     this._keysState[e.code] = !1;
     const t = {};
     t[e.code] = !1;
-    const s = {
+    const i = {
       type: "keyboard",
       keys: { ...this._keysState },
       delta: t,
       event: e
     };
-    this._notifyInputChanged(s);
+    this._notifyInputChanged(i);
   }
   /**
    * Notify subscribers of device connected event
@@ -1708,10 +1882,10 @@ class te {
     return { ...this._mouseDevice };
   }
   /**
-   * Destroy the mouse resource access and clean up event listeners
+   * Tears down the mouse resource access and cleans up event listeners
    */
-  destroy() {
-    this._targetElement.removeEventListener("mousedown", this._handleMouseDown), this._targetElement.removeEventListener("mouseup", this._handleMouseUp), this._targetElement.removeEventListener("mousemove", this._handleMouseMove), this._targetElement.removeEventListener("wheel", this._handleMouseWheel);
+  $teardown() {
+    return this._targetElement.removeEventListener("mousedown", this._handleMouseDown), this._targetElement.removeEventListener("mouseup", this._handleMouseUp), this._targetElement.removeEventListener("mousemove", this._handleMouseMove), this._targetElement.removeEventListener("wheel", this._handleMouseWheel), Promise.resolve();
   }
   //------------------------------------------------------------------------------------------------------------------
   // Private Methods
@@ -1726,10 +1900,10 @@ class te {
    * Handle mouse button down events
    */
   _handleMouseDown(e) {
-    const t = `button-${e.button}`, s = {
+    const t = `button-${e.button}`, i = {
       pressed: !0
     };
-    this._buttonState[t] = s, this._notifyInputChanged({
+    this._buttonState[t] = i, this._notifyInputChanged({
       type: "mouse",
       event: e,
       buttons: { ...this._buttonState },
@@ -1741,10 +1915,10 @@ class te {
    * Handle mouse button up events
    */
   _handleMouseUp(e) {
-    const t = `button-${e.button}`, s = {
+    const t = `button-${e.button}`, i = {
       pressed: !1
     };
-    this._buttonState[t] = s, this._notifyInputChanged({
+    this._buttonState[t] = i, this._notifyInputChanged({
       type: "mouse",
       event: e,
       buttons: { ...this._buttonState },
@@ -1804,7 +1978,7 @@ class te {
     this._onInputChanged && this._onInputChanged(this._mouseDevice, e);
   }
 }
-class se {
+class ie {
   //------------------------------------------------------------------------------------------------------------------
   /**
    * Create a new GamepadResourceAccess
@@ -1858,10 +2032,10 @@ class se {
   getStates() {
     const e = {};
     return Object.keys(this._buttonStates).forEach((t) => {
-      const s = Number(t), i = this._buttonStates[s] || {}, o = this._axesStates[s] || {};
-      e[s] = {
+      const i = Number(t), s = this._buttonStates[i] || {}, o = this._axesStates[i] || {};
+      e[i] = {
         type: "gamepad",
-        buttons: { ...i },
+        buttons: { ...s },
         axes: { ...o }
       };
     }), e;
@@ -1881,11 +2055,11 @@ class se {
    * @param index - The index of the gamepad state to get
    */
   getState(e) {
-    const t = this._buttonStates[e], s = this._axesStates[e];
-    return !t && !s ? null : {
+    const t = this._buttonStates[e], i = this._axesStates[e];
+    return !t && !i ? null : {
       type: "gamepad",
       buttons: t ? { ...t } : {},
-      axes: s ? { ...s } : {}
+      axes: i ? { ...i } : {}
     };
   }
   /**
@@ -1898,46 +2072,46 @@ class se {
     for (const t of e) {
       if (!t)
         continue;
-      const s = t.index;
-      if (!this._gamepadDevices[s]) {
+      const i = t.index;
+      if (!this._gamepadDevices[i]) {
         this._handleGamepadConnected(t);
         continue;
       }
-      const i = this._gamepadDevices[s];
-      if (!i)
+      const s = this._gamepadDevices[i];
+      if (!s)
         continue;
-      const o = this._buttonStates[s] || {}, r = this._axesStates[s] || {}, c = {};
+      const o = this._buttonStates[i] || {}, c = this._axesStates[i] || {}, a = {};
       let h = !1;
-      t.buttons.forEach((d, _) => {
-        const p = `button-${_}`, f = {
-          pressed: d.pressed,
-          touched: d.touched,
-          value: d.value
+      t.buttons.forEach((u, p) => {
+        const l = `button-${p}`, f = {
+          pressed: u.pressed,
+          touched: u.touched,
+          value: u.value
         };
-        c[p] = f;
-        const y = o[p];
+        a[l] = f;
+        const y = o[l];
         (!y || y.pressed !== f.pressed || y.touched !== f.touched || y.value !== f.value) && (h = !0);
       });
-      const u = {};
-      let g = !1;
-      if (t.axes.forEach((d, _) => {
-        const p = `axis-${_}`;
-        u[p] = d, r[p] !== d && (g = !0);
-      }), this._buttonStates[s] = c, this._axesStates[s] = u, h || g) {
-        const d = {
+      const d = {};
+      let _ = !1;
+      if (t.axes.forEach((u, p) => {
+        const l = `axis-${p}`;
+        d[l] = u, c[l] !== u && (_ = !0);
+      }), this._buttonStates[i] = a, this._axesStates[i] = d, h || _) {
+        const u = {
           type: "gamepad",
-          buttons: { ...c },
-          axes: { ...u }
+          buttons: { ...a },
+          axes: { ...d }
         };
-        this._notifyInputChanged(i, d);
+        this._notifyInputChanged(s, u);
       }
     }
   }
   /**
-   * Destroy the gamepad resource access and clean up event listeners
+   * Tears down the gamepad resource access and cleans up event listeners
    */
-  destroy() {
-    window.removeEventListener("gamepadconnected", this._handleGamepadConnected), window.removeEventListener("gamepaddisconnected", this._handleGamepadDisconnected);
+  $teardown() {
+    return window.removeEventListener("gamepadconnected", this._handleGamepadConnected), window.removeEventListener("gamepaddisconnected", this._handleGamepadDisconnected), Promise.resolve();
   }
   //------------------------------------------------------------------------------------------------------------------
   // Private Methods
@@ -1956,32 +2130,32 @@ class se {
    * Handle gamepad connected event
    */
   _handleGamepadConnected(e) {
-    const t = e instanceof GamepadEvent ? e.gamepad : e, s = t.index, i = {
-      id: `gamepad-${s}`,
+    const t = e instanceof GamepadEvent ? e.gamepad : e, i = t.index, s = {
+      id: `gamepad-${i}`,
       name: t.id,
       type: "gamepad",
       connected: !0,
-      index: s,
+      index: i,
       mapping: t.mapping,
       axes: Array.from(t.axes),
       buttons: Array.from(t.buttons)
     };
-    this._gamepadDevices[s] = i;
+    this._gamepadDevices[i] = s;
     const o = {};
-    Array.from(t.buttons).forEach((c, h) => {
+    Array.from(t.buttons).forEach((a, h) => {
       o[`button-${h}`] = {
-        pressed: c.pressed,
-        touched: c.touched,
-        value: c.value
+        pressed: a.pressed,
+        touched: a.touched,
+        value: a.value
       };
-    }), this._buttonStates[s] = o;
-    const r = {};
-    Array.from(t.axes).forEach((c, h) => {
-      r[`axis-${h}`] = c;
-    }), this._axesStates[s] = r, this._notifyDeviceConnected(i), this._notifyInputChanged(i, {
+    }), this._buttonStates[i] = o;
+    const c = {};
+    Array.from(t.axes).forEach((a, h) => {
+      c[`axis-${h}`] = a;
+    }), this._axesStates[i] = c, this._notifyDeviceConnected(s), this._notifyInputChanged(s, {
       type: "gamepad",
       buttons: { ...o },
-      axes: { ...r },
+      axes: { ...c },
       event: e instanceof GamepadEvent ? e : void 0
     });
   }
@@ -1989,8 +2163,8 @@ class se {
    * Handle gamepad disconnected event
    */
   _handleGamepadDisconnected(e) {
-    const s = e.gamepad.index, i = this._gamepadDevices[s];
-    i && (i.connected = !1, this._notifyDeviceDisconnected(i), this._gamepadDevices[s] = void 0, this._buttonStates[s] = void 0, this._axesStates[s] = void 0);
+    const i = e.gamepad.index, s = this._gamepadDevices[i];
+    s && (s.connected = !1, this._notifyDeviceDisconnected(s), this._gamepadDevices[i] = void 0, this._buttonStates[i] = void 0, this._axesStates[i] = void 0);
   }
   /**
    * Notify subscribers of device connected event
@@ -2011,7 +2185,7 @@ class se {
     this._onInputChanged && this._onInputChanged(e, t);
   }
 }
-class ie {
+class se {
   //------------------------------------------------------------------------------------------------------------------
   /**
    * Create a new UserInputManager
@@ -2020,14 +2194,14 @@ class ie {
    * @param canvas - The DOM element to attach input listeners to
    * @param logger - The logging utility to use
    */
-  constructor(e, t, s) {
+  constructor(e, t, i) {
     n(this, "_eventBus");
     n(this, "_keyboardRA");
     n(this, "_mouseRA");
     n(this, "_gamepadRA");
     /** Logger instance */
     n(this, "_log");
-    this._eventBus = e, this._log = (s == null ? void 0 : s.getLogger("UserInputManager")) || new l("UserInputManager"), this._log.info("Initializing UserInputManager"), this._log.debug("Initializing input resource access classes"), this._keyboardRA = new ee(), this._mouseRA = new te(t), this._gamepadRA = new se(), this._log.debug("Registering input event callbacks"), this._keyboardRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._keyboardRA.onInputChanged(this._publishInputChanged.bind(this)), this._mouseRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._mouseRA.onInputChanged(this._publishInputChanged.bind(this)), this._gamepadRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._gamepadRA.onDeviceDisconnected(this._publishDeviceDisconnected.bind(this)), this._gamepadRA.onInputChanged(this._publishInputChanged.bind(this)), this._log.info("UserInputManager initialized successfully");
+    this._eventBus = e, this._log = (i == null ? void 0 : i.getLogger("UserInputManager")) || new g("UserInputManager"), this._log.info("Initializing UserInputManager"), this._log.debug("Initializing input resource access classes"), this._keyboardRA = new ee(), this._mouseRA = new te(t), this._gamepadRA = new ie(), this._log.debug("Registering input event callbacks"), this._keyboardRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._keyboardRA.onInputChanged(this._publishInputChanged.bind(this)), this._mouseRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._mouseRA.onInputChanged(this._publishInputChanged.bind(this)), this._gamepadRA.onDeviceConnected(this._publishDeviceConnected.bind(this)), this._gamepadRA.onDeviceDisconnected(this._publishDeviceDisconnected.bind(this)), this._gamepadRA.onInputChanged(this._publishInputChanged.bind(this)), this._log.info("UserInputManager initialized successfully");
   }
   //------------------------------------------------------------------------------------------------------------------
   // Private methods
@@ -2059,7 +2233,7 @@ class ie {
    */
   _publishInputChanged(e, t) {
     this._log.trace(`Input changed: ${e.id}`, t);
-    const s = {
+    const i = {
       type: "input:changed",
       payload: {
         deviceId: e.id,
@@ -2067,16 +2241,22 @@ class ie {
         state: t
       }
     };
-    this._eventBus.publish(s);
+    this._eventBus.publish(i);
   }
   //------------------------------------------------------------------------------------------------------------------
   // Internal methods
   //------------------------------------------------------------------------------------------------------------------
   /**
-   * Destroy the input manager and clean up event listeners
+   * Tears down the input manager and clean up event listeners
    */
-  $destroy() {
-    this._log.info("Destroying UserInputManager"), this._log.debug("Cleaning up input resource access instances"), this._keyboardRA.destroy(), this._mouseRA.destroy(), this._gamepadRA.destroy(), this._log.info("UserInputManager destroyed");
+  $teardown() {
+    return this._log.info("Tearing down UserInputManager"), this._log.debug("Cleaning up input resource access instances"), Promise.all([
+      this._keyboardRA.$teardown(),
+      this._mouseRA.$teardown(),
+      this._gamepadRA.$teardown()
+    ]).then(() => {
+      this._log.info("UserInputManager torn down successfully");
+    });
   }
   //------------------------------------------------------------------------------------------------------------------
   // Public methods
@@ -2108,9 +2288,9 @@ class ie {
       return this._gamepadRA.getDevice(t);
     } else {
       const t = this.listDevices();
-      for (const s of t)
-        if (s.id === e)
-          return s;
+      for (const i of t)
+        if (i.id === e)
+          return i;
     }
     return this._log.warn(`Device not found: ${e}`), null;
   }
@@ -2121,46 +2301,48 @@ class ie {
     this._gamepadRA.pollGamepads();
   }
 }
-async function M(a, e) {
-  const t = new K(a, e);
+async function M(r, e) {
+  const t = new K(r, e);
   return await t.initAsync(), t;
 }
-function v(a, e) {
-  return new U(a, e.antialias, e.options, e.adaptToDeviceRatio);
+function v(r, e) {
+  return new T(r, e.antialias, e.options, e.adaptToDeviceRatio);
 }
-function ne(a) {
-  return new B(a);
+function ne(r) {
+  return new L(r);
 }
-async function oe(a, e) {
-  if (a === null)
+async function oe(r, e) {
+  if (r === null)
     return console.debug("Using Null Engine"), ne(e);
   const t = e.engine || "auto";
   if (t === "webgpu")
-    if ($())
+    if (k())
       try {
-        return console.debug("Using forced WebGPU engine"), await M(a, e);
-      } catch (s) {
-        throw console.error("Forced WebGPU initialization failed:", s), new Error("Forced WebGPU failed to initialize. If WebGPU is required, check browser compatibility.");
+        return console.debug("Using forced WebGPU engine"), await M(r, e);
+      } catch (i) {
+        throw console.error("Forced WebGPU initialization failed:", i), new Error(
+          "Forced WebGPU failed to initialize. If WebGPU is required, check browser compatibility."
+        );
       }
     else
       throw new Error("WebGPU was forced but is not available in this browser.");
   if (t === "webgl")
-    return console.debug("Using forced WebGL engine"), v(a, e);
-  if ($())
+    return console.debug("Using forced WebGL engine"), v(r, e);
+  if (k())
     try {
-      return console.debug("Using WebGPU"), M(a, e).catch((s) => (console.warn("WebGPU initialization failed, falling back to WebGL:", s), v(a, e)));
-    } catch (s) {
-      console.warn("WebGPU initialization failed, falling back to WebGL:", s);
+      return console.debug("Using WebGPU"), M(r, e).catch((i) => (console.warn("WebGPU initialization failed, falling back to WebGL:", i), v(r, e)));
+    } catch (i) {
+      console.warn("WebGPU initialization failed, falling back to WebGL:", i);
     }
   else
     console.warn("WebGPU not supported, falling back to WebGL.");
-  return console.debug("Using WebGL"), v(a, e);
+  return console.debug("Using WebGL"), v(r, e);
 }
 async function ae() {
-  const a = await T();
-  return new R(!0, a);
+  const r = await R();
+  return new U(!0, r);
 }
-const de = ["keyboard", "mouse", "gamepad"], le = [
+const ue = ["keyboard", "mouse", "gamepad"], le = [
   "trace",
   "debug",
   "info",
@@ -2168,53 +2350,56 @@ const de = ["keyboard", "mouse", "gamepad"], le = [
   "error",
   "none"
 ];
-async function ge(a, e = {}) {
-  const t = new F(e.logLevel || "debug"), s = t.getLogger("SAGE");
+async function ge(r, e, t = {}) {
+  const i = new O(t.logLevel || "debug"), s = i.getLogger("SAGE");
   s.info(`Initializing SAGE Game Engine v${m}...`), s.debug("Creating rendering engine...");
-  const i = await oe(a, e.renderOptions || {});
+  const o = await oe(r, t.renderOptions || {});
   s.debug("Creating physics engine...");
-  const o = await ae();
+  const c = await ae();
   s.debug("Creating event bus...");
-  const r = new O(t);
+  const a = new W(i);
   s.debug("Creating scene engine...");
-  const c = new N(i, o, t);
+  const h = new F(o, c, i);
   s.debug("Creating managers...");
-  const h = new ie(r, a, t), u = new j(r, t), g = new Q(r, t, u), d = new Z(i, c, g, h, t);
-  if (s.info(`SAGE Game Engine v${m} initialized successfully.`), s.debug("Registering default input bindings..."), e.bindings)
-    for (const _ of e.bindings)
-      u.registerBinding(_);
+  const d = new se(a, r, i), _ = new X(a, i), u = new Q(a, i, _), p = new Z(o, h, u, d, i);
+  s.info(`SAGE Game Engine v${m} initialized successfully.`), s.debug("Loading entities...");
+  for (const l of e)
+    u.registerEntityDefinition(l);
+  if (s.debug("Registering default input bindings..."), t.bindings)
+    for (const l of t.bindings)
+      _.registerBinding(l);
   return new z(
+    r,
+    o,
+    c,
     a,
     i,
-    o,
-    r,
-    t,
     // Engines
     {
-      sceneEngine: c
+      sceneEngine: h
     },
     // Managers
     {
-      bindingManager: u,
-      entityManager: g,
-      gameManager: d,
-      inputManager: h
+      bindingManager: _,
+      entityManager: u,
+      gameManager: p,
+      inputManager: d
     }
   );
 }
 export {
-  W as ConsoleBackend,
+  P as ConsoleBackend,
   q as GameEntity,
-  ue as GameEntityBehavior,
-  O as GameEventBus,
+  de as GameEntityBehavior,
+  W as GameEventBus,
   le as LogLevels,
-  F as LoggingUtility,
-  P as NullBackend,
-  l as SAGELogger,
+  O as LoggingUtility,
+  H as NullBackend,
+  g as SAGELogger,
   z as SkewedAspectGameEngine,
   m as VERSION,
-  J as bindingTypes,
+  N as bindingTypes,
   ge as createGameEngine,
-  de as validDeviceTypes
+  ue as validDeviceTypes
 };
 //# sourceMappingURL=sage.es.js.map