@sadhaka/loom-engine 0.11.0 → 0.13.0

package/dist/index.js

@@ -8,7 +8,7 @@
 // the previous suffix `-perf-9-1` lingered after package.json was
 // bumped to 0.10.0, surfacing as a drift bug in
 // engine.LOOM_ENGINE_VERSION-based diagnostics.
-export const LOOM_ENGINE_VERSION = '0.11.0';
+export const LOOM_ENGINE_VERSION = '0.13.0';
 export { vec2, vec3, rect, clamp, lerp, smoothstep, approxEq, rectContains, rectIntersects, visibleInView, } from './util/math.js';
 export { rgba, hexToRgba, rgbaToHexString, rgbaToCssString, colorLerp, COLOR_WHITE, COLOR_BLACK, COLOR_TRANSPARENT, COLOR_KNOT_STR, COLOR_KNOT_DEX, COLOR_KNOT_INT, COLOR_KNOT_CENTER, } from './util/color.js';
 export { EntityAllocator, NULL_ENTITY, entityIndex, entityGeneration, makeEntity, } from './entity.js';
@@ -21,9 +21,18 @@ export { ResourceRegistry, createTimeResource, createVeilBudgetResource, RESOURC
 // Default systems
 export { SpriteRenderSystem } from './systems/sprite-render-system.js';
 // Engine facade
-export { Engine } from './engine.js';
+export { Engine, registerBackend, isBackendRegistered } from './engine.js';
 export { createCamera, getCameraViewRect, worldToScreen, screenToWorld, } from './renderer/camera.js';
 export { Canvas2DDevice, } from './renderer/canvas2d-device.js';
+// WebGL2 backend (Phase 14.1). Importing this symbol triggers the
+// module's self-registration of the 'webgl2' backend factory, so
+// Engine.create({ backend: 'webgl2' }) starts working from then on.
+// Canvas2D-only consumers do not import this and the entire WebGL2
+// path tree-shakes out of the bundle.
+export { WebGL2Device } from './renderer/webgl2-device.js';
+export { TextureAtlas, makeParticleDiscAtlas, } from './renderer/texture-atlas.js';
+export { SpriteBatcher, FLOATS_PER_INSTANCE, } from './renderer/sprite-batcher.js';
+export { SPRITE_VERT_SRC, SPRITE_FRAG_SRC, UNIT_QUAD_VERTICES, } from './renderer/shaders/sprite-shader-source.js';
 export { ISO_TILE_WIDTH, ISO_TILE_HEIGHT, ISO_HALF_W, ISO_HALF_H, ISO_Z_SCALE, tileToIso, worldToIso, isoToTile, isoDepthKey, } from './renderer/iso-projection.js';
 export { loadSpriteSheet, computeFrameIndex, SpriteSheetLoadError, } from './asset/sprite-sheet-loader.js';
 export { synthesizeDefaultClip, clipDurationMs, frameInClipAt, manifestFrameIndex, } from './animation/animation-clip.js';
@@ -66,4 +75,10 @@ export { createZoneState, beginTransition, tickTransition, isTransitioning, RESO
 export { ZONE_CATALOG } from './zone/zone-catalog.js';
 export { InteractablePool, POOL_INTERACTABLE, INTERACTABLE_FLAG_ACTIVE, } from './components/interactable.js';
 export { InteractionSystem, createLastInteraction, RESOURCE_LAST_INTERACTION, } from './systems/interaction-system.js';
+export { RESOURCE_MULTIPLAYER_BRIDGE, RESOURCE_PEER_POOL, BROADCAST_HZ, BROADCAST_MIN_INTERVAL_MS, } from './network/multiplayer-bridge.js';
+export { PeerPool } from './network/peer-pool.js';
+export { MockMultiplayerBridge } from './network/mock-multiplayer-bridge.js';
+export { SSEMultiplayerBridge } from './network/sse-multiplayer-bridge.js';
+export { PeerSpritePool, POOL_PEER_SPRITE } from './components/peer-sprite.js';
+export { PeerPresenceSystem, PeerRenderSystem, } from './systems/peer-presence-system.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,qDAAqD;AAErD,qEAAqE;AACrE,kEAAkE;AAClE,kEAAkE;AAClE,gDAAgD;AAChD,gDAAgD;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AAI5C,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,IAAI,EACJ,SAAS,EACT,eAAe,EACf,eAAe,EACf,SAAS,EACT,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,eAAe,EACf,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,WAAW;AACX,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAcrC,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,GACf,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,8BAA8B,CAAC;AAWtC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AAOxC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAOhF,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,wBAAwB,EACxB,aAAa,GACd,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,qBAAqB,EACrB,YAAY,GACb,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAI3E,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAQnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAiChC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AAMtC,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAKtE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAElF,mEAAmE;AACnE,8DAA8D;AAC9D,oEAAoE;AACpE,OAAO,EACL,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,UAAU,EACV,WAAW,EACX,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAO1D,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAE/E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAQhE,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAKtD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/network/mock-multiplayer-bridge.d.ts

@@ -0,0 +1,34 @@
+import { type IMultiplayerBridge, type MultiplayerBridgeStatus, type MultiplayerBridgeStats, type PresenceMessage } from './multiplayer-bridge.js';
+export interface MockMultiplayerBridgeOptions {
+    nowMs?: () => number;
+}
+interface SentBroadcast {
+    x: number;
+    y: number;
+    zone: string;
+    tsMs: number;
+    sentAtMs: number;
+}
+export declare class MockMultiplayerBridge implements IMultiplayerBridge {
+    private queue;
+    private statusValue;
+    private statsValue;
+    private readonly nowMs;
+    private lastBroadcastMs;
+    private sentBroadcasts;
+    constructor(opts?: MockMultiplayerBridgeOptions);
+    connect(): void;
+    disconnect(): void;
+    status(): MultiplayerBridgeStatus;
+    pollMessages(): PresenceMessage[];
+    broadcastPosition(x: number, y: number, zone: string, tsMs: number): void;
+    stats(): Readonly<MultiplayerBridgeStats>;
+    enqueueIncoming(msg: PresenceMessage): void;
+    enqueueIncomingAll(msgs: ReadonlyArray<PresenceMessage>): void;
+    getSentBroadcasts(): ReadonlyArray<Readonly<SentBroadcast>>;
+    pendingIncoming(): number;
+    resetRateLimit(): void;
+    getLastBroadcastMs(): number;
+}
+export {};
+//# sourceMappingURL=mock-multiplayer-bridge.d.ts.map

package/dist/network/mock-multiplayer-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-multiplayer-bridge.d.ts","sourceRoot":"","sources":["../../src/network/mock-multiplayer-bridge.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EAErB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,4BAA4B;IAI3C,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,UAAU,aAAa;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IAIb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,qBAAsB,YAAW,kBAAkB;IAC9D,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,UAAU,CAKhB;IACF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,cAAc,CAAuB;gBAEjC,IAAI,GAAE,4BAAiC;IAInD,OAAO,IAAI,IAAI;IAKf,UAAU,IAAI,IAAI;IAIlB,MAAM,IAAI,uBAAuB;IAIjC,YAAY,IAAI,eAAe,EAAE;IAOjC,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAWzE,KAAK,IAAI,QAAQ,CAAC,sBAAsB,CAAC;IAOzC,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAK3C,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,IAAI;IAS9D,iBAAiB,IAAI,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAK3D,eAAe,IAAI,MAAM;IAMzB,cAAc,IAAI,IAAI;IAKtB,kBAAkB,IAAI,MAAM;CAG7B"}

package/dist/network/mock-multiplayer-bridge.js

@@ -0,0 +1,91 @@
+// MockMultiplayerBridge - in-memory presence transport for tests +
+// offline demos.
+//
+// Tests inject incoming presence frames via enqueueIncoming() and let
+// PeerPresenceSystem drain them. broadcastPosition() captures local
+// sends in a getSentBroadcasts() buffer so tests can assert on them.
+// pollMessages() drains the inbound queue in FIFO order.
+//
+// Rate-limiting: shared with the SSE bridge via BROADCAST_MIN_INTERVAL_MS.
+// A nowMs() injection point lets tests fast-forward time without
+// touching the real clock.
+import { BROADCAST_MIN_INTERVAL_MS, } from './multiplayer-bridge.js';
+export class MockMultiplayerBridge {
+    queue = [];
+    statusValue = 'idle';
+    statsValue = {
+        messagesReceived: 0,
+        messagesSent: 0,
+        rateLimitedDrops: 0,
+        reconnects: 0,
+    };
+    nowMs;
+    lastBroadcastMs = -Infinity;
+    sentBroadcasts = [];
+    constructor(opts = {}) {
+        this.nowMs = opts.nowMs ?? (() => (typeof performance !== 'undefined' ? performance.now() : Date.now()));
+    }
+    connect() {
+        if (this.statusValue === 'connected')
+            return;
+        this.statusValue = 'connected';
+    }
+    disconnect() {
+        this.statusValue = 'closed';
+    }
+    status() {
+        return this.statusValue;
+    }
+    pollMessages() {
+        if (this.queue.length === 0)
+            return [];
+        const out = this.queue;
+        this.queue = [];
+        return out;
+    }
+    broadcastPosition(x, y, zone, tsMs) {
+        const now = this.nowMs();
+        if (now - this.lastBroadcastMs < BROADCAST_MIN_INTERVAL_MS) {
+            this.statsValue.rateLimitedDrops++;
+            return;
+        }
+        this.lastBroadcastMs = now;
+        this.sentBroadcasts.push({ x, y, zone, tsMs, sentAtMs: now });
+        this.statsValue.messagesSent++;
+    }
+    stats() {
+        return this.statsValue;
+    }
+    // ----- Mock-only injection helpers -----
+    // Enqueue an inbound presence message as if it came from the server.
+    enqueueIncoming(msg) {
+        this.queue.push(msg);
+        this.statsValue.messagesReceived++;
+    }
+    enqueueIncomingAll(msgs) {
+        for (let i = 0; i < msgs.length; i++) {
+            const m = msgs[i];
+            if (m)
+                this.enqueueIncoming(m);
+        }
+    }
+    // Tests inspect what broadcastPosition let through. Returns the
+    // backing array; the caller may copy if they need a snapshot.
+    getSentBroadcasts() {
+        return this.sentBroadcasts;
+    }
+    // Convenience: how many inbound messages are waiting for a poll.
+    pendingIncoming() {
+        return this.queue.length;
+    }
+    // Reset rate-limiter state. Useful in tests that simulate a
+    // reconnect or want a clean slate.
+    resetRateLimit() {
+        this.lastBroadcastMs = -Infinity;
+    }
+    // Inspect-only: when did broadcastPosition last send (in nowMs() units).
+    getLastBroadcastMs() {
+        return this.lastBroadcastMs;
+    }
+}
+//# sourceMappingURL=mock-multiplayer-bridge.js.map

package/dist/network/mock-multiplayer-bridge.js.map

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

package/dist/network/multiplayer-bridge.d.ts

@@ -0,0 +1,45 @@
+export type MultiplayerBridgeStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'closed';
+export interface MultiplayerBridgeStats {
+    messagesReceived: number;
+    messagesSent: number;
+    rateLimitedDrops: number;
+    reconnects: number;
+}
+export interface PresenceUpdate {
+    kind: 'update';
+    characterId: string;
+    x: number;
+    y: number;
+    zone: string;
+    tsMs: number;
+    name?: string;
+}
+export interface PresenceDepart {
+    kind: 'depart';
+    characterId: string;
+}
+export interface PresenceSnapshot {
+    kind: 'snapshot';
+    peers: ReadonlyArray<{
+        characterId: string;
+        x: number;
+        y: number;
+        zone: string;
+        tsMs: number;
+        name?: string;
+    }>;
+}
+export type PresenceMessage = PresenceUpdate | PresenceDepart | PresenceSnapshot;
+export interface IMultiplayerBridge {
+    connect(): void;
+    disconnect(): void;
+    status(): MultiplayerBridgeStatus;
+    pollMessages(): PresenceMessage[];
+    broadcastPosition(x: number, y: number, zone: string, tsMs: number): void;
+    stats(): Readonly<MultiplayerBridgeStats>;
+}
+export declare const RESOURCE_MULTIPLAYER_BRIDGE = "multiplayer_bridge";
+export declare const RESOURCE_PEER_POOL = "peer_pool";
+export declare const BROADCAST_HZ = 10;
+export declare const BROADCAST_MIN_INTERVAL_MS: number;
+//# sourceMappingURL=multiplayer-bridge.d.ts.map

package/dist/network/multiplayer-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiplayer-bridge.d.ts","sourceRoot":"","sources":["../../src/network/multiplayer-bridge.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,YAAY,GACZ,WAAW,GACX,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IAErC,gBAAgB,EAAE,MAAM,CAAC;IAGzB,YAAY,EAAE,MAAM,CAAC;IAGrB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IAGjC,OAAO,IAAI,IAAI,CAAC;IAEhB,UAAU,IAAI,IAAI,CAAC;IACnB,MAAM,IAAI,uBAAuB,CAAC;IAGlC,YAAY,IAAI,eAAe,EAAE,CAAC;IAKlC,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1E,KAAK,IAAI,QAAQ,CAAC,sBAAsB,CAAC,CAAC;CAC3C;AAGD,eAAO,MAAM,2BAA2B,uBAAuB,CAAC;AAChE,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAM9C,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,yBAAyB,QAAsB,CAAC"}

package/dist/network/multiplayer-bridge.js

@@ -0,0 +1,34 @@
+// MultiplayerBridge - abstraction over the presence transport.
+//
+// Concrete implementations:
+//   MockMultiplayerBridge - in-process transport for tests + offline
+//                           dev. enqueueIncoming() simulates server
+//                           pushes; broadcastPosition() captures local
+//                           sends so tests can assert on them.
+//   SSEMultiplayerBridge  - SSE-based implementation parallel to
+//                           SSEDirectorBridge. Browser-only; throws in
+//                           Node test runs.
+//
+// The PeerPresenceSystem (PHASE_INPUT) calls pollMessages() once per
+// tick to drain queued presence updates, applies them to the PeerPool,
+// and advances per-peer interpolation. Bridges buffer messages between
+// polls so the system's per-tick read is bounded.
+//
+// Wire protocol (shared with the server-side Track B implementation):
+//   - Server emits SSE 'presence.update'   { character_id, x, y, zone, ts_ms, name? }
+//   - Server emits SSE 'presence.depart'   { character_id }
+//   - Server emits SSE 'presence.snapshot' { peers: [{ character_id, x, y, zone, ts_ms, name? }, ...] }
+//   - Client POSTs   /presence/move        { character_id, x, y, zone, ts_ms }
+//
+// The bridge layer hides transport details. PeerPresenceSystem and
+// PeerPool deal only with strongly-typed PresenceMessage values.
+// Resource keys.
+export const RESOURCE_MULTIPLAYER_BRIDGE = 'multiplayer_bridge';
+export const RESOURCE_PEER_POOL = 'peer_pool';
+// Engine-side rate limit on broadcastPosition. The wire protocol
+// targets 10 Hz; bridges enforce this regardless of how often the
+// caller invokes broadcastPosition. Documented in the Multiplayer
+// section of README.md.
+export const BROADCAST_HZ = 10;
+export const BROADCAST_MIN_INTERVAL_MS = 1000 / BROADCAST_HZ;
+//# sourceMappingURL=multiplayer-bridge.js.map

package/dist/network/multiplayer-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiplayer-bridge.js","sourceRoot":"","sources":["../../src/network/multiplayer-bridge.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,4BAA4B;AAC5B,qEAAqE;AACrE,oEAAoE;AACpE,uEAAuE;AACvE,+DAA+D;AAC/D,iEAAiE;AACjE,uEAAuE;AACvE,4CAA4C;AAC5C,EAAE;AACF,qEAAqE;AACrE,uEAAuE;AACvE,uEAAuE;AACvE,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,sFAAsF;AACtF,4DAA4D;AAC5D,wGAAwG;AACxG,+EAA+E;AAC/E,EAAE;AACF,mEAAmE;AACnE,iEAAiE;AA2EjE,iBAAiB;AACjB,MAAM,CAAC,MAAM,2BAA2B,GAAG,oBAAoB,CAAC;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAE9C,iEAAiE;AACjE,kEAAkE;AAClE,kEAAkE;AAClE,wBAAwB;AACxB,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,YAAY,CAAC"}

package/dist/network/peer-pool.d.ts

@@ -0,0 +1,46 @@
+export interface PeerEntry {
+    characterId: string;
+    zone: string;
+    name: string | null;
+    prevX: number;
+    prevY: number;
+    prevTsMs: number;
+    currentX: number;
+    currentY: number;
+    currentTsMs: number;
+    lastRenderedFrame: number;
+}
+export interface RenderedPeerView {
+    characterId: string;
+    x: number;
+    y: number;
+    zone: string;
+    name: string | null;
+}
+export declare class PeerPool {
+    private peers;
+    private localCharacterId;
+    private scratchView;
+    setLocalCharacterId(id: string | null): void;
+    getLocalCharacterId(): string | null;
+    upsert(characterId: string, x: number, y: number, zone: string, tsMs: number, name?: string): void;
+    applySnapshot(peers: ReadonlyArray<{
+        characterId: string;
+        x: number;
+        y: number;
+        zone: string;
+        tsMs: number;
+        name?: string;
+    }>): void;
+    remove(characterId: string): boolean;
+    has(characterId: string): boolean;
+    size(): number;
+    get(characterId: string): Readonly<PeerEntry> | undefined;
+    forEachRendered(nowMs: number, frame: number, fn: (view: Readonly<RenderedPeerView>) => void): void;
+    getRenderedPosition(characterId: string, nowMs: number): {
+        x: number;
+        y: number;
+    } | null;
+    clear(): void;
+}
+//# sourceMappingURL=peer-pool.d.ts.map

package/dist/network/peer-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-pool.d.ts","sourceRoot":"","sources":["../../src/network/peer-pool.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAGpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IAGpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAMD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAYD,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,gBAAgB,CAAuB;IAI/C,OAAO,CAAC,WAAW,CAMjB;IAEF,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAO5C,mBAAmB,IAAI,MAAM,GAAG,IAAI;IASpC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IA0ClG,aAAa,CACX,KAAK,EAAE,aAAa,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,GACD,IAAI;IAwBP,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIpC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjC,IAAI,IAAI,MAAM;IAId,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS;IAOzD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,KAAK,IAAI,GAAG,IAAI;IAsBnG,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAcxF,KAAK,IAAI,IAAI;CAGd"}

package/dist/network/peer-pool.js

@@ -0,0 +1,185 @@
+// PeerPool - tracks all known remote peers and their interpolated
+// world position.
+//
+// Each peer keeps the last two known positions (prev, current) with
+// timestamps. At frame time the system asks the pool for the
+// interpolated (x, y) per peer, which is computed as
+//   factor = clamp01((nowMs - prevTsMs) / (currentTsMs - prevTsMs))
+//   x      = lerp(prevX, currentX, factor)
+//   y      = lerp(prevY, currentY, factor)
+//
+// When a new presence.update arrives, prev <- current, current <- new.
+// The factor saturates at 1 once nowMs passes currentTsMs, so a peer
+// who stops sending updates simply freezes at their last known
+// position rather than extrapolating off into the distance.
+//
+// "Acceptable lag" per the phase 15.1 spec is ~150ms (one update
+// interval at the 10Hz wire rate), which is imperceptible at
+// walk-speed. No CRDT, no client-side prediction beyond the
+// straight-line lerp - those are deferred until shared state extends
+// past raw position.
+//
+// Self-filter: the local character's own character_id should NOT
+// appear among the rendered peers (we don't render ourselves as a
+// ghost). The PeerPresenceSystem owns this filter via
+// setLocalCharacterId(); peers with that id are silently skipped on
+// upsert and removed if already present.
+function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+function clamp01(t) {
+    if (t < 0)
+        return 0;
+    if (t > 1)
+        return 1;
+    return t;
+}
+export class PeerPool {
+    peers = new Map();
+    localCharacterId = null;
+    // Reused on every getRenderedPosition / forEachRendered call so the
+    // hot per-frame path is allocation-free.
+    scratchView = {
+        characterId: '',
+        x: 0,
+        y: 0,
+        zone: '',
+        name: null,
+    };
+    setLocalCharacterId(id) {
+        this.localCharacterId = id;
+        if (id !== null && this.peers.has(id)) {
+            this.peers.delete(id);
+        }
+    }
+    getLocalCharacterId() {
+        return this.localCharacterId;
+    }
+    // Apply a new presence update for a peer. If the peer is the local
+    // character, the update is ignored (self-filter). If this is the
+    // first update for the peer, prev = current = the new position so
+    // the lerp factor immediately saturates and the peer renders at the
+    // sent position.
+    upsert(characterId, x, y, zone, tsMs, name) {
+        if (this.localCharacterId !== null && characterId === this.localCharacterId) {
+            return;
+        }
+        const existing = this.peers.get(characterId);
+        if (!existing) {
+            this.peers.set(characterId, {
+                characterId,
+                zone,
+                name: name ?? null,
+                prevX: x,
+                prevY: y,
+                prevTsMs: tsMs,
+                currentX: x,
+                currentY: y,
+                currentTsMs: tsMs,
+                lastRenderedFrame: -1,
+            });
+            return;
+        }
+        // Out-of-order: drop messages older than current. Wire protocol
+        // is monotonic per character_id, but reorder buffers + reconnect
+        // replays can deliver an older ts after a newer one.
+        if (tsMs < existing.currentTsMs) {
+            return;
+        }
+        existing.prevX = existing.currentX;
+        existing.prevY = existing.currentY;
+        existing.prevTsMs = existing.currentTsMs;
+        existing.currentX = x;
+        existing.currentY = y;
+        existing.currentTsMs = tsMs;
+        existing.zone = zone;
+        if (name !== undefined) {
+            existing.name = name;
+        }
+    }
+    // Replace the entire roster with a snapshot. Peers not present in
+    // the snapshot are dropped; peers in the snapshot but not yet
+    // tracked are inserted (with prev = current so they render at the
+    // sent position immediately).
+    applySnapshot(peers) {
+        const seen = new Set();
+        for (let i = 0; i < peers.length; i++) {
+            const p = peers[i];
+            if (!p)
+                continue;
+            if (this.localCharacterId !== null && p.characterId === this.localCharacterId) {
+                continue;
+            }
+            seen.add(p.characterId);
+            this.upsert(p.characterId, p.x, p.y, p.zone, p.tsMs, p.name);
+        }
+        // Drop anyone not in the snapshot. Iterate keys snapshot first
+        // because Map.delete during iteration is fine but copying makes
+        // intent obvious.
+        const toRemove = [];
+        this.peers.forEach((_v, k) => {
+            if (!seen.has(k))
+                toRemove.push(k);
+        });
+        for (let i = 0; i < toRemove.length; i++) {
+            const k = toRemove[i];
+            if (k)
+                this.peers.delete(k);
+        }
+    }
+    remove(characterId) {
+        return this.peers.delete(characterId);
+    }
+    has(characterId) {
+        return this.peers.has(characterId);
+    }
+    size() {
+        return this.peers.size;
+    }
+    get(characterId) {
+        return this.peers.get(characterId);
+    }
+    // Iterate every tracked peer with their interpolated world
+    // position at nowMs. The view object is reused; consumers must
+    // copy any field they want to retain past the callback.
+    forEachRendered(nowMs, frame, fn) {
+        this.peers.forEach((entry) => {
+            const v = this.scratchView;
+            v.characterId = entry.characterId;
+            v.zone = entry.zone;
+            v.name = entry.name;
+            const dt = entry.currentTsMs - entry.prevTsMs;
+            if (dt <= 0) {
+                v.x = entry.currentX;
+                v.y = entry.currentY;
+            }
+            else {
+                const t = clamp01((nowMs - entry.prevTsMs) / dt);
+                v.x = lerp(entry.prevX, entry.currentX, t);
+                v.y = lerp(entry.prevY, entry.currentY, t);
+            }
+            entry.lastRenderedFrame = frame;
+            fn(v);
+        });
+    }
+    // Single-peer query for tests + the rare ad-hoc lookup. Hot paths
+    // use forEachRendered to avoid map lookups.
+    getRenderedPosition(characterId, nowMs) {
+        const entry = this.peers.get(characterId);
+        if (!entry)
+            return null;
+        const dt = entry.currentTsMs - entry.prevTsMs;
+        if (dt <= 0) {
+            return { x: entry.currentX, y: entry.currentY };
+        }
+        const t = clamp01((nowMs - entry.prevTsMs) / dt);
+        return {
+            x: lerp(entry.prevX, entry.currentX, t),
+            y: lerp(entry.prevY, entry.currentY, t),
+        };
+    }
+    clear() {
+        this.peers.clear();
+    }
+}
+//# sourceMappingURL=peer-pool.js.map

package/dist/network/peer-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-pool.js","sourceRoot":"","sources":["../../src/network/peer-pool.ts"],"names":[],"mappings":"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"}

package/dist/network/sse-multiplayer-bridge.d.ts

@@ -0,0 +1,36 @@
+import { type IMultiplayerBridge, type MultiplayerBridgeStatus, type MultiplayerBridgeStats, type PresenceMessage } from './multiplayer-bridge.js';
+export interface SSEMultiplayerBridgeOptions {
+    baseUrl: string;
+    broadcastUrl?: string;
+    characterId: string;
+    zone: string;
+    eventSourceFactory?: (url: string) => EventSource;
+    fetchFn?: typeof fetch;
+}
+export declare class SSEMultiplayerBridge implements IMultiplayerBridge {
+    private readonly baseUrl;
+    private readonly broadcastUrl;
+    private readonly characterId;
+    private readonly zone;
+    private readonly eventSourceFactory;
+    private readonly fetchFn;
+    private es;
+    private queue;
+    private statusValue;
+    private statsValue;
+    private lastBroadcastMs;
+    constructor(opts: SSEMultiplayerBridgeOptions);
+    connect(): void;
+    disconnect(): void;
+    status(): MultiplayerBridgeStatus;
+    pollMessages(): PresenceMessage[];
+    broadcastPosition(x: number, y: number, zone: string, tsMs: number): void;
+    stats(): Readonly<MultiplayerBridgeStats>;
+    private buildUrl;
+    private openConnection;
+    private closeConnection;
+    private handleUpdate;
+    private handleDepart;
+    private handleSnapshot;
+}
+//# sourceMappingURL=sse-multiplayer-bridge.d.ts.map

package/dist/network/sse-multiplayer-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-multiplayer-bridge.d.ts","sourceRoot":"","sources":["../../src/network/sse-multiplayer-bridge.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EAErB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,2BAA2B;IAI1C,OAAO,EAAE,MAAM,CAAC;IAKhB,YAAY,CAAC,EAAE,MAAM,CAAC;IAItB,WAAW,EAAE,MAAM,CAAC;IAEpB,IAAI,EAAE,MAAM,CAAC;IAGb,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,CAAC;IAClD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA+B;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,UAAU,CAKhB;IAEF,OAAO,CAAC,eAAe,CAAqB;gBAEhC,IAAI,EAAE,2BAA2B;IAwB7C,OAAO,IAAI,IAAI;IAMf,UAAU,IAAI,IAAI;IAKlB,MAAM,IAAI,uBAAuB;IAIjC,YAAY,IAAI,eAAe,EAAE;IAOjC,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IA0BzE,KAAK,IAAI,QAAQ,CAAC,sBAAsB,CAAC;IAMzC,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,cAAc;IAmCtB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,cAAc;CAsCvB"}