@adatechnology/game-test-room 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import * as THREE_NS from 'three';
+import { AudioEngine } from '@adatechnology/game-audio';
 import { DestructibleSpec, Vec3, DestructionWorld, DestructionOptions, DestructionEvent, MaterialDef } from '@adatechnology/game-destruction';
 export { DestructionEvent, Vec3 } from '@adatechnology/game-destruction';
 import { SpecFromObjectOptions, DestructionRenderer, Quality } from '@adatechnology/game-destruction-three';
 import { Arsenal, WeaponState, WeaponDef } from '@adatechnology/game-weapons';
 import { FluidRenderer } from '@adatechnology/game-fluids-three';
 import { ContainerSpec, FluidWorld, LiquidDef, ItemUseDef, SurfaceSpec } from '@adatechnology/game-fluids';
-import { ModuleControl, ControlValue, ModuleLayer, DestructibleImpl, AnimationClipSpec, TestableModule } from '@adatechnology/game-contracts';
+import { ModuleControl, ControlValue, ModuleLayer, DestructibleImpl, AnimationClipSpec, EnvironmentBus, TestableModule } from '@adatechnology/game-contracts';
 export { AnimationClipSpec, DestructibleImpl, ItemAnimationContract, ModuleScenario, TestableItem, TestableModule } from '@adatechnology/game-contracts';
 
 type NewEntry = NewLogEntry;
@@ -194,6 +195,13 @@ interface TestRoomOptions {
     /** Called for every destruction event (to log, play sounds, sync over LAN). Fluid events reach the log too. */
     onEvent?: (event: DestructionEvent) => void;
     onSound?: (key: string, point: Vec3, volume: number) => void;
+    /**
+     * The sound engine of the room (@adatechnology/game-audio): the destruction renderer's sound keys play on it, and modules get it as `host.audio`.
+     * Default: a new engine of the room's own (it makes no AudioContext until the first sound); `false` for a silent room.
+     */
+    audio?: AudioEngine | false;
+    /** The environment store modules get as `host.environment` (the weather module writes it, the others read it). Default: a new one with a calm dry day. */
+    environment?: EnvironmentBus;
     /** Show the built-in HUD and panels (default true). */
     ui?: boolean;
     /** Room counters the bench panel shows and `TestRoom.metrics()` returns (default all); `false` for none. */
@@ -238,6 +246,10 @@ interface SpawnedObject {
     movable: boolean;
 }
 interface TestRoom {
+    /** The room's sound engine, or `null` in a silent room. */
+    readonly audio: AudioEngine | null;
+    /** The environment store lent to modules as `host.environment`. */
+    readonly environment: EnvironmentBus;
     readonly world: DestructionWorld;
     readonly renderer: DestructionRenderer;
     readonly scene: THREE_NS.Scene;