using System;
using static PKHeX.Core.EntityContext;
namespace PKHeX.Core;
///
/// "Context" is an existence island; data format restricts the types of changes that can be made (such as evolving).
///
///
/// Starting in the 8th generation games, entities can move between games with wildly different evolution rules.
/// Previous implementations of a "Format Generation" were unable to differentiate if a class object was present in one of these different-rule contexts.
/// The "Format Generation" is still a useful generalization to check if certain fields are present in the entity data, or if certain mutations are possible.
///
public enum EntityContext : byte
{
None = 0,
Gen1 = 1,
Gen2 = 2,
Gen3 = 3,
Gen4 = 4,
Gen5 = 5,
Gen6 = 6,
Gen7 = 7,
Gen8 = 8,
Gen9 = 9,
SplitInvalid,
Gen7b,
Gen8a,
Gen8b,
MaxInvalid,
}
public static class EntityContextExtensions
{
public static int Generation(this EntityContext value) => value < SplitInvalid ? (int)value : value switch
{
Gen7b => 7,
Gen8a => 8,
Gen8b => 8,
_ => throw new ArgumentOutOfRangeException(nameof(value), value, null),
};
public static bool IsValid(this EntityContext value) => value is not (0 or SplitInvalid) and < MaxInvalid;
public static GameVersion GetSingleGameVersion(this EntityContext value) => value switch
{
Gen1 => GameVersion.RD,
Gen2 => GameVersion.C,
Gen3 => GameVersion.E,
Gen4 => GameVersion.SS,
Gen5 => GameVersion.W2,
Gen6 => GameVersion.AS,
Gen7 => GameVersion.UM,
Gen8 => GameVersion.SH,
Gen9 => GameVersion.VL,
Gen7b => GameVersion.GP,
Gen8a => GameVersion.PLA,
Gen8b => GameVersion.BD,
_ => throw new ArgumentOutOfRangeException(nameof(value), value, null),
};
public static GameConsole GetConsole(this EntityContext value) => value switch
{
Gen1 or Gen2 => GameConsole.GB,
Gen3 => GameConsole.GBA,
Gen4 or Gen5 => GameConsole.NDS,
Gen6 or Gen7 => GameConsole._3DS,
Gen7b or Gen8 or Gen8a or Gen8b or Gen9 => GameConsole.NX,
_ => throw new ArgumentOutOfRangeException(nameof(value), value, null),
};
public static GameVersion[] GetVersionsWithin(this EntityContext value, GameVersion[] source) => value.GetVersionLump().GetVersionsWithinRange(source);
public static GameVersion GetVersionLump(this EntityContext value) => value switch
{
Gen1 => GameVersion.Gen1,
Gen2 => GameVersion.Gen2,
Gen3 => GameVersion.Gen3,
Gen4 => GameVersion.Gen4,
Gen5 => GameVersion.Gen5,
Gen6 => GameVersion.Gen6,
Gen7 => GameVersion.Gen7,
Gen8 => GameVersion.Gen8,
Gen9 => GameVersion.Gen9,
Gen7b => GameVersion.Gen7b,
Gen8a => GameVersion.PLA,
Gen8b => GameVersion.BDSP,
_ => throw new ArgumentOutOfRangeException(nameof(value), value, null),
};
public static EntityContext GetContext(this GameVersion version) => version switch
{
GameVersion.GP or GameVersion.GE or GameVersion.GO => Gen7b,
GameVersion.PLA => Gen8a,
GameVersion.BD or GameVersion.SP => Gen8b,
_ => (EntityContext)version.GetGeneration(),
};
}