class: SpecterWorld

const world = await SpecterWorld.connect();

await world.joinHost("192.168.1.100", "Arena_P");

await world.close();

await world.cleanup();

await world.loadMap("/Game/Maps/Arena", { listen: true });

await world.waitForMapLoad("Arena");

console.log(world.currentMap);

const status = await world.getNetworkStatus();

const boss = await world.spawnActor('/Game/Blueprints/Enemies/BP_Boss');

await world.evaluate("TakeScreenshot", { fileName: "menu" });

await world.console("cheat god");

await world.setTimeScale(2.0);

await world.setTimeDilation(0.5);

const path = await world.takeScreenshot("inventory_open", true);

await world.waitForVariable("GameState.Phase", "Combat");

// Custom timeout & predicate options
await world.waitForEvent('playerJoined', {
    timeout: 10000,
    predicate: (data) => data.playerName === 'Player_1'
});

// Option 1: Press and hold the key for 2000ms (2 seconds) before releasing
await world.keyboard.press('E', 2000);

// Option 2: Manually hold the key down indefinitely (e.g., walking forward)
await world.keyboard.down('W');
await world.waitForEvent('SomeEvent'); // Wait for something to happen while walking
await world.keyboard.up('W'); // Release it

await world.keyboard.up('W');

// Push the left thumbstick 50% forward for one frame
await world.injectAxis('Gamepad_LeftY', 0.5);

import { SpecterInputSequence } from '@specter/test';

const spinAttack = new SpecterInputSequence()
    .addAxisCircle('Gamepad_LeftX', 'Gamepad_LeftY', 0, 1500, 2);

await world.playSequence(spinAttack);

// By Class Name (Default)
const player = world.actor("BP_Hero");

// By Gameplay Tag Prefix Selector (Playwright-style)
const boss = world.actor("Tag:Enemy.Boss");
const bossAlt = world.actor("tag=Enemy.Boss");

const enemy = world.actorByTag("Enemy.Boss");

const inventory = world.widget("WBP_Inventory");

const p1 = world.getByPlayerId(0);

const audio = world.subsystem("AudioSubsystem");

const saveGame = world.uobject("MySaveGame");

const metrics = await world.getPerformanceMetrics();
console.log(`FPS: ${metrics.fps}`);
console.log(`Frame Time: ${metrics.frameTimeMs}ms`);
console.log(`Memory: ${metrics.memoryMb}MB`);

// Assert minimum performance threshold
expect(metrics.fps).toBeGreaterThan(30);

const reachable = await world.isPointReachable(
  { x: 100, y: 200, z: 0 },
  { x: 500, y: 600, z: 0 }
);
expect(reachable).toBe(true);

const playing = await world.isSequencePlaying('IntroSequence');

const pos = await world.getSequencePlaybackPosition('IntroSequence');
console.log(`Cutscene is at ${pos}s`);

// Jump to the 5-second mark of the intro cutscene
await world.scrubSequence('IntroSequence', 5.0);

// Verify the cutscene spawned a specific actor at that moment
await expect(world.actor('BP_CutsceneBoss')).toBeVisible();

await client1.network.setEmulatedLatency(150);

await client1.network.setPacketLoss(5);

await client1.network.resetNetworkEmulation();