quake2ts 0.0.570 → 0.0.572

package/packages/test-utils/dist/index.d.cts

@@ -2,7 +2,7 @@ import * as vitest from 'vitest';
 import { Mock } from 'vitest';
 import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, NetDriver, UserCommand } from '@quake2ts/shared';
 export { intersects, ladderTrace, stairTrace } from '@quake2ts/shared';
-import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, MonsterMove, DamageMod, GameExports } from '@quake2ts/game';
+import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, MonsterMove, DamageMod, PlayerInventory, BaseItem, WeaponId, WeaponItem, HealthItem, ArmorItem, AmmoItemId, PowerupItem, GameExports } from '@quake2ts/game';
 import { NetworkTransport, Server, ServerStatic, Client, ClientState } from '@quake2ts/server';
 import { ImageData } from '@napi-rs/canvas';
 import { LaunchOptions, BrowserContextOptions, Browser, BrowserContext, Page } from 'playwright';
@@ -197,6 +197,37 @@ declare const mockMonsterAttacks: {
     fireBFG: Mock<any, any>;
 };
 
+/**
+ * Creates a mock player inventory with default values suitable for testing.
+ * Can be customized with overrides.
+ */
+declare function createMockInventory(overrides?: Partial<PlayerInventory>): PlayerInventory;
+/**
+ * Generic factory for any item type.
+ * Attempts to find a predefined item by ID first, then applies overrides.
+ */
+declare function createMockItem(id: string, overrides?: Partial<BaseItem>): BaseItem;
+/**
+ * Creates a mock WeaponItem
+ */
+declare function createMockWeaponItem(weaponId: WeaponId, overrides?: Partial<WeaponItem>): WeaponItem;
+/**
+ * Creates a mock HealthItem
+ */
+declare function createMockHealthItem(amount: number, overrides?: Partial<HealthItem>): HealthItem;
+/**
+ * Creates a mock ArmorItem
+ */
+declare function createMockArmorItem(amount: number, overrides?: Partial<ArmorItem>): ArmorItem;
+/**
+ * Creates a mock AmmoItem
+ */
+declare function createMockAmmoItem(ammoItemId: AmmoItemId, overrides?: Partial<BaseItem>): BaseItem;
+/**
+ * Creates a mock PowerupItem
+ */
+declare function createMockPowerupItem(id: string, duration: number, overrides?: Partial<PowerupItem>): PowerupItem;
+
 interface GameState {
     levelName: string;
     time: number;
@@ -778,4 +809,4 @@ interface VisualScenario {
  */
 declare function createVisualTestScenario(page: Page, sceneName: string): VisualScenario;
 
-export { type AudioEvent, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type Connection, type ConsistencyReport, type ControlledTimer, type DeltaSnapshot, type DrawCall, type GameState, type GameStateCapture, type Handshake, HandshakeStage, InputInjector, type MockAI, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockPointerLock, type MockRAF, type MockRConClient, type MockServer, type MockServerConsole, type MockServerContext, MockTransport, type MockUDPSocket, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkConfig, type NetworkSimulator, type NodeSetupOptions, type PlaywrightOptions, type PlaywrightTestClient, type Snapshot, type StorageScenario, type TestContext, type UserInfo, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshots, createBinaryStreamMock, createBinaryWriterMock, createCombatTestContext, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createItemEntityFactory, createMockAI, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockDamageInfo, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockMonsterAI, createMockMonsterMove, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockRConClient, createMockServer, createMockServerClient, createMockServerConsole, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWeapon, createMockWebGL2Context, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPhysicsTestContext, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createProjectileEntityFactory, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createTestContext, createTriggerEntityFactory, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, mockMonsterAttacks, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };
+export { type AudioEvent, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type Connection, type ConsistencyReport, type ControlledTimer, type DeltaSnapshot, type DrawCall, type GameState, type GameStateCapture, type Handshake, HandshakeStage, InputInjector, type MockAI, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockPointerLock, type MockRAF, type MockRConClient, type MockServer, type MockServerConsole, type MockServerContext, MockTransport, type MockUDPSocket, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkConfig, type NetworkSimulator, type NodeSetupOptions, type PlaywrightOptions, type PlaywrightTestClient, type Snapshot, type StorageScenario, type TestContext, type UserInfo, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshots, createBinaryStreamMock, createBinaryWriterMock, createCombatTestContext, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createItemEntityFactory, createMockAI, createMockAmmoItem, createMockArmorItem, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockDamageInfo, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockImage, createMockImageData, createMockIndexedDB, createMockInventory, createMockItem, createMockLocalStorage, createMockMonsterAI, createMockMonsterMove, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockPowerupItem, createMockRAF, createMockRConClient, createMockServer, createMockServerClient, createMockServerConsole, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPhysicsTestContext, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createProjectileEntityFactory, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createTestContext, createTriggerEntityFactory, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, mockMonsterAttacks, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };

package/packages/test-utils/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as vitest from 'vitest';
 import { Mock } from 'vitest';
 import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, NetDriver, UserCommand } from '@quake2ts/shared';
 export { intersects, ladderTrace, stairTrace } from '@quake2ts/shared';
-import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, MonsterMove, DamageMod, GameExports } from '@quake2ts/game';
+import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, MonsterMove, DamageMod, PlayerInventory, BaseItem, WeaponId, WeaponItem, HealthItem, ArmorItem, AmmoItemId, PowerupItem, GameExports } from '@quake2ts/game';
 import { NetworkTransport, Server, ServerStatic, Client, ClientState } from '@quake2ts/server';
 import { ImageData } from '@napi-rs/canvas';
 import { LaunchOptions, BrowserContextOptions, Browser, BrowserContext, Page } from 'playwright';
@@ -197,6 +197,37 @@ declare const mockMonsterAttacks: {
     fireBFG: Mock<any, any>;
 };
 
+/**
+ * Creates a mock player inventory with default values suitable for testing.
+ * Can be customized with overrides.
+ */
+declare function createMockInventory(overrides?: Partial<PlayerInventory>): PlayerInventory;
+/**
+ * Generic factory for any item type.
+ * Attempts to find a predefined item by ID first, then applies overrides.
+ */
+declare function createMockItem(id: string, overrides?: Partial<BaseItem>): BaseItem;
+/**
+ * Creates a mock WeaponItem
+ */
+declare function createMockWeaponItem(weaponId: WeaponId, overrides?: Partial<WeaponItem>): WeaponItem;
+/**
+ * Creates a mock HealthItem
+ */
+declare function createMockHealthItem(amount: number, overrides?: Partial<HealthItem>): HealthItem;
+/**
+ * Creates a mock ArmorItem
+ */
+declare function createMockArmorItem(amount: number, overrides?: Partial<ArmorItem>): ArmorItem;
+/**
+ * Creates a mock AmmoItem
+ */
+declare function createMockAmmoItem(ammoItemId: AmmoItemId, overrides?: Partial<BaseItem>): BaseItem;
+/**
+ * Creates a mock PowerupItem
+ */
+declare function createMockPowerupItem(id: string, duration: number, overrides?: Partial<PowerupItem>): PowerupItem;
+
 interface GameState {
     levelName: string;
     time: number;
@@ -778,4 +809,4 @@ interface VisualScenario {
  */
 declare function createVisualTestScenario(page: Page, sceneName: string): VisualScenario;
 
-export { type AudioEvent, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type Connection, type ConsistencyReport, type ControlledTimer, type DeltaSnapshot, type DrawCall, type GameState, type GameStateCapture, type Handshake, HandshakeStage, InputInjector, type MockAI, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockPointerLock, type MockRAF, type MockRConClient, type MockServer, type MockServerConsole, type MockServerContext, MockTransport, type MockUDPSocket, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkConfig, type NetworkSimulator, type NodeSetupOptions, type PlaywrightOptions, type PlaywrightTestClient, type Snapshot, type StorageScenario, type TestContext, type UserInfo, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshots, createBinaryStreamMock, createBinaryWriterMock, createCombatTestContext, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createItemEntityFactory, createMockAI, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockDamageInfo, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockMonsterAI, createMockMonsterMove, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockRConClient, createMockServer, createMockServerClient, createMockServerConsole, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWeapon, createMockWebGL2Context, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPhysicsTestContext, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createProjectileEntityFactory, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createTestContext, createTriggerEntityFactory, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, mockMonsterAttacks, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };
+export { type AudioEvent, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type Connection, type ConsistencyReport, type ControlledTimer, type DeltaSnapshot, type DrawCall, type GameState, type GameStateCapture, type Handshake, HandshakeStage, InputInjector, type MockAI, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockPointerLock, type MockRAF, type MockRConClient, type MockServer, type MockServerConsole, type MockServerContext, MockTransport, type MockUDPSocket, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkConfig, type NetworkSimulator, type NodeSetupOptions, type PlaywrightOptions, type PlaywrightTestClient, type Snapshot, type StorageScenario, type TestContext, type UserInfo, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshots, createBinaryStreamMock, createBinaryWriterMock, createCombatTestContext, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createItemEntityFactory, createMockAI, createMockAmmoItem, createMockArmorItem, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockDamageInfo, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockImage, createMockImageData, createMockIndexedDB, createMockInventory, createMockItem, createMockLocalStorage, createMockMonsterAI, createMockMonsterMove, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockPowerupItem, createMockRAF, createMockRConClient, createMockServer, createMockServerClient, createMockServerConsole, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPhysicsTestContext, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createProjectileEntityFactory, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createTestContext, createTriggerEntityFactory, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, mockMonsterAttacks, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };

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

@@ -565,6 +565,103 @@ var mockMonsterAttacks = {
   fireBFG: vi4.fn()
 };
 
+// src/game/mocks/items.ts
+import {
+  createPlayerInventory
+} from "@quake2ts/game";
+import {
+  WEAPON_ITEMS,
+  HEALTH_ITEMS,
+  ARMOR_ITEMS,
+  POWERUP_ITEMS,
+  POWER_ARMOR_ITEMS,
+  KEY_ITEMS,
+  FLAG_ITEMS,
+  getAmmoItemDefinition
+} from "@quake2ts/game";
+function createMockInventory(overrides = {}) {
+  const defaultInventory = createPlayerInventory();
+  const inventory = {
+    ...defaultInventory,
+    ...overrides
+  };
+  return inventory;
+}
+function createMockItem(id, overrides = {}) {
+  let base;
+  base = WEAPON_ITEMS[id] || HEALTH_ITEMS[id] || ARMOR_ITEMS[id] || POWERUP_ITEMS[id] || POWER_ARMOR_ITEMS[id] || KEY_ITEMS[id] || FLAG_ITEMS[id];
+  if (!base) {
+    base = {
+      id,
+      name: `Mock Item ${id}`
+    };
+  }
+  return {
+    ...base,
+    ...overrides
+  };
+}
+function createMockWeaponItem(weaponId, overrides = {}) {
+  const found = Object.values(WEAPON_ITEMS).find((w) => w.weaponId === weaponId);
+  const base = found ? { ...found } : {
+    type: "weapon",
+    id: `weapon_${weaponId}`,
+    name: `Mock Weapon ${weaponId}`,
+    weaponId,
+    ammoType: null,
+    initialAmmo: 0,
+    pickupAmmo: 0,
+    fireRate: 1
+  };
+  return { ...base, ...overrides };
+}
+function createMockHealthItem(amount, overrides = {}) {
+  return {
+    type: "health",
+    id: "item_health_mock",
+    name: "Mock Health",
+    amount,
+    max: 100,
+    ...overrides
+  };
+}
+function createMockArmorItem(amount, overrides = {}) {
+  return {
+    type: "armor",
+    id: "item_armor_mock",
+    name: "Mock Armor",
+    amount,
+    ...overrides
+  };
+}
+function createMockAmmoItem(ammoItemId, overrides = {}) {
+  const def = getAmmoItemDefinition(ammoItemId);
+  if (!def) {
+    throw new Error(`Unknown ammo item id: ${ammoItemId}`);
+  }
+  const base = {
+    id: def.id,
+    name: `Mock Ammo ${def.id}`
+  };
+  return {
+    ...base,
+    ...overrides
+  };
+}
+function createMockPowerupItem(id, duration, overrides = {}) {
+  const found = POWERUP_ITEMS[id];
+  const base = found ? { ...found } : {
+    type: "powerup",
+    id,
+    name: `Mock Powerup ${id}`,
+    timer: duration
+  };
+  if (duration !== void 0 && !found) {
+    base.timer = duration;
+  }
+  return { ...base, ...overrides };
+}
+
 // src/game/mocks.ts
 import { vi as vi5 } from "vitest";
 function createMockGameState(overrides) {
@@ -2273,6 +2370,8 @@ export {
   createGameStateSnapshotFactory,
   createItemEntityFactory,
   createMockAI,
+  createMockAmmoItem,
+  createMockArmorItem,
   createMockAudioContext,
   createMockCanvas,
   createMockCanvasContext2D,
@@ -2286,15 +2385,19 @@ export {
   createMockGameExports,
   createMockGameState,
   createMockHandshake,
+  createMockHealthItem,
   createMockImage,
   createMockImageData,
   createMockIndexedDB,
+  createMockInventory,
+  createMockItem,
   createMockLocalStorage,
   createMockMonsterAI,
   createMockMonsterMove,
   createMockNetDriver,
   createMockNetworkAddress,
   createMockPerformance,
+  createMockPowerupItem,
   createMockRAF,
   createMockRConClient,
   createMockServer,
@@ -2307,6 +2410,7 @@ export {
   createMockUDPSocket,
   createMockUserInfo,
   createMockWeapon,
+  createMockWeaponItem,
   createMockWebGL2Context,
   createMonsterEntityFactory,
   createMultiplayerTestScenario,