@quake2ts/test-utils 0.0.740 → 0.0.741

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quake2ts/test-utils",
-  "version": "0.0.740",
+  "version": "0.0.741",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -39,10 +39,10 @@
     "pngjs": "^7.0.0",
     "vitest": "^1.6.0",
     "webgpu": "^0.3.8",
-    "@quake2ts/engine": "^0.0.740",
-    "@quake2ts/game": "0.0.740",
-    "@quake2ts/server": "0.0.740",
-    "@quake2ts/shared": "0.0.740"
+    "@quake2ts/engine": "^0.0.741",
+    "@quake2ts/server": "0.0.741",
+    "@quake2ts/shared": "0.0.741",
+    "@quake2ts/game": "0.0.741"
   },
   "peerDependenciesMeta": {
     "@quake2ts/engine": {
@@ -92,10 +92,10 @@
     "typescript": "^5.4.5",
     "vitest": "^1.6.0",
     "webgpu": "^0.3.8",
-    "@quake2ts/engine": "^0.0.740",
-    "@quake2ts/game": "0.0.740",
-    "@quake2ts/server": "0.0.740",
-    "@quake2ts/shared": "0.0.740"
+    "@quake2ts/engine": "^0.0.741",
+    "@quake2ts/game": "0.0.741",
+    "@quake2ts/shared": "0.0.741",
+    "@quake2ts/server": "0.0.741"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",

package/src/game/helpers.ts

@@ -180,16 +180,16 @@ export function createTestContext(options?: { seed?: number, initialEntities?: E
       frameNumber: 1,
       sightEntity: null,
       soundEntity: null,
+      activePlayers: [],
+      monsterAlertedByPlayers: vi.fn().mockReturnValue(null),
+      soundClient: vi.fn().mockReturnValue(null),
     },
-    warn: vi.fn(), // Added warn to entities as it is sometimes used there too, though typically on SpawnContext
-    // Adding missing properties to satisfy EntitySystem interface partially or fully
-    // We cast to unknown first anyway, but filling these in makes it safer for consumers
+    warn: vi.fn(),
     skill: 1,
     deathmatch: false,
     coop: false,
     activeCount: entityList.length,
     world: entityList.find(e => e.classname === 'worldspawn') || new Entity(0),
-    // ... other EntitySystem properties would go here
   } as unknown as EntitySystem;
 
   return {
@@ -200,7 +200,6 @@ export function createTestContext(options?: { seed?: number, initialEntities?: E
     health_multiplier: 1,
     warn: vi.fn(),
     free: vi.fn(),
-    // Mock precache functions if they are part of SpawnContext in future or TestContext extensions
     precacheModel: vi.fn(),
     precacheSound: vi.fn(),
     precacheImage: vi.fn(),
@@ -209,7 +208,6 @@ export function createTestContext(options?: { seed?: number, initialEntities?: E
 
 export function createSpawnTestContext(mapName?: string): TestContext {
   const ctx = createTestContext();
-  // Simulate map load if needed
   if (mapName) {
     ctx.game.spawnWorld();
   }
@@ -222,7 +220,6 @@ export function createCombatTestContext(): TestContext {
 
 export function createPhysicsTestContext(bspModel?: BspModel): TestContext {
   const context = createTestContext();
-
   if (bspModel) {
     // If a BSP model is provided, we can set up the trace mock to be more realistic.
     // For now, we'll just store the model on the context if we extended TestContext,
@@ -231,7 +228,6 @@ export function createPhysicsTestContext(bspModel?: BspModel): TestContext {
     // In a real scenario, we might want to hook up a real BSP physics engine mock here
     // or a mock that uses the BSP data.
   }
-
   return context;
 }
 
@@ -239,6 +235,21 @@ export function createEntity(): Entity {
   return new Entity(1);
 }
 
+/**
+ * Spawns an entity into the system and applies the properties from the provided data object.
+ * This is useful for testing when you want to spawn an entity with specific properties
+ * generated by a factory.
+ *
+ * @param system - The EntitySystem to spawn into.
+ * @param data - The partial entity data to apply (e.g. from createPlayerEntityFactory).
+ * @returns The spawned and populated Entity.
+ */
+export function spawnEntity(system: EntitySystem, data: Partial<Entity>): Entity {
+  const ent = system.spawn();
+  Object.assign(ent, data);
+  return ent;
+}
+
 /**
  * Creates mock imports and engine for use with createGame() from @quake2ts/game.
  * This is a convenience helper that provides all the commonly mocked functions
@@ -272,7 +283,6 @@ export function createGameImportsAndEngine(overrides?: {
     soundIndex: Mock;
   }>;
 }) {
-  // Default trace result - matches the pattern from original monster tests
   const defaultTraceResult = {
     fraction: 1.0,
     endpos: { x: 0, y: 0, z: 0 },

package/src/shared/math.ts

@@ -63,3 +63,5 @@ export const randomVector3 = (min: number = -100, max: number = 100): Vec3 => ({
     y: Math.random() * (max - min) + min,
     z: Math.random() * (max - min) + min,
 });
+
+export { ZERO_VEC3 } from '@quake2ts/shared';