dopaminejs 2.1.0 → 2.3.0

package/dist/dopamine.js

@@ -1,4 +1,5 @@
-class C {
+import { Animator as j, Collider as X, Component as J, Director as V, DopamineKernel as W, EventBus as K, Game as Y, GameObject as Q, GlobalInput as Z, GlobalLoader as tt, GlobalPhysics as et, Input as st, Loader as it, ParticleEmitter as at, Physics as nt, PluginRegistry as rt, Renderer as ot, Scene as lt, ScreenShake as ct, Sprite as ht, SystemRegistry as dt, Ticker as ut, Vector2 as pt } from "./engine.js";
+class T {
   constructor() {
     this.listeners = /* @__PURE__ */ new Map();
   }
@@ -8,28 +9,28 @@ class C {
    * @param {Function} callback - Callback function
    * @returns {Function} Unsubscribe function
    */
-  on(e, t) {
-    return this.listeners.has(e) || this.listeners.set(e, /* @__PURE__ */ new Set()), this.listeners.get(e).add(t), () => this.off(e, t);
+  on(t, e) {
+    return this.listeners.has(t) || this.listeners.set(t, /* @__PURE__ */ new Set()), this.listeners.get(t).add(e), () => this.off(t, e);
   }
   /**
    * Unsubscribe from an event
    * @param {string} event - Event name
    * @param {Function} callback - Callback function
    */
-  off(e, t) {
-    this.listeners.has(e) && this.listeners.get(e).delete(t);
+  off(t, e) {
+    this.listeners.has(t) && this.listeners.get(t).delete(e);
   }
   /**
    * Emit an event
    * @param {string} event - Event name
    * @param {*} data - Event data
    */
-  emit(e, t) {
-    this.listeners.has(e) && this.listeners.get(e).forEach((s) => {
+  emit(t, e) {
+    this.listeners.has(t) && this.listeners.get(t).forEach((s) => {
       try {
-        s(t);
+        s(e);
       } catch (i) {
-        console.error(`Error in listener for event '${e}':`, i);
+        console.error(`Error in listener for event '${t}':`, i);
       }
     });
   }
@@ -40,17 +41,68 @@ class C {
     this.listeners.clear();
   }
 }
-class O extends C {
-  constructor(e, t = {}) {
-    super(), this.dataService = e, this.player = null, this.achievements = { ...this._initAchievements(), ...t.achievements || {} };
+const E = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]), y = (r) => typeof r == "string" && r.length > 0 && !E.has(r), f = (r, t) => Object.prototype.hasOwnProperty.call(r, t), m = (r) => r !== null && typeof r == "object" && !Array.isArray(r), v = (r, t, e = 0) => {
+  const s = Number(r);
+  return Number.isInteger(s) && s >= e ? s : t;
+};
+class D extends T {
+  /**
+   * @param {Object} dataService - Persistence, see DataService
+   * @param {Object} [config]
+   * @param {Object} [config.achievements] - Extra achievement definitions
+   * @param {Object} [config.events] - Kernel EventBus to mirror events onto
+   * @param {Object} [config.kernel] - Kernel; its `events` bus is used if present
+   */
+  constructor(t, e = {}) {
+    super(), this.dataService = t, this.player = null, this.achievements = { ...this._initAchievements(), ...e.achievements || {} }, this.events = e.events || e.kernel?.events || null, this._batchDepth = 0, this._pendingSave = !1;
+  }
+  /**
+   * Emit locally, and mirror onto the kernel bus when one is attached.
+   * @private
+   */
+  _publish(t, e) {
+    this.emit(t, e), this.events && this.events.emit(t, e);
+  }
+  /**
+   * Run `fn` with saves collapsed into a single write at the end.
+   *
+   * Nested batches are counted, so an inner operation that batches on its
+   * own still results in exactly one write for the outermost call.
+   *
+   * @param {Function} fn
+   * @private
+   */
+  async _batch(t) {
+    this._batchDepth++;
+    try {
+      return await t();
+    } finally {
+      this._batchDepth--, this._batchDepth === 0 && this._pendingSave && (this._pendingSave = !1, await this._write());
+    }
   }
   /**
    * Initialize the reward system for current player
    * @returns {Promise<Object>} Player data
    */
   async init() {
-    const e = await this.dataService.load("player", null);
-    return this.player = this._migrate(e), this._updateDailyStreak(), await this.save(), this.player;
+    const t = await this.dataService.load("player", null);
+    this.player = this._migrate(t);
+    const e = this._updateDailyStreak();
+    return await this.save(), e && this._publishStreak(), this.player;
+  }
+  /**
+   * @private
+   */
+  _requirePlayer() {
+    if (!this.player)
+      throw new Error("[DopamineJS] RewardSystem.init() must be awaited before use");
+  }
+  /**
+   * @private
+   */
+  _publishStreak() {
+    const { current: t, longest: e } = this.player.streak;
+    this._publish("streak_updated", { current: t, longest: e });
   }
   /**
    * Get default player data structure
@@ -86,21 +138,80 @@ class O extends C {
    * @returns {Object} Player object guaranteed to have every field
    * @private
    */
-  _migrate(e) {
-    const t = this._getDefaultPlayer();
-    return !e || typeof e != "object" ? t : {
-      ...t,
+  _migrate(t) {
+    const e = this._getDefaultPlayer();
+    if (!m(t))
+      return e;
+    const s = Number(t.xp), i = Number.isFinite(s) && s >= 0 ? s : 0, n = this._calculateLevel(i), a = m(t.streak) ? t.streak : {}, o = v(a.current, 1, 1), l = typeof a.lastPlayDate == "string" && /^\d{4}-\d{2}-\d{2}$/.test(a.lastPlayDate) ? a.lastPlayDate : e.streak.lastPlayDate;
+    return {
       ...e,
-      streak: { ...t.streak, ...e.streak || {} },
-      achievements: e.achievements || {},
-      stats: e.stats || {}
+      ...t,
+      name: typeof t.name == "string" ? t.name : e.name,
+      xp: i,
+      // A level above the curve is kept: older versions banked levels
+      // at half the XP and those players keep what they earned.
+      level: Math.max(n, v(t.level, n, 1)),
+      totalGamesPlayed: v(t.totalGamesPlayed, 0),
+      createdAt: Number.isFinite(t.createdAt) ? t.createdAt : e.createdAt,
+      lastPlayedAt: Number.isFinite(t.lastPlayedAt) ? t.lastPlayedAt : e.lastPlayedAt,
+      streak: {
+        current: o,
+        longest: Math.max(o, v(a.longest, o, 1)),
+        lastPlayDate: l
+      },
+      achievements: this._migrateAchievements(t.achievements),
+      stats: this._migrateStats(t.stats)
     };
   }
+  /**
+   * @private
+   */
+  _migrateAchievements(t) {
+    const e = {};
+    if (!m(t)) return e;
+    for (const s of Object.keys(t)) {
+      const i = t[s];
+      !y(s) || !m(i) || (e[s] = {
+        unlockedAt: Number.isFinite(i.unlockedAt) ? i.unlockedAt : Date.now(),
+        seen: i.seen === !0
+      });
+    }
+    return e;
+  }
+  /**
+   * @private
+   */
+  _migrateStats(t) {
+    const e = {};
+    if (!m(t)) return e;
+    for (const s of Object.keys(t)) {
+      const i = t[s];
+      if (!y(s) || !m(i)) continue;
+      const n = {};
+      for (const a of Object.keys(i))
+        y(a) && Number.isFinite(i[a]) && (n[a] = i[a]);
+      n.totalPlays = v(i.totalPlays, 0), n.highScore = Number.isFinite(i.highScore) ? i.highScore : 0, e[s] = n;
+    }
+    return e;
+  }
   /**
    * Save player data
    */
   async save() {
-    this.player && (this.player.lastPlayedAt = Date.now(), await this.dataService.save("player", this.player));
+    if (this.player) {
+      if (this._batchDepth > 0) {
+        this._pendingSave = !0;
+        return;
+      }
+      await this._write();
+    }
+  }
+  /**
+   * The actual persistence call. Bypasses batching.
+   * @private
+   */
+  async _write() {
+    this.player.lastPlayedAt = Date.now(), await this.dataService.save("player", this.player) === !1 && this._publish("save_failed", { key: "player" });
   }
   /**
    * Add XP and handle level ups
@@ -108,30 +219,35 @@ class O extends C {
    * @param {string} reason - Why XP was awarded (for notifications)
    * @returns {Object} { leveledUp: boolean, newLevel: number, xpGained: number }
    */
-  async addXP(e, t = "") {
-    if (!Number.isFinite(e))
-      throw new TypeError(`[DopamineJS] addXP expects a finite number, received ${e}`);
+  async addXP(t, e = "") {
+    if (!Number.isFinite(t))
+      throw new TypeError(`[DopamineJS] addXP expects a finite number, received ${t}`);
+    this._requirePlayer();
     const s = this.player.level;
-    this.player.xp += e;
-    const i = this._calculateLevel(this.player.xp), r = i > s;
-    return r && (this.player.level = i), await this.save(), this.emit("xp_gained", { amount: e, reason: t, leveledUp: r, newLevel: i }), r && this.emit("level_up", { oldLevel: s, newLevel: i }), { leveledUp: r, newLevel: i, xpGained: e };
+    t = Math.max(t, -this.player.xp), this.player.xp += t;
+    const i = Math.max(s, this._calculateLevel(this.player.xp)), n = i > s;
+    n && (this.player.level = i), await this.save();
+    const a = this.player.xp;
+    return this._publish("xp_gained", { amount: t, reason: e, leveledUp: n, newLevel: i, total: a }), n && this._publish("level_up", { oldLevel: s, newLevel: i, totalXP: a }), { leveledUp: n, newLevel: i, xpGained: t };
   }
   /**
    * Calculate level from XP (exponential curve)
    */
-  _calculateLevel(e) {
-    const t = Math.floor((1 + Math.sqrt(1 + 4 * e / 50)) / 2);
-    return Math.max(1, t);
+  _calculateLevel(t) {
+    if (!(t > 0)) return 1;
+    const e = Math.floor((1 + Math.sqrt(1 + 4 * t / 50)) / 2);
+    return Math.max(1, e);
   }
   /**
    * Get XP needed for next level
    */
   getXPForNextLevel() {
-    const e = this.player.level + 1, t = 50 * e * (e - 1), s = 50 * this.player.level * (this.player.level - 1), i = t - s, r = i > 0 ? Math.max(0, Math.min(1, (this.player.xp - s) / i)) : 0;
+    this._requirePlayer();
+    const t = this.player.level + 1, e = 50 * t * (t - 1), s = 50 * this.player.level * (this.player.level - 1), i = e - s, n = i > 0 ? Math.max(0, Math.min(1, (this.player.xp - s) / i)) : 0;
     return {
-      total: t,
-      needed: Math.max(0, t - this.player.xp),
-      progress: r
+      total: e,
+      needed: Math.max(0, e - this.player.xp),
+      progress: n
     };
   }
   /**
@@ -139,86 +255,103 @@ class O extends C {
    * @param {string} gameName - Unique ID for the game
    * @param {Object} result - Game-specific result data
    */
-  async recordGame(e, t) {
-    this.player.stats[e] || (this.player.stats[e] = { totalPlays: 0, highScore: 0 });
-    const s = this.player.stats[e];
-    s.totalPlays++, this.player.totalGamesPlayed++, t.score !== void 0 && t.score > s.highScore && (s.highScore = t.score, this.emit("new_high_score", { gameName: e, score: t.score })), Object.keys(t).forEach((r) => {
-      r !== "score" && (s[r] = (s[r] || 0) + (typeof t[r] == "number" ? t[r] : 0));
+  async recordGame(t, e = {}) {
+    if (this._requirePlayer(), !y(t))
+      throw new TypeError(`[DopamineJS] recordGame expects a game name, received ${String(t)}`);
+    if (!m(e))
+      throw new TypeError("[DopamineJS] recordGame expects a result object");
+    if (e.score !== void 0 && !Number.isFinite(e.score))
+      throw new TypeError(`[DopamineJS] recordGame expects a finite score, received ${String(e.score)}`);
+    return this._batch(() => this._recordGame(t, e));
+  }
+  /**
+   * @private
+   */
+  async _recordGame(t, e) {
+    this._updateDailyStreak() && this._publishStreak(), f(this.player.stats, t) || (this.player.stats[t] = { totalPlays: 0, highScore: 0 });
+    const s = this.player.stats[t];
+    s.totalPlays++, this.player.totalGamesPlayed++, e.score !== void 0 && e.score > s.highScore && (s.highScore = e.score, this._publish("new_high_score", { gameName: t, score: e.score })), Object.keys(e).forEach((n) => {
+      if (n !== "score" && y(n)) {
+        const a = f(s, n) && Number.isFinite(s[n]) ? s[n] : 0;
+        s[n] = a + (Number.isFinite(e[n]) ? e[n] : 0);
+      }
     });
     let i = 10;
-    t.score && (i += Math.floor(t.score / 5)), i = Math.floor(i * this.getStreakMultiplier()), await this.addXP(i, `Played ${e}`), await this.checkAchievements(e, t), await this.save();
+    e.score && (i += Math.max(0, Math.floor(e.score / 5))), i = Math.floor(i * this.getStreakMultiplier()), await this.addXP(i, `Played ${t}`), await this.checkAchievements(t, e), await this.save();
   }
   /**
    * Check and unlock achievements
    */
-  async checkAchievements(e, t) {
+  async checkAchievements(t, e) {
     const s = [];
-    for (const [i, r] of Object.entries(this.achievements)) {
-      if (this.player.achievements[i]) continue;
-      let n = !1;
+    for (const [i, n] of Object.entries(this.achievements)) {
+      if (f(this.player.achievements, i)) continue;
+      let a = !1;
       try {
-        n = r.check(this.player, e, t);
+        a = n.check(this.player, t, e);
       } catch (o) {
         console.error(`[DopamineJS] Achievement "${i}" check threw:`, o);
         continue;
       }
-      n && (await this.unlockAchievement(i), s.push(r));
+      a && await this.unlockAchievement(i) && s.push(n);
     }
     return s;
   }
   /**
    * Unlock an achievement
    */
-  async unlockAchievement(e) {
-    const t = this.achievements[e];
-    return t ? (this.player.achievements[e] = {
+  async unlockAchievement(t) {
+    if (this._requirePlayer(), !y(t) || !f(this.achievements, t) || f(this.player.achievements, t)) return !1;
+    const e = this.achievements[t];
+    return e ? (this.player.achievements[t] = {
       unlockedAt: Date.now(),
       seen: !1
     }, await this.addXP(
-      Number.isFinite(t.xp) ? t.xp : 0,
-      `Achievement: ${t.name}`
-    ), this.emit("achievement_unlocked", t), await this.save(), !0) : !1;
+      Number.isFinite(e.xp) ? e.xp : 0,
+      `Achievement: ${e.name}`
+    ), this._publish("achievement_unlocked", { ...e, id: t }), await this.save(), !0) : !1;
   }
   /**
    * Get all unlocked achievements
    */
   getUnlockedAchievements() {
-    return Object.entries(this.player.achievements).map(([e, t]) => ({
-      ...this.achievements[e],
-      id: e,
-      ...t
+    return Object.entries(this.player.achievements).map(([t, e]) => ({
+      ...this.achievements[t],
+      id: t,
+      ...e
     }));
   }
   /**
    * Get achievements user hasn't seen the notification for yet
    */
   getUnseenAchievements() {
-    return this.getUnlockedAchievements().filter((e) => !e.seen);
+    return this.getUnlockedAchievements().filter((t) => !t.seen);
   }
   /**
    * Mark achievements as seen
    */
-  async markAchievementsSeen(e) {
-    for (const t of e)
-      this.player.achievements[t] && (this.player.achievements[t].seen = !0);
+  async markAchievementsSeen(t) {
+    for (const e of t)
+      f(this.player.achievements, e) && (this.player.achievements[e].seen = !0);
     await this.save();
   }
   /**
    * Update daily streak
+   * @returns {boolean} True when the calendar day changed
    */
   _updateDailyStreak() {
-    const e = this._getTodayDateString(), t = this.player.streak.lastPlayDate;
-    if (t === e)
-      return;
+    const t = this._getTodayDateString(), e = this.player.streak.lastPlayDate;
+    if (e === t)
+      return !1;
     const s = this._getYesterdayDateString();
-    t === s ? (this.player.streak.current++, this.player.streak.current > this.player.streak.longest && (this.player.streak.longest = this.player.streak.current)) : this.player.streak.current = 1, this.player.streak.lastPlayDate = e;
+    return e === s ? (this.player.streak.current++, this.player.streak.current > this.player.streak.longest && (this.player.streak.longest = this.player.streak.current)) : this.player.streak.current = 1, this.player.streak.lastPlayDate = t, !0;
   }
   /**
    * Get streak multiplier for XP
    */
   getStreakMultiplier() {
-    const e = this.player.streak.current;
-    return e >= 7 ? 2 : e >= 5 ? 1.5 : e >= 3 ? 1.25 : 1;
+    const t = this.player.streak.current;
+    return t >= 7 ? 2 : t >= 5 ? 1.5 : t >= 3 ? 1.25 : 1;
   }
   /**
    * Format a Date as a YYYY-MM-DD string in the player's local timezone.
@@ -231,9 +364,9 @@ class O extends C {
    * @returns {string}
    * @private
    */
-  _toLocalDateString(e) {
-    const t = e.getFullYear(), s = String(e.getMonth() + 1).padStart(2, "0"), i = String(e.getDate()).padStart(2, "0");
-    return `${t}-${s}-${i}`;
+  _toLocalDateString(t) {
+    const e = t.getFullYear(), s = String(t.getMonth() + 1).padStart(2, "0"), i = String(t.getDate()).padStart(2, "0");
+    return `${e}-${s}-${i}`;
   }
   /**
    * Get today's local date as YYYY-MM-DD string
@@ -245,8 +378,8 @@ class O extends C {
    * Get yesterday's local date as YYYY-MM-DD string
    */
   _getYesterdayDateString() {
-    const e = /* @__PURE__ */ new Date();
-    return e.setDate(e.getDate() - 1), this._toLocalDateString(e);
+    const t = /* @__PURE__ */ new Date();
+    return t.setDate(t.getDate() - 1), this._toLocalDateString(t);
   }
   /**
    * Initialize achievement definitions
@@ -260,77 +393,96 @@ class O extends C {
         description: "Play your first game",
         icon: "🎮",
         xp: 50,
-        check: (e) => e.totalGamesPlayed >= 1
+        check: (t) => t.totalGamesPlayed >= 1
       },
       level_5: {
         name: "Rising Star",
         description: "Reach level 5",
         icon: "⭐",
         xp: 100,
-        check: (e) => e.level >= 5
+        check: (t) => t.level >= 5
       },
       level_10: {
         name: "Expert Player",
         description: "Reach level 10",
         icon: "🏆",
         xp: 250,
-        check: (e) => e.level >= 10
+        check: (t) => t.level >= 10
       },
       streak_3: {
         name: "Dedicated",
         description: "Play 3 days in a row",
         icon: "🔥",
         xp: 100,
-        check: (e) => e.streak.current >= 3
+        check: (t) => t.streak.current >= 3
       },
       streak_7: {
         name: "Unstoppable",
         description: "Play 7 days in a row",
         icon: "💥",
         xp: 300,
-        check: (e) => e.streak.current >= 7
+        check: (t) => t.streak.current >= 7
       }
     };
   }
 }
-function w() {
-  const a = /* @__PURE__ */ new Map();
+function P() {
+  const r = /* @__PURE__ */ new Map();
   return {
-    getItem: (e) => a.has(e) ? a.get(e) : null,
-    setItem: (e, t) => {
-      a.set(e, String(t));
+    getItem: (t) => r.has(t) ? r.get(t) : null,
+    setItem: (t, e) => {
+      r.set(t, String(e));
     },
-    removeItem: (e) => {
-      a.delete(e);
+    removeItem: (t) => {
+      r.delete(t);
     },
     clear: () => {
-      a.clear();
+      r.clear();
     }
   };
 }
-function S() {
+function A() {
   try {
     if (typeof localStorage > "u")
-      return w();
-    const a = "__dopamine_probe__";
-    return localStorage.setItem(a, "1"), localStorage.removeItem(a), localStorage;
+      return P();
+    const r = "__dopamine_probe__";
+    return localStorage.setItem(r, "1"), localStorage.removeItem(r), localStorage;
   } catch {
-    return w();
+    return P();
   }
 }
-class A {
-  constructor(e = {}) {
-    this.storage = e.storage || S(), this.prefix = e.prefix || "dopamine_";
+class I {
+  constructor(t = {}) {
+    this.storage = t.storage || A(), this.prefix = t.prefix || "dopamine_", this._tail = null;
+  }
+  /**
+   * Run a write after any write still in flight.
+   *
+   * Promise storage can finish two overlapping writes in either order, and
+   * the older value would win. Synchronous storage never has one in flight,
+   * so it still writes before this returns.
+   * @private
+   */
+  _write(t) {
+    const e = this._tail ? this._tail.then(t) : t();
+    if (typeof e?.then == "function") {
+      const s = Promise.resolve(e).catch(() => {
+      }).then(() => {
+        this._tail === s && (this._tail = null);
+      });
+      this._tail = s;
+    }
+    return e;
   }
   /**
    * Save data to local storage
    * @param {string} key 
    * @param {any} data 
    */
-  async save(e, t) {
+  async save(t, e) {
     try {
-      const s = JSON.stringify(t);
-      return this.storage.setItem(this.prefix + e, s), !0;
+      const s = JSON.stringify(e);
+      return await this._write(() => this.storage.setItem(this.prefix + t, s)), !0;
     } catch (s) {
       return console.error("Error saving data:", s), !1;
     }
@@ -340,32 +492,33 @@ class A {
    * @param {string} key 
    * @param {any} defaultValue 
    */
-  async load(e, t = null) {
+  async load(t, e = null) {
     try {
-      const s = this.storage.getItem(this.prefix + e);
-      return s ? JSON.parse(s) : t;
+      await this._tail;
+      const s = await this.storage.getItem(this.prefix + t);
+      return s ? JSON.parse(s) : e;
     } catch (s) {
-      return console.error("Error loading data:", s), t;
+      return console.error("Error loading data:", s), e;
     }
   }
   /**
    * Clear specific data
    * @param {string} key 
    */
-  async clear(e) {
-    this.storage.removeItem(this.prefix + e);
+  async clear(t) {
+    await this._write(() => this.storage.removeItem(this.prefix + t));
   }
 }
-const k = "game-ui-overlay";
-class D {
-  constructor(e) {
-    this.particleSystem = e, this.container = null, this.xpBar = null, this.levelDisplay = null, this.streakDisplay = null, this._timers = /* @__PURE__ */ new Set(), this._detached = [], this.init();
+const M = "game-ui-overlay";
+class L {
+  constructor(t) {
+    this.particleSystem = t, this.container = null, this.xpBar = null, this.levelDisplay = null, this.streakDisplay = null, this._timers = /* @__PURE__ */ new Set(), this._detached = [], this.init();
   }
   /**
    * Initialize UI overlay
    */
   init() {
-    this.container = document.createElement("div"), this.container.className = "game-ui-overlay", document.getElementById(k) || (this.container.id = k), this.container.innerHTML = `
+    this.container = document.createElement("div"), this.container.className = "game-ui-overlay", document.getElementById(M) || (this.container.id = M), this.container.innerHTML = `
             <div class="game-ui-top-bar">
                 <div class="level-badge">
                     <span class="level-label">LVL</span>
@@ -384,32 +537,46 @@ class D {
                     <span class="streak-number">1</span>
                 </div>
             </div>
-        `, document.body.appendChild(this.container), this.levelBadge = this.container.querySelector(".level-badge"), this.streakBadge = this.container.querySelector(".streak-badge"), this.xpBar = this.container.querySelector(".xp-bar-fill"), this.xpText = this.container.querySelector(".xp-text"), this.levelDisplay = this.container.querySelector(".level-number"), this.streakDisplay = this.container.querySelector(".streak-number");
+        `, this.liveRegion = document.createElement("div"), this.liveRegion.className = "dopamine-live-region", this.liveRegion.setAttribute("aria-live", "polite"), this.liveRegion.setAttribute("role", "status"), Object.assign(this.liveRegion.style, {
+      position: "absolute",
+      width: "1px",
+      height: "1px",
+      overflow: "hidden",
+      clipPath: "inset(50%)",
+      whiteSpace: "nowrap"
+    }), this.container.appendChild(this.liveRegion), document.body.appendChild(this.container), this.levelBadge = this.container.querySelector(".level-badge"), this.streakBadge = this.container.querySelector(".streak-badge"), this.xpBar = this.container.querySelector(".xp-bar-fill"), this.xpText = this.container.querySelector(".xp-text"), this.levelDisplay = this.container.querySelector(".level-number"), this.streakDisplay = this.container.querySelector(".streak-number");
   }
   /**
    * setTimeout that destroy() can cancel.
    * @private
    */
-  _defer(e, t) {
+  _defer(t, e) {
     const s = setTimeout(() => {
-      this._timers.delete(s), e();
-    }, t);
+      this._timers.delete(s), t();
+    }, e);
     return this._timers.add(s), s;
   }
   /**
    * Append a transient element and remember it for cleanup.
    * @private
    */
-  _mount(e) {
-    return document.body.appendChild(e), this._detached.push(e), e;
+  _mount(t) {
+    return document.body.appendChild(t), this._detached.push(t), t;
+  }
+  /**
+   * Repeat a popup as text for assistive technology.
+   * @private
+   */
+  _announce(t) {
+    this.liveRegion && (this.liveRegion.textContent = t);
   }
   /**
    * Replay a CSS animation by clearing it for one tick.
    * @private
    */
-  _replayAnimation(e, t) {
-    e && (e.style.animation = "none", this._defer(() => {
-      e.style.animation = t;
+  _replayAnimation(t, e) {
+    t && (t.style.animation = "none", this._defer(() => {
+      t.style.animation = e;
     }, 10));
   }
   /**
@@ -417,22 +584,25 @@ class D {
    * @param {number} current - XP held right now
    * @param {number} needed - XP still required for the next level
    * @param {number} total - XP total that marks the next level
+   * @param {number} [progress] - Position within the current level, 0 to 1.
+   *   Without it the bar falls back to current / total, which is lifetime
+   *   XP and starts every level after the first partly full.
    */
-  updateXP(e, t, s) {
-    const i = s > 0 ? e / s * 100 : 0;
-    this.xpBar.style.width = `${Math.max(0, Math.min(100, i))}%`, this.xpText.textContent = `${e} / ${s} XP`, this._replayAnimation(this.xpBar, "xp-pulse 0.3s ease-out");
+  updateXP(t, e, s, i) {
+    const n = Number.isFinite(i) ? i : s > 0 ? t / s : 0;
+    this.xpBar.style.width = `${Math.max(0, Math.min(100, n * 100))}%`, this.xpText.textContent = `${t} / ${s} XP`, this._replayAnimation(this.xpBar, "xp-pulse 0.3s ease-out");
   }
   /**
    * Update level display
    */
-  updateLevel(e) {
-    this.levelDisplay.textContent = e, this._replayAnimation(this.levelBadge, "level-pulse 0.5s ease-out");
+  updateLevel(t) {
+    this.levelDisplay.textContent = t, this._replayAnimation(this.levelBadge, "level-pulse 0.5s ease-out");
   }
   /**
    * Update streak display
    */
-  updateStreak(e) {
-    this.streakDisplay.textContent = e, e >= 7 ? this.streakBadge.style.background = "linear-gradient(135deg, #ff6b00 0%, #ff4400 100%)" : e >= 3 && (this.streakBadge.style.background = "linear-gradient(135deg, #ff8800 0%, #ff6b00 100%)");
+  updateStreak(t) {
+    this.streakDisplay.textContent = t, t >= 7 ? this.streakBadge.style.background = "linear-gradient(135deg, #ff6b00 0%, #ff4400 100%)" : t >= 3 ? this.streakBadge.style.background = "linear-gradient(135deg, #ff8800 0%, #ff6b00 100%)" : this.streakBadge.style.background = "";
   }
   /**
    * Show achievement unlocked popup
@@ -442,9 +612,9 @@ class D {
    * and could carry a player-supplied or server-supplied string, so it goes
    * in as text.
    */
-  showAchievement(e) {
-    const t = document.createElement("div");
-    t.className = "achievement-popup", t.innerHTML = `
+  showAchievement(t) {
+    const e = document.createElement("div");
+    e.className = "achievement-popup", e.innerHTML = `
             <div class="achievement-shine"></div>
             <div class="achievement-content">
                 <div class="achievement-icon"></div>
@@ -455,17 +625,17 @@ class D {
                     <div class="achievement-xp"></div>
                 </div>
             </div>
-        `, t.querySelector(".achievement-icon").innerHTML = e.icon ?? "", t.querySelector(".achievement-name").textContent = e.name ?? "", t.querySelector(".achievement-desc").textContent = e.description ?? "", t.querySelector(".achievement-xp").textContent = `+${e.xp ?? 0} XP`, this._mount(t), this._defer(() => {
-      const s = t.getBoundingClientRect();
+        `, e.querySelector(".achievement-icon").innerHTML = t.icon ?? "", e.querySelector(".achievement-name").textContent = t.name ?? "", e.querySelector(".achievement-desc").textContent = t.description ?? "", e.querySelector(".achievement-xp").textContent = `+${t.xp ?? 0} XP`, this._mount(e), this._announce(`Achievement unlocked: ${t.name ?? ""}`), this._defer(() => {
+      const s = e.getBoundingClientRect();
       this.particleSystem.confetti(s.left + s.width / 2, s.top + s.height / 2, 40);
     }, 300), this._defer(() => {
-      t.style.animation = "slideOut 0.3s ease-in forwards", this._defer(() => this._remove(t), 300);
+      e.style.animation = "slideOut 0.3s ease-in forwards", this._defer(() => this._remove(e), 300);
     }, 4e3);
   }
   /**
    * Show level up screen
    */
-  showLevelUp(e, t) {
+  showLevelUp(t, e) {
     const s = document.createElement("div");
     s.className = "level-up-overlay", s.innerHTML = `
             <div class="level-up-content">
@@ -473,11 +643,11 @@ class D {
                 <div class="level-up-number"></div>
                 <div class="level-up-subtitle">Amazing progress!</div>
             </div>
-        `, s.querySelector(".level-up-number").textContent = t, this._mount(s), this._defer(() => {
+        `, s.querySelector(".level-up-number").textContent = e, this._mount(s), this._announce(`Level up: ${e}`), this._defer(() => {
       for (let i = 0; i < 5; i++)
         this._defer(() => {
-          const r = Math.random() * window.innerWidth, n = Math.random() * window.innerHeight * 0.6;
-          this.particleSystem.confetti(r, n, 30);
+          const n = Math.random() * window.innerWidth, a = Math.random() * window.innerHeight * 0.6;
+          this.particleSystem.confetti(n, a, 30);
         }, i * 200);
     }, 300), this._defer(() => {
       s.style.opacity = "0", this._defer(() => this._remove(s), 500);
@@ -486,34 +656,34 @@ class D {
   /**
    * Show floating text (e.g., "+50 XP", "COMBO!")
    */
-  showFloatingText(e, t, s, i = "#ffd700", r = "24px") {
-    const n = document.createElement("div");
-    n.className = "floating-text", n.textContent = e, n.style.left = t + "px", n.style.top = s + "px", n.style.color = i, n.style.fontSize = r, this._mount(n), this._defer(() => this._remove(n), 2e3);
+  showFloatingText(t, e, s, i = "#ffd700", n = "24px") {
+    const a = document.createElement("div");
+    a.className = "floating-text", a.textContent = t, a.style.left = e + "px", a.style.top = s + "px", a.style.color = i, a.style.fontSize = n, this._mount(a), this._defer(() => this._remove(a), 2e3);
   }
   /**
    * Show combo multiplier
    */
-  showCombo(e, t, s) {
-    this.showFloatingText(`${e}× COMBO!`, t, s, "#ff6b6b", "32px"), this.particleSystem.fire(t, s, 20);
+  showCombo(t, e, s) {
+    this.showFloatingText(`${t}× COMBO!`, e, s, "#ff6b6b", "32px"), this.particleSystem.fire(e, s, 20);
   }
   /**
    * Show "near miss" indicator
    */
-  showNearMiss(e, t) {
-    this.showFloatingText("CLOSE CALL!", e, t, "#45b7d1", "20px"), this.particleSystem.sparkle(e, t, 15, "#45b7d1");
+  showNearMiss(t, e) {
+    this.showFloatingText("CLOSE CALL!", t, e, "#45b7d1", "20px"), this.particleSystem.sparkle(t, e, 15, "#45b7d1");
   }
   /**
    * Show lucky moment (random multiplier)
    */
-  showLuckyMoment(e, t, s) {
-    this.showFloatingText(`LUCKY ${e}×!`, t, s, "#ffd700", "36px"), this.particleSystem.starBurst(t, s, 12), this.particleSystem.confetti(t, s, 25);
+  showLuckyMoment(t, e, s) {
+    this.showFloatingText(`LUCKY ${t}×!`, e, s, "#ffd700", "36px"), this.particleSystem.starBurst(e, s, 12), this.particleSystem.confetti(e, s, 25);
   }
   /**
    * Show generic notification
    */
-  showNotification(e, t = "normal") {
+  showNotification(t, e = "normal") {
     const s = window.innerWidth / 2, i = window.innerHeight / 3;
-    t === "legendary" ? this.showLuckyMoment(e, s, i) : t === "rare" ? this.showCombo(e, s, i) : this.showFloatingText(e, s, i, "#fff", "24px");
+    e === "legendary" ? (this.showFloatingText(t, s, i, "#ffd700", "36px"), this.particleSystem.starBurst(s, i, 12), this.particleSystem.confetti(s, i, 25)) : e === "rare" ? (this.showFloatingText(t, s, i, "#ff6b6b", "32px"), this.particleSystem.fire(s, i, 20)) : this.showFloatingText(t, s, i, "#fff", "24px"), this._announce(t);
   }
   /**
    * Show Game Over Summary
@@ -524,121 +694,130 @@ class D {
    * @param {Function} [data.onReplay] - Replay button handler (default: reload)
    * @param {Function} [data.onExit] - Exit button handler (button hidden if omitted)
    */
-  showSummary(e) {
-    const t = document.createElement("div");
-    t.className = "message-box", t.style.display = "flex", t.style.position = "absolute", t.style.top = "50%", t.style.left = "50%", t.style.transform = "translate(-50%, -50%)", t.style.zIndex = "1000";
+  showSummary(t) {
+    const e = document.createElement("div");
+    e.className = "message-box", e.style.display = "flex", e.style.position = "absolute", e.style.top = "50%", e.style.left = "50%", e.style.transform = "translate(-50%, -50%)", e.style.zIndex = "1000";
     const s = document.createElement("h1");
     s.textContent = "Game Over";
     const i = document.createElement("div");
-    i.className = "summary-score", i.style.cssText = "font-size: 3rem; font-weight: bold; color: #e06020; margin: 10px 0;", i.textContent = e.score;
-    const r = document.createElement("div");
-    r.className = "summary-metrics", r.style.cssText = "width: 100%; margin-bottom: 20px;";
-    for (const [o, c] of Object.entries(e.metrics || {})) {
+    i.className = "summary-score", i.style.cssText = "font-size: 3rem; font-weight: bold; color: #e06020; margin: 10px 0;", i.textContent = t.score;
+    const n = document.createElement("div");
+    n.className = "summary-metrics", n.style.cssText = "width: 100%; margin-bottom: 20px;";
+    for (const [o, l] of Object.entries(t.metrics || {})) {
       const h = document.createElement("div");
       h.style.cssText = "display:flex;justify-content:space-between;width:100%";
-      const l = document.createElement("span");
-      l.textContent = `${o}:`;
+      const d = document.createElement("span");
+      d.textContent = `${o}:`;
       const u = document.createElement("strong");
-      u.textContent = c, h.append(l, u), r.appendChild(h);
+      u.textContent = l, h.append(d, u), n.appendChild(h);
     }
-    t.append(s, i, r);
-    const n = document.createElement("button");
-    if (n.className = "btn", n.textContent = "Play Again", n.addEventListener("click", e.onReplay || (() => window.location.reload())), t.appendChild(n), e.onExit) {
+    e.append(s, i, n);
+    const a = document.createElement("button");
+    if (a.className = "btn", a.textContent = "Play Again", a.addEventListener("click", t.onReplay || (() => window.location.reload())), e.appendChild(a), t.onExit) {
       const o = document.createElement("button");
-      o.className = "btn", o.textContent = "Exit", o.style.cssText = "margin-top: 10px; background: #543847;", o.addEventListener("click", e.onExit), t.appendChild(o);
+      o.className = "btn", o.textContent = "Exit", o.style.cssText = "margin-top: 10px; background: #543847;", o.addEventListener("click", t.onExit), e.appendChild(o);
     }
-    return this._mount(t), t;
+    return this._mount(e), e;
   }
   /**
    * @private
    */
-  _remove(e) {
-    e.remove();
-    const t = this._detached.indexOf(e);
-    t > -1 && this._detached.splice(t, 1);
+  _remove(t) {
+    t.remove();
+    const e = this._detached.indexOf(t);
+    e > -1 && this._detached.splice(e, 1);
   }
   /**
    * Tear down the overlay, any transient popups, and all pending timers.
    */
   destroy() {
-    var e;
     for (const t of this._timers)
       clearTimeout(t);
     this._timers.clear();
     for (const t of this._detached)
       t.remove();
-    this._detached = [], (e = this.container) == null || e.remove(), this.container = null, this.xpBar = null, this.xpText = null, this.levelBadge = null, this.streakBadge = null, this.levelDisplay = null, this.streakDisplay = null;
+    this._detached = [], this.container?.remove(), this.container = null, this.liveRegion = null, this.xpBar = null, this.xpText = null, this.levelBadge = null, this.streakBadge = null, this.levelDisplay = null, this.streakDisplay = null;
   }
 }
-class T {
-  constructor(e = {}) {
-    this.container = e.container ? typeof e.container == "string" ? document.querySelector(e.container) : e.container : document.body, this.canvasId = e.canvasId || "dopamine-particle-canvas", this.canvas = document.createElement("canvas"), this.canvas.classList.add("dopamine-particle-canvas"), document.getElementById(this.canvasId) || (this.canvas.id = this.canvasId), this.canvas.style.pointerEvents = "none", this.canvas.style.zIndex = e.zIndex || "9999", this.container === document.body ? (this.canvas.style.position = "fixed", this.canvas.style.top = "0", this.canvas.style.left = "0") : (this.canvas.style.position = "absolute", this.canvas.style.top = "0", this.canvas.style.left = "0", window.getComputedStyle(this.container).position === "static" && (this.container.style.position = "relative")), this.container.appendChild(this.canvas), this.ctx = this.canvas.getContext("2d"), this.particles = [], this.pool = [], this.sprites = /* @__PURE__ */ new Map(), this.customEffects = /* @__PURE__ */ new Map(), this.isAnimating = !1, this._onResize = () => this._resize(), this._resizeObserver = null, this._frameHandle = null, this._resize(), window.ResizeObserver && this.container !== document.body ? (this._resizeObserver = new ResizeObserver(this._onResize), this._resizeObserver.observe(this.container)) : window.addEventListener("resize", this._onResize);
+class z {
+  constructor(t = {}) {
+    this.container = t.container ? typeof t.container == "string" ? document.querySelector(t.container) : t.container : document.body, this.container || (console.warn(`[DopamineJS] Particle container '${t.container}' not found. Using document.body.`), this.container = document.body), this.maxParticles = Number.isFinite(t.maxParticles) ? Math.max(0, Math.floor(t.maxParticles)) : 5e3, this._reducedMotion = t.respectReducedMotion !== !1 && typeof window.matchMedia == "function" ? window.matchMedia("(prefers-reduced-motion: reduce)") : null, this.canvasId = t.canvasId || "dopamine-particle-canvas", this.canvas = document.createElement("canvas"), this.canvas.classList.add("dopamine-particle-canvas"), document.getElementById(this.canvasId) || (this.canvas.id = this.canvasId), this.canvas.style.pointerEvents = "none", this.canvas.style.zIndex = t.zIndex || "9999", this.container === document.body ? (this.canvas.style.position = "fixed", this.canvas.style.top = "0", this.canvas.style.left = "0") : (this.canvas.style.position = "absolute", this.canvas.style.top = "0", this.canvas.style.left = "0", window.getComputedStyle(this.container).position === "static" && (this.container.style.position = "relative")), this.container.appendChild(this.canvas), this.ctx = this.canvas.getContext("2d"), this.particles = [], this.pool = [], this.sprites = /* @__PURE__ */ new Map(), this.customEffects = /* @__PURE__ */ new Map(), this.isAnimating = !1, this._onResize = () => this._resize(), this._resizeObserver = null, this._frameHandle = null, this._lastFrameTime = null, this._resize(), window.ResizeObserver && this.container !== document.body ? (this._resizeObserver = new ResizeObserver(this._onResize), this._resizeObserver.observe(this.container)) : window.addEventListener("resize", this._onResize);
   }
   _resize() {
-    const e = this.container === document.body ? window.innerWidth : this.container.clientWidth, t = this.container === document.body ? window.innerHeight : this.container.clientHeight, s = window.devicePixelRatio || 1;
-    this.width = e, this.height = t, this.canvas.width = Math.round(e * s), this.canvas.height = Math.round(t * s), this.canvas.style.width = `${e}px`, this.canvas.style.height = `${t}px`, this.ctx.setTransform(s, 0, 0, s, 0, 0);
+    const t = this.container === document.body ? window.innerWidth : this.container.clientWidth, e = this.container === document.body ? window.innerHeight : this.container.clientHeight, s = window.devicePixelRatio || 1;
+    this.width = t, this.height = e, this.canvas.width = Math.round(t * s), this.canvas.height = Math.round(e * s), this.canvas.style.width = `${t}px`, this.canvas.style.height = `${e}px`, this.ctx.setTransform(s, 0, 0, s, 0, 0);
   }
   /**
    * Register a custom sprite image
    * @param {string} key 
    * @param {string} url 
    */
-  registerSprite(e, t) {
+  registerSprite(t, e) {
     const s = new Image();
-    s.src = t, this.sprites.set(e, s);
+    s.src = e, this.sprites.set(t, s);
   }
   /**
    * Register a custom effect
    * @param {string} name 
    * @param {Function} callback - (x, y, ...args) => void
    */
-  registerEffect(e, t) {
-    this.customEffects.set(e, t);
+  registerEffect(t, e) {
+    this.customEffects.set(t, e);
   }
   /**
    * Play a registered effect
    */
-  play(e, t, s, ...i) {
-    const r = this.customEffects.get(e);
-    r ? r(t, s, ...i) : console.warn(`[DopamineJS] Effect '${e}' not found.`);
+  play(t, e, s, ...i) {
+    const n = this.customEffects.get(t);
+    n ? n(e, s, ...i) : console.warn(`[DopamineJS] Effect '${t}' not found.`);
   }
   /**
    * Emit particles with custom config
    * @param {Object} config 
    */
-  emit(e) {
+  emit(t) {
     const {
-      x: t,
+      x: e,
       y: s,
       count: i = 10,
-      speed: r = 5,
-      gravity: n = 0.1,
+      speed: n = 5,
+      gravity: a = 0.1,
       decay: o = 0.02,
-      life: c = 1,
+      life: l = 1,
       color: h = "#ffd700",
-      sprite: l = null,
+      sprite: d = null,
       spread: u = Math.PI * 2,
-      angle: m = 0,
-      size: f = 5
-    } = e;
-    for (let v = 0; v < i; v++) {
-      const d = this._getParticle(), _ = m + (Math.random() - 0.5) * u, x = Math.random() * r;
-      d.x = t, d.y = s, d.vx = Math.cos(_) * x, d.vy = Math.sin(_) * x, d.life = c, d.decay = o * (0.8 + Math.random() * 0.4), d.gravity = n, d.color = Array.isArray(h) ? h[Math.floor(Math.random() * h.length)] : h, d.size = f * (0.8 + Math.random() * 0.4), d.sprite = l, d.rotation = Math.random() * Math.PI * 2, d.rotationSpeed = (Math.random() - 0.5) * 0.2, this.particles.push(d);
+      angle: p = 0,
+      size: g = 5,
+      type: C = null
+    } = t, x = this._allowed(i);
+    for (let w = 0; w < x; w++) {
+      const c = this._getParticle(), S = p + (Math.random() - 0.5) * u, b = Math.random() * n;
+      c.x = e, c.y = s, c.vx = Math.cos(S) * b, c.vy = Math.sin(S) * b, c.life = l, c.decay = o * (0.8 + Math.random() * 0.4), c.gravity = a, c.color = Array.isArray(h) ? h[Math.floor(Math.random() * h.length)] : h, c.size = g * (0.8 + Math.random() * 0.4), c.sprite = d, c.type = C, c.rotation = Math.random() * Math.PI * 2, c.rotationSpeed = (Math.random() - 0.5) * 0.2, this.particles.push(c);
     }
-    this._startAnimation();
+    x > 0 && this._startAnimation();
+  }
+  /**
+   * How many of `count` particles may be created right now.
+   * @private
+   */
+  _allowed(t) {
+    if (this._reducedMotion?.matches || !Number.isFinite(t)) return 0;
+    const e = this.maxParticles - this.particles.length;
+    return Math.max(0, Math.min(Math.floor(t), e));
   }
   _getParticle() {
     return this.pool.length > 0 ? this.pool.pop() : {};
   }
-  _recycleParticle(e) {
-    this.pool.push(e);
+  _recycleParticle(t) {
+    this.pool.push(t);
   }
   // --- Built-in Effects ---
-  confetti(e, t, s = 50) {
+  confetti(t, e, s = 50) {
     const i = ["#ff6b6b", "#4ecdc4", "#45b7d1", "#f7dc6f", "#c06c84", "#6c5ce7"];
     this.emit({
-      x: e,
-      y: t,
+      x: t,
+      y: e,
       count: s,
       color: i,
       speed: 10,
@@ -648,10 +827,10 @@ class T {
       spread: Math.PI * 2
     });
   }
-  coinShower(e, t, s = 10) {
+  coinShower(t, e, s = 10) {
     this.emit({
-      x: e,
-      y: t,
+      x: t,
+      y: e,
       count: s,
       color: "#ffd700",
       speed: 4,
@@ -663,10 +842,10 @@ class T {
       spread: Math.PI / 2
     });
   }
-  sparkle(e, t, s = 20, i = "#ffd700") {
+  sparkle(t, e, s = 20, i = "#ffd700") {
     this.emit({
-      x: e,
-      y: t,
+      x: t,
+      y: e,
       count: s,
       color: i,
       speed: 3,
@@ -676,11 +855,11 @@ class T {
       size: 3
     });
   }
-  fire(e, t, s = 15) {
+  fire(t, e, s = 15) {
     const i = ["#ff6b00", "#ff8800", "#ffaa00", "#ff4400"];
     this.emit({
-      x: e,
-      y: t,
+      x: t,
+      y: e,
       count: s,
       color: i,
       speed: 3,
@@ -691,42 +870,50 @@ class T {
       spread: Math.PI / 4
     });
   }
-  starBurst(e, t, s = 8) {
-    for (let i = 0; i < s; i++) {
-      const r = this._getParticle(), n = Math.PI * 2 / s * i, o = 4;
-      r.x = e, r.y = t, r.vx = Math.cos(n) * o, r.vy = Math.sin(n) * o, r.life = 1, r.decay = 0.03, r.gravity = 0, r.color = "#ffffff", r.size = 15, r.sprite = null, r.type = "star", r.rotation = n, r.rotationSpeed = 0, this.particles.push(r);
+  starBurst(t, e, s = 8) {
+    const i = this._allowed(s);
+    for (let n = 0; n < i; n++) {
+      const a = this._getParticle(), o = Math.PI * 2 / i * n, l = 4;
+      a.x = t, a.y = e, a.vx = Math.cos(o) * l, a.vy = Math.sin(o) * l, a.life = 1, a.decay = 0.03, a.gravity = 0, a.color = "#ffffff", a.size = 15, a.sprite = null, a.type = "star", a.rotation = o, a.rotationSpeed = 0, this.particles.push(a);
     }
-    this._startAnimation();
+    i > 0 && this._startAnimation();
   }
   _startAnimation() {
-    this.isAnimating || (this.isAnimating = !0, this._animate());
+    this.isAnimating || (this.isAnimating = !0, this._lastFrameTime = null, this._animate());
   }
-  _animate() {
+  /**
+   * @param {number} [time] - requestAnimationFrame timestamp
+   */
+  _animate(t) {
     this._frameHandle = null, this.ctx.clearRect(0, 0, this.width, this.height);
-    for (let e = this.particles.length - 1; e >= 0; e--) {
-      const t = this.particles[e];
-      if (t.vy += t.gravity, t.x += t.vx, t.y += t.vy, t.life -= t.decay, t.rotationSpeed && (t.rotation += t.rotationSpeed), t.life <= 0) {
-        this._recycleParticle(t), this.particles.splice(e, 1);
+    let e = 1;
+    Number.isFinite(t) && (this._lastFrameTime !== null && (e = Math.max(0, Math.min(3, (t - this._lastFrameTime) / (1e3 / 60)))), this._lastFrameTime = t);
+    for (let s = this.particles.length - 1; s >= 0; s--) {
+      const i = this.particles[s];
+      if (i.vy += i.gravity * e, i.x += i.vx * e, i.y += i.vy * e, i.life -= i.decay * e, i.rotationSpeed && (i.rotation += i.rotationSpeed * e), i.life <= 0) {
+        this._recycleParticle(i);
+        const n = this.particles.pop();
+        s < this.particles.length && (this.particles[s] = n);
         continue;
       }
-      if (this.ctx.save(), this.ctx.globalAlpha = t.life, this.ctx.translate(t.x, t.y), this.ctx.rotate(t.rotation), t.sprite && this.sprites.has(t.sprite)) {
-        const s = this.sprites.get(t.sprite);
-        s.complete && this.ctx.drawImage(s, -t.size / 2, -t.size / 2, t.size, t.size);
-      } else t.type === "star" ? (this.ctx.fillStyle = t.color, this._drawStarPath(0, 0, 5, t.size, t.size / 2), this.ctx.fill()) : (this.ctx.fillStyle = t.color, this.ctx.beginPath(), this.ctx.arc(0, 0, t.size, 0, Math.PI * 2), this.ctx.fill());
+      if (this.ctx.save(), this.ctx.globalAlpha = i.life, this.ctx.translate(i.x, i.y), this.ctx.rotate(i.rotation), i.sprite && this.sprites.has(i.sprite)) {
+        const n = this.sprites.get(i.sprite);
+        n.complete && this.ctx.drawImage(n, -i.size / 2, -i.size / 2, i.size, i.size);
+      } else i.type === "star" ? (this.ctx.fillStyle = i.color, this._drawStarPath(0, 0, 5, i.size, i.size / 2), this.ctx.fill()) : (this.ctx.fillStyle = i.color, this.ctx.beginPath(), this.ctx.arc(0, 0, i.size, 0, Math.PI * 2), this.ctx.fill());
       this.ctx.restore();
     }
-    this.particles.length > 0 ? this._frameHandle = requestAnimationFrame(() => this._animate()) : this.isAnimating = !1;
+    this.particles.length > 0 ? this._frameHandle = requestAnimationFrame((s) => this._animate(s)) : this.isAnimating = !1;
   }
-  _drawStarPath(e, t, s, i, r) {
-    let n = Math.PI / 2 * 3, o = e, c = t;
+  _drawStarPath(t, e, s, i, n) {
+    let a = Math.PI / 2 * 3, o = t, l = e;
     const h = Math.PI / s;
-    this.ctx.beginPath(), this.ctx.moveTo(e, t - i);
-    for (let l = 0; l < s; l++)
-      o = e + Math.cos(n) * i, c = t + Math.sin(n) * i, this.ctx.lineTo(o, c), n += h, o = e + Math.cos(n) * r, c = t + Math.sin(n) * r, this.ctx.lineTo(o, c), n += h;
-    this.ctx.lineTo(e, t - i), this.ctx.closePath();
+    this.ctx.beginPath(), this.ctx.moveTo(t, e - i);
+    for (let d = 0; d < s; d++)
+      o = t + Math.cos(a) * i, l = e + Math.sin(a) * i, this.ctx.lineTo(o, l), a += h, o = t + Math.cos(a) * n, l = e + Math.sin(a) * n, this.ctx.lineTo(o, l), a += h;
+    this.ctx.lineTo(t, e - i), this.ctx.closePath();
   }
   clear() {
-    this.particles.forEach((e) => this._recycleParticle(e)), this.particles = [], this.ctx.clearRect(0, 0, this.width, this.height);
+    this.particles.forEach((t) => this._recycleParticle(t)), this.particles = [], this.ctx.clearRect(0, 0, this.width, this.height);
   }
   /**
    * Stop animating, detach resize handling, and remove the canvas.
@@ -738,18 +925,29 @@ class T {
     this.clear(), this.isAnimating = !1, this._frameHandle !== null && (cancelAnimationFrame(this._frameHandle), this._frameHandle = null), this._resizeObserver && (this._resizeObserver.disconnect(), this._resizeObserver = null), window.removeEventListener("resize", this._onResize), this.canvas.remove(), this.sprites.clear(), this.customEffects.clear(), this.pool = [];
   }
 }
-class I {
-  constructor(e = {}) {
-    this.audioContext = null, this.storageKey = e.storageKey || "dopamineSoundsMuted", this.storage = e.storage || S(), this.muted = this.storage.getItem(this.storageKey) === "true", this.assets = /* @__PURE__ */ new Map(), this.customSounds = e.customSounds || {}, this.masterGain = null, this._volume = e.volume ?? 1, Object.keys(this.customSounds).length > 0 && this.preloadSounds(this.customSounds);
+const k = (r, t) => Object.prototype.hasOwnProperty.call(r, t);
+class F {
+  constructor(t = {}) {
+    this.audioContext = null, this.storageKey = t.storageKey || "dopamineSoundsMuted", this.storage = t.storage || A(), this.muted = this.storage.getItem(this.storageKey) === "true", this.assets = /* @__PURE__ */ new Map(), this.customSounds = t.customSounds || {}, this.masterGain = null, this._volume = 1, this.setVolume(t.volume ?? 1), this._loading = /* @__PURE__ */ new Map(), this._timers = /* @__PURE__ */ new Set();
+  }
+  /**
+   * setTimeout that destroy() can cancel.
+   * @private
+   */
+  _later(t, e) {
+    const s = setTimeout(() => {
+      this._timers.delete(s), t();
+    }, e);
+    this._timers.add(s);
   }
   /**
    * Initialize Audio Context (must be called after user interaction)
    */
   initAudio() {
     if (!this.audioContext) {
-      const e = typeof window < "u" ? window.AudioContext || window.webkitAudioContext : void 0;
-      if (!e) return !1;
-      this.audioContext = new e(), this.masterGain = this.audioContext.createGain(), this.masterGain.gain.value = this._volume, this.masterGain.connect(this.audioContext.destination);
+      const t = typeof window < "u" ? window.AudioContext || window.webkitAudioContext : void 0;
+      if (!t) return !1;
+      this.audioContext = new t(), this.masterGain = this.audioContext.createGain(), this.masterGain.gain.value = this._volume, this.masterGain.connect(this.audioContext.destination), this.preloadSounds(this.customSounds);
     }
     return this.audioContext.state === "suspended" && this.audioContext.resume(), !0;
   }
@@ -757,8 +955,8 @@ class I {
    * Set master output volume.
    * @param {number} value - 0..1
    */
-  setVolume(e) {
-    return this._volume = Math.max(0, Math.min(1, e)), this.masterGain && (this.masterGain.gain.value = this._volume), this._volume;
+  setVolume(t) {
+    return Number.isFinite(t) ? (this._volume = Math.max(0, Math.min(1, t)), this.masterGain && (this.masterGain.gain.value = this._volume), this._volume) : this._volume;
   }
   /**
    * Current master output volume.
@@ -786,45 +984,60 @@ class I {
    * @param {string} key - Unique identifier (e.g., 'jump', 'win')
    * @param {string} url - Path to audio file
    */
-  registerSound(e, t) {
-    this.customSounds[e] = t, this.audioContext && this.loadSound(e, t);
+  registerSound(t, e) {
+    this.customSounds[t] = e, this.audioContext && this.loadSound(t, e);
   }
   /**
    * Preload multiple sounds
    * @param {Object} soundMap - { key: url }
    */
-  async preloadSounds(e) {
-    const t = Object.entries(e).map(([s, i]) => this.loadSound(s, i));
-    await Promise.allSettled(t);
+  async preloadSounds(t) {
+    const e = Object.entries(t).map(([s, i]) => this.loadSound(s, i));
+    await Promise.allSettled(e);
   }
   /**
    * Load and decode a sound file
    */
-  async loadSound(e, t) {
+  async loadSound(t, e) {
+    if (!this.audioContext) return;
+    if (this._loading.has(t))
+      return this._loading.get(t);
+    const s = this._load(t, e).finally(() => this._loading.delete(t));
+    return this._loading.set(t, s), s;
+  }
+  /**
+   * @private
+   */
+  async _load(t, e) {
     try {
-      if (!this.audioContext)
-        return;
-      const i = await (await fetch(t)).arrayBuffer(), r = await this.audioContext.decodeAudioData(i);
-      this.assets.set(e, r);
+      const s = this.audioContext, i = await fetch(e);
+      if (i.ok === !1)
+        throw new Error(`HTTP ${i.status}`);
+      const n = await i.arrayBuffer(), a = await s.decodeAudioData(n);
+      this.audioContext === s && this.assets.set(t, a);
     } catch (s) {
-      console.warn(`[DopamineJS] Failed to load sound '${e}':`, s);
+      console.warn(`[DopamineJS] Failed to load sound '${t}':`, s);
     }
   }
   /**
    * Play a sound by key (custom) or fallback to synth
    * @param {string} key - 'jump', 'score', 'success', etc.
    */
-  async play(e) {
+  async play(t) {
     if (this.muted || !this.initAudio()) return;
-    if (this.assets.has(e)) {
-      this._playBuffer(this.assets.get(e));
+    if (this.assets.has(t)) {
+      this._playBuffer(this.assets.get(t));
       return;
     }
-    if (this.customSounds[e] && !this.assets.has(e) && (await this.loadSound(e, this.customSounds[e]), this.assets.has(e))) {
-      this._playBuffer(this.assets.get(e));
-      return;
+    if (k(this.customSounds, t) && !this.assets.has(t)) {
+      const s = this.audioContext;
+      if (await this.loadSound(t, this.customSounds[t]), this.audioContext !== s) return;
+      if (this.assets.has(t)) {
+        this._playBuffer(this.assets.get(t));
+        return;
+      }
     }
-    const t = {
+    const e = {
       jump: () => this.playJump(!0),
       score: () => this.playScore(!0),
       success: () => this.playSuccess(!0),
@@ -832,793 +1045,128 @@ class I {
       error: () => this.playError(!0),
       gameover: () => this.playGameOver(!0)
     };
-    t[e] && t[e]();
+    k(e, t) && e[t]();
   }
-  _playBuffer(e) {
-    const t = this.audioContext.createBufferSource();
-    t.buffer = e, t.connect(this._output()), t.start(0);
+  _playBuffer(t) {
+    const e = this.audioContext.createBufferSource();
+    e.buffer = t, e.connect(this._output()), e.start(0);
   }
   /**
    * Play a synthesized tone
    */
-  playTone(e, t, s = "sine", i = 0.3) {
+  playTone(t, e, s = "sine", i = 0.3) {
     if (this.muted || !this.initAudio()) return;
-    const r = this.audioContext.createOscillator(), n = this.audioContext.createGain();
-    r.connect(n), n.connect(this._output()), r.frequency.value = e, r.type = s;
+    const n = this.audioContext.createOscillator(), a = this.audioContext.createGain();
+    n.connect(a), a.connect(this._output()), n.frequency.value = t, n.type = s;
     const o = Math.max(1e-4, i);
-    n.gain.setValueAtTime(o, this.audioContext.currentTime), n.gain.exponentialRampToValueAtTime(0.01, this.audioContext.currentTime + t), r.start(this.audioContext.currentTime), r.stop(this.audioContext.currentTime + t);
+    a.gain.setValueAtTime(o, this.audioContext.currentTime), a.gain.exponentialRampToValueAtTime(0.01, this.audioContext.currentTime + e), n.start(this.audioContext.currentTime), n.stop(this.audioContext.currentTime + e);
   }
   // --- Presets (Synth) ---
-  playJump(e = !1) {
-    if (!e && this.assets.has("jump")) return this.play("jump");
+  playJump(t = !1) {
+    if (!t && this.assets.has("jump")) return this.play("jump");
     this.playTone(400, 0.1, "square", 0.2);
   }
-  playScore(e = !1) {
-    if (!e && this.assets.has("score")) return this.play("score");
-    this.playTone(800, 0.15, "sine", 0.25), setTimeout(() => this.playTone(1e3, 0.15, "sine", 0.25), 50);
+  playScore(t = !1) {
+    if (!t && this.assets.has("score")) return this.play("score");
+    this.playTone(800, 0.15, "sine", 0.25), this._later(() => this.playTone(1e3, 0.15, "sine", 0.25), 50);
   }
-  playGameOver(e = !1) {
-    if (!e && this.assets.has("gameover")) return this.play("gameover");
-    this.playTone(300, 0.2, "sawtooth", 0.3), setTimeout(() => this.playTone(200, 0.2, "sawtooth", 0.3), 100), setTimeout(() => this.playTone(150, 0.3, "sawtooth", 0.3), 200);
+  playGameOver(t = !1) {
+    if (!t && this.assets.has("gameover")) return this.play("gameover");
+    this.playTone(300, 0.2, "sawtooth", 0.3), this._later(() => this.playTone(200, 0.2, "sawtooth", 0.3), 100), this._later(() => this.playTone(150, 0.3, "sawtooth", 0.3), 200);
   }
-  playClick(e = !1) {
-    if (!e && this.assets.has("click")) return this.play("click");
+  playClick(t = !1) {
+    if (!t && this.assets.has("click")) return this.play("click");
     this.playTone(600, 0.05, "sine", 0.1);
   }
-  playSuccess(e = !1) {
-    if (!e && this.assets.has("success")) return this.play("success");
-    this.playTone(600, 0.1, "sine", 0.2), setTimeout(() => this.playTone(800, 0.2, "sine", 0.2), 100);
+  playSuccess(t = !1) {
+    if (!t && this.assets.has("success")) return this.play("success");
+    this.playTone(600, 0.1, "sine", 0.2), this._later(() => this.playTone(800, 0.2, "sine", 0.2), 100);
   }
-  playError(e = !1) {
-    if (!e && this.assets.has("error")) return this.play("error");
+  playError(t = !1) {
+    if (!t && this.assets.has("error")) return this.play("error");
     this.playTone(200, 0.2, "sawtooth", 0.3);
   }
+  /**
+   * Cancel queued tones, close the audio context and drop decoded buffers.
+   * Browsers cap the number of live AudioContexts per page.
+   */
+  destroy() {
+    for (const t of this._timers)
+      clearTimeout(t);
+    this._timers.clear(), this.audioContext && this.audioContext.close?.()?.catch?.(() => {
+    }), this.audioContext = null, this.masterGain = null, this.assets.clear(), this._loading.clear();
+  }
 }
 class N {
-  constructor(e = {}) {
-    this.config = e, this.dataService = new A(e.data || {}), this.rewardSystem = new O(this.dataService, e.rewards || {}), this.soundManager = new I(e.sound || {}), this.particleSystem = new T(e.particles || {}), this.gameUI = new D(this.particleSystem), this._bindEvents();
+  constructor(t = {}) {
+    this.config = t, this.dataService = new I(t.data || {}), this.rewardSystem = new D(this.dataService, t.rewards || {}), this.soundManager = new F(t.sound || {}), this.particleSystem = new z(t.particles || {}), this.gameUI = new L(this.particleSystem), this._bindEvents();
   }
   async init() {
-    return await this.rewardSystem.init(), {
+    return await this.rewardSystem.init(), this._syncUI(), {
       rewardSystem: this.rewardSystem,
       gameUI: this.gameUI,
       particleSystem: this.particleSystem,
       soundManager: this.soundManager
     };
   }
-  _bindEvents() {
-    this.rewardSystem.on("xp_gained", (e) => {
-      const { total: t, needed: s } = this.rewardSystem.getXPForNextLevel();
-      this.gameUI.updateXP(this.rewardSystem.player.xp, s, t), e.xpGained > 0;
-    }), this.rewardSystem.on("level_up", (e) => {
-      this.gameUI.updateLevel(e.newLevel), this.gameUI.showLevelUp(e.oldLevel, e.newLevel);
-    }), this.rewardSystem.on("achievement_unlocked", (e) => {
-      this.gameUI.showAchievement(e);
-    }), this.rewardSystem.on("new_high_score", (e) => {
-      this.gameUI.showNotification(`New High Score: ${e.score}!`, "legendary"), this.soundManager.playSuccess();
-    });
-  }
-}
-class p {
-  constructor() {
-    this._listeners = /* @__PURE__ */ new Map(), this._onceListeners = /* @__PURE__ */ new Map(), this._sortedCache = /* @__PURE__ */ new Map();
-  }
-  /**
-   * Register an event listener
-   * @param {string} event - Event name
-   * @param {Function} callback - Callback function
-   * @param {number} priority - Higher priority = called first (default: 0)
-   * @returns {EventBus} - For chaining
-   */
-  on(e, t, s = 0) {
-    return this._listeners.has(e) || this._listeners.set(e, /* @__PURE__ */ new Set()), this._listeners.get(e).add({ callback: t, priority: s }), this._sortedCache.delete(e), this;
-  }
-  /**
-   * Register a one-time event listener
-   * @param {string} event - Event name
-   * @param {Function} callback - Callback function
-   * @returns {EventBus} - For chaining
-   */
-  once(e, t) {
-    return this._onceListeners.has(e) || this._onceListeners.set(e, /* @__PURE__ */ new Set()), this._onceListeners.get(e).add(t), this;
-  }
-  /**
-   * Remove an event listener
-   * @param {string} event - Event name
-   * @param {Function} callback - Callback function to remove
-   * @returns {EventBus} - For chaining
-   */
-  off(e, t) {
-    const s = this._listeners.get(e);
-    if (s)
-      for (const r of [...s])
-        r.callback === t && (s.delete(r), this._sortedCache.delete(e));
-    const i = this._onceListeners.get(e);
-    return i && i.delete(t), this;
-  }
-  /**
-   * Emit an event to all registered listeners
-   * @param {string} event - Event name
-   * @param {*} data - Event data
-   */
-  emit(e, t) {
-    const s = this._getSortedListeners(e);
-    for (let r = 0; r < s.length; r++)
-      this._invoke(s[r].callback, t, e);
-    const i = this._onceListeners.get(e);
-    if (i && i.size > 0) {
-      const r = [...i];
-      i.clear();
-      for (const n of r)
-        this._invoke(n, t, e);
-    }
-  }
-  /**
-   * Call one listener without letting it abort the dispatch.
-   *
-   * A throwing listener used to take out every lower-priority listener for
-   * that event, which on 'tick' means the game silently stops updating.
-   *
-   * @private
-   */
-  _invoke(e, t, s) {
-    try {
-      e(t);
-    } catch (i) {
-      console.error(`[DopamineJS] Listener for "${s}" threw:`, i);
-    }
-  }
   /**
-   * Get sorted listeners for an event (with caching)
+   * Draw the loaded player. Without this the overlay keeps its placeholder
+   * (level 1, 0 XP, streak 1) until the first event arrives.
    * @private
    */
-  _getSortedListeners(e) {
-    if (this._sortedCache.has(e))
-      return this._sortedCache.get(e);
-    const t = this._listeners.get(e);
-    if (!t || t.size === 0)
-      return [];
-    const s = Array.from(t).sort((i, r) => r.priority - i.priority);
-    return this._sortedCache.set(e, s), s;
-  }
-  /**
-   * Remove all listeners for an event, or all events if no event specified
-   * @param {string} [event] - Event name (optional)
-   */
-  clear(e) {
-    e ? (this._listeners.delete(e), this._onceListeners.delete(e), this._sortedCache.delete(e)) : (this._listeners.clear(), this._onceListeners.clear(), this._sortedCache.clear());
-  }
-  /**
-   * Check if an event has listeners
-   * @param {string} event - Event name
-   * @returns {boolean}
-   */
-  hasListeners(e) {
-    const t = this._listeners.get(e), s = this._onceListeners.get(e);
-    return !!(t != null && t.size) || !!(s != null && s.size);
-  }
-}
-p.Events = {
-  // Core game loop events
-  TICK: "tick",
-  FIXED_UPDATE: "fixed_update",
-  RENDER: "render",
-  // Physics events
-  COLLISION_ENTER: "collision_enter",
-  COLLISION_EXIT: "collision_exit",
-  // Dopamine events (from RewardSystem)
-  XP_GAINED: "xp_gained",
-  LEVEL_UP: "level_up",
-  ACHIEVEMENT_UNLOCKED: "achievement_unlocked",
-  NEW_HIGH_SCORE: "new_high_score",
-  STREAK_UPDATED: "streak_updated",
-  // System lifecycle events
-  SYSTEM_REGISTERED: "system_registered",
-  SYSTEM_UNREGISTERED: "system_unregistered",
-  PLUGIN_LOADED: "plugin_loaded",
-  PLUGIN_UNLOADED: "plugin_unloaded"
-};
-class L {
-  constructor(e) {
-    this.kernel = e, this._systems = /* @__PURE__ */ new Map(), this._updateOrder = [], this._fixedUpdateOrder = [], this._needsRecompute = !1;
-  }
-  /**
-   * Register a system
-   * @param {string} name - Unique system name
-   * @param {Object} system - System instance (must implement ISystem interface)
-   * @param {Object} options - Configuration options
-   * @param {number} options.priority - Update priority (higher = earlier, default: 0)
-   * @param {string[]} options.dependencies - System names this depends on
-   * @returns {SystemRegistry} - For chaining
-   */
-  register(e, t, { priority: s = 0, dependencies: i = [] } = {}) {
-    this._systems.has(e) && (console.warn(`[SystemRegistry] System "${e}" already registered. Replacing.`), this.unregister(e));
-    for (const r of i)
-      this._systems.has(r) || console.warn(`[SystemRegistry] Dependency "${r}" not found for system "${e}"`);
-    return this._systems.set(e, {
-      system: t,
-      priority: s,
-      dependencies: i
-    }), t.init && t.init(this.kernel), this._needsRecompute = !0, this.kernel.events.emit("system_registered", { name: e, system: t }), this;
-  }
-  /**
-   * Get a system by name
-   * @param {string} name - System name
-   * @returns {Object|undefined} - System instance
-   */
-  get(e) {
-    const t = this._systems.get(e);
-    return t ? t.system : void 0;
-  }
-  /**
-   * Check if a system is registered
-   * @param {string} name - System name
-   * @returns {boolean}
-   */
-  has(e) {
-    return this._systems.has(e);
+  _syncUI() {
+    const { player: t } = this.rewardSystem, { total: e, needed: s, progress: i } = this.rewardSystem.getXPForNextLevel();
+    this.gameUI.updateXP(t.xp, s, e, i), this.gameUI.updateLevel(t.level), this.gameUI.updateStreak(t.streak.current);
   }
-  /**
-   * Unregister a system
-   * @param {string} name - System name
-   * @returns {boolean} - True if system was found and removed
-   */
-  unregister(e) {
-    const t = this._systems.get(e);
-    return t ? (t.system.destroy && t.system.destroy(), this._systems.delete(e), this._needsRecompute = !0, this.kernel.events.emit("system_unregistered", { name: e }), !0) : !1;
-  }
-  /**
-   * Update all systems (called each frame)
-   * @param {number} dt - Delta time in seconds
-   */
-  update(e) {
-    this._needsRecompute && this._recomputeUpdateOrder();
-    for (let t = 0; t < this._updateOrder.length; t++) {
-      const s = this._updateOrder[t];
-      s.update && s.update(e);
-    }
-  }
-  /**
-   * Fixed update for physics (called at fixed timestep)
-   * @param {number} dt - Fixed delta time
-   */
-  fixedUpdate(e) {
-    this._needsRecompute && this._recomputeUpdateOrder();
-    for (let t = 0; t < this._fixedUpdateOrder.length; t++) {
-      const s = this._fixedUpdateOrder[t];
-      s.fixedUpdate && s.fixedUpdate(e);
-    }
-  }
-  /**
-   * Recompute the update order based on dependencies and priorities
-   * Uses topological sort for dependencies
-   * @private
-   */
-  _recomputeUpdateOrder() {
-    const e = Array.from(this._systems.entries()), t = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map();
-    for (const [n, o] of e)
-      t.set(n, o.dependencies), s.set(n, 0);
-    for (const [n, o] of t)
-      for (const c of o)
-        s.has(c) && s.set(n, s.get(n) + 1);
-    const i = [], r = [];
-    for (const [n, o] of s)
-      o === 0 && i.push(n);
-    for (; i.length > 0; ) {
-      i.sort((o, c) => {
-        const h = this._systems.get(o).priority;
-        return this._systems.get(c).priority - h;
-      });
-      const n = i.shift();
-      r.push(n);
-      for (const [o, c] of t)
-        if (c.includes(n)) {
-          const h = s.get(o) - 1;
-          s.set(o, h), h === 0 && i.push(o);
-        }
-    }
-    r.length !== e.length && (console.error("[SystemRegistry] Circular dependency detected in systems!"), r.length = 0, r.push(...e.map(([n]) => n).sort((n, o) => this._systems.get(o).priority - this._systems.get(n).priority))), this._updateOrder = r.map((n) => this._systems.get(n).system).filter((n) => n.update), this._fixedUpdateOrder = r.map((n) => this._systems.get(n).system).filter((n) => n.fixedUpdate), this._needsRecompute = !1;
-  }
-  /**
-   * Get all registered system names
-   * @returns {string[]}
-   */
-  getSystemNames() {
-    return Array.from(this._systems.keys());
-  }
-  /**
-   * Clear all systems
-   */
-  clear() {
-    for (const e of this._systems.keys())
-      this.unregister(e);
-  }
-}
-class U {
-  constructor(e) {
-    this.kernel = e, this._plugins = /* @__PURE__ */ new Map(), this._loadOrder = [];
-  }
-  /**
-   * Register and initialize a plugin
-   * 
-   * Plugin interface:
-   * {
-   *   name: string,
-   *   version?: string,
-   *   init(kernel): void,
-   *   destroy?(): void
-   * }
-   * 
-   * @param {Object} plugin - Plugin instance
-   * @returns {PluginRegistry} - For chaining
-   */
-  use(e) {
-    if (!e.name)
-      throw new Error("[PluginRegistry] Plugin must have a name");
-    if (this._plugins.has(e.name))
-      return console.warn(`[PluginRegistry] Plugin "${e.name}" already registered. Skipping.`), this;
-    if (!e.init || typeof e.init != "function")
-      throw new Error(`[PluginRegistry] Plugin "${e.name}" must have an init() method`);
-    this._plugins.set(e.name, e), this._loadOrder.push(e.name);
-    try {
-      e.init(this.kernel), this.kernel.events.emit("plugin_loaded", {
-        name: e.name,
-        version: e.version
-      });
-    } catch (t) {
-      throw console.error(`[PluginRegistry] Failed to initialize plugin "${e.name}":`, t), this._plugins.delete(e.name), this._loadOrder.pop(), t;
-    }
-    return this;
-  }
-  /**
-   * Register and initialize a plugin asynchronously
-   * Useful for plugins that need to load external resources
-   * 
-   * @param {Object} plugin - Plugin instance with async init
-   * @returns {Promise<PluginRegistry>} - For chaining
-   */
-  async useAsync(e) {
-    if (!e.name)
-      throw new Error("[PluginRegistry] Plugin must have a name");
-    if (this._plugins.has(e.name))
-      return console.warn(`[PluginRegistry] Plugin "${e.name}" already registered. Skipping.`), this;
-    if (!e.init || typeof e.init != "function")
-      throw new Error(`[PluginRegistry] Plugin "${e.name}" must have an init() method`);
-    this._plugins.set(e.name, e), this._loadOrder.push(e.name);
-    try {
-      await e.init(this.kernel), this.kernel.events.emit("plugin_loaded", {
-        name: e.name,
-        version: e.version
-      });
-    } catch (t) {
-      throw console.error(`[PluginRegistry] Failed to initialize plugin "${e.name}":`, t), this._plugins.delete(e.name), this._loadOrder.pop(), t;
-    }
-    return this;
-  }
-  /**
-   * Remove a plugin
-   * @param {string} name - Plugin name
-   * @returns {boolean} - True if plugin was found and removed
-   */
-  remove(e) {
-    const t = this._plugins.get(e);
-    if (!t)
-      return !1;
-    if (t.destroy)
-      try {
-        t.destroy();
-      } catch (i) {
-        console.error(`[PluginRegistry] Error destroying plugin "${e}":`, i);
-      }
-    this._plugins.delete(e);
-    const s = this._loadOrder.indexOf(e);
-    return s > -1 && this._loadOrder.splice(s, 1), this.kernel.events.emit("plugin_unloaded", { name: e }), !0;
-  }
-  /**
-   * Get a plugin by name
-   * @param {string} name - Plugin name
-   * @returns {Object|undefined} - Plugin instance
-   */
-  get(e) {
-    return this._plugins.get(e);
-  }
-  /**
-   * Check if a plugin is registered
-   * @param {string} name - Plugin name
-   * @returns {boolean}
-   */
-  has(e) {
-    return this._plugins.has(e);
-  }
-  /**
-   * Get all registered plugin names
-   * @returns {string[]}
-   */
-  getPluginNames() {
-    return Array.from(this._plugins.keys());
-  }
-  /**
-   * Get plugin load order
-   * @returns {string[]}
-   */
-  getLoadOrder() {
-    return [...this._loadOrder];
-  }
-  /**
-   * Clear all plugins (in reverse load order)
-   */
-  clear() {
-    for (let e = this._loadOrder.length - 1; e >= 0; e--)
-      this.remove(this._loadOrder[e]);
-  }
-}
-class R {
-  constructor(e = {}) {
-    this.width = e.width || 800, this.height = e.height || 600, this.backgroundColor = e.backgroundColor || "#000000", e.canvas ? (this.canvas = e.canvas, this.canvas.width = this.width, this.canvas.height = this.height) : (this.canvas = document.createElement("canvas"), this.canvas.width = this.width, this.canvas.height = this.height, (e.parent ? typeof e.parent == "string" ? document.querySelector(e.parent) : e.parent : document.body).appendChild(this.canvas)), this.ctx = this.canvas.getContext("2d");
-  }
-  /**
-   * Clear the canvas.
-   */
-  clear() {
-    this.ctx.fillStyle = this.backgroundColor, this.ctx.fillRect(0, 0, this.width, this.height);
-  }
-  resize(e, t) {
-    this.width = e, this.height = t, this.canvas.width = e, this.canvas.height = t;
-  }
-}
-class z {
-  constructor() {
-    this.running = !1, this.lastTime = 0, this.callbacks = /* @__PURE__ */ new Set(), this._frameHandle = null, this._tick = this._tick.bind(this);
-  }
-  /**
-   * Add a callback to the loop.
-   * @param {Function} callback - Function to call each frame (receives dt).
-   */
-  add(e) {
-    this.callbacks.add(e);
-  }
-  /**
-   * Remove a callback from the loop.
-   * @param {Function} callback 
-   */
-  remove(e) {
-    this.callbacks.delete(e);
-  }
-  /**
-   * Start the loop.
-   */
-  start() {
-    this.running || (this.running = !0, this.lastTime = performance.now(), this._frameHandle !== null && cancelAnimationFrame(this._frameHandle), this._frameHandle = requestAnimationFrame(this._tick));
-  }
-  /**
-   * Stop the loop.
-   */
-  stop() {
-    this.running = !1, this._frameHandle !== null && (cancelAnimationFrame(this._frameHandle), this._frameHandle = null);
-  }
-  _tick(e) {
-    if (this._frameHandle = null, !this.running) return;
-    const t = (e - this.lastTime) / 1e3;
-    this.lastTime = e;
-    const s = Math.min(t, 0.1);
-    for (const i of [...this.callbacks])
-      i(s);
-    this.running && (this._frameHandle = requestAnimationFrame(this._tick));
-  }
-}
-class y {
-  constructor() {
-    this.gameObject = null, this.kernel = null;
-  }
-  /**
-   * Access systems through kernel (no more globals!)
-   */
-  get physics() {
-    var e;
-    return (e = this.kernel) == null ? void 0 : e.systems.get("physics");
-  }
-  get input() {
-    var e;
-    return (e = this.kernel) == null ? void 0 : e.systems.get("input");
-  }
-  get loader() {
-    var e;
-    return (e = this.kernel) == null ? void 0 : e.systems.get("loader");
-  }
-  get events() {
-    var e;
-    return (e = this.kernel) == null ? void 0 : e.events;
-  }
-  onAttach() {
-  }
-  onDetach() {
-  }
-  update(e) {
-  }
-  render(e) {
-  }
-}
-class H extends y {
-  constructor(e = "box", t = 50, s = 50, i = 25) {
-    super(), this.type = e, this.width = t, this.height = s, this.radius = i, this.tag = null;
-  }
-  onAttach() {
-    super.onAttach(), this.physics && this.physics.add(this);
-  }
-  onDetach() {
-    super.onDetach(), this.physics && this.physics.remove(this);
-  }
-  getBounds() {
-    const e = this.gameObject;
-    if (this.type === "box")
-      return {
-        left: e.x - this.width / 2,
-        right: e.x + this.width / 2,
-        top: e.y - this.height / 2,
-        bottom: e.y + this.height / 2
-      };
-    if (this.type === "circle")
-      return {
-        x: e.x,
-        y: e.y,
-        radius: this.radius
-      };
-  }
-}
-class b {
-  constructor() {
-    this.colliders = [], this.kernel = null;
-  }
-  /**
-   * ISystem interface - called when registered
-   */
-  init(e) {
-    this.kernel = e;
-  }
-  /**
-   * ISystem interface - called at fixed timestep
-   */
-  fixedUpdate(e) {
-    this.step();
-  }
-  /**
-   * ISystem interface - cleanup
-   */
-  destroy() {
-    this.colliders = [];
-  }
-  add(e) {
-    this.colliders.push(e);
-  }
-  remove(e) {
-    const t = this.colliders.indexOf(e);
-    t > -1 && this.colliders.splice(t, 1);
-  }
-  /**
-   * Main Physics Step.
-   * Checks all pairs and triggers callbacks.
-   */
-  step() {
-    for (let e = 0; e < this.colliders.length; e++)
-      for (let t = e + 1; t < this.colliders.length; t++) {
-        const s = this.colliders[e], i = this.colliders[t];
-        this._intersects(s, s.getBounds(), i, i.getBounds()) && (this._notifyCollision(s.gameObject, i.gameObject), this._notifyCollision(i.gameObject, s.gameObject));
-      }
-  }
-  _notifyCollision(e, t) {
-    !e || !e.components || e.components.forEach((s) => {
-      s.onCollisionEnter && s.onCollisionEnter(t);
-    });
-  }
-  /**
-   * Check if a specific collider overlaps with anything in the target group (tag).
-   * @param {Collider} source 
-   * @param {string} targetTag 
-   */
-  checkOverlap(e, t) {
-    const s = [], i = e.getBounds();
-    for (const r of this.colliders) {
-      if (r === e || t && r.tag !== t) continue;
-      const n = r.getBounds();
-      this._intersects(e, i, r, n) && s.push(r);
-    }
-    return s;
-  }
-  _intersects(e, t, s, i) {
-    if (e.type === "box" && s.type === "box")
-      return t.left < i.right && t.right > i.left && t.top < i.bottom && t.bottom > i.top;
-    if (e.type === "circle" && s.type === "circle") {
-      const r = t.x - i.x, n = t.y - i.y;
-      return Math.sqrt(r * r + n * n) < t.radius + i.radius;
-    }
-    return !1;
-  }
-  // IPhysicsSystem interface methods (for plugin compatibility)
-  addBody(e) {
-    this.add(e);
-  }
-  removeBody(e) {
-    this.remove(e);
-  }
-  checkCollision(e, t) {
-    return this._intersects(e, e.getBounds(), t, t.getBounds());
-  }
-  raycast(e, t, s) {
-    return null;
-  }
-  setGravity(e, t) {
-  }
-}
-const $ = new b();
-console.warn("[DopamineJS] GlobalPhysics is deprecated. Use kernel.physics instead.");
-class M {
-  constructor() {
-    this.keys = /* @__PURE__ */ new Map(), this.mouse = { x: 0, y: 0, buttons: /* @__PURE__ */ new Map() }, this.kernel = null, this._onKeyDown = this._onKeyDown.bind(this), this._onKeyUp = this._onKeyUp.bind(this), this._onMouseMove = this._onMouseMove.bind(this), this._onMouseDown = this._onMouseDown.bind(this), this._onMouseUp = this._onMouseUp.bind(this);
-  }
-  /**
-   * ISystem interface - called when registered
-   */
-  init(e) {
-    this.kernel = e, window.addEventListener("keydown", this._onKeyDown), window.addEventListener("keyup", this._onKeyUp), window.addEventListener("mousemove", this._onMouseMove), window.addEventListener("mousedown", this._onMouseDown), window.addEventListener("mouseup", this._onMouseUp);
-  }
-  /**
-   * ISystem interface - cleanup
-   */
-  destroy() {
-    window.removeEventListener("keydown", this._onKeyDown), window.removeEventListener("keyup", this._onKeyUp), window.removeEventListener("mousemove", this._onMouseMove), window.removeEventListener("mousedown", this._onMouseDown), window.removeEventListener("mouseup", this._onMouseUp);
-  }
-  _onKeyDown(e) {
-    this.keys.set(e.key, !0);
-  }
-  _onKeyUp(e) {
-    this.keys.set(e.key, !1);
-  }
-  _onMouseMove(e) {
-    this.mouse.x = e.clientX, this.mouse.y = e.clientY;
-  }
-  _onMouseDown(e) {
-    this.mouse.buttons.set(e.button, !0);
-  }
-  _onMouseUp(e) {
-    this.mouse.buttons.set(e.button, !1);
-  }
-  isKeyDown(e) {
-    return this.keys.get(e) || !1;
-  }
-  isMouseButtonDown(e = 0) {
-    return this.mouse.buttons.get(e) || !1;
-  }
-}
-const q = new M();
-console.warn("[DopamineJS] GlobalInput is deprecated. Use kernel.input instead.");
-class E {
-  constructor() {
-    this.assets = /* @__PURE__ */ new Map(), this.kernel = null;
-  }
-  /**
-   * ISystem interface - called when registered
-   */
-  init(e) {
-    this.kernel = e;
-  }
-  /**
-   * ISystem interface - cleanup
-   */
-  destroy() {
-    this.assets.clear();
-  }
-  async loadImage(e, t) {
-    return new Promise((s, i) => {
-      const r = new Image();
-      r.onload = () => {
-        this.assets.set(e, r), s(r);
-      }, r.onerror = i, r.src = t;
-    });
-  }
-  get(e) {
-    return this.assets.get(e);
-  }
-}
-const K = new E();
-console.warn("[DopamineJS] GlobalLoader is deprecated. Use kernel.loader instead.");
-class B {
-  constructor(e = {}) {
-    this.config = e, this._boundUpdate = this._update.bind(this), this.events = new p(), this.systems = new L(this), this.plugins = new U(this), this._registerCoreSystems(e), this.fixedTimestep = e.fixedTimestep || 1 / 60, this._accumulator = 0, this._maxAccumulator = this.fixedTimestep * 5;
-  }
-  /**
-   * Register core engine systems
-   * These can be replaced by plugins
-   * @private
-   */
-  _registerCoreSystems(e) {
-    this.systems.register("ticker", new z(), {
-      priority: 100
-    });
-    const t = {
-      width: e.width,
-      height: e.height,
-      backgroundColor: e.backgroundColor,
-      canvas: e.canvas,
-      ...e.renderer
-    };
-    this.systems.register("renderer", new R(t), {
-      priority: 90
-    }), this.systems.register("input", new M(), {
-      priority: 80
-    }), this.systems.register("loader", new E(), {
-      priority: 70
-    }), this.systems.register("physics", new b(), {
-      priority: 60
-    });
-  }
-  /**
-   * Start the kernel (begins game loop)
-   */
-  start() {
-    const e = this.systems.get("ticker");
-    e && (e.add(this._boundUpdate), e.start()), this.events.emit("kernel_started");
-  }
-  /**
-   * Stop the kernel
-   */
-  stop() {
-    const e = this.systems.get("ticker");
-    e && e.stop(), this.events.emit("kernel_stopped");
-  }
-  /**
-   * Main update loop
-   * @private
-   */
-  _update(e) {
-    for (this.events.emit(p.Events.TICK, { dt: e }), this._accumulator += e, this._accumulator > this._maxAccumulator && (this._accumulator = this._maxAccumulator); this._accumulator >= this.fixedTimestep; )
-      this.events.emit(p.Events.FIXED_UPDATE, { dt: this.fixedTimestep }), this.systems.fixedUpdate(this.fixedTimestep), this._accumulator -= this.fixedTimestep;
-    this.systems.update(e), this.events.emit(p.Events.RENDER, { dt: e });
-  }
-  /**
-   * Shorthand accessors for common systems (backward compatibility)
-   */
-  get physics() {
-    return this.systems.get("physics");
-  }
-  get input() {
-    return this.systems.get("input");
-  }
-  get loader() {
-    return this.systems.get("loader");
-  }
-  get renderer() {
-    return this.systems.get("renderer");
-  }
-  get ticker() {
-    return this.systems.get("ticker");
-  }
-  /**
-   * Destroy the kernel and cleanup all systems
+  _bindEvents() {
+    const t = this.rewardSystem;
+    this._unsubscribe = [
+      t.on("xp_gained", () => {
+        const { total: e, needed: s, progress: i } = t.getXPForNextLevel();
+        this.gameUI.updateXP(t.player.xp, s, e, i);
+      }),
+      t.on("level_up", (e) => {
+        this.gameUI.updateLevel(e.newLevel), this.gameUI.showLevelUp(e.oldLevel, e.newLevel);
+      }),
+      t.on("achievement_unlocked", (e) => {
+        this.gameUI.showAchievement(e);
+      }),
+      t.on("streak_updated", (e) => {
+        this.gameUI.updateStreak(e.current);
+      }),
+      t.on("new_high_score", (e) => {
+        this.gameUI.showNotification(`New High Score: ${e.score}!`, "legendary"), this.soundManager.playSuccess();
+      })
+    ];
+  }
+  /**
+   * Remove the overlay and canvas, stop audio, and detach from the reward
+   * system. The reward system itself stays usable.
    */
   destroy() {
-    this.stop();
-    const e = this.systems.get("ticker");
-    e && e.remove(this._boundUpdate), this.plugins.clear(), this.systems.clear(), this.events.clear();
+    for (const t of this._unsubscribe)
+      t();
+    this._unsubscribe = [], this.gameUI.destroy(), this.particleSystem.destroy(), this.soundManager.destroy();
   }
 }
-const g = {
+const _ = {
   /**
    * Called when system is registered to the kernel
    * @param {DopamineKernel} kernel - The kernel instance
    */
-  init(a) {
+  init(r) {
   },
   /**
    * Called each frame (variable timestep)
    * @param {number} dt - Delta time in seconds
    */
-  update(a) {
+  update(r) {
   },
   /**
    * Called at fixed timestep (for physics)
    * @param {number} dt - Fixed delta time
    */
-  fixedUpdate(a) {
+  fixedUpdate(r) {
   },
   /**
    * Called when system is unregistered
@@ -1626,33 +1174,33 @@ const g = {
   destroy() {
   }
 };
-class X {
+class G {
   constructor() {
     this.kernel = null;
   }
-  init(e) {
-    this.kernel = e;
+  init(t) {
+    this.kernel = t;
   }
-  update(e) {
+  update(t) {
   }
-  fixedUpdate(e) {
+  fixedUpdate(t) {
   }
   destroy() {
   }
 }
-const J = {
-  ...g,
+const R = {
+  ..._,
   /**
    * Add a physics body to the simulation
    * @param {Object} body - Physics body (implementation-specific)
    */
-  addBody(a) {
+  addBody(r) {
   },
   /**
    * Remove a physics body from the simulation
    * @param {Object} body - Physics body to remove
    */
-  removeBody(a) {
+  removeBody(r) {
   },
   /**
    * Check collision between two bodies
@@ -1660,7 +1208,7 @@ const J = {
    * @param {Object} b - Second body
    * @returns {boolean} - True if colliding
    */
-  checkCollision(a, e) {
+  checkCollision(r, t) {
   },
   /**
    * Perform a raycast
@@ -1669,43 +1217,43 @@ const J = {
    * @param {number} distance - Maximum ray distance
    * @returns {Object|null} - Hit result or null
    */
-  raycast(a, e, t) {
+  raycast(r, t, e) {
   },
   /**
    * Set gravity for the physics world
    * @param {number} x - Gravity X component
    * @param {number} y - Gravity Y component
    */
-  setGravity(a, e) {
+  setGravity(r, t) {
   },
   /**
    * Step the physics simulation
    * @param {number} dt - Delta time
    */
-  step(a) {
+  step(r) {
   }
-}, W = {
-  ...g,
+}, B = {
+  ..._,
   /**
    * Register a sound with a key
    * @param {string} key - Sound identifier
    * @param {string} url - Path to audio file
    */
-  registerSound(a, e) {
+  registerSound(r, t) {
   },
   /**
    * Preload multiple sounds
    * @param {Object} soundMap - Map of key -> url
    * @returns {Promise<void>}
    */
-  preloadSounds(a) {
+  preloadSounds(r) {
   },
   /**
    * Play a sound by key
    * @param {string} key - Sound identifier
    * @param {Object} options - Playback options (volume, loop, etc.)
    */
-  play(a, e) {
+  play(r, t) {
   },
   /**
    * Play a synthesized tone
@@ -1714,13 +1262,13 @@ const J = {
    * @param {string} type - Waveform type ('sine', 'square', etc.)
    * @param {number} volume - Volume (0-1)
    */
-  playTone(a, e, t, s) {
+  playTone(r, t, e, s) {
   },
   /**
    * Stop a playing sound
    * @param {string} key - Sound identifier
    */
-  stop(a) {
+  stop(r) {
   },
   /**
    * Toggle mute state
@@ -1732,23 +1280,23 @@ const J = {
    * Set master volume
    * @param {number} volume - Volume (0-1)
    */
-  setVolume(a) {
+  setVolume(r) {
   }
-}, Y = {
-  ...g,
+}, U = {
+  ..._,
   /**
    * Register a sprite for particles
    * @param {string} key - Sprite identifier
    * @param {string} url - Path to image
    */
-  registerSprite(a, e) {
+  registerSprite(r, t) {
   },
   /**
    * Register a custom effect
    * @param {string} name - Effect name
    * @param {Function} callback - Effect function (x, y, ...args) => void
    */
-  registerEffect(a, e) {
+  registerEffect(r, t) {
   },
   /**
    * Play a registered effect
@@ -1757,13 +1305,13 @@ const J = {
    * @param {number} y - Y position
    * @param {...any} args - Additional arguments
    */
-  play(a, e, t, ...s) {
+  play(r, t, e, ...s) {
   },
   /**
    * Emit particles with custom configuration
    * @param {Object} config - Particle configuration
    */
-  emit(a) {
+  emit(r) {
   },
   /**
    * Clear all particles
@@ -1771,380 +1319,86 @@ const J = {
   clear() {
   },
   // Built-in effects (optional, but recommended)
-  confetti(a, e, t) {
+  confetti(r, t, e) {
   },
-  coinShower(a, e, t) {
+  coinShower(r, t, e) {
   },
-  sparkle(a, e, t, s) {
+  sparkle(r, t, e, s) {
   },
-  fire(a, e, t) {
+  fire(r, t, e) {
   },
-  starBurst(a, e, t) {
+  starBurst(r, t, e) {
   }
 };
-class V {
-  constructor() {
-    this.gameObjects = [], this.kernel = null;
-  }
-  /**
-   * Called when the scene is added to the Game.
-   */
-  onEnter() {
-  }
-  /**
-   * Called when the scene is removed from the Game.
-   */
-  onExit() {
-  }
-  /**
-   * Add a GameObject to the scene.
-   * @param {GameObject} gameObject 
-   */
-  add(e) {
-    return this.kernel && (e.kernel = this.kernel), this.gameObjects.push(e), e;
-  }
-  /**
-   * Remove a GameObject from the scene.
-   * @param {GameObject} gameObject 
-   */
-  remove(e) {
-    const t = this.gameObjects.indexOf(e);
-    t > -1 && this.gameObjects.splice(t, 1);
-  }
-  /**
-   * Update loop for the scene.
-   * @param {number} dt 
-   */
-  update(e) {
-    for (const t of this.gameObjects)
-      t.update(e);
-  }
-  /**
-   * Render loop for the scene.
-   * @param {CanvasRenderingContext2D} ctx 
-   */
-  render(e) {
-    for (const t of this.gameObjects)
-      t.render(e);
-  }
-}
-class G {
-  constructor(e) {
-    this.game = e, this.currentScene = null;
-  }
-  /**
-   * Switch to a new scene.
-   * @param {Scene} scene 
-   */
-  run(e) {
-    this.currentScene && this.currentScene.onExit(), this.currentScene = e, this.currentScene.game = this.game, this.game.scene = e, e.onEnter();
-  }
-}
-class Q {
-  constructor(e = {}) {
-    this.config = e, this.kernel = new B(e), this.director = new G(this), this.kernel.systems.register("director", this.director), this.kernel.events.on(p.Events.TICK, this._update.bind(this), 10), this.kernel.events.on(p.Events.RENDER, this._render.bind(this), 10);
-  }
-  /**
-   * Backward compatibility accessors
-   */
-  get renderer() {
-    return this.kernel.renderer;
-  }
-  get ticker() {
-    return this.kernel.ticker;
-  }
-  get physics() {
-    return this.kernel.physics;
-  }
-  get input() {
-    return this.kernel.input;
-  }
-  /**
-   * Start the game loop.
-   */
-  start() {
-    this.kernel.start();
-  }
-  /**
-   * Stop the game loop.
-   */
-  stop() {
-    this.kernel.stop();
-  }
-  /**
-   * Switch to a new scene.
-   * @param {Scene} newScene 
-   */
-  setScene(e) {
-    e.kernel = this.kernel, this.director.run(e);
-  }
-  _update({ dt: e }) {
-    this.director.currentScene && this.director.currentScene.update(e);
-  }
-  _render({ dt: e }) {
-    this.renderer.clear(), this.director.currentScene && this.director.currentScene.render(this.renderer.ctx);
-  }
-  /**
-   * Destroy the game and cleanup
-   */
-  destroy() {
-    this.kernel.destroy();
-  }
-}
-class Z {
-  constructor(e = 0, t = 0) {
-    this.x = e, this.y = t, this.rotation = 0, this.scale = { x: 1, y: 1 }, this.components = [], this.children = [], this.parent = null, this._kernel = null;
-  }
-  get kernel() {
-    return this._kernel;
-  }
-  set kernel(e) {
-    this._kernel = e;
-    for (const t of this.components)
-      t.kernel = e;
-    for (const t of this.children)
-      t.kernel = e;
-  }
-  /**
-   * Add a child object.
-   * @param {GameObject} child 
-   */
-  addChild(e) {
-    return e.parent = this, e.kernel = this.kernel, this.children.push(e), e;
-  }
-  /**
-   * Add a component.
-   * @param {Component} component 
-   */
-  addComponent(e) {
-    return e.gameObject = this, e.kernel = this.kernel, this.components.push(e), e.onAttach(), e;
-  }
-  /**
-   * Get a component by class type.
-   * @param {class} type 
-   */
-  getComponent(e) {
-    return this.components.find((t) => t instanceof e);
-  }
-  update(e) {
-    for (const t of this.components)
-      t.update && t.update(e);
-    for (const t of this.children)
-      t.update(e);
-  }
-  render(e) {
-    e.save(), e.translate(this.x, this.y), e.rotate(this.rotation), e.scale(this.scale.x, this.scale.y);
-    for (const t of this.components)
-      t.render && t.render(e);
-    for (const t of this.children)
-      t.render(e);
-    e.restore();
-  }
-}
-class P {
-  constructor(e = 0, t = 0) {
-    this.x = e, this.y = t;
-  }
-  add(e) {
-    return this.x += e.x, this.y += e.y, this;
-  }
-  sub(e) {
-    return this.x -= e.x, this.y -= e.y, this;
-  }
-  scale(e) {
-    return this.x *= e, this.y *= e, this;
-  }
-  distance(e) {
-    const t = this.x - e.x, s = this.y - e.y;
-    return Math.sqrt(t * t + s * s);
-  }
-  normalize() {
-    const e = Math.sqrt(this.x * this.x + this.y * this.y);
-    return e > 0 && (this.x /= e, this.y /= e), this;
-  }
-  clone() {
-    return new P(this.x, this.y);
-  }
-  static distance(e, t) {
-    return Math.sqrt(Math.pow(t.x - e.x, 2) + Math.pow(t.y - e.y, 2));
-  }
-}
-class j extends y {
-  constructor(e) {
-    super(), this.image = e, this.anchor = { x: 0.5, y: 0.5 }, this.width = e ? e.width : 0, this.height = e ? e.height : 0, this.frame = { x: 0, y: 0, w: this.width, h: this.height };
-  }
-  setFrame(e, t, s, i) {
-    this.frame = { x: e, y: t, w: s, h: i }, this.width = s, this.height = i;
-  }
-  setTexture(e) {
-    this.image = e, e && this.setFrame(0, 0, e.width, e.height);
-  }
-  render(e) {
-    if (!this.image) return;
-    const t = this.frame.w, s = this.frame.h, i = -t * this.anchor.x, r = -s * this.anchor.y;
-    e.drawImage(
-      this.image,
-      this.frame.x,
-      this.frame.y,
-      t,
-      s,
-      // Source
-      i,
-      r,
-      t,
-      s
-      // Destination
-    );
-  }
-}
-class ee extends y {
-  constructor() {
-    super(), this.animations = {}, this.currentAnim = null, this.timer = 0, this.currentFrameIndex = 0, this.sprite = null;
-  }
-  onAttach() {
-    this.sprite = this.gameObject.getComponent(j), this.sprite || console.warn("Animator attached to GameObject without a Sprite component.");
-  }
-  addAnimation(e, t, s = 10, i = !0) {
-    this.animations[e] = { frames: t, fps: s, loop: i };
-  }
-  play(e) {
-    this.currentAnim && this.currentAnim.name === e || this.animations[e] && (this.currentAnim = { name: e, ...this.animations[e] }, this.currentFrameIndex = 0, this.timer = 0, this._updateFrame());
-  }
-  update(e) {
-    if (!this.currentAnim || !this.sprite) return;
-    this.timer += e;
-    const t = 1 / this.currentAnim.fps;
-    this.timer >= t && (this.timer -= t, this.currentFrameIndex++, this.currentFrameIndex >= this.currentAnim.frames.length && (this.currentAnim.loop ? this.currentFrameIndex = 0 : this.currentFrameIndex = this.currentAnim.frames.length - 1), this._updateFrame());
-  }
-  _updateFrame() {
-    const e = this.currentAnim.frames[this.currentFrameIndex];
-    this.sprite.setFrame(e.x, e.y, e.w, e.h);
-  }
-}
-class te {
-  static createGround(e, t, s = "#333") {
+class $ {
+  static createGround(t, e, s = "#333") {
     const i = document.createElement("canvas");
-    i.width = e, i.height = t;
-    const r = i.getContext("2d");
-    r.fillStyle = s, r.fillRect(0, 0, e, t);
-    for (let n = 0; n < 1e3; n++) {
-      r.fillStyle = Math.random() > 0.5 ? "#444" : "#222";
+    i.width = t, i.height = e;
+    const n = i.getContext("2d");
+    n.fillStyle = s, n.fillRect(0, 0, t, e);
+    for (let a = 0; a < 1e3; a++) {
+      n.fillStyle = Math.random() > 0.5 ? "#444" : "#222";
       const o = Math.random() * 4 + 2;
-      r.fillRect(Math.random() * e, Math.random() * t, o, o);
+      n.fillRect(Math.random() * t, Math.random() * e, o, o);
     }
-    r.strokeStyle = "rgba(255,255,255,0.05)", r.lineWidth = 2, r.beginPath();
-    for (let n = 0; n <= e; n += 64)
-      r.moveTo(n, 0), r.lineTo(n, t);
-    for (let n = 0; n <= t; n += 64)
-      r.moveTo(0, n), r.lineTo(e, n);
-    return r.stroke(), i;
-  }
-  static createCharacterSheet(e, t) {
-    const r = document.createElement("canvas");
-    r.width = 64 * 4, r.height = 64;
-    const n = r.getContext("2d");
+    n.strokeStyle = "rgba(255,255,255,0.05)", n.lineWidth = 2, n.beginPath();
+    for (let a = 0; a <= t; a += 64)
+      n.moveTo(a, 0), n.lineTo(a, e);
+    for (let a = 0; a <= e; a += 64)
+      n.moveTo(0, a), n.lineTo(t, a);
+    return n.stroke(), i;
+  }
+  static createCharacterSheet(t, e) {
+    const n = document.createElement("canvas");
+    n.width = 256, n.height = 64;
+    const a = n.getContext("2d");
     for (let o = 0; o < 4; o++) {
-      const c = o * 64, h = 0, l = c + 64 / 2, u = h + 64 / 2, m = o % 2 === 0 ? 0 : -2, f = o === 1 ? 5 : o === 3 ? -5 : 0;
-      n.fillStyle = e, n.beginPath(), n.arc(l, u + m, 20, 0, Math.PI * 2), n.fill(), n.fillStyle = t, n.beginPath(), n.arc(l - 15, u + m + f, 8, 0, Math.PI * 2), n.arc(l + 15, u + m - f, 8, 0, Math.PI * 2), n.fill(), n.fillStyle = F(e), n.beginPath(), n.arc(l, u + m, 15, 0, Math.PI * 2), n.fill(), t === "#333" && (n.fillStyle = "#000", n.fillRect(l + 10, u + m - 5, 25, 6));
-    }
-    return r;
-  }
-}
-function F(a, e) {
-  return a;
-}
-class se extends y {
-  constructor(e) {
-    super(), this.system = e;
-  }
-  /**
-   * Trigger an effect at the GameObject's current position.
-   * @param {string} effectName - 'confetti', 'fire', 'sparkle', etc.
-   * @param {object} options - override options
-   */
-  play(e, t = {}) {
-    const s = this.gameObject.x, i = this.gameObject.y;
-    switch (e) {
-      case "confetti":
-        this.system.confetti(s, i, t.count);
-        break;
-      case "fire":
-        this.system.fire(s, i, t.count);
-        break;
-      case "sparkle":
-        this.system.sparkle(s, i, t.count, t.color);
-        break;
-      case "blood":
-        this.system.emit({
-          x: s,
-          y: i,
-          count: 10,
-          color: ["#8a0303", "#ff0000"],
-          speed: 4,
-          gravity: 0.1,
-          decay: 0.05
-        });
-        break;
-      default:
-        this.system.emit({
-          x: s,
-          y: i,
-          ...t
-        });
+      const l = o * 64, h = 0, d = l + 64 / 2, u = h + 64 / 2, p = o % 2 === 0 ? 0 : -2, g = o === 1 ? 5 : o === 3 ? -5 : 0;
+      a.fillStyle = t, a.beginPath(), a.arc(d, u + p, 20, 0, Math.PI * 2), a.fill(), a.fillStyle = e, a.beginPath(), a.arc(d - 15, u + p + g, 8, 0, Math.PI * 2), a.arc(d + 15, u + p - g, 8, 0, Math.PI * 2), a.fill(), a.fillStyle = O(t), a.beginPath(), a.arc(d, u + p, 15, 0, Math.PI * 2), a.fill(), e === "#333" && (a.fillStyle = "#000", a.fillRect(d + 10, u + p - 5, 25, 6));
     }
+    return n;
   }
 }
-class ie extends y {
-  constructor() {
-    super(), this.intensity = 0, this.duration = 0, this.timer = 0, this.originalPos = { x: 0, y: 0 }, this.isShaking = !1;
-  }
-  shake(e = 5, t = 0.2) {
-    this.intensity = e, this.duration = t, this.timer = 0, this.isShaking = !0, this.timer === 0 && (this.originalPos.x = this.gameObject.x, this.originalPos.y = this.gameObject.y);
-  }
-  update(e) {
-    if (!this.isShaking) return;
-    if (this.timer += e, this.timer >= this.duration) {
-      this.isShaking = !1, this.gameObject.x = this.originalPos.x, this.gameObject.y = this.originalPos.y;
-      return;
-    }
-    const t = (Math.random() - 0.5) * 2 * this.intensity, s = (Math.random() - 0.5) * 2 * this.intensity;
-    this.gameObject.x = this.originalPos.x + t, this.gameObject.y = this.originalPos.y + s;
-  }
+function O(r, t) {
+  return r;
 }
 export {
-  ee as Animator,
-  H as Collider,
-  y as Component,
-  A as DataService,
-  G as Director,
-  B as DopamineKernel,
-  p as EventBus,
-  Q as Game,
-  Z as GameObject,
-  D as GameUI,
-  q as GlobalInput,
-  K as GlobalLoader,
-  $ as GlobalPhysics,
-  W as IAudioSystem,
-  Y as IParticleSystem,
-  J as IPhysicsSystem,
-  g as ISystem,
-  M as Input,
-  E as Loader,
-  se as ParticleEmitter,
-  T as ParticleSystem,
-  b as Physics,
-  U as PluginRegistry,
-  R as Renderer,
-  O as RewardSystem,
-  V as Scene,
-  ie as ScreenShake,
-  I as SoundManager,
-  j as Sprite,
-  X as System,
-  L as SystemRegistry,
-  te as TextureGenerator,
-  z as Ticker,
-  P as Vector2,
-  N as default
+  j as Animator,
+  X as Collider,
+  J as Component,
+  I as DataService,
+  V as Director,
+  W as DopamineKernel,
+  K as EventBus,
+  T as EventEmitter,
+  Y as Game,
+  Q as GameObject,
+  L as GameUI,
+  Z as GlobalInput,
+  tt as GlobalLoader,
+  et as GlobalPhysics,
+  B as IAudioSystem,
+  U as IParticleSystem,
+  R as IPhysicsSystem,
+  _ as ISystem,
+  st as Input,
+  it as Loader,
+  at as ParticleEmitter,
+  z as ParticleSystem,
+  nt as Physics,
+  rt as PluginRegistry,
+  ot as Renderer,
+  D as RewardSystem,
+  lt as Scene,
+  ct as ScreenShake,
+  F as SoundManager,
+  ht as Sprite,
+  G as System,
+  dt as SystemRegistry,
+  $ as TextureGenerator,
+  ut as Ticker,
+  pt as Vector2,
+  P as createMemoryStorage,
+  N as default,
+  A as resolveStorage
 };