// Serialize as a plain string — idiomatic C# is an enum with [JsonStringEnumConverter]:
public enum DataSource
{
    PackFile,
    GameFiles,
    ParentFiles,
    AssKitFiles,
    ExternalFile,
}

// Serialize as either { "File": "..." } or { "Folder": "..." }:
public abstract class ContainerPath { }
public class ContainerPathFile   : ContainerPath { public string File { get; set; } }
public class ContainerPathFolder : ContainerPath { public string Folder { get; set; } }

public class RFileInfo
{
    public string Path { get; set; }
    public string? ContainerName { get; set; }
    public long? Timestamp { get; set; }
    public string FileType { get; set; }
}

public class ContainerInfo
{
    public string FileName { get; set; }
    public string FilePath { get; set; }
    public PFHVersion PfhVersion { get; set; }
    public PFHFileType PfhFileType { get; set; }
    public PFHFlags Bitmask { get; set; }
    public CompressionFormat Compress { get; set; }
    public ulong Timestamp { get; set; }
}

public class DependenciesInfo
{
    public List<RFileInfo> AsskitTables { get; set; }
    public List<RFileInfo> VanillaPackedFiles { get; set; }
    public List<RFileInfo> ParentPackedFiles { get; set; }
}

public class SessionInfo
{
    public int SessionId { get; set; }
    public int ConnectionCount { get; set; }
    public double? TimeoutRemainingSecs { get; set; }
    public bool IsShuttingDown { get; set; }
    public List<string> PackNames { get; set; }
}

// Tagged-enum payload — one class per variant:
public abstract class NewFile { }
public class NewFileAnimPack : NewFile { public string AnimPack { get; set; } }
public class NewFileDB : NewFile { public Tuple<string, string, int> DB { get; set; } }
public class NewFileLoc : NewFile { public string Loc { get; set; } }
public class NewFilePortraitSettings : NewFile
{
    public Tuple<string, uint, List<Tuple<string, string>>> PortraitSettings { get; set; }
}
public class NewFileText : NewFile { public Tuple<string, string> Text { get; set; } }  // second is TextFormat enum
public class NewFileVMD : NewFile { public string VMD { get; set; } }
public class NewFileWSModel : NewFile { public string WSModel { get; set; } }

public class VideoInfo
{
    public string Format { get; set; }
    public int Version { get; set; }
    public string CodecFourCc { get; set; }
    public int Width { get; set; }
    public int Height { get; set; }
    public int NumFrames { get; set; }
    public double Framerate { get; set; }
}

public enum FileType
{
    Anim, AnimFragmentBattle, AnimPack, AnimsTable, Atlas, Audio,
    BMD, BMDVegetation, Dat, DB, ESF, Font, GroupFormations,
    HlslCompiled, Image, Loc, MatchedCombat, Pack, PortraitSettings,
    RigidModel, SoundBank, Text, UIC, UnitVariant, Video, VMD,
    WSModel, Unknown,
}

public enum CompressionFormat { None, Lzma1, Lz4, Zstd }

public enum PFHFileType { Boot, Release, Patch, Mod, Movie }

public enum PFHVersion { PFH0, PFH2, PFH3, PFH4, PFH5, PFH6 }

[Flags]
public enum PFHFlags : uint
{
    None = 0,
    HasExtendedHeader      = 0x0000_0100,
    HasEncryptedIndex      = 0x0000_0080,
    HasIndexWithTimestamps = 0x0000_0040,
    HasEncryptedData       = 0x0000_0010,
}

public enum SupportedFormats { CaVp8, Ivf }

// Serialize as either { "MyMod": [string, string] } or the string "Normal".
public abstract class OperationalMode { }
public class OperationalModeMyMod : OperationalMode
{
    public string GameFolder { get; set; }
    public string MyModPackName { get; set; }
}
public class OperationalModeNormal : OperationalMode { }

// Tagged-enum — one class per variant. Branch on the JSON key.
public abstract class DecodedData { }
public class DecodedDataBoolean         : DecodedData { public bool Boolean { get; set; } }
public class DecodedDataF32             : DecodedData { public float F32 { get; set; } }
public class DecodedDataF64             : DecodedData { public double F64 { get; set; } }
public class DecodedDataI16             : DecodedData { public short I16 { get; set; } }
public class DecodedDataI32             : DecodedData { public int I32 { get; set; } }
public class DecodedDataI64             : DecodedData { public long I64 { get; set; } }
public class DecodedDataColourRGB       : DecodedData { public string ColourRGB { get; set; } }
public class DecodedDataStringU8        : DecodedData { public string StringU8 { get; set; } }
public class DecodedDataStringU16       : DecodedData { public string StringU16 { get; set; } }
public class DecodedDataOptionalI16     : DecodedData { public short OptionalI16 { get; set; } }
public class DecodedDataOptionalI32     : DecodedData { public int OptionalI32 { get; set; } }
public class DecodedDataOptionalI64     : DecodedData { public long OptionalI64 { get; set; } }
public class DecodedDataOptionalStringU8 : DecodedData { public string OptionalStringU8 { get; set; } }
public class DecodedDataOptionalStringU16: DecodedData { public string OptionalStringU16 { get; set; } }
public class DecodedDataSequenceU16     : DecodedData { public byte[] SequenceU16 { get; set; } }
public class DecodedDataSequenceU32     : DecodedData { public byte[] SequenceU32 { get; set; } }

public class TableInMemory
{
    public string TableName { get; set; }
    public Definition Definition { get; set; }
    public DefinitionPatch DefinitionPatch { get; set; }
    public List<List<DecodedData>> TableData { get; set; }
    public bool Altered { get; set; }
}

public class RFile
{
    public string Path { get; set; }
    public long? Timestamp { get; set; }
    public FileType FileType { get; set; }
    public string? ContainerName { get; set; }
    public object Data { get; set; }
}

// Tagged enum — one wrapper class per variant. Only the most common ones shown.
public abstract class RFileDecoded { }
public class RFileDecodedDB : RFileDecoded { public DB DB { get; set; } }
public class RFileDecodedLoc : RFileDecoded { public Loc Loc { get; set; } }
public class RFileDecodedText : RFileDecoded { public Text Text { get; set; } }
public class RFileDecodedImage : RFileDecoded { public Image Image { get; set; } }
public class RFileDecodedRigidModel : RFileDecoded { public RigidModel RigidModel { get; set; } }
// ... one class per variant listed in the enum above.

public class TableReferences
{
    public string FieldName { get; set; }
    public bool ReferencedTableIsAkOnly { get; set; }
    public bool ReferencedColumnIsLocalised { get; set; }
    public Dictionary<string, string> Data { get; set; }
}

public class DB
{
    public bool MysteriousByte { get; set; }
    public string Guid { get; set; }
    public TableInMemory Table { get; set; }
}

public class Loc
{
    public TableInMemory Table { get; set; }
}

public class Text
{
    public TextEncoding Encoding { get; set; }
    public TextFormat Format { get; set; }
    public string Contents { get; set; }
}

public enum TextEncoding { Iso8859_1, Utf8, Utf8Bom, Utf16Le }

public enum TextFormat { Bat, Cpp, Html, Hlsl, Json, Js, Css, Lua, Markdown, Plain, Python, Sql, Xml, Yaml }

public class Image
{
    public byte[] Data { get; set; }
    public byte[]? ConvertedData { get; set; }
}

public class RigidModel
{
    public uint Version { get; set; }
    public uint Uk1 { get; set; }
    public string SkeletonId { get; set; }
    public List<object> Lods { get; set; }
}

public class ESF
{
    public string Signature { get; set; }
    public uint Unknown1 { get; set; }
    public uint CreationDate { get; set; }
    public object RootNode { get; set; }
}

public class Bmd
{
    public uint SerialiseVersion { get; set; }
    // plus format-specific fields depending on serialise_version
}

public class AnimFragmentBattle
{
    public uint Version { get; set; }
    public List<object> Entries { get; set; }
    public string SkeletonName { get; set; }
    public uint Subversion { get; set; }
}

public class AnimsTable
{
    public uint Version { get; set; }
    public List<object> Entries { get; set; }
}

public class Atlas
{
    public uint Version { get; set; }
    public uint Unknown { get; set; }
    public List<object> Entries { get; set; }
}

public class Audio
{
    public byte[] Data { get; set; }
}

public class GroupFormations
{
    public List<object> Formations { get; set; }
}

public class MatchedCombat
{
    public uint Version { get; set; }
    public List<object> Entries { get; set; }
}

public class PortraitSettings
{
    public uint Version { get; set; }
    public List<object> Entries { get; set; }
}

public class UIC
{
    public uint Version { get; set; }
    public bool SourceIsXml { get; set; }
    public string Comment { get; set; }
    public string PrecacheCondition { get; set; }
    public Dictionary<string, object> Hierarchy { get; set; }
    public Dictionary<string, object> Components { get; set; }
}

public class UnitVariant
{
    public uint Version { get; set; }
    public uint Unknown1 { get; set; }
    public List<object> Categories { get; set; }
}

// Mix of plain-string and tagged-enum variants. Model it as a tagged union:
public abstract class FieldType { }
public class FieldTypePrimitive : FieldType { public string Kind { get; set; } }  // e.g. "I32"
public class FieldTypeSequenceU16 : FieldType { public Definition SequenceU16 { get; set; } }
public class FieldTypeSequenceU32 : FieldType { public Definition SequenceU32 { get; set; } }

public class Field
{
    public string Name { get; set; }
    public FieldType FieldType { get; set; }
    public bool IsKey { get; set; }
    public string? DefaultValue { get; set; }
    public bool IsFilename { get; set; }
    public string? FilenameRelativePath { get; set; }
    public Tuple<string, string>? IsReference { get; set; }
    public List<string>? Lookup { get; set; }
    public string Description { get; set; }
    public short CaOrder { get; set; }
    public int IsBitwise { get; set; }
    public Dictionary<int, string> EnumValues { get; set; }
    public byte? IsPartOfColour { get; set; }
}

public class Definition
{
    public int Version { get; set; }
    public List<Field> Fields { get; set; }
    public List<Field> LocalisedFields { get; set; }
    public List<uint> LocalisedKeyOrder { get; set; }
}

public class Schema
{
    public ushort Version { get; set; }
    public Dictionary<string, List<Definition>> Definitions { get; set; }
    public Dictionary<string, DefinitionPatch> Patches { get; set; }
}

// DefinitionPatch is a type alias for the nested map:
using DefinitionPatch = System.Collections.Generic.Dictionary<string, System.Collections.Generic.Dictionary<string, string>>;

public class PackSettings
{
    public Dictionary<string, string> SettingsText { get; set; }
    public Dictionary<string, string> SettingsString { get; set; }
    public Dictionary<string, bool> SettingsBool { get; set; }
    public Dictionary<string, int> SettingsNumber { get; set; }
}

public class Note
{
    public ulong Id { get; set; }
    public string Message { get; set; }
    public string? Url { get; set; }
    public string Path { get; set; }
}

public class OptimizerOptions
{
    public bool PackRemoveItmFiles { get; set; }
    public bool DbImportDatacoresIntoTwadKeyDeletes { get; set; }
    public bool DbOptimizeDatacoredTables { get; set; }
    public bool TableRemoveDuplicatedEntries { get; set; }
    public bool TableRemoveItmEntries { get; set; }
    public bool TableRemoveItnrEntries { get; set; }
    public bool TableRemoveEmptyFile { get; set; }
    public bool TextRemoveUnusedXmlMapFolders { get; set; }
    public bool TextRemoveUnusedXmlPrefabFolder { get; set; }
    public bool TextRemoveAgfFiles { get; set; }
    public bool TextRemoveModelStatisticsFiles { get; set; }
    public bool PtsRemoveUnusedArtSets { get; set; }
    public bool PtsRemoveUnusedVariants { get; set; }
    public bool PtsRemoveEmptyMasks { get; set; }
    public bool PtsRemoveEmptyFile { get; set; }
}

public class SettingsSnapshot
{
    public Dictionary<string, bool> Bool { get; set; }
    public Dictionary<string, int> I32 { get; set; }
    public Dictionary<string, float> F32 { get; set; }
    public Dictionary<string, string> String { get; set; }
    public Dictionary<string, byte[]> RawData { get; set; }
    public Dictionary<string, List<string>> VecString { get; set; }
}

public class Translation
{
    public string Key { get; set; }
    public string ValueOriginal { get; set; }
    public string ValueTranslated { get; set; }
    public bool NeedsRetranslation { get; set; }
    public bool Removed { get; set; }
}

public class PackTranslation
{
    public string Language { get; set; }
    public string PackName { get; set; }
    public Dictionary<string, Translation> Translations { get; set; }
}

public class Diagnostics
{
    public List<string> FoldersIgnored { get; set; }
    public List<string> FilesIgnored { get; set; }
    public List<string> FieldsIgnored { get; set; }
    public List<string> DiagnosticsIgnored { get; set; }
    public List<DiagnosticType> Results { get; set; }
}

public abstract class DiagnosticType { }
public class DiagnosticTypeAnimFragmentBattle : DiagnosticType { public object AnimFragmentBattle { get; set; } }
public class DiagnosticTypeConfig             : DiagnosticType { public object Config { get; set; } }
public class DiagnosticTypeDependency         : DiagnosticType { public object Dependency { get; set; } }
public class DiagnosticTypeDB                 : DiagnosticType { public object DB { get; set; } }
public class DiagnosticTypeLoc                : DiagnosticType { public object Loc { get; set; } }
public class DiagnosticTypePack               : DiagnosticType { public object Pack { get; set; } }
public class DiagnosticTypePortraitSettings   : DiagnosticType { public object PortraitSettings { get; set; } }
public class DiagnosticTypeText               : DiagnosticType { public object Text { get; set; } }

// Serialize as either a wrapped object { "<Variant>": "version" } or a bare string.
public abstract class APIResponse { }
public class APIResponseNewBetaUpdate   : APIResponse { public string NewBetaUpdate { get; set; } }
public class APIResponseNewStableUpdate : APIResponse { public string NewStableUpdate { get; set; } }
public class APIResponseNewUpdateHotfix : APIResponse { public string NewUpdateHotfix { get; set; } }
public class APIResponseNoUpdate        : APIResponse { }
public class APIResponseUnknownVersion  : APIResponse { }

public enum GitResponse { NewUpdate, NoUpdate, NoLocalFiles, Diverged }

// Serialize as either { "Pack": "pack_key" } or a bare string.
public abstract class SearchSource { }
public class SearchSourcePack        : SearchSource { public string Pack { get; set; } }
public class SearchSourceParentFiles : SearchSource { }
public class SearchSourceGameFiles   : SearchSource { }
public class SearchSourceAssKitFiles : SearchSource { }

public class SearchOn
{
    public bool Anim { get; set; }
    public bool AnimFragmentBattle { get; set; }
    public bool AnimPack { get; set; }
    public bool AnimsTable { get; set; }
    public bool Atlas { get; set; }
    public bool Audio { get; set; }
    public bool Bmd { get; set; }
    public bool Db { get; set; }
    public bool Esf { get; set; }
    public bool GroupFormations { get; set; }
    public bool Image { get; set; }
    public bool Loc { get; set; }
    public bool MatchedCombat { get; set; }
    public bool Pack { get; set; }
    public bool PortraitSettings { get; set; }
    public bool RigidModel { get; set; }
    public bool SoundBank { get; set; }
    public bool Text { get; set; }
    public bool Uic { get; set; }
    public bool UnitVariant { get; set; }
    public bool Unknown { get; set; }
    public bool Video { get; set; }
    public bool Schema { get; set; }
}

public class GlobalSearch
{
    public string Pattern { get; set; }
    public string ReplaceText { get; set; }
    public bool CaseSensitive { get; set; }
    public bool UseRegex { get; set; }
    public List<SearchSource> Sources { get; set; }
    public SearchOn SearchOn { get; set; }
    public Matches Matches { get; set; }
    public string GameKey { get; set; }
}

public class Matches
{
    public List<MatchContainer<UnknownMatch>> Anim { get; set; }
    public List<MatchContainer<AnimFragmentBattleMatch>> AnimFragmentBattle { get; set; }
    public List<MatchContainer<UnknownMatch>> AnimPack { get; set; }
    public List<MatchContainer<UnknownMatch>> AnimsTable { get; set; }
    public List<MatchContainer<AtlasMatch>> Atlas { get; set; }
    public List<MatchContainer<UnknownMatch>> Audio { get; set; }
    public List<MatchContainer<UnknownMatch>> Bmd { get; set; }
    public List<MatchContainer<TableMatch>> Db { get; set; }
    public List<MatchContainer<UnknownMatch>> Esf { get; set; }
    public List<MatchContainer<UnknownMatch>> GroupFormations { get; set; }
    public List<MatchContainer<UnknownMatch>> Image { get; set; }
    public List<MatchContainer<TableMatch>> Loc { get; set; }
    public List<MatchContainer<UnknownMatch>> MatchedCombat { get; set; }
    public List<MatchContainer<UnknownMatch>> Pack { get; set; }
    public List<MatchContainer<PortraitSettingsMatch>> PortraitSettings { get; set; }
    public List<MatchContainer<RigidModelMatch>> RigidModel { get; set; }
    public List<MatchContainer<UnknownMatch>> SoundBank { get; set; }
    public List<MatchContainer<TextMatch>> Text { get; set; }
    public List<MatchContainer<UnknownMatch>> Uic { get; set; }
    public List<MatchContainer<UnitVariantMatch>> UnitVariant { get; set; }
    public List<MatchContainer<UnknownMatch>> Unknown { get; set; }
    public List<MatchContainer<UnknownMatch>> Video { get; set; }
    public MatchContainer<SchemaMatch> Schema { get; set; }
}

public class TableMatch
{
    public string ColumnName { get; set; }
    public uint ColumnNumber { get; set; }
    public long RowNumber { get; set; }
    public long Start { get; set; }
    public long End { get; set; }
    public string Text { get; set; }
}

public class TextMatch
{
    public ulong Row { get; set; }
    public long Start { get; set; }
    public long End { get; set; }
    public string Text { get; set; }
}

public class UnknownMatch
{
    public long Pos { get; set; }
    public long Len { get; set; }
}

// AtlasMatch has the same shape as TableMatch.
public class AtlasMatch : TableMatch { }

public class SchemaMatch
{
    public string TableName { get; set; }
    public int Version { get; set; }
    public int Column { get; set; }
    public string ColumnName { get; set; }
}

// AnimFragmentBattleMatch, PortraitSettingsMatch, RigidModelMatch and UnitVariantMatch
// follow the tables above; field-for-field translations are straightforward
// (booleans → bool, nullable tuples → Tuple<...>? or a named class).

// Wrapper shared by every *Matches type:
public class MatchContainer<M>
{
    public string Path { get; set; }
    public SearchSource Source { get; set; }
    public string ContainerName { get; set; }
    public List<M> Matches { get; set; }
}

// One wrapper class per variant. Only the most common ones shown — pattern is identical for the rest.
public abstract class MatchHolder { }
public class MatchHolderDb   : MatchHolder { public MatchContainer<TableMatch> Db { get; set; } }
public class MatchHolderLoc  : MatchHolder { public MatchContainer<TableMatch> Loc { get; set; } }
public class MatchHolderText : MatchHolder { public MatchContainer<TextMatch> Text { get; set; } }
public class MatchHolderSchema : MatchHolder { public MatchContainer<SchemaMatch> Schema { get; set; } }
// ... one class per variant listed above; most wrap MatchContainer<UnknownMatch>.