@nice2dev/game-engine 0.1.0

package/dist/esm/monetization/Monetization.js

@@ -0,0 +1,186 @@
+/* ────────────────────────────────────────────────────────────────
+   EPIC E9 — Monetization Tools
+   
+   In-app purchases, ad mediation, analytics, A/B testing,
+   leaderboards, cloud saves
+──────────────────────────────────────────────────────────────── */
+function getActiveSubscriptions(store, now) {
+    return store.purchaseHistory.filter(p => p.state === 'purchased' &&
+        store.products.some(prod => prod.id === p.productId && prod.type === 'subscription') &&
+        (!p.expiresAt || p.expiresAt > now));
+}
+function hasProduct(store, productId) {
+    return store.purchaseHistory.some(p => p.productId === productId && p.state === 'purchased' && p.verified);
+}
+function getBalance(wallet, currencyId) {
+    var _a;
+    const entry = wallet.entries.find(e => e.currencyId === currencyId);
+    return (_a = entry === null || entry === void 0 ? void 0 : entry.balance) !== null && _a !== void 0 ? _a : 0;
+}
+function modifyBalance(wallet, currencyId, amount, maxBalance = Infinity) {
+    let entry = wallet.entries.find(e => e.currencyId === currencyId);
+    if (!entry) {
+        entry = { currencyId, balance: 0 };
+        wallet.entries.push(entry);
+    }
+    const newBalance = entry.balance + amount;
+    if (newBalance < 0)
+        return false;
+    entry.balance = Math.min(newBalance, maxBalance);
+    return true;
+}
+class AnalyticsBuffer {
+    constructor(config) {
+        this.events = [];
+        this.flushCallback = null;
+        this.config = config;
+    }
+    onFlush(callback) {
+        this.flushCallback = callback;
+    }
+    track(type, name, params = {}) {
+        if (!this.config.enabled)
+            return;
+        if (this.config.sampleRate < 1 && Math.random() > this.config.sampleRate)
+            return;
+        this.events.push({
+            type,
+            name,
+            timestamp: Date.now(),
+            sessionId: '',
+            params,
+        });
+        if (this.events.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    flush() {
+        var _a;
+        if (this.events.length === 0)
+            return;
+        const batch = this.events.splice(0);
+        (_a = this.flushCallback) === null || _a === void 0 ? void 0 : _a.call(this, batch);
+    }
+    getBufferSize() {
+        return this.events.length;
+    }
+}
+/** Deterministic assignment based on userId hash. */
+function assignVariant(test, userId) {
+    let hash = 0;
+    const key = test.id + userId;
+    for (let i = 0; i < key.length; i++) {
+        hash = ((hash << 5) - hash + key.charCodeAt(i)) | 0;
+    }
+    const normalized = Math.abs(hash) / 0x7FFFFFFF;
+    let cumulative = 0;
+    for (const variant of test.variants) {
+        cumulative += variant.weight;
+        if (normalized <= cumulative)
+            return variant;
+    }
+    return test.variants[test.variants.length - 1];
+}
+function insertScore(entries, newEntry, sort, maxEntries) {
+    const result = [...entries];
+    result.push(newEntry);
+    result.sort((a, b) => sort === 'highest' ? b.score - a.score : a.score - b.score);
+    if (result.length > maxEntries)
+        result.length = maxEntries;
+    for (let i = 0; i < result.length; i++)
+        result[i].rank = i + 1;
+    return result;
+}
+function formatLeaderboardScore(score, format) {
+    switch (format) {
+        case 'integer': return Math.floor(score).toLocaleString();
+        case 'decimal': return score.toFixed(2);
+        case 'time': {
+            const totalSec = Math.floor(score / 1000);
+            const ms = score % 1000;
+            const min = Math.floor(totalSec / 60);
+            const sec = totalSec % 60;
+            return `${min}:${sec.toString().padStart(2, '0')}.${ms.toString().padStart(3, '0')}`;
+        }
+        default: return String(score);
+    }
+}
+/** Simple checksum for save integrity. */
+function computeChecksum(data) {
+    let hash = 0;
+    for (let i = 0; i < data.length; i++) {
+        hash = ((hash << 5) - hash + data.charCodeAt(i)) | 0;
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+class AchievementTracker {
+    constructor() {
+        this.definitions = new Map();
+        this.progress = new Map();
+    }
+    registerAchievement(def) {
+        this.definitions.set(def.id, def);
+        if (!this.progress.has(def.id)) {
+            this.progress.set(def.id, { achievementId: def.id, unlocked: false, progress: 0 });
+        }
+    }
+    incrementProgress(achievementId, amount = 1) {
+        var _a, _b;
+        const def = this.definitions.get(achievementId);
+        const prog = this.progress.get(achievementId);
+        if (!def || !prog || prog.unlocked)
+            return false;
+        prog.progress = Math.min(prog.progress + amount, (_a = def.maxProgress) !== null && _a !== void 0 ? _a : 1);
+        if (prog.progress >= ((_b = def.maxProgress) !== null && _b !== void 0 ? _b : 1)) {
+            prog.unlocked = true;
+            prog.unlockedAt = Date.now();
+            return true; // Newly unlocked
+        }
+        return false;
+    }
+    unlock(achievementId) {
+        var _a;
+        const prog = this.progress.get(achievementId);
+        if (!prog || prog.unlocked)
+            return false;
+        const def = this.definitions.get(achievementId);
+        if (!def)
+            return false;
+        prog.unlocked = true;
+        prog.progress = (_a = def.maxProgress) !== null && _a !== void 0 ? _a : 1;
+        prog.unlockedAt = Date.now();
+        return true;
+    }
+    isUnlocked(achievementId) {
+        var _a, _b;
+        return (_b = (_a = this.progress.get(achievementId)) === null || _a === void 0 ? void 0 : _a.unlocked) !== null && _b !== void 0 ? _b : false;
+    }
+    getProgress(achievementId) {
+        return this.progress.get(achievementId);
+    }
+    getUnlockedCount() {
+        let count = 0;
+        this.progress.forEach(p => { if (p.unlocked)
+            count++; });
+        return count;
+    }
+    getTotalPoints() {
+        let total = 0;
+        this.progress.forEach((p, id) => {
+            if (p.unlocked) {
+                const def = this.definitions.get(id);
+                if (def)
+                    total += def.points;
+            }
+        });
+        return total;
+    }
+    getAllProgress() {
+        const result = [];
+        this.progress.forEach(p => result.push(p));
+        return result;
+    }
+}
+
+export { AchievementTracker, AnalyticsBuffer, assignVariant, computeChecksum, formatLeaderboardScore, getActiveSubscriptions, getBalance, hasProduct, insertScore, modifyBalance };
+//# sourceMappingURL=Monetization.js.map

package/dist/esm/monetization/Monetization.js.map

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

package/dist/esm/multiplayer/LocalMultiplayer.js

@@ -0,0 +1,284 @@
+import { EventBus } from '../core/EventBus.js';
+
+/* ────────────────────────────────────────────────────────────────
+   Multiplayer Local — SplitScreen, PlayerManager, drop-in/out
+──────────────────────────────────────────────────────────────── */
+/* ── Player Manager ───────────────────────────────────────────── */
+class PlayerManager {
+    constructor(maxPlayers = 4) {
+        this.events = new EventBus();
+        this.players = new Map();
+        this.maxPlayers = maxPlayers;
+    }
+    get activeCount() {
+        let n = 0;
+        for (const p of this.players.values())
+            if (p.active)
+                n++;
+        return n;
+    }
+    getPlayer(index) {
+        return this.players.get(index);
+    }
+    get allPlayers() {
+        return Array.from(this.players.values());
+    }
+    get activePlayers() {
+        return this.allPlayers.filter(p => p.active);
+    }
+    /* ── Drop-in / Drop-out ─────────────────────────────────────── */
+    join(config) {
+        var _a;
+        if (this.players.has(config.index))
+            return null;
+        if (this.players.size >= this.maxPlayers)
+            return null;
+        const player = {
+            index: config.index,
+            name: config.name || `Player ${config.index + 1}`,
+            color: config.color,
+            inputDevice: config.inputDevice === 'gamepad' ? 'gamepad' : 'keyboard',
+            gamepadIndex: (_a = config.gamepadIndex) !== null && _a !== void 0 ? _a : config.index,
+            score: 0,
+            lives: 3,
+            active: true,
+            entityId: null,
+        };
+        this.players.set(config.index, player);
+        this.events.emit('player:join', player);
+        return player;
+    }
+    leave(index) {
+        const p = this.players.get(index);
+        if (!p)
+            return;
+        p.active = false;
+        this.events.emit('player:leave', p);
+        this.players.delete(index);
+    }
+    /** Quick setup for single player (keyboard). */
+    setupSingle() {
+        this.clear();
+        return this.join({
+            index: 0,
+            name: 'Player 1',
+            color: PLAYER_COLORS[0],
+            inputDevice: 'keyboard',
+        });
+    }
+    /** Quick setup for local multiplayer. */
+    setupLocal(count) {
+        this.clear();
+        const players = [];
+        for (let i = 0; i < Math.min(count, this.maxPlayers); i++) {
+            const p = this.join({
+                index: i,
+                name: `Player ${i + 1}`,
+                color: PLAYER_COLORS[i % PLAYER_COLORS.length],
+                inputDevice: i === 0 ? 'keyboard' : 'gamepad',
+                gamepadIndex: i > 0 ? i - 1 : undefined,
+            });
+            if (p)
+                players.push(p);
+        }
+        return players;
+    }
+    clear() {
+        this.players.clear();
+    }
+}
+class SplitScreenManager {
+    constructor() {
+        this._mode = 'shared';
+        this._canvasWidth = 1280;
+        this._canvasHeight = 720;
+        this.viewports = [];
+    }
+    get mode() {
+        return this._mode;
+    }
+    /** Set screen dimensions (usually from canvas). */
+    setCanvasSize(w, h) {
+        this._canvasWidth = w;
+        this._canvasHeight = h;
+        this.rebuildViewports();
+    }
+    /** Configure split mode for N active players. */
+    configure(players, preferredMode) {
+        const count = players.filter(p => p.active).length;
+        if (preferredMode) {
+            this._mode = preferredMode;
+        }
+        else {
+            // Auto-detect best layout
+            if (count <= 1)
+                this._mode = 'shared';
+            else if (count === 2)
+                this._mode = 'split-vertical';
+            else if (count <= 4)
+                this._mode = 'split-quad';
+            else if (count <= 6)
+                this._mode = 'split-6';
+            else if (count <= 9)
+                this._mode = 'split-9';
+            else
+                this._mode = 'split-12';
+        }
+        this.rebuildViewports();
+    }
+    buildGrid(cols, rows, maxSlots) {
+        const w = this._canvasWidth;
+        const h = this._canvasHeight;
+        const cw = 1 / cols;
+        const ch = 1 / rows;
+        const pw = w / cols;
+        const ph = h / rows;
+        for (let i = 0; i < maxSlots; i++) {
+            const col = i % cols;
+            const row = Math.floor(i / cols);
+            this.viewports.push({
+                playerIndex: i,
+                rect: { x: col * cw, y: row * ch, width: cw, height: ch },
+                pixelRect: { x: Math.round(col * pw), y: Math.round(row * ph), width: Math.round(pw), height: Math.round(ph) },
+            });
+        }
+    }
+    rebuildViewports() {
+        this.viewports = [];
+        const w = this._canvasWidth;
+        const h = this._canvasHeight;
+        switch (this._mode) {
+            case 'shared':
+                this.viewports.push({
+                    playerIndex: -1,
+                    rect: { x: 0, y: 0, width: 1, height: 1 },
+                    pixelRect: { x: 0, y: 0, width: w, height: h },
+                });
+                break;
+            case 'split-horizontal':
+                this.viewports.push({
+                    playerIndex: 0,
+                    rect: { x: 0, y: 0, width: 1, height: 0.5 },
+                    pixelRect: { x: 0, y: 0, width: w, height: h / 2 },
+                }, {
+                    playerIndex: 1,
+                    rect: { x: 0, y: 0.5, width: 1, height: 0.5 },
+                    pixelRect: { x: 0, y: h / 2, width: w, height: h / 2 },
+                });
+                break;
+            case 'split-vertical':
+                this.viewports.push({
+                    playerIndex: 0,
+                    rect: { x: 0, y: 0, width: 0.5, height: 1 },
+                    pixelRect: { x: 0, y: 0, width: w / 2, height: h },
+                }, {
+                    playerIndex: 1,
+                    rect: { x: 0.5, y: 0, width: 0.5, height: 1 },
+                    pixelRect: { x: w / 2, y: 0, width: w / 2, height: h },
+                });
+                break;
+            case 'split-quad':
+                this.buildGrid(2, 2, 4);
+                break;
+            case 'split-6':
+                this.buildGrid(3, 2, 6);
+                break;
+            case 'split-9':
+                this.buildGrid(3, 3, 9);
+                break;
+            case 'split-12':
+                this.buildGrid(4, 3, 12);
+                break;
+        }
+    }
+    getViewports() {
+        return this.viewports;
+    }
+    getViewportForPlayer(playerIndex) {
+        return this.viewports.find(v => v.playerIndex === playerIndex);
+    }
+    /** Apply viewport clip/transform to Canvas 2D context before rendering a player's view. */
+    applyViewport(ctx, viewport) {
+        const r = viewport.pixelRect;
+        ctx.save();
+        ctx.beginPath();
+        ctx.rect(r.x, r.y, r.width, r.height);
+        ctx.clip();
+        ctx.translate(r.x, r.y);
+    }
+    /** Restore context after rendering a viewport. */
+    restoreViewport(ctx) {
+        ctx.restore();
+    }
+    /** Render divider lines between viewports. */
+    renderDividers(ctx, lineColor = '#333', lineWidth = 2) {
+        if (this._mode === 'shared')
+            return;
+        ctx.save();
+        ctx.strokeStyle = lineColor;
+        ctx.lineWidth = lineWidth;
+        const w = this._canvasWidth;
+        const h = this._canvasHeight;
+        const gridSpec = this.getGridSpec();
+        if (gridSpec) {
+            const { cols, rows } = gridSpec;
+            // Vertical dividers
+            for (let c = 1; c < cols; c++) {
+                const x = Math.round(w * c / cols);
+                ctx.beginPath();
+                ctx.moveTo(x, 0);
+                ctx.lineTo(x, h);
+                ctx.stroke();
+            }
+            // Horizontal dividers
+            for (let r = 1; r < rows; r++) {
+                const y = Math.round(h * r / rows);
+                ctx.beginPath();
+                ctx.moveTo(0, y);
+                ctx.lineTo(w, y);
+                ctx.stroke();
+            }
+        }
+        else if (this._mode === 'split-vertical') {
+            ctx.beginPath();
+            ctx.moveTo(w / 2, 0);
+            ctx.lineTo(w / 2, h);
+            ctx.stroke();
+        }
+        else if (this._mode === 'split-horizontal') {
+            ctx.beginPath();
+            ctx.moveTo(0, h / 2);
+            ctx.lineTo(w, h / 2);
+            ctx.stroke();
+        }
+        ctx.restore();
+    }
+    /** Get cols/rows for grid-based layouts. */
+    getGridSpec() {
+        switch (this._mode) {
+            case 'split-quad': return { cols: 2, rows: 2 };
+            case 'split-6': return { cols: 3, rows: 2 };
+            case 'split-9': return { cols: 3, rows: 3 };
+            case 'split-12': return { cols: 4, rows: 3 };
+            default: return null;
+        }
+    }
+}
+/* ── Default player colors ────────────────────────────────────── */
+const PLAYER_COLORS = [
+    { r: 0.2, g: 0.5, b: 1, a: 1 }, // P1  blue
+    { r: 1, g: 0.3, b: 0.3, a: 1 }, // P2  red
+    { r: 0.2, g: 0.9, b: 0.3, a: 1 }, // P3  green
+    { r: 1, g: 0.8, b: 0.1, a: 1 }, // P4  yellow
+    { r: 0.8, g: 0.2, b: 0.9, a: 1 }, // P5  purple
+    { r: 1, g: 0.5, b: 0.1, a: 1 }, // P6  orange
+    { r: 0.1, g: 0.9, b: 0.9, a: 1 }, // P7  cyan
+    { r: 1, g: 0.4, b: 0.7, a: 1 }, // P8  pink
+    { r: 0.6, g: 0.4, b: 0.2, a: 1 }, // P9  brown
+    { r: 0.7, g: 0.7, b: 0.7, a: 1 }, // P10 silver
+    { r: 0.5, g: 1, b: 0.5, a: 1 }, // P11 lime
+    { r: 0.9, g: 0.9, b: 0.3, a: 1 }, // P12 gold
+];
+
+export { PLAYER_COLORS, PlayerManager, SplitScreenManager };
+//# sourceMappingURL=LocalMultiplayer.js.map

package/dist/esm/multiplayer/LocalMultiplayer.js.map

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

package/dist/esm/multiplayer/MiniGameTypes.js

@@ -0,0 +1,60 @@
+/**
+ * Mini-game types and registry for couch/online mini-game collections.
+ */
+const MINI_PLAYER_COLORS = [
+    "#e74c3c", "#3498db", "#2ecc71", "#f1c40f",
+    "#9b59b6", "#e67e22", "#1abc9c", "#e91e63",
+];
+const MINI_PLAYER_NAMES = [
+    "Player 1", "Player 2", "Player 3", "Player 4",
+    "Player 5", "Player 6", "Player 7", "Player 8",
+];
+const DIR_UP = { dx: 0, dy: -1 };
+const DIR_DOWN = { dx: 0, dy: 1 };
+const DIR_LEFT = { dx: -1, dy: 0 };
+const DIR_RIGHT = { dx: 1, dy: 0 };
+const KEYBOARD_GROUPS = [
+    { up: "w", down: "s", left: "a", right: "d", action: " " },
+    { up: "ArrowUp", down: "ArrowDown", left: "ArrowLeft", right: "ArrowRight", action: "Enter" },
+    { up: "i", down: "k", left: "j", right: "l", action: "u" },
+    { up: "8", down: "5", left: "4", right: "6", action: "0" }, // numpad mapped
+];
+/**
+ * GameRegistry — typed registry of available mini-games.
+ *
+ * Call `registry.register(meta)` to add games.
+ * Call `registry.all()` or `registry.find(id)` to query.
+ */
+class GameRegistry {
+    constructor() {
+        this.games = new Map();
+    }
+    register(meta) {
+        this.games.set(meta.id, meta);
+    }
+    registerAll(metas) {
+        for (const m of metas)
+            this.register(m);
+    }
+    unregister(id) {
+        this.games.delete(id);
+    }
+    find(id) {
+        return this.games.get(id);
+    }
+    all() {
+        return Array.from(this.games.values());
+    }
+    filter(predicate) {
+        return this.all().filter(predicate);
+    }
+    /** Games that support the given player count. */
+    forPlayerCount(n) {
+        return this.filter(m => n >= m.minPlayers && n <= m.maxPlayers);
+    }
+}
+/** Default singleton registry */
+const gameRegistry = new GameRegistry();
+
+export { DIR_DOWN, DIR_LEFT, DIR_RIGHT, DIR_UP, GameRegistry, KEYBOARD_GROUPS, MINI_PLAYER_COLORS, MINI_PLAYER_NAMES, gameRegistry };
+//# sourceMappingURL=MiniGameTypes.js.map

package/dist/esm/multiplayer/MiniGameTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiniGameTypes.js","sources":["../../../src/multiplayer/MiniGameTypes.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;AAEG;AAmBI,MAAM,kBAAkB,GAAG;AAC9B,IAAA,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;AAC1C,IAAA,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;;AAGvC,MAAM,iBAAiB,GAAG;AAC7B,IAAA,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;AAC9C,IAAA,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;;AAM3C,MAAM,MAAM,GAAW,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE;AACtC,MAAM,QAAQ,GAAS,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAG,CAAC;AACtC,MAAM,QAAQ,GAAS,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;AACtC,MAAM,SAAS,GAAQ,EAAE,EAAE,EAAG,CAAC,EAAE,EAAE,EAAE,CAAC;AAYtC,MAAM,eAAe,GAAoB;AAC5C,IAAA,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;AAC1D,IAAA,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE;AAC7F,IAAA,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IAC1D,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;;AAkB9D;;;;;AAKG;MACU,YAAY,CAAA;AAAzB,IAAA,WAAA,GAAA;AACY,QAAA,IAAA,CAAA,KAAK,GAAG,IAAI,GAAG,EAAwB;IA8BnD;AA5BI,IAAA,QAAQ,CAAC,IAAkB,EAAA;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IACjC;AAEA,IAAA,WAAW,CAAC,KAAqB,EAAA;QAC7B,KAAK,MAAM,CAAC,IAAI,KAAK;AAAE,YAAA,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C;AAEA,IAAA,UAAU,CAAC,EAAU,EAAA;AACjB,QAAA,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB;AAEA,IAAA,IAAI,CAAC,EAAU,EAAA;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7B;IAEA,GAAG,GAAA;QACC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC1C;AAEA,IAAA,MAAM,CAAC,SAAuC,EAAA;QAC1C,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;IACvC;;AAGA,IAAA,cAAc,CAAC,CAAS,EAAA;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC;IACnE;AACH;AAED;AACO,MAAM,YAAY,GAAG,IAAI,YAAY;;;;"}

package/dist/esm/network/MultiplayerTransport.js

@@ -0,0 +1,106 @@
+import { EventBus } from '../core/EventBus.js';
+
+/**
+ * MultiplayerTransport — abstract transport layer for game multiplayer.
+ *
+ * Multiple implementations can be plugged in:
+ *  - LocalTransport  (in-memory, couch co-op / testing)
+ *  - SignalRTransport (real-time via ASP.NET SignalR)
+ *  - WebRTCTransport  (peer-to-peer via PeerManager from ./network)
+ *
+ * For raw WebRTC, see PeerManager in network/Networking.ts.
+ */
+/* ── LocalTransport (in-memory, same-tab) ──────────────────────── */
+class LocalTransport {
+    constructor() {
+        this.state = "disconnected";
+        this.bus = new EventBus();
+        this.stateListeners = [];
+    }
+    async connect() { this.setState("connected"); }
+    disconnect() { this.setState("disconnected"); }
+    send(msg) {
+        // Echo locally (useful for testing, couch co-op)
+        this.bus.emit(msg.type, msg);
+    }
+    on(type, handler) { this.bus.on(type, handler); }
+    off(type, handler) { this.bus.off(type, handler); }
+    onStateChange(handler) { this.stateListeners.push(handler); }
+    setState(s) { this.state = s; for (const fn of this.stateListeners)
+        fn(s); }
+}
+/* ── SignalRTransport ──────────────────────────────────────────── */
+/**
+ * SignalR-based transport.
+ *
+ * Requires `@microsoft/signalr` to be installed as a peer dependency.
+ * Connection is established to `url` (e.g. `/hubs/game`).
+ *
+ * Hub server methods expected:
+ *   CreateRoom, JoinRoom, LeaveRoom, SendGameMessage,
+ *   StartMatchmaking, CancelMatchmaking
+ *
+ * Client-invoked events:
+ *   GameMessage, RoomJoined, RoomLeft, PlayerJoined, PlayerLeft,
+ *   MatchFound, Error
+ */
+class SignalRTransport {
+    constructor(options) {
+        this.state = "disconnected";
+        this.connection = null; // HubConnection from @microsoft/signalr
+        this.bus = new EventBus();
+        this.stateListeners = [];
+        this.tokenFactory = options === null || options === void 0 ? void 0 : options.accessTokenFactory;
+    }
+    async connect(url) {
+        this.setState("connecting");
+        try {
+            // Dynamic import so @microsoft/signalr is optional
+            const signalR = await import('../node_modules/@microsoft/signalr/dist/esm/index.js');
+            let builder = new signalR.HubConnectionBuilder()
+                .withUrl(url, this.tokenFactory ? { accessTokenFactory: this.tokenFactory } : {})
+                .withAutomaticReconnect([0, 1000, 2000, 5000, 10000, 30000]);
+            this.connection = builder.build();
+            // Forward hub events to bus
+            const hubEvents = ["GameMessage", "RoomJoined", "RoomLeft", "PlayerJoined", "PlayerLeft", "MatchFound", "Error"];
+            for (const evt of hubEvents) {
+                this.connection.on(evt, (payload) => {
+                    const msg = { type: evt, payload, timestamp: Date.now() };
+                    this.bus.emit(evt, msg);
+                });
+            }
+            this.connection.onreconnecting(() => this.setState("reconnecting"));
+            this.connection.onreconnected(() => this.setState("connected"));
+            this.connection.onclose(() => this.setState("disconnected"));
+            await this.connection.start();
+            this.setState("connected");
+        }
+        catch (_a) {
+            this.setState("disconnected");
+            throw new Error("SignalR connection failed");
+        }
+    }
+    disconnect() {
+        var _a;
+        (_a = this.connection) === null || _a === void 0 ? void 0 : _a.stop();
+        this.connection = null;
+        this.setState("disconnected");
+    }
+    send(msg) {
+        var _a;
+        (_a = this.connection) === null || _a === void 0 ? void 0 : _a.invoke("SendGameMessage", msg.type, msg.payload);
+    }
+    /** Hub server invocations */
+    async invoke(method, ...args) {
+        var _a;
+        return (_a = this.connection) === null || _a === void 0 ? void 0 : _a.invoke(method, ...args);
+    }
+    on(type, handler) { this.bus.on(type, handler); }
+    off(type, handler) { this.bus.off(type, handler); }
+    onStateChange(handler) { this.stateListeners.push(handler); }
+    setState(s) { this.state = s; for (const fn of this.stateListeners)
+        fn(s); }
+}
+
+export { LocalTransport, SignalRTransport };
+//# sourceMappingURL=MultiplayerTransport.js.map