class: SpecterLocator

const activeEnemies = world.actorByTag('Enemy').filter({ hasProperty: { 'IsAlive': true } });

const healthPotionSlot = world.widget('InventorySlot').and(world.widgetByText('Health Potion'));

const anyMinion = world.actor('BP_Minion_Melee').or(world.actor('BP_Minion_Range'));

const minions = await world.actor('BP_Minion').all();
for (const minion of minions) {
  await expect(minion).toBeVisible();
}

const firstMinion = world.actor('BP_Minion').first();

const lastMinion = world.actor('BP_Minion').last();

const thirdMinion = world.actor('BP_Minion').nth(2);

const numMinions = await world.actor('BP_Minion').count();
console.log(numMinions);

// Resolve only when damage is greater than 50
await bossActor.waitForEvent('OnTakeAnyDamage', (data) => data.damage > 50);

// You can add full IntelliSense for custom events via module augmentation!
// In your test or setup file:
declare module '@specter-automation/test' {
    interface CustomActorEvents {
        OnShieldBroken: { currentShield: number; maxShield: number };
    }
}
const shieldInfo = await playerActor.waitForEvent('OnShieldBroken');
console.log(shieldInfo.maxShield); // Fully typed number

await world.widget('VictoryScreen').waitForExist();

const player2Boss = bossLocator.client(world2);
await expect(player2Boss).toBeVisible();

// 1. Get a returned struct
const location = await player.callFunction("K2_GetActorLocation");

// 2. Pass in structs and parameters
await player.callFunction("K2_SetActorLocation", {
    NewLocation: { X: 0, Y: 0, Z: 1000 },
    bSweep: false,
    bTeleport: true,
    SweepHitResult: {}
});

// 3. Read an object reference and chain a new locator
const weaponName = await player.callFunction("GetEquippedWeapon");
const weapon = world.actor(weaponName);
await weapon.callFunction("Fire");

const health = await player.getPropertyValue("CurrentHealth");

const gameState = world.actor('GameStateBase');
const matchStateVar = await gameState.trackProperty('MatchState');

// Now wait for the transition event using the returned stable variable name:
await world.waitForVariable(matchStateVar, 'InProgress');

const player = world.actor('BP_PlayerCharacter');
const healthVar = await player.trackAttribute('AttributeSet_Player', 'Health');

// Wait for health to drop below or transition to 0:
await world.waitForVariable(healthVar, '0');

const opacity = await ui.locator('FadeOverlay').getMaterialScalarParameter('Opacity');

const color = await shield.getMaterialVectorParameter('GlowColor');
console.log(color.hex);

const tex = await portrait.getMaterialTextureParameter('Icon');

const matName = await terrain.getMaterialName();

const isDynamic = await healthBar.isDynamicMaterial();