quake2ts 0.0.621 → 0.0.629

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

@@ -4,10 +4,10 @@ import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, Col
 export { intersects, ladderTrace, stairTrace } from '@quake2ts/shared';
 import { Vec3 as Vec3$1, Bounds3 } from '@quake2ts/shared/math/vec3';
 import { TraceResult, CollisionPlane as CollisionPlane$1 } from '@quake2ts/shared/bsp/collision';
-import { ConfigStringEntry, Cvar, AudioNodeLike, AudioBufferSourceNodeLike, AudioBufferLike, AudioParamLike, GainNodeLike, DynamicsCompressorNodeLike, PannerNodeLike, BiquadFilterNodeLike, AudioDestinationNodeLike, AudioContextLike, Renderer, FrameRenderer, BspSurfacePipeline, Md2Pipeline, Md3Pipeline, SpriteRenderer, SkyboxPipeline, Camera, FrameRenderStats, EntityState as EntityState$1, ProtocolPlayerState, FrameData, DamageIndicator, FogData } from '@quake2ts/engine';
+import { ConfigStringEntry, Cvar, AudioNodeLike, AudioBufferSourceNodeLike, AudioBufferLike, AudioParamLike, GainNodeLike, DynamicsCompressorNodeLike, PannerNodeLike, BiquadFilterNodeLike, AudioDestinationNodeLike, AudioContextLike, Renderer, FrameRenderer, BspSurfacePipeline, Md2Pipeline, Md3Pipeline, SpriteRenderer, SkyboxPipeline, AssetManager, PreparedTexture, Md2Model, Md3Model, BspMap, Camera, FrameRenderStats, EntityState as EntityState$1, ProtocolPlayerState, FrameData, DamageIndicator, FogData } from '@quake2ts/engine';
 export { ConfigStringEntry, Cvar } from '@quake2ts/engine';
 import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, MonsterMove, DamageMod, PlayerInventory, BaseItem, WeaponId, WeaponItem, HealthItem, ArmorItem, AmmoItemId, PowerupItem, GameExports, PlayerClient } from '@quake2ts/game';
-import { NetworkTransport, Server, ServerStatic, Client, ClientState, ClientFrame } from '@quake2ts/server';
+import { NetworkTransport, Server, ServerStatic, Client, ClientState as ClientState$1, ClientFrame } from '@quake2ts/server';
 import { ImageData, Canvas } from '@napi-rs/canvas';
 import { vec3 } from 'gl-matrix';
 
@@ -703,7 +703,7 @@ declare function createMockServer(overrides?: Partial<MockServer>): MockServer;
  * Interface representing connection state for testing.
  */
 interface Connection {
-    state: ClientState;
+    state: ClientState$1;
     address: string;
     challenge: number;
     userInfo: UserInfo;
@@ -756,7 +756,7 @@ declare function createMockUserInfo(overrides?: Partial<UserInfo>): UserInfo;
  * @param state The client state (default: Connected).
  * @param overrides Optional overrides for the client.
  */
-declare function createMockConnection(state?: ClientState, overrides?: Partial<Client>): Client;
+declare function createMockConnection(state?: ClientState$1, overrides?: Partial<Client>): Client;
 /**
  * Creates a mock handshake object.
  * @param stage The stage of the handshake (default: None).
@@ -1032,16 +1032,59 @@ declare function createMockImageData(width: number, height: number, fillColor?:
  */
 declare function createMockImage(width?: number, height?: number, src?: string): HTMLImageElement;
 
-declare function createMockGPUAdapter(): GPUAdapter;
-declare function createMockGPUDevice(): GPUDevice;
-declare function createMockGPUCanvasContext(): GPUCanvasContext;
+interface HeadlessWebGPUSetup {
+    adapter: GPUAdapter;
+    device: GPUDevice;
+    cleanup: () => Promise<void>;
+}
+interface WebGPUContextState {
+    adapter: GPUAdapter;
+    device: GPUDevice;
+    queue: GPUQueue;
+}
+/**
+ * Initialize WebGPU in a headless Node.js environment using @webgpu/dawn (via webgpu package)
+ */
+declare function initHeadlessWebGPU(options?: {
+    powerPreference?: 'low-power' | 'high-performance';
+    requiredFeatures?: GPUFeatureName[];
+}): Promise<HeadlessWebGPUSetup>;
+/**
+ * Creates a complete context state for testing
+ */
+declare function createHeadlessTestContext(): Promise<WebGPUContextState>;
+
+interface MockWebGPUContext {
+    adapter: GPUAdapter;
+    device: GPUDevice;
+    queue: GPUQueue;
+}
+/**
+ * Patches globalThis with WebGPU globals (GPUBufferUsage, etc.)
+ * and optionally patches navigator.gpu.
+ */
 declare function setupWebGPUMocks(): {
     mockGpu: {
         requestAdapter: vitest.Mock<any, any>;
         getPreferredCanvasFormat: vitest.Mock<any, any>;
     };
     mockAdapter: GPUAdapter;
+    mockDevice: GPUDevice;
 };
+declare function createMockGPUAdapter(options?: Partial<GPUAdapter>): GPUAdapter;
+declare function createMockGPUDevice(features?: Set<GPUFeatureName>): GPUDevice;
+declare function createMockQueue(): GPUQueue;
+declare function createMockGPUBuffer(descriptor: GPUBufferDescriptor): GPUBuffer;
+declare function createMockGPUTexture(descriptor: GPUTextureDescriptor): GPUTexture;
+declare function createMockTextureView(): GPUTextureView;
+declare function createMockSampler(): GPUSampler;
+declare function createMockShaderModule(descriptor: GPUShaderModuleDescriptor): GPUShaderModule;
+declare function createMockComputePipeline(): GPUComputePipeline;
+declare function createMockRenderPipeline(): GPURenderPipeline;
+declare function createMockCommandEncoder(): GPUCommandEncoder;
+declare function createMockRenderPassEncoder(): GPURenderPassEncoder;
+declare function createMockComputePassEncoder(): GPUComputePassEncoder;
+declare function createMockWebGPUContext(): MockWebGPUContext;
 
 /**
  * Interface for the mock RequestAnimationFrame implementation.
@@ -1333,6 +1376,12 @@ declare function createMockMd3Pipeline(overrides?: Partial<Md3Pipeline>): Md3Pip
 declare function createMockSpritePipeline(overrides?: Partial<SpriteRenderer>): SpriteRenderer;
 declare function createMockSkyboxPipeline(overrides?: Partial<SkyboxPipeline>): SkyboxPipeline;
 
+declare function createMockAssetManager(overrides?: Partial<AssetManager>): AssetManager;
+declare function createMockTexture(width?: number, height?: number, data?: Uint8Array): PreparedTexture;
+declare function createMockMd2Model(overrides?: Partial<Md2Model>): Md2Model;
+declare function createMockMd3Model(overrides?: Partial<Md3Model>): Md3Model;
+declare function createMockBspMap(overrides?: Partial<BspMap>): BspMap;
+
 interface MockPipeline {
     render: ReturnType<typeof vi.fn>;
     init: ReturnType<typeof vi.fn>;
@@ -1412,6 +1461,62 @@ interface AudioEvent {
  */
 declare function captureAudioEvents(context: AudioContext): AudioEvent[];
 
+/**
+ * Interface for render test setup
+ */
+interface RenderTestSetup {
+    context: WebGPUContextState;
+    renderTarget: GPUTexture;
+    renderTargetView: GPUTextureView;
+    commandEncoder: GPUCommandEncoder;
+    cleanup: () => Promise<void>;
+    width: number;
+    height: number;
+}
+/**
+ * Creates a setup for testing rendering pipelines.
+ * Initializes a headless WebGPU context, a render target texture, and a command encoder.
+ */
+declare function createRenderTestSetup(width?: number, height?: number): Promise<RenderTestSetup>;
+/**
+ * Helper to render and capture the output as pixel data.
+ * It manages the render pass, submission, and buffer readback.
+ */
+declare function renderAndCapture(setup: RenderTestSetup, renderFn: (pass: GPURenderPassEncoder) => void): Promise<Uint8ClampedArray>;
+/**
+ * Interface for compute test setup
+ */
+interface ComputeTestSetup {
+    context: WebGPUContextState;
+    outputBuffer: GPUBuffer;
+    commandEncoder: GPUCommandEncoder;
+    cleanup: () => Promise<void>;
+    outputSize: number;
+}
+/**
+ * Creates a setup for testing compute shaders.
+ */
+declare function createComputeTestSetup(outputSize: number): Promise<ComputeTestSetup>;
+/**
+ * Helper to run a compute pass and read back the output buffer.
+ */
+declare function runComputeAndReadback(setup: ComputeTestSetup, computeFn: (pass: GPUComputePassEncoder) => void): Promise<ArrayBuffer>;
+
+interface GeometryBuffers {
+    vertexBuffer: GPUBuffer;
+    indexBuffer?: GPUBuffer;
+    vertexCount: number;
+    indexCount?: number;
+}
+/**
+ * Template for testing a rendering pipeline
+ */
+declare function testPipelineRendering(name: string, createPipeline: (device: GPUDevice) => GPURenderPipeline, setupGeometry: (device: GPUDevice) => GeometryBuffers, expectedOutput?: Uint8ClampedArray): Promise<void>;
+/**
+ * Template for testing compute shaders
+ */
+declare function testComputeShader(name: string, createComputePipeline: (device: GPUDevice) => GPUComputePipeline, inputData: Float32Array, expectedOutput?: Float32Array): Promise<void>;
+
 /**
  * Client Input System Mocks
  *
@@ -1595,6 +1700,107 @@ declare function createMockEntityState(number: number, modelIndex?: number, orig
 declare function createMockDamageIndicator(damage: number, dir?: Vec3, health?: boolean, armor?: boolean, power?: boolean): DamageIndicator;
 declare function createMockFogData(overrides?: Partial<FogData>): FogData;
 
+interface DownloadManager {
+    download(url: string): Promise<ArrayBuffer>;
+    cancel(url: string): void;
+    getProgress(url: string): number;
+}
+declare function createMockDownloadManager(overrides?: Partial<DownloadManager>): DownloadManager;
+interface PrecacheList {
+    models: string[];
+    sounds: string[];
+    images: string[];
+}
+declare function createMockPrecacheList(models?: string[], sounds?: string[], images?: string[]): PrecacheList;
+declare function simulateDownload(url: string, progressCallback?: (percent: number) => void): Promise<ArrayBuffer>;
+
+declare class MockClientConfigStrings {
+    private readonly strings;
+    private readonly models;
+    private readonly sounds;
+    private readonly images;
+    constructor();
+    set(index: number, value: string): void;
+    get(index: number): string | undefined;
+    getModelName(index: number): string | undefined;
+    getSoundName(index: number): string | undefined;
+    getImageName(index: number): string | undefined;
+    getPlayerName(playernum: number): string | undefined;
+    clear(): void;
+}
+interface ClientStateProvider {
+    tickRate: number;
+    frameTimeMs: number;
+    serverFrame: number;
+    serverProtocol: number;
+    configStrings: MockClientConfigStrings;
+    getClientName(num: number): string;
+    getKeyBinding(key: string): string;
+    inAutoDemo: boolean;
+}
+interface ClientInfo {
+    name: string;
+    skin: string;
+    model: string;
+    icon: string;
+}
+interface ClientState extends ClientStateProvider {
+    playerNum: number;
+    serverTime: number;
+    parseEntities: number;
+}
+interface Frame {
+    serverFrame: number;
+    deltaFrame: number;
+    valid: boolean;
+    entities: EntityState[];
+}
+interface ConnectionState {
+    state: 'disconnected' | 'connecting' | 'connected' | 'active';
+}
+declare const createMockClientState: (overrides?: Partial<ClientState>) => ClientState;
+declare const createMockFrame: (overrides?: Partial<Frame>) => Frame;
+declare const createMockClientInfo: (overrides?: Partial<ClientInfo>) => ClientInfo;
+declare const createMockConnectionState: (state?: ConnectionState["state"]) => ConnectionState;
+
+interface MockConsole {
+    print: (text: string) => void;
+    error: (text: string) => void;
+    execute: (text: string) => void;
+    addCommand: (name: string, handler: (args: string[]) => void) => void;
+    getCvar: (name: string) => string | undefined;
+    setCvar: (name: string, value: string) => void;
+    getHistory: () => string[];
+    clearHistory: () => void;
+    getErrors: () => string[];
+}
+interface MockCommand {
+    name: string;
+    handler: (args: string[]) => void;
+}
+interface CvarRegistry {
+    [key: string]: string;
+}
+declare function createMockConsole(overrides?: Partial<MockConsole>): MockConsole;
+declare function createMockCommand(name: string, handler: (args: string[]) => void): MockCommand;
+declare function createMockCvarRegistry(initialCvars?: Record<string, string>): CvarRegistry;
+
+interface PredictionScenario {
+    clientState: ClientState;
+    snapshots: EntityState[][];
+    lagMs: number;
+}
+interface SmoothingAnalysis {
+    smooth: boolean;
+    maxError: number;
+    averageError: number;
+    jumps: number[];
+}
+declare const createPredictionTestScenario: (lagMs?: number) => PredictionScenario;
+declare const simulateClientPrediction: (state: ClientState, input: UserCommand, deltaTime: number) => ClientState;
+declare const createInterpolationTestData: (startState: EntityState, endState: EntityState, steps?: number) => EntityState[];
+declare const verifySmoothing: (states: EntityState[]) => SmoothingAnalysis;
+
 interface PlaywrightOptions {
     headless?: boolean;
     viewport?: {
@@ -1684,4 +1890,4 @@ interface VisualScenario {
  */
 declare function createVisualTestScenario(sceneName: string): VisualScenario;
 
-export { type AudioEvent, type BandwidthScenario, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type CameraInput, type Connection, type ConsistencyReport, type ControlledTimer, type DeltaSnapshot, type DrawCall, FakeAudioContext, FakeAudioNode, FakeAudioParam, FakeBiquadFilterNode, FakeBufferSource, FakeDestination, FakeGainNode, FakePannerNode, type GameState, type GameStateCapture, type Handshake, HandshakeStage, type HudState, InputInjector, type KeyModifiers, type MasterServer, type Message, type MessageReaderMock, type MessageWriterMock, type MockAI, FakeBufferSource as MockAudioBufferSourceNode, type MockChatMessage, type MockCollisionEntityIndex, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockNetDriver, type MockNetDriverState, MockNetworkTransport, type MockNotification, MockPointerLock, type MockRAF, type MockRConClient, type MockRenderingContext, type MockServer, type MockServerConsole, type MockServerContext, type MockServerMessage, MockTransport, type MockUDPSocket, MockWebGL2RenderingContext, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkSimulator, type NodeSetupOptions, type PacketMock, type PhysicsScenario, type PlaywrightOptions, type PlaywrightTestClient, type RateLimiter, type RecordedPacket, type RefDef, type ServerInfo, type ServerListFilter, type Snapshot, type StorageScenario, type SurfaceMock, type TestContext, type TraceMock, type Transform, type UserInfo, type ViewScenario, type ViewState, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshot, compareScreenshots, createBandwidthTestScenario, createBinaryStreamMock, createBinaryWriterMock, createBounds, createCombatTestContext, createConfigStringArrayMock, createConfigStringMock, createControlledTimer, createCustomNetworkCondition, createCvarMock, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createInputInjector, createItemEntityFactory, createMessageReaderMock, createMessageWriterMock, createMockAI, createMockAmmoItem, createMockArmorItem, createMockAudioBuffer, createMockAudioContext, createMockBspPipeline, createMockBufferSource, createMockCamera, createMockCanvas, createMockCanvasContext2D, createMockChatMessage, createMockCollisionEntityIndex, createMockConnection, createMockDamageIndicator, createMockDamageInfo, createMockDeltaFrame, createMockEngine, createMockEntityState, createMockFogData, createMockFrameRenderer, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockHudState, createMockImage, createMockImageData, createMockIndexedDB, createMockInventory, createMockItem, createMockKeyboardEvent, createMockLocalStorage, createMockMasterServer, createMockMd2Pipeline, createMockMd3Pipeline, createMockMonsterAI, createMockMonsterMove, createMockMouseEvent, createMockNetDriver, createMockNetworkAddress, createMockNotification, createMockPannerNode, createMockPerformance, createMockPointerLock, createMockPowerupItem, createMockRAF, createMockRConClient, createMockRateLimiter, createMockRefDef, createMockRenderer, createMockRenderingContext, createMockScoreboard, createMockServer, createMockServerClient, createMockServerConsole, createMockServerInfo, createMockServerMessage, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockSkyboxPipeline, createMockSnapshot, createMockSpritePipeline, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockViewState, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMockWheelEvent, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPacketMock, createPhysicsTestContext, createPhysicsTestScenario, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createProjectileEntityFactory, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createSurfaceMock, createTestContext, createTraceMock, createTransform, createTriggerEntityFactory, createVector3, createViewTestScenario, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, measureSnapshotSize, mockMonsterAttacks, randomVector3, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateBandwidthLimit, simulateCameraMovement, simulateFrames, simulateGravity, simulateHandshake, simulateJump, simulateMovement, simulateNetworkCondition, simulateNetworkDelay, simulatePacketLoss, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerRegistration, simulateServerTick, simulateSnapshotDelivery, takeScreenshot, teardownBrowserEnvironment, teardownMockAudioContext, teardownNodeEnvironment, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };
+export { type AudioEvent, type BandwidthScenario, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type CameraInput, type ClientInfo, type ClientState, type ClientStateProvider, type ComputeTestSetup, type Connection, type ConnectionState, type ConsistencyReport, type ControlledTimer, type CvarRegistry, type DeltaSnapshot, type DownloadManager, type DrawCall, FakeAudioContext, FakeAudioNode, FakeAudioParam, FakeBiquadFilterNode, FakeBufferSource, FakeDestination, FakeGainNode, FakePannerNode, type Frame, type GameState, type GameStateCapture, type GeometryBuffers, type Handshake, HandshakeStage, type HeadlessWebGPUSetup, type HudState, InputInjector, type KeyModifiers, type MasterServer, type Message, type MessageReaderMock, type MessageWriterMock, type MockAI, FakeBufferSource as MockAudioBufferSourceNode, type MockChatMessage, MockClientConfigStrings, type MockCollisionEntityIndex, type MockCommand, type MockConsole, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockNetDriver, type MockNetDriverState, MockNetworkTransport, type MockNotification, MockPointerLock, type MockRAF, type MockRConClient, type MockRenderingContext, type MockServer, type MockServerConsole, type MockServerContext, type MockServerMessage, MockTransport, type MockUDPSocket, MockWebGL2RenderingContext, type MockWebGPUContext, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkSimulator, type NodeSetupOptions, type PacketMock, type PhysicsScenario, type PlaywrightOptions, type PlaywrightTestClient, type PrecacheList, type PredictionScenario, type RateLimiter, type RecordedPacket, type RefDef, type RenderTestSetup, type ServerInfo, type ServerListFilter, type SmoothingAnalysis, type Snapshot, type StorageScenario, type SurfaceMock, type TestContext, type TraceMock, type Transform, type UserInfo, type ViewScenario, type ViewState, type VisualDiff, type VisualScenario, type WebGPUContextState, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshot, compareScreenshots, createBandwidthTestScenario, createBinaryStreamMock, createBinaryWriterMock, createBounds, createCombatTestContext, createComputeTestSetup, createConfigStringArrayMock, createConfigStringMock, createControlledTimer, createCustomNetworkCondition, createCvarMock, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createHeadlessTestContext, createInputInjector, createInterpolationTestData, createItemEntityFactory, createMessageReaderMock, createMessageWriterMock, createMockAI, createMockAmmoItem, createMockArmorItem, createMockAssetManager, createMockAudioBuffer, createMockAudioContext, createMockBspMap, createMockBspPipeline, createMockBufferSource, createMockCamera, createMockCanvas, createMockCanvasContext2D, createMockChatMessage, createMockClientInfo, createMockClientState, createMockCollisionEntityIndex, createMockCommand, createMockCommandEncoder, createMockComputePassEncoder, createMockComputePipeline, createMockConnection, createMockConnectionState, createMockConsole, createMockCvarRegistry, createMockDamageIndicator, createMockDamageInfo, createMockDeltaFrame, createMockDownloadManager, createMockEngine, createMockEntityState, createMockFogData, createMockFrame, createMockFrameRenderer, createMockGPUAdapter, createMockGPUBuffer, createMockGPUDevice, createMockGPUTexture, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockHudState, createMockImage, createMockImageData, createMockIndexedDB, createMockInventory, createMockItem, createMockKeyboardEvent, createMockLocalStorage, createMockMasterServer, createMockMd2Model, createMockMd2Pipeline, createMockMd3Model, createMockMd3Pipeline, createMockMonsterAI, createMockMonsterMove, createMockMouseEvent, createMockNetDriver, createMockNetworkAddress, createMockNotification, createMockPannerNode, createMockPerformance, createMockPointerLock, createMockPowerupItem, createMockPrecacheList, createMockQueue, createMockRAF, createMockRConClient, createMockRateLimiter, createMockRefDef, createMockRenderPassEncoder, createMockRenderPipeline, createMockRenderer, createMockRenderingContext, createMockSampler, createMockScoreboard, createMockServer, createMockServerClient, createMockServerConsole, createMockServerInfo, createMockServerMessage, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockShaderModule, createMockSkyboxPipeline, createMockSnapshot, createMockSpritePipeline, createMockTexture, createMockTextureView, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockViewState, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMockWebGPUContext, createMockWheelEvent, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPacketMock, createPhysicsTestContext, createPhysicsTestScenario, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createPredictionTestScenario, createProjectileEntityFactory, createRenderTestSetup, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createSurfaceMock, createTestContext, createTraceMock, createTransform, createTriggerEntityFactory, createVector3, createViewTestScenario, createVisualTestScenario, initHeadlessWebGPU, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, measureSnapshotSize, mockMonsterAttacks, randomVector3, renderAndCapture, runComputeAndReadback, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateBandwidthLimit, simulateCameraMovement, simulateClientPrediction, simulateDownload, simulateFrames, simulateGravity, simulateHandshake, simulateJump, simulateMovement, simulateNetworkCondition, simulateNetworkDelay, simulatePacketLoss, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerRegistration, simulateServerTick, simulateSnapshotDelivery, takeScreenshot, teardownBrowserEnvironment, teardownMockAudioContext, teardownNodeEnvironment, testComputeShader, testPipelineRendering, throttleBandwidth, verifySmoothing, verifySnapshotConsistency, waitForGameReady };

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

@@ -4,10 +4,10 @@ import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, Col
 export { intersects, ladderTrace, stairTrace } from '@quake2ts/shared';
 import { Vec3 as Vec3$1, Bounds3 } from '@quake2ts/shared/math/vec3';
 import { TraceResult, CollisionPlane as CollisionPlane$1 } from '@quake2ts/shared/bsp/collision';
-import { ConfigStringEntry, Cvar, AudioNodeLike, AudioBufferSourceNodeLike, AudioBufferLike, AudioParamLike, GainNodeLike, DynamicsCompressorNodeLike, PannerNodeLike, BiquadFilterNodeLike, AudioDestinationNodeLike, AudioContextLike, Renderer, FrameRenderer, BspSurfacePipeline, Md2Pipeline, Md3Pipeline, SpriteRenderer, SkyboxPipeline, Camera, FrameRenderStats, EntityState as EntityState$1, ProtocolPlayerState, FrameData, DamageIndicator, FogData } from '@quake2ts/engine';
+import { ConfigStringEntry, Cvar, AudioNodeLike, AudioBufferSourceNodeLike, AudioBufferLike, AudioParamLike, GainNodeLike, DynamicsCompressorNodeLike, PannerNodeLike, BiquadFilterNodeLike, AudioDestinationNodeLike, AudioContextLike, Renderer, FrameRenderer, BspSurfacePipeline, Md2Pipeline, Md3Pipeline, SpriteRenderer, SkyboxPipeline, AssetManager, PreparedTexture, Md2Model, Md3Model, BspMap, Camera, FrameRenderStats, EntityState as EntityState$1, ProtocolPlayerState, FrameData, DamageIndicator, FogData } from '@quake2ts/engine';
 export { ConfigStringEntry, Cvar } from '@quake2ts/engine';
 import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, MonsterMove, DamageMod, PlayerInventory, BaseItem, WeaponId, WeaponItem, HealthItem, ArmorItem, AmmoItemId, PowerupItem, GameExports, PlayerClient } from '@quake2ts/game';
-import { NetworkTransport, Server, ServerStatic, Client, ClientState, ClientFrame } from '@quake2ts/server';
+import { NetworkTransport, Server, ServerStatic, Client, ClientState as ClientState$1, ClientFrame } from '@quake2ts/server';
 import { ImageData, Canvas } from '@napi-rs/canvas';
 import { vec3 } from 'gl-matrix';
 
@@ -703,7 +703,7 @@ declare function createMockServer(overrides?: Partial<MockServer>): MockServer;
  * Interface representing connection state for testing.
  */
 interface Connection {
-    state: ClientState;
+    state: ClientState$1;
     address: string;
     challenge: number;
     userInfo: UserInfo;
@@ -756,7 +756,7 @@ declare function createMockUserInfo(overrides?: Partial<UserInfo>): UserInfo;
  * @param state The client state (default: Connected).
  * @param overrides Optional overrides for the client.
  */
-declare function createMockConnection(state?: ClientState, overrides?: Partial<Client>): Client;
+declare function createMockConnection(state?: ClientState$1, overrides?: Partial<Client>): Client;
 /**
  * Creates a mock handshake object.
  * @param stage The stage of the handshake (default: None).
@@ -1032,16 +1032,59 @@ declare function createMockImageData(width: number, height: number, fillColor?:
  */
 declare function createMockImage(width?: number, height?: number, src?: string): HTMLImageElement;
 
-declare function createMockGPUAdapter(): GPUAdapter;
-declare function createMockGPUDevice(): GPUDevice;
-declare function createMockGPUCanvasContext(): GPUCanvasContext;
+interface HeadlessWebGPUSetup {
+    adapter: GPUAdapter;
+    device: GPUDevice;
+    cleanup: () => Promise<void>;
+}
+interface WebGPUContextState {
+    adapter: GPUAdapter;
+    device: GPUDevice;
+    queue: GPUQueue;
+}
+/**
+ * Initialize WebGPU in a headless Node.js environment using @webgpu/dawn (via webgpu package)
+ */
+declare function initHeadlessWebGPU(options?: {
+    powerPreference?: 'low-power' | 'high-performance';
+    requiredFeatures?: GPUFeatureName[];
+}): Promise<HeadlessWebGPUSetup>;
+/**
+ * Creates a complete context state for testing
+ */
+declare function createHeadlessTestContext(): Promise<WebGPUContextState>;
+
+interface MockWebGPUContext {
+    adapter: GPUAdapter;
+    device: GPUDevice;
+    queue: GPUQueue;
+}
+/**
+ * Patches globalThis with WebGPU globals (GPUBufferUsage, etc.)
+ * and optionally patches navigator.gpu.
+ */
 declare function setupWebGPUMocks(): {
     mockGpu: {
         requestAdapter: vitest.Mock<any, any>;
         getPreferredCanvasFormat: vitest.Mock<any, any>;
     };
     mockAdapter: GPUAdapter;
+    mockDevice: GPUDevice;
 };
+declare function createMockGPUAdapter(options?: Partial<GPUAdapter>): GPUAdapter;
+declare function createMockGPUDevice(features?: Set<GPUFeatureName>): GPUDevice;
+declare function createMockQueue(): GPUQueue;
+declare function createMockGPUBuffer(descriptor: GPUBufferDescriptor): GPUBuffer;
+declare function createMockGPUTexture(descriptor: GPUTextureDescriptor): GPUTexture;
+declare function createMockTextureView(): GPUTextureView;
+declare function createMockSampler(): GPUSampler;
+declare function createMockShaderModule(descriptor: GPUShaderModuleDescriptor): GPUShaderModule;
+declare function createMockComputePipeline(): GPUComputePipeline;
+declare function createMockRenderPipeline(): GPURenderPipeline;
+declare function createMockCommandEncoder(): GPUCommandEncoder;
+declare function createMockRenderPassEncoder(): GPURenderPassEncoder;
+declare function createMockComputePassEncoder(): GPUComputePassEncoder;
+declare function createMockWebGPUContext(): MockWebGPUContext;
 
 /**
  * Interface for the mock RequestAnimationFrame implementation.
@@ -1333,6 +1376,12 @@ declare function createMockMd3Pipeline(overrides?: Partial<Md3Pipeline>): Md3Pip
 declare function createMockSpritePipeline(overrides?: Partial<SpriteRenderer>): SpriteRenderer;
 declare function createMockSkyboxPipeline(overrides?: Partial<SkyboxPipeline>): SkyboxPipeline;
 
+declare function createMockAssetManager(overrides?: Partial<AssetManager>): AssetManager;
+declare function createMockTexture(width?: number, height?: number, data?: Uint8Array): PreparedTexture;
+declare function createMockMd2Model(overrides?: Partial<Md2Model>): Md2Model;
+declare function createMockMd3Model(overrides?: Partial<Md3Model>): Md3Model;
+declare function createMockBspMap(overrides?: Partial<BspMap>): BspMap;
+
 interface MockPipeline {
     render: ReturnType<typeof vi.fn>;
     init: ReturnType<typeof vi.fn>;
@@ -1412,6 +1461,62 @@ interface AudioEvent {
  */
 declare function captureAudioEvents(context: AudioContext): AudioEvent[];
 
+/**
+ * Interface for render test setup
+ */
+interface RenderTestSetup {
+    context: WebGPUContextState;
+    renderTarget: GPUTexture;
+    renderTargetView: GPUTextureView;
+    commandEncoder: GPUCommandEncoder;
+    cleanup: () => Promise<void>;
+    width: number;
+    height: number;
+}
+/**
+ * Creates a setup for testing rendering pipelines.
+ * Initializes a headless WebGPU context, a render target texture, and a command encoder.
+ */
+declare function createRenderTestSetup(width?: number, height?: number): Promise<RenderTestSetup>;
+/**
+ * Helper to render and capture the output as pixel data.
+ * It manages the render pass, submission, and buffer readback.
+ */
+declare function renderAndCapture(setup: RenderTestSetup, renderFn: (pass: GPURenderPassEncoder) => void): Promise<Uint8ClampedArray>;
+/**
+ * Interface for compute test setup
+ */
+interface ComputeTestSetup {
+    context: WebGPUContextState;
+    outputBuffer: GPUBuffer;
+    commandEncoder: GPUCommandEncoder;
+    cleanup: () => Promise<void>;
+    outputSize: number;
+}
+/**
+ * Creates a setup for testing compute shaders.
+ */
+declare function createComputeTestSetup(outputSize: number): Promise<ComputeTestSetup>;
+/**
+ * Helper to run a compute pass and read back the output buffer.
+ */
+declare function runComputeAndReadback(setup: ComputeTestSetup, computeFn: (pass: GPUComputePassEncoder) => void): Promise<ArrayBuffer>;
+
+interface GeometryBuffers {
+    vertexBuffer: GPUBuffer;
+    indexBuffer?: GPUBuffer;
+    vertexCount: number;
+    indexCount?: number;
+}
+/**
+ * Template for testing a rendering pipeline
+ */
+declare function testPipelineRendering(name: string, createPipeline: (device: GPUDevice) => GPURenderPipeline, setupGeometry: (device: GPUDevice) => GeometryBuffers, expectedOutput?: Uint8ClampedArray): Promise<void>;
+/**
+ * Template for testing compute shaders
+ */
+declare function testComputeShader(name: string, createComputePipeline: (device: GPUDevice) => GPUComputePipeline, inputData: Float32Array, expectedOutput?: Float32Array): Promise<void>;
+
 /**
  * Client Input System Mocks
  *
@@ -1595,6 +1700,107 @@ declare function createMockEntityState(number: number, modelIndex?: number, orig
 declare function createMockDamageIndicator(damage: number, dir?: Vec3, health?: boolean, armor?: boolean, power?: boolean): DamageIndicator;
 declare function createMockFogData(overrides?: Partial<FogData>): FogData;
 
+interface DownloadManager {
+    download(url: string): Promise<ArrayBuffer>;
+    cancel(url: string): void;
+    getProgress(url: string): number;
+}
+declare function createMockDownloadManager(overrides?: Partial<DownloadManager>): DownloadManager;
+interface PrecacheList {
+    models: string[];
+    sounds: string[];
+    images: string[];
+}
+declare function createMockPrecacheList(models?: string[], sounds?: string[], images?: string[]): PrecacheList;
+declare function simulateDownload(url: string, progressCallback?: (percent: number) => void): Promise<ArrayBuffer>;
+
+declare class MockClientConfigStrings {
+    private readonly strings;
+    private readonly models;
+    private readonly sounds;
+    private readonly images;
+    constructor();
+    set(index: number, value: string): void;
+    get(index: number): string | undefined;
+    getModelName(index: number): string | undefined;
+    getSoundName(index: number): string | undefined;
+    getImageName(index: number): string | undefined;
+    getPlayerName(playernum: number): string | undefined;
+    clear(): void;
+}
+interface ClientStateProvider {
+    tickRate: number;
+    frameTimeMs: number;
+    serverFrame: number;
+    serverProtocol: number;
+    configStrings: MockClientConfigStrings;
+    getClientName(num: number): string;
+    getKeyBinding(key: string): string;
+    inAutoDemo: boolean;
+}
+interface ClientInfo {
+    name: string;
+    skin: string;
+    model: string;
+    icon: string;
+}
+interface ClientState extends ClientStateProvider {
+    playerNum: number;
+    serverTime: number;
+    parseEntities: number;
+}
+interface Frame {
+    serverFrame: number;
+    deltaFrame: number;
+    valid: boolean;
+    entities: EntityState[];
+}
+interface ConnectionState {
+    state: 'disconnected' | 'connecting' | 'connected' | 'active';
+}
+declare const createMockClientState: (overrides?: Partial<ClientState>) => ClientState;
+declare const createMockFrame: (overrides?: Partial<Frame>) => Frame;
+declare const createMockClientInfo: (overrides?: Partial<ClientInfo>) => ClientInfo;
+declare const createMockConnectionState: (state?: ConnectionState["state"]) => ConnectionState;
+
+interface MockConsole {
+    print: (text: string) => void;
+    error: (text: string) => void;
+    execute: (text: string) => void;
+    addCommand: (name: string, handler: (args: string[]) => void) => void;
+    getCvar: (name: string) => string | undefined;
+    setCvar: (name: string, value: string) => void;
+    getHistory: () => string[];
+    clearHistory: () => void;
+    getErrors: () => string[];
+}
+interface MockCommand {
+    name: string;
+    handler: (args: string[]) => void;
+}
+interface CvarRegistry {
+    [key: string]: string;
+}
+declare function createMockConsole(overrides?: Partial<MockConsole>): MockConsole;
+declare function createMockCommand(name: string, handler: (args: string[]) => void): MockCommand;
+declare function createMockCvarRegistry(initialCvars?: Record<string, string>): CvarRegistry;
+
+interface PredictionScenario {
+    clientState: ClientState;
+    snapshots: EntityState[][];
+    lagMs: number;
+}
+interface SmoothingAnalysis {
+    smooth: boolean;
+    maxError: number;
+    averageError: number;
+    jumps: number[];
+}
+declare const createPredictionTestScenario: (lagMs?: number) => PredictionScenario;
+declare const simulateClientPrediction: (state: ClientState, input: UserCommand, deltaTime: number) => ClientState;
+declare const createInterpolationTestData: (startState: EntityState, endState: EntityState, steps?: number) => EntityState[];
+declare const verifySmoothing: (states: EntityState[]) => SmoothingAnalysis;
+
 interface PlaywrightOptions {
     headless?: boolean;
     viewport?: {
@@ -1684,4 +1890,4 @@ interface VisualScenario {
  */
 declare function createVisualTestScenario(sceneName: string): VisualScenario;
 
-export { type AudioEvent, type BandwidthScenario, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type CameraInput, type Connection, type ConsistencyReport, type ControlledTimer, type DeltaSnapshot, type DrawCall, FakeAudioContext, FakeAudioNode, FakeAudioParam, FakeBiquadFilterNode, FakeBufferSource, FakeDestination, FakeGainNode, FakePannerNode, type GameState, type GameStateCapture, type Handshake, HandshakeStage, type HudState, InputInjector, type KeyModifiers, type MasterServer, type Message, type MessageReaderMock, type MessageWriterMock, type MockAI, FakeBufferSource as MockAudioBufferSourceNode, type MockChatMessage, type MockCollisionEntityIndex, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockNetDriver, type MockNetDriverState, MockNetworkTransport, type MockNotification, MockPointerLock, type MockRAF, type MockRConClient, type MockRenderingContext, type MockServer, type MockServerConsole, type MockServerContext, type MockServerMessage, MockTransport, type MockUDPSocket, MockWebGL2RenderingContext, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkSimulator, type NodeSetupOptions, type PacketMock, type PhysicsScenario, type PlaywrightOptions, type PlaywrightTestClient, type RateLimiter, type RecordedPacket, type RefDef, type ServerInfo, type ServerListFilter, type Snapshot, type StorageScenario, type SurfaceMock, type TestContext, type TraceMock, type Transform, type UserInfo, type ViewScenario, type ViewState, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshot, compareScreenshots, createBandwidthTestScenario, createBinaryStreamMock, createBinaryWriterMock, createBounds, createCombatTestContext, createConfigStringArrayMock, createConfigStringMock, createControlledTimer, createCustomNetworkCondition, createCvarMock, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createInputInjector, createItemEntityFactory, createMessageReaderMock, createMessageWriterMock, createMockAI, createMockAmmoItem, createMockArmorItem, createMockAudioBuffer, createMockAudioContext, createMockBspPipeline, createMockBufferSource, createMockCamera, createMockCanvas, createMockCanvasContext2D, createMockChatMessage, createMockCollisionEntityIndex, createMockConnection, createMockDamageIndicator, createMockDamageInfo, createMockDeltaFrame, createMockEngine, createMockEntityState, createMockFogData, createMockFrameRenderer, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockHudState, createMockImage, createMockImageData, createMockIndexedDB, createMockInventory, createMockItem, createMockKeyboardEvent, createMockLocalStorage, createMockMasterServer, createMockMd2Pipeline, createMockMd3Pipeline, createMockMonsterAI, createMockMonsterMove, createMockMouseEvent, createMockNetDriver, createMockNetworkAddress, createMockNotification, createMockPannerNode, createMockPerformance, createMockPointerLock, createMockPowerupItem, createMockRAF, createMockRConClient, createMockRateLimiter, createMockRefDef, createMockRenderer, createMockRenderingContext, createMockScoreboard, createMockServer, createMockServerClient, createMockServerConsole, createMockServerInfo, createMockServerMessage, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockSkyboxPipeline, createMockSnapshot, createMockSpritePipeline, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockViewState, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMockWheelEvent, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPacketMock, createPhysicsTestContext, createPhysicsTestScenario, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createProjectileEntityFactory, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createSurfaceMock, createTestContext, createTraceMock, createTransform, createTriggerEntityFactory, createVector3, createViewTestScenario, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, measureSnapshotSize, mockMonsterAttacks, randomVector3, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateBandwidthLimit, simulateCameraMovement, simulateFrames, simulateGravity, simulateHandshake, simulateJump, simulateMovement, simulateNetworkCondition, simulateNetworkDelay, simulatePacketLoss, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerRegistration, simulateServerTick, simulateSnapshotDelivery, takeScreenshot, teardownBrowserEnvironment, teardownMockAudioContext, teardownNodeEnvironment, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };
+export { type AudioEvent, type BandwidthScenario, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type CameraInput, type ClientInfo, type ClientState, type ClientStateProvider, type ComputeTestSetup, type Connection, type ConnectionState, type ConsistencyReport, type ControlledTimer, type CvarRegistry, type DeltaSnapshot, type DownloadManager, type DrawCall, FakeAudioContext, FakeAudioNode, FakeAudioParam, FakeBiquadFilterNode, FakeBufferSource, FakeDestination, FakeGainNode, FakePannerNode, type Frame, type GameState, type GameStateCapture, type GeometryBuffers, type Handshake, HandshakeStage, type HeadlessWebGPUSetup, type HudState, InputInjector, type KeyModifiers, type MasterServer, type Message, type MessageReaderMock, type MessageWriterMock, type MockAI, FakeBufferSource as MockAudioBufferSourceNode, type MockChatMessage, MockClientConfigStrings, type MockCollisionEntityIndex, type MockCommand, type MockConsole, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockNetDriver, type MockNetDriverState, MockNetworkTransport, type MockNotification, MockPointerLock, type MockRAF, type MockRConClient, type MockRenderingContext, type MockServer, type MockServerConsole, type MockServerContext, type MockServerMessage, MockTransport, type MockUDPSocket, MockWebGL2RenderingContext, type MockWebGPUContext, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkSimulator, type NodeSetupOptions, type PacketMock, type PhysicsScenario, type PlaywrightOptions, type PlaywrightTestClient, type PrecacheList, type PredictionScenario, type RateLimiter, type RecordedPacket, type RefDef, type RenderTestSetup, type ServerInfo, type ServerListFilter, type SmoothingAnalysis, type Snapshot, type StorageScenario, type SurfaceMock, type TestContext, type TraceMock, type Transform, type UserInfo, type ViewScenario, type ViewState, type VisualDiff, type VisualScenario, type WebGPUContextState, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshot, compareScreenshots, createBandwidthTestScenario, createBinaryStreamMock, createBinaryWriterMock, createBounds, createCombatTestContext, createComputeTestSetup, createConfigStringArrayMock, createConfigStringMock, createControlledTimer, createCustomNetworkCondition, createCvarMock, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createHeadlessTestContext, createInputInjector, createInterpolationTestData, createItemEntityFactory, createMessageReaderMock, createMessageWriterMock, createMockAI, createMockAmmoItem, createMockArmorItem, createMockAssetManager, createMockAudioBuffer, createMockAudioContext, createMockBspMap, createMockBspPipeline, createMockBufferSource, createMockCamera, createMockCanvas, createMockCanvasContext2D, createMockChatMessage, createMockClientInfo, createMockClientState, createMockCollisionEntityIndex, createMockCommand, createMockCommandEncoder, createMockComputePassEncoder, createMockComputePipeline, createMockConnection, createMockConnectionState, createMockConsole, createMockCvarRegistry, createMockDamageIndicator, createMockDamageInfo, createMockDeltaFrame, createMockDownloadManager, createMockEngine, createMockEntityState, createMockFogData, createMockFrame, createMockFrameRenderer, createMockGPUAdapter, createMockGPUBuffer, createMockGPUDevice, createMockGPUTexture, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockHudState, createMockImage, createMockImageData, createMockIndexedDB, createMockInventory, createMockItem, createMockKeyboardEvent, createMockLocalStorage, createMockMasterServer, createMockMd2Model, createMockMd2Pipeline, createMockMd3Model, createMockMd3Pipeline, createMockMonsterAI, createMockMonsterMove, createMockMouseEvent, createMockNetDriver, createMockNetworkAddress, createMockNotification, createMockPannerNode, createMockPerformance, createMockPointerLock, createMockPowerupItem, createMockPrecacheList, createMockQueue, createMockRAF, createMockRConClient, createMockRateLimiter, createMockRefDef, createMockRenderPassEncoder, createMockRenderPipeline, createMockRenderer, createMockRenderingContext, createMockSampler, createMockScoreboard, createMockServer, createMockServerClient, createMockServerConsole, createMockServerInfo, createMockServerMessage, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockShaderModule, createMockSkyboxPipeline, createMockSnapshot, createMockSpritePipeline, createMockTexture, createMockTextureView, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockViewState, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMockWebGPUContext, createMockWheelEvent, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPacketMock, createPhysicsTestContext, createPhysicsTestScenario, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createPredictionTestScenario, createProjectileEntityFactory, createRenderTestSetup, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createSurfaceMock, createTestContext, createTraceMock, createTransform, createTriggerEntityFactory, createVector3, createViewTestScenario, createVisualTestScenario, initHeadlessWebGPU, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, measureSnapshotSize, mockMonsterAttacks, randomVector3, renderAndCapture, runComputeAndReadback, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateBandwidthLimit, simulateCameraMovement, simulateClientPrediction, simulateDownload, simulateFrames, simulateGravity, simulateHandshake, simulateJump, simulateMovement, simulateNetworkCondition, simulateNetworkDelay, simulatePacketLoss, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerRegistration, simulateServerTick, simulateSnapshotDelivery, takeScreenshot, teardownBrowserEnvironment, teardownMockAudioContext, teardownNodeEnvironment, testComputeShader, testPipelineRendering, throttleBandwidth, verifySmoothing, verifySnapshotConsistency, waitForGameReady };