@nice2dev/game-engine 0.1.0

package/dist/cjs/audio/AudioManager.js

@@ -0,0 +1,248 @@
+'use strict';
+
+var EventBus = require('../core/EventBus.js');
+
+/* ────────────────────────────────────────────────────────────────
+   AudioManager — Web Audio API wrapper for games
+──────────────────────────────────────────────────────────────── */
+/* ── AudioManager ─────────────────────────────────────────────── */
+class AudioManager {
+    constructor() {
+        this.events = new EventBus.EventBus();
+        this.ctx = null;
+        this.masterGain = null;
+        this.channelGains = new Map();
+        this.bufferCache = new Map();
+        this.activeMusic = null;
+        this.activeSounds = new Set();
+        this.pool = [];
+        this._listenerPos = { x: 0, y: 0 };
+        this._muted = false;
+        // Volume settings
+        this.volumes = {
+            master: 1,
+            music: 0.7,
+            sfx: 1,
+            voice: 1,
+            ui: 0.8,
+        };
+    }
+    /* ── Lifecycle ──────────────────────────────────────────────── */
+    /** Initialize audio context (must be called after user gesture). */
+    init() {
+        if (this.ctx)
+            return;
+        this.ctx = new AudioContext();
+        this.masterGain = this.ctx.createGain();
+        this.masterGain.connect(this.ctx.destination);
+        // Create channel gains
+        const channels = ['music', 'sfx', 'voice', 'ui'];
+        for (const ch of channels) {
+            const gain = this.ctx.createGain();
+            gain.gain.value = this.volumes[ch];
+            gain.connect(this.masterGain);
+            this.channelGains.set(ch, gain);
+        }
+        this.masterGain.gain.value = this.volumes.master;
+    }
+    /** Ensure context is running (after autoplay policy). */
+    async resume() {
+        var _a;
+        if (((_a = this.ctx) === null || _a === void 0 ? void 0 : _a.state) === 'suspended') {
+            await this.ctx.resume();
+        }
+    }
+    dispose() {
+        var _a;
+        this.stopAll();
+        this.bufferCache.clear();
+        (_a = this.ctx) === null || _a === void 0 ? void 0 : _a.close();
+        this.ctx = null;
+    }
+    /* ── Loading ────────────────────────────────────────────────── */
+    /** Load an audio file and cache its buffer. */
+    async load(id, url) {
+        if (this.bufferCache.has(id))
+            return;
+        if (!this.ctx)
+            this.init();
+        const response = await fetch(url);
+        const arrayBuf = await response.arrayBuffer();
+        const audioBuffer = await this.ctx.decodeAudioData(arrayBuf);
+        this.bufferCache.set(id, audioBuffer);
+    }
+    /** Check if a sound is loaded. */
+    isLoaded(id) {
+        return this.bufferCache.has(id);
+    }
+    /* ── Play SFX ───────────────────────────────────────────────── */
+    /** Play a sound effect. Returns an ID to control it. */
+    play(id, options = {}) {
+        var _a, _b, _c, _d;
+        if (!this.ctx || !this.masterGain) {
+            if (typeof console !== 'undefined')
+                console.warn(`[AudioManager] play("${id}"): AudioContext not initialized. Call init() first.`);
+            return -1;
+        }
+        const buffer = this.bufferCache.get(id);
+        if (!buffer) {
+            if (typeof console !== 'undefined')
+                console.warn(`[AudioManager] play("${id}"): sound not loaded. Call loadSound() first.`);
+            return -1;
+        }
+        const channel = (_a = options.channel) !== null && _a !== void 0 ? _a : 'sfx';
+        const channelGain = this.channelGains.get(channel);
+        if (!channelGain)
+            return -1;
+        const source = this.ctx.createBufferSource();
+        source.buffer = buffer;
+        source.loop = (_b = options.loop) !== null && _b !== void 0 ? _b : false;
+        source.playbackRate.value = (_c = options.pitch) !== null && _c !== void 0 ? _c : 1;
+        // Volume
+        const volNode = this.ctx.createGain();
+        volNode.gain.value = (_d = options.volume) !== null && _d !== void 0 ? _d : 1;
+        // Pan
+        let panNode = null;
+        if (options.pan !== undefined) {
+            panNode = this.ctx.createStereoPanner();
+            panNode.pan.value = Math.max(-1, Math.min(1, options.pan));
+        }
+        // Chain: source → vol → [pan] → channel → master
+        source.connect(volNode);
+        if (panNode) {
+            volNode.connect(panNode);
+            panNode.connect(channelGain);
+        }
+        else {
+            volNode.connect(channelGain);
+        }
+        const soundId = nextSoundId++;
+        const active = {
+            id: soundId,
+            source,
+            gain: volNode,
+            channel,
+        };
+        source.onended = () => {
+            this.activeSounds.delete(active);
+        };
+        source.start();
+        this.activeSounds.add(active);
+        this.events.emit('sound:play', { id, soundId });
+        return soundId;
+    }
+    /** Stop a specific playing sound. */
+    stopSound(soundId) {
+        for (const snd of this.activeSounds) {
+            if (snd.id === soundId) {
+                snd.source.stop();
+                this.activeSounds.delete(snd);
+                break;
+            }
+        }
+    }
+    /* ── Music ──────────────────────────────────────────────────── */
+    /** Play background music with optional crossfade. */
+    playMusic(id, options = {}) {
+        var _a, _b, _c;
+        if (!this.ctx)
+            return;
+        const buffer = this.bufferCache.get(id);
+        if (!buffer)
+            return;
+        const fadeIn = (_a = options.fadeIn) !== null && _a !== void 0 ? _a : 1;
+        // Fade out current
+        if (this.activeMusic) {
+            this.fadeOutMusic(1);
+        }
+        const channelGain = this.channelGains.get('music');
+        if (!channelGain)
+            return;
+        const source = this.ctx.createBufferSource();
+        source.buffer = buffer;
+        source.loop = (_b = options.loop) !== null && _b !== void 0 ? _b : true;
+        const volNode = this.ctx.createGain();
+        volNode.gain.value = 0;
+        volNode.gain.linearRampToValueAtTime((_c = options.volume) !== null && _c !== void 0 ? _c : 1, this.ctx.currentTime + fadeIn);
+        source.connect(volNode);
+        volNode.connect(channelGain);
+        source.start();
+        this.activeMusic = { id, source, gain: volNode };
+        this.events.emit('music:play', id);
+    }
+    /** Stop music with fade out. */
+    stopMusic(fadeOut = 1) {
+        this.fadeOutMusic(fadeOut);
+    }
+    fadeOutMusic(fadeOut) {
+        if (!this.activeMusic || !this.ctx)
+            return;
+        const { source, gain } = this.activeMusic;
+        gain.gain.linearRampToValueAtTime(0, this.ctx.currentTime + fadeOut);
+        setTimeout(() => {
+            try {
+                source.stop();
+            }
+            catch ( /* already stopped */_a) { /* already stopped */ }
+        }, fadeOut * 1000 + 50);
+        this.activeMusic = null;
+    }
+    /* ── Volume Control ─────────────────────────────────────────── */
+    setVolume(channel, volume) {
+        volume = Math.max(0, Math.min(1, volume));
+        this.volumes[channel] = volume;
+        if (channel === 'master') {
+            if (this.masterGain)
+                this.masterGain.gain.value = volume;
+        }
+        else {
+            const gain = this.channelGains.get(channel);
+            if (gain)
+                gain.gain.value = volume;
+        }
+    }
+    getVolume(channel) {
+        return this.volumes[channel];
+    }
+    get muted() {
+        return this._muted;
+    }
+    set muted(value) {
+        this._muted = value;
+        if (this.masterGain) {
+            this.masterGain.gain.value = value ? 0 : this.volumes.master;
+        }
+    }
+    /* ── Spatial Audio ──────────────────────────────────────────── */
+    setListenerPosition(pos) {
+        this._listenerPos = pos;
+    }
+    /* ── Utility ────────────────────────────────────────────────── */
+    /** Stop all sounds and music, properly disconnecting audio nodes. */
+    stopAll() {
+        for (const snd of this.activeSounds) {
+            try {
+                snd.source.stop();
+            }
+            catch ( /* already stopped */_a) { /* already stopped */ }
+            try {
+                snd.source.disconnect();
+            }
+            catch ( /* already disconnected */_b) { /* already disconnected */ }
+            try {
+                snd.gain.disconnect();
+            }
+            catch ( /* already disconnected */_c) { /* already disconnected */ }
+        }
+        this.activeSounds.clear();
+        this.pool.length = 0;
+        this.fadeOutMusic(0);
+    }
+    get activeSoundCount() {
+        return this.activeSounds.size;
+    }
+}
+let nextSoundId = 1;
+
+exports.AudioManager = AudioManager;
+//# sourceMappingURL=AudioManager.js.map

package/dist/cjs/audio/AudioManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioManager.js","sources":["../../../src/audio/AudioManager.ts"],"sourcesContent":[null],"names":["EventBus"],"mappings":"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"}

package/dist/cjs/core/EventBus.js

@@ -0,0 +1,63 @@
+'use strict';
+
+/* ────────────────────────────────────────────────────────────────
+   EventBus — Typed publish/subscribe event system
+──────────────────────────────────────────────────────────────── */
+class EventBus {
+    constructor() {
+        this.handlers = new Map();
+    }
+    /** Subscribe to an event. Returns unsubscribe function. */
+    on(event, handler) {
+        let set = this.handlers.get(event);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(event, set);
+        }
+        set.add(handler);
+        return () => this.off(event, handler);
+    }
+    /** Subscribe once — auto-removes after first call. */
+    once(event, handler) {
+        const wrapper = (data) => {
+            this.off(event, wrapper);
+            handler(data);
+        };
+        return this.on(event, wrapper);
+    }
+    /** Unsubscribe from an event. */
+    off(event, handler) {
+        const set = this.handlers.get(event);
+        if (set) {
+            set.delete(handler);
+            if (set.size === 0)
+                this.handlers.delete(event);
+        }
+    }
+    /** Emit an event to all subscribers. */
+    emit(event, data) {
+        const set = this.handlers.get(event);
+        if (set) {
+            for (const handler of set) {
+                handler(data);
+            }
+        }
+    }
+    /** Remove all handlers for an event, or all events if no arg. */
+    clear(event) {
+        if (event) {
+            this.handlers.delete(event);
+        }
+        else {
+            this.handlers.clear();
+        }
+    }
+    /** Check if an event has any listeners. */
+    has(event) {
+        const set = this.handlers.get(event);
+        return set != null && set.size > 0;
+    }
+}
+
+exports.EventBus = EventBus;
+//# sourceMappingURL=EventBus.js.map

package/dist/cjs/core/EventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.js","sources":["../../../src/core/EventBus.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;AAEmE;MAItD,QAAQ,CAAA;AAArB,IAAA,WAAA,GAAA;AACU,QAAA,IAAA,CAAA,QAAQ,GAAG,IAAI,GAAG,EAAsC;IAuDlE;;IApDE,EAAE,CAAc,KAAa,EAAE,OAAwB,EAAA;QACrD,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE;AACR,YAAA,GAAG,GAAG,IAAI,GAAG,EAAE;YACf,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;QAC/B;AACA,QAAA,GAAG,CAAC,GAAG,CAAC,OAAgC,CAAC;QACzC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC;IACvC;;IAGA,IAAI,CAAc,KAAa,EAAE,OAAwB,EAAA;AACvD,QAAA,MAAM,OAAO,GAAoB,CAAC,IAAI,KAAI;AACxC,YAAA,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC;AACf,QAAA,CAAC;QACD,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;IAChC;;IAGA,GAAG,CAAc,KAAa,EAAE,OAAwB,EAAA;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QACpC,IAAI,GAAG,EAAE;AACP,YAAA,GAAG,CAAC,MAAM,CAAC,OAAgC,CAAC;AAC5C,YAAA,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;AAAE,gBAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;QACjD;IACF;;IAGA,IAAI,CAAc,KAAa,EAAE,IAAO,EAAA;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QACpC,IAAI,GAAG,EAAE;AACP,YAAA,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE;gBACzB,OAAO,CAAC,IAAI,CAAC;YACf;QACF;IACF;;AAGA,IAAA,KAAK,CAAC,KAAc,EAAA;QAClB,IAAI,KAAK,EAAE;AACT,YAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7B;aAAO;AACL,YAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;QACvB;IACF;;AAGA,IAAA,GAAG,CAAC,KAAa,EAAA;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QACpC,OAAO,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC;IACpC;AACD;;;;"}

package/dist/cjs/core/GameClock.js

@@ -0,0 +1,70 @@
+'use strict';
+
+/* ────────────────────────────────────────────────────────────────
+   GameClock — High-precision game timing
+──────────────────────────────────────────────────────────────── */
+class GameClock {
+    constructor(fixedFps = 60) {
+        this._startTime = 0;
+        this._elapsed = 0;
+        this._delta = 0;
+        this._frame = 0;
+        this._timeScale = 1;
+        this._paused = false;
+        this._fixedDelta = 1 / fixedFps;
+        this._startTime = performance.now() / 1000;
+    }
+    /* ── Getters ────────────────────────────────────────────────── */
+    /** Total elapsed time in seconds (affected by timeScale) */
+    get elapsed() {
+        return this._elapsed;
+    }
+    /** Delta time for current frame in seconds */
+    get delta() {
+        return this._delta;
+    }
+    /** Fixed timestep for physics */
+    get fixedDelta() {
+        return this._fixedDelta;
+    }
+    /** Current frame number */
+    get frame() {
+        return this._frame;
+    }
+    /** Time scale multiplier (0 = frozen, 1 = normal, 2 = 2x) */
+    get timeScale() {
+        return this._timeScale;
+    }
+    set timeScale(value) {
+        this._timeScale = Math.max(0, value);
+    }
+    get paused() {
+        return this._paused;
+    }
+    /** Real time since start in seconds (unaffected by timeScale) */
+    get realTime() {
+        return performance.now() / 1000 - this._startTime;
+    }
+    /* ── Methods ────────────────────────────────────────────────── */
+    /** Called each frame with raw delta */
+    tick(rawDelta) {
+        this._delta = this._paused ? 0 : rawDelta * this._timeScale;
+        this._elapsed += this._delta;
+        this._frame++;
+    }
+    pause() {
+        this._paused = true;
+    }
+    resume() {
+        this._paused = false;
+    }
+    reset() {
+        this._elapsed = 0;
+        this._delta = 0;
+        this._frame = 0;
+        this._startTime = performance.now() / 1000;
+    }
+}
+
+exports.GameClock = GameClock;
+//# sourceMappingURL=GameClock.js.map

package/dist/cjs/core/GameClock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameClock.js","sources":["../../../src/core/GameClock.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;AAEmE;MAEtD,SAAS,CAAA;IASpB,WAAA,CAAY,QAAQ,GAAG,EAAE,EAAA;QARjB,IAAA,CAAA,UAAU,GAAG,CAAC;QACd,IAAA,CAAA,QAAQ,GAAG,CAAC;QACZ,IAAA,CAAA,MAAM,GAAG,CAAC;QACV,IAAA,CAAA,MAAM,GAAG,CAAC;QACV,IAAA,CAAA,UAAU,GAAG,CAAC;QACd,IAAA,CAAA,OAAO,GAAG,KAAK;AAIrB,QAAA,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,QAAQ;QAC/B,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI;IAC5C;;;AAKA,IAAA,IAAI,OAAO,GAAA;QACT,OAAO,IAAI,CAAC,QAAQ;IACtB;;AAGA,IAAA,IAAI,KAAK,GAAA;QACP,OAAO,IAAI,CAAC,MAAM;IACpB;;AAGA,IAAA,IAAI,UAAU,GAAA;QACZ,OAAO,IAAI,CAAC,WAAW;IACzB;;AAGA,IAAA,IAAI,KAAK,GAAA;QACP,OAAO,IAAI,CAAC,MAAM;IACpB;;AAGA,IAAA,IAAI,SAAS,GAAA;QACX,OAAO,IAAI,CAAC,UAAU;IACxB;IAEA,IAAI,SAAS,CAAC,KAAa,EAAA;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC;IACtC;AAEA,IAAA,IAAI,MAAM,GAAA;QACR,OAAO,IAAI,CAAC,OAAO;IACrB;;AAGA,IAAA,IAAI,QAAQ,GAAA;QACV,OAAO,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,UAAU;IACnD;;;AAKA,IAAA,IAAI,CAAC,QAAgB,EAAA;AACnB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC,UAAU;AAC3D,QAAA,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM;QAC5B,IAAI,CAAC,MAAM,EAAE;IACf;IAEA,KAAK,GAAA;AACH,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI;IACrB;IAEA,MAAM,GAAA;AACJ,QAAA,IAAI,CAAC,OAAO,GAAG,KAAK;IACtB;IAEA,KAAK,GAAA;AACH,QAAA,IAAI,CAAC,QAAQ,GAAG,CAAC;AACjB,QAAA,IAAI,CAAC,MAAM,GAAG,CAAC;AACf,QAAA,IAAI,CAAC,MAAM,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI;IAC5C;AACD;;;;"}

package/dist/cjs/core/GameConfig.js

@@ -0,0 +1,86 @@
+'use strict';
+
+/* ────────────────────────────────────────────────────────────────
+   GameConfig — Global game configuration
+──────────────────────────────────────────────────────────────── */
+const WHITE = { r: 1, g: 1, b: 1, a: 1 };
+const DEFAULT_PHYSICS = {
+    gravity: { x: 0, y: 980 },
+    fixedTimestep: 1 / 60,
+    velocityIterations: 8,
+    positionIterations: 3,
+};
+const DEFAULT_AUDIO = {
+    masterVolume: 1,
+    musicVolume: 0.7,
+    sfxVolume: 1,
+    voiceVolume: 1,
+};
+const DEFAULT_RENDERING = {
+    pixelPerfect: false,
+    antiAlias: true,
+    backgroundColor: WHITE,
+};
+const DEFAULT_SETTINGS = {
+    width: 1280,
+    height: 720,
+    targetFps: 60,
+    maxPlayers: 4,
+    physics: { ...DEFAULT_PHYSICS },
+    audio: { ...DEFAULT_AUDIO },
+    rendering: { ...DEFAULT_RENDERING },
+};
+class GameConfig {
+    constructor(overrides) {
+        this._settings = mergeSettings(DEFAULT_SETTINGS, overrides !== null && overrides !== void 0 ? overrides : {});
+    }
+    get settings() {
+        return this._settings;
+    }
+    get width() { return this._settings.width; }
+    get height() { return this._settings.height; }
+    get targetFps() { return this._settings.targetFps; }
+    get maxPlayers() { return this._settings.maxPlayers; }
+    get physics() { return this._settings.physics; }
+    get audio() { return this._settings.audio; }
+    get rendering() { return this._settings.rendering; }
+    update(overrides) {
+        this._settings = mergeSettings(this._settings, overrides);
+    }
+    toJSON() {
+        return structuredClone(this._settings);
+    }
+    static fromJSON(json) {
+        return new GameConfig(json);
+    }
+}
+/* ── Deep merge utility ───────────────────────────────────────── */
+/** Type-safe deep merge wrapper — returns T preserving the original shape. */
+function mergeSettings(target, source) {
+    return mergeDeepRaw(target, source);
+}
+function mergeDeepRaw(target, source) {
+    const result = { ...target };
+    const src = source;
+    for (const key of Object.keys(src)) {
+        const sv = src[key];
+        const tv = result[key];
+        if (isPlainObject(sv) && isPlainObject(tv)) {
+            result[key] = mergeDeepRaw(tv, sv);
+        }
+        else if (sv !== undefined) {
+            result[key] = sv;
+        }
+    }
+    return result;
+}
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+
+exports.DEFAULT_AUDIO = DEFAULT_AUDIO;
+exports.DEFAULT_PHYSICS = DEFAULT_PHYSICS;
+exports.DEFAULT_RENDERING = DEFAULT_RENDERING;
+exports.DEFAULT_SETTINGS = DEFAULT_SETTINGS;
+exports.GameConfig = GameConfig;
+//# sourceMappingURL=GameConfig.js.map

package/dist/cjs/core/GameConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameConfig.js","sources":["../../../src/core/GameConfig.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/cjs/core/GameLoop.js

@@ -0,0 +1,93 @@
+'use strict';
+
+/* ────────────────────────────────────────────────────────────────
+   GameLoop — requestAnimationFrame loop with fixed & variable timestep
+──────────────────────────────────────────────────────────────── */
+class GameLoop {
+    constructor(callbacks) {
+        this.callbacks = callbacks;
+        this._running = false;
+        this._rafId = 0;
+        this._lastTime = 0;
+        this._accumulator = 0;
+        this._frameCount = 0;
+        this._fpsTime = 0;
+        this._fps = 0;
+        this._timeScale = 1;
+        this.fixedTimestep = 1 / 60; // 60 Hz fixed update
+        this.maxDelta = 0.1; // clamp to prevent spiral of death
+        /* ── Internal ───────────────────────────────────────────────── */
+        this.tick = (nowMs) => {
+            if (!this._running)
+                return;
+            this._rafId = requestAnimationFrame(this.tick);
+            const now = nowMs / 1000;
+            let dt = (now - this._lastTime) * this._timeScale;
+            this._lastTime = now;
+            // Clamp large deltas (e.g. tab was in background)
+            if (dt > this.maxDelta)
+                dt = this.maxDelta;
+            // Fixed timestep accumulator
+            this._accumulator += dt;
+            while (this._accumulator >= this.fixedTimestep) {
+                this.callbacks.fixedUpdate(this.fixedTimestep);
+                this._accumulator -= this.fixedTimestep;
+            }
+            // Variable update
+            this.callbacks.update(dt);
+            // Render with interpolation factor
+            const interpolation = this._accumulator / this.fixedTimestep;
+            this.callbacks.render(interpolation);
+            // FPS counter
+            this._frameCount++;
+            if (now - this._fpsTime >= 1) {
+                this._fps = this._frameCount / (now - this._fpsTime);
+                this._frameCount = 0;
+                this._fpsTime = now;
+            }
+        };
+    }
+    /* ── Public API ─────────────────────────────────────────────── */
+    get running() {
+        return this._running;
+    }
+    get fps() {
+        return this._fps;
+    }
+    get frameCount() {
+        return this._frameCount;
+    }
+    get timeScale() {
+        return this._timeScale;
+    }
+    set timeScale(v) {
+        this._timeScale = Math.max(0, v);
+    }
+    start() {
+        if (this._running)
+            return;
+        this._running = true;
+        this._lastTime = performance.now() / 1000;
+        this._accumulator = 0;
+        this._fpsTime = this._lastTime;
+        this._frameCount = 0;
+        this._rafId = requestAnimationFrame(this.tick);
+    }
+    stop() {
+        this._running = false;
+        if (this._rafId) {
+            cancelAnimationFrame(this._rafId);
+            this._rafId = 0;
+        }
+    }
+    /** Run a single frame manually (for step-debug) */
+    stepFrame(dt = this.fixedTimestep) {
+        this.callbacks.fixedUpdate(dt);
+        this.callbacks.update(dt);
+        this.callbacks.render(1);
+        this._frameCount++;
+    }
+}
+
+exports.GameLoop = GameLoop;
+//# sourceMappingURL=GameLoop.js.map

package/dist/cjs/core/GameLoop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameLoop.js","sources":["../../../src/core/GameLoop.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/cjs/core/ServiceLocator.js

@@ -0,0 +1,73 @@
+'use strict';
+
+/* ────────────────────────────────────────────────────────────────
+   ServiceLocator — Dependency injection container
+──────────────────────────────────────────────────────────────── */
+class ServiceLocator {
+    constructor() {
+        this.services = new Map();
+    }
+    static get instance() {
+        if (!ServiceLocator._instance) {
+            ServiceLocator._instance = new ServiceLocator();
+        }
+        return ServiceLocator._instance;
+    }
+    /** Register a service by key. */
+    register(key, service) {
+        this.services.set(key, service);
+    }
+    /** Retrieve a service by key. Throws if not registered. */
+    get(key) {
+        const svc = this.services.get(key);
+        if (svc === undefined) {
+            throw new Error(`[ServiceLocator] Service "${key}" not registered.`);
+        }
+        return svc;
+    }
+    /** Retrieve a service, or undefined if not registered. */
+    tryGet(key) {
+        return this.services.get(key);
+    }
+    /** Check if a service is registered. */
+    has(key) {
+        return this.services.has(key);
+    }
+    /** Remove a service. */
+    unregister(key) {
+        return this.services.delete(key);
+    }
+    /** Remove all services. */
+    clear() {
+        this.services.clear();
+    }
+    /** Reset static singleton (for testing). */
+    static reset() {
+        var _a;
+        (_a = ServiceLocator._instance) === null || _a === void 0 ? void 0 : _a.clear();
+        ServiceLocator._instance = null;
+    }
+}
+ServiceLocator._instance = null;
+/* ── Convenience service keys ─────────────────────────────────── */
+const SERVICE_KEYS = {
+    CONFIG: 'GameConfig',
+    CLOCK: 'GameClock',
+    LOOP: 'GameLoop',
+    EVENTS: 'EventBus',
+    EVENT_BUS: 'EventBus',
+    INPUT: 'InputManager',
+    AUDIO: 'AudioManager',
+    RENDERER: 'Renderer2D',
+    CAMERA: 'Camera2D',
+    PHYSICS: 'PhysicsEngine',
+    SCENES: 'SceneManager',
+    SCENE_MANAGER: 'SceneManager',
+    PLAYERS: 'PlayerManager',
+    PLAYER_MANAGER: 'PlayerManager',
+    WORLD: 'World',
+};
+
+exports.SERVICE_KEYS = SERVICE_KEYS;
+exports.ServiceLocator = ServiceLocator;
+//# sourceMappingURL=ServiceLocator.js.map