dopaminejs 1.1.0 → 1.2.0

package/dist/dopamine.mjs

@@ -1,4 +1,4 @@
-class p {
+class g {
   constructor() {
     this.listeners = /* @__PURE__ */ new Map();
   }
@@ -8,28 +8,28 @@ class p {
    * @param {Function} callback - Callback function
    * @returns {Function} Unsubscribe function
    */
-  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);
+  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);
   }
   /**
    * Unsubscribe from an event
    * @param {string} event - Event name
    * @param {Function} callback - Callback function
    */
-  off(t, e) {
-    this.listeners.has(t) && this.listeners.get(t).delete(e);
+  off(e, t) {
+    this.listeners.has(e) && this.listeners.get(e).delete(t);
   }
   /**
    * Emit an event
    * @param {string} event - Event name
    * @param {*} data - Event data
    */
-  emit(t, e) {
-    this.listeners.has(t) && this.listeners.get(t).forEach((s) => {
+  emit(e, t) {
+    this.listeners.has(e) && this.listeners.get(e).forEach((s) => {
       try {
-        s(e);
+        s(t);
       } catch (i) {
-        console.error(`Error in listener for event '${t}':`, i);
+        console.error(`Error in listener for event '${e}':`, i);
       }
     });
   }
@@ -40,9 +40,9 @@ class p {
     this.listeners.clear();
   }
 }
-class m extends p {
-  constructor(t, e = {}) {
-    super(), this.dataService = t, this.player = null, this.achievements = { ...this._initAchievements(), ...e.achievements || {} };
+class x extends g {
+  constructor(e, t = {}) {
+    super(), this.dataService = e, this.player = null, this.achievements = { ...this._initAchievements(), ...t.achievements || {} };
   }
   /**
    * Initialize the reward system for current player
@@ -86,28 +86,28 @@ class m extends p {
    * @param {string} reason - Why XP was awarded (for notifications)
    * @returns {Object} { leveledUp: boolean, newLevel: number, xpGained: number }
    */
-  async addXP(t, e = "") {
+  async addXP(e, t = "") {
     const s = this.player.level;
-    this.player.xp += t;
+    this.player.xp += e;
     const i = this._calculateLevel(this.player.xp), a = i > s;
-    return a && (this.player.level = i), await this.save(), this.emit("xp_gained", { amount: t, reason: e, leveledUp: a, newLevel: i }), a && this.emit("level_up", { oldLevel: s, newLevel: i }), { leveledUp: a, newLevel: i, xpGained: t };
+    return a && (this.player.level = i), await this.save(), this.emit("xp_gained", { amount: e, reason: t, leveledUp: a, newLevel: i }), a && this.emit("level_up", { oldLevel: s, newLevel: i }), { leveledUp: a, newLevel: i, xpGained: e };
   }
   /**
    * Calculate level from XP (exponential curve)
    */
-  _calculateLevel(t) {
-    const e = Math.floor((1 + Math.sqrt(1 + 8 * t / 50)) / 2);
-    return Math.max(1, e);
+  _calculateLevel(e) {
+    const t = Math.floor((1 + Math.sqrt(1 + 8 * e / 50)) / 2);
+    return Math.max(1, t);
   }
   /**
    * Get XP needed for next level
    */
   getXPForNextLevel() {
-    const t = this.player.level + 1, e = 50 * t * (t - 1), s = 50 * this.player.level * (this.player.level - 1);
+    const e = this.player.level + 1, t = 50 * e * (e - 1), s = 50 * this.player.level * (this.player.level - 1);
     return {
-      total: e,
-      needed: e - this.player.xp,
-      progress: (this.player.xp - s) / (e - s)
+      total: t,
+      needed: t - this.player.xp,
+      progress: (this.player.xp - s) / (t - s)
     };
   }
   /**
@@ -115,74 +115,74 @@ class m extends p {
    * @param {string} gameName - Unique ID for the game
    * @param {Object} result - Game-specific result data
    */
-  async recordGame(t, e) {
-    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.emit("new_high_score", { gameName: t, score: e.score })), Object.keys(e).forEach((a) => {
-      a !== "score" && (s[a] = (s[a] || 0) + (typeof e[a] == "number" ? e[a] : 0));
+  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((a) => {
+      a !== "score" && (s[a] = (s[a] || 0) + (typeof t[a] == "number" ? t[a] : 0));
     });
     let i = 10;
-    e.score && (i += 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();
+    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();
   }
   /**
    * Check and unlock achievements
    */
-  async checkAchievements(t, e) {
+  async checkAchievements(e, t) {
     const s = [];
     for (const [i, a] of Object.entries(this.achievements))
-      this.player.achievements[i] || a.check(this.player, t, e) && (await this.unlockAchievement(i), s.push(a));
+      this.player.achievements[i] || a.check(this.player, e, t) && (await this.unlockAchievement(i), s.push(a));
     return s;
   }
   /**
    * Unlock an achievement
    */
-  async unlockAchievement(t) {
-    const e = this.achievements[t];
-    return e ? (this.player.achievements[t] = {
+  async unlockAchievement(e) {
+    const t = this.achievements[e];
+    return t ? (this.player.achievements[e] = {
       unlockedAt: Date.now(),
       seen: !1
-    }, await this.addXP(e.xp, `Achievement: ${e.name}`), this.emit("achievement_unlocked", e), await this.save(), !0) : !1;
+    }, await this.addXP(t.xp, `Achievement: ${t.name}`), this.emit("achievement_unlocked", t), await this.save(), !0) : !1;
   }
   /**
    * Get all unlocked achievements
    */
   getUnlockedAchievements() {
-    return Object.entries(this.player.achievements).map(([t, e]) => ({
-      ...this.achievements[t],
-      id: t,
-      ...e
+    return Object.entries(this.player.achievements).map(([e, t]) => ({
+      ...this.achievements[e],
+      id: e,
+      ...t
     }));
   }
   /**
    * Get achievements user hasn't seen the notification for yet
    */
   getUnseenAchievements() {
-    return this.getUnlockedAchievements().filter((t) => !t.seen);
+    return this.getUnlockedAchievements().filter((e) => !e.seen);
   }
   /**
    * Mark achievements as seen
    */
-  async markAchievementsSeen(t) {
-    for (const e of t)
-      this.player.achievements[e] && (this.player.achievements[e].seen = !0);
+  async markAchievementsSeen(e) {
+    for (const t of e)
+      this.player.achievements[t] && (this.player.achievements[t].seen = !0);
     await this.save();
   }
   /**
    * Update daily streak
    */
   _updateDailyStreak() {
-    const t = this._getTodayDateString(), e = this.player.streak.lastPlayDate;
-    if (e === t)
+    const e = this._getTodayDateString(), t = this.player.streak.lastPlayDate;
+    if (t === e)
       return;
     const s = this._getYesterdayDateString();
-    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;
+    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;
   }
   /**
    * Get streak multiplier for XP
    */
   getStreakMultiplier() {
-    const t = this.player.streak.current;
-    return t >= 7 ? 2 : t >= 5 ? 1.5 : t >= 3 ? 1.25 : 1;
+    const e = this.player.streak.current;
+    return e >= 7 ? 2 : e >= 5 ? 1.5 : e >= 3 ? 1.25 : 1;
   }
   /**
    * Get today's date as YYYY-MM-DD string
@@ -194,8 +194,8 @@ class m extends p {
    * Get yesterday's date as YYYY-MM-DD string
    */
   _getYesterdayDateString() {
-    const t = /* @__PURE__ */ new Date();
-    return t.setDate(t.getDate() - 1), t.toISOString().split("T")[0];
+    const e = /* @__PURE__ */ new Date();
+    return e.setDate(e.getDate() - 1), e.toISOString().split("T")[0];
   }
   /**
    * Initialize achievement definitions
@@ -209,52 +209,52 @@ class m extends p {
         description: "Play your first game",
         icon: "🎮",
         xp: 50,
-        check: (t) => t.totalGamesPlayed >= 1
+        check: (e) => e.totalGamesPlayed >= 1
       },
       level_5: {
         name: "Rising Star",
         description: "Reach level 5",
         icon: "⭐",
         xp: 100,
-        check: (t) => t.level >= 5
+        check: (e) => e.level >= 5
       },
       level_10: {
         name: "Expert Player",
         description: "Reach level 10",
         icon: "🏆",
         xp: 250,
-        check: (t) => t.level >= 10
+        check: (e) => e.level >= 10
       },
       streak_3: {
         name: "Dedicated",
         description: "Play 3 days in a row",
         icon: "🔥",
         xp: 100,
-        check: (t) => t.streak.current >= 3
+        check: (e) => e.streak.current >= 3
       },
       streak_7: {
         name: "Unstoppable",
         description: "Play 7 days in a row",
         icon: "💥",
         xp: 300,
-        check: (t) => t.streak.current >= 7
+        check: (e) => e.streak.current >= 7
       }
     };
   }
 }
-class u {
-  constructor(t = {}) {
-    this.storage = t.storage || window.localStorage, this.prefix = t.prefix || "dopamine_";
+class w {
+  constructor(e = {}) {
+    this.storage = e.storage || window.localStorage, this.prefix = e.prefix || "dopamine_";
   }
   /**
    * Save data to local storage
    * @param {string} key 
    * @param {any} data 
    */
-  async save(t, e) {
+  async save(e, t) {
     try {
-      const s = JSON.stringify(e);
-      return this.storage.setItem(this.prefix + t, s), !0;
+      const s = JSON.stringify(t);
+      return this.storage.setItem(this.prefix + e, s), !0;
     } catch (s) {
       return console.error("Error saving data:", s), !1;
     }
@@ -264,25 +264,25 @@ class u {
    * @param {string} key 
    * @param {any} defaultValue 
    */
-  async load(t, e = null) {
+  async load(e, t = null) {
     try {
-      const s = this.storage.getItem(this.prefix + t);
-      return s ? JSON.parse(s) : e;
+      const s = this.storage.getItem(this.prefix + e);
+      return s ? JSON.parse(s) : t;
     } catch (s) {
-      return console.error("Error loading data:", s), e;
+      return console.error("Error loading data:", s), t;
     }
   }
   /**
    * Clear specific data
    * @param {string} key 
    */
-  async clear(t) {
-    this.storage.removeItem(this.prefix + t);
+  async clear(e) {
+    this.storage.removeItem(this.prefix + e);
   }
 }
-class y {
-  constructor(t) {
-    this.particleSystem = t, this.container = null, this.xpBar = null, this.levelDisplay = null, this.streakDisplay = null, this.init();
+class S {
+  constructor(e) {
+    this.particleSystem = e, this.container = null, this.xpBar = null, this.levelDisplay = null, this.streakDisplay = null, this.init();
   }
   /**
    * Initialize UI overlay
@@ -312,62 +312,62 @@ class y {
   /**
    * Update XP bar
    */
-  updateXP(t, e, s) {
-    const i = t / s * 100;
-    this.xpBar.style.width = `${Math.min(100, i)}%`, this.xpText.textContent = `${t} / ${s} XP`, this.xpBar.style.animation = "none", setTimeout(() => {
+  updateXP(e, t, s) {
+    const i = e / s * 100;
+    this.xpBar.style.width = `${Math.min(100, i)}%`, this.xpText.textContent = `${e} / ${s} XP`, this.xpBar.style.animation = "none", setTimeout(() => {
       this.xpBar.style.animation = "xp-pulse 0.3s ease-out";
     }, 10);
   }
   /**
    * Update level display
    */
-  updateLevel(t) {
-    this.levelDisplay.textContent = t;
-    const e = document.getElementById("level-badge");
-    e.style.animation = "none", setTimeout(() => {
-      e.style.animation = "level-pulse 0.5s ease-out";
+  updateLevel(e) {
+    this.levelDisplay.textContent = e;
+    const t = document.getElementById("level-badge");
+    t.style.animation = "none", setTimeout(() => {
+      t.style.animation = "level-pulse 0.5s ease-out";
     }, 10);
   }
   /**
    * Update streak display
    */
-  updateStreak(t) {
-    this.streakDisplay.textContent = t;
-    const e = document.getElementById("streak-badge");
-    t >= 7 ? e.style.background = "linear-gradient(135deg, #ff6b00 0%, #ff4400 100%)" : t >= 3 && (e.style.background = "linear-gradient(135deg, #ff8800 0%, #ff6b00 100%)");
+  updateStreak(e) {
+    this.streakDisplay.textContent = e;
+    const t = document.getElementById("streak-badge");
+    e >= 7 ? t.style.background = "linear-gradient(135deg, #ff6b00 0%, #ff4400 100%)" : e >= 3 && (t.style.background = "linear-gradient(135deg, #ff8800 0%, #ff6b00 100%)");
   }
   /**
    * Show achievement unlocked popup
    */
-  showAchievement(t) {
-    const e = document.createElement("div");
-    e.className = "achievement-popup", e.innerHTML = `
+  showAchievement(e) {
+    const t = document.createElement("div");
+    t.className = "achievement-popup", t.innerHTML = `
             <div class="achievement-shine"></div>
             <div class="achievement-content">
-                <div class="achievement-icon">${t.icon}</div>
+                <div class="achievement-icon">${e.icon}</div>
                 <div class="achievement-info">
                     <div class="achievement-title">Achievement Unlocked!</div>
-                    <div class="achievement-name">${t.name}</div>
-                    <div class="achievement-desc">${t.description}</div>
-                    <div class="achievement-xp">+${t.xp} XP</div>
+                    <div class="achievement-name">${e.name}</div>
+                    <div class="achievement-desc">${e.description}</div>
+                    <div class="achievement-xp">+${e.xp} XP</div>
                 </div>
             </div>
-        `, document.body.appendChild(e), setTimeout(() => {
-      const s = e.getBoundingClientRect();
+        `, document.body.appendChild(t), setTimeout(() => {
+      const s = t.getBoundingClientRect();
       this.particleSystem.confetti(s.left + s.width / 2, s.top + s.height / 2, 40);
     }, 300), setTimeout(() => {
-      e.style.animation = "slideOut 0.3s ease-in forwards", setTimeout(() => e.remove(), 300);
+      t.style.animation = "slideOut 0.3s ease-in forwards", setTimeout(() => t.remove(), 300);
     }, 4e3);
   }
   /**
    * Show level up screen
    */
-  showLevelUp(t, e) {
+  showLevelUp(e, t) {
     const s = document.createElement("div");
     s.className = "level-up-overlay", s.innerHTML = `
             <div class="level-up-content">
                 <div class="level-up-title">LEVEL UP!</div>
-                <div class="level-up-number">${e}</div>
+                <div class="level-up-number">${t}</div>
                 <div class="level-up-subtitle">Amazing progress!</div>
             </div>
         `, document.body.appendChild(s), setTimeout(() => {
@@ -383,163 +383,177 @@ class y {
   /**
    * Show floating text (e.g., "+50 XP", "COMBO!")
    */
-  showFloatingText(t, e, s, i = "#ffd700", a = "24px") {
+  showFloatingText(e, t, s, i = "#ffd700", a = "24px") {
     const n = document.createElement("div");
-    n.className = "floating-text", n.textContent = t, n.style.left = e + "px", n.style.top = s + "px", n.style.color = i, n.style.fontSize = a, document.body.appendChild(n), setTimeout(() => n.remove(), 2e3);
+    n.className = "floating-text", n.textContent = e, n.style.left = t + "px", n.style.top = s + "px", n.style.color = i, n.style.fontSize = a, document.body.appendChild(n), setTimeout(() => n.remove(), 2e3);
   }
   /**
    * Show combo multiplier
    */
-  showCombo(t, e, s) {
-    this.showFloatingText(`${t}× COMBO!`, e, s, "#ff6b6b", "32px"), this.particleSystem.fire(e, s, 20);
+  showCombo(e, t, s) {
+    this.showFloatingText(`${e}× COMBO!`, t, s, "#ff6b6b", "32px"), this.particleSystem.fire(t, s, 20);
   }
   /**
    * Show "near miss"indicator
    */
-  showNearMiss(t, e) {
-    this.showFloatingText("CLOSE CALL!", t, e, "#45b7d1", "20px"), this.particleSystem.sparkle(t, e, 15, "#45b7d1");
+  showNearMiss(e, t) {
+    this.showFloatingText("CLOSE CALL!", e, t, "#45b7d1", "20px"), this.particleSystem.sparkle(e, t, 15, "#45b7d1");
   }
   /**
    * Show lucky moment (random multiplier)
    */
-  showLuckyMoment(t, e, s) {
-    this.showFloatingText(`LUCKY ${t}×!`, e, s, "#ffd700", "36px"), this.particleSystem.starBurst(e, s, 12), this.particleSystem.confetti(e, s, 25);
+  showLuckyMoment(e, t, s) {
+    this.showFloatingText(`LUCKY ${e}×!`, t, s, "#ffd700", "36px"), this.particleSystem.starBurst(t, s, 12), this.particleSystem.confetti(t, s, 25);
   }
   /**
    * Show generic notification
    */
-  showNotification(t, e = "normal") {
+  showNotification(e, t = "normal") {
     const s = window.innerWidth / 2, i = window.innerHeight / 3;
-    e === "legendary" ? this.showLuckyMoment(t, s, i) : e === "rare" ? this.showCombo(t, s, i) : this.showFloatingText(t, s, i, "#fff", "24px");
+    t === "legendary" ? this.showLuckyMoment(e, s, i) : t === "rare" ? this.showCombo(e, s, i) : this.showFloatingText(e, s, i, "#fff", "24px");
   }
   /**
    * Show Game Over Summary
    */
-  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";
+  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";
     let s = "";
-    t.metrics && (s = Object.entries(t.metrics).map(([i, a]) => `<div style="display:flex;justify-content:space-between;width:100%"><span>${i}:</span> <strong>${a}</strong></div>`).join("")), e.innerHTML = `
+    e.metrics && (s = Object.entries(e.metrics).map(([i, a]) => `<div style="display:flex;justify-content:space-between;width:100%"><span>${i}:</span> <strong>${a}</strong></div>`).join("")), t.innerHTML = `
             <h1>Game Over</h1>
-            <div style="font-size: 3rem; font-weight: bold; color: #e06020; margin: 10px 0;">${t.score}</div>
+            <div style="font-size: 3rem; font-weight: bold; color: #e06020; margin: 10px 0;">${e.score}</div>
             <div style="width: 100%; margin-bottom: 20px;">
                 ${s}
             </div>
             <button class="btn" onclick="location.reload()">Play Again</button>
             <button class="btn" onclick="window.location.href='index.html'" style="margin-top: 10px; background: #543847;">Exit</button>
-        `, document.body.appendChild(e);
+        `, document.body.appendChild(t);
   }
 }
-class v {
-  constructor(t = {}) {
-    this.canvasId = t.canvasId || "dopamine-particle-canvas", this.canvas = document.getElementById(this.canvasId), this.canvas || (this.canvas = document.createElement("canvas"), this.canvas.id = this.canvasId, this.canvas.style.position = "fixed", this.canvas.style.top = "0", this.canvas.style.left = "0", this.canvas.style.width = "100%", this.canvas.style.height = "100%", this.canvas.style.pointerEvents = "none", this.canvas.style.zIndex = t.zIndex || "9999", document.body.appendChild(this.canvas)), this.ctx = this.canvas.getContext("2d"), this.particles = [], this.isAnimating = !1, this._resize(), window.addEventListener("resize", () => this._resize());
+class b {
+  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.getElementById(this.canvasId), this.canvas || (this.canvas = document.createElement("canvas"), 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._resize(), window.ResizeObserver && this.container !== document.body ? new ResizeObserver(() => this._resize()).observe(this.container) : window.addEventListener("resize", () => this._resize());
   }
   _resize() {
-    this.canvas.width = window.innerWidth, this.canvas.height = window.innerHeight;
+    this.container === document.body ? (this.canvas.width = window.innerWidth, this.canvas.height = window.innerHeight) : (this.canvas.width = this.container.clientWidth, this.canvas.height = this.container.clientHeight);
   }
   /**
-   * Confetti explosion (for achievements, level ups)
+   * Register a custom sprite image
+   * @param {string} key 
+   * @param {string} url 
    */
-  confetti(t, e, s = 50) {
-    const i = ["#ff6b6b", "#4ecdc4", "#45b7d1", "#f7dc6f", "#c06c84", "#6c5ce7"];
-    for (let a = 0; a < s; a++)
-      this.particles.push({
-        x: t,
-        y: e,
-        vx: (Math.random() - 0.5) * 10,
-        vy: (Math.random() - 0.5) * 10 - 5,
-        rotation: Math.random() * Math.PI * 2,
-        rotationSpeed: (Math.random() - 0.5) * 0.2,
-        color: i[Math.floor(Math.random() * i.length)],
-        size: Math.random() * 8 + 4,
-        life: 1,
-        decay: 0.015 + Math.random() * 0.01,
-        gravity: 0.3,
-        type: "confetti"
-      });
-    this._startAnimation();
+  registerSprite(e, t) {
+    const s = new Image();
+    s.src = t, this.sprites.set(e, s);
   }
   /**
-   * Sparkle effect (for score milestones, combos)
-   */
-  sparkle(t, e, s = 20, i = "#ffd700") {
-    for (let a = 0; a < s; a++) {
-      const n = Math.PI * 2 / s * a, r = 2 + Math.random() * 3;
-      this.particles.push({
-        x: t,
-        y: e,
-        vx: Math.cos(n) * r,
-        vy: Math.sin(n) * r,
-        color: i,
-        size: Math.random() * 4 + 2,
-        life: 1,
-        decay: 0.02,
-        gravity: -0.1,
-        // Slight upward drift
-        type: "spark"
-      });
-    }
-    this._startAnimation();
+   * Register a custom effect
+   * @param {string} name 
+   * @param {Function} callback - (x, y, ...args) => void
+   */
+  registerEffect(e, t) {
+    this.customEffects.set(e, t);
   }
   /**
-   * Coin shower (for collecting coins)
-   */
-  coinShower(t, e, s = 10) {
-    for (let i = 0; i < s; i++)
-      this.particles.push({
-        x: t + (Math.random() - 0.5) * 100,
-        y: e - Math.random() * 50,
-        vx: (Math.random() - 0.5) * 3,
-        vy: Math.random() * -2 - 3,
-        color: "#ffd700",
-        size: 12,
-        life: 1,
-        decay: 0.012,
-        gravity: 0.4,
-        type: "coin"
-      });
-    this._startAnimation();
+   * Play a registered effect
+   */
+  play(e, t, s, ...i) {
+    const a = this.customEffects.get(e);
+    a ? a(t, s, ...i) : console.warn(`[DopamineJS] Effect '${e}' not found.`);
   }
   /**
-   * Fire particles (for streaks, combos)
+   * Emit particles with custom config
+   * @param {Object} config 
    */
-  fire(t, e, s = 15) {
-    const i = ["#ff6b00", "#ff8800", "#ffaa00", "#ff4400"];
-    for (let a = 0; a < s; a++)
-      this.particles.push({
-        x: t + (Math.random() - 0.5) * 20,
-        y: e,
-        vx: (Math.random() - 0.5) * 2,
-        vy: -Math.random() * 3 - 2,
-        color: i[Math.floor(Math.random() * i.length)],
-        size: Math.random() * 6 + 3,
-        life: 1,
-        decay: 0.025,
-        gravity: -0.2,
-        // Upward
-        type: "fire"
-      });
+  emit(e) {
+    const {
+      x: t,
+      y: s,
+      count: i = 10,
+      speed: a = 5,
+      gravity: n = 0.1,
+      decay: o = 0.02,
+      life: h = 1,
+      color: l = "#ffd700",
+      sprite: d = null,
+      spread: y = Math.PI * 2,
+      angle: v = 0,
+      size: f = 5
+    } = e;
+    for (let p = 0; p < i; p++) {
+      const r = this._getParticle(), u = v + (Math.random() - 0.5) * y, m = Math.random() * a;
+      r.x = t, r.y = s, r.vx = Math.cos(u) * m, r.vy = Math.sin(u) * m, r.life = h, r.decay = o * (0.8 + Math.random() * 0.4), r.gravity = n, r.color = Array.isArray(l) ? l[Math.floor(Math.random() * l.length)] : l, r.size = f * (0.8 + Math.random() * 0.4), r.sprite = d, r.rotation = Math.random() * Math.PI * 2, r.rotationSpeed = (Math.random() - 0.5) * 0.2, this.particles.push(r);
+    }
     this._startAnimation();
   }
-  /**
-   * Star burst (for "perfect" moments)
-   */
-  starBurst(t, e, s = 8) {
+  _getParticle() {
+    return this.pool.length > 0 ? this.pool.pop() : {};
+  }
+  _recycleParticle(e) {
+    this.pool.push(e);
+  }
+  // --- Built-in Effects ---
+  confetti(e, t, s = 50) {
+    const i = ["#ff6b6b", "#4ecdc4", "#45b7d1", "#f7dc6f", "#c06c84", "#6c5ce7"];
+    this.emit({
+      x: e,
+      y: t,
+      count: s,
+      color: i,
+      speed: 10,
+      gravity: 0.3,
+      decay: 0.015,
+      size: 8,
+      spread: Math.PI * 2
+    });
+  }
+  coinShower(e, t, s = 10) {
+    this.emit({
+      x: e,
+      y: t,
+      count: s,
+      color: "#ffd700",
+      speed: 4,
+      gravity: 0.4,
+      decay: 0.012,
+      size: 12,
+      angle: -Math.PI / 2,
+      // Upwards initially
+      spread: Math.PI / 2
+    });
+  }
+  sparkle(e, t, s = 20, i = "#ffd700") {
+    this.emit({
+      x: e,
+      y: t,
+      count: s,
+      color: i,
+      speed: 3,
+      gravity: -0.05,
+      // Float up
+      decay: 0.03,
+      size: 3
+    });
+  }
+  fire(e, t, s = 15) {
+    const i = ["#ff6b00", "#ff8800", "#ffaa00", "#ff4400"];
+    this.emit({
+      x: e,
+      y: t,
+      count: s,
+      color: i,
+      speed: 3,
+      gravity: -0.2,
+      decay: 0.04,
+      size: 5,
+      angle: -Math.PI / 2,
+      spread: Math.PI / 4
+    });
+  }
+  starBurst(e, t, s = 8) {
     for (let i = 0; i < s; i++) {
-      const a = Math.PI * 2 / s * i, n = 4;
-      this.particles.push({
-        x: t,
-        y: e,
-        vx: Math.cos(a) * n,
-        vy: Math.sin(a) * n,
-        rotation: a,
-        color: "#ffffff",
-        size: 15,
-        life: 1,
-        decay: 0.03,
-        gravity: 0,
-        type: "star"
-      });
+      const a = this._getParticle(), n = Math.PI * 2 / s * i, o = 4;
+      a.x = e, a.y = t, a.vx = Math.cos(n) * o, a.vy = Math.sin(n) * o, a.life = 1, a.decay = 0.03, a.gravity = 0, a.color = "#ffffff", a.size = 15, a.sprite = null, a.type = "star", a.rotation = n, a.rotationSpeed = 0, this.particles.push(a);
     }
     this._startAnimation();
   }
@@ -548,44 +562,43 @@ class v {
   }
   _animate() {
     this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);
-    for (let t = this.particles.length - 1; t >= 0; t--) {
-      const e = this.particles[t];
-      if (e.vy += e.gravity, e.x += e.vx, e.y += e.vy, e.life -= e.decay, e.rotationSpeed && (e.rotation += e.rotationSpeed), e.life <= 0) {
-        this.particles.splice(t, 1);
+    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);
         continue;
       }
-      this.ctx.save(), this.ctx.globalAlpha = e.life, this.ctx.fillStyle = e.color, e.type === "confetti" ? (this.ctx.translate(e.x, e.y), this.ctx.rotate(e.rotation), this.ctx.fillRect(-e.size / 2, -e.size / 2, e.size, e.size / 2)) : e.type === "coin" ? (this.ctx.beginPath(), this.ctx.arc(e.x, e.y, e.size, 0, Math.PI * 2), this.ctx.fill(), this.ctx.fillStyle = "#ffee88", this.ctx.beginPath(), this.ctx.arc(e.x - e.size / 3, e.y - e.size / 3, e.size / 3, 0, Math.PI * 2), this.ctx.fill()) : e.type === "star" ? this._drawStar(e.x, e.y, 5, e.size, e.size / 2, e.rotation) : (this.ctx.beginPath(), this.ctx.arc(e.x, e.y, e.size, 0, Math.PI * 2), this.ctx.fill()), this.ctx.restore();
+      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());
+      this.ctx.restore();
     }
     this.particles.length > 0 ? requestAnimationFrame(() => this._animate()) : this.isAnimating = !1;
   }
-  _drawStar(t, e, s, i, a, n) {
-    let r = Math.PI / 2 * 3 + n;
-    const c = Math.PI / s;
-    this.ctx.beginPath(), this.ctx.moveTo(t, e - i);
-    for (let d = 0; d < s; d++) {
-      let l = t + Math.cos(r) * i, h = e + Math.sin(r) * i;
-      this.ctx.lineTo(l, h), r += c, l = t + Math.cos(r) * a, h = e + Math.sin(r) * a, this.ctx.lineTo(l, h), r += c;
-    }
-    this.ctx.lineTo(t, e - i), this.ctx.closePath(), this.ctx.fill();
+  _drawStarPath(e, t, s, i, a) {
+    let n = Math.PI / 2 * 3, o = e, h = t;
+    const l = Math.PI / s;
+    this.ctx.beginPath(), this.ctx.moveTo(e, t - i);
+    for (let d = 0; d < s; d++)
+      o = e + Math.cos(n) * i, h = t + Math.sin(n) * i, this.ctx.lineTo(o, h), n += l, o = e + Math.cos(n) * a, h = t + Math.sin(n) * a, this.ctx.lineTo(o, h), n += l;
+    this.ctx.lineTo(e, t - i), this.ctx.closePath();
   }
-  /**
-   * Clear all particles
-   */
   clear() {
-    this.particles = [], this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);
+    this.particles.forEach((e) => this._recycleParticle(e)), this.particles = [], this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);
   }
 }
-class f {
-  constructor(t = {}) {
-    this.audioContext = null, this.storageKey = t.storageKey || "dopamineSoundsMuted", this.muted = localStorage.getItem(this.storageKey) === "true", this.assets = /* @__PURE__ */ new Map(), this.soundPack = t.soundPack || "synth", this.customSounds = t.customSounds || {}, Object.keys(this.customSounds).length > 0 && this.preloadSounds(this.customSounds);
+class P {
+  constructor(e = {}) {
+    this.audioContext = null, this.storageKey = e.storageKey || "dopamineSoundsMuted", this.muted = localStorage.getItem(this.storageKey) === "true", this.assets = /* @__PURE__ */ new Map(), this.soundPack = e.soundPack || "synth", this.customSounds = e.customSounds || {}, Object.keys(this.customSounds).length > 0 && this.preloadSounds(this.customSounds);
   }
   /**
    * Initialize Audio Context (must be called after user interaction)
    */
   initAudio() {
     if (!this.audioContext) {
-      const t = window.AudioContext || window.webkitAudioContext;
-      this.audioContext = new t();
+      const e = window.AudioContext || window.webkitAudioContext;
+      this.audioContext = new e();
     }
     this.audioContext.state === "suspended" && this.audioContext.resume();
   }
@@ -601,45 +614,45 @@ class f {
    * @param {string} key - Unique identifier (e.g., 'jump', 'win')
    * @param {string} url - Path to audio file
    */
-  registerSound(t, e) {
-    this.customSounds[t] = e, this.audioContext && this.loadSound(t, e);
+  registerSound(e, t) {
+    this.customSounds[e] = t, this.audioContext && this.loadSound(e, t);
   }
   /**
    * Preload multiple sounds
    * @param {Object} soundMap - { key: url }
    */
-  async preloadSounds(t) {
-    const e = Object.entries(t).map(([s, i]) => this.loadSound(s, i));
-    await Promise.allSettled(e);
+  async preloadSounds(e) {
+    const t = Object.entries(e).map(([s, i]) => this.loadSound(s, i));
+    await Promise.allSettled(t);
   }
   /**
    * Load and decode a sound file
    */
-  async loadSound(t, e) {
+  async loadSound(e, t) {
     try {
       if (!this.audioContext)
         return;
-      const i = await (await fetch(e)).arrayBuffer(), a = await this.audioContext.decodeAudioData(i);
-      this.assets.set(t, a);
+      const i = await (await fetch(t)).arrayBuffer(), a = await this.audioContext.decodeAudioData(i);
+      this.assets.set(e, a);
     } catch (s) {
-      console.warn(`[DopamineJS] Failed to load sound '${t}':`, s);
+      console.warn(`[DopamineJS] Failed to load sound '${e}':`, s);
     }
   }
   /**
    * Play a sound by key (custom) or fallback to synth
    * @param {string} key - 'jump', 'score', 'success', etc.
    */
-  async play(t) {
+  async play(e) {
     if (this.muted) return;
-    if (this.initAudio(), this.assets.has(t)) {
-      this._playBuffer(this.assets.get(t));
+    if (this.initAudio(), this.assets.has(e)) {
+      this._playBuffer(this.assets.get(e));
       return;
     }
-    if (this.customSounds[t] && !this.assets.has(t) && (await this.loadSound(t, this.customSounds[t]), this.assets.has(t))) {
-      this._playBuffer(this.assets.get(t));
+    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;
     }
-    const e = {
+    const t = {
       jump: () => this.playJump(!0),
       // true = force synth
       score: () => this.playScore(!0),
@@ -648,50 +661,50 @@ class f {
       error: () => this.playError(!0),
       gameover: () => this.playGameOver(!0)
     };
-    e[t] && e[t]();
+    t[e] && t[e]();
   }
-  _playBuffer(t) {
-    const e = this.audioContext.createBufferSource();
-    e.buffer = t, e.connect(this.audioContext.destination), e.start(0);
+  _playBuffer(e) {
+    const t = this.audioContext.createBufferSource();
+    t.buffer = e, t.connect(this.audioContext.destination), t.start(0);
   }
   /**
    * Play a synthesized tone
    */
-  playTone(t, e, s = "sine", i = 0.3) {
+  playTone(e, t, s = "sine", i = 0.3) {
     if (this.muted) return;
     this.initAudio();
     const a = this.audioContext.createOscillator(), n = this.audioContext.createGain();
-    a.connect(n), n.connect(this.audioContext.destination), a.frequency.value = t, a.type = s, n.gain.setValueAtTime(i, this.audioContext.currentTime), n.gain.exponentialRampToValueAtTime(0.01, this.audioContext.currentTime + e), a.start(this.audioContext.currentTime), a.stop(this.audioContext.currentTime + e);
+    a.connect(n), n.connect(this.audioContext.destination), a.frequency.value = e, a.type = s, n.gain.setValueAtTime(i, this.audioContext.currentTime), n.gain.exponentialRampToValueAtTime(0.01, this.audioContext.currentTime + t), a.start(this.audioContext.currentTime), a.stop(this.audioContext.currentTime + t);
   }
   // --- Presets (Synth) ---
-  playJump(t = !1) {
-    if (!t && this.assets.has("jump")) return this.play("jump");
+  playJump(e = !1) {
+    if (!e && this.assets.has("jump")) return this.play("jump");
     this.playTone(400, 0.1, "square", 0.2);
   }
-  playScore(t = !1) {
-    if (!t && this.assets.has("score")) return this.play("score");
+  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);
   }
-  playGameOver(t = !1) {
-    if (!t && this.assets.has("gameover")) return this.play("gameover");
+  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);
   }
-  playClick(t = !1) {
-    if (!t && this.assets.has("click")) return this.play("click");
+  playClick(e = !1) {
+    if (!e && this.assets.has("click")) return this.play("click");
     this.playTone(600, 0.05, "sine", 0.1);
   }
-  playSuccess(t = !1) {
-    if (!t && this.assets.has("success")) return this.play("success");
+  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);
   }
-  playError(t = !1) {
-    if (!t && this.assets.has("error")) return this.play("error");
+  playError(e = !1) {
+    if (!e && this.assets.has("error")) return this.play("error");
     this.playTone(200, 0.2, "sawtooth", 0.3);
   }
 }
-class g {
-  constructor(t = {}) {
-    this.config = t, this.dataService = new u(t.data || {}), this.rewardSystem = new m(this.dataService, t.rewards || {}), this.soundManager = new f(t.sound || {}), this.particleSystem = new v(t.particles || {}), this.gameUI = new y(this.particleSystem), this._bindEvents();
+class M {
+  constructor(e = {}) {
+    this.config = e, this.dataService = new w(e.data || {}), this.rewardSystem = new x(this.dataService, e.rewards || {}), this.soundManager = new P(e.sound || {}), this.particleSystem = new b(e.particles || {}), this.gameUI = new S(this.particleSystem), this._bindEvents();
   }
   async init() {
     return await this.rewardSystem.init(), console.log("DopamineJS Initialized 🚀"), {
@@ -702,23 +715,23 @@ class g {
     };
   }
   _bindEvents() {
-    this.rewardSystem.on("xp_gained", (t) => {
-      const { total: e, needed: s } = this.rewardSystem.getXPForNextLevel();
-      this.gameUI.updateXP(this.rewardSystem.player.xp, s, e), t.xpGained > 0;
-    }), this.rewardSystem.on("level_up", (t) => {
-      this.gameUI.updateLevel(t.newLevel), this.gameUI.showLevelUp(t.oldLevel, t.newLevel);
-    }), this.rewardSystem.on("achievement_unlocked", (t) => {
-      this.gameUI.showAchievement(t);
-    }), this.rewardSystem.on("new_high_score", (t) => {
-      this.gameUI.showNotification(`New High Score: ${t.score}!`, "legendary"), this.soundManager.playSuccess();
+    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();
     });
   }
 }
 export {
-  u as DataService,
-  y as GameUI,
-  v as ParticleSystem,
-  m as RewardSystem,
-  f as SoundManager,
-  g as default
+  w as DataService,
+  S as GameUI,
+  b as ParticleSystem,
+  x as RewardSystem,
+  P as SoundManager,
+  M as default
 };