quake2ts 0.0.562 → 0.0.564

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

@@ -1,9 +1,9 @@
 import * as vitest from 'vitest';
 import { Mock } from 'vitest';
-import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, NetDriver } from '@quake2ts/shared';
+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 { NetworkTransport, Server, ServerStatic, Client } from '@quake2ts/server';
+import { NetworkTransport, Server, ServerStatic, Client, ClientState } from '@quake2ts/server';
 import { ImageData } from '@napi-rs/canvas';
 import { LaunchOptions, BrowserContextOptions, Browser, BrowserContext, Page } from 'playwright';
 import { Server as Server$1 } from 'http';
@@ -267,6 +267,155 @@ interface MockServer {
  */
 declare function createMockServer(overrides?: Partial<MockServer>): MockServer;
 
+/**
+ * Interface representing connection state for testing.
+ */
+interface Connection {
+    state: ClientState;
+    address: string;
+    challenge: number;
+    userInfo: UserInfo;
+}
+/**
+ * Stages of the client connection handshake.
+ */
+declare enum HandshakeStage {
+    None = 0,
+    Challenge = 1,
+    Connect = 2,
+    Info = 3,
+    Active = 4
+}
+/**
+ * Interface representing a handshake state.
+ */
+interface Handshake {
+    stage: HandshakeStage;
+    clientNum: number;
+    challenge: number;
+    qport: number;
+}
+/**
+ * Interface for UserInfo structure.
+ */
+interface UserInfo {
+    name: string;
+    skin: string;
+    model: string;
+    fov: number;
+    hand: number;
+    rate: number;
+    msg: number;
+    spectator?: number;
+    [key: string]: string | number | undefined;
+}
+/**
+ * Helper to serialize UserInfo to Quake 2 info string format.
+ * Format: \key\value\key2\value2
+ */
+declare function serializeUserInfo(info: UserInfo): string;
+/**
+ * Creates a mock UserInfo object.
+ * @param overrides Optional overrides for the user info.
+ */
+declare function createMockUserInfo(overrides?: Partial<UserInfo>): UserInfo;
+/**
+ * Creates a mock connection object (Client) with specific state.
+ * @param state The client state (default: Connected).
+ * @param overrides Optional overrides for the client.
+ */
+declare function createMockConnection(state?: ClientState, overrides?: Partial<Client>): Client;
+/**
+ * Creates a mock handshake object.
+ * @param stage The stage of the handshake (default: None).
+ */
+declare function createMockHandshake(stage?: HandshakeStage): Handshake;
+/**
+ * Simulates a handshake between a mock client and server.
+ * Note: This is a high-level simulation helper.
+ * @param client The mock client connection.
+ * @param server The mock server instance.
+ * @returns Promise that resolves to true if handshake succeeded.
+ */
+declare function simulateHandshake(client: Client, server: any): Promise<boolean>;
+
+type MockServerContext = Server & {
+    clients: (Client | null)[];
+    entities?: Entity[];
+};
+interface MultiplayerScenario {
+    server: MockServerContext;
+    clients: Client[];
+    entities: Entity[];
+}
+/**
+ * Creates a multiplayer test scenario with a mock server and a number of clients.
+ * @param numPlayers Number of players to simulate.
+ */
+declare function createMultiplayerTestScenario(numPlayers?: number): MultiplayerScenario;
+/**
+ * Simulates a player joining the server.
+ * @param server The mock server instance.
+ * @param userInfo Optional user info overrides.
+ */
+declare function simulatePlayerJoin(server: MockServerContext, userInfo?: Partial<UserInfo>): Promise<Client>;
+/**
+ * Simulates a player leaving the server.
+ * @param server The mock server instance.
+ * @param clientNum The client number to disconnect.
+ */
+declare function simulatePlayerLeave(server: MockServerContext, clientNum: number): void;
+/**
+ * Simulates a single server frame update.
+ * @param server The mock server instance.
+ * @param deltaTime Time step in seconds (default: 0.1).
+ */
+declare function simulateServerTick(server: MockServerContext, deltaTime?: number): void;
+/**
+ * Simulates player input for a specific client.
+ * @param client The server client.
+ * @param input The input command.
+ */
+declare function simulatePlayerInput(client: Client, input: Partial<UserCommand>): void;
+
+interface Snapshot {
+    serverTime: number;
+    playerState: any;
+    entities: EntityState[];
+}
+interface DeltaSnapshot {
+    snapshot: Snapshot;
+    deltaEntities: EntityState[];
+    removedEntities: number[];
+}
+interface ConsistencyReport {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Creates a client-specific snapshot from the server state.
+ * @param serverState The current server state.
+ * @param clientNum The client number to generate snapshot for.
+ */
+declare function createServerSnapshot(serverState: Server, clientNum: number): Snapshot;
+/**
+ * Calculates the delta between two snapshots.
+ * @param oldSnapshot The baseline snapshot.
+ * @param newSnapshot The current snapshot.
+ */
+declare function createDeltaSnapshot(oldSnapshot: Snapshot, newSnapshot: Snapshot): DeltaSnapshot;
+/**
+ * Verifies the consistency of a sequence of snapshots.
+ * @param snapshots Array of snapshots ordered by time.
+ */
+declare function verifySnapshotConsistency(snapshots: Snapshot[]): ConsistencyReport;
+/**
+ * Simulates network delivery of a snapshot with potential packet loss.
+ * @param snapshot The snapshot to deliver.
+ * @param reliability Probability of successful delivery (0.0 to 1.0).
+ */
+declare function simulateSnapshotDelivery(snapshot: Snapshot, reliability?: number): Promise<Snapshot | null>;
+
 interface BrowserSetupOptions {
     url?: string;
     pretendToBeVisual?: boolean;
@@ -310,11 +459,14 @@ declare function createMockImageData(width: number, height: number, fillColor?:
  */
 declare function createMockImage(width?: number, height?: number, src?: string): HTMLImageElement;
 
+interface NodeSetupOptions {
+    polyfillFetch?: boolean;
+}
 /**
  * Sets up a Node.js environment for testing.
  * This is primarily for backend or shared logic that doesn't rely on browser APIs.
  */
-declare function setupNodeEnvironment(): void;
+declare function setupNodeEnvironment(options?: NodeSetupOptions): void;
 
 declare function createMockWebGL2Context(canvas: HTMLCanvasElement): WebGL2RenderingContext;
 
@@ -334,14 +486,14 @@ declare function createMockSessionStorage(initialData?: Record<string, string>):
  */
 declare function createMockIndexedDB(): IDBFactory;
 interface StorageScenario {
-    storage: Storage;
-    populate(data: Record<string, string>): void;
-    verify(key: string, value: string): boolean;
+    storage: Storage | IDBFactory;
+    populate(data: Record<string, any>): Promise<void> | void;
+    verify(key: string, value: any): Promise<boolean> | boolean;
 }
 /**
  * Helper to setup a storage test scenario.
  */
-declare function createStorageTestScenario(storageType?: 'local' | 'session'): StorageScenario;
+declare function createStorageTestScenario(storageType?: 'local' | 'session' | 'indexed'): StorageScenario;
 
 declare function createMockAudioContext(): AudioContext;
 /**
@@ -358,8 +510,7 @@ interface AudioEvent {
 }
 /**
  * Captures audio operations for verification.
- * Currently requires manual instrumentation or a more sophisticated Proxy mock.
- * This is a placeholder for future implementation.
+ * Note: Only works if the context was created via createMockAudioContext which proxies calls.
  */
 declare function captureAudioEvents(context: AudioContext): AudioEvent[];
 
@@ -452,4 +603,59 @@ declare class InputInjector {
     wheel(deltaY: number): void;
 }
 
-export { type AudioEvent, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type ControlledTimer, type DrawCall, type GameState, type GameStateCapture, InputInjector, type MockEngine, type MockGame, MockPointerLock, type MockRAF, type MockServer, MockTransport, type MockUDPSocket, type NetworkAddress, type PlaywrightOptions, type PlaywrightTestClient, type StorageScenario, type TestContext, captureAudioEvents, captureCanvasDrawCalls, captureGameState, createBinaryStreamMock, createBinaryWriterMock, createControlledTimer, createEntity, createEntityStateFactory, createGameStateSnapshotFactory, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockEngine, createMockGame, createMockGameState, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockServer, createMockServerClient, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockWebGL2Context, createNetChanMock, createPlayerStateFactory, createPlaywrightTestClient, createSpawnContext, createStorageTestScenario, createTestContext, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, simulateFrames, simulateFramesWithMock, teardownBrowserEnvironment, teardownMockAudioContext, waitForGameReady };
+interface NetworkSimulator {
+    apply(page: any): Promise<void>;
+    clear(page: any): Promise<void>;
+}
+type NetworkCondition = 'good' | 'slow' | 'unstable' | 'offline';
+interface NetworkConfig {
+    offline: boolean;
+    downloadThroughput: number;
+    uploadThroughput: number;
+    latency: number;
+}
+/**
+ * Simulates network conditions using Chrome DevTools Protocol (CDP) via Playwright.
+ */
+declare function simulateNetworkCondition(condition: NetworkCondition): NetworkSimulator;
+/**
+ * Creates a custom network condition simulator.
+ *
+ * @param latency Latency in milliseconds
+ * @param jitter Approximate jitter (variation in latency) - Note: CDP doesn't support jitter natively.
+ * @param packetLoss Packet loss percentage (0-100) - Ignored for basic CDP emulation.
+ */
+declare function createCustomNetworkCondition(latency: number, jitter?: number, packetLoss?: number, baseConfig?: NetworkConfig): NetworkSimulator;
+/**
+ * Throttles bandwidth for the given page.
+ */
+declare function throttleBandwidth(page: any, bytesPerSecond: number): Promise<void>;
+
+interface VisualDiff {
+    pixelDiff: number;
+    diffPath?: string;
+    matched: boolean;
+}
+/**
+ * Captures a screenshot of the current game state.
+ */
+declare function captureGameScreenshot(page: Page, name: string, options?: {
+    dir?: string;
+    fullPage?: boolean;
+}): Promise<Buffer>;
+/**
+ * Compares two image buffers pixel-by-pixel.
+ * Note: A robust implementation would use a library like 'pixelmatch' or 'looks-same'.
+ * For now, we provide a basic placeholder or rely on simple buffer comparison.
+ */
+declare function compareScreenshots(baseline: Buffer, current: Buffer, threshold?: number): Promise<VisualDiff>;
+interface VisualScenario {
+    capture(name: string): Promise<Buffer>;
+    compare(name: string, baselineDir: string): Promise<VisualDiff>;
+}
+/**
+ * Creates a helper for visual regression testing scenarios.
+ */
+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 MockServer, 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, createMockGame, createMockGameState, createMockHandshake, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockServer, createMockServerClient, 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, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };

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

@@ -1,9 +1,9 @@
 import * as vitest from 'vitest';
 import { Mock } from 'vitest';
-import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, NetDriver } from '@quake2ts/shared';
+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 { NetworkTransport, Server, ServerStatic, Client } from '@quake2ts/server';
+import { NetworkTransport, Server, ServerStatic, Client, ClientState } from '@quake2ts/server';
 import { ImageData } from '@napi-rs/canvas';
 import { LaunchOptions, BrowserContextOptions, Browser, BrowserContext, Page } from 'playwright';
 import { Server as Server$1 } from 'http';
@@ -267,6 +267,155 @@ interface MockServer {
  */
 declare function createMockServer(overrides?: Partial<MockServer>): MockServer;
 
+/**
+ * Interface representing connection state for testing.
+ */
+interface Connection {
+    state: ClientState;
+    address: string;
+    challenge: number;
+    userInfo: UserInfo;
+}
+/**
+ * Stages of the client connection handshake.
+ */
+declare enum HandshakeStage {
+    None = 0,
+    Challenge = 1,
+    Connect = 2,
+    Info = 3,
+    Active = 4
+}
+/**
+ * Interface representing a handshake state.
+ */
+interface Handshake {
+    stage: HandshakeStage;
+    clientNum: number;
+    challenge: number;
+    qport: number;
+}
+/**
+ * Interface for UserInfo structure.
+ */
+interface UserInfo {
+    name: string;
+    skin: string;
+    model: string;
+    fov: number;
+    hand: number;
+    rate: number;
+    msg: number;
+    spectator?: number;
+    [key: string]: string | number | undefined;
+}
+/**
+ * Helper to serialize UserInfo to Quake 2 info string format.
+ * Format: \key\value\key2\value2
+ */
+declare function serializeUserInfo(info: UserInfo): string;
+/**
+ * Creates a mock UserInfo object.
+ * @param overrides Optional overrides for the user info.
+ */
+declare function createMockUserInfo(overrides?: Partial<UserInfo>): UserInfo;
+/**
+ * Creates a mock connection object (Client) with specific state.
+ * @param state The client state (default: Connected).
+ * @param overrides Optional overrides for the client.
+ */
+declare function createMockConnection(state?: ClientState, overrides?: Partial<Client>): Client;
+/**
+ * Creates a mock handshake object.
+ * @param stage The stage of the handshake (default: None).
+ */
+declare function createMockHandshake(stage?: HandshakeStage): Handshake;
+/**
+ * Simulates a handshake between a mock client and server.
+ * Note: This is a high-level simulation helper.
+ * @param client The mock client connection.
+ * @param server The mock server instance.
+ * @returns Promise that resolves to true if handshake succeeded.
+ */
+declare function simulateHandshake(client: Client, server: any): Promise<boolean>;
+
+type MockServerContext = Server & {
+    clients: (Client | null)[];
+    entities?: Entity[];
+};
+interface MultiplayerScenario {
+    server: MockServerContext;
+    clients: Client[];
+    entities: Entity[];
+}
+/**
+ * Creates a multiplayer test scenario with a mock server and a number of clients.
+ * @param numPlayers Number of players to simulate.
+ */
+declare function createMultiplayerTestScenario(numPlayers?: number): MultiplayerScenario;
+/**
+ * Simulates a player joining the server.
+ * @param server The mock server instance.
+ * @param userInfo Optional user info overrides.
+ */
+declare function simulatePlayerJoin(server: MockServerContext, userInfo?: Partial<UserInfo>): Promise<Client>;
+/**
+ * Simulates a player leaving the server.
+ * @param server The mock server instance.
+ * @param clientNum The client number to disconnect.
+ */
+declare function simulatePlayerLeave(server: MockServerContext, clientNum: number): void;
+/**
+ * Simulates a single server frame update.
+ * @param server The mock server instance.
+ * @param deltaTime Time step in seconds (default: 0.1).
+ */
+declare function simulateServerTick(server: MockServerContext, deltaTime?: number): void;
+/**
+ * Simulates player input for a specific client.
+ * @param client The server client.
+ * @param input The input command.
+ */
+declare function simulatePlayerInput(client: Client, input: Partial<UserCommand>): void;
+
+interface Snapshot {
+    serverTime: number;
+    playerState: any;
+    entities: EntityState[];
+}
+interface DeltaSnapshot {
+    snapshot: Snapshot;
+    deltaEntities: EntityState[];
+    removedEntities: number[];
+}
+interface ConsistencyReport {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Creates a client-specific snapshot from the server state.
+ * @param serverState The current server state.
+ * @param clientNum The client number to generate snapshot for.
+ */
+declare function createServerSnapshot(serverState: Server, clientNum: number): Snapshot;
+/**
+ * Calculates the delta between two snapshots.
+ * @param oldSnapshot The baseline snapshot.
+ * @param newSnapshot The current snapshot.
+ */
+declare function createDeltaSnapshot(oldSnapshot: Snapshot, newSnapshot: Snapshot): DeltaSnapshot;
+/**
+ * Verifies the consistency of a sequence of snapshots.
+ * @param snapshots Array of snapshots ordered by time.
+ */
+declare function verifySnapshotConsistency(snapshots: Snapshot[]): ConsistencyReport;
+/**
+ * Simulates network delivery of a snapshot with potential packet loss.
+ * @param snapshot The snapshot to deliver.
+ * @param reliability Probability of successful delivery (0.0 to 1.0).
+ */
+declare function simulateSnapshotDelivery(snapshot: Snapshot, reliability?: number): Promise<Snapshot | null>;
+
 interface BrowserSetupOptions {
     url?: string;
     pretendToBeVisual?: boolean;
@@ -310,11 +459,14 @@ declare function createMockImageData(width: number, height: number, fillColor?:
  */
 declare function createMockImage(width?: number, height?: number, src?: string): HTMLImageElement;
 
+interface NodeSetupOptions {
+    polyfillFetch?: boolean;
+}
 /**
  * Sets up a Node.js environment for testing.
  * This is primarily for backend or shared logic that doesn't rely on browser APIs.
  */
-declare function setupNodeEnvironment(): void;
+declare function setupNodeEnvironment(options?: NodeSetupOptions): void;
 
 declare function createMockWebGL2Context(canvas: HTMLCanvasElement): WebGL2RenderingContext;
 
@@ -334,14 +486,14 @@ declare function createMockSessionStorage(initialData?: Record<string, string>):
  */
 declare function createMockIndexedDB(): IDBFactory;
 interface StorageScenario {
-    storage: Storage;
-    populate(data: Record<string, string>): void;
-    verify(key: string, value: string): boolean;
+    storage: Storage | IDBFactory;
+    populate(data: Record<string, any>): Promise<void> | void;
+    verify(key: string, value: any): Promise<boolean> | boolean;
 }
 /**
  * Helper to setup a storage test scenario.
  */
-declare function createStorageTestScenario(storageType?: 'local' | 'session'): StorageScenario;
+declare function createStorageTestScenario(storageType?: 'local' | 'session' | 'indexed'): StorageScenario;
 
 declare function createMockAudioContext(): AudioContext;
 /**
@@ -358,8 +510,7 @@ interface AudioEvent {
 }
 /**
  * Captures audio operations for verification.
- * Currently requires manual instrumentation or a more sophisticated Proxy mock.
- * This is a placeholder for future implementation.
+ * Note: Only works if the context was created via createMockAudioContext which proxies calls.
  */
 declare function captureAudioEvents(context: AudioContext): AudioEvent[];
 
@@ -452,4 +603,59 @@ declare class InputInjector {
     wheel(deltaY: number): void;
 }
 
-export { type AudioEvent, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type ControlledTimer, type DrawCall, type GameState, type GameStateCapture, InputInjector, type MockEngine, type MockGame, MockPointerLock, type MockRAF, type MockServer, MockTransport, type MockUDPSocket, type NetworkAddress, type PlaywrightOptions, type PlaywrightTestClient, type StorageScenario, type TestContext, captureAudioEvents, captureCanvasDrawCalls, captureGameState, createBinaryStreamMock, createBinaryWriterMock, createControlledTimer, createEntity, createEntityStateFactory, createGameStateSnapshotFactory, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockEngine, createMockGame, createMockGameState, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockServer, createMockServerClient, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockWebGL2Context, createNetChanMock, createPlayerStateFactory, createPlaywrightTestClient, createSpawnContext, createStorageTestScenario, createTestContext, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, simulateFrames, simulateFramesWithMock, teardownBrowserEnvironment, teardownMockAudioContext, waitForGameReady };
+interface NetworkSimulator {
+    apply(page: any): Promise<void>;
+    clear(page: any): Promise<void>;
+}
+type NetworkCondition = 'good' | 'slow' | 'unstable' | 'offline';
+interface NetworkConfig {
+    offline: boolean;
+    downloadThroughput: number;
+    uploadThroughput: number;
+    latency: number;
+}
+/**
+ * Simulates network conditions using Chrome DevTools Protocol (CDP) via Playwright.
+ */
+declare function simulateNetworkCondition(condition: NetworkCondition): NetworkSimulator;
+/**
+ * Creates a custom network condition simulator.
+ *
+ * @param latency Latency in milliseconds
+ * @param jitter Approximate jitter (variation in latency) - Note: CDP doesn't support jitter natively.
+ * @param packetLoss Packet loss percentage (0-100) - Ignored for basic CDP emulation.
+ */
+declare function createCustomNetworkCondition(latency: number, jitter?: number, packetLoss?: number, baseConfig?: NetworkConfig): NetworkSimulator;
+/**
+ * Throttles bandwidth for the given page.
+ */
+declare function throttleBandwidth(page: any, bytesPerSecond: number): Promise<void>;
+
+interface VisualDiff {
+    pixelDiff: number;
+    diffPath?: string;
+    matched: boolean;
+}
+/**
+ * Captures a screenshot of the current game state.
+ */
+declare function captureGameScreenshot(page: Page, name: string, options?: {
+    dir?: string;
+    fullPage?: boolean;
+}): Promise<Buffer>;
+/**
+ * Compares two image buffers pixel-by-pixel.
+ * Note: A robust implementation would use a library like 'pixelmatch' or 'looks-same'.
+ * For now, we provide a basic placeholder or rely on simple buffer comparison.
+ */
+declare function compareScreenshots(baseline: Buffer, current: Buffer, threshold?: number): Promise<VisualDiff>;
+interface VisualScenario {
+    capture(name: string): Promise<Buffer>;
+    compare(name: string, baselineDir: string): Promise<VisualDiff>;
+}
+/**
+ * Creates a helper for visual regression testing scenarios.
+ */
+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 MockServer, 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, createMockGame, createMockGameState, createMockHandshake, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockServer, createMockServerClient, 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, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };