dopaminejs 1.0.0 → 1.1.0

package/dist/dopamine.umd.js

@@ -1,4 +1,4 @@
-(function(o,c){typeof exports=="object"&&typeof module<"u"?c(exports):typeof define=="function"&&define.amd?define(["exports"],c):(o=typeof globalThis<"u"?globalThis:o||self,c(o.Dopamine={}))})(this,function(o){"use strict";class c{constructor(){this.storage=window.localStorage}async save(t,e){try{const i=JSON.stringify(e);return this.storage.setItem(t,i),!0}catch(i){return console.error("Error saving data:",i),!1}}async load(t,e=null){try{const i=this.storage.getItem(t);return i?JSON.parse(i):e}catch(i){return console.error("Error loading data:",i),e}}async clear(t){this.storage.removeItem(t)}}const d=new c;class x{constructor(){this.player=null,this.achievements=this._initAchievements(),this.listeners=[]}async init(){return this.player=await d.load("player",this._getDefaultPlayer()),this._updateDailyStreak(),await this.save(),this.player}_getDefaultPlayer(){return{name:"Player",xp:0,level:1,totalGamesPlayed:0,createdAt:Date.now(),lastPlayedAt:Date.now(),streak:{current:1,longest:1,lastPlayDate:this._getTodayDateString()},achievements:{},stats:{}}}async save(){this.player&&(this.player.lastPlayedAt=Date.now(),await d.save("player",this.player))}async addXP(t,e=""){const i=this.player.level;this.player.xp+=t;const s=this._calculateLevel(this.player.xp),a=s>i;return a&&(this.player.level=s),await this.save(),this._emit("xp_gained",{amount:t,reason:e,leveledUp:a,newLevel:s}),a&&this._emit("level_up",{oldLevel:i,newLevel:s}),{leveledUp:a,newLevel:s,xpGained:t}}_calculateLevel(t){const e=Math.floor((1+Math.sqrt(1+8*t/50))/2);return Math.max(1,e)}getXPForNextLevel(){const t=this.player.level+1,e=50*t*(t-1),i=50*this.player.level*(this.player.level-1);return{total:e,needed:e-this.player.xp,progress:(this.player.xp-i)/(e-i)}}async recordGame(t,e){this.player.stats[t]||(this.player.stats[t]={totalPlays:0,highScore:0});const i=this.player.stats[t];i.totalPlays++,this.player.totalGamesPlayed++,e.score!==void 0&&e.score>i.highScore&&(i.highScore=e.score,this._emit("new_high_score",{gameName:t,score:e.score})),Object.keys(e).forEach(a=>{a!=="score"&&(i[a]=(i[a]||0)+(typeof e[a]=="number"?e[a]:0))});let s=10;e.score&&(s+=Math.floor(e.score/5)),s=Math.floor(s*this.getStreakMultiplier()),await this.addXP(s,`Played ${t}`),await this.checkAchievements(t,e),await this.save()}async checkAchievements(t,e){const i=[];for(const[s,a]of Object.entries(this.achievements))this.player.achievements[s]||a.check(this.player,t,e)&&(await this.unlockAchievement(s),i.push(a));return i}async unlockAchievement(t){const e=this.achievements[t];return e?(this.player.achievements[t]={unlockedAt:Date.now(),seen:!1},await this.addXP(e.xp,`Achievement: ${e.name}`),this._emit("achievement_unlocked",e),await this.save(),!0):!1}getUnlockedAchievements(){return Object.entries(this.player.achievements).map(([t,e])=>({...this.achievements[t],id:t,...e}))}getUnseenAchievements(){return this.getUnlockedAchievements().filter(t=>!t.seen)}async markAchievementsSeen(t){for(const e of t)this.player.achievements[e]&&(this.player.achievements[e].seen=!0);await this.save()}_updateDailyStreak(){const t=this._getTodayDateString(),e=this.player.streak.lastPlayDate;if(e===t)return;const i=this._getYesterdayDateString();e===i?(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}getStreakMultiplier(){const t=this.player.streak.current;return t>=7?2:t>=5?1.5:t>=3?1.25:1}_getTodayDateString(){return new Date().toISOString().split("T")[0]}_getYesterdayDateString(){const t=new Date;return t.setDate(t.getDate()-1),t.toISOString().split("T")[0]}on(t,e){this.listeners.push({event:t,callback:e})}_emit(t,e){this.listeners.filter(i=>i.event===t).forEach(i=>i.callback(e))}_initAchievements(){return{first_game:{name:"First Steps",description:"Play your first game",icon:"🎮",xp:50,check:t=>t.totalGamesPlayed>=1},level_5:{name:"Rising Star",description:"Reach level 5",icon:"⭐",xp:100,check:t=>t.level>=5},level_10:{name:"Expert Player",description:"Reach level 10",icon:"🏆",xp:250,check:t=>t.level>=10},streak_3:{name:"Dedicated",description:"Play 3 days in a row",icon:"🔥",xp:100,check:t=>t.streak.current>=3},streak_7:{name:"Unstoppable",description:"Play 7 days in a row",icon:"💥",xp:300,check:t=>t.streak.current>=7}}}registerAchievements(t){this.achievements={...this.achievements,...t}}}const p=new x;class w{constructor(t="dopamine-particle-canvas"){this.canvasId=t,this.canvas=document.getElementById(t),this.canvas||(this.canvas=document.createElement("canvas"),this.canvas.id=t,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="9999",document.body.appendChild(this.canvas)),this.ctx=this.canvas.getContext("2d"),this.particles=[],this.isAnimating=!1,this._resize(),window.addEventListener("resize",()=>this._resize())}_resize(){this.canvas.width=window.innerWidth,this.canvas.height=window.innerHeight}confetti(t,e,i=50){const s=["#ff6b6b","#4ecdc4","#45b7d1","#f7dc6f","#c06c84","#6c5ce7"];for(let a=0;a<i;a++)this.particles.push({x:t,y:e,vx:(Math.random()-.5)*10,vy:(Math.random()-.5)*10-5,rotation:Math.random()*Math.PI*2,rotationSpeed:(Math.random()-.5)*.2,color:s[Math.floor(Math.random()*s.length)],size:Math.random()*8+4,life:1,decay:.015+Math.random()*.01,gravity:.3,type:"confetti"});this._startAnimation()}sparkle(t,e,i=20,s="#ffd700"){for(let a=0;a<i;a++){const n=Math.PI*2/i*a,l=2+Math.random()*3;this.particles.push({x:t,y:e,vx:Math.cos(n)*l,vy:Math.sin(n)*l,color:s,size:Math.random()*4+2,life:1,decay:.02,gravity:-.1,type:"spark"})}this._startAnimation()}coinShower(t,e,i=10){for(let s=0;s<i;s++)this.particles.push({x:t+(Math.random()-.5)*100,y:e-Math.random()*50,vx:(Math.random()-.5)*3,vy:Math.random()*-2-3,color:"#ffd700",size:12,life:1,decay:.012,gravity:.4,type:"coin"});this._startAnimation()}fire(t,e,i=15){const s=["#ff6b00","#ff8800","#ffaa00","#ff4400"];for(let a=0;a<i;a++)this.particles.push({x:t+(Math.random()-.5)*20,y:e,vx:(Math.random()-.5)*2,vy:-Math.random()*3-2,color:s[Math.floor(Math.random()*s.length)],size:Math.random()*6+3,life:1,decay:.025,gravity:-.2,type:"fire"});this._startAnimation()}starBurst(t,e,i=8){for(let s=0;s<i;s++){const a=Math.PI*2/i*s,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:.03,gravity:0,type:"star"})}this._startAnimation()}_startAnimation(){this.isAnimating||(this.isAnimating=!0,this._animate())}_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);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()}this.particles.length>0?requestAnimationFrame(()=>this._animate()):this.isAnimating=!1}_drawStar(t,e,i,s,a,n){let l=Math.PI/2*3+n;const f=Math.PI/i;this.ctx.beginPath(),this.ctx.moveTo(t,e-s);for(let g=0;g<i;g++){let m=t+Math.cos(l)*s,y=e+Math.sin(l)*s;this.ctx.lineTo(m,y),l+=f,m=t+Math.cos(l)*a,y=e+Math.sin(l)*a,this.ctx.lineTo(m,y),l+=f}this.ctx.lineTo(t,e-s),this.ctx.closePath(),this.ctx.fill()}clear(){this.particles=[],this.ctx.clearRect(0,0,this.canvas.width,this.canvas.height)}}const r=new w;class b{constructor(){this.container=null,this.xpBar=null,this.levelDisplay=null,this.streakDisplay=null,this.init()}init(){this.container=document.createElement("div"),this.container.id="game-ui-overlay",this.container.innerHTML=`
+(function(r,h){typeof exports=="object"&&typeof module<"u"?h(exports):typeof define=="function"&&define.amd?define(["exports"],h):(r=typeof globalThis<"u"?globalThis:r||self,h(r.Dopamine={}))})(this,function(r){"use strict";class h{constructor(){this.listeners=new Map}on(t,e){return this.listeners.has(t)||this.listeners.set(t,new Set),this.listeners.get(t).add(e),()=>this.off(t,e)}off(t,e){this.listeners.has(t)&&this.listeners.get(t).delete(e)}emit(t,e){this.listeners.has(t)&&this.listeners.get(t).forEach(s=>{try{s(e)}catch(i){console.error(`Error in listener for event '${t}':`,i)}})}clear(){this.listeners.clear()}}class p extends h{constructor(t,e={}){super(),this.dataService=t,this.player=null,this.achievements={...this._initAchievements(),...e.achievements||{}}}async init(){return this.player=await this.dataService.load("player",this._getDefaultPlayer()),this._updateDailyStreak(),await this.save(),this.player}_getDefaultPlayer(){return{name:"Player",xp:0,level:1,totalGamesPlayed:0,createdAt:Date.now(),lastPlayedAt:Date.now(),streak:{current:1,longest:1,lastPlayDate:this._getTodayDateString()},achievements:{},stats:{}}}async save(){this.player&&(this.player.lastPlayedAt=Date.now(),await this.dataService.save("player",this.player))}async addXP(t,e=""){const s=this.player.level;this.player.xp+=t;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}}_calculateLevel(t){const e=Math.floor((1+Math.sqrt(1+8*t/50))/2);return Math.max(1,e)}getXPForNextLevel(){const t=this.player.level+1,e=50*t*(t-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)}}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))});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()}async checkAchievements(t,e){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));return s}async unlockAchievement(t){const e=this.achievements[t];return e?(this.player.achievements[t]={unlockedAt:Date.now(),seen:!1},await this.addXP(e.xp,`Achievement: ${e.name}`),this.emit("achievement_unlocked",e),await this.save(),!0):!1}getUnlockedAchievements(){return Object.entries(this.player.achievements).map(([t,e])=>({...this.achievements[t],id:t,...e}))}getUnseenAchievements(){return this.getUnlockedAchievements().filter(t=>!t.seen)}async markAchievementsSeen(t){for(const e of t)this.player.achievements[e]&&(this.player.achievements[e].seen=!0);await this.save()}_updateDailyStreak(){const t=this._getTodayDateString(),e=this.player.streak.lastPlayDate;if(e===t)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}getStreakMultiplier(){const t=this.player.streak.current;return t>=7?2:t>=5?1.5:t>=3?1.25:1}_getTodayDateString(){return new Date().toISOString().split("T")[0]}_getYesterdayDateString(){const t=new Date;return t.setDate(t.getDate()-1),t.toISOString().split("T")[0]}_initAchievements(){return{first_game:{name:"First Steps",description:"Play your first game",icon:"🎮",xp:50,check:t=>t.totalGamesPlayed>=1},level_5:{name:"Rising Star",description:"Reach level 5",icon:"⭐",xp:100,check:t=>t.level>=5},level_10:{name:"Expert Player",description:"Reach level 10",icon:"🏆",xp:250,check:t=>t.level>=10},streak_3:{name:"Dedicated",description:"Play 3 days in a row",icon:"🔥",xp:100,check:t=>t.streak.current>=3},streak_7:{name:"Unstoppable",description:"Play 7 days in a row",icon:"💥",xp:300,check:t=>t.streak.current>=7}}}}class u{constructor(t={}){this.storage=t.storage||window.localStorage,this.prefix=t.prefix||"dopamine_"}async save(t,e){try{const s=JSON.stringify(e);return this.storage.setItem(this.prefix+t,s),!0}catch(s){return console.error("Error saving data:",s),!1}}async load(t,e=null){try{const s=this.storage.getItem(this.prefix+t);return s?JSON.parse(s):e}catch(s){return console.error("Error loading data:",s),e}}async clear(t){this.storage.removeItem(this.prefix+t)}}class m{constructor(t){this.particleSystem=t,this.container=null,this.xpBar=null,this.levelDisplay=null,this.streakDisplay=null,this.init()}init(){this.container=document.createElement("div"),this.container.id="game-ui-overlay",this.container.innerHTML=`
             <div class="game-ui-top-bar">
                 <div class="level-badge" id="level-badge">
                     <span class="level-label">LVL</span>
@@ -17,7 +17,7 @@
                     <span class="streak-number" id="streak-number">1</span>
                 </div>
             </div>
-        `,document.body.appendChild(this.container),this.xpBar=document.getElementById("xp-bar-fill"),this.xpText=document.getElementById("xp-text"),this.levelDisplay=document.getElementById("level-number"),this.streakDisplay=document.getElementById("streak-number")}updateXP(t,e,i){const s=t/i*100;this.xpBar.style.width=`${Math.min(100,s)}%`,this.xpText.textContent=`${t} / ${i} XP`,this.xpBar.style.animation="none",setTimeout(()=>{this.xpBar.style.animation="xp-pulse 0.3s ease-out"},10)}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"},10)}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%)")}showAchievement(t){const e=document.createElement("div");e.className="achievement-popup",e.innerHTML=`
+        `,document.body.appendChild(this.container),this.xpBar=document.getElementById("xp-bar-fill"),this.xpText=document.getElementById("xp-text"),this.levelDisplay=document.getElementById("level-number"),this.streakDisplay=document.getElementById("streak-number")}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(()=>{this.xpBar.style.animation="xp-pulse 0.3s ease-out"},10)}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"},10)}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%)")}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">${t.icon}</div>
@@ -28,18 +28,18 @@
                     <div class="achievement-xp">+${t.xp} XP</div>
                 </div>
             </div>
-        `,document.body.appendChild(e),setTimeout(()=>{const i=e.getBoundingClientRect();r.confetti(i.left+i.width/2,i.top+i.height/2,40)},300),setTimeout(()=>{e.style.animation="slideOut 0.3s ease-in forwards",setTimeout(()=>e.remove(),300)},4e3)}showLevelUp(t,e){const i=document.createElement("div");i.className="level-up-overlay",i.innerHTML=`
+        `,document.body.appendChild(e),setTimeout(()=>{const s=e.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)},4e3)}showLevelUp(t,e){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-subtitle">Amazing progress!</div>
             </div>
-        `,document.body.appendChild(i),setTimeout(()=>{for(let s=0;s<5;s++)setTimeout(()=>{const a=Math.random()*window.innerWidth,n=Math.random()*window.innerHeight*.6;r.confetti(a,n,30)},s*200)},300),setTimeout(()=>{i.style.opacity="0",setTimeout(()=>i.remove(),500)},2500)}showFloatingText(t,e,i,s="#ffd700",a="24px"){const n=document.createElement("div");n.className="floating-text",n.textContent=t,n.style.left=e+"px",n.style.top=i+"px",n.style.color=s,n.style.fontSize=a,document.body.appendChild(n),setTimeout(()=>n.remove(),2e3)}showCombo(t,e,i){this.showFloatingText(`${t}× COMBO!`,e,i,"#ff6b6b","32px"),r.fire(e,i,20)}showNearMiss(t,e){this.showFloatingText("CLOSE CALL!",t,e,"#45b7d1","20px"),r.sparkle(t,e,15,"#45b7d1")}showLuckyMoment(t,e,i){this.showFloatingText(`LUCKY ${t}×!`,e,i,"#ffd700","36px"),r.starBurst(e,i,12),r.confetti(e,i,25)}showNotification(t,e="normal"){const i=window.innerWidth/2,s=window.innerHeight/3;e==="legendary"?this.showLuckyMoment(t,i,s):e==="rare"?this.showCombo(t,i,s):this.showFloatingText(t,i,s,"#fff","24px")}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";let i="";t.metrics&&(i=Object.entries(t.metrics).map(([s,a])=>`<div style="display:flex;justify-content:space-between;width:100%"><span>${s}:</span> <strong>${a}</strong></div>`).join("")),e.innerHTML=`
+        `,document.body.appendChild(s),setTimeout(()=>{for(let i=0;i<5;i++)setTimeout(()=>{const a=Math.random()*window.innerWidth,n=Math.random()*window.innerHeight*.6;this.particleSystem.confetti(a,n,30)},i*200)},300),setTimeout(()=>{s.style.opacity="0",setTimeout(()=>s.remove(),500)},2500)}showFloatingText(t,e,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)}showCombo(t,e,s){this.showFloatingText(`${t}× COMBO!`,e,s,"#ff6b6b","32px"),this.particleSystem.fire(e,s,20)}showNearMiss(t,e){this.showFloatingText("CLOSE CALL!",t,e,"#45b7d1","20px"),this.particleSystem.sparkle(t,e,15,"#45b7d1")}showLuckyMoment(t,e,s){this.showFloatingText(`LUCKY ${t}×!`,e,s,"#ffd700","36px"),this.particleSystem.starBurst(e,s,12),this.particleSystem.confetti(e,s,25)}showNotification(t,e="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")}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";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=`
             <h1>Game Over</h1>
             <div style="font-size: 3rem; font-weight: bold; color: #e06020; margin: 10px 0;">${t.score}</div>
             <div style="width: 100%; margin-bottom: 20px;">
-                ${i}
+                ${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)}}const v=new b;class M{constructor(){this.audioContext=null,this.muted=localStorage.getItem("dopamineSoundsMuted")==="true"}initAudio(){this.audioContext||(this.audioContext=new(window.AudioContext||window.webkitAudioContext))}toggleMute(){return this.muted=!this.muted,localStorage.setItem("dopamineSoundsMuted",this.muted),this.muted}playTone(t,e,i="sine",s=.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=i,n.gain.setValueAtTime(s,this.audioContext.currentTime),n.gain.exponentialRampToValueAtTime(.01,this.audioContext.currentTime+e),a.start(this.audioContext.currentTime),a.stop(this.audioContext.currentTime+e)}playJump(){this.playTone(400,.1,"square",.2)}playScore(){this.playTone(800,.15,"sine",.25),setTimeout(()=>this.playTone(1e3,.15,"sine",.25),50)}playGameOver(){this.playTone(300,.2,"sawtooth",.3),setTimeout(()=>this.playTone(200,.2,"sawtooth",.3),100),setTimeout(()=>this.playTone(150,.3,"sawtooth",.3),200)}playClick(){this.playTone(600,.05,"sine",.1)}playSuccess(){this.playTone(600,.1,"sine",.2),setTimeout(()=>this.playTone(800,.2,"sine",.2),100)}playError(){this.playTone(200,.2,"sawtooth",.3)}}const u=new M;class k{constructor(t={}){this.config=t}async init(){return await p.init(),console.log("DopamineJS Initialized 🚀"),{rewardSystem:p,gameUI:v,particleSystem:r,soundManager:u}}}o.dataService=d,o.default=k,o.gameUI=v,o.particleSystem=r,o.rewardSystem=p,o.soundManager=u,Object.defineProperties(o,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})});
+        `,document.body.appendChild(e)}}class y{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())}_resize(){this.canvas.width=window.innerWidth,this.canvas.height=window.innerHeight}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()-.5)*10,vy:(Math.random()-.5)*10-5,rotation:Math.random()*Math.PI*2,rotationSpeed:(Math.random()-.5)*.2,color:i[Math.floor(Math.random()*i.length)],size:Math.random()*8+4,life:1,decay:.015+Math.random()*.01,gravity:.3,type:"confetti"});this._startAnimation()}sparkle(t,e,s=20,i="#ffd700"){for(let a=0;a<s;a++){const n=Math.PI*2/s*a,o=2+Math.random()*3;this.particles.push({x:t,y:e,vx:Math.cos(n)*o,vy:Math.sin(n)*o,color:i,size:Math.random()*4+2,life:1,decay:.02,gravity:-.1,type:"spark"})}this._startAnimation()}coinShower(t,e,s=10){for(let i=0;i<s;i++)this.particles.push({x:t+(Math.random()-.5)*100,y:e-Math.random()*50,vx:(Math.random()-.5)*3,vy:Math.random()*-2-3,color:"#ffd700",size:12,life:1,decay:.012,gravity:.4,type:"coin"});this._startAnimation()}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()-.5)*20,y:e,vx:(Math.random()-.5)*2,vy:-Math.random()*3-2,color:i[Math.floor(Math.random()*i.length)],size:Math.random()*6+3,life:1,decay:.025,gravity:-.2,type:"fire"});this._startAnimation()}starBurst(t,e,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:.03,gravity:0,type:"star"})}this._startAnimation()}_startAnimation(){this.isAnimating||(this.isAnimating=!0,this._animate())}_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);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()}this.particles.length>0?requestAnimationFrame(()=>this._animate()):this.isAnimating=!1}_drawStar(t,e,s,i,a,n){let o=Math.PI/2*3+n;const f=Math.PI/s;this.ctx.beginPath(),this.ctx.moveTo(t,e-i);for(let g=0;g<s;g++){let c=t+Math.cos(o)*i,d=e+Math.sin(o)*i;this.ctx.lineTo(c,d),o+=f,c=t+Math.cos(o)*a,d=e+Math.sin(o)*a,this.ctx.lineTo(c,d),o+=f}this.ctx.lineTo(t,e-i),this.ctx.closePath(),this.ctx.fill()}clear(){this.particles=[],this.ctx.clearRect(0,0,this.canvas.width,this.canvas.height)}}class v{constructor(t={}){this.audioContext=null,this.storageKey=t.storageKey||"dopamineSoundsMuted",this.muted=localStorage.getItem(this.storageKey)==="true",this.assets=new Map,this.soundPack=t.soundPack||"synth",this.customSounds=t.customSounds||{},Object.keys(this.customSounds).length>0&&this.preloadSounds(this.customSounds)}initAudio(){if(!this.audioContext){const t=window.AudioContext||window.webkitAudioContext;this.audioContext=new t}this.audioContext.state==="suspended"&&this.audioContext.resume()}toggleMute(){return this.muted=!this.muted,localStorage.setItem(this.storageKey,this.muted),this.muted}registerSound(t,e){this.customSounds[t]=e,this.audioContext&&this.loadSound(t,e)}async preloadSounds(t){const e=Object.entries(t).map(([s,i])=>this.loadSound(s,i));await Promise.allSettled(e)}async loadSound(t,e){try{if(!this.audioContext)return;const i=await(await fetch(e)).arrayBuffer(),a=await this.audioContext.decodeAudioData(i);this.assets.set(t,a)}catch(s){console.warn(`[DopamineJS] Failed to load sound '${t}':`,s)}}async play(t){if(this.muted)return;if(this.initAudio(),this.assets.has(t)){this._playBuffer(this.assets.get(t));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));return}const e={jump:()=>this.playJump(!0),score:()=>this.playScore(!0),success:()=>this.playSuccess(!0),click:()=>this.playClick(!0),error:()=>this.playError(!0),gameover:()=>this.playGameOver(!0)};e[t]&&e[t]()}_playBuffer(t){const e=this.audioContext.createBufferSource();e.buffer=t,e.connect(this.audioContext.destination),e.start(0)}playTone(t,e,s="sine",i=.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(.01,this.audioContext.currentTime+e),a.start(this.audioContext.currentTime),a.stop(this.audioContext.currentTime+e)}playJump(t=!1){if(!t&&this.assets.has("jump"))return this.play("jump");this.playTone(400,.1,"square",.2)}playScore(t=!1){if(!t&&this.assets.has("score"))return this.play("score");this.playTone(800,.15,"sine",.25),setTimeout(()=>this.playTone(1e3,.15,"sine",.25),50)}playGameOver(t=!1){if(!t&&this.assets.has("gameover"))return this.play("gameover");this.playTone(300,.2,"sawtooth",.3),setTimeout(()=>this.playTone(200,.2,"sawtooth",.3),100),setTimeout(()=>this.playTone(150,.3,"sawtooth",.3),200)}playClick(t=!1){if(!t&&this.assets.has("click"))return this.play("click");this.playTone(600,.05,"sine",.1)}playSuccess(t=!1){if(!t&&this.assets.has("success"))return this.play("success");this.playTone(600,.1,"sine",.2),setTimeout(()=>this.playTone(800,.2,"sine",.2),100)}playError(t=!1){if(!t&&this.assets.has("error"))return this.play("error");this.playTone(200,.2,"sawtooth",.3)}}class x{constructor(t={}){this.config=t,this.dataService=new u(t.data||{}),this.rewardSystem=new p(this.dataService,t.rewards||{}),this.soundManager=new v(t.sound||{}),this.particleSystem=new y(t.particles||{}),this.gameUI=new m(this.particleSystem),this._bindEvents()}async init(){return await this.rewardSystem.init(),console.log("DopamineJS Initialized 🚀"),{rewardSystem:this.rewardSystem,gameUI:this.gameUI,particleSystem:this.particleSystem,soundManager:this.soundManager}}_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()})}}r.DataService=u,r.GameUI=m,r.ParticleSystem=y,r.RewardSystem=p,r.SoundManager=v,r.default=x,Object.defineProperties(r,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "dopaminejs",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "description": "A lightweight library for adding juice, rewards, and feedback to HTML5 games.",
     "main": "dist/dopamine.umd.js",
     "module": "dist/dopamine.mjs",
@@ -9,7 +9,9 @@
         "dist",
         "src",
         "README.md",
-        "LICENSE"
+        "LICENSE",
+        "CHANGELOG.md",
+        "ARCHITECTURE.md"
     ],
     "exports": {
         ".": {
@@ -23,6 +25,8 @@
         "dev": "vite",
         "build": "vite build",
         "preview": "vite preview",
+        "test": "vitest",
+        "release": "node scripts/deploy.js",
         "prepublishOnly": "npm run build"
     },
     "keywords": [
@@ -37,14 +41,16 @@
     "author": "Gemini",
     "license": "MIT",
     "devDependencies": {
-        "vite": "^5.0.0"
+        "jsdom": "^27.2.0",
+        "vite": "^5.0.0",
+        "vitest": "^4.0.15"
     },
     "repository": {
         "type": "git",
-        "url": "https://github.com/BaryoDev/SimpleMobileGames.git"
+        "url": "https://github.com/BaryoDev/dopaminejs.git"
     },
     "bugs": {
-        "url": "https://github.com/BaryoDev/SimpleMobileGames/issues"
+        "url": "https://github.com/BaryoDev/dopaminejs/issues"
     },
-    "homepage": "https://github.com/BaryoDev/SimpleMobileGames#readme"
-}
+    "homepage": "https://github.com/BaryoDev/dopaminejs#readme"
+}

package/src/audio/SoundManager.js

@@ -4,9 +4,20 @@
  */
 
 export class SoundManager {
-    constructor() {
+    constructor(config = {}) {
         this.audioContext = null;
-        this.muted = localStorage.getItem('dopamineSoundsMuted') === 'true';
+        this.storageKey = config.storageKey || 'dopamineSoundsMuted';
+        this.muted = localStorage.getItem(this.storageKey) === 'true';
+
+        // Asset management
+        this.assets = new Map(); // key -> AudioBuffer
+        this.soundPack = config.soundPack || 'synth'; // 'synth' or custom
+        this.customSounds = config.customSounds || {}; // key -> url
+
+        // Preload custom sounds if provided
+        if (Object.keys(this.customSounds).length > 0) {
+            this.preloadSounds(this.customSounds);
+        }
     }
 
     /**
@@ -14,7 +25,11 @@ export class SoundManager {
      */
     initAudio() {
         if (!this.audioContext) {
-            this.audioContext = new (window.AudioContext || window.webkitAudioContext)();
+            const AudioContext = window.AudioContext || window.webkitAudioContext;
+            this.audioContext = new AudioContext();
+        }
+        if (this.audioContext.state === 'suspended') {
+            this.audioContext.resume();
         }
     }
 
@@ -24,16 +39,102 @@ export class SoundManager {
      */
     toggleMute() {
         this.muted = !this.muted;
-        localStorage.setItem('dopamineSoundsMuted', this.muted);
+        localStorage.setItem(this.storageKey, this.muted);
         return this.muted;
     }
 
+    /**
+     * Register a custom sound URL
+     * @param {string} key - Unique identifier (e.g., 'jump', 'win')
+     * @param {string} url - Path to audio file
+     */
+    registerSound(key, url) {
+        this.customSounds[key] = url;
+        // Auto-load if context exists, otherwise wait for init
+        if (this.audioContext) {
+            this.loadSound(key, url);
+        }
+    }
+
+    /**
+     * Preload multiple sounds
+     * @param {Object} soundMap - { key: url }
+     */
+    async preloadSounds(soundMap) {
+        const promises = Object.entries(soundMap).map(([key, url]) => this.loadSound(key, url));
+        await Promise.allSettled(promises);
+    }
+
+    /**
+     * Load and decode a sound file
+     */
+    async loadSound(key, url) {
+        try {
+            // We need audio context to decode
+            if (!this.audioContext) {
+                // If no context yet, we can't decode. 
+                // In a real app, we might fetch buffer first, decode later.
+                // For simplicity, we'll wait for initAudio() or lazy load.
+                return;
+            }
+
+            const response = await fetch(url);
+            const arrayBuffer = await response.arrayBuffer();
+            const audioBuffer = await this.audioContext.decodeAudioData(arrayBuffer);
+            this.assets.set(key, audioBuffer);
+        } catch (error) {
+            console.warn(`[DopamineJS] Failed to load sound '${key}':`, error);
+        }
+    }
+
+    /**
+     * Play a sound by key (custom) or fallback to synth
+     * @param {string} key - 'jump', 'score', 'success', etc.
+     */
+    async play(key) {
+        if (this.muted) return;
+        this.initAudio();
+
+        // 1. Try custom asset first
+        if (this.assets.has(key)) {
+            this._playBuffer(this.assets.get(key));
+            return;
+        }
+
+        // 2. Try to load if registered but not loaded
+        if (this.customSounds[key] && !this.assets.has(key)) {
+            await this.loadSound(key, this.customSounds[key]);
+            if (this.assets.has(key)) {
+                this._playBuffer(this.assets.get(key));
+                return;
+            }
+        }
+
+        // 3. Fallback to synth based on key name
+        // Map common keys to synth methods
+        const synthMap = {
+            'jump': () => this.playJump(true), // true = force synth
+            'score': () => this.playScore(true),
+            'success': () => this.playSuccess(true),
+            'click': () => this.playClick(true),
+            'error': () => this.playError(true),
+            'gameover': () => this.playGameOver(true)
+        };
+
+        if (synthMap[key]) {
+            synthMap[key]();
+        }
+    }
+
+    _playBuffer(buffer) {
+        const source = this.audioContext.createBufferSource();
+        source.buffer = buffer;
+        source.connect(this.audioContext.destination);
+        source.start(0);
+    }
+
     /**
      * Play a synthesized tone
-     * @param {number} frequency 
-     * @param {number} duration 
-     * @param {string} type - 'sine', 'square', 'sawtooth', 'triangle'
-     * @param {number} volume 
      */
     playTone(frequency, duration, type = 'sine', volume = 0.3) {
         if (this.muted) return;
@@ -55,35 +156,39 @@ export class SoundManager {
         oscillator.stop(this.audioContext.currentTime + duration);
     }
 
-    // --- Presets ---
+    // --- Presets (Synth) ---
 
-    playJump() {
+    playJump(force = false) {
+        if (!force && this.assets.has('jump')) return this.play('jump');
         this.playTone(400, 0.1, 'square', 0.2);
     }
 
-    playScore() {
+    playScore(force = false) {
+        if (!force && this.assets.has('score')) return this.play('score');
         this.playTone(800, 0.15, 'sine', 0.25);
         setTimeout(() => this.playTone(1000, 0.15, 'sine', 0.25), 50);
     }
 
-    playGameOver() {
+    playGameOver(force = false) {
+        if (!force && 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() {
+    playClick(force = false) {
+        if (!force && this.assets.has('click')) return this.play('click');
         this.playTone(600, 0.05, 'sine', 0.1);
     }
 
-    playSuccess() {
+    playSuccess(force = false) {
+        if (!force && 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() {
+    playError(force = false) {
+        if (!force && this.assets.has('error')) return this.play('error');
         this.playTone(200, 0.2, 'sawtooth', 0.3);
     }
 }
-
-export const soundManager = new SoundManager();

package/src/core/DataService.js

@@ -4,8 +4,9 @@
  */
 
 export class DataService {
-    constructor() {
-        this.storage = window.localStorage;
+    constructor(config = {}) {
+        this.storage = config.storage || window.localStorage;
+        this.prefix = config.prefix || 'dopamine_';
     }
 
     /**
@@ -16,7 +17,7 @@ export class DataService {
     async save(key, data) {
         try {
             const serialized = JSON.stringify(data);
-            this.storage.setItem(key, serialized);
+            this.storage.setItem(this.prefix + key, serialized);
             return true;
         } catch (e) {
             console.error('Error saving data:', e);
@@ -31,7 +32,7 @@ export class DataService {
      */
     async load(key, defaultValue = null) {
         try {
-            const data = this.storage.getItem(key);
+            const data = this.storage.getItem(this.prefix + key);
             return data ? JSON.parse(data) : defaultValue;
         } catch (e) {
             console.error('Error loading data:', e);
@@ -44,8 +45,6 @@ export class DataService {
      * @param {string} key 
      */
     async clear(key) {
-        this.storage.removeItem(key);
+        this.storage.removeItem(this.prefix + key);
     }
 }
-
-export const dataService = new DataService();

package/src/core/EventEmitter.js

@@ -0,0 +1,58 @@
+/**
+ * Simple Event Emitter implementation
+ */
+export class EventEmitter {
+    constructor() {
+        this.listeners = new Map();
+    }
+
+    /**
+     * Subscribe to an event
+     * @param {string} event - Event name
+     * @param {Function} callback - Callback function
+     * @returns {Function} Unsubscribe function
+     */
+    on(event, callback) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(callback);
+
+        return () => this.off(event, callback);
+    }
+
+    /**
+     * Unsubscribe from an event
+     * @param {string} event - Event name
+     * @param {Function} callback - Callback function
+     */
+    off(event, callback) {
+        if (this.listeners.has(event)) {
+            this.listeners.get(event).delete(callback);
+        }
+    }
+
+    /**
+     * Emit an event
+     * @param {string} event - Event name
+     * @param {*} data - Event data
+     */
+    emit(event, data) {
+        if (this.listeners.has(event)) {
+            this.listeners.get(event).forEach(callback => {
+                try {
+                    callback(data);
+                } catch (error) {
+                    console.error(`Error in listener for event '${event}':`, error);
+                }
+            });
+        }
+    }
+
+    /**
+     * Clear all listeners
+     */
+    clear() {
+        this.listeners.clear();
+    }
+}

package/src/core/RewardSystem.js

@@ -3,13 +3,14 @@
  * Manages achievements, XP, levels, streaks, and rewards
  */
 
-import { dataService } from './DataService.js';
+import { EventEmitter } from './EventEmitter.js';
 
-export class RewardSystem {
-    constructor() {
+export class RewardSystem extends EventEmitter {
+    constructor(dataService, config = {}) {
+        super();
+        this.dataService = dataService;
         this.player = null;
-        this.achievements = this._initAchievements();
-        this.listeners = [];
+        this.achievements = { ...this._initAchievements(), ...(config.achievements || {}) };
     }
 
     /**
@@ -17,7 +18,7 @@ export class RewardSystem {
      * @returns {Promise<Object>} Player data
      */
     async init() {
-        this.player = await dataService.load('player', this._getDefaultPlayer());
+        this.player = await this.dataService.load('player', this._getDefaultPlayer());
 
         // Check daily streak
         this._updateDailyStreak();
@@ -57,7 +58,7 @@ export class RewardSystem {
     async save() {
         if (this.player) {
             this.player.lastPlayedAt = Date.now();
-            await dataService.save('player', this.player);
+            await this.dataService.save('player', this.player);
         }
     }
 
@@ -82,10 +83,10 @@ export class RewardSystem {
         await this.save();
 
         // Notify listeners
-        this._emit('xp_gained', { amount, reason, leveledUp, newLevel });
+        this.emit('xp_gained', { amount, reason, leveledUp, newLevel });
 
         if (leveledUp) {
-            this._emit('level_up', { oldLevel, newLevel });
+            this.emit('level_up', { oldLevel, newLevel });
         }
 
         return { leveledUp, newLevel, xpGained: amount };
@@ -135,7 +136,7 @@ export class RewardSystem {
         // Update high score if applicable
         if (result.score !== undefined && result.score > stats.highScore) {
             stats.highScore = result.score;
-            this._emit('new_high_score', { gameName, score: result.score });
+            this.emit('new_high_score', { gameName, score: result.score });
         }
 
         // Merge other result data into stats
@@ -200,7 +201,7 @@ export class RewardSystem {
         // Award XP
         await this.addXP(achievement.xp, `Achievement: ${achievement.name}`);
 
-        this._emit('achievement_unlocked', achievement);
+        this.emit('achievement_unlocked', achievement);
         await this.save();
 
         return true;
@@ -292,19 +293,6 @@ export class RewardSystem {
         return yesterday.toISOString().split('T')[0];
     }
 
-    /**
-     * Event system for UI updates
-     */
-    on(event, callback) {
-        this.listeners.push({ event, callback });
-    }
-
-    _emit(event, data) {
-        this.listeners
-            .filter(l => l.event === event)
-            .forEach(l => l.callback(data));
-    }
-
     /**
      * Initialize achievement definitions
      * Can be extended by games
@@ -349,14 +337,4 @@ export class RewardSystem {
             }
         };
     }
-
-    /**
-     * Register custom achievements
-     * @param {Object} achievements 
-     */
-    registerAchievements(achievements) {
-        this.achievements = { ...this.achievements, ...achievements };
-    }
 }
-
-export const rewardSystem = new RewardSystem();

package/src/effects/ParticleSystem.js

@@ -4,21 +4,21 @@
  */
 
 export class ParticleSystem {
-    constructor(canvasId = 'dopamine-particle-canvas') {
-        this.canvasId = canvasId;
-        this.canvas = document.getElementById(canvasId);
+    constructor(config = {}) {
+        this.canvasId = config.canvasId || 'dopamine-particle-canvas';
+        this.canvas = document.getElementById(this.canvasId);
 
         if (!this.canvas) {
             // Create overlay canvas if it doesn't exist
             this.canvas = document.createElement('canvas');
-            this.canvas.id = canvasId;
+            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 = '9999';
+            this.canvas.style.zIndex = config.zIndex || '9999';
             document.body.appendChild(this.canvas);
         }
 
@@ -255,5 +255,3 @@ export class ParticleSystem {
         this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);
     }
 }
-
-export const particleSystem = new ParticleSystem();

package/src/index.js

@@ -1,25 +1,62 @@
-import { rewardSystem } from './core/RewardSystem.js';
-import { dataService } from './core/DataService.js';
-import { gameUI } from './ui/GameUI.js';
-import { particleSystem } from './effects/ParticleSystem.js';
-import { soundManager } from './audio/SoundManager.js';
+import { RewardSystem } from './core/RewardSystem.js';
+import { DataService } from './core/DataService.js';
+import { GameUI } from './ui/GameUI.js';
+import { ParticleSystem } from './effects/ParticleSystem.js';
+import { SoundManager } from './audio/SoundManager.js';
 import './ui/dopamine.css';
 
-export { rewardSystem, dataService, gameUI, particleSystem, soundManager };
+export { RewardSystem, DataService, GameUI, ParticleSystem, SoundManager };
 
 export default class Dopamine {
     constructor(config = {}) {
         this.config = config;
+
+        // Initialize subsystems with config
+        this.dataService = new DataService(config.data || {});
+        this.rewardSystem = new RewardSystem(this.dataService, config.rewards || {});
+        this.soundManager = new SoundManager(config.sound || {});
+        this.particleSystem = new ParticleSystem(config.particles || {});
+        this.gameUI = new GameUI(this.particleSystem);
+
+        // Bind UI to RewardSystem events
+        this._bindEvents();
     }
 
     async init() {
-        await rewardSystem.init();
+        await this.rewardSystem.init();
         console.log('DopamineJS Initialized 🚀');
         return {
-            rewardSystem,
-            gameUI,
-            particleSystem,
-            soundManager
+            rewardSystem: this.rewardSystem,
+            gameUI: this.gameUI,
+            particleSystem: this.particleSystem,
+            soundManager: this.soundManager
         };
     }
+
+    _bindEvents() {
+        this.rewardSystem.on('xp_gained', (data) => {
+            const { total, needed } = this.rewardSystem.getXPForNextLevel();
+            this.gameUI.updateXP(this.rewardSystem.player.xp, needed, total);
+
+            if (data.xpGained > 0) {
+                // Show floating text for XP gain
+                // We might need a way to know WHERE to show this, or just show it in a standard place
+                // For now, let's just update the bar
+            }
+        });
+
+        this.rewardSystem.on('level_up', (data) => {
+            this.gameUI.updateLevel(data.newLevel);
+            this.gameUI.showLevelUp(data.oldLevel, data.newLevel);
+        });
+
+        this.rewardSystem.on('achievement_unlocked', (achievement) => {
+            this.gameUI.showAchievement(achievement);
+        });
+
+        this.rewardSystem.on('new_high_score', (data) => {
+            this.gameUI.showNotification(`New High Score: ${data.score}!`, 'legendary');
+            this.soundManager.playSuccess();
+        });
+    }
 }