quake2ts 0.0.561 → 0.0.562

package/packages/test-utils/dist/index.js

@@ -1,1283 +1,1496 @@
-// src/setup/browser.ts
-import { JSDOM } from "jsdom";
-import { Canvas, Image, ImageData } from "@napi-rs/canvas";
-import "fake-indexeddb/auto";
-
-// src/e2e/input.ts
-var MockPointerLock = class {
-  static setup(doc) {
-    let _pointerLockElement = null;
-    Object.defineProperty(doc, "pointerLockElement", {
-      get: () => _pointerLockElement,
-      configurable: true
-    });
-    doc.exitPointerLock = () => {
-      if (_pointerLockElement) {
-        _pointerLockElement = null;
-        doc.dispatchEvent(new Event("pointerlockchange"));
-      }
-    };
-    global.HTMLElement.prototype.requestPointerLock = function() {
-      _pointerLockElement = this;
-      doc.dispatchEvent(new Event("pointerlockchange"));
-    };
-  }
-};
-var InputInjector = class {
-  constructor(doc, win) {
-    this.doc = doc;
-    this.win = win;
-  }
-  keyDown(key, code) {
-    const event = new this.win.KeyboardEvent("keydown", {
-      key,
-      code: code || key,
-      bubbles: true,
-      cancelable: true,
-      view: this.win
-    });
-    this.doc.dispatchEvent(event);
-  }
-  keyUp(key, code) {
-    const event = new this.win.KeyboardEvent("keyup", {
-      key,
-      code: code || key,
-      bubbles: true,
-      cancelable: true,
-      view: this.win
-    });
-    this.doc.dispatchEvent(event);
-  }
-  mouseMove(movementX, movementY, clientX = 0, clientY = 0) {
-    const event = new this.win.MouseEvent("mousemove", {
-      bubbles: true,
-      cancelable: true,
-      view: this.win,
-      clientX,
-      clientY,
-      movementX,
-      // Note: JSDOM might not support this standard property fully on event init
-      movementY
-    });
-    Object.defineProperty(event, "movementX", { value: movementX });
-    Object.defineProperty(event, "movementY", { value: movementY });
-    const target = this.doc.pointerLockElement || this.doc;
-    target.dispatchEvent(event);
-  }
-  mouseDown(button = 0) {
-    const event = new this.win.MouseEvent("mousedown", {
-      button,
-      bubbles: true,
-      cancelable: true,
-      view: this.win
-    });
-    const target = this.doc.pointerLockElement || this.doc;
-    target.dispatchEvent(event);
-  }
-  mouseUp(button = 0) {
-    const event = new this.win.MouseEvent("mouseup", {
-      button,
-      bubbles: true,
-      cancelable: true,
-      view: this.win
-    });
-    const target = this.doc.pointerLockElement || this.doc;
-    target.dispatchEvent(event);
-  }
-  wheel(deltaY) {
-    const event = new this.win.WheelEvent("wheel", {
-      deltaY,
-      bubbles: true,
-      cancelable: true,
-      view: this.win
-    });
-    const target = this.doc.pointerLockElement || this.doc;
-    target.dispatchEvent(event);
-  }
-};
+// src/shared/mocks.ts
+import { vi } from "vitest";
+var createBinaryWriterMock = () => ({
+  writeByte: vi.fn(),
+  writeShort: vi.fn(),
+  writeLong: vi.fn(),
+  writeString: vi.fn(),
+  writeBytes: vi.fn(),
+  getBuffer: vi.fn(() => new Uint8Array(0)),
+  reset: vi.fn(),
+  // Legacy methods (if any)
+  writeInt8: vi.fn(),
+  writeUint8: vi.fn(),
+  writeInt16: vi.fn(),
+  writeUint16: vi.fn(),
+  writeInt32: vi.fn(),
+  writeUint32: vi.fn(),
+  writeFloat: vi.fn(),
+  getData: vi.fn(() => new Uint8Array(0))
+});
+var createNetChanMock = () => ({
+  qport: 1234,
+  // Sequencing
+  incomingSequence: 0,
+  outgoingSequence: 0,
+  incomingAcknowledged: 0,
+  // Reliable messaging
+  incomingReliableAcknowledged: false,
+  incomingReliableSequence: 0,
+  outgoingReliableSequence: 0,
+  reliableMessage: createBinaryWriterMock(),
+  reliableLength: 0,
+  // Fragmentation
+  fragmentSendOffset: 0,
+  fragmentBuffer: null,
+  fragmentLength: 0,
+  fragmentReceived: 0,
+  // Timing
+  lastReceived: 0,
+  lastSent: 0,
+  remoteAddress: { type: "IP", port: 1234 },
+  // Methods
+  setup: vi.fn(),
+  reset: vi.fn(),
+  transmit: vi.fn(),
+  process: vi.fn(),
+  canSendReliable: vi.fn(() => true),
+  writeReliableByte: vi.fn(),
+  writeReliableShort: vi.fn(),
+  writeReliableLong: vi.fn(),
+  writeReliableString: vi.fn(),
+  getReliableData: vi.fn(() => new Uint8Array(0)),
+  needsKeepalive: vi.fn(() => false),
+  isTimedOut: vi.fn(() => false)
+});
+var createBinaryStreamMock = () => ({
+  getPosition: vi.fn(() => 0),
+  getReadPosition: vi.fn(() => 0),
+  getLength: vi.fn(() => 0),
+  getRemaining: vi.fn(() => 0),
+  seek: vi.fn(),
+  setReadPosition: vi.fn(),
+  hasMore: vi.fn(() => true),
+  hasBytes: vi.fn((amount) => true),
+  readChar: vi.fn(() => 0),
+  readByte: vi.fn(() => 0),
+  readShort: vi.fn(() => 0),
+  readUShort: vi.fn(() => 0),
+  readLong: vi.fn(() => 0),
+  readULong: vi.fn(() => 0),
+  readFloat: vi.fn(() => 0),
+  readString: vi.fn(() => ""),
+  readStringLine: vi.fn(() => ""),
+  readCoord: vi.fn(() => 0),
+  readAngle: vi.fn(() => 0),
+  readAngle16: vi.fn(() => 0),
+  readData: vi.fn((length) => new Uint8Array(length)),
+  readPos: vi.fn(),
+  readDir: vi.fn()
+});
 
-// src/setup/webgl.ts
-function createMockWebGL2Context(canvas) {
-  const gl = {
-    canvas,
-    drawingBufferWidth: canvas.width,
-    drawingBufferHeight: canvas.height,
-    // Constants
-    VERTEX_SHADER: 35633,
-    FRAGMENT_SHADER: 35632,
-    COMPILE_STATUS: 35713,
-    LINK_STATUS: 35714,
-    ARRAY_BUFFER: 34962,
-    ELEMENT_ARRAY_BUFFER: 34963,
-    STATIC_DRAW: 35044,
-    DYNAMIC_DRAW: 35048,
-    FLOAT: 5126,
-    DEPTH_TEST: 2929,
-    BLEND: 3042,
-    SRC_ALPHA: 770,
-    ONE_MINUS_SRC_ALPHA: 771,
-    TEXTURE_2D: 3553,
-    RGBA: 6408,
-    UNSIGNED_BYTE: 5121,
-    COLOR_BUFFER_BIT: 16384,
-    DEPTH_BUFFER_BIT: 256,
-    TRIANGLES: 4,
-    TRIANGLE_STRIP: 5,
-    TRIANGLE_FAN: 6,
-    // Methods
-    createShader: () => ({}),
-    shaderSource: () => {
-    },
-    compileShader: () => {
-    },
-    getShaderParameter: (_, param) => {
-      if (param === 35713) return true;
-      return true;
-    },
-    getShaderInfoLog: () => "",
-    createProgram: () => ({}),
-    attachShader: () => {
-    },
-    linkProgram: () => {
-    },
-    getProgramParameter: (_, param) => {
-      if (param === 35714) return true;
-      return true;
-    },
-    getProgramInfoLog: () => "",
-    useProgram: () => {
-    },
-    createBuffer: () => ({}),
-    bindBuffer: () => {
-    },
-    bufferData: () => {
-    },
-    enableVertexAttribArray: () => {
-    },
-    vertexAttribPointer: () => {
-    },
-    enable: () => {
-    },
-    disable: () => {
-    },
-    depthMask: () => {
-    },
-    blendFunc: () => {
-    },
-    viewport: () => {
-    },
-    clearColor: () => {
-    },
-    clear: () => {
-    },
-    createTexture: () => ({}),
-    bindTexture: () => {
-    },
-    texImage2D: () => {
-    },
-    texParameteri: () => {
-    },
-    activeTexture: () => {
-    },
-    uniform1i: () => {
-    },
-    uniform1f: () => {
-    },
-    uniform2f: () => {
-    },
-    uniform3f: () => {
-    },
-    uniform4f: () => {
-    },
-    uniformMatrix4fv: () => {
-    },
-    getUniformLocation: () => ({}),
-    getAttribLocation: () => 0,
-    drawArrays: () => {
-    },
-    drawElements: () => {
-    },
-    createVertexArray: () => ({}),
-    bindVertexArray: () => {
-    },
-    deleteShader: () => {
-    },
-    deleteProgram: () => {
-    },
-    deleteBuffer: () => {
-    },
-    deleteTexture: () => {
-    },
-    deleteVertexArray: () => {
-    },
-    // WebGL2 specific
-    texImage3D: () => {
-    },
-    uniformBlockBinding: () => {
-    },
-    getExtension: () => null
+// src/shared/bsp.ts
+import {
+  computePlaneSignBits,
+  CONTENTS_SOLID
+} from "@quake2ts/shared";
+function makePlane(normal, dist) {
+  return {
+    normal,
+    dist,
+    type: Math.abs(normal.x) === 1 ? 0 : Math.abs(normal.y) === 1 ? 1 : Math.abs(normal.z) === 1 ? 2 : 3,
+    signbits: computePlaneSignBits(normal)
+  };
+}
+function makeAxisBrush(size, contents = CONTENTS_SOLID) {
+  const half = size / 2;
+  const planes = [
+    makePlane({ x: 1, y: 0, z: 0 }, half),
+    makePlane({ x: -1, y: 0, z: 0 }, half),
+    makePlane({ x: 0, y: 1, z: 0 }, half),
+    makePlane({ x: 0, y: -1, z: 0 }, half),
+    makePlane({ x: 0, y: 0, z: 1 }, half),
+    makePlane({ x: 0, y: 0, z: -1 }, half)
+  ];
+  return {
+    contents,
+    sides: planes.map((plane) => ({ plane, surfaceFlags: 0 }))
+  };
+}
+function makeNode(plane, children) {
+  return { plane, children };
+}
+function makeBspModel(planes, nodes, leaves, brushes, leafBrushes) {
+  return {
+    planes,
+    nodes,
+    leaves,
+    brushes,
+    leafBrushes,
+    bmodels: []
+  };
+}
+function makeLeaf(contents, firstLeafBrush, numLeafBrushes) {
+  return { contents, cluster: 0, area: 0, firstLeafBrush, numLeafBrushes };
+}
+function makeLeafModel(brushes) {
+  const planes = brushes.flatMap((brush) => brush.sides.map((side) => side.plane));
+  return {
+    planes,
+    nodes: [],
+    leaves: [makeLeaf(0, 0, brushes.length)],
+    brushes,
+    leafBrushes: brushes.map((_, i) => i),
+    bmodels: []
   };
-  return gl;
 }
+function makeBrushFromMinsMaxs(mins, maxs, contents = CONTENTS_SOLID) {
+  const planes = [
+    makePlane({ x: 1, y: 0, z: 0 }, maxs.x),
+    makePlane({ x: -1, y: 0, z: 0 }, -mins.x),
+    makePlane({ x: 0, y: 1, z: 0 }, maxs.y),
+    makePlane({ x: 0, y: -1, z: 0 }, -mins.y),
+    makePlane({ x: 0, y: 0, z: 1 }, maxs.z),
+    makePlane({ x: 0, y: 0, z: -1 }, -mins.z)
+  ];
+  return {
+    contents,
+    sides: planes.map((plane) => ({ plane, surfaceFlags: 0 }))
+  };
+}
+
+// src/game/factories.ts
+var createPlayerStateFactory = (overrides) => ({
+  pm_type: 0,
+  pm_time: 0,
+  pm_flags: 0,
+  origin: { x: 0, y: 0, z: 0 },
+  velocity: { x: 0, y: 0, z: 0 },
+  viewAngles: { x: 0, y: 0, z: 0 },
+  onGround: false,
+  waterLevel: 0,
+  watertype: 0,
+  mins: { x: 0, y: 0, z: 0 },
+  maxs: { x: 0, y: 0, z: 0 },
+  damageAlpha: 0,
+  damageIndicators: [],
+  blend: [0, 0, 0, 0],
+  stats: [],
+  kick_angles: { x: 0, y: 0, z: 0 },
+  kick_origin: { x: 0, y: 0, z: 0 },
+  gunoffset: { x: 0, y: 0, z: 0 },
+  gunangles: { x: 0, y: 0, z: 0 },
+  gunindex: 0,
+  gun_frame: 0,
+  rdflags: 0,
+  fov: 90,
+  renderfx: 0,
+  ...overrides
+});
+var createEntityStateFactory = (overrides) => ({
+  number: 0,
+  origin: { x: 0, y: 0, z: 0 },
+  angles: { x: 0, y: 0, z: 0 },
+  oldOrigin: { x: 0, y: 0, z: 0 },
+  modelIndex: 0,
+  modelIndex2: 0,
+  modelIndex3: 0,
+  modelIndex4: 0,
+  frame: 0,
+  skinNum: 0,
+  effects: 0,
+  renderfx: 0,
+  solid: 0,
+  sound: 0,
+  event: 0,
+  ...overrides
+});
+var createGameStateSnapshotFactory = (overrides) => ({
+  gravity: { x: 0, y: 0, z: -800 },
+  origin: { x: 0, y: 0, z: 0 },
+  velocity: { x: 0, y: 0, z: 0 },
+  viewangles: { x: 0, y: 0, z: 0 },
+  level: { timeSeconds: 0, frameNumber: 0, previousTimeSeconds: 0, deltaSeconds: 0.1 },
+  entities: {
+    activeCount: 0,
+    worldClassname: "worldspawn"
+  },
+  packetEntities: [],
+  pmFlags: 0,
+  pmType: 0,
+  waterlevel: 0,
+  watertype: 0,
+  deltaAngles: { x: 0, y: 0, z: 0 },
+  health: 100,
+  armor: 0,
+  ammo: 0,
+  blend: [0, 0, 0, 0],
+  damageAlpha: 0,
+  damageIndicators: [],
+  stats: [],
+  kick_angles: { x: 0, y: 0, z: 0 },
+  kick_origin: { x: 0, y: 0, z: 0 },
+  gunoffset: { x: 0, y: 0, z: 0 },
+  gunangles: { x: 0, y: 0, z: 0 },
+  gunindex: 0,
+  pm_time: 0,
+  gun_frame: 0,
+  rdflags: 0,
+  fov: 90,
+  renderfx: 0,
+  pm_flags: 0,
+  pm_type: 0,
+  ...overrides
+});
 
-// src/setup/browser.ts
-function setupBrowserEnvironment(options = {}) {
-  const {
-    url = "http://localhost",
-    pretendToBeVisual = true,
-    resources = void 0,
-    enableWebGL2 = false,
-    enablePointerLock = false
-  } = options;
-  const dom = new JSDOM("<!DOCTYPE html><html><head></head><body></body></html>", {
-    url,
-    pretendToBeVisual,
-    resources
-  });
-  global.window = dom.window;
-  global.document = dom.window.document;
-  try {
-    global.navigator = dom.window.navigator;
-  } catch (e) {
-    try {
-      Object.defineProperty(global, "navigator", {
-        value: dom.window.navigator,
-        writable: true,
-        configurable: true
-      });
-    } catch (e2) {
-      console.warn("Could not assign global.navigator, skipping.");
-    }
-  }
-  global.location = dom.window.location;
-  global.HTMLElement = dom.window.HTMLElement;
-  global.HTMLCanvasElement = dom.window.HTMLCanvasElement;
-  global.Event = dom.window.Event;
-  global.CustomEvent = dom.window.CustomEvent;
-  global.DragEvent = dom.window.DragEvent;
-  global.MouseEvent = dom.window.MouseEvent;
-  global.KeyboardEvent = dom.window.KeyboardEvent;
-  global.FocusEvent = dom.window.FocusEvent;
-  global.WheelEvent = dom.window.WheelEvent;
-  global.InputEvent = dom.window.InputEvent;
-  global.UIEvent = dom.window.UIEvent;
-  try {
-    global.localStorage = dom.window.localStorage;
-  } catch (e) {
-  }
-  if (!global.localStorage) {
-    const storage = /* @__PURE__ */ new Map();
-    global.localStorage = {
-      getItem: (key) => storage.get(key) || null,
-      setItem: (key, value) => storage.set(key, value),
-      removeItem: (key) => storage.delete(key),
-      clear: () => storage.clear(),
-      key: (index) => Array.from(storage.keys())[index] || null,
-      get length() {
-        return storage.size;
-      }
-    };
-  }
-  const originalCreateElement = document.createElement.bind(document);
-  document.createElement = function(tagName, options2) {
-    if (tagName.toLowerCase() === "canvas") {
-      const napiCanvas = new Canvas(300, 150);
-      const domCanvas = originalCreateElement("canvas", options2);
-      Object.defineProperty(domCanvas, "width", {
-        get: () => napiCanvas.width,
-        set: (value) => {
-          napiCanvas.width = value;
-        },
-        enumerable: true,
-        configurable: true
-      });
-      Object.defineProperty(domCanvas, "height", {
-        get: () => napiCanvas.height,
-        set: (value) => {
-          napiCanvas.height = value;
-        },
-        enumerable: true,
-        configurable: true
-      });
-      const originalGetContext = domCanvas.getContext.bind(domCanvas);
-      domCanvas.getContext = function(contextId, options3) {
-        if (contextId === "2d") {
-          return napiCanvas.getContext("2d", options3);
-        }
-        if (enableWebGL2 && contextId === "webgl2") {
-          return createMockWebGL2Context(domCanvas);
-        }
-        if (contextId === "webgl" || contextId === "webgl2") {
-          return originalGetContext(contextId, options3);
-        }
-        return napiCanvas.getContext(contextId, options3);
-      };
-      domCanvas.__napiCanvas = napiCanvas;
-      return domCanvas;
-    }
-    return originalCreateElement(tagName, options2);
+// src/game/helpers.ts
+import { vi as vi2 } from "vitest";
+import { Entity, SpawnRegistry, ScriptHookRegistry } from "@quake2ts/game";
+import { createRandomGenerator } from "@quake2ts/shared";
+import { intersects, stairTrace, ladderTrace } from "@quake2ts/shared";
+var createMockEngine = () => ({
+  sound: vi2.fn(),
+  soundIndex: vi2.fn((sound) => 0),
+  modelIndex: vi2.fn((model) => 0),
+  centerprintf: vi2.fn()
+});
+var createMockGame = (seed = 12345) => {
+  const spawnRegistry = new SpawnRegistry();
+  const hooks = new ScriptHookRegistry();
+  const game = {
+    random: createRandomGenerator({ seed }),
+    registerEntitySpawn: vi2.fn((classname, spawnFunc) => {
+      spawnRegistry.register(classname, (entity) => spawnFunc(entity));
+    }),
+    unregisterEntitySpawn: vi2.fn((classname) => {
+      spawnRegistry.unregister(classname);
+    }),
+    getCustomEntities: vi2.fn(() => Array.from(spawnRegistry.keys())),
+    hooks,
+    registerHooks: vi2.fn((newHooks) => hooks.register(newHooks)),
+    spawnWorld: vi2.fn(() => {
+      hooks.onMapLoad("q2dm1");
+    }),
+    clientBegin: vi2.fn((client) => {
+      hooks.onPlayerSpawn({});
+    }),
+    damage: vi2.fn((amount) => {
+      hooks.onDamage({}, null, null, amount, 0, 0);
+    })
   };
-  if (enableWebGL2) {
-    const originalProtoGetContext = global.HTMLCanvasElement.prototype.getContext;
-    global.HTMLCanvasElement.prototype.getContext = function(contextId, options2) {
-      if (contextId === "webgl2") {
-        return createMockWebGL2Context(this);
+  return { game, spawnRegistry };
+};
+function createTestContext(options) {
+  const engine = createMockEngine();
+  const seed = options?.seed ?? 12345;
+  const { game, spawnRegistry } = createMockGame(seed);
+  const traceFn = vi2.fn((start, end, mins, maxs) => ({
+    fraction: 1,
+    ent: null,
+    allsolid: false,
+    startsolid: false,
+    endpos: end,
+    plane: { normal: { x: 0, y: 0, z: 1 }, dist: 0 },
+    surfaceFlags: 0,
+    contents: 0
+  }));
+  const entityList = options?.initialEntities ? [...options.initialEntities] : [];
+  const hooks = game.hooks;
+  const entities = {
+    spawn: vi2.fn(() => {
+      const ent = new Entity(entityList.length + 1);
+      entityList.push(ent);
+      hooks.onEntitySpawn(ent);
+      return ent;
+    }),
+    free: vi2.fn((ent) => {
+      const idx = entityList.indexOf(ent);
+      if (idx !== -1) {
+        entityList.splice(idx, 1);
       }
-      return originalProtoGetContext.call(this, contextId, options2);
-    };
-  }
-  global.Image = Image;
-  global.ImageData = ImageData;
-  if (typeof global.createImageBitmap === "undefined") {
-    global.createImageBitmap = async function(image, _options) {
-      if (image && typeof image.width === "number" && typeof image.height === "number") {
-        const canvas2 = new Canvas(image.width, image.height);
-        const ctx = canvas2.getContext("2d");
-        if (image.data) {
-          ctx.putImageData(image, 0, 0);
-        }
-        return canvas2;
+      hooks.onEntityRemove(ent);
+    }),
+    finalizeSpawn: vi2.fn(),
+    freeImmediate: vi2.fn((ent) => {
+      const idx = entityList.indexOf(ent);
+      if (idx !== -1) {
+        entityList.splice(idx, 1);
       }
-      const canvas = new Canvas(100, 100);
-      return canvas;
-    };
+    }),
+    setSpawnRegistry: vi2.fn(),
+    timeSeconds: 10,
+    deltaSeconds: 0.1,
+    modelIndex: vi2.fn(() => 0),
+    scheduleThink: vi2.fn((entity, time) => {
+      entity.nextthink = time;
+    }),
+    linkentity: vi2.fn(),
+    trace: traceFn,
+    pointcontents: vi2.fn(() => 0),
+    multicast: vi2.fn(),
+    unicast: vi2.fn(),
+    engine,
+    game,
+    sound: vi2.fn((ent, chan, sound, vol, attn, timeofs) => {
+      engine.sound(ent, chan, sound, vol, attn, timeofs);
+    }),
+    soundIndex: vi2.fn((sound) => engine.soundIndex(sound)),
+    useTargets: vi2.fn((entity, activator) => {
+    }),
+    findByTargetName: vi2.fn(() => []),
+    pickTarget: vi2.fn(() => null),
+    killBox: vi2.fn(),
+    rng: createRandomGenerator({ seed }),
+    imports: {
+      configstring: vi2.fn(),
+      trace: traceFn,
+      pointcontents: vi2.fn(() => 0)
+    },
+    level: {
+      intermission_angle: { x: 0, y: 0, z: 0 },
+      intermission_origin: { x: 0, y: 0, z: 0 },
+      next_auto_save: 0,
+      health_bar_entities: null
+    },
+    targetNameIndex: /* @__PURE__ */ new Map(),
+    forEachEntity: vi2.fn((callback) => {
+      entityList.forEach(callback);
+    }),
+    find: vi2.fn((predicate) => {
+      return entityList.find(predicate);
+    }),
+    findByClassname: vi2.fn((classname) => {
+      return entityList.find((e) => e.classname === classname);
+    }),
+    beginFrame: vi2.fn((timeSeconds) => {
+      entities.timeSeconds = timeSeconds;
+    }),
+    targetAwareness: {
+      timeSeconds: 10,
+      frameNumber: 1,
+      sightEntity: null,
+      soundEntity: null
+    },
+    // Adding missing properties to satisfy EntitySystem interface partially or fully
+    // We cast to unknown first anyway, but filling these in makes it safer for consumers
+    skill: 1,
+    deathmatch: false,
+    coop: false,
+    activeCount: entityList.length,
+    world: entityList.find((e) => e.classname === "worldspawn") || new Entity(0)
+    // ... other EntitySystem properties would go here
+  };
+  return {
+    keyValues: {},
+    entities,
+    game,
+    engine,
+    health_multiplier: 1,
+    warn: vi2.fn(),
+    free: vi2.fn(),
+    // Mock precache functions if they are part of SpawnContext in future or TestContext extensions
+    precacheModel: vi2.fn(),
+    precacheSound: vi2.fn(),
+    precacheImage: vi2.fn()
+  };
+}
+function createSpawnContext() {
+  return createTestContext();
+}
+function createEntity() {
+  return new Entity(1);
+}
+
+// src/game/mocks.ts
+function createMockGameState(overrides) {
+  return {
+    levelName: "test_level",
+    time: 0,
+    entities: [],
+    clients: [],
+    ...overrides
+  };
+}
+
+// src/server/mocks/transport.ts
+import { vi as vi3 } from "vitest";
+var MockTransport = class {
+  constructor() {
+    this.address = "127.0.0.1";
+    this.port = 27910;
+    this.sentMessages = [];
+    this.receivedMessages = [];
+    this.listening = false;
+    this.listenSpy = vi3.fn().mockImplementation(async (port) => {
+      this.port = port;
+      this.listening = true;
+    });
+    this.closeSpy = vi3.fn().mockImplementation(() => {
+      this.listening = false;
+    });
   }
-  if (typeof global.btoa === "undefined") {
-    global.btoa = function(str) {
-      return Buffer.from(str, "binary").toString("base64");
-    };
+  /**
+   * Start listening on the specified port.
+   */
+  async listen(port) {
+    return this.listenSpy(port);
   }
-  if (typeof global.atob === "undefined") {
-    global.atob = function(str) {
-      return Buffer.from(str, "base64").toString("binary");
-    };
+  /**
+   * Close the transport.
+   */
+  close() {
+    this.closeSpy();
   }
-  if (enablePointerLock) {
-    MockPointerLock.setup(global.document);
+  /**
+   * Register a callback for new connections.
+   */
+  onConnection(callback) {
+    this.onConnectionCallback = callback;
   }
-  if (typeof global.requestAnimationFrame === "undefined") {
-    let lastTime = 0;
-    global.requestAnimationFrame = (callback) => {
-      const currTime = Date.now();
-      const timeToCall = Math.max(0, 16 - (currTime - lastTime));
-      const id = setTimeout(() => {
-        callback(currTime + timeToCall);
-      }, timeToCall);
-      lastTime = currTime + timeToCall;
-      return id;
-    };
-    global.cancelAnimationFrame = (id) => {
-      clearTimeout(id);
-    };
+  /**
+   * Register a callback for errors.
+   */
+  onError(callback) {
+    this.onErrorCallback = callback;
   }
-}
-function teardownBrowserEnvironment() {
-  delete global.window;
-  delete global.document;
-  delete global.navigator;
-  delete global.localStorage;
-  delete global.location;
-  delete global.HTMLElement;
-  delete global.HTMLCanvasElement;
-  delete global.Image;
-  delete global.ImageData;
-  delete global.createImageBitmap;
-  delete global.Event;
-  delete global.CustomEvent;
-  delete global.DragEvent;
-  delete global.MouseEvent;
-  delete global.KeyboardEvent;
-  delete global.FocusEvent;
-  delete global.WheelEvent;
-  delete global.InputEvent;
-  delete global.UIEvent;
-}
-
-// src/setup/canvas.ts
-import { Canvas as Canvas2, Image as Image2, ImageData as ImageData2 } from "@napi-rs/canvas";
-function createMockCanvas(width = 300, height = 150) {
-  if (typeof document !== "undefined" && document.createElement) {
-    const canvas2 = document.createElement("canvas");
-    canvas2.width = width;
-    canvas2.height = height;
-    return canvas2;
+  /**
+   * Check if the transport is currently listening.
+   */
+  isListening() {
+    return this.listening;
   }
-  const canvas = new Canvas2(width, height);
-  const originalGetContext = canvas.getContext.bind(canvas);
-  canvas.getContext = function(contextId, options) {
-    if (contextId === "webgl2") {
-      return createMockWebGL2Context(canvas);
-    }
-    if (contextId === "2d") {
-      return originalGetContext("2d", options);
+  /**
+   * Helper to simulate a new connection.
+   * @param driver The network driver for the connection.
+   * @param info Optional connection info.
+   */
+  simulateConnection(driver, info) {
+    if (this.onConnectionCallback) {
+      this.onConnectionCallback(driver, info);
     }
-    return originalGetContext(contextId, options);
-  };
-  return canvas;
-}
-function createMockCanvasContext2D(canvas) {
-  if (!canvas) {
-    canvas = createMockCanvas();
   }
-  return canvas.getContext("2d");
-}
-function captureCanvasDrawCalls(context) {
-  const drawCalls = [];
-  const methodsToSpy = [
-    "fillRect",
-    "strokeRect",
-    "clearRect",
-    "fillText",
-    "strokeText",
-    "drawImage",
-    "beginPath",
-    "closePath",
-    "moveTo",
-    "lineTo",
-    "arc",
-    "arcTo",
-    "bezierCurveTo",
-    "quadraticCurveTo",
-    "stroke",
-    "fill",
-    "putImageData"
-  ];
-  methodsToSpy.forEach((method) => {
-    const original = context[method];
-    if (typeof original === "function") {
-      context[method] = function(...args) {
-        drawCalls.push({ method, args });
-        return original.apply(this, args);
-      };
-    }
-  });
-  return drawCalls;
-}
-function createMockImageData(width, height, fillColor) {
-  const imageData = new ImageData2(width, height);
-  if (fillColor) {
-    const [r, g, b, a] = fillColor;
-    for (let i = 0; i < imageData.data.length; i += 4) {
-      imageData.data[i] = r;
-      imageData.data[i + 1] = g;
-      imageData.data[i + 2] = b;
-      imageData.data[i + 3] = a;
+  /**
+   * Helper to simulate an error.
+   * @param error The error to simulate.
+   */
+  simulateError(error) {
+    if (this.onErrorCallback) {
+      this.onErrorCallback(error);
     }
   }
-  return imageData;
-}
-function createMockImage(width, height, src) {
-  const img = new Image2();
-  if (width) img.width = width;
-  if (height) img.height = height;
-  if (src) img.src = src;
-  return img;
-}
-
-// src/setup/node.ts
-function setupNodeEnvironment() {
-  if (typeof global.fetch === "undefined") {
-  }
-}
-
-// src/setup/storage.ts
-import "fake-indexeddb/auto";
-function createMockLocalStorage(initialData = {}) {
-  const storage = new Map(Object.entries(initialData));
-  return {
-    getItem: (key) => storage.get(key) || null,
-    setItem: (key, value) => storage.set(key, value),
-    removeItem: (key) => storage.delete(key),
-    clear: () => storage.clear(),
-    key: (index) => Array.from(storage.keys())[index] || null,
-    get length() {
-      return storage.size;
-    }
+};
+function createMockUDPSocket(overrides) {
+  const socket = {
+    send: vi3.fn(),
+    on: vi3.fn(),
+    close: vi3.fn(),
+    bind: vi3.fn(),
+    address: vi3.fn().mockReturnValue({ address: "127.0.0.1", family: "IPv4", port: 0 }),
+    ...overrides
   };
+  return socket;
 }
-function createMockSessionStorage(initialData = {}) {
-  return createMockLocalStorage(initialData);
-}
-function createMockIndexedDB() {
-  if (typeof indexedDB === "undefined") {
-    throw new Error("IndexedDB mock not found. Ensure fake-indexeddb is loaded.");
-  }
-  return indexedDB;
+function createMockNetworkAddress(ip = "127.0.0.1", port = 27910) {
+  return { ip, port };
 }
-function createStorageTestScenario(storageType = "local") {
-  const storage = storageType === "local" ? createMockLocalStorage() : createMockSessionStorage();
-  return {
-    storage,
-    populate(data) {
-      Object.entries(data).forEach(([k, v]) => storage.setItem(k, v));
-    },
-    verify(key, value) {
-      return storage.getItem(key) === value;
-    }
-  };
+function createMockTransport(address = "127.0.0.1", port = 27910, overrides) {
+  const transport = new MockTransport();
+  transport.address = address;
+  transport.port = port;
+  Object.assign(transport, overrides);
+  return transport;
 }
 
-// src/setup/audio.ts
-function createMockAudioContext() {
+// src/server/mocks/state.ts
+import { ServerState, ClientState } from "@quake2ts/server";
+import { MAX_CONFIGSTRINGS, MAX_EDICTS } from "@quake2ts/shared";
+import { vi as vi4 } from "vitest";
+function createMockServerState(overrides) {
   return {
-    createGain: () => ({
-      connect: () => {
-      },
-      gain: { value: 1, setValueAtTime: () => {
-      } }
-    }),
-    createOscillator: () => ({
-      connect: () => {
-      },
-      start: () => {
-      },
-      stop: () => {
-      },
-      frequency: { value: 440 }
-    }),
-    createBufferSource: () => ({
-      connect: () => {
-      },
-      start: () => {
-      },
-      stop: () => {
-      },
-      buffer: null,
-      playbackRate: { value: 1 },
-      loop: false
-    }),
-    destination: {},
-    currentTime: 0,
-    state: "running",
-    resume: async () => {
-    },
-    suspend: async () => {
+    state: ServerState.Game,
+    attractLoop: false,
+    loadGame: false,
+    startTime: Date.now(),
+    time: 0,
+    frame: 0,
+    name: "test_map",
+    collisionModel: null,
+    configStrings: new Array(MAX_CONFIGSTRINGS).fill(""),
+    baselines: new Array(MAX_EDICTS).fill(null),
+    multicastBuf: new Uint8Array(0),
+    ...overrides
+  };
+}
+function createMockServerStatic(maxClients = 16, overrides) {
+  return {
+    initialized: true,
+    realTime: Date.now(),
+    mapCmd: "",
+    spawnCount: 1,
+    clients: new Array(maxClients).fill(null),
+    lastHeartbeat: 0,
+    challenges: [],
+    ...overrides
+  };
+}
+function createMockServerClient(clientNum, overrides) {
+  const mockNet = {
+    connect: vi4.fn(),
+    disconnect: vi4.fn(),
+    send: vi4.fn(),
+    onMessage: vi4.fn(),
+    onClose: vi4.fn(),
+    onError: vi4.fn(),
+    isConnected: vi4.fn().mockReturnValue(true)
+  };
+  return {
+    index: clientNum,
+    state: ClientState.Connected,
+    edict: { index: clientNum + 1 },
+    net: mockNet,
+    netchan: {
+      qport: 0,
+      remoteAddress: "127.0.0.1",
+      incomingSequence: 0,
+      outgoingSequence: 0,
+      lastReceived: 0,
+      process: vi4.fn(),
+      transmit: vi4.fn(),
+      writeReliableByte: vi4.fn(),
+      writeReliableShort: vi4.fn(),
+      writeReliableLong: vi4.fn(),
+      writeReliableString: vi4.fn(),
+      writeReliableData: vi4.fn()
     },
-    close: async () => {
+    // Cast as any because NetChan might be complex to fully mock here
+    userInfo: "",
+    lastMessage: 0,
+    lastCommandTime: 0,
+    commandCount: 0,
+    messageQueue: [],
+    frames: [],
+    lastFrame: 0,
+    lastPacketEntities: [],
+    challenge: 0,
+    lastConnect: 0,
+    ping: 0,
+    rate: 0,
+    name: `Client${clientNum}`,
+    messageLevel: 0,
+    datagram: new Uint8Array(0),
+    downloadSize: 0,
+    downloadCount: 0,
+    commandMsec: 0,
+    frameLatency: [],
+    messageSize: [],
+    suppressCount: 0,
+    commandQueue: [],
+    lastCmd: {
+      msec: 0,
+      buttons: 0,
+      angles: { x: 0, y: 0, z: 0 },
+      forwardmove: 0,
+      sidemove: 0,
+      upmove: 0,
+      sequence: 0,
+      lightlevel: 0,
+      impulse: 0,
+      serverFrame: 0
     },
-    decodeAudioData: async (buffer) => ({
-      duration: 1,
-      length: 44100,
-      sampleRate: 44100,
-      numberOfChannels: 2,
-      getChannelData: () => new Float32Array(44100)
-    }),
-    createBuffer: (channels, length, sampleRate) => ({
-      duration: length / sampleRate,
-      length,
-      sampleRate,
-      numberOfChannels: channels,
-      getChannelData: () => new Float32Array(length)
-    })
+    ...overrides
   };
 }
-function setupMockAudioContext() {
-  if (typeof global.AudioContext === "undefined" && typeof global.window !== "undefined") {
-    global.AudioContext = class {
-      constructor() {
-        return createMockAudioContext();
+function createMockServer(overrides) {
+  return {
+    start: vi4.fn().mockResolvedValue(void 0),
+    stop: vi4.fn(),
+    multicast: vi4.fn(),
+    unicast: vi4.fn(),
+    configstring: vi4.fn(),
+    kickPlayer: vi4.fn(),
+    changeMap: vi4.fn().mockResolvedValue(void 0),
+    ...overrides
+  };
+}
+
+// src/setup/browser.ts
+import { JSDOM } from "jsdom";
+import { Canvas, Image, ImageData } from "@napi-rs/canvas";
+import "fake-indexeddb/auto";
+
+// src/e2e/input.ts
+var MockPointerLock = class {
+  static setup(doc) {
+    let _pointerLockElement = null;
+    Object.defineProperty(doc, "pointerLockElement", {
+      get: () => _pointerLockElement,
+      configurable: true
+    });
+    doc.exitPointerLock = () => {
+      if (_pointerLockElement) {
+        _pointerLockElement = null;
+        doc.dispatchEvent(new Event("pointerlockchange"));
       }
     };
-    global.window.AudioContext = global.AudioContext;
-    global.window.webkitAudioContext = global.AudioContext;
+    global.HTMLElement.prototype.requestPointerLock = function() {
+      _pointerLockElement = this;
+      doc.dispatchEvent(new Event("pointerlockchange"));
+    };
   }
-}
-function teardownMockAudioContext() {
-  if (global.AudioContext && global.AudioContext.toString().includes("class")) {
-    delete global.AudioContext;
-    delete global.window.AudioContext;
-    delete global.window.webkitAudioContext;
+};
+var InputInjector = class {
+  constructor(doc, win) {
+    this.doc = doc;
+    this.win = win;
   }
-}
-function captureAudioEvents(context) {
-  return [];
-}
+  keyDown(key, code) {
+    const event = new this.win.KeyboardEvent("keydown", {
+      key,
+      code: code || key,
+      bubbles: true,
+      cancelable: true,
+      view: this.win
+    });
+    this.doc.dispatchEvent(event);
+  }
+  keyUp(key, code) {
+    const event = new this.win.KeyboardEvent("keyup", {
+      key,
+      code: code || key,
+      bubbles: true,
+      cancelable: true,
+      view: this.win
+    });
+    this.doc.dispatchEvent(event);
+  }
+  mouseMove(movementX, movementY, clientX = 0, clientY = 0) {
+    const event = new this.win.MouseEvent("mousemove", {
+      bubbles: true,
+      cancelable: true,
+      view: this.win,
+      clientX,
+      clientY,
+      movementX,
+      // Note: JSDOM might not support this standard property fully on event init
+      movementY
+    });
+    Object.defineProperty(event, "movementX", { value: movementX });
+    Object.defineProperty(event, "movementY", { value: movementY });
+    const target = this.doc.pointerLockElement || this.doc;
+    target.dispatchEvent(event);
+  }
+  mouseDown(button = 0) {
+    const event = new this.win.MouseEvent("mousedown", {
+      button,
+      bubbles: true,
+      cancelable: true,
+      view: this.win
+    });
+    const target = this.doc.pointerLockElement || this.doc;
+    target.dispatchEvent(event);
+  }
+  mouseUp(button = 0) {
+    const event = new this.win.MouseEvent("mouseup", {
+      button,
+      bubbles: true,
+      cancelable: true,
+      view: this.win
+    });
+    const target = this.doc.pointerLockElement || this.doc;
+    target.dispatchEvent(event);
+  }
+  wheel(deltaY) {
+    const event = new this.win.WheelEvent("wheel", {
+      deltaY,
+      bubbles: true,
+      cancelable: true,
+      view: this.win
+    });
+    const target = this.doc.pointerLockElement || this.doc;
+    target.dispatchEvent(event);
+  }
+};
 
-// src/setup/timing.ts
-var activeMockRAF;
-function createMockRAF() {
-  let callbacks = [];
-  let nextId = 1;
-  let currentTime = 0;
-  const originalRAF = global.requestAnimationFrame;
-  const originalCancelRAF = global.cancelAnimationFrame;
-  const raf = (callback) => {
-    const id = nextId++;
-    callbacks.push({ id, callback });
-    return id;
-  };
-  const cancel = (id) => {
-    callbacks = callbacks.filter((cb) => cb.id !== id);
-  };
-  const mock = {
-    tick(timestamp) {
-      if (typeof timestamp !== "number") {
-        currentTime += 16.6;
-      } else {
-        currentTime = timestamp;
-      }
-      const currentCallbacks = [...callbacks];
-      callbacks = [];
-      currentCallbacks.forEach(({ callback }) => {
-        callback(currentTime);
-      });
+// src/setup/webgl.ts
+function createMockWebGL2Context(canvas) {
+  const gl = {
+    canvas,
+    drawingBufferWidth: canvas.width,
+    drawingBufferHeight: canvas.height,
+    // Constants
+    VERTEX_SHADER: 35633,
+    FRAGMENT_SHADER: 35632,
+    COMPILE_STATUS: 35713,
+    LINK_STATUS: 35714,
+    ARRAY_BUFFER: 34962,
+    ELEMENT_ARRAY_BUFFER: 34963,
+    STATIC_DRAW: 35044,
+    DYNAMIC_DRAW: 35048,
+    FLOAT: 5126,
+    DEPTH_TEST: 2929,
+    BLEND: 3042,
+    SRC_ALPHA: 770,
+    ONE_MINUS_SRC_ALPHA: 771,
+    TEXTURE_2D: 3553,
+    RGBA: 6408,
+    UNSIGNED_BYTE: 5121,
+    COLOR_BUFFER_BIT: 16384,
+    DEPTH_BUFFER_BIT: 256,
+    TRIANGLES: 4,
+    TRIANGLE_STRIP: 5,
+    TRIANGLE_FAN: 6,
+    // Methods
+    createShader: () => ({}),
+    shaderSource: () => {
+    },
+    compileShader: () => {
+    },
+    getShaderParameter: (_, param) => {
+      if (param === 35713) return true;
+      return true;
+    },
+    getShaderInfoLog: () => "",
+    createProgram: () => ({}),
+    attachShader: () => {
+    },
+    linkProgram: () => {
+    },
+    getProgramParameter: (_, param) => {
+      if (param === 35714) return true;
+      return true;
+    },
+    getProgramInfoLog: () => "",
+    useProgram: () => {
+    },
+    createBuffer: () => ({}),
+    bindBuffer: () => {
+    },
+    bufferData: () => {
+    },
+    enableVertexAttribArray: () => {
+    },
+    vertexAttribPointer: () => {
     },
-    advance(deltaMs = 16.6) {
-      this.tick(currentTime + deltaMs);
+    enable: () => {
     },
-    getCallbacks() {
-      return callbacks.map((c) => c.callback);
+    disable: () => {
     },
-    reset() {
-      callbacks = [];
-      nextId = 1;
-      currentTime = 0;
+    depthMask: () => {
     },
-    enable() {
-      activeMockRAF = this;
-      global.requestAnimationFrame = raf;
-      global.cancelAnimationFrame = cancel;
+    blendFunc: () => {
     },
-    disable() {
-      if (activeMockRAF === this) {
-        activeMockRAF = void 0;
-      }
-      if (originalRAF) {
-        global.requestAnimationFrame = originalRAF;
-      } else {
-        delete global.requestAnimationFrame;
-      }
-      if (originalCancelRAF) {
-        global.cancelAnimationFrame = originalCancelRAF;
-      } else {
-        delete global.cancelAnimationFrame;
-      }
-    }
-  };
-  return mock;
-}
-function createMockPerformance(startTime = 0) {
-  let currentTime = startTime;
-  const mockPerf = {
-    now: () => currentTime,
-    timeOrigin: startTime,
-    timing: {
-      navigationStart: startTime
+    viewport: () => {
     },
-    clearMarks: () => {
+    clearColor: () => {
     },
-    clearMeasures: () => {
+    clear: () => {
     },
-    clearResourceTimings: () => {
+    createTexture: () => ({}),
+    bindTexture: () => {
     },
-    getEntries: () => [],
-    getEntriesByName: () => [],
-    getEntriesByType: () => [],
-    mark: () => {
+    texImage2D: () => {
     },
-    measure: () => {
+    texParameteri: () => {
     },
-    setResourceTimingBufferSize: () => {
+    activeTexture: () => {
     },
-    toJSON: () => ({}),
-    addEventListener: () => {
+    uniform1i: () => {
     },
-    removeEventListener: () => {
+    uniform1f: () => {
     },
-    dispatchEvent: () => true
-  };
-  mockPerf.advance = (deltaMs) => {
-    currentTime += deltaMs;
-  };
-  mockPerf.setTime = (time) => {
-    currentTime = time;
-  };
-  return mockPerf;
-}
-function createControlledTimer() {
-  let currentTime = 0;
-  let timers = [];
-  let nextId = 1;
-  const originalSetTimeout = global.setTimeout;
-  const originalClearTimeout = global.clearTimeout;
-  const originalSetInterval = global.setInterval;
-  const originalClearInterval = global.clearInterval;
-  const mockSetTimeout = (callback, delay = 0, ...args) => {
-    const id = nextId++;
-    timers.push({ id, callback, dueTime: currentTime + delay, args });
-    return id;
-  };
-  const mockClearTimeout = (id) => {
-    timers = timers.filter((t) => t.id !== id);
-  };
-  const mockSetInterval = (callback, delay = 0, ...args) => {
-    const id = nextId++;
-    timers.push({ id, callback, dueTime: currentTime + delay, interval: delay, args });
-    return id;
-  };
-  const mockClearInterval = (id) => {
-    timers = timers.filter((t) => t.id !== id);
-  };
-  global.setTimeout = mockSetTimeout;
-  global.clearTimeout = mockClearTimeout;
-  global.setInterval = mockSetInterval;
-  global.clearInterval = mockClearInterval;
-  return {
-    tick() {
-      this.advanceBy(0);
+    uniform2f: () => {
     },
-    advanceBy(ms) {
-      const targetTime = currentTime + ms;
-      while (true) {
-        let earliest = null;
-        for (const t of timers) {
-          if (!earliest || t.dueTime < earliest.dueTime) {
-            earliest = t;
-          }
-        }
-        if (!earliest || earliest.dueTime > targetTime) {
-          break;
-        }
-        currentTime = earliest.dueTime;
-        const { callback, args, interval, id } = earliest;
-        if (interval !== void 0) {
-          earliest.dueTime += interval;
-          if (interval === 0) earliest.dueTime += 1;
-        } else {
-          timers = timers.filter((t) => t.id !== id);
-        }
-        callback(...args);
-      }
-      currentTime = targetTime;
+    uniform3f: () => {
     },
-    clear() {
-      timers = [];
+    uniform4f: () => {
     },
-    restore() {
-      global.setTimeout = originalSetTimeout;
-      global.clearTimeout = originalClearTimeout;
-      global.setInterval = originalSetInterval;
-      global.clearInterval = originalClearInterval;
-    }
-  };
-}
-function simulateFrames(count, frameTimeMs = 16.6, callback) {
-  if (!activeMockRAF) {
-    throw new Error("simulateFrames requires an active MockRAF. Ensure createMockRAF().enable() is called.");
-  }
-  for (let i = 0; i < count; i++) {
-    if (callback) callback(i);
-    activeMockRAF.advance(frameTimeMs);
-  }
-}
-function simulateFramesWithMock(mock, count, frameTimeMs = 16.6, callback) {
-  for (let i = 0; i < count; i++) {
-    if (callback) callback(i);
-    mock.advance(frameTimeMs);
-  }
-}
-
-// src/e2e/playwright.ts
-import { chromium } from "playwright";
-import { createServer } from "http";
-import handler from "serve-handler";
-async function createPlaywrightTestClient(options = {}) {
-  let staticServer;
-  let clientUrl = options.clientUrl;
-  const rootPath = options.rootPath || process.cwd();
-  if (!clientUrl) {
-    staticServer = createServer((request, response) => {
-      return handler(request, response, {
-        public: rootPath,
-        cleanUrls: false,
-        headers: [
-          {
-            source: "**/*",
-            headers: [
-              { key: "Cache-Control", value: "no-cache" },
-              { key: "Access-Control-Allow-Origin", value: "*" },
-              { key: "Cross-Origin-Opener-Policy", value: "same-origin" },
-              { key: "Cross-Origin-Embedder-Policy", value: "require-corp" }
-            ]
-          }
-        ]
-      });
-    });
-    await new Promise((resolve) => {
-      if (!staticServer) return;
-      staticServer.listen(0, () => {
-        const addr = staticServer?.address();
-        const port = typeof addr === "object" ? addr?.port : 0;
-        clientUrl = `http://localhost:${port}`;
-        console.log(`Test client serving from ${rootPath} at ${clientUrl}`);
-        resolve();
-      });
-    });
-  }
-  const browser = await chromium.launch({
-    headless: options.headless ?? true,
-    args: [
-      "--use-gl=egl",
-      "--ignore-gpu-blocklist",
-      ...options.launchOptions?.args || []
-    ],
-    ...options.launchOptions
-  });
-  const width = options.width || 1280;
-  const height = options.height || 720;
-  const context = await browser.newContext({
-    viewport: { width, height },
-    deviceScaleFactor: 1,
-    ...options.contextOptions
-  });
-  const page = await context.newPage();
-  const close = async () => {
-    await browser.close();
-    if (staticServer) {
-      staticServer.close();
-    }
-  };
-  const navigate = async (url) => {
-    const targetUrl = url || clientUrl;
-    if (!targetUrl) throw new Error("No URL to navigate to");
-    let finalUrl = targetUrl;
-    if (options.serverUrl && !targetUrl.includes("connect=")) {
-      const separator = targetUrl.includes("?") ? "&" : "?";
-      finalUrl = `${targetUrl}${separator}connect=${encodeURIComponent(options.serverUrl)}`;
-    }
-    console.log(`Navigating to: ${finalUrl}`);
-    await page.goto(finalUrl, { waitUntil: "domcontentloaded" });
-  };
-  return {
-    browser,
-    context,
-    page,
-    server: staticServer,
-    close,
-    navigate,
-    waitForGame: async (timeout = 1e4) => {
-      await waitForGameReady(page, timeout);
+    uniformMatrix4fv: () => {
+    },
+    getUniformLocation: () => ({}),
+    getAttribLocation: () => 0,
+    drawArrays: () => {
+    },
+    drawElements: () => {
+    },
+    createVertexArray: () => ({}),
+    bindVertexArray: () => {
+    },
+    deleteShader: () => {
+    },
+    deleteProgram: () => {
+    },
+    deleteBuffer: () => {
+    },
+    deleteTexture: () => {
+    },
+    deleteVertexArray: () => {
     },
-    injectInput: async (type, data) => {
-      await page.evaluate(({ type: type2, data: data2 }) => {
-        if (window.injectGameInput) window.injectGameInput(type2, data2);
-      }, { type, data });
-    }
+    // WebGL2 specific
+    texImage3D: () => {
+    },
+    uniformBlockBinding: () => {
+    },
+    getExtension: () => null
   };
+  return gl;
 }
-async function waitForGameReady(page, timeout = 1e4) {
+
+// src/setup/browser.ts
+function setupBrowserEnvironment(options = {}) {
+  const {
+    url = "http://localhost",
+    pretendToBeVisual = true,
+    resources = void 0,
+    enableWebGL2 = false,
+    enablePointerLock = false
+  } = options;
+  const dom = new JSDOM("<!DOCTYPE html><html><head></head><body></body></html>", {
+    url,
+    pretendToBeVisual,
+    resources
+  });
+  global.window = dom.window;
+  global.document = dom.window.document;
   try {
-    await page.waitForFunction(() => {
-      return window.gameInstance && window.gameInstance.isReady;
-    }, null, { timeout });
+    global.navigator = dom.window.navigator;
   } catch (e) {
-    await page.waitForSelector("canvas", { timeout });
+    try {
+      Object.defineProperty(global, "navigator", {
+        value: dom.window.navigator,
+        writable: true,
+        configurable: true
+      });
+    } catch (e2) {
+      console.warn("Could not assign global.navigator, skipping.");
+    }
   }
-}
-async function captureGameState(page) {
-  return await page.evaluate(() => {
-    if (window.gameInstance && window.gameInstance.getState) {
-      return window.gameInstance.getState();
+  global.location = dom.window.location;
+  global.HTMLElement = dom.window.HTMLElement;
+  global.HTMLCanvasElement = dom.window.HTMLCanvasElement;
+  global.Event = dom.window.Event;
+  global.CustomEvent = dom.window.CustomEvent;
+  global.DragEvent = dom.window.DragEvent;
+  global.MouseEvent = dom.window.MouseEvent;
+  global.KeyboardEvent = dom.window.KeyboardEvent;
+  global.FocusEvent = dom.window.FocusEvent;
+  global.WheelEvent = dom.window.WheelEvent;
+  global.InputEvent = dom.window.InputEvent;
+  global.UIEvent = dom.window.UIEvent;
+  try {
+    global.localStorage = dom.window.localStorage;
+  } catch (e) {
+  }
+  if (!global.localStorage) {
+    const storage = /* @__PURE__ */ new Map();
+    global.localStorage = {
+      getItem: (key) => storage.get(key) || null,
+      setItem: (key, value) => storage.set(key, value),
+      removeItem: (key) => storage.delete(key),
+      clear: () => storage.clear(),
+      key: (index) => Array.from(storage.keys())[index] || null,
+      get length() {
+        return storage.size;
+      }
+    };
+  }
+  const originalCreateElement = document.createElement.bind(document);
+  document.createElement = function(tagName, options2) {
+    if (tagName.toLowerCase() === "canvas") {
+      const napiCanvas = new Canvas(300, 150);
+      const domCanvas = originalCreateElement("canvas", options2);
+      Object.defineProperty(domCanvas, "width", {
+        get: () => napiCanvas.width,
+        set: (value) => {
+          napiCanvas.width = value;
+        },
+        enumerable: true,
+        configurable: true
+      });
+      Object.defineProperty(domCanvas, "height", {
+        get: () => napiCanvas.height,
+        set: (value) => {
+          napiCanvas.height = value;
+        },
+        enumerable: true,
+        configurable: true
+      });
+      const originalGetContext = domCanvas.getContext.bind(domCanvas);
+      domCanvas.getContext = function(contextId, options3) {
+        if (contextId === "2d") {
+          return napiCanvas.getContext("2d", options3);
+        }
+        if (enableWebGL2 && contextId === "webgl2") {
+          return createMockWebGL2Context(domCanvas);
+        }
+        if (contextId === "webgl" || contextId === "webgl2") {
+          return originalGetContext(contextId, options3);
+        }
+        return napiCanvas.getContext(contextId, options3);
+      };
+      domCanvas.__napiCanvas = napiCanvas;
+      return domCanvas;
     }
-    return {};
-  });
-}
-
-// src/shared/bsp.ts
-import {
-  computePlaneSignBits,
-  CONTENTS_SOLID
-} from "@quake2ts/shared";
-function makePlane(normal, dist) {
-  return {
-    normal,
-    dist,
-    type: Math.abs(normal.x) === 1 ? 0 : Math.abs(normal.y) === 1 ? 1 : Math.abs(normal.z) === 1 ? 2 : 3,
-    signbits: computePlaneSignBits(normal)
-  };
-}
-function makeAxisBrush(size, contents = CONTENTS_SOLID) {
-  const half = size / 2;
-  const planes = [
-    makePlane({ x: 1, y: 0, z: 0 }, half),
-    makePlane({ x: -1, y: 0, z: 0 }, half),
-    makePlane({ x: 0, y: 1, z: 0 }, half),
-    makePlane({ x: 0, y: -1, z: 0 }, half),
-    makePlane({ x: 0, y: 0, z: 1 }, half),
-    makePlane({ x: 0, y: 0, z: -1 }, half)
-  ];
-  return {
-    contents,
-    sides: planes.map((plane) => ({ plane, surfaceFlags: 0 }))
-  };
-}
-function makeNode(plane, children) {
-  return { plane, children };
-}
-function makeBspModel(planes, nodes, leaves, brushes, leafBrushes) {
-  return {
-    planes,
-    nodes,
-    leaves,
-    brushes,
-    leafBrushes,
-    bmodels: []
+    return originalCreateElement(tagName, options2);
   };
+  if (enableWebGL2) {
+    const originalProtoGetContext = global.HTMLCanvasElement.prototype.getContext;
+    global.HTMLCanvasElement.prototype.getContext = function(contextId, options2) {
+      if (contextId === "webgl2") {
+        return createMockWebGL2Context(this);
+      }
+      return originalProtoGetContext.call(this, contextId, options2);
+    };
+  }
+  global.Image = Image;
+  global.ImageData = ImageData;
+  if (typeof global.createImageBitmap === "undefined") {
+    global.createImageBitmap = async function(image, _options) {
+      if (image && typeof image.width === "number" && typeof image.height === "number") {
+        const canvas2 = new Canvas(image.width, image.height);
+        const ctx = canvas2.getContext("2d");
+        if (image.data) {
+          ctx.putImageData(image, 0, 0);
+        }
+        return canvas2;
+      }
+      const canvas = new Canvas(100, 100);
+      return canvas;
+    };
+  }
+  if (typeof global.btoa === "undefined") {
+    global.btoa = function(str) {
+      return Buffer.from(str, "binary").toString("base64");
+    };
+  }
+  if (typeof global.atob === "undefined") {
+    global.atob = function(str) {
+      return Buffer.from(str, "base64").toString("binary");
+    };
+  }
+  if (enablePointerLock) {
+    MockPointerLock.setup(global.document);
+  }
+  if (typeof global.requestAnimationFrame === "undefined") {
+    let lastTime = 0;
+    global.requestAnimationFrame = (callback) => {
+      const currTime = Date.now();
+      const timeToCall = Math.max(0, 16 - (currTime - lastTime));
+      const id = setTimeout(() => {
+        callback(currTime + timeToCall);
+      }, timeToCall);
+      lastTime = currTime + timeToCall;
+      return id;
+    };
+    global.cancelAnimationFrame = (id) => {
+      clearTimeout(id);
+    };
+  }
 }
-function makeLeaf(contents, firstLeafBrush, numLeafBrushes) {
-  return { contents, cluster: 0, area: 0, firstLeafBrush, numLeafBrushes };
+function teardownBrowserEnvironment() {
+  delete global.window;
+  delete global.document;
+  delete global.navigator;
+  delete global.localStorage;
+  delete global.location;
+  delete global.HTMLElement;
+  delete global.HTMLCanvasElement;
+  delete global.Image;
+  delete global.ImageData;
+  delete global.createImageBitmap;
+  delete global.Event;
+  delete global.CustomEvent;
+  delete global.DragEvent;
+  delete global.MouseEvent;
+  delete global.KeyboardEvent;
+  delete global.FocusEvent;
+  delete global.WheelEvent;
+  delete global.InputEvent;
+  delete global.UIEvent;
 }
-function makeLeafModel(brushes) {
-  const planes = brushes.flatMap((brush) => brush.sides.map((side) => side.plane));
-  return {
-    planes,
-    nodes: [],
-    leaves: [makeLeaf(0, 0, brushes.length)],
-    brushes,
-    leafBrushes: brushes.map((_, i) => i),
-    bmodels: []
+
+// src/setup/canvas.ts
+import { Canvas as Canvas2, Image as Image2, ImageData as ImageData2 } from "@napi-rs/canvas";
+function createMockCanvas(width = 300, height = 150) {
+  if (typeof document !== "undefined" && document.createElement) {
+    const canvas2 = document.createElement("canvas");
+    canvas2.width = width;
+    canvas2.height = height;
+    return canvas2;
+  }
+  const canvas = new Canvas2(width, height);
+  const originalGetContext = canvas.getContext.bind(canvas);
+  canvas.getContext = function(contextId, options) {
+    if (contextId === "webgl2") {
+      return createMockWebGL2Context(canvas);
+    }
+    if (contextId === "2d") {
+      return originalGetContext("2d", options);
+    }
+    return originalGetContext(contextId, options);
   };
+  return canvas;
 }
-function makeBrushFromMinsMaxs(mins, maxs, contents = CONTENTS_SOLID) {
-  const planes = [
-    makePlane({ x: 1, y: 0, z: 0 }, maxs.x),
-    makePlane({ x: -1, y: 0, z: 0 }, -mins.x),
-    makePlane({ x: 0, y: 1, z: 0 }, maxs.y),
-    makePlane({ x: 0, y: -1, z: 0 }, -mins.y),
-    makePlane({ x: 0, y: 0, z: 1 }, maxs.z),
-    makePlane({ x: 0, y: 0, z: -1 }, -mins.z)
+function createMockCanvasContext2D(canvas) {
+  if (!canvas) {
+    canvas = createMockCanvas();
+  }
+  return canvas.getContext("2d");
+}
+function captureCanvasDrawCalls(context) {
+  const drawCalls = [];
+  const methodsToSpy = [
+    "fillRect",
+    "strokeRect",
+    "clearRect",
+    "fillText",
+    "strokeText",
+    "drawImage",
+    "beginPath",
+    "closePath",
+    "moveTo",
+    "lineTo",
+    "arc",
+    "arcTo",
+    "bezierCurveTo",
+    "quadraticCurveTo",
+    "stroke",
+    "fill",
+    "putImageData"
   ];
-  return {
-    contents,
-    sides: planes.map((plane) => ({ plane, surfaceFlags: 0 }))
-  };
+  methodsToSpy.forEach((method) => {
+    const original = context[method];
+    if (typeof original === "function") {
+      context[method] = function(...args) {
+        drawCalls.push({ method, args });
+        return original.apply(this, args);
+      };
+    }
+  });
+  return drawCalls;
+}
+function createMockImageData(width, height, fillColor) {
+  const imageData = new ImageData2(width, height);
+  if (fillColor) {
+    const [r, g, b, a] = fillColor;
+    for (let i = 0; i < imageData.data.length; i += 4) {
+      imageData.data[i] = r;
+      imageData.data[i + 1] = g;
+      imageData.data[i + 2] = b;
+      imageData.data[i + 3] = a;
+    }
+  }
+  return imageData;
+}
+function createMockImage(width, height, src) {
+  const img = new Image2();
+  if (width) img.width = width;
+  if (height) img.height = height;
+  if (src) img.src = src;
+  return img;
 }
 
-// src/shared/mocks.ts
-import { vi } from "vitest";
-var createBinaryWriterMock = () => ({
-  writeByte: vi.fn(),
-  writeShort: vi.fn(),
-  writeLong: vi.fn(),
-  writeString: vi.fn(),
-  writeBytes: vi.fn(),
-  getBuffer: vi.fn(() => new Uint8Array(0)),
-  reset: vi.fn(),
-  // Legacy methods (if any)
-  writeInt8: vi.fn(),
-  writeUint8: vi.fn(),
-  writeInt16: vi.fn(),
-  writeUint16: vi.fn(),
-  writeInt32: vi.fn(),
-  writeUint32: vi.fn(),
-  writeFloat: vi.fn(),
-  getData: vi.fn(() => new Uint8Array(0))
-});
-var createNetChanMock = () => ({
-  qport: 1234,
-  // Sequencing
-  incomingSequence: 0,
-  outgoingSequence: 0,
-  incomingAcknowledged: 0,
-  // Reliable messaging
-  incomingReliableAcknowledged: false,
-  incomingReliableSequence: 0,
-  outgoingReliableSequence: 0,
-  reliableMessage: createBinaryWriterMock(),
-  reliableLength: 0,
-  // Fragmentation
-  fragmentSendOffset: 0,
-  fragmentBuffer: null,
-  fragmentLength: 0,
-  fragmentReceived: 0,
-  // Timing
-  lastReceived: 0,
-  lastSent: 0,
-  remoteAddress: { type: "IP", port: 1234 },
-  // Methods
-  setup: vi.fn(),
-  reset: vi.fn(),
-  transmit: vi.fn(),
-  process: vi.fn(),
-  canSendReliable: vi.fn(() => true),
-  writeReliableByte: vi.fn(),
-  writeReliableShort: vi.fn(),
-  writeReliableLong: vi.fn(),
-  writeReliableString: vi.fn(),
-  getReliableData: vi.fn(() => new Uint8Array(0)),
-  needsKeepalive: vi.fn(() => false),
-  isTimedOut: vi.fn(() => false)
-});
-var createBinaryStreamMock = () => ({
-  getPosition: vi.fn(() => 0),
-  getReadPosition: vi.fn(() => 0),
-  getLength: vi.fn(() => 0),
-  getRemaining: vi.fn(() => 0),
-  seek: vi.fn(),
-  setReadPosition: vi.fn(),
-  hasMore: vi.fn(() => true),
-  hasBytes: vi.fn((amount) => true),
-  readChar: vi.fn(() => 0),
-  readByte: vi.fn(() => 0),
-  readShort: vi.fn(() => 0),
-  readUShort: vi.fn(() => 0),
-  readLong: vi.fn(() => 0),
-  readULong: vi.fn(() => 0),
-  readFloat: vi.fn(() => 0),
-  readString: vi.fn(() => ""),
-  readStringLine: vi.fn(() => ""),
-  readCoord: vi.fn(() => 0),
-  readAngle: vi.fn(() => 0),
-  readAngle16: vi.fn(() => 0),
-  readData: vi.fn((length) => new Uint8Array(length)),
-  readPos: vi.fn(),
-  readDir: vi.fn()
-});
+// src/setup/node.ts
+function setupNodeEnvironment() {
+  if (typeof global.fetch === "undefined") {
+  }
+}
 
-// src/game/factories.ts
-var createPlayerStateFactory = (overrides) => ({
-  pm_type: 0,
-  pm_time: 0,
-  pm_flags: 0,
-  origin: { x: 0, y: 0, z: 0 },
-  velocity: { x: 0, y: 0, z: 0 },
-  viewAngles: { x: 0, y: 0, z: 0 },
-  onGround: false,
-  waterLevel: 0,
-  watertype: 0,
-  mins: { x: 0, y: 0, z: 0 },
-  maxs: { x: 0, y: 0, z: 0 },
-  damageAlpha: 0,
-  damageIndicators: [],
-  blend: [0, 0, 0, 0],
-  stats: [],
-  kick_angles: { x: 0, y: 0, z: 0 },
-  kick_origin: { x: 0, y: 0, z: 0 },
-  gunoffset: { x: 0, y: 0, z: 0 },
-  gunangles: { x: 0, y: 0, z: 0 },
-  gunindex: 0,
-  gun_frame: 0,
-  rdflags: 0,
-  fov: 90,
-  renderfx: 0,
-  ...overrides
-});
-var createEntityStateFactory = (overrides) => ({
-  number: 0,
-  origin: { x: 0, y: 0, z: 0 },
-  angles: { x: 0, y: 0, z: 0 },
-  oldOrigin: { x: 0, y: 0, z: 0 },
-  modelIndex: 0,
-  modelIndex2: 0,
-  modelIndex3: 0,
-  modelIndex4: 0,
-  frame: 0,
-  skinNum: 0,
-  effects: 0,
-  renderfx: 0,
-  solid: 0,
-  sound: 0,
-  event: 0,
-  ...overrides
-});
-var createGameStateSnapshotFactory = (overrides) => ({
-  gravity: { x: 0, y: 0, z: -800 },
-  origin: { x: 0, y: 0, z: 0 },
-  velocity: { x: 0, y: 0, z: 0 },
-  viewangles: { x: 0, y: 0, z: 0 },
-  level: { timeSeconds: 0, frameNumber: 0, previousTimeSeconds: 0, deltaSeconds: 0.1 },
-  entities: {
-    activeCount: 0,
-    worldClassname: "worldspawn"
-  },
-  packetEntities: [],
-  pmFlags: 0,
-  pmType: 0,
-  waterlevel: 0,
-  watertype: 0,
-  deltaAngles: { x: 0, y: 0, z: 0 },
-  health: 100,
-  armor: 0,
-  ammo: 0,
-  blend: [0, 0, 0, 0],
-  damageAlpha: 0,
-  damageIndicators: [],
-  stats: [],
-  kick_angles: { x: 0, y: 0, z: 0 },
-  kick_origin: { x: 0, y: 0, z: 0 },
-  gunoffset: { x: 0, y: 0, z: 0 },
-  gunangles: { x: 0, y: 0, z: 0 },
-  gunindex: 0,
-  pm_time: 0,
-  gun_frame: 0,
-  rdflags: 0,
-  fov: 90,
-  renderfx: 0,
-  pm_flags: 0,
-  pm_type: 0,
-  ...overrides
-});
+// src/setup/storage.ts
+import "fake-indexeddb/auto";
+function createMockLocalStorage(initialData = {}) {
+  const storage = new Map(Object.entries(initialData));
+  return {
+    getItem: (key) => storage.get(key) || null,
+    setItem: (key, value) => storage.set(key, value),
+    removeItem: (key) => storage.delete(key),
+    clear: () => storage.clear(),
+    key: (index) => Array.from(storage.keys())[index] || null,
+    get length() {
+      return storage.size;
+    }
+  };
+}
+function createMockSessionStorage(initialData = {}) {
+  return createMockLocalStorage(initialData);
+}
+function createMockIndexedDB() {
+  if (typeof indexedDB === "undefined") {
+    throw new Error("IndexedDB mock not found. Ensure fake-indexeddb is loaded.");
+  }
+  return indexedDB;
+}
+function createStorageTestScenario(storageType = "local") {
+  const storage = storageType === "local" ? createMockLocalStorage() : createMockSessionStorage();
+  return {
+    storage,
+    populate(data) {
+      Object.entries(data).forEach(([k, v]) => storage.setItem(k, v));
+    },
+    verify(key, value) {
+      return storage.getItem(key) === value;
+    }
+  };
+}
 
-// src/game/helpers.ts
-import { vi as vi2 } from "vitest";
-import { Entity, SpawnRegistry, ScriptHookRegistry } from "@quake2ts/game";
-import { createRandomGenerator } from "@quake2ts/shared";
-import { intersects, stairTrace, ladderTrace } from "@quake2ts/shared";
-var createMockEngine = () => ({
-  sound: vi2.fn(),
-  soundIndex: vi2.fn((sound) => 0),
-  modelIndex: vi2.fn((model) => 0),
-  centerprintf: vi2.fn()
-});
-var createMockGame = (seed = 12345) => {
-  const spawnRegistry = new SpawnRegistry();
-  const hooks = new ScriptHookRegistry();
-  const game = {
-    random: createRandomGenerator({ seed }),
-    registerEntitySpawn: vi2.fn((classname, spawnFunc) => {
-      spawnRegistry.register(classname, (entity) => spawnFunc(entity));
+// src/setup/audio.ts
+function createMockAudioContext() {
+  return {
+    createGain: () => ({
+      connect: () => {
+      },
+      gain: { value: 1, setValueAtTime: () => {
+      } }
     }),
-    unregisterEntitySpawn: vi2.fn((classname) => {
-      spawnRegistry.unregister(classname);
+    createOscillator: () => ({
+      connect: () => {
+      },
+      start: () => {
+      },
+      stop: () => {
+      },
+      frequency: { value: 440 }
     }),
-    getCustomEntities: vi2.fn(() => Array.from(spawnRegistry.keys())),
-    hooks,
-    registerHooks: vi2.fn((newHooks) => hooks.register(newHooks)),
-    spawnWorld: vi2.fn(() => {
-      hooks.onMapLoad("q2dm1");
+    createBufferSource: () => ({
+      connect: () => {
+      },
+      start: () => {
+      },
+      stop: () => {
+      },
+      buffer: null,
+      playbackRate: { value: 1 },
+      loop: false
     }),
-    clientBegin: vi2.fn((client) => {
-      hooks.onPlayerSpawn({});
+    destination: {},
+    currentTime: 0,
+    state: "running",
+    resume: async () => {
+    },
+    suspend: async () => {
+    },
+    close: async () => {
+    },
+    decodeAudioData: async (buffer) => ({
+      duration: 1,
+      length: 44100,
+      sampleRate: 44100,
+      numberOfChannels: 2,
+      getChannelData: () => new Float32Array(44100)
     }),
-    damage: vi2.fn((amount) => {
-      hooks.onDamage({}, null, null, amount, 0, 0);
+    createBuffer: (channels, length, sampleRate) => ({
+      duration: length / sampleRate,
+      length,
+      sampleRate,
+      numberOfChannels: channels,
+      getChannelData: () => new Float32Array(length)
     })
   };
-  return { game, spawnRegistry };
-};
-function createTestContext(options) {
-  const engine = createMockEngine();
-  const seed = options?.seed ?? 12345;
-  const { game, spawnRegistry } = createMockGame(seed);
-  const traceFn = vi2.fn((start, end, mins, maxs) => ({
-    fraction: 1,
-    ent: null,
-    allsolid: false,
-    startsolid: false,
-    endpos: end,
-    plane: { normal: { x: 0, y: 0, z: 1 }, dist: 0 },
-    surfaceFlags: 0,
-    contents: 0
-  }));
-  const entityList = options?.initialEntities ? [...options.initialEntities] : [];
-  const hooks = game.hooks;
-  const entities = {
-    spawn: vi2.fn(() => {
-      const ent = new Entity(entityList.length + 1);
-      entityList.push(ent);
-      hooks.onEntitySpawn(ent);
-      return ent;
-    }),
-    free: vi2.fn((ent) => {
-      const idx = entityList.indexOf(ent);
-      if (idx !== -1) {
-        entityList.splice(idx, 1);
+}
+function setupMockAudioContext() {
+  if (typeof global.AudioContext === "undefined" && typeof global.window !== "undefined") {
+    global.AudioContext = class {
+      constructor() {
+        return createMockAudioContext();
       }
-      hooks.onEntityRemove(ent);
-    }),
-    finalizeSpawn: vi2.fn(),
-    freeImmediate: vi2.fn((ent) => {
-      const idx = entityList.indexOf(ent);
-      if (idx !== -1) {
-        entityList.splice(idx, 1);
+    };
+    global.window.AudioContext = global.AudioContext;
+    global.window.webkitAudioContext = global.AudioContext;
+  }
+}
+function teardownMockAudioContext() {
+  if (global.AudioContext && global.AudioContext.toString().includes("class")) {
+    delete global.AudioContext;
+    delete global.window.AudioContext;
+    delete global.window.webkitAudioContext;
+  }
+}
+function captureAudioEvents(context) {
+  return [];
+}
+
+// src/setup/timing.ts
+var activeMockRAF;
+function createMockRAF() {
+  let callbacks = [];
+  let nextId = 1;
+  let currentTime = 0;
+  const originalRAF = global.requestAnimationFrame;
+  const originalCancelRAF = global.cancelAnimationFrame;
+  const raf = (callback) => {
+    const id = nextId++;
+    callbacks.push({ id, callback });
+    return id;
+  };
+  const cancel = (id) => {
+    callbacks = callbacks.filter((cb) => cb.id !== id);
+  };
+  const mock = {
+    tick(timestamp) {
+      if (typeof timestamp !== "number") {
+        currentTime += 16.6;
+      } else {
+        currentTime = timestamp;
       }
-    }),
-    setSpawnRegistry: vi2.fn(),
-    timeSeconds: 10,
-    deltaSeconds: 0.1,
-    modelIndex: vi2.fn(() => 0),
-    scheduleThink: vi2.fn((entity, time) => {
-      entity.nextthink = time;
-    }),
-    linkentity: vi2.fn(),
-    trace: traceFn,
-    pointcontents: vi2.fn(() => 0),
-    multicast: vi2.fn(),
-    unicast: vi2.fn(),
-    engine,
-    game,
-    sound: vi2.fn((ent, chan, sound, vol, attn, timeofs) => {
-      engine.sound(ent, chan, sound, vol, attn, timeofs);
-    }),
-    soundIndex: vi2.fn((sound) => engine.soundIndex(sound)),
-    useTargets: vi2.fn((entity, activator) => {
-    }),
-    findByTargetName: vi2.fn(() => []),
-    pickTarget: vi2.fn(() => null),
-    killBox: vi2.fn(),
-    rng: createRandomGenerator({ seed }),
-    imports: {
-      configstring: vi2.fn(),
-      trace: traceFn,
-      pointcontents: vi2.fn(() => 0)
+      const currentCallbacks = [...callbacks];
+      callbacks = [];
+      currentCallbacks.forEach(({ callback }) => {
+        callback(currentTime);
+      });
+    },
+    advance(deltaMs = 16.6) {
+      this.tick(currentTime + deltaMs);
+    },
+    getCallbacks() {
+      return callbacks.map((c) => c.callback);
+    },
+    reset() {
+      callbacks = [];
+      nextId = 1;
+      currentTime = 0;
+    },
+    enable() {
+      activeMockRAF = this;
+      global.requestAnimationFrame = raf;
+      global.cancelAnimationFrame = cancel;
+    },
+    disable() {
+      if (activeMockRAF === this) {
+        activeMockRAF = void 0;
+      }
+      if (originalRAF) {
+        global.requestAnimationFrame = originalRAF;
+      } else {
+        delete global.requestAnimationFrame;
+      }
+      if (originalCancelRAF) {
+        global.cancelAnimationFrame = originalCancelRAF;
+      } else {
+        delete global.cancelAnimationFrame;
+      }
+    }
+  };
+  return mock;
+}
+function createMockPerformance(startTime = 0) {
+  let currentTime = startTime;
+  const mockPerf = {
+    now: () => currentTime,
+    timeOrigin: startTime,
+    timing: {
+      navigationStart: startTime
     },
-    level: {
-      intermission_angle: { x: 0, y: 0, z: 0 },
-      intermission_origin: { x: 0, y: 0, z: 0 },
-      next_auto_save: 0,
-      health_bar_entities: null
+    clearMarks: () => {
     },
-    targetNameIndex: /* @__PURE__ */ new Map(),
-    forEachEntity: vi2.fn((callback) => {
-      entityList.forEach(callback);
-    }),
-    find: vi2.fn((predicate) => {
-      return entityList.find(predicate);
-    }),
-    findByClassname: vi2.fn((classname) => {
-      return entityList.find((e) => e.classname === classname);
-    }),
-    beginFrame: vi2.fn((timeSeconds) => {
-      entities.timeSeconds = timeSeconds;
-    }),
-    targetAwareness: {
-      timeSeconds: 10,
-      frameNumber: 1,
-      sightEntity: null,
-      soundEntity: null
+    clearMeasures: () => {
     },
-    // Adding missing properties to satisfy EntitySystem interface partially or fully
-    // We cast to unknown first anyway, but filling these in makes it safer for consumers
-    skill: 1,
-    deathmatch: false,
-    coop: false,
-    activeCount: entityList.length,
-    world: entityList.find((e) => e.classname === "worldspawn") || new Entity(0)
-    // ... other EntitySystem properties would go here
+    clearResourceTimings: () => {
+    },
+    getEntries: () => [],
+    getEntriesByName: () => [],
+    getEntriesByType: () => [],
+    mark: () => {
+    },
+    measure: () => {
+    },
+    setResourceTimingBufferSize: () => {
+    },
+    toJSON: () => ({}),
+    addEventListener: () => {
+    },
+    removeEventListener: () => {
+    },
+    dispatchEvent: () => true
+  };
+  mockPerf.advance = (deltaMs) => {
+    currentTime += deltaMs;
+  };
+  mockPerf.setTime = (time) => {
+    currentTime = time;
+  };
+  return mockPerf;
+}
+function createControlledTimer() {
+  let currentTime = 0;
+  let timers = [];
+  let nextId = 1;
+  const originalSetTimeout = global.setTimeout;
+  const originalClearTimeout = global.clearTimeout;
+  const originalSetInterval = global.setInterval;
+  const originalClearInterval = global.clearInterval;
+  const mockSetTimeout = (callback, delay = 0, ...args) => {
+    const id = nextId++;
+    timers.push({ id, callback, dueTime: currentTime + delay, args });
+    return id;
+  };
+  const mockClearTimeout = (id) => {
+    timers = timers.filter((t) => t.id !== id);
+  };
+  const mockSetInterval = (callback, delay = 0, ...args) => {
+    const id = nextId++;
+    timers.push({ id, callback, dueTime: currentTime + delay, interval: delay, args });
+    return id;
+  };
+  const mockClearInterval = (id) => {
+    timers = timers.filter((t) => t.id !== id);
   };
+  global.setTimeout = mockSetTimeout;
+  global.clearTimeout = mockClearTimeout;
+  global.setInterval = mockSetInterval;
+  global.clearInterval = mockClearInterval;
   return {
-    keyValues: {},
-    entities,
-    game,
-    engine,
-    health_multiplier: 1,
-    warn: vi2.fn(),
-    free: vi2.fn(),
-    // Mock precache functions if they are part of SpawnContext in future or TestContext extensions
-    precacheModel: vi2.fn(),
-    precacheSound: vi2.fn(),
-    precacheImage: vi2.fn()
+    tick() {
+      this.advanceBy(0);
+    },
+    advanceBy(ms) {
+      const targetTime = currentTime + ms;
+      while (true) {
+        let earliest = null;
+        for (const t of timers) {
+          if (!earliest || t.dueTime < earliest.dueTime) {
+            earliest = t;
+          }
+        }
+        if (!earliest || earliest.dueTime > targetTime) {
+          break;
+        }
+        currentTime = earliest.dueTime;
+        const { callback, args, interval, id } = earliest;
+        if (interval !== void 0) {
+          earliest.dueTime += interval;
+          if (interval === 0) earliest.dueTime += 1;
+        } else {
+          timers = timers.filter((t) => t.id !== id);
+        }
+        callback(...args);
+      }
+      currentTime = targetTime;
+    },
+    clear() {
+      timers = [];
+    },
+    restore() {
+      global.setTimeout = originalSetTimeout;
+      global.clearTimeout = originalClearTimeout;
+      global.setInterval = originalSetInterval;
+      global.clearInterval = originalClearInterval;
+    }
   };
 }
-function createSpawnContext() {
-  return createTestContext();
+function simulateFrames(count, frameTimeMs = 16.6, callback) {
+  if (!activeMockRAF) {
+    throw new Error("simulateFrames requires an active MockRAF. Ensure createMockRAF().enable() is called.");
+  }
+  for (let i = 0; i < count; i++) {
+    if (callback) callback(i);
+    activeMockRAF.advance(frameTimeMs);
+  }
 }
-function createEntity() {
-  return new Entity(1);
+function simulateFramesWithMock(mock, count, frameTimeMs = 16.6, callback) {
+  for (let i = 0; i < count; i++) {
+    if (callback) callback(i);
+    mock.advance(frameTimeMs);
+  }
+}
+
+// src/e2e/playwright.ts
+import { chromium } from "playwright";
+import { createServer } from "http";
+import handler from "serve-handler";
+async function createPlaywrightTestClient(options = {}) {
+  let staticServer;
+  let clientUrl = options.clientUrl;
+  const rootPath = options.rootPath || process.cwd();
+  if (!clientUrl) {
+    staticServer = createServer((request, response) => {
+      return handler(request, response, {
+        public: rootPath,
+        cleanUrls: false,
+        headers: [
+          {
+            source: "**/*",
+            headers: [
+              { key: "Cache-Control", value: "no-cache" },
+              { key: "Access-Control-Allow-Origin", value: "*" },
+              { key: "Cross-Origin-Opener-Policy", value: "same-origin" },
+              { key: "Cross-Origin-Embedder-Policy", value: "require-corp" }
+            ]
+          }
+        ]
+      });
+    });
+    await new Promise((resolve) => {
+      if (!staticServer) return;
+      staticServer.listen(0, () => {
+        const addr = staticServer?.address();
+        const port = typeof addr === "object" ? addr?.port : 0;
+        clientUrl = `http://localhost:${port}`;
+        console.log(`Test client serving from ${rootPath} at ${clientUrl}`);
+        resolve();
+      });
+    });
+  }
+  const browser = await chromium.launch({
+    headless: options.headless ?? true,
+    args: [
+      "--use-gl=egl",
+      "--ignore-gpu-blocklist",
+      ...options.launchOptions?.args || []
+    ],
+    ...options.launchOptions
+  });
+  const width = options.width || 1280;
+  const height = options.height || 720;
+  const context = await browser.newContext({
+    viewport: { width, height },
+    deviceScaleFactor: 1,
+    ...options.contextOptions
+  });
+  const page = await context.newPage();
+  const close = async () => {
+    await browser.close();
+    if (staticServer) {
+      staticServer.close();
+    }
+  };
+  const navigate = async (url) => {
+    const targetUrl = url || clientUrl;
+    if (!targetUrl) throw new Error("No URL to navigate to");
+    let finalUrl = targetUrl;
+    if (options.serverUrl && !targetUrl.includes("connect=")) {
+      const separator = targetUrl.includes("?") ? "&" : "?";
+      finalUrl = `${targetUrl}${separator}connect=${encodeURIComponent(options.serverUrl)}`;
+    }
+    console.log(`Navigating to: ${finalUrl}`);
+    await page.goto(finalUrl, { waitUntil: "domcontentloaded" });
+  };
+  return {
+    browser,
+    context,
+    page,
+    server: staticServer,
+    close,
+    navigate,
+    waitForGame: async (timeout = 1e4) => {
+      await waitForGameReady(page, timeout);
+    },
+    injectInput: async (type, data) => {
+      await page.evaluate(({ type: type2, data: data2 }) => {
+        if (window.injectGameInput) window.injectGameInput(type2, data2);
+      }, { type, data });
+    }
+  };
+}
+async function waitForGameReady(page, timeout = 1e4) {
+  try {
+    await page.waitForFunction(() => {
+      return window.gameInstance && window.gameInstance.isReady;
+    }, null, { timeout });
+  } catch (e) {
+    await page.waitForSelector("canvas", { timeout });
+  }
+}
+async function captureGameState(page) {
+  return await page.evaluate(() => {
+    if (window.gameInstance && window.gameInstance.getState) {
+      return window.gameInstance.getState();
+    }
+    return {};
+  });
 }
 export {
   InputInjector,
   MockPointerLock,
+  MockTransport,
   captureAudioEvents,
   captureCanvasDrawCalls,
   captureGameState,
@@ -1292,13 +1505,21 @@ export {
   createMockCanvasContext2D,
   createMockEngine,
   createMockGame,
+  createMockGameState,
   createMockImage,
   createMockImageData,
   createMockIndexedDB,
   createMockLocalStorage,
+  createMockNetworkAddress,
   createMockPerformance,
   createMockRAF,
+  createMockServer,
+  createMockServerClient,
+  createMockServerState,
+  createMockServerStatic,
   createMockSessionStorage,
+  createMockTransport,
+  createMockUDPSocket,
   createMockWebGL2Context,
   createNetChanMock,
   createPlayerStateFactory,