@quake2ts/test-utils 0.0.818 → 0.0.823

package/dist/index.d.cts

@@ -1,11 +1,12 @@
 import * as vitest from 'vitest';
 import { Mock, vi } from 'vitest';
-import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, TraceResult as TraceResult$1, NetDriver, NetChan, UserCommand, ProtocolPlayerState } from '@quake2ts/shared';
+import * as SharedMath from '@quake2ts/shared';
+import { CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, Vec3 as Vec3$1, TraceResult as TraceResult$1, NetDriver, NetChan, UserCommand, ProtocolPlayerState } from '@quake2ts/shared';
 export { ZERO_VEC3, 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, BspModel, WebGLContextState, AudioNodeLike, AudioBufferSourceNodeLike, AudioBufferLike, AudioParamLike, GainNodeLike, DynamicsCompressorNodeLike, PannerNodeLike, BiquadFilterNodeLike, AudioDestinationNodeLike, AudioContextLike, Renderer, FrameRenderer, BspSurfacePipeline, Md2Pipeline, Md3Pipeline, SpriteRenderer, SkyboxPipeline, AssetManager, PreparedTexture, Md2Model, Md3Model, BspMap, BufferUsage, VertexBuffer, IndexBuffer, ShaderProgram, DLight, DynamicLightManager, ParticleSystem, NullRenderer, CoordinateSystem, LoggingRenderer, Camera, FrameRenderStats, EntityState as EntityState$1, ProtocolPlayerState as ProtocolPlayerState$1, FrameData, DamageIndicator, FogData } from '@quake2ts/engine';
+import { BspTexInfo, BspLightmapInfo, BspEntity, BspMap, ConfigStringEntry, Cvar, BspModel, WebGLContextState, AudioNodeLike, AudioBufferSourceNodeLike, AudioBufferLike, AudioParamLike, GainNodeLike, DynamicsCompressorNodeLike, PannerNodeLike, BiquadFilterNodeLike, AudioDestinationNodeLike, AudioContextLike, Renderer, FrameRenderer, BspSurfacePipeline, Md2Pipeline, Md3Pipeline, SpriteRenderer, SkyboxPipeline, AssetManager, PreparedTexture, Md2Model, Md3Model, BufferUsage, VertexBuffer, IndexBuffer, ShaderProgram, DLight, DynamicLightManager, ParticleSystem, NullRenderer, CoordinateSystem, LoggingRenderer, Camera, FrameRenderStats, EntityState as EntityState$1, ProtocolPlayerState as ProtocolPlayerState$1, FrameData, DamageIndicator, FogData } from '@quake2ts/engine';
 export { ConfigStringEntry, Cvar, DLight, DynamicLightManager, IndexBuffer, ParticleSystem, ShaderProgram, VertexBuffer } from '@quake2ts/engine';
+import { Vec3, Bounds3 } from '@quake2ts/shared/math/vec3';
+import { TraceResult, CollisionPlane as CollisionPlane$1 } from '@quake2ts/shared/bsp/collision';
 import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, GameSaveFile, LevelState, MonsterMove, DamageMod, ArmorType, RegularArmorState, PowerArmorState, PlayerInventory, BaseItem, WeaponId, WeaponItem, HealthItem, ArmorItem, AmmoItemId, PowerupItem, PlayerClient } from '@quake2ts/game';
 import { NetworkTransport, Server, ServerStatic, Client, ClientState as ClientState$1, ClientFrame } from '@quake2ts/server';
 import { ImageData, Canvas } from '@napi-rs/canvas';
@@ -174,7 +175,7 @@ declare const createPacketMock: (overrides?: Partial<PacketMock>) => PacketMock;
  * @param dist - The distance from the origin.
  * @returns A CollisionPlane object.
  */
-declare function makePlane(normal: Vec3, dist: number): CollisionPlane;
+declare function makePlane(normal: SharedMath.Vec3, dist: number): CollisionPlane;
 /**
  * Creates a simple axis-aligned cubic brush for testing.
  *
@@ -227,7 +228,37 @@ declare function makeLeafModel(brushes: CollisionBrush[]): CollisionModel;
  * @param contents - Content flags (default: CONTENTS_SOLID).
  * @returns A CollisionBrush object.
  */
-declare function makeBrushFromMinsMaxs(mins: Vec3, maxs: Vec3, contents?: number): CollisionBrush;
+declare function makeBrushFromMinsMaxs(mins: SharedMath.Vec3, maxs: SharedMath.Vec3, contents?: number): CollisionBrush;
+type BspVec3 = [number, number, number];
+interface TestBspSurface {
+    vertices: BspVec3[];
+    texInfo?: Partial<BspTexInfo>;
+    lightmap?: Uint8Array;
+    lightmapInfo?: BspLightmapInfo;
+    styles?: [number, number, number, number];
+}
+interface TestBspMapOptions {
+    surfaces?: TestBspSurface[];
+    entities?: BspEntity[];
+}
+/**
+ * Creates a minimal valid BspMap for testing rendering.
+ *
+ * @param options - Configuration for the test BSP map.
+ * @returns A BspMap object populated with the requested surfaces.
+ */
+declare function createTestBspMap(options?: TestBspMapOptions): BspMap;
+/**
+ * Creates a simple solid color lightmap of specified dimensions.
+ *
+ * @param width - Width of the lightmap (usually small, e.g. 16x16)
+ * @param height - Height of the lightmap
+ * @param r - Red component (0-255)
+ * @param g - Green component (0-255)
+ * @param b - Blue component (0-255)
+ * @returns Uint8Array containing RGB data
+ */
+declare function createTestLightmap(width: number, height: number, r: number, g: number, b: number): Uint8Array;
 
 declare function findPakFile(): string | null;
 declare function loadMapFromPak(mapName: string): ArrayBuffer | null;
@@ -240,7 +271,7 @@ declare function loadMapFromPak(mapName: string): ArrayBuffer | null;
  * @param z - The Z coordinate (default: 0).
  * @returns A Vec3 object.
  */
-declare const createVector3: (x?: number, y?: number, z?: number) => Vec3$1;
+declare const createVector3: (x?: number, y?: number, z?: number) => Vec3;
 /**
  * Creates a bounds object (min/max vectors).
  *
@@ -248,14 +279,14 @@ declare const createVector3: (x?: number, y?: number, z?: number) => Vec3$1;
  * @param maxs - The maximum bounds vector (default: 1,1,1).
  * @returns A Bounds3 object.
  */
-declare const createBounds: (mins?: Vec3$1, maxs?: Vec3$1) => Bounds3;
+declare const createBounds: (mins?: Vec3, maxs?: Vec3) => Bounds3;
 /**
  * Interface representing a transformation (position, rotation, scale).
  */
 interface Transform {
-    position: Vec3$1;
-    rotation: Vec3$1;
-    scale: Vec3$1;
+    position: Vec3;
+    rotation: Vec3;
+    scale: Vec3;
 }
 /**
  * Creates a Transform object.
@@ -271,14 +302,14 @@ declare const createTransform: (overrides?: Partial<Transform>) => Transform;
  * @param max - Maximum value for each component (default: 100).
  * @returns A random Vec3 object.
  */
-declare const randomVector3: (min?: number, max?: number) => Vec3$1;
+declare const randomVector3: (min?: number, max?: number) => Vec3;
 
 /**
  * Interface for a TraceResult mock, including all standard properties.
  */
 interface TraceMock extends Partial<TraceResult> {
     fraction: number;
-    endpos: Vec3$1;
+    endpos: Vec3;
     plane: CollisionPlane$1;
     surface: {
         flags: number;
@@ -474,7 +505,7 @@ declare function createPhysicsTestScenario(scenarioType: 'stairs' | 'ladder' | '
  * Uses the game's runPmove logic or manually invokes similar steps.
  * This is useful for testing specific movement mechanics in isolation.
  */
-declare function simulateMovement(entity: Entity, destination: Vec3, context: TestContext): TraceResult$1;
+declare function simulateMovement(entity: Entity, destination: Vec3$1, context: TestContext): TraceResult$1;
 /**
  * Simulates gravity application on an entity.
  */
@@ -1586,7 +1617,7 @@ interface Lightmap {
 /**
  * Creates a mock DLight with default values.
  */
-declare function createMockDLight(position?: Vec3, color?: Vec3, intensity?: number): DLight;
+declare function createMockDLight(position?: Vec3$1, color?: Vec3$1, intensity?: number): DLight;
 /**
  * Creates a mock DynamicLightManager with spy methods.
  */
@@ -1597,8 +1628,8 @@ declare function createMockDLightManager(overrides?: Partial<DynamicLightManager
 declare function createMockLightmap(width?: number, height?: number): Lightmap;
 
 interface MockParticle {
-    position: Vec3;
-    velocity: Vec3;
+    position: Vec3$1;
+    velocity: Vec3$1;
     color: [number, number, number, number];
     size: number;
     lifetime: number;
@@ -2047,8 +2078,8 @@ interface CameraInput {
     rollDelta?: number;
 }
 interface DemoCameraResult {
-    origin: Vec3;
-    angles: Vec3;
+    origin: Vec3$1;
+    angles: Vec3$1;
     fov: number;
 }
 /**
@@ -2140,8 +2171,8 @@ declare function simulatePacketLoss<T>(messages: T[], lossPercent: number): T[];
 /**
  * Factory for creating a mock EntityState.
  */
-declare function createMockEntityState(number: number, modelIndex?: number, origin?: Partial<Vec3>, overrides?: Partial<EntityState$1>): EntityState$1;
-declare function createMockDamageIndicator(damage: number, dir?: Vec3, health?: boolean, armor?: boolean, power?: boolean): DamageIndicator;
+declare function createMockEntityState(number: number, modelIndex?: number, origin?: Partial<Vec3$1>, overrides?: Partial<EntityState$1>): EntityState$1;
+declare function createMockDamageIndicator(damage: number, dir?: Vec3$1, health?: boolean, armor?: boolean, power?: boolean): DamageIndicator;
 declare function createMockFogData(overrides?: Partial<FogData>): FogData;
 
 interface DownloadManager {
@@ -2326,4 +2357,4 @@ declare function compareScreenshots(baseline: Buffer, current: Buffer, threshold
  */
 declare function createVisualTestScenario(sceneName: string): VisualScenario;
 
-export { type AnimationSnapshotOptions, type AnimationSnapshotResult, type AudioEvent, type BandwidthScenario, type BinaryStreamMock, type BinaryWriterMock, BrowserInputSource, type BrowserSetupOptions, type CameraInput, type CaptureOptions, type ClientInfo, type ClientState, type ClientStateProvider, type ComparisonOptions, type ComparisonResult, type ComputeTestSetup, type Connection, type ConnectionState, type ConsistencyReport, type ControlledTimer, type CvarRegistry, type DeltaSnapshot, type DemoCameraResult, type DownloadManager, type DrawCall, FakeAudioContext, FakeAudioNode, FakeAudioParam, FakeBiquadFilterNode, FakeBufferSource, FakeDestination, FakeGainNode, FakePannerNode, type Frame, type GameState, type GameStateCapture, type GeometryBuffers, type Handshake, HandshakeStage, type HeadlessWebGLContext, type HeadlessWebGLOptions, type HeadlessWebGPUSetup, type HudState, InputInjector, type KeyModifiers, type LevelFrameState, type Lightmap, 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 MockImportsAndEngine, type MockMonsterAI, MockNetDriver, type MockNetDriverState, MockNetworkTransport, type MockNotification, type MockParticle, type MockParticleEmitter, MockPointerLock, type MockRAF, type MockRConClient, type MockRenderingContext, type MockSaveGame, type MockServer, type MockServerConsole, type MockServerContext, type MockServerMessage, MockTransport, type MockUDPSocket, type MockWeapon, MockWebGL2RenderingContext, type MockWebGPUContext, type MultiplayerScenario, type NetChanMock, 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 SaveGameDiff, type ServerInfo, type ServerListFilter, type SmoothingAnalysis, type Snapshot, type SnapshotTestOptions, type StorageScenario, type SurfaceMock, type TestContext, type TraceMock, type Transform, type UserInfo, type ViewScenario, type ViewState, type VisualDiff, type VisualScenario, type WebGLPlaywrightOptions, type WebGLPlaywrightSetup, type WebGLRenderTestSetup, type WebGPUContextState, type WebGPUMocks, captureAudioEvents, captureCanvasDrawCalls, captureFramebufferAsPNG, captureGameScreenshot, captureGameState, captureTexture, captureWebGLFramebuffer, compareSaveGames, compareScreenshots, compareSnapshots, createBandwidthTestScenario, createBinaryStreamMock, createBinaryWriterMock, createBounds, createCheckerboardTexture, createCombatTestContext, createComputeTestSetup, createConfigStringArrayMock, createConfigStringMock, createControlledTimer, createCustomNetworkCondition, createCvarMock, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameImportsAndEngine, createGameStateSnapshotFactory, createHeadlessTestContext, createHeadlessWebGL, createInputInjector, createInterpolationTestData, createItemEntityFactory, createLoggingRenderer, 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, createMockDLight, createMockDLightManager, createMockDamageIndicator, createMockDamageInfo, createMockDeltaFrame, createMockDemoCameraResult, createMockDownloadManager, createMockEngine, createMockEntityState, createMockFogData, createMockFrame, createMockFrameRenderer, createMockGPUAdapter, createMockGPUBuffer, createMockGPUDevice, createMockGPUTexture, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockHudState, createMockImage, createMockImageData, createMockIndexBuffer, createMockIndexedDB, createMockInventory, createMockItem, createMockKeyboardEvent, createMockLightmap, createMockLocalStorage, createMockMasterServer, createMockMd2Model, createMockMd2Pipeline, createMockMd3Model, createMockMd3Pipeline, createMockMonsterAI, createMockMonsterMove, createMockMouseEvent, createMockNetDriver, createMockNetworkAddress, createMockNotification, createMockPannerNode, createMockParticle, createMockParticleEmitter, createMockParticleSystem, createMockPerformance, createMockPlayerState, createMockPointerLock, createMockPowerupItem, createMockPrecacheList, createMockQueue, createMockRAF, createMockRConClient, createMockRateLimiter, createMockRefDef, createMockRenderPassEncoder, createMockRenderPipeline, createMockRenderer, createMockRenderingContext, createMockSampler, createMockSaveGame, createMockScoreboard, createMockServer, createMockServerClient, createMockServerConsole, createMockServerInfo, createMockServerMessage, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockShader, createMockShaderModule, createMockShaderProgram, createMockSkyboxPipeline, createMockSnapshot, createMockSpritePipeline, createMockTexture, createMockTextureView, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockVertexBuffer, createMockViewState, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMockWebGLContextState, createMockWebGPUContext, createMockWheelEvent, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createNullRenderer, createPacketMock, createPhysicsTestContext, createPhysicsTestScenario, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createPowerArmorState, createPredictionTestScenario, createProjectileEntityFactory, createRegularArmorState, createRenderTestSetup, createSaveGameSnapshot, createServerSnapshot, createSolidTexture, createSpawnTestContext, createStorageTestScenario, createSurfaceMock, createTestContext, createTraceMock, createTransform, createTriggerEntityFactory, createVector3, createViewTestScenario, createVisualTestScenario, createWebGLPlaywrightSetup, createWebGLRenderTestSetup, expectAnimationSnapshot, expectNoDoubleTransform, expectRendererCalls, expectSnapshot, findPakFile, flipPixelsVertically, getSnapshotPath, initHeadlessWebGPU, loadMapFromPak, loadPNG, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, measureSnapshotSize, mockMonsterAttacks, parseProtocolPlayerState, randomVector3, renderAndCapture, renderAndCaptureWebGL, renderAndCaptureWebGLPlaywright, renderAndExpectSnapshot, restoreSaveGameSnapshot, runComputeAndReadback, savePNG, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateBandwidthLimit, simulateCameraMovement, simulateClientPrediction, simulateDownload, simulateFrames, simulateGravity, simulateHandshake, simulateJump, simulateMovement, simulateNetworkCondition, simulateNetworkDelay, simulatePacketLoss, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerRegistration, simulateServerTick, simulateSnapshotDelivery, spawnEntity, takeScreenshot, teardownBrowserEnvironment, teardownMockAudioContext, teardownNodeEnvironment, testComputeShader, testPipelineRendering, testWebGLAnimation, testWebGLRenderer, throttleBandwidth, verifySmoothing, verifySnapshotConsistency, waitForGameReady };
+export { type AnimationSnapshotOptions, type AnimationSnapshotResult, type AudioEvent, type BandwidthScenario, type BinaryStreamMock, type BinaryWriterMock, BrowserInputSource, type BrowserSetupOptions, type BspVec3, type CameraInput, type CaptureOptions, type ClientInfo, type ClientState, type ClientStateProvider, type ComparisonOptions, type ComparisonResult, type ComputeTestSetup, type Connection, type ConnectionState, type ConsistencyReport, type ControlledTimer, type CvarRegistry, type DeltaSnapshot, type DemoCameraResult, type DownloadManager, type DrawCall, FakeAudioContext, FakeAudioNode, FakeAudioParam, FakeBiquadFilterNode, FakeBufferSource, FakeDestination, FakeGainNode, FakePannerNode, type Frame, type GameState, type GameStateCapture, type GeometryBuffers, type Handshake, HandshakeStage, type HeadlessWebGLContext, type HeadlessWebGLOptions, type HeadlessWebGPUSetup, type HudState, InputInjector, type KeyModifiers, type LevelFrameState, type Lightmap, 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 MockImportsAndEngine, type MockMonsterAI, MockNetDriver, type MockNetDriverState, MockNetworkTransport, type MockNotification, type MockParticle, type MockParticleEmitter, MockPointerLock, type MockRAF, type MockRConClient, type MockRenderingContext, type MockSaveGame, type MockServer, type MockServerConsole, type MockServerContext, type MockServerMessage, MockTransport, type MockUDPSocket, type MockWeapon, MockWebGL2RenderingContext, type MockWebGPUContext, type MultiplayerScenario, type NetChanMock, 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 SaveGameDiff, type ServerInfo, type ServerListFilter, type SmoothingAnalysis, type Snapshot, type SnapshotTestOptions, type StorageScenario, type SurfaceMock, type TestBspMapOptions, type TestBspSurface, type TestContext, type TraceMock, type Transform, type UserInfo, type ViewScenario, type ViewState, type VisualDiff, type VisualScenario, type WebGLPlaywrightOptions, type WebGLPlaywrightSetup, type WebGLRenderTestSetup, type WebGPUContextState, type WebGPUMocks, captureAudioEvents, captureCanvasDrawCalls, captureFramebufferAsPNG, captureGameScreenshot, captureGameState, captureTexture, captureWebGLFramebuffer, compareSaveGames, compareScreenshots, compareSnapshots, createBandwidthTestScenario, createBinaryStreamMock, createBinaryWriterMock, createBounds, createCheckerboardTexture, createCombatTestContext, createComputeTestSetup, createConfigStringArrayMock, createConfigStringMock, createControlledTimer, createCustomNetworkCondition, createCvarMock, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameImportsAndEngine, createGameStateSnapshotFactory, createHeadlessTestContext, createHeadlessWebGL, createInputInjector, createInterpolationTestData, createItemEntityFactory, createLoggingRenderer, 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, createMockDLight, createMockDLightManager, createMockDamageIndicator, createMockDamageInfo, createMockDeltaFrame, createMockDemoCameraResult, createMockDownloadManager, createMockEngine, createMockEntityState, createMockFogData, createMockFrame, createMockFrameRenderer, createMockGPUAdapter, createMockGPUBuffer, createMockGPUDevice, createMockGPUTexture, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockHudState, createMockImage, createMockImageData, createMockIndexBuffer, createMockIndexedDB, createMockInventory, createMockItem, createMockKeyboardEvent, createMockLightmap, createMockLocalStorage, createMockMasterServer, createMockMd2Model, createMockMd2Pipeline, createMockMd3Model, createMockMd3Pipeline, createMockMonsterAI, createMockMonsterMove, createMockMouseEvent, createMockNetDriver, createMockNetworkAddress, createMockNotification, createMockPannerNode, createMockParticle, createMockParticleEmitter, createMockParticleSystem, createMockPerformance, createMockPlayerState, createMockPointerLock, createMockPowerupItem, createMockPrecacheList, createMockQueue, createMockRAF, createMockRConClient, createMockRateLimiter, createMockRefDef, createMockRenderPassEncoder, createMockRenderPipeline, createMockRenderer, createMockRenderingContext, createMockSampler, createMockSaveGame, createMockScoreboard, createMockServer, createMockServerClient, createMockServerConsole, createMockServerInfo, createMockServerMessage, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockShader, createMockShaderModule, createMockShaderProgram, createMockSkyboxPipeline, createMockSnapshot, createMockSpritePipeline, createMockTexture, createMockTextureView, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockVertexBuffer, createMockViewState, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMockWebGLContextState, createMockWebGPUContext, createMockWheelEvent, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createNullRenderer, createPacketMock, createPhysicsTestContext, createPhysicsTestScenario, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createPowerArmorState, createPredictionTestScenario, createProjectileEntityFactory, createRegularArmorState, createRenderTestSetup, createSaveGameSnapshot, createServerSnapshot, createSolidTexture, createSpawnTestContext, createStorageTestScenario, createSurfaceMock, createTestBspMap, createTestContext, createTestLightmap, createTraceMock, createTransform, createTriggerEntityFactory, createVector3, createViewTestScenario, createVisualTestScenario, createWebGLPlaywrightSetup, createWebGLRenderTestSetup, expectAnimationSnapshot, expectNoDoubleTransform, expectRendererCalls, expectSnapshot, findPakFile, flipPixelsVertically, getSnapshotPath, initHeadlessWebGPU, loadMapFromPak, loadPNG, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, measureSnapshotSize, mockMonsterAttacks, parseProtocolPlayerState, randomVector3, renderAndCapture, renderAndCaptureWebGL, renderAndCaptureWebGLPlaywright, renderAndExpectSnapshot, restoreSaveGameSnapshot, runComputeAndReadback, savePNG, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateBandwidthLimit, simulateCameraMovement, simulateClientPrediction, simulateDownload, simulateFrames, simulateGravity, simulateHandshake, simulateJump, simulateMovement, simulateNetworkCondition, simulateNetworkDelay, simulatePacketLoss, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerRegistration, simulateServerTick, simulateSnapshotDelivery, spawnEntity, takeScreenshot, teardownBrowserEnvironment, teardownMockAudioContext, teardownNodeEnvironment, testComputeShader, testPipelineRendering, testWebGLAnimation, testWebGLRenderer, throttleBandwidth, verifySmoothing, verifySnapshotConsistency, waitForGameReady };

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import * as vitest from 'vitest';
 import { Mock, vi } from 'vitest';
-import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, TraceResult as TraceResult$1, NetDriver, NetChan, UserCommand, ProtocolPlayerState } from '@quake2ts/shared';
+import * as SharedMath from '@quake2ts/shared';
+import { CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, Vec3 as Vec3$1, TraceResult as TraceResult$1, NetDriver, NetChan, UserCommand, ProtocolPlayerState } from '@quake2ts/shared';
 export { ZERO_VEC3, 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, BspModel, WebGLContextState, AudioNodeLike, AudioBufferSourceNodeLike, AudioBufferLike, AudioParamLike, GainNodeLike, DynamicsCompressorNodeLike, PannerNodeLike, BiquadFilterNodeLike, AudioDestinationNodeLike, AudioContextLike, Renderer, FrameRenderer, BspSurfacePipeline, Md2Pipeline, Md3Pipeline, SpriteRenderer, SkyboxPipeline, AssetManager, PreparedTexture, Md2Model, Md3Model, BspMap, BufferUsage, VertexBuffer, IndexBuffer, ShaderProgram, DLight, DynamicLightManager, ParticleSystem, NullRenderer, CoordinateSystem, LoggingRenderer, Camera, FrameRenderStats, EntityState as EntityState$1, ProtocolPlayerState as ProtocolPlayerState$1, FrameData, DamageIndicator, FogData } from '@quake2ts/engine';
+import { BspTexInfo, BspLightmapInfo, BspEntity, BspMap, ConfigStringEntry, Cvar, BspModel, WebGLContextState, AudioNodeLike, AudioBufferSourceNodeLike, AudioBufferLike, AudioParamLike, GainNodeLike, DynamicsCompressorNodeLike, PannerNodeLike, BiquadFilterNodeLike, AudioDestinationNodeLike, AudioContextLike, Renderer, FrameRenderer, BspSurfacePipeline, Md2Pipeline, Md3Pipeline, SpriteRenderer, SkyboxPipeline, AssetManager, PreparedTexture, Md2Model, Md3Model, BufferUsage, VertexBuffer, IndexBuffer, ShaderProgram, DLight, DynamicLightManager, ParticleSystem, NullRenderer, CoordinateSystem, LoggingRenderer, Camera, FrameRenderStats, EntityState as EntityState$1, ProtocolPlayerState as ProtocolPlayerState$1, FrameData, DamageIndicator, FogData } from '@quake2ts/engine';
 export { ConfigStringEntry, Cvar, DLight, DynamicLightManager, IndexBuffer, ParticleSystem, ShaderProgram, VertexBuffer } from '@quake2ts/engine';
+import { Vec3, Bounds3 } from '@quake2ts/shared/math/vec3';
+import { TraceResult, CollisionPlane as CollisionPlane$1 } from '@quake2ts/shared/bsp/collision';
 import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, GameSaveFile, LevelState, MonsterMove, DamageMod, ArmorType, RegularArmorState, PowerArmorState, PlayerInventory, BaseItem, WeaponId, WeaponItem, HealthItem, ArmorItem, AmmoItemId, PowerupItem, PlayerClient } from '@quake2ts/game';
 import { NetworkTransport, Server, ServerStatic, Client, ClientState as ClientState$1, ClientFrame } from '@quake2ts/server';
 import { ImageData, Canvas } from '@napi-rs/canvas';
@@ -174,7 +175,7 @@ declare const createPacketMock: (overrides?: Partial<PacketMock>) => PacketMock;
  * @param dist - The distance from the origin.
  * @returns A CollisionPlane object.
  */
-declare function makePlane(normal: Vec3, dist: number): CollisionPlane;
+declare function makePlane(normal: SharedMath.Vec3, dist: number): CollisionPlane;
 /**
  * Creates a simple axis-aligned cubic brush for testing.
  *
@@ -227,7 +228,37 @@ declare function makeLeafModel(brushes: CollisionBrush[]): CollisionModel;
  * @param contents - Content flags (default: CONTENTS_SOLID).
  * @returns A CollisionBrush object.
  */
-declare function makeBrushFromMinsMaxs(mins: Vec3, maxs: Vec3, contents?: number): CollisionBrush;
+declare function makeBrushFromMinsMaxs(mins: SharedMath.Vec3, maxs: SharedMath.Vec3, contents?: number): CollisionBrush;
+type BspVec3 = [number, number, number];
+interface TestBspSurface {
+    vertices: BspVec3[];
+    texInfo?: Partial<BspTexInfo>;
+    lightmap?: Uint8Array;
+    lightmapInfo?: BspLightmapInfo;
+    styles?: [number, number, number, number];
+}
+interface TestBspMapOptions {
+    surfaces?: TestBspSurface[];
+    entities?: BspEntity[];
+}
+/**
+ * Creates a minimal valid BspMap for testing rendering.
+ *
+ * @param options - Configuration for the test BSP map.
+ * @returns A BspMap object populated with the requested surfaces.
+ */
+declare function createTestBspMap(options?: TestBspMapOptions): BspMap;
+/**
+ * Creates a simple solid color lightmap of specified dimensions.
+ *
+ * @param width - Width of the lightmap (usually small, e.g. 16x16)
+ * @param height - Height of the lightmap
+ * @param r - Red component (0-255)
+ * @param g - Green component (0-255)
+ * @param b - Blue component (0-255)
+ * @returns Uint8Array containing RGB data
+ */
+declare function createTestLightmap(width: number, height: number, r: number, g: number, b: number): Uint8Array;
 
 declare function findPakFile(): string | null;
 declare function loadMapFromPak(mapName: string): ArrayBuffer | null;
@@ -240,7 +271,7 @@ declare function loadMapFromPak(mapName: string): ArrayBuffer | null;
  * @param z - The Z coordinate (default: 0).
  * @returns A Vec3 object.
  */
-declare const createVector3: (x?: number, y?: number, z?: number) => Vec3$1;
+declare const createVector3: (x?: number, y?: number, z?: number) => Vec3;
 /**
  * Creates a bounds object (min/max vectors).
  *
@@ -248,14 +279,14 @@ declare const createVector3: (x?: number, y?: number, z?: number) => Vec3$1;
  * @param maxs - The maximum bounds vector (default: 1,1,1).
  * @returns A Bounds3 object.
  */
-declare const createBounds: (mins?: Vec3$1, maxs?: Vec3$1) => Bounds3;
+declare const createBounds: (mins?: Vec3, maxs?: Vec3) => Bounds3;
 /**
  * Interface representing a transformation (position, rotation, scale).
  */
 interface Transform {
-    position: Vec3$1;
-    rotation: Vec3$1;
-    scale: Vec3$1;
+    position: Vec3;
+    rotation: Vec3;
+    scale: Vec3;
 }
 /**
  * Creates a Transform object.
@@ -271,14 +302,14 @@ declare const createTransform: (overrides?: Partial<Transform>) => Transform;
  * @param max - Maximum value for each component (default: 100).
  * @returns A random Vec3 object.
  */
-declare const randomVector3: (min?: number, max?: number) => Vec3$1;
+declare const randomVector3: (min?: number, max?: number) => Vec3;
 
 /**
  * Interface for a TraceResult mock, including all standard properties.
  */
 interface TraceMock extends Partial<TraceResult> {
     fraction: number;
-    endpos: Vec3$1;
+    endpos: Vec3;
     plane: CollisionPlane$1;
     surface: {
         flags: number;
@@ -474,7 +505,7 @@ declare function createPhysicsTestScenario(scenarioType: 'stairs' | 'ladder' | '
  * Uses the game's runPmove logic or manually invokes similar steps.
  * This is useful for testing specific movement mechanics in isolation.
  */
-declare function simulateMovement(entity: Entity, destination: Vec3, context: TestContext): TraceResult$1;
+declare function simulateMovement(entity: Entity, destination: Vec3$1, context: TestContext): TraceResult$1;
 /**
  * Simulates gravity application on an entity.
  */
@@ -1586,7 +1617,7 @@ interface Lightmap {
 /**
  * Creates a mock DLight with default values.
  */
-declare function createMockDLight(position?: Vec3, color?: Vec3, intensity?: number): DLight;
+declare function createMockDLight(position?: Vec3$1, color?: Vec3$1, intensity?: number): DLight;
 /**
  * Creates a mock DynamicLightManager with spy methods.
  */
@@ -1597,8 +1628,8 @@ declare function createMockDLightManager(overrides?: Partial<DynamicLightManager
 declare function createMockLightmap(width?: number, height?: number): Lightmap;
 
 interface MockParticle {
-    position: Vec3;
-    velocity: Vec3;
+    position: Vec3$1;
+    velocity: Vec3$1;
     color: [number, number, number, number];
     size: number;
     lifetime: number;
@@ -2047,8 +2078,8 @@ interface CameraInput {
     rollDelta?: number;
 }
 interface DemoCameraResult {
-    origin: Vec3;
-    angles: Vec3;
+    origin: Vec3$1;
+    angles: Vec3$1;
     fov: number;
 }
 /**
@@ -2140,8 +2171,8 @@ declare function simulatePacketLoss<T>(messages: T[], lossPercent: number): T[];
 /**
  * Factory for creating a mock EntityState.
  */
-declare function createMockEntityState(number: number, modelIndex?: number, origin?: Partial<Vec3>, overrides?: Partial<EntityState$1>): EntityState$1;
-declare function createMockDamageIndicator(damage: number, dir?: Vec3, health?: boolean, armor?: boolean, power?: boolean): DamageIndicator;
+declare function createMockEntityState(number: number, modelIndex?: number, origin?: Partial<Vec3$1>, overrides?: Partial<EntityState$1>): EntityState$1;
+declare function createMockDamageIndicator(damage: number, dir?: Vec3$1, health?: boolean, armor?: boolean, power?: boolean): DamageIndicator;
 declare function createMockFogData(overrides?: Partial<FogData>): FogData;
 
 interface DownloadManager {
@@ -2326,4 +2357,4 @@ declare function compareScreenshots(baseline: Buffer, current: Buffer, threshold
  */
 declare function createVisualTestScenario(sceneName: string): VisualScenario;
 
-export { type AnimationSnapshotOptions, type AnimationSnapshotResult, type AudioEvent, type BandwidthScenario, type BinaryStreamMock, type BinaryWriterMock, BrowserInputSource, type BrowserSetupOptions, type CameraInput, type CaptureOptions, type ClientInfo, type ClientState, type ClientStateProvider, type ComparisonOptions, type ComparisonResult, type ComputeTestSetup, type Connection, type ConnectionState, type ConsistencyReport, type ControlledTimer, type CvarRegistry, type DeltaSnapshot, type DemoCameraResult, type DownloadManager, type DrawCall, FakeAudioContext, FakeAudioNode, FakeAudioParam, FakeBiquadFilterNode, FakeBufferSource, FakeDestination, FakeGainNode, FakePannerNode, type Frame, type GameState, type GameStateCapture, type GeometryBuffers, type Handshake, HandshakeStage, type HeadlessWebGLContext, type HeadlessWebGLOptions, type HeadlessWebGPUSetup, type HudState, InputInjector, type KeyModifiers, type LevelFrameState, type Lightmap, 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 MockImportsAndEngine, type MockMonsterAI, MockNetDriver, type MockNetDriverState, MockNetworkTransport, type MockNotification, type MockParticle, type MockParticleEmitter, MockPointerLock, type MockRAF, type MockRConClient, type MockRenderingContext, type MockSaveGame, type MockServer, type MockServerConsole, type MockServerContext, type MockServerMessage, MockTransport, type MockUDPSocket, type MockWeapon, MockWebGL2RenderingContext, type MockWebGPUContext, type MultiplayerScenario, type NetChanMock, 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 SaveGameDiff, type ServerInfo, type ServerListFilter, type SmoothingAnalysis, type Snapshot, type SnapshotTestOptions, type StorageScenario, type SurfaceMock, type TestContext, type TraceMock, type Transform, type UserInfo, type ViewScenario, type ViewState, type VisualDiff, type VisualScenario, type WebGLPlaywrightOptions, type WebGLPlaywrightSetup, type WebGLRenderTestSetup, type WebGPUContextState, type WebGPUMocks, captureAudioEvents, captureCanvasDrawCalls, captureFramebufferAsPNG, captureGameScreenshot, captureGameState, captureTexture, captureWebGLFramebuffer, compareSaveGames, compareScreenshots, compareSnapshots, createBandwidthTestScenario, createBinaryStreamMock, createBinaryWriterMock, createBounds, createCheckerboardTexture, createCombatTestContext, createComputeTestSetup, createConfigStringArrayMock, createConfigStringMock, createControlledTimer, createCustomNetworkCondition, createCvarMock, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameImportsAndEngine, createGameStateSnapshotFactory, createHeadlessTestContext, createHeadlessWebGL, createInputInjector, createInterpolationTestData, createItemEntityFactory, createLoggingRenderer, 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, createMockDLight, createMockDLightManager, createMockDamageIndicator, createMockDamageInfo, createMockDeltaFrame, createMockDemoCameraResult, createMockDownloadManager, createMockEngine, createMockEntityState, createMockFogData, createMockFrame, createMockFrameRenderer, createMockGPUAdapter, createMockGPUBuffer, createMockGPUDevice, createMockGPUTexture, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockHudState, createMockImage, createMockImageData, createMockIndexBuffer, createMockIndexedDB, createMockInventory, createMockItem, createMockKeyboardEvent, createMockLightmap, createMockLocalStorage, createMockMasterServer, createMockMd2Model, createMockMd2Pipeline, createMockMd3Model, createMockMd3Pipeline, createMockMonsterAI, createMockMonsterMove, createMockMouseEvent, createMockNetDriver, createMockNetworkAddress, createMockNotification, createMockPannerNode, createMockParticle, createMockParticleEmitter, createMockParticleSystem, createMockPerformance, createMockPlayerState, createMockPointerLock, createMockPowerupItem, createMockPrecacheList, createMockQueue, createMockRAF, createMockRConClient, createMockRateLimiter, createMockRefDef, createMockRenderPassEncoder, createMockRenderPipeline, createMockRenderer, createMockRenderingContext, createMockSampler, createMockSaveGame, createMockScoreboard, createMockServer, createMockServerClient, createMockServerConsole, createMockServerInfo, createMockServerMessage, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockShader, createMockShaderModule, createMockShaderProgram, createMockSkyboxPipeline, createMockSnapshot, createMockSpritePipeline, createMockTexture, createMockTextureView, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockVertexBuffer, createMockViewState, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMockWebGLContextState, createMockWebGPUContext, createMockWheelEvent, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createNullRenderer, createPacketMock, createPhysicsTestContext, createPhysicsTestScenario, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createPowerArmorState, createPredictionTestScenario, createProjectileEntityFactory, createRegularArmorState, createRenderTestSetup, createSaveGameSnapshot, createServerSnapshot, createSolidTexture, createSpawnTestContext, createStorageTestScenario, createSurfaceMock, createTestContext, createTraceMock, createTransform, createTriggerEntityFactory, createVector3, createViewTestScenario, createVisualTestScenario, createWebGLPlaywrightSetup, createWebGLRenderTestSetup, expectAnimationSnapshot, expectNoDoubleTransform, expectRendererCalls, expectSnapshot, findPakFile, flipPixelsVertically, getSnapshotPath, initHeadlessWebGPU, loadMapFromPak, loadPNG, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, measureSnapshotSize, mockMonsterAttacks, parseProtocolPlayerState, randomVector3, renderAndCapture, renderAndCaptureWebGL, renderAndCaptureWebGLPlaywright, renderAndExpectSnapshot, restoreSaveGameSnapshot, runComputeAndReadback, savePNG, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateBandwidthLimit, simulateCameraMovement, simulateClientPrediction, simulateDownload, simulateFrames, simulateGravity, simulateHandshake, simulateJump, simulateMovement, simulateNetworkCondition, simulateNetworkDelay, simulatePacketLoss, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerRegistration, simulateServerTick, simulateSnapshotDelivery, spawnEntity, takeScreenshot, teardownBrowserEnvironment, teardownMockAudioContext, teardownNodeEnvironment, testComputeShader, testPipelineRendering, testWebGLAnimation, testWebGLRenderer, throttleBandwidth, verifySmoothing, verifySnapshotConsistency, waitForGameReady };
+export { type AnimationSnapshotOptions, type AnimationSnapshotResult, type AudioEvent, type BandwidthScenario, type BinaryStreamMock, type BinaryWriterMock, BrowserInputSource, type BrowserSetupOptions, type BspVec3, type CameraInput, type CaptureOptions, type ClientInfo, type ClientState, type ClientStateProvider, type ComparisonOptions, type ComparisonResult, type ComputeTestSetup, type Connection, type ConnectionState, type ConsistencyReport, type ControlledTimer, type CvarRegistry, type DeltaSnapshot, type DemoCameraResult, type DownloadManager, type DrawCall, FakeAudioContext, FakeAudioNode, FakeAudioParam, FakeBiquadFilterNode, FakeBufferSource, FakeDestination, FakeGainNode, FakePannerNode, type Frame, type GameState, type GameStateCapture, type GeometryBuffers, type Handshake, HandshakeStage, type HeadlessWebGLContext, type HeadlessWebGLOptions, type HeadlessWebGPUSetup, type HudState, InputInjector, type KeyModifiers, type LevelFrameState, type Lightmap, 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 MockImportsAndEngine, type MockMonsterAI, MockNetDriver, type MockNetDriverState, MockNetworkTransport, type MockNotification, type MockParticle, type MockParticleEmitter, MockPointerLock, type MockRAF, type MockRConClient, type MockRenderingContext, type MockSaveGame, type MockServer, type MockServerConsole, type MockServerContext, type MockServerMessage, MockTransport, type MockUDPSocket, type MockWeapon, MockWebGL2RenderingContext, type MockWebGPUContext, type MultiplayerScenario, type NetChanMock, 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 SaveGameDiff, type ServerInfo, type ServerListFilter, type SmoothingAnalysis, type Snapshot, type SnapshotTestOptions, type StorageScenario, type SurfaceMock, type TestBspMapOptions, type TestBspSurface, type TestContext, type TraceMock, type Transform, type UserInfo, type ViewScenario, type ViewState, type VisualDiff, type VisualScenario, type WebGLPlaywrightOptions, type WebGLPlaywrightSetup, type WebGLRenderTestSetup, type WebGPUContextState, type WebGPUMocks, captureAudioEvents, captureCanvasDrawCalls, captureFramebufferAsPNG, captureGameScreenshot, captureGameState, captureTexture, captureWebGLFramebuffer, compareSaveGames, compareScreenshots, compareSnapshots, createBandwidthTestScenario, createBinaryStreamMock, createBinaryWriterMock, createBounds, createCheckerboardTexture, createCombatTestContext, createComputeTestSetup, createConfigStringArrayMock, createConfigStringMock, createControlledTimer, createCustomNetworkCondition, createCvarMock, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameImportsAndEngine, createGameStateSnapshotFactory, createHeadlessTestContext, createHeadlessWebGL, createInputInjector, createInterpolationTestData, createItemEntityFactory, createLoggingRenderer, 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, createMockDLight, createMockDLightManager, createMockDamageIndicator, createMockDamageInfo, createMockDeltaFrame, createMockDemoCameraResult, createMockDownloadManager, createMockEngine, createMockEntityState, createMockFogData, createMockFrame, createMockFrameRenderer, createMockGPUAdapter, createMockGPUBuffer, createMockGPUDevice, createMockGPUTexture, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockHudState, createMockImage, createMockImageData, createMockIndexBuffer, createMockIndexedDB, createMockInventory, createMockItem, createMockKeyboardEvent, createMockLightmap, createMockLocalStorage, createMockMasterServer, createMockMd2Model, createMockMd2Pipeline, createMockMd3Model, createMockMd3Pipeline, createMockMonsterAI, createMockMonsterMove, createMockMouseEvent, createMockNetDriver, createMockNetworkAddress, createMockNotification, createMockPannerNode, createMockParticle, createMockParticleEmitter, createMockParticleSystem, createMockPerformance, createMockPlayerState, createMockPointerLock, createMockPowerupItem, createMockPrecacheList, createMockQueue, createMockRAF, createMockRConClient, createMockRateLimiter, createMockRefDef, createMockRenderPassEncoder, createMockRenderPipeline, createMockRenderer, createMockRenderingContext, createMockSampler, createMockSaveGame, createMockScoreboard, createMockServer, createMockServerClient, createMockServerConsole, createMockServerInfo, createMockServerMessage, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockShader, createMockShaderModule, createMockShaderProgram, createMockSkyboxPipeline, createMockSnapshot, createMockSpritePipeline, createMockTexture, createMockTextureView, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockVertexBuffer, createMockViewState, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMockWebGLContextState, createMockWebGPUContext, createMockWheelEvent, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createNullRenderer, createPacketMock, createPhysicsTestContext, createPhysicsTestScenario, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createPowerArmorState, createPredictionTestScenario, createProjectileEntityFactory, createRegularArmorState, createRenderTestSetup, createSaveGameSnapshot, createServerSnapshot, createSolidTexture, createSpawnTestContext, createStorageTestScenario, createSurfaceMock, createTestBspMap, createTestContext, createTestLightmap, createTraceMock, createTransform, createTriggerEntityFactory, createVector3, createViewTestScenario, createVisualTestScenario, createWebGLPlaywrightSetup, createWebGLRenderTestSetup, expectAnimationSnapshot, expectNoDoubleTransform, expectRendererCalls, expectSnapshot, findPakFile, flipPixelsVertically, getSnapshotPath, initHeadlessWebGPU, loadMapFromPak, loadPNG, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, measureSnapshotSize, mockMonsterAttacks, parseProtocolPlayerState, randomVector3, renderAndCapture, renderAndCaptureWebGL, renderAndCaptureWebGLPlaywright, renderAndExpectSnapshot, restoreSaveGameSnapshot, runComputeAndReadback, savePNG, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateBandwidthLimit, simulateCameraMovement, simulateClientPrediction, simulateDownload, simulateFrames, simulateGravity, simulateHandshake, simulateJump, simulateMovement, simulateNetworkCondition, simulateNetworkDelay, simulatePacketLoss, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerRegistration, simulateServerTick, simulateSnapshotDelivery, spawnEntity, takeScreenshot, teardownBrowserEnvironment, teardownMockAudioContext, teardownNodeEnvironment, testComputeShader, testPipelineRendering, testWebGLAnimation, testWebGLRenderer, throttleBandwidth, verifySmoothing, verifySnapshotConsistency, waitForGameReady };

package/dist/index.js

@@ -203,6 +203,140 @@ function makeBrushFromMinsMaxs(mins, maxs, contents = CONTENTS_SOLID) {
     sides: planes.map((plane) => ({ plane, surfaceFlags: 0 }))
   };
 }
+function createTestBspMap(options = {}) {
+  const vertices = [];
+  const edges = [];
+  const surfEdges = [];
+  const faces = [];
+  const texInfos = [];
+  const lightMapInfo = [];
+  let lightMapDataSize = 0;
+  if (options.surfaces) {
+    for (const surface of options.surfaces) {
+      if (surface.lightmap) {
+        lightMapDataSize += surface.lightmap.length;
+      }
+    }
+  }
+  const lightMaps = new Uint8Array(lightMapDataSize);
+  let currentLightMapOffset = 0;
+  if (options.surfaces) {
+    for (const surface of options.surfaces) {
+      const firstEdge = surfEdges.length;
+      const startVertexIndex = vertices.length;
+      for (const v of surface.vertices) {
+        vertices.push(v);
+      }
+      for (let i = 0; i < surface.vertices.length; i++) {
+        const v1 = startVertexIndex + i;
+        const v2 = startVertexIndex + (i + 1) % surface.vertices.length;
+        edges.push({ vertices: [v1, v2] });
+        surfEdges.push(edges.length - 1);
+      }
+      const defaultTexInfo = {
+        s: [1, 0, 0],
+        sOffset: 0,
+        t: [0, 1, 0],
+        tOffset: 0,
+        flags: 0,
+        value: 0,
+        texture: "test_texture",
+        nextTexInfo: -1
+      };
+      const texInfo = { ...defaultTexInfo, ...surface.texInfo };
+      texInfos.push(texInfo);
+      let lightOffset = -1;
+      let info = void 0;
+      if (surface.lightmap) {
+        lightOffset = currentLightMapOffset;
+        lightMaps.set(surface.lightmap, lightOffset);
+        info = { offset: lightOffset, length: surface.lightmap.length };
+        currentLightMapOffset += surface.lightmap.length;
+      }
+      lightMapInfo.push(info);
+      faces.push({
+        planeIndex: 0,
+        // Dummy plane
+        side: 0,
+        firstEdge,
+        numEdges: surface.vertices.length,
+        texInfo: texInfos.length - 1,
+        styles: surface.styles ?? [255, 255, 255, 255],
+        // Default styles
+        lightOffset
+      });
+    }
+  }
+  const header = { version: 38, lumps: /* @__PURE__ */ new Map() };
+  const entities = {
+    raw: "",
+    entities: options.entities || [],
+    worldspawn: void 0,
+    getUniqueClassnames: () => []
+  };
+  const planes = [{ normal: [0, 0, 1], dist: 0, type: 0 }];
+  const nodes = [];
+  const leafs = [{
+    contents: 0,
+    cluster: 0,
+    area: 0,
+    mins: [-1e3, -1e3, -1e3],
+    maxs: [1e3, 1e3, 1e3],
+    firstLeafFace: 0,
+    numLeafFaces: faces.length,
+    firstLeafBrush: 0,
+    numLeafBrushes: 0
+  }];
+  const leafLists = {
+    leafFaces: [faces.map((_, i) => i)],
+    leafBrushes: [[]]
+  };
+  const models = [{
+    mins: [-1e3, -1e3, -1e3],
+    maxs: [1e3, 1e3, 1e3],
+    origin: [0, 0, 0],
+    headNode: 0,
+    firstFace: 0,
+    numFaces: faces.length
+  }];
+  const data = {
+    header,
+    entities,
+    planes,
+    vertices,
+    nodes,
+    texInfo: texInfos,
+    faces,
+    lightMaps,
+    lightMapInfo,
+    leafs,
+    leafLists,
+    edges,
+    surfEdges: Int32Array.from(surfEdges),
+    models,
+    brushes: [],
+    brushSides: [],
+    visibility: void 0,
+    areas: [],
+    areaPortals: []
+  };
+  return {
+    ...data,
+    pickEntity: () => null,
+    findLeaf: () => leafs[0],
+    calculatePVS: () => void 0
+  };
+}
+function createTestLightmap(width, height, r, g, b) {
+  const size = width * height * 3;
+  const data = new Uint8Array(size);
+  for (let i = 0; i < size; i += 3) {
+    data[i] = r;
+    data[i + 1] = g;
+    data[i + 2] = b;
+  }
+  return data;
+}
 
 // src/shared/pak-loader.ts
 import * as fs from "fs";
@@ -3326,6 +3460,7 @@ function createMockRenderer(overrides) {
     setLodBias: vi12.fn(),
     setAreaPortalState: vi12.fn(),
     renderInstanced: vi12.fn(),
+    uploadBspGeometry: vi12.fn().mockReturnValue({ surfaces: [], lightmaps: [] }),
     dispose: vi12.fn(),
     ...overrides
   };
@@ -5575,7 +5710,9 @@ export {
   createSpawnTestContext,
   createStorageTestScenario,
   createSurfaceMock,
+  createTestBspMap,
   createTestContext,
+  createTestLightmap,
   createTraceMock,
   createTransform,
   createTriggerEntityFactory,