@sadhaka/loom-engine 0.12.0 → 0.14.0

package/dist/systems/peer-presence-system.js

@@ -0,0 +1,118 @@
+// PeerPresenceSystem - drains the IMultiplayerBridge each tick, applies
+// presence messages to the PeerPool, and (optionally) broadcasts the
+// local character's position via PeerBroadcastBridge.
+//
+// PeerRenderSystem - iterates PeerPool at frame time, computes each
+// peer's interpolated position from prev/current samples, looks up
+// their sprite via PeerSpritePool, and submits drawSprite + drawText
+// (name label) calls to the device.
+//
+// Phasing rationale (matches DirectorSystem):
+//   PHASE_INPUT  - PeerPresenceSystem drains the bridge so peers are
+//                  fresh before any logic system reads them. Mirrors
+//                  the DirectorSystem ordering.
+//   PHASE_RENDER - PeerRenderSystem submits draw calls. Per-peer
+//                  interp factor is computed from the current
+//                  TimeResource clock, so peers move smoothly even on
+//                  frames with no inbound update.
+//
+// PeerPresenceSystem also routes the snapshot, update, and depart
+// message kinds to the right PeerPool method:
+//   snapshot -> applySnapshot (drops anyone not in the snapshot)
+//   update   -> upsert
+//   depart   -> remove
+//
+// Self-filter: callers register the local character_id via
+// peerPool.setLocalCharacterId(...) at startup. The pool refuses to
+// store an entry with that id; if a snapshot or update mentions it,
+// it's silently skipped (we don't render ourselves as a ghost).
+import { RESOURCE_MULTIPLAYER_BRIDGE, RESOURCE_PEER_POOL, } from '../network/multiplayer-bridge.js';
+import { POOL_PEER_SPRITE } from '../components/peer-sprite.js';
+import { RESOURCE_DEVICE, RESOURCE_CAMERA, RESOURCE_TIME, } from '../resources.js';
+export class PeerPresenceSystem {
+    name = 'peer-presence';
+    update(world, _dt) {
+        const bridge = world.resources.get(RESOURCE_MULTIPLAYER_BRIDGE);
+        const pool = world.resources.get(RESOURCE_PEER_POOL);
+        if (!bridge || !pool)
+            return;
+        const messages = bridge.pollMessages();
+        if (messages.length === 0)
+            return;
+        for (let i = 0; i < messages.length; i++) {
+            const m = messages[i];
+            if (!m)
+                continue;
+            switch (m.kind) {
+                case 'update':
+                    pool.upsert(m.characterId, m.x, m.y, m.zone, m.tsMs, m.name);
+                    break;
+                case 'depart':
+                    pool.remove(m.characterId);
+                    break;
+                case 'snapshot':
+                    pool.applySnapshot(m.peers);
+                    break;
+            }
+        }
+    }
+}
+// Render-phase counterpart. Optional - consumers who only want to
+// surface peer state (e.g. on a minimap) can read PeerPool directly
+// and skip this system.
+export class PeerRenderSystem {
+    name = 'peer-render';
+    // Reused per-frame to avoid allocation in the per-peer hot path.
+    scratchTextStyle = {
+        font: '12px sans-serif',
+        fill: { r: 1, g: 1, b: 1, a: 1 },
+        align: 'center',
+        baseline: 'bottom',
+    };
+    scratchTint = {
+        r: 1, g: 1, b: 1, a: 1,
+    };
+    // Vertical offset (world units) applied to the name label so it
+    // sits just above the sprite. Tuned for the engine's standard
+    // 64-px sprite cell; consumers with custom art can override via
+    // the PeerRenderSystem constructor.
+    labelYOffset;
+    showNames;
+    constructor(opts = {}) {
+        this.labelYOffset = opts.labelYOffset ?? -32;
+        this.showNames = opts.showNames ?? true;
+    }
+    update(world, _dt) {
+        const pool = world.resources.get(RESOURCE_PEER_POOL);
+        const sprites = world.getPool(POOL_PEER_SPRITE);
+        const device = world.resources.get(RESOURCE_DEVICE);
+        const camera = world.resources.get(RESOURCE_CAMERA);
+        const time = world.resources.get(RESOURCE_TIME);
+        if (!pool || !sprites || !device || !camera)
+            return;
+        device.setCamera(camera);
+        const nowMs = (time ? time.elapsed * 1000 : 0) + (typeof performance !== 'undefined' ? performance.now() : 0);
+        const frame = time ? time.frame : -1;
+        // Capture the values we need from each peer before drawing.
+        // forEachRendered's view is reused; we have to read fields out
+        // before the next iteration mutates the scratch.
+        pool.forEachRendered(nowMs, frame, (view) => {
+            const entry = sprites.resolve(view.characterId);
+            if (entry.tint) {
+                const t = this.scratchTint;
+                t.r = entry.tint.r;
+                t.g = entry.tint.g;
+                t.b = entry.tint.b;
+                t.a = entry.tint.a;
+                device.drawSprite(view.x, view.y, 0, entry.atlas, entry.frame, t);
+            }
+            else {
+                device.drawSprite(view.x, view.y, 0, entry.atlas, entry.frame);
+            }
+            if (this.showNames && view.name) {
+                device.drawText(view.x, view.y + this.labelYOffset, view.name, this.scratchTextStyle);
+            }
+        });
+    }
+}
+//# sourceMappingURL=peer-presence-system.js.map

package/dist/systems/peer-presence-system.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sadhaka/loom-engine",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Browser-first 2D / 2.5D game engine. Canvas2D, ECS, render-graph stages, Director-bridge SSE integration. Built from scratch in TypeScript for TheWorldTable.ai.",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,6 +11,10 @@
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
+    "./server": {
+      "import": "./dist/server/index.js",
+      "types": "./dist/server/index.d.ts"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -43,7 +47,7 @@
     "build:all": "npm run build && npm run build:demos",
     "watch": "tsc --watch",
     "clean": "rm -rf dist demo/*.js demo/*.js.map demo/*/main.js demo/*/main.js.map",
-    "test": "tsx --test tests/smoke.test.ts tests/world.test.ts tests/asset-loader.test.ts tests/animation.test.ts tests/vfx.test.ts tests/audio-input.test.ts tests/director.test.ts tests/combat.test.ts tests/projectile.test.ts tests/arpg.test.ts tests/snapshot-recovery.test.ts tests/touch-input.test.ts tests/webgl2-device.test.ts",
+    "test": "tsx --test tests/smoke.test.ts tests/world.test.ts tests/asset-loader.test.ts tests/animation.test.ts tests/vfx.test.ts tests/audio-input.test.ts tests/director.test.ts tests/combat.test.ts tests/projectile.test.ts tests/arpg.test.ts tests/snapshot-recovery.test.ts tests/touch-input.test.ts tests/webgl2-device.test.ts tests/multiplayer.test.ts tests/zone-event-envelope.test.ts tests/mock-zone-bridge.test.ts tests/zone-event-system.test.ts tests/zone-state-resource.test.ts tests/ai-plugin-registry.test.ts tests/ai-plugin-error-isolation.test.ts tests/mock-ai-plugin.test.ts tests/plugin-context.test.ts",
     "bench": "npm run build && node --expose-gc --import=tsx tools/perf-bench.ts",
     "bench:fast": "npm run build && node --expose-gc --import=tsx tools/perf-bench.ts --no-write",
     "bench:browser": "npm run build && tsc -p tools/tsconfig.bench.json",