pokemon-showdown/dev-tools/globals.ts

type Battle = import('./../sim/battle').Battle
type Field = import('./../sim/field').Field
type ModdedDex = typeof import('./../sim/dex')
type Pokemon = import('./../sim/pokemon').Pokemon
type Side = import('./../sim/side').Side
type Validator = import('./../sim/team-validator').Validator

type PageTable = import('./../server/chat').PageTable
type ChatCommands = import('./../server/chat').ChatCommands
type ChatFilter = import('./../server/chat').ChatFilter
type NameFilter = import('./../server/chat').NameFilter

interface AnyObject {[k: string]: any}
type DexTable<T> = {[key: string]: T}

declare let Config: {[k: string]: any};

declare let Monitor: typeof import("../server/monitor");

declare let LoginServer: typeof import('../server/loginserver');

// type RoomBattle = AnyObject;

declare let Verifier: typeof import('../server/verifier');
declare let Dnsbl: typeof import('../server/dnsbl');
declare let Sockets: typeof import('../server/sockets');
// let TeamValidator: typeof import('../sim/team-validator');
declare let TeamValidatorAsync: typeof import('../server/team-validator-async');

type GenderName = 'M' | 'F' | 'N' | '';
type StatNameExceptHP = 'atk' | 'def' | 'spa' | 'spd' | 'spe';
type StatName = 'hp' | StatNameExceptHP;
type StatsExceptHPTable = {[stat in StatNameExceptHP]: number};
type StatsTable = {[stat in StatName]: number };
type SparseStatsTable = Partial<StatsTable>;
type BoostName = StatNameExceptHP | 'accuracy' | 'evasion';
type BoostsTable = {[boost in BoostName]: number };
type SparseBoostsTable = Partial<BoostsTable>;
type Nonstandard = 'Glitch' | 'Past' | 'Future' | 'CAP' | 'LGPE' | 'Pokestar' | 'Custom';
type PokemonSet = {
	name: string,
	species: string,
	item: string,
	ability: string,
	moves: string[],
	nature: string,
	gender: string,
	evs: StatsTable,
	ivs: StatsTable,
	level: number,
	shiny?: boolean,
	happiness?: number,
	pokeball?: string,
	hpType?: string,
};

/**
 * Describes a possible way to get a move onto a pokemon.
 *
 * First character is a generation number, 1-7.
 * Second character is a source ID, one of:
 *
 * - L = start or level-up, 3rd char+ is the level
 * - M = TM/HM
 * - T = tutor
 * - E = egg
 * - S = event, 3rd char+ is the index in .eventPokemon
 * - D = Dream World, only 5D is valid
 * - V = Virtual Console transfer, only 7V is valid
 * - C = NOT A REAL SOURCE, see note, only 3C/4C is valid
 *
 * C marks certain moves learned by a pokemon's prevo. It's used to
 * work around the chainbreeding checker's shortcuts for performance;
 * it lets the pokemon be a valid father for teaching the move, but
 * is otherwise ignored by the learnset checker (which will actually
 * check prevos for compatibility).
 */
type MoveSource = string;

/**
 * Describes a possible way to get a pokemon. Is not exhaustive!
 * sourcesBefore covers all sources that do not have exclusive
 * moves (like catching wild pokemon).
 *
 * First character is a generation number, 1-7.
 * Second character is a source ID, one of:
 *
 * - E = egg, 3rd char+ is the father in gen 2-5, empty in gen 6-7
 *   because egg moves aren't restricted to fathers anymore
 * - S = event, 3rd char+ is the index in .eventPokemon
 * - D = Dream World, only 5D is valid
 * - V = Virtual Console transfer, only 7V is valid
 *
 * Designed to match MoveSource where possible.
 */
type PokemonSource = string;

/**
 * Keeps track of how a pokemon with a given set might be obtained.
 *
 * `sources` is a list of possible PokemonSources, and a nonzero
 * sourcesBefore means the Pokemon is compatible with all possible
 * PokemonSources from that gen or earlier.
 *
 * `limitedEgg` tracks moves that can only be obtained from an egg with
 * another father in gen 2-5. If there are multiple such moves,
 * potential fathers need to be checked to see if they can actually
 * learn the move combination in question.
 */
type PokemonSources = {
	sources: PokemonSource[]
	sourcesBefore: number
	babyOnly?: string
	sketchMove?: string
	hm?: string
	restrictiveMoves?: string[]
	limitedEgg?: (string | 'self')[]
	isHidden?: boolean
	fastCheck?: true
}

type EventInfo = {
	generation: number,
	level?: number,
	shiny?: boolean | 1,
	gender?: GenderName,
	nature?: string,
	ivs?: SparseStatsTable,
	perfectIVs?: number,
	isHidden?: boolean,
	abilities?: string[],
	maxEggMoves?: number,
	moves?: string[],
	pokeball?: string,
	from?: string,
};

type Effect = Ability | Item | ActiveMove | Template | PureEffect | Format

interface SelfEffect {
	boosts?: SparseBoostsTable
	chance?: number
	sideCondition?: string
	slotCondition?: string
	volatileStatus?: string
	onHit?: EffectData["onHit"]
}

interface SecondaryEffect {
	chance?: number
	ability?: Ability
	boosts?: SparseBoostsTable
	dustproof?: boolean
	kingsrock?: boolean
	self?: SelfEffect
	status?: string
	volatileStatus?: string
	onAfterHit?: EffectData["onAfterHit"]
	onHit?: EffectData["onHit"]
}

interface EventMethods {
	/** Return true to stop the move from being used */
	beforeMoveCallback?: (this: Battle, pokemon: Pokemon, target: Pokemon | null, move: ActiveMove) => boolean | void
	beforeTurnCallback?: (this: Battle, pokemon: Pokemon, target: Pokemon) => void
	damageCallback?: (this: Battle, pokemon: Pokemon, target: Pokemon) => number | false
	durationCallback?: (this: Battle, target: Pokemon, source: Pokemon, effect: Effect | null) => number
	onAfterDamage?: (this: Battle, damage: number, target: Pokemon, soruce: Pokemon, move: ActiveMove) => void
	onAfterEachBoost?: (this: Battle, boost: SparseBoostsTable, target: Pokemon, source: Pokemon) => void
	onAfterHit?: (this: Battle, source: Pokemon, target: Pokemon, move: ActiveMove) => void
	onAfterSetStatus?: (this: Battle, status: PureEffect, target: Pokemon, source: Pokemon, effect: Effect) => void
	onAfterSubDamage?: (this: Battle, damage: any, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onAfterSwitchInSelf?: (this: Battle, pokemon: Pokemon) => void
	onAfterUseItem?: (this: Battle, item: Item, pokemon: Pokemon) => void
	onAfterBoost?: (this: Battle, boost: SparseBoostsTable, target: Pokemon, source: Pokemon, effect: Effect) => void
	onAfterMoveSecondarySelf?: (this: Battle, source: Pokemon, target: Pokemon, move: ActiveMove) => void
	onAfterMoveSecondary?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onAfterMove?: (this: Battle, pokemon: Pokemon, target: Pokemon, move: ActiveMove) => void
	onAfterMoveSelf?: (this: Battle, pokemon: Pokemon) => void
	onAllyTryAddVolatile?: (this: Battle, status: PureEffect, target: Pokemon, source: Pokemon, effect: Effect) => void
	onAllyBasePower?: (this: Battle, basePower: number, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => void
	onAllyModifyAtk?: (this: Battle, atk: number) => void
	onAllyModifySpD?: (this: Battle, spd: number) => void
	onAllyBoost?: (this: Battle, boost: SparseBoostsTable, target: Pokemon, source: Pokemon, effect: Effect) => void
	onAllySetStatus?: (this: Battle, status: PureEffect, target: Pokemon, source: Pokemon, effect: Effect) => void
	onAllyTryHitSide?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onAllyFaint?: (this: Battle, target: Pokemon) => void
	onAllyAfterUseItem?: (this: Battle, item: Item, pokemon: Pokemon) => void
	onAllyModifyMove?: (this: Battle, move: ActiveMove) => void
	onAnyTryPrimaryHit?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onAnyTryMove?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onAnyDamage?: (this: Battle, damage: number, target: Pokemon, source: Pokemon, effect: Effect) => void
	onAnyBasePower?: (this: Battle, basePower: number, source: Pokemon, target: Pokemon, move: ActiveMove) => void
	onAnySetWeather?: (this: Battle, target: Pokemon, source: Pokemon, weather: PureEffect) => void
	onAnyTerrainStart?: (this: Battle) => void
	onAnyModifyDamage?: (this: Battle, damage: number, source: Pokemon, target: Pokemon, move: ActiveMove) => void
	onAnyRedirectTarget?: (this: Battle, target: Pokemon, source: Pokemon, source2: Pokemon, move: ActiveMove) => void
	onAnyAccuracy?: (this: Battle, accuracy: number, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onAnyTryImmunity?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onAnyFaint?: (this: Battle) => void
	onAnyModifyBoost?: (this: Battle, boosts: SparseBoostsTable, target: Pokemon) => void
	onAnyDragOut?: (this: Battle, pokemon: Pokemon) => void
	onAnySetStatus?: (this: Battle, status: PureEffect, pokemon: Pokemon) => void
	onAttract?: (this: Battle, target: Pokemon, source: Pokemon, effect: Effect) => void
	onAccuracy?: (this: Battle, accuracy: number, target: Pokemon, source: Pokemon, move: ActiveMove) => number | boolean | null | void
	onBasePower?: (this: Battle, basePower: number, pokemon: Pokemon, target: Pokemon, move: ActiveMove) => void
	onTryImmunity?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onBeforeFaint?: (this: Battle, pokemon: Pokemon) => void
	onBeforeMove?: (this: Battle, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => void
	onBeforeSwitchIn?: (this: Battle, pokemon: Pokemon) => void
	onBeforeSwitchOut?: (this: Battle, pokemon: Pokemon) => void
	onBeforeTurn?: (this: Battle, pokemon: Pokemon) => void
	onBoost?: (this: Battle, boost: SparseBoostsTable, target: Pokemon, source: Pokemon, effect: Effect) => void
	onChargeMove?: (this: Battle, pokemon: Pokemon, target: Pokemon, move: ActiveMove) => void
	onCheckShow?: (this: Battle, pokemon: Pokemon) => void
	onCopy?: (this: Battle, pokemon: Pokemon) => void
	onDamage?: (this: Battle, damage: number, target: Pokemon, source: Pokemon, effect: Effect) => void
	onDeductPP?: (this: Battle, target: Pokemon, source: Pokemon) => number | void
	onDisableMove?: (this: Battle, pokemon: Pokemon) => void
	onDragOut?: (this: Battle, pokemon: Pokemon) => void
	onEat?: ((this: Battle, pokemon: Pokemon) => void) | false
	onEatItem?: (this: Battle, item: Item, pokemon: Pokemon) => void
	onEffectiveness?: (this: Battle, typeMod: number, target: Pokemon | null, type: string, move: ActiveMove) => void
	onEnd?: (this: Battle, target: Pokemon & Side & Field) => void
	onFaint?: (this: Battle, target: Pokemon, source: Pokemon, effect: Effect) => void
	onFlinch?: ((this: Battle, pokemon: Pokemon) => void) | boolean
	onFoeAfterDamage?: (this: Battle, damage: number, target: Pokemon) => void
	onFoeBasePower?: (this: Battle, basePower: number, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => void
	onFoeBeforeMove?: (this: Battle, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => void
	onFoeDisableMove?: (this: Battle, pokemon: Pokemon) => void
	onFoeMaybeTrapPokemon?: (this: Battle, pokemon: Pokemon, source: Pokemon) => void
	onFoeModifyDef?: (this: Battle, def: number, pokemon: Pokemon) => number
	onFoeRedirectTarget?: (this: Battle, target: Pokemon, source: Pokemon, source2: Effect, move: ActiveMove) => void
	onFoeSwitchOut?: (this: Battle, pokemon: Pokemon) => void
	onFoeTrapPokemon?: (this: Battle, pokemon: Pokemon) => void
	onFoeTryMove?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onHit?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onHitField?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => boolean | void
	onHitSide?: (this: Battle, side: Side, source: Pokemon, move: ActiveMove) => void
	onImmunity?: (this: Battle, type: string, pokemon: Pokemon) => void
	onLockMove?: string | ((this: Battle, pokemon: Pokemon) => void)
	onLockMoveTarget?: (this: Battle) => number
	onModifyAccuracy?: (this: Battle, accuracy: number, target: Pokemon, source: Pokemon, move: ActiveMove) => number | void
	onModifyAtk?: (this: Battle, atk: number, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => number | void
	onModifyBoost?: (this: Battle, boosts: SparseBoostsTable) => void
	onModifyCritRatio?: (this: Battle, critRatio: number, source: Pokemon, target: Pokemon) => number | void
	onModifyDamage?: (this: Battle, damage: number, source: Pokemon, target: Pokemon, move: ActiveMove) => number | void
	onModifyDef?: (this: Battle, def: number, pokemon: Pokemon) => number | void
	onModifyMove?: (this: Battle, move: ActiveMove, pokemon: Pokemon, target: Pokemon) => void
	onModifyPriority?: (this: Battle, priority: number, pokemon: Pokemon, target: Pokemon, move: ActiveMove) => number | void
	onModifySecondaries?: (this: Battle, secondaries: SecondaryEffect[], target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onModifySpA?: (this: Battle, atk: number, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => number | void
	onModifySpD?: (this: Battle, spd: number, pokemon: Pokemon) => number | void
	onModifySpe?: (this: Battle, spe: number, pokemon: Pokemon) => number | void
	onModifyWeight?: (this: Battle, weight: number, pokemon: Pokemon) => number | void
	onMoveAborted?: (this: Battle, pokemon: Pokemon, target: Pokemon, move: ActiveMove) => void
	onMoveFail?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onNegateImmunity?: ((this: Battle, pokemon: Pokemon, type: string) => void) | boolean
	onOverrideAction?: (this: Battle, pokemon: Pokemon, target: Pokemon, move: ActiveMove) => void
	onPrepareHit?: (this: Battle, source: Pokemon, target: Pokemon, move: ActiveMove) => void
	onPreStart?: (this: Battle, pokemon: Pokemon) => void
	onPrimal?: (this: Battle, pokemon: Pokemon) => void
	onRedirectTarget?: (this: Battle, target: Pokemon, source: Pokemon, source2: Effect) => void
	onResidual?: (this: Battle, target: Pokemon & Side, source: Pokemon, effect: Effect) => void
	onRestart?: (this: Battle, target: Pokemon & Field, source: Pokemon) => void
	onSetAbility?: (this: Battle, ability: string, target: Pokemon, source: Pokemon, effect: Effect) => void
	onSetStatus?: (this: Battle, status: PureEffect, target: Pokemon, source: Pokemon, effect: Effect) => void
	onSourceAccuracy?: (this: Battle, accuracy: number, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onSourceBasePower?: (this: Battle, basePower: number, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => void
	onSourceFaint?: (this: Battle, target: Pokemon, source: Pokemon, effect: Effect) => void
	onSourceHit?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onSourceModifyAccuracy?: (this: Battle, accuracy: number, target: Pokemon, source: Pokemon) => number | void
	onSourceModifyAtk?: (this: Battle, atk: number, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => number | void
	onSourceModifyDamage?: (this: Battle, damage: number, source: Pokemon, target: Pokemon, move: ActiveMove) => number | void
	onSourceModifySecondaries?: (this: Battle, secondaries: SecondaryEffect[], target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onSourceModifySpA?: (this: Battle, atk: number, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => number | void
	onSourceTryHeal?: (this: Battle, damage: number, target: Pokemon, source: Pokemon, effect: Effect) => void
	onSourceTryPrimaryHit?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onStallMove?: (this: Battle, pokemon: Pokemon) => void
	onStart?: (this: Battle, target: Pokemon & Side & Field, source: Pokemon, effect: Effect, move: ActiveMove) => void
	onSwitchIn?: (this: Battle, pokemon: Pokemon) => void
	onSwitchOut?: (this: Battle, pokemon: Pokemon) => void
	onTakeItem?: ((this: Battle, item: Item, pokemon: Pokemon, source: Pokemon) => void) | false
	onTerrain?: (this: Battle, pokemon: Pokemon) => void
	onTrapPokemon?: (this: Battle, pokemon: Pokemon) => void
	onTry?: (this: Battle, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => void
	onTryAddVolatile?: (this: Battle, status: PureEffect, target: Pokemon, source: Pokemon, effect: Effect) => void
	onTryEatItem?: (this: Battle, item: Item, pokemon: Pokemon) => void
	onTryHeal?: ((this: Battle, damage: number, target: Pokemon, source: Pokemon, effect: Effect) => void) | boolean
	onTryHit?: ((this: Battle, pokemon: Pokemon, target: Pokemon, move: ActiveMove) => void) | boolean
	onTryHitField?: (this: Battle, target: Pokemon, source: Pokemon) => boolean | void
	onTryHitSide?: (this: Battle, side: Side, source: Pokemon) => void
	onTryMove?: (this: Battle, pokemon: Pokemon, target: Pokemon, move: ActiveMove) => void
	onTryPrimaryHit?: (this: Battle, target: Pokemon, source: Pokemon, move: ActiveMove) => void
	onType?: (this: Battle, types: string[], pokemon: Pokemon) => void
	onUpdate?: (this: Battle, pokemon: Pokemon) => void
	onUseMoveMessage?: (this: Battle, pokemon: Pokemon, target: Pokemon, move: ActiveMove) => void
	onWeather?: (this: Battle, target: Pokemon, source: Pokemon, effect: PureEffect) => void
	onWeatherModifyDamage?: (this: Battle, damage: number, attacker: Pokemon, defender: Pokemon, move: ActiveMove) => number | void
	onAnyModifyDamagePhase1?: (this: Battle, damage: number, source: Pokemon, target: Pokemon, move: ActiveMove) => number | void
	onAnyModifyDamagePhase2?: EventMethods["onAnyModifyDamagePhase1"]
	onModifyDamagePhase1?: EventMethods["onAnyModifyDamagePhase1"]
	onModifyDamagePhase2?: EventMethods["onAnyModifyDamagePhase1"]
}

interface EffectData extends EventMethods {
	id: string
	name: string
	num: number
	affectsFainted?: boolean
	counterMax?: number
	desc?: string
	drain?: [number, number]
	duration?: number
	effect?: Partial<EffectData>
	effectType?: string
	infiltrates?: boolean
	isNonstandard?: Nonstandard | null
	isUnreleased?: boolean
	/**
	 * `true` for generic Z-moves like Gigavolt Havoc.
	 * Also `true` for Z-powered status moves like Z-Encore.
	 * Move ID of the base move, for specific Z-moves like Stoked
	 * Sparksurfer.
	 */
	isZ?: boolean | string
	noCopy?: boolean
	onAccuracyPriority?: number
	onAfterDamageOrder?: number
	onAfterMoveSecondaryPriority?: number
	onAfterMoveSecondarySelfPriority?: number
	onAfterMoveSelfPriority?: number
	onAnyFaintPriority?: number
	onAttractPriority?: number
	onBasePowerPriority?: number
	onBeforeMovePriority?: number
	onBeforeSwitchOutPriority?: number
	onBoostPriority?: number
	onCriticalHit?: boolean
	onDamagePriority?: number
	onDragOutPriority?: number
	onFoeBeforeMovePriority?: number
	onFoeModifyDefPriority?: number
	onFoeRedirectTargetPriority?: number
	onFoeTrapPokemonPriority?: number
	onFoeTryEatItem?: boolean
	onHitPriority?: number
	onModifyAccuracyPriority?: number
	onModifyAtkPriority?: number
	onModifyCritRatioPriority?: number
	onModifyDefPriority?: number
	onModifyMovePriority?: number
	onModifyPriorityPriority?: number
	onModifySpAPriority?: number
	onModifySpDPriority?: number
	onModifyWeightPriority?: number
	onRedirectTargetPriority?: number
	onResidualOrder?: number
	onResidualPriority?: number
	onResidualSubOrder?: number
	onSwitchInPriority?: number
	onTrapPokemonPriority?: number
	onTryHealPriority?: number
	onTryHitPriority?: number
	onTryMovePriority?: number
	onTryPrimaryHitPriority?: number
	onTypePriority?: number
	recoil?: [number, number]
	secondary?: SecondaryEffect | null
	secondaries?: SecondaryEffect[] | null
	self?: SelfEffect | null
	shortDesc?: string
	status?: string
	weather?: string
}

interface ModdedEffectData extends Partial<EffectData> {
	inherit?: boolean
}

type EffectType = 'Effect' | 'Pokemon' | 'Move' | 'Item' | 'Ability' | 'Format' | 'Ruleset' | 'Weather' | 'Status' | 'Rule' | 'ValidatorRule'

interface BasicEffect extends EffectData {
	effectType: EffectType
	exists: boolean
	flags: AnyObject
	fullname: string
	gen: number
	sourceEffect: string
	toString: () => string
}

interface PureEffect extends Readonly<BasicEffect> {
	readonly effectType: 'Status' | 'Effect' | 'Weather'
}

interface AbilityData extends EffectData {
	rating: number
	isUnbreakable?: boolean
	suppressWeather?: boolean
}

interface ModdedAbilityData extends Partial<AbilityData>, ModdedEffectData {}

interface Ability extends Readonly<BasicEffect & AbilityData> {
	readonly effectType: 'Ability'
}

interface FlingData {
	basePower: number
	status?: string
	volatileStatus?: string
	effect?: EventMethods["onHit"]
}

interface ItemData extends EffectData {
	gen: number
	fling?: FlingData
	forcedForme?: string
	ignoreKlutz?: boolean
	isBerry?: boolean
	isChoice?: boolean
	isGem?: boolean
	megaStone?: string
	megaEvolves?: string
	naturalGift?: {basePower: number, type: string}
	onDrive?: string
	onMemory?: string
	onPlate?: string
	spritenum?: number
	zMove?: string | true
	zMoveFrom?: string
	zMoveType?: string
	zMoveUser?: string[]
}

interface ModdedItemData extends Partial<ItemData>, ModdedEffectData {
	onCustap?: (this: Battle, pokemon: Pokemon) => void
}

interface Item extends Readonly<BasicEffect & ItemData> {
	readonly effectType: 'Item'
}

interface MoveData extends EffectData {
	accuracy: true | number
	basePower: number
	category: 'Physical' | 'Special' | 'Status'
	flags: AnyObject
	pp: number
	priority: number
	target: string
	type: string
	alwaysHit?: boolean
	baseMoveType?: string
	basePowerModifier?: number
	boosts?: SparseBoostsTable | false
	breaksProtect?: boolean
	contestType?: string
	critModifier?: number
	critRatio?: number
	damage?: number | 'level' | false | null
	defensiveCategory?: 'Physical' | 'Special' | 'Status'
	forceSwitch?: boolean
	hasCustomRecoil?: boolean
	heal?: number[] | null
	ignoreAbility?: boolean
	ignoreAccuracy?: boolean
	ignoreDefensive?: boolean
	ignoreEvasion?: boolean
	ignoreImmunity?: boolean | {[k: string]: boolean}
	ignoreNegativeOffensive?: boolean
	ignoreOffensive?: boolean
	ignorePositiveDefensive?: boolean
	ignorePositiveEvasion?: boolean
	isSelfHit?: boolean
	isFutureMove?: boolean
	isViable?: boolean
	mindBlownRecoil?: boolean
	multiaccuracy?: boolean
	multihit?: number | number[]
	multihitType?: string
	noDamageVariance?: boolean
	noFaint?: boolean
	noMetronome?: string[]
	nonGhostTarget?: string
	noPPBoosts?: boolean
	noSketch?: boolean
	ohko?: boolean | string
	pressureTarget?: string
	pseudoWeather?: string
	selfBoost?: {boosts?: SparseBoostsTable}
	selfdestruct?: string | boolean
	selfSwitch?: string | boolean
	sideCondition?: string
	sleepUsable?: boolean
	slotCondition?: string
	spreadModifier?: number
	stallingMove?: boolean
	stealsBoosts?: boolean
	struggleRecoil?: boolean
	terrain?: string
	thawsTarget?: boolean
	useTargetOffensive?: boolean
	useSourceDefensive?: boolean
	volatileStatus?: string
	weather?: string
	willCrit?: boolean
	forceSTAB?: boolean
	zMovePower?: number
	zMoveEffect?: string
	zMoveBoost?: SparseBoostsTable
	basePowerCallback?: (this: Battle, pokemon: Pokemon, target: Pokemon, move: ActiveMove) => number | false | null
}

interface ModdedMoveData extends Partial<MoveData>, ModdedEffectData {}

interface Move extends Readonly<BasicEffect & MoveData> {
	readonly effectType: 'Move'
}

interface ActiveMove extends BasicEffect, MoveData {
	readonly effectType: 'Move'
	typeMod: number
	hit: number
	ability?: Ability
	aerilateBoosted?: boolean
	allies?: Pokemon[]
	auraBooster?: Pokemon
	causedCrashDamage?: boolean
	crit?: boolean
	forceStatus?: string
	galvanizeBoosted?: boolean
	hasAuraBreak?: boolean
	hasBounced?: boolean
	hasSheerForce?: boolean
	isExternal?: boolean
	lastHit?: boolean
	magnitude?: number
	negateSecondary?: boolean
	normalizeBoosted?: boolean
	pixilateBoosted?: boolean
	pranksterBoosted?: boolean
	refrigerateBoosted?: boolean
	selfDropped?: boolean
	spreadHit?: boolean
	stab?: number
	statusRoll?: string
	totalDamage?: number | false
	willChangeForme?: boolean
	/**
	 * Whether or not this move is a Z-Move that broke protect
	 * (affects damage calculation).
	 * @type {boolean}
	 */
	zBrokeProtect?: boolean
	/**
	 * Has this move been boosted by a Z-crystal? Usually the same as
	 * `isZ`, but hacked moves will have this be `false` and `isZ` be
	 * truthy.
	 */
	isZPowered?: boolean
}

type TemplateAbility = {0: string, 1?: string, H?: string, S?: string}

interface TemplateData {
	abilities: TemplateAbility
	baseStats: StatsTable
	canHatch?: boolean
	color: string
	eggGroups: string[]
	heightm: number
	num: number
	species: string
	types: string[]
	weightkg: number
	baseForme?: string
	baseSpecies?: string
	evoLevel?: number
	evoMove?: string
	evoCondition?: string
	evoItem?: string
	evos?: string[]
	evoType?: 'trade' | 'stone' | 'levelMove' | 'levelExtra' | 'levelFriendship' | 'levelHold'
	forme?: string
	formeLetter?: string
	gender?: GenderName
	genderRatio?: {[k: string]: number}
	maxHP?: number
	otherForms?: string[]
	otherFormes?: string[]
	prevo?: string
}

interface ModdedTemplateData extends Partial<TemplateData> {
	inherit?: true,
}

interface TemplateFormatsData {
	battleOnly?: boolean
	comboMoves?: string[]
	doublesTier?: string
	encounters?: EventInfo[]
	essentialMove?: string
	eventOnly?: boolean
	eventPokemon?: EventInfo[]
	exclusiveMoves?: string[]
	gen?: number
	isNonstandard?: Nonstandard | null
	isUnreleased?: boolean
	maleOnlyHidden?: boolean
	randomBattleMoves?: string[]
	randomDoubleBattleMoves?: string[]
	requiredAbility?: string
	requiredItem?: string
	requiredItems?: string[]
	requiredMove?: string
	tier?: string
	unreleasedHidden?: boolean
}

interface ModdedTemplateFormatsData extends Partial<TemplateFormatsData> {
	inherit?: true,
	randomSet1?: RandomTeamsTypes["TemplateRandomSet"]
	randomSet2?: RandomTeamsTypes["TemplateRandomSet"]
	randomSet3?: RandomTeamsTypes["TemplateRandomSet"]
	randomSet4?: RandomTeamsTypes["TemplateRandomSet"]
	randomSet5?: RandomTeamsTypes["TemplateRandomSet"]
}

interface Template extends Readonly<BasicEffect & TemplateData & TemplateFormatsData> {
	readonly effectType: 'Pokemon'
	readonly baseSpecies: string
	readonly doublesTier: string
	readonly eventOnly: boolean
	readonly evos: string[]
	readonly forme: string
	readonly formeLetter: string
	readonly gender: GenderName
	readonly genderRatio: {M: number, F: number}
	readonly maleOnlyHidden: boolean
	readonly nfe: boolean
	readonly prevo: string
	readonly speciesid: string
	readonly spriteid: string
	readonly tier: string
	readonly addedType?: string
	readonly isMega?: boolean
	readonly isPrimal?: boolean
	readonly learnset?: {[k: string]: MoveSource[]}
}

type GameType = 'singles' | 'doubles' | 'triples' | 'rotation' | 'multi' | 'free-for-all'
type SideID = 'p1' | 'p2' | 'p3' | 'p4'

interface GameTimerSettings {
	dcTimer: boolean;
	dcTimerBank: boolean;
	starting: number;
	grace: number;
	addPerTurn: number;
	maxPerTurn: number;
	maxFirstTurn: number;
	timeoutAutoChoose: boolean;
	accelerate: boolean;
}

interface FormatsData extends EventMethods {
	name: string
	banlist?: string[]
	cannotMega?: string[]
	canUseRandomTeam?: boolean
	challengeShow?: boolean
	debug?: boolean
	defaultLevel?: number
	desc?: string
	effectType?: string
	forcedLevel?: number
	gameType?: GameType
	maxForcedLevel?: number
	maxLevel?: number
	mod?: string
	noChangeAbility?: boolean
	noChangeForme?: boolean
	onBasePowerPriority?: number
	onModifyMovePriority?: number
	onSwitchInPriority?: number
	rated?: boolean
	requirePentagon?: boolean
	requirePlus?: boolean
	restrictedAbilities?: string[]
	restrictedMoves?: string[]
	restrictedStones?: string[]
	ruleset?: string[]
	searchShow?: boolean
	allowMultisearch?: boolean
	team?: string
	teamLength?: {validate?: [number, number], battle?: number}
	threads?: string[]
	timer?: Partial<GameTimerSettings>
	tournamentShow?: boolean
	unbanlist?: string[]
	checkLearnset?: (this: Validator, move: Move, template: Template, lsetData: PokemonSources, set: PokemonSet) => {type: string, [any: string]: any} | null
	onAfterMega?: (this: Battle, pokemon: Pokemon) => void
	onBegin?: (this: Battle) => void
	onChangeSet?: (this: ModdedDex, set: PokemonSet, format: Format, setHas?: AnyObject, teamHas?: AnyObject) => string[] | void
	onModifyTemplate?: (this: Battle, template: Template, target: Pokemon, source: Pokemon, effect: Effect) => Template | void
	onTeamPreview?: (this: Battle) => void
	onValidateSet?: (this: ModdedDex, set: PokemonSet, format: Format, setHas: AnyObject, teamHas: AnyObject) => string[] | void
	onValidateTeam?: (this: ModdedDex, team: PokemonSet[], format: Format, teamHas: AnyObject) => string[] | void
	validateSet?: (this: Validator, set: PokemonSet, teamHas: AnyObject) => string[] | void
	validateTeam?: (this: Validator, team: PokemonSet[], removeNicknames: boolean) => string[] | void,
	section?: string,
	column?: number
}

interface ModdedFormatsData extends Partial<FormatsData> {
	inherit?: boolean
}

interface RuleTable extends Map<string, string> {
	checkLearnset: [Function, string] | null
	complexBans: [string, string, number, string[]][]
	complexTeamBans: [string, string, number, string[]][]
	check: (thing: string, setHas: {[k: string]: true}) => string
	getReason: (key: string) => string
}

interface Format extends Readonly<BasicEffect & FormatsData> {
	readonly effectType: 'Format' | 'Ruleset' | 'Rule' | 'ValidatorRule'
	readonly baseRuleset: string[]
	readonly banlist: string[]
	readonly customRules: string[] | null
	readonly defaultLevel: number
	readonly maxLevel: number
	readonly noLog: boolean
	readonly ruleset: string[]
	readonly unbanlist: string[]
	ruleTable: RuleTable | null
}

type SpreadMoveTargets = (Pokemon | false | null)[]
type SpreadMoveDamage = (number | boolean | undefined)[]

interface BattleScriptsData {
	gen: number
	zMoveTable?: {[k: string]: string}
	afterMoveSecondaryEvent?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => undefined
	calcRecoilDamage?: (this: Battle, damageDealt: number, move: Move) => number
	canMegaEvo?: (this: Battle, pokemon: Pokemon) => string | undefined | null
	canUltraBurst?: (this: Battle, pokemon: Pokemon) => string | null
	canZMove?: (this: Battle, pokemon: Pokemon) => (AnyObject | null)[] | void
	forceSwitch?: (this: Battle, damage: SpreadMoveDamage, targets: SpreadMoveTargets, source: Pokemon, move: ActiveMove, moveData: ActiveMove, isSecondary?: boolean, isSelf?: boolean) => SpreadMoveDamage
	getActiveZMove?: (this: Battle, move: Move, pokemon: Pokemon) => ActiveMove
	getSpreadDamage?: (this: Battle, damage: SpreadMoveDamage, targets: SpreadMoveTargets, source: Pokemon, move: ActiveMove, moveData: ActiveMove, isSecondary?: boolean, isSelf?: boolean) => SpreadMoveDamage
	getZMove?: (this: Battle, move: Move, pokemon: Pokemon, skipChecks?: boolean) => string | undefined
	hitStepAccuracy?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => boolean[]
	hitStepBreakProtect?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => undefined
	hitStepMoveHitLoop?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => SpreadMoveDamage
	hitStepPowderImmunity?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => boolean[]
	hitStepPranksterImmunity?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => boolean[]
	hitStepStealBoosts?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => undefined
	hitStepTryHitEvent?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => (boolean | '')[]
	hitStepTryImmunityEvent?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => boolean[]
	hitStepTypeImmunity?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => boolean[]
	isAdjacent?: (this: Battle, pokemon1: Pokemon, pokemon2: Pokemon) => boolean
	moveHit?: (this: Battle, target: Pokemon | null, pokemon: Pokemon, move: ActiveMove, moveData?: ActiveMove, isSecondary?: boolean, isSelf?: boolean) => number | undefined | false
	resolveAction?: (this: Battle, action: AnyObject, midTurn?: boolean) => Actions["Action"]
	runAction?: (this: Battle, action: Actions["Action"]) => void
	runMegaEvo?: (this: Battle, pokemon: Pokemon) => boolean
	runMove?: (this: Battle, moveOrMoveName: Move | string, pokemon: Pokemon, targetLoc: number, sourceEffect?: Effect | null, zMove?: string, externalMove?: boolean) => void
	runMoveEffects?: (this: Battle, damage: SpreadMoveDamage, targets: SpreadMoveTargets, source: Pokemon, move: ActiveMove, moveData: ActiveMove, isSecondary?: boolean, isSelf?: boolean) => SpreadMoveDamage
	runZPower?: (this: Battle, move: ActiveMove, pokemon: Pokemon) => void
	secondaries?: (this: Battle, targets: SpreadMoveTargets, source: Pokemon, move: ActiveMove, moveData: ActiveMove, isSelf?: boolean) => void
	selfDrops?: (this: Battle, targets: SpreadMoveTargets, source: Pokemon, move: ActiveMove, moveData: ActiveMove, isSecondary?: boolean) => void
	spreadMoveHit?: (this: Battle, targets: SpreadMoveTargets, pokemon: Pokemon, move: ActiveMove, moveData?: ActiveMove, isSecondary?: boolean, isSelf?: boolean) => [SpreadMoveDamage, SpreadMoveTargets]
	targetTypeChoices?: (this: Battle, targetType: string) => boolean
	tryMoveHit?: (this: Battle, target: Pokemon, pokemon: Pokemon, move: ActiveMove) => number | undefined | false | ''
	tryPrimaryHitEvent?: (this: Battle, damage: SpreadMoveDamage, targets: SpreadMoveTargets, pokemon: Pokemon, move: ActiveMove, moveData: ActiveMove, isSecondary?: boolean) => SpreadMoveDamage
	trySpreadMoveHit?: (this: Battle, targets: Pokemon[], pokemon: Pokemon, move: ActiveMove) => boolean
	useMove?: (this: Battle, move: Move, pokemon: Pokemon, target?: Pokemon | null, sourceEffect?: Effect | null, zMove?: string) => boolean
	useMoveInner?: (this: Battle, move: Move, pokemon: Pokemon, target?: Pokemon | null, sourceEffect?: Effect | null, zMove?: string) => boolean
}

interface ModdedBattleSide {
	lastMove?: Move | null
}

interface ModdedBattlePokemon {
	inherit?: boolean
	boostBy?: (this: Pokemon, boost: SparseBoostsTable) => boolean | number
	calculateStat?: (this: Pokemon, statName: StatNameExceptHP, boost: number, modifier?: number) => number
	getActionSpeed?: (this: Pokemon) => number
	getRequestData?: (this: Pokemon) => {moves: {move: string, id: string, target?: string, disabled?: boolean}[], maybeDisabled?: boolean, trapped?: boolean, maybeTrapped?: boolean, canMegaEvo?: boolean, canUltraBurst?: boolean, canZMove?: AnyObject | null}
	getStat?: (this: Pokemon, statName: StatNameExceptHP, unboosted?: boolean, unmodified?: boolean, fastReturn?: boolean) => number
	getWeight?: (this: Pokemon) => number
	hasAbility?: (this: Pokemon, ability: string | string[]) => boolean
	isGrounded?: (this: Pokemon, negateImmunity: boolean | undefined) => boolean | null
	modifyStat?: (this: Pokemon, statName: StatNameExceptHP, modifier: number) => void
	moveUsed?: (this: Pokemon, move: Move, targetLoc?: number) => void
	recalculateStats?: (this: Pokemon) => void
	setAbility?: (this: Pokemon, ability: string | Ability, source: Pokemon | null, isFromFormeChange: boolean) => string | false
	transformInto?: (this: Pokemon, pokemon: Pokemon, effect: Effect | null) => boolean
}

interface ModdedBattleScriptsData extends Partial<BattleScriptsData> {
	inherit?: string
	lastDamage?: number
	pokemon?: ModdedBattlePokemon
	side?: ModdedBattleSide
	boost?: (this: Battle, boost: SparseBoostsTable, target: Pokemon, source?: Pokemon | null, effect?: Effect | string | null, isSecondary?: boolean, isSelf?: boolean) => boolean | null | 0
	debug?: (this: Battle, activity: string) => void
	getDamage?: (this: Battle, pokemon: Pokemon, target: Pokemon, move: string | number | ActiveMove, suppressMessages: boolean) => number | undefined | null | false
	getEffect?: (this: Battle, name: string | Effect | null) => Effect
	init?: (this: Battle) => void
	modifyDamage?: (this: Battle, baseDamage: number, pokemon: Pokemon, target: Pokemon, move: ActiveMove, suppressMessages?: boolean) => void
	natureModify?: (this: Battle, stats: StatsTable, set: PokemonSet) => StatsTable
	setTerrain?: (this: Battle, status: string | Effect, source: Pokemon | null | 'debug', sourceEffect: Effect | null) => boolean
	spreadModify?: (this: Battle, baseStats: StatsTable, set: PokemonSet) => StatsTable
	suppressingWeather?: (this: Battle) => boolean

	// oms
	doGetMixedTemplate?: (this: Battle, template: Template, deltas: AnyObject) => Template
	getMegaDeltas?: (this: Battle, megaSpecies: Template) => AnyObject
	getMixedTemplate?: (this: Battle, originalSpecies: string, megaSpecies: string) => Template
}

interface TypeData {
	damageTaken: {[attackingTypeNameOrEffectid: string]: number}
	HPdvs?: SparseStatsTable
	HPivs?: SparseStatsTable
}

interface ModdedTypeData extends Partial<TypeData> {
	inherit?: boolean
}

interface TypeInfo extends Readonly<TypeData> {
	readonly effectType: 'Type' | 'EffectType'
	readonly exists: boolean
	readonly gen: number
	readonly HPdvs: SparseStatsTable
	readonly HPivs: SparseStatsTable
	readonly id: string
	readonly name: string
	readonly toString: () => string
}

interface PlayerOptions {
	name?: string;
	avatar?: string;
	team?: PokemonSet[] | string | null;
	seed?: PRNGSeed;
}

interface Actions {
	/** A move action */
	MoveAction: {
		/** action type */
		choice: 'move' | 'beforeTurnMove'
		/** priority of the action (lower first) */
		priority: number
		/** speed of pokemon using move (higher first if priority tie) */
		speed: number
		/** the pokemon doing the move */
		pokemon: Pokemon
		/** location of the target, relative to pokemon's side */
		targetLoc: number
		/** a move to use (move action only) */
		moveid: string
		/** a move to use (move action only) */
		move: Move
		/** true if megaing or ultra bursting */
		mega: boolean | 'done'
		/** if zmoving, the name of the zmove */
		zmove?: string
		/** effect that called the move (eg Instruct) if any */
		sourceEffect?: Effect | null
	}

	/** A switch action */
	SwitchAction: {
		/** action type */
		choice: 'switch' | 'instaswitch'
		/** priority of the action (lower first) */
		priority: number
		/** speed of pokemon switching (higher first if priority tie) */
		speed: number
		/** the pokemon doing the switch */
		pokemon: Pokemon
		/** pokemon to switch to */
		target: Pokemon
		/** effect that called the switch (eg U */
		sourceEffect: Effect | null
	}

	/** A Team Preview choice action */
	TeamAction: {
		/** action type */
		choice: 'team'
		/** priority of the action (lower first) */
		priority: number
		/** unused for this action type */
		speed: 1
		/** the pokemon switching */
		pokemon: Pokemon
		/** new index */
		index: number
	}

	/** A generic action not done by a pokemon */
	FieldAction: {
		/** action type */
		choice: 'start' | 'residual' | 'pass' | 'beforeTurn'
		/** priority of the action (lower first) */
		priority: number
		/** unused for this action type */
		speed: 1
		/** unused for this action type */
		pokemon: null
	}

	/** A generic action done by a single pokemon */
	PokemonAction: {
		/** action type */
		choice: 'megaEvo' | 'shift' | 'runPrimal' | 'runSwitch' | 'event' | 'runUnnerve'
		/** priority of the action (lower first) */
		priority: number
		/** speed of pokemon doing action (higher first if priority tie) */
		speed: number
		/** the pokemon doing action */
		pokemon: Pokemon
	}

	Action: Actions["MoveAction"] | Actions["SwitchAction"] | Actions["TeamAction"] | Actions["FieldAction"] | Actions["PokemonAction"]
}

interface RandomTeamsTypes {
	TeamDetails: {
		megaStone?: number
		zMove?: number
		hail?: number
		rain?: number
		sand?: number
		sun?: number
		stealthRock?: number
		spikes?: number
		toxicSpikes?: number
		hazardClear?: number
		rapidSpin?: number
		illusion?: number
	}
	FactoryTeamDetails: {
		megaCount: number
		zCount?: number
		forceResult: boolean
		weather?: string
		typeCount: {[k: string]: number}
		typeComboCount: {[k: string]: number}
		baseFormes: {[k: string]: number}
		has: {[k: string]: number}
		weaknesses: {[k: string]: number}
		resistances: {[k: string]: number}
	}
	RandomSet: {
		name: string
		species: string
		gender: string | boolean
		moves: string[]
		ability: string
		evs: SparseStatsTable
		ivs: SparseStatsTable
		item: string
		level: number
		shiny: boolean
		nature?: string
		happiness?: number
		moveset?: RandomTeamsTypes["RandomSet"]
		other?: {discard: boolean, restrictMoves: {[k: string]: number}}
	}
	RandomFactorySet: {
		name: string
		species: string
		gender: string
		item: string
		ability: string
		shiny: boolean
		level: number
		happiness: number
		evs: SparseStatsTable
		ivs: SparseStatsTable
		nature: string
		moves: string[]
	}
	TemplateRandomSet: {
		chance: number
		item: string[]
		baseMove1?: string
		baseMove2?: string
		baseMove3?: string
		baseMove4?: string
		fillerMoves1?: string[]
		fillerMoves2?: string[]
		fillerMoves3?: string[]
		fillerMoves4?: string[]
	}
}