quake2ts 0.0.568 → 0.0.570

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 } from '@quake2ts/game';
+import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, MonsterMove, DamageMod, 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';
@@ -97,6 +97,12 @@ declare function makeBrushFromMinsMaxs(mins: Vec3, maxs: Vec3, contents?: number
 declare const createPlayerStateFactory: (overrides?: Partial<PlayerState>) => PlayerState;
 declare const createEntityStateFactory: (overrides?: Partial<EntityState>) => EntityState;
 declare const createGameStateSnapshotFactory: (overrides?: Partial<GameStateSnapshot>) => GameStateSnapshot;
+declare function createEntityFactory(overrides?: Partial<Entity>): Entity;
+declare function createPlayerEntityFactory(overrides?: Partial<Entity>): Entity;
+declare function createMonsterEntityFactory(classname: string, overrides?: Partial<Entity>): Entity;
+declare function createItemEntityFactory(classname: string, overrides?: Partial<Entity>): Entity;
+declare function createProjectileEntityFactory(classname: string, overrides?: Partial<Entity>): Entity;
+declare function createTriggerEntityFactory(classname: string, overrides?: Partial<Entity>): Entity;
 
 interface MockEngine {
     sound: Mock<[Entity, number, string, number, number, number], void>;
@@ -129,9 +135,68 @@ declare function createTestContext(options?: {
     seed?: number;
     initialEntities?: Entity[];
 }): TestContext;
-declare function createSpawnContext(): SpawnContext;
+declare function createSpawnTestContext(mapName?: string): TestContext;
+declare function createCombatTestContext(): TestContext;
+declare function createPhysicsTestContext(): TestContext;
 declare function createEntity(): Entity;
 
+interface MockAI {
+    checkAttack: Mock;
+    findTarget: Mock;
+    visible: Mock;
+    infront: Mock;
+}
+interface MockMonsterAI {
+    stand: Mock;
+    walk: Mock;
+    run: Mock;
+    dodge: Mock;
+    attack: Mock;
+    melee: Mock;
+    sight: Mock;
+    idle: Mock;
+}
+declare function createMockAI(overrides?: Partial<MockAI>): MockAI;
+declare function createMockMonsterAI(overrides?: Partial<MockMonsterAI>): MockMonsterAI;
+declare function createMockMonsterMove(first: number, last: number, think: (self: Entity, context: EntitySystem) => void, action: (self: Entity, dist: number, context: EntitySystem) => void): MonsterMove;
+
+interface MockDamageInfo {
+    damage: number;
+    mod: DamageMod;
+    knockback: number;
+    attacker: Entity | null;
+    inflictor: Entity | null;
+    dir: {
+        x: number;
+        y: number;
+        z: number;
+    } | null;
+    point: {
+        x: number;
+        y: number;
+        z: number;
+    } | null;
+}
+declare function createMockDamageInfo(overrides?: Partial<MockDamageInfo>): MockDamageInfo;
+declare function createMockWeapon(name?: string): {
+    name: string;
+    ammoType: string;
+    ammoUse: number;
+    selection: Mock<any, any>;
+    think: Mock<any, any>;
+    command: Mock<any, any>;
+};
+declare const mockMonsterAttacks: {
+    fireBlaster: Mock<any, any>;
+    fireRocket: Mock<any, any>;
+    fireGrenade: Mock<any, any>;
+    fireHeat: Mock<any, any>;
+    fireBullet: Mock<any, any>;
+    fireShotgun: Mock<any, any>;
+    fireRailgun: Mock<any, any>;
+    fireBFG: Mock<any, any>;
+};
+
 interface GameState {
     levelName: string;
     time: number;
@@ -143,6 +208,10 @@ interface GameState {
  * @param overrides Optional overrides for the game state.
  */
 declare function createMockGameState(overrides?: Partial<GameState>): GameState;
+/**
+ * Creates a mock GameExports object.
+ */
+declare function createMockGameExports(overrides?: Partial<GameExports>): GameExports;
 
 /**
  * Mock implementation of the NetworkTransport interface for server testing.
@@ -709,4 +778,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 MockEngine, type MockGame, 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, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityStateFactory, createGameStateSnapshotFactory, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameState, createMockHandshake, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockRConClient, createMockServer, createMockServerClient, createMockServerConsole, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWebGL2Context, createMultiplayerTestScenario, createNetChanMock, createPlayerStateFactory, createPlaywrightTestClient, createServerSnapshot, createSpawnContext, createStorageTestScenario, createTestContext, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, 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, 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 };

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 } from '@quake2ts/game';
+import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, MonsterMove, DamageMod, 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';
@@ -97,6 +97,12 @@ declare function makeBrushFromMinsMaxs(mins: Vec3, maxs: Vec3, contents?: number
 declare const createPlayerStateFactory: (overrides?: Partial<PlayerState>) => PlayerState;
 declare const createEntityStateFactory: (overrides?: Partial<EntityState>) => EntityState;
 declare const createGameStateSnapshotFactory: (overrides?: Partial<GameStateSnapshot>) => GameStateSnapshot;
+declare function createEntityFactory(overrides?: Partial<Entity>): Entity;
+declare function createPlayerEntityFactory(overrides?: Partial<Entity>): Entity;
+declare function createMonsterEntityFactory(classname: string, overrides?: Partial<Entity>): Entity;
+declare function createItemEntityFactory(classname: string, overrides?: Partial<Entity>): Entity;
+declare function createProjectileEntityFactory(classname: string, overrides?: Partial<Entity>): Entity;
+declare function createTriggerEntityFactory(classname: string, overrides?: Partial<Entity>): Entity;
 
 interface MockEngine {
     sound: Mock<[Entity, number, string, number, number, number], void>;
@@ -129,9 +135,68 @@ declare function createTestContext(options?: {
     seed?: number;
     initialEntities?: Entity[];
 }): TestContext;
-declare function createSpawnContext(): SpawnContext;
+declare function createSpawnTestContext(mapName?: string): TestContext;
+declare function createCombatTestContext(): TestContext;
+declare function createPhysicsTestContext(): TestContext;
 declare function createEntity(): Entity;
 
+interface MockAI {
+    checkAttack: Mock;
+    findTarget: Mock;
+    visible: Mock;
+    infront: Mock;
+}
+interface MockMonsterAI {
+    stand: Mock;
+    walk: Mock;
+    run: Mock;
+    dodge: Mock;
+    attack: Mock;
+    melee: Mock;
+    sight: Mock;
+    idle: Mock;
+}
+declare function createMockAI(overrides?: Partial<MockAI>): MockAI;
+declare function createMockMonsterAI(overrides?: Partial<MockMonsterAI>): MockMonsterAI;
+declare function createMockMonsterMove(first: number, last: number, think: (self: Entity, context: EntitySystem) => void, action: (self: Entity, dist: number, context: EntitySystem) => void): MonsterMove;
+
+interface MockDamageInfo {
+    damage: number;
+    mod: DamageMod;
+    knockback: number;
+    attacker: Entity | null;
+    inflictor: Entity | null;
+    dir: {
+        x: number;
+        y: number;
+        z: number;
+    } | null;
+    point: {
+        x: number;
+        y: number;
+        z: number;
+    } | null;
+}
+declare function createMockDamageInfo(overrides?: Partial<MockDamageInfo>): MockDamageInfo;
+declare function createMockWeapon(name?: string): {
+    name: string;
+    ammoType: string;
+    ammoUse: number;
+    selection: Mock<any, any>;
+    think: Mock<any, any>;
+    command: Mock<any, any>;
+};
+declare const mockMonsterAttacks: {
+    fireBlaster: Mock<any, any>;
+    fireRocket: Mock<any, any>;
+    fireGrenade: Mock<any, any>;
+    fireHeat: Mock<any, any>;
+    fireBullet: Mock<any, any>;
+    fireShotgun: Mock<any, any>;
+    fireRailgun: Mock<any, any>;
+    fireBFG: Mock<any, any>;
+};
+
 interface GameState {
     levelName: string;
     time: number;
@@ -143,6 +208,10 @@ interface GameState {
  * @param overrides Optional overrides for the game state.
  */
 declare function createMockGameState(overrides?: Partial<GameState>): GameState;
+/**
+ * Creates a mock GameExports object.
+ */
+declare function createMockGameExports(overrides?: Partial<GameExports>): GameExports;
 
 /**
  * Mock implementation of the NetworkTransport interface for server testing.
@@ -709,4 +778,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 MockEngine, type MockGame, 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, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityStateFactory, createGameStateSnapshotFactory, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameState, createMockHandshake, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockRConClient, createMockServer, createMockServerClient, createMockServerConsole, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWebGL2Context, createMultiplayerTestScenario, createNetChanMock, createPlayerStateFactory, createPlaywrightTestClient, createServerSnapshot, createSpawnContext, createStorageTestScenario, createTestContext, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, 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, 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 };