quake2ts 0.0.567 → 0.0.569

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 } 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;
@@ -230,6 +295,11 @@ declare function createMockNetworkAddress(ip?: string, port?: number): NetworkAd
  * @param overrides Optional overrides for the transport properties.
  */
 declare function createMockTransport(address?: string, port?: number, overrides?: Partial<MockTransport>): MockTransport;
+/**
+ * Creates a mock NetDriver instance.
+ * @param overrides Optional overrides for the NetDriver methods.
+ */
+declare function createMockNetDriver(overrides?: Partial<NetDriver>): NetDriver;
 
 /**
  * Creates a mock server state object.
@@ -704,4 +774,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, 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, 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 } 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;
@@ -230,6 +295,11 @@ declare function createMockNetworkAddress(ip?: string, port?: number): NetworkAd
  * @param overrides Optional overrides for the transport properties.
  */
 declare function createMockTransport(address?: string, port?: number, overrides?: Partial<MockTransport>): MockTransport;
+/**
+ * Creates a mock NetDriver instance.
+ * @param overrides Optional overrides for the NetDriver methods.
+ */
+declare function createMockNetDriver(overrides?: Partial<NetDriver>): NetDriver;
 
 /**
  * Creates a mock server state object.
@@ -704,4 +774,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, 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, 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 };