@bloopjs/bloop 0.0.89 → 0.0.90

package/dist/players.d.ts

@@ -0,0 +1,26 @@
+import type { InputContext, PlayerInputContext, NetContext } from "@bloopjs/engine";
+/**
+ * Collection of player input contexts with ergonomic access.
+ *
+ * - `.get(i)` returns PlayerInputContext without undefined (throws for out-of-bounds 0-11)
+ * - Iteration yields only connected players
+ * - `.count` returns number of connected players
+ */
+export declare class Players implements Iterable<PlayerInputContext> {
+    #private;
+    constructor(inputs: InputContext, net: NetContext);
+    /**
+     * Get player input context by index.
+     * @param index Player index (0-11)
+     * @returns PlayerInputContext for that slot
+     * @throws RangeError if index out of bounds
+     */
+    get(index: number): PlayerInputContext;
+    /** Number of connected players (1 in local mode, peerCount in multiplayer) */
+    get count(): number;
+    /** Iterate over connected players only */
+    [Symbol.iterator](): IterableIterator<PlayerInputContext>;
+    /** Iterate over connected players with their indices */
+    entries(): IterableIterator<[number, PlayerInputContext]>;
+}
+//# sourceMappingURL=players.d.ts.map

package/dist/players.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"players.d.ts","sourceRoot":"","sources":["../src/players.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;GAMG;AACH,qBAAa,OAAQ,YAAW,QAAQ,CAAC,kBAAkB,CAAC;;gBAI9C,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU;IAKjD;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB;IAUtC,8EAA8E;IAC9E,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,0CAA0C;IACzC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,kBAAkB,CAAC;IAQ1D,wDAAwD;IACvD,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAO3D"}

package/dist/sim.d.ts

@@ -1,4 +1,4 @@
-import { type EnginePointer, type Key, type MouseButton, NetContext, type NetEvent, type NetEventType, TimeContext, type WasmEngine } from "@bloopjs/engine";
+import { type EnginePointer, type Key, type MouseButton, NetContext, type NetEvent, type NetEventType, ScreenContext, TimeContext, type WasmEngine } from "@bloopjs/engine";
 export type LoadTapeOptions = {
     /** Frames between checkpoints for seek optimization (0 = disabled). Default: 0 */
     checkpointInterval?: number;
@@ -139,6 +139,7 @@ export declare class Sim {
     unmount(): void;
     get time(): TimeContext;
     get net(): NetContext;
+    get screen(): ScreenContext;
     get buffer(): ArrayBuffer;
     get isRecording(): boolean;
     get isReplaying(): boolean;
@@ -150,6 +151,15 @@ export declare class Sim {
         mousedown: (button: MouseButton, peerId?: number) => void;
         mouseup: (button: MouseButton, peerId?: number) => void;
         mousewheel: (x: number, y: number, peerId?: number) => void;
+        /**
+         * Emit a resize event. Updates screen context and fires resize callback in systems.
+         * @param width Logical width in CSS pixels
+         * @param height Logical height in CSS pixels
+         * @param physicalWidth Physical width in device pixels
+         * @param physicalHeight Physical height in device pixels
+         * @param pixelRatio Device pixel ratio
+         */
+        resize: (width: number, height: number, physicalWidth: number, physicalHeight: number, pixelRatio: number) => void;
         /**
          * Emit a network event (join:ok, peer:join, etc.)
          * Events are queued in the engine and processed during the next tick's systemsCallback.

package/dist/sim.d.ts.map

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

package/dist/system.d.ts

@@ -1,7 +1,7 @@
 import type { NetEvent } from "@bloopjs/engine";
 import type { Context } from "./context";
 import type { BloopSchema } from "./data/schema";
-import type { KeyEvent, MouseButtonEvent, MouseMoveEvent, MouseWheelEvent } from "./events";
+import type { KeyEvent, MouseButtonEvent, MouseMoveEvent, MouseWheelEvent, ResizeEvent } from "./events";
 export type System<GS extends BloopSchema = BloopSchema> = {
     label?: string;
     update?: (context: Context<GS>) => void;
@@ -27,5 +27,9 @@ export type System<GS extends BloopSchema = BloopSchema> = {
     netcode?: (context: Context<GS> & {
         event: NetEvent;
     }) => void;
+    /** Handle screen/viewport resize events */
+    resize?: (context: Context<GS> & {
+        event: ResizeEvent;
+    }) => void;
 };
 //# sourceMappingURL=system.d.ts.map

package/dist/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../src/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,WAAW,GAAG,WAAW,IAAI;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAExC,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;IAEV,KAAK,CAAC,EAAE,CACN,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;IAEV,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,gBAAgB,CAAC;KACzB,KACE,IAAI,CAAC;IAEV,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,gBAAgB,CAAC;KACzB,KACE,IAAI,CAAC;IAEV,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,cAAc,CAAC;KACvB,KACE,IAAI,CAAC;IAEV,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,eAAe,CAAC;KACxB,KACE,IAAI,CAAC;IAEV,uDAAuD;IACvD,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;CACX,CAAC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../src/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,WAAW,GAAG,WAAW,IAAI;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAExC,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;IAEV,KAAK,CAAC,EAAE,CACN,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;IAEV,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,gBAAgB,CAAC;KACzB,KACE,IAAI,CAAC;IAEV,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,gBAAgB,CAAC;KACzB,KACE,IAAI,CAAC;IAEV,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,cAAc,CAAC;KACvB,KACE,IAAI,CAAC;IAEV,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,eAAe,CAAC;KACxB,KACE,IAAI,CAAC;IAEV,uDAAuD;IACvD,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;IAEV,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CACP,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,WAAW,CAAC;KACpB,KACE,IAAI,CAAC;CACX,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloopjs/bloop",
-  "version": "0.0.89",
+  "version": "0.0.90",
   "author": "Neil Sarkar",
   "type": "module",
   "repository": {
@@ -35,7 +35,7 @@
     "@types/bun": "latest"
   },
   "dependencies": {
-    "@bloopjs/engine": "0.0.89"
+    "@bloopjs/engine": "0.0.90"
   },
   "peerDependencies": {
     "typescript": "^5"

package/src/bloop.ts

@@ -9,18 +9,22 @@ import {
   NET_CTX_OFFSET,
   NetContext,
   type NetEvent,
+  SCREEN_CTX_OFFSET,
+  ScreenContext,
   TIME_CTX_OFFSET,
   TimeContext,
 } from "@bloopjs/engine";
+import { Players } from "./players";
 import type { Context } from "./context";
 import type { Bag } from "./data/bag";
 import type { BloopSchema } from "./data/schema";
 import type {
-  InputEvent,
+  BloopEvent,
   KeyEvent,
   MouseButtonEvent,
   MouseMoveEvent,
   MouseWheelEvent,
+  ResizeEvent,
 } from "./events";
 import type { EngineHooks } from "./sim";
 import type { System } from "./system";
@@ -75,15 +79,16 @@ export class Bloop<GS extends BloopSchema> {
     }
 
     const inputs = new InputContext();
+    const net = new NetContext();
+    const screen = new ScreenContext();
     this.#context = {
       bag: opts.bag ?? {},
       time: new TimeContext(),
       inputs,
-      get players() {
-        return inputs.players;
-      },
+      players: new Players(inputs, net),
       rawPointer: -1,
-      net: new NetContext(),
+      net,
+      screen,
     };
   }
 
@@ -160,6 +165,7 @@ export class Bloop<GS extends BloopSchema> {
       const timeCtxPtr = dv.getUint32(TIME_CTX_OFFSET, true);
       const inputCtxPtr = dv.getUint32(INPUT_CTX_OFFSET, true);
       const netCtxPtr = dv.getUint32(NET_CTX_OFFSET, true);
+      const screenCtxPtr = dv.getUint32(SCREEN_CTX_OFFSET, true);
 
       this.#context.rawPointer = ptr;
 
@@ -193,6 +199,16 @@ export class Bloop<GS extends BloopSchema> {
           netCtxPtr,
         );
       }
+
+      if (
+        this.#context.screen.dataView?.buffer !== this.#engineBuffer ||
+        this.#context.screen.dataView?.byteOffset !== screenCtxPtr
+      ) {
+        this.#context.screen.dataView = new DataView(
+          this.#engineBuffer,
+          screenCtxPtr,
+        );
+      }
     },
 
     systemsCallback: (system_handle: number, ptr: EnginePointer) => {
@@ -342,6 +358,18 @@ export class Bloop<GS extends BloopSchema> {
                 this.#context as Context<GS> & { event: NetEvent },
               );
               break;
+            case Enums.EventType.Resize:
+              // Resize event - values are read from screen context (already updated by engine)
+              system.resize?.(
+                attachEvent<ResizeEvent, GS>(this.#context, {
+                  width: this.#context.screen.width,
+                  height: this.#context.screen.height,
+                  physicalWidth: this.#context.screen.physicalWidth,
+                  physicalHeight: this.#context.screen.physicalHeight,
+                  pixelRatio: this.#context.screen.pixelRatio,
+                }),
+              );
+              break;
             default:
               // Session lifecycle and other internal events are handled by engine
               // They don't need to be dispatched to game systems
@@ -356,12 +384,12 @@ export class Bloop<GS extends BloopSchema> {
   };
 }
 
-function attachEvent<IE extends InputEvent, GS extends BloopSchema>(
+function attachEvent<E extends BloopEvent, GS extends BloopSchema>(
   context: Context<GS>,
-  event: IE,
-): Context<GS> & { event: IE } {
+  event: E,
+): Context<GS> & { event: E } {
   (context as any).event = event;
-  return context as Context<GS> & { event: IE };
+  return context as Context<GS> & { event: E };
 }
 
 type MakeGS<B extends Bag> = BloopSchema<B>;

package/src/context.ts

@@ -2,10 +2,11 @@ import type {
   EnginePointer,
   InputContext,
   NetContext,
-  PlayerInputContext,
+  ScreenContext,
   TimeContext,
 } from "@bloopjs/engine";
 import type { BloopSchema } from "./data/schema";
+import type { Players } from "./players";
 
 export type Context<
   GS extends BloopSchema = BloopSchema,
@@ -27,12 +28,15 @@ export type Context<
   /** The input snapshot */
   inputs: InputContext;
   /**
-   * Per-player input states. Shorthand for inputs.players.
-   * Access via: context.players[0].keys.a.held
+   * Per-player input states.
+   * Access via: context.players.get(0).keys.a.held
+   * Iterate connected players: for (const p of context.players) { ... }
    */
-  players: readonly PlayerInputContext[];
+  players: Players;
   /** The engine pointer to the injected system arguments (for advanced use cases) */
   rawPointer: EnginePointer;
   /** Network context for multiplayer sessions */
   net: NetContext;
+  /** Screen/viewport dimensions and pixel ratio */
+  screen: ScreenContext;
 };

package/src/events.ts

@@ -23,3 +23,13 @@ export type MouseWheelEvent = {
   x: number;
   y: number;
 };
+
+export type ResizeEvent = {
+  width: number;
+  height: number;
+  physicalWidth: number;
+  physicalHeight: number;
+  pixelRatio: number;
+};
+
+export type BloopEvent = InputEvent | ResizeEvent;

package/src/mod.ts

@@ -6,3 +6,4 @@ export { unwrap, assert } from "./util";
 export { mount, type Mountable, type MountOptions } from "./mount";
 export { Bloop } from "./bloop";
 export { Sim, type LoadTapeOptions } from "./sim";
+export { Players } from "./players";

package/src/players.ts

@@ -0,0 +1,61 @@
+import type {
+  InputContext,
+  PlayerInputContext,
+  NetContext,
+} from "@bloopjs/engine";
+
+/**
+ * Collection of player input contexts with ergonomic access.
+ *
+ * - `.get(i)` returns PlayerInputContext without undefined (throws for out-of-bounds 0-11)
+ * - Iteration yields only connected players
+ * - `.count` returns number of connected players
+ */
+export class Players implements Iterable<PlayerInputContext> {
+  readonly #inputs: InputContext;
+  readonly #net: NetContext;
+
+  constructor(inputs: InputContext, net: NetContext) {
+    this.#inputs = inputs;
+    this.#net = net;
+  }
+
+  /**
+   * Get player input context by index.
+   * @param index Player index (0-11)
+   * @returns PlayerInputContext for that slot
+   * @throws RangeError if index out of bounds
+   */
+  get(index: number): PlayerInputContext {
+    const players = this.#inputs.players;
+    if (index < 0 || index >= players.length) {
+      throw new RangeError(
+        `Player index ${index} out of bounds (0-${players.length - 1})`,
+      );
+    }
+    return players[index]!;
+  }
+
+  /** Number of connected players (1 in local mode, peerCount in multiplayer) */
+  get count(): number {
+    return this.#net.isInSession ? this.#net.peerCount : 1;
+  }
+
+  /** Iterate over connected players only */
+  *[Symbol.iterator](): IterableIterator<PlayerInputContext> {
+    const players = this.#inputs.players;
+    const count = this.count;
+    for (let i = 0; i < count; i++) {
+      yield players[i]!;
+    }
+  }
+
+  /** Iterate over connected players with their indices */
+  *entries(): IterableIterator<[number, PlayerInputContext]> {
+    const players = this.#inputs.players;
+    const count = this.count;
+    for (let i = 0; i < count; i++) {
+      yield [i, players[i]!];
+    }
+  }
+}

package/src/sim.ts

@@ -7,6 +7,7 @@ import {
   NetContext,
   type NetEvent,
   type NetEventType,
+  ScreenContext,
   SNAPSHOT_HEADER_ENGINE_LEN_OFFSET,
   SNAPSHOT_HEADER_USER_LEN_OFFSET,
   TimeContext,
@@ -104,6 +105,11 @@ export class Sim {
    */
   #net: NetContext;
 
+  /**
+   * Screen context - reads viewport dimensions from WASM memory.
+   */
+  #screen: ScreenContext;
+
   /**
    * Callback fired when tape buffer fills up and recording stops.
    * The tape data is passed so you can save it before clearing.
@@ -125,6 +131,7 @@ export class Sim {
 
     this.#serialize = opts?.serialize;
     this.#net = new NetContext();
+    this.#screen = new ScreenContext();
   }
 
   /**
@@ -379,6 +386,20 @@ export class Sim {
     return this.#net;
   }
 
+  get screen(): ScreenContext {
+    if (
+      !this.#screen.dataView ||
+      this.#screen.dataView.buffer !== this.#memory.buffer
+    ) {
+      // update the data view to the latest memory buffer
+      this.#screen.dataView = new DataView(
+        this.#memory.buffer,
+        this.wasm.get_screen_ctx(),
+      );
+    }
+    return this.#screen;
+  }
+
   get buffer(): ArrayBuffer {
     return this.#memory.buffer;
   }
@@ -414,6 +435,23 @@ export class Sim {
     mousewheel: (x: number, y: number, peerId: number = 0): void => {
       this.wasm.emit_mousewheel(x, y, peerId);
     },
+    /**
+     * Emit a resize event. Updates screen context and fires resize callback in systems.
+     * @param width Logical width in CSS pixels
+     * @param height Logical height in CSS pixels
+     * @param physicalWidth Physical width in device pixels
+     * @param physicalHeight Physical height in device pixels
+     * @param pixelRatio Device pixel ratio
+     */
+    resize: (
+      width: number,
+      height: number,
+      physicalWidth: number,
+      physicalHeight: number,
+      pixelRatio: number,
+    ): void => {
+      this.wasm.emit_resize(width, height, physicalWidth, physicalHeight, pixelRatio);
+    },
     /**
      * Emit a network event (join:ok, peer:join, etc.)
      * Events are queued in the engine and processed during the next tick's systemsCallback.

package/src/system.ts

@@ -6,6 +6,7 @@ import type {
   MouseButtonEvent,
   MouseMoveEvent,
   MouseWheelEvent,
+  ResizeEvent,
 } from "./events";
 
 export type System<GS extends BloopSchema = BloopSchema> = {
@@ -55,4 +56,11 @@ export type System<GS extends BloopSchema = BloopSchema> = {
       event: NetEvent;
     },
   ) => void;
+
+  /** Handle screen/viewport resize events */
+  resize?: (
+    context: Context<GS> & {
+      event: ResizeEvent;
+    },
+  ) => void;
 };