esf-dogma-engine 13.0.0

//! The fit to calculate.

use std::collections::{BTreeMap, BTreeSet};
use std::fmt;

use serde::de::{self, Visitor};
use serde::{Deserialize, Deserializer, Serialize};

#[cfg(feature = "typescript")]
use tsify::Tsify;

use crate::projection::Projection;

/// A ship, what is fitted to it, and the character flying it.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Clone)]
pub struct Fit {
    /// Only for display; the calculation does not use it.
    #[cfg_attr(feature = "typescript", tsify(optional))]
    pub name: Option<String>,
    /// The ship.
    pub ship: Ship,
    /// Modules, drones, fighters, implants, boosters and cargo.
    pub items: Vec<FitItem>,
    /// The character flying the ship.
    #[serde(default)]
    pub character: Character,
    /// Where the ship is.
    #[serde(default)]
    pub environment: Environment,
    /// What projections to apply on this fit.
    #[serde(default, skip_serializing_if = "Projection::is_empty")]
    pub incoming: Projection,
}

/// The ship of a fit.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Clone)]
pub struct Ship {
    /// The type id of the ship.
    pub type_id: i32,
    /// The type id of the active mode, for ships that have modes.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mode: Option<i32>,
}

/// A module, drone, fighter squadron, implant, booster or item in cargo.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Clone)]
pub struct FitItem {
    /// The type id of the item.
    pub type_id: i32,
    /// Where the item is.
    pub slot: Slot,
    /// 1 for modules. Stack size for drones, fighters and cargo; for fighters
    /// in a tube, the size of the squadron.
    #[serde(default = "one")]
    pub quantity: u32,
    /// The state asked for; the calculation lowers it when the item cannot
    /// reach it.
    pub state: State,
    /// The charge loaded in the module, if any.
    #[cfg_attr(feature = "typescript", tsify(optional))]
    pub charge: Option<Charge>,
    /// Only for mutated modules and drones.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mutation: Option<Mutation>,
    /// Only for fighters: the abilities used, by effect id. `None` uses the
    /// abilities the fighter uses by default.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub fighter_abilities: Option<BTreeSet<i32>>,
    /// Only for boosters: the side effects rolled, by effect id. Empty means
    /// none.
    #[serde(default, skip_serializing_if = "BTreeSet::is_empty")]
    pub booster_side_effects: BTreeSet<i32>,
    /// How far a module whose bonus grows every cycle has spooled.
    /// Only per-second stats use it; volley is always unspooled.
    /// `None` is fully spooled.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub spool: Option<Spool>,
}

/// Where an item is. The number is the position in its rack, starting at 0;
/// for implants and boosters, the slot as EVE numbers it, starting at 1.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Copy, Clone, PartialEq, Eq, Hash)]
#[serde(tag = "type", content = "index", rename_all = "snake_case")]
pub enum Slot {
    /// A high slot.
    High(u8),
    /// A medium slot.
    Medium(u8),
    /// A low slot.
    Low(u8),
    /// A rig slot.
    Rig(u8),
    /// A subsystem slot.
    Subsystem(u8),
    /// A service slot, on a structure.
    Service(u8),
    /// A fighter tube; a squadron that is not offline is in space.
    FighterTube(u8),
    /// The fighter bay; nothing in it is in space.
    FighterBay,
    /// An implant; the number is its `implantness`.
    Implant(u8),
    /// A booster; the number is its `boosterness`.
    Booster(u16),
    /// The drone bay; a drone that is not offline is in space.
    DroneBay,
    /// The cargo hold; nothing in it is calculated.
    Cargo,
}

/// The state of an item, lowest first.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Copy, Clone, PartialEq, Eq, PartialOrd, Ord)]
#[serde(rename_all = "snake_case")]
pub enum State {
    /// Only passive effects apply.
    Offline,
    /// Online effects apply too.
    Online,
    /// Active effects apply too.
    Active,
    /// Overload effects apply too.
    Overload,
}

/// A charge loaded in a module.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Clone)]
pub struct Charge {
    /// The type id of the charge.
    pub type_id: i32,
}

/// How a module or drone was mutated.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Clone)]
pub struct Mutation {
    /// The type id of the item before it was mutated.
    pub base: i32,
    /// The rolled value of each mutated attribute, by attribute id.
    #[serde(default, deserialize_with = "id_map")]
    #[cfg_attr(
        feature = "typescript",
        tsify(type = "Map<number, number> | Record<number, number>")
    )]
    pub attributes: BTreeMap<i32, f64>,
}

/// How far a module has spooled.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Copy, Clone, PartialEq)]
#[serde(rename_all = "snake_case")]
pub enum Spool {
    /// The bonus reached so far: 0.0 is unspooled, 2.125 is +212.5%.
    MultiplierBonus(f64),
}

/// The character flying the ship.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Clone, Default)]
pub struct Character {
    /// The level of each skill, by type id. A skill that is not listed is not
    /// trained, and gives no bonus.
    #[serde(default, deserialize_with = "id_map")]
    #[cfg_attr(
        feature = "typescript",
        tsify(type = "Map<number, number> | Record<number, number>")
    )]
    pub skills: BTreeMap<i32, u8>,
    /// -10.0 to 5.0. Only a few ships have a bonus that scales with it.
    #[serde(default)]
    pub security_status: f64,
}

/// Where the ship is.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Clone, Default)]
pub struct Environment {
    /// The damage the ship is assumed to take, for effective hitpoints.
    #[serde(default)]
    pub damage_profile: DamageProfile,
    /// The security of the solar system.
    #[serde(default)]
    pub security: Security,
    /// What a Reactive Armor Hardener shifts its resistances towards.
    #[serde(default)]
    pub reactive_armor: ReactiveArmor,
}

/// What a Reactive Armor Hardener shifts its resistances towards.
///
/// EVE shows it as a plain 15/15/15/15 hardener, as the client has no damage
/// to shift it against. `DoNotAdapt` reports the same, and is the default.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Copy, Clone, Default, PartialEq)]
#[serde(rename_all = "snake_case")]
pub enum ReactiveArmor {
    /// Leave the resistances where they start, the way EVE shows them.
    #[default]
    DoNotAdapt,
    /// Shift towards the damage the ship is already assumed to take.
    DamageProfile,
    /// Shift towards damage of its own, which the rest of the fit ignores.
    Profile(DamageProfile),
}

/// How incoming damage is split over the four damage types. Only the ratio
/// matters; the calculation scales the four to add up to one.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Copy, Clone, PartialEq)]
pub struct DamageProfile {
    /// EM damage.
    #[serde(default)]
    pub em: f64,
    /// Explosive damage.
    #[serde(default)]
    pub explosive: f64,
    /// Kinetic damage.
    #[serde(default)]
    pub kinetic: f64,
    /// Thermal damage.
    #[serde(default)]
    pub thermal: f64,
}

impl Default for DamageProfile {
    fn default() -> Self {
        Self {
            em: 0.25,
            explosive: 0.25,
            kinetic: 0.25,
            thermal: 0.25,
        }
    }
}

/// The security of a solar system.
#[cfg_attr(feature = "typescript", derive(Tsify))]
#[derive(Serialize, Deserialize, Debug, Copy, Clone, Default, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum Security {
    /// High-sec.
    #[default]
    HighSec,
    /// Low-sec.
    LowSec,
    /// Null-sec.
    NullSec,
    /// Wormhole space.
    Wormhole,
}

fn one() -> u32 {
    1
}

/* JSON and JavaScript objects only have string keys, Python dicts have real
 * ones. */
pub(crate) fn id_map<'de, D, V>(deserializer: D) -> Result<BTreeMap<i32, V>, D::Error>
where
    D: Deserializer<'de>,
    V: Deserialize<'de>,
{
    Ok(BTreeMap::<Id, V>::deserialize(deserializer)?
        .into_iter()
        .map(|(Id(key), value)| (key, value))
        .collect())
}

#[derive(PartialEq, Eq, PartialOrd, Ord)]
struct Id(i32);

impl<'de> Deserialize<'de> for Id {
    fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Id, D::Error> {
        struct IdVisitor;

        impl Visitor<'_> for IdVisitor {
            type Value = Id;

            fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
                formatter.write_str("an identifier")
            }

            fn visit_str<E: de::Error>(self, value: &str) -> Result<Id, E> {
                value
                    .parse()
                    .map(Id)
                    .map_err(|_| E::custom(format!("expected an identifier, found {value:?}")))
            }

            fn visit_i64<E: de::Error>(self, value: i64) -> Result<Id, E> {
                i32::try_from(value)
                    .map(Id)
                    .map_err(|_| E::custom(format!("expected an identifier, found {value}")))
            }

            fn visit_u64<E: de::Error>(self, value: u64) -> Result<Id, E> {
                i32::try_from(value)
                    .map(Id)
                    .map_err(|_| E::custom(format!("expected an identifier, found {value}")))
            }
        }

        deserializer.deserialize_any(IdVisitor)
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::projection::ProjectedBuff;

    #[test]
    fn minimal_fit_fills_defaults() {
        let fit: Fit = serde_json::from_str(
            r#"{
                "ship": {"type_id": 587},
                "items": [
                    {"type_id": 2873, "slot": {"type": "high", "index": 0}, "state": "active"},
                    {"type_id": 2488, "slot": {"type": "drone_bay"}, "quantity": 5, "state": "active"}
                ],
                "character": {"skills": {"3300": 5}}
            }"#,
        )
        .unwrap();

        assert_eq!(fit.ship.mode, None);
        assert_eq!(fit.items[0].slot, Slot::High(0));
        assert_eq!(fit.items[0].quantity, 1);
        assert_eq!(fit.items[0].fighter_abilities, None);
        assert_eq!(fit.items[0].spool, None);
        assert_eq!(fit.items[1].slot, Slot::DroneBay);
        assert_eq!(fit.items[1].quantity, 5);
        assert_eq!(fit.character.skills[&3300], 5);
        assert_eq!(fit.character.security_status, 0.0);
        assert_eq!(fit.environment.security, Security::HighSec);
        assert_eq!(fit.environment.damage_profile, DamageProfile::default());
        assert_eq!(fit.environment.reactive_armor, ReactiveArmor::DoNotAdapt);
        assert!(fit.incoming.is_empty());
    }

    #[test]
    fn reads_damage_profile() {
        let fit: Fit = serde_json::from_str(
            r#"{
                "ship": {"type_id": 587},
                "items": [],
                "environment": {"damage_profile": {"kinetic": 3, "thermal": 1}}
            }"#,
        )
        .unwrap();

        assert_eq!(
            fit.environment.damage_profile,
            DamageProfile {
                em: 0.0,
                explosive: 0.0,
                kinetic: 3.0,
                thermal: 1.0,
            }
        );
        assert_eq!(fit.environment.security, Security::HighSec);
    }

    #[test]
    fn reads_reactive_armor() {
        let read = |environment| {
            let fit: Fit = serde_json::from_str(&format!(
                r#"{{"ship": {{"type_id": 587}}, "items": [], "environment": {environment}}}"#
            ))
            .unwrap();
            fit.environment.reactive_armor
        };

        assert_eq!(
            read(r#"{"reactive_armor": "damage_profile"}"#),
            ReactiveArmor::DamageProfile
        );
        assert_eq!(
            read(r#"{"reactive_armor": {"profile": {"kinetic": 3, "thermal": 1}}}"#),
            ReactiveArmor::Profile(DamageProfile {
                em: 0.0,
                explosive: 0.0,
                kinetic: 3.0,
                thermal: 1.0,
            })
        );
    }

    #[test]
    fn reads_security() {
        let fit: Fit = serde_json::from_str(
            r#"{
                "ship": {"type_id": 35832},
                "items": [],
                "environment": {"security": "null_sec"}
            }"#,
        )
        .unwrap();

        assert_eq!(fit.environment.security, Security::NullSec);
    }

    #[test]
    fn reads_incoming() {
        let fit: Fit = serde_json::from_str(
            r#"{
                "ship": {"type_id": 587},
                "items": [],
                "incoming": {
                    "buffs": [{"id": 10, "value": -8.0}],
                    "effects": [{"type_id": 527, "effect_id": 6426, "attributes": {"20": -60.0}}]
                }
            }"#,
        )
        .unwrap();

        assert_eq!(
            fit.incoming.buffs,
            [ProjectedBuff {
                id: 10,
                value: -8.0
            }]
        );
        assert_eq!(fit.incoming.effects[0].type_id, 527);
        assert_eq!(fit.incoming.effects[0].effect_id, 6426);
        assert_eq!(
            fit.incoming.effects[0].attributes,
            BTreeMap::from([(20, -60.0)])
        );
    }

    #[test]
    fn reads_fighters() {
        let fit: Fit = serde_json::from_str(
            r#"{
                "ship": {"type_id": 23911},
                "items": [
                    {"type_id": 40556, "slot": {"type": "fighter_tube", "index": 1}, "quantity": 6, "state": "active", "fighter_abilities": [6465, 6431]},
                    {"type_id": 40556, "slot": {"type": "fighter_bay"}, "quantity": 3, "state": "offline", "fighter_abilities": []}
                ]
            }"#,
        )
        .unwrap();

        assert_eq!(fit.items[0].slot, Slot::FighterTube(1));
        assert_eq!(
            fit.items[0].fighter_abilities,
            Some(BTreeSet::from([6431, 6465]))
        );
        assert_eq!(fit.items[1].slot, Slot::FighterBay);
        assert_eq!(fit.items[1].fighter_abilities, Some(BTreeSet::new()));
    }

    #[test]
    fn reads_implants_and_boosters() {
        let fit: Fit = serde_json::from_str(
            r#"{
                "ship": {"type_id": 587},
                "items": [
                    {"type_id": 20499, "slot": {"type": "implant", "index": 1}, "state": "online"},
                    {"type_id": 9950, "slot": {"type": "booster", "index": 1}, "state": "online", "booster_side_effects": [2745, 2737]},
                    {"type_id": 57285, "slot": {"type": "booster", "index": 504}, "state": "online"}
                ]
            }"#,
        )
        .unwrap();

        assert_eq!(fit.items[0].slot, Slot::Implant(1));
        assert_eq!(fit.items[1].slot, Slot::Booster(1));
        assert_eq!(
            fit.items[1].booster_side_effects,
            BTreeSet::from([2737, 2745])
        );
        assert_eq!(fit.items[2].slot, Slot::Booster(504));
        assert!(fit.items[2].booster_side_effects.is_empty());
    }

    #[test]
    fn reads_mutation() {
        let fit: Fit = serde_json::from_str(
            r#"{
                "ship": {"type_id": 587},
                "items": [
                    {"type_id": 47732, "slot": {"type": "medium", "index": 0}, "state": "active", "mutation": {"base": 448, "attributes": {"6": 7.5, "54": 10500}}}
                ]
            }"#,
        )
        .unwrap();

        let mutation = fit.items[0].mutation.as_ref().unwrap();
        assert_eq!(mutation.base, 448);
        assert_eq!(
            mutation.attributes,
            BTreeMap::from([(6, 7.5), (54, 10500.0)])
        );
    }

    #[test]
    fn reads_spool() {
        let fit: Fit = serde_json::from_str(
            r#"{
                "ship": {"type_id": 52250},
                "items": [
                    {"type_id": 47914, "slot": {"type": "high", "index": 0}, "state": "active", "spool": {"multiplier_bonus": 0.7}}
                ]
            }"#,
        )
        .unwrap();

        assert_eq!(fit.items[0].spool, Some(Spool::MultiplierBonus(0.7)));
    }

    #[test]
    fn reads_security_status() {
        let fit: Fit = serde_json::from_str(
            r#"{
                "ship": {"type_id": 44995},
                "items": [],
                "character": {"security_status": -2.5}
            }"#,
        )
        .unwrap();

        assert_eq!(fit.character.security_status, -2.5);
        assert!(fit.character.skills.is_empty());
    }

    #[test]
    fn reads_mode() {
        let fit: Fit = serde_json::from_str(
            r#"{
                "ship": {"type_id": 34317, "mode": 34319},
                "items": []
            }"#,
        )
        .unwrap();

        assert_eq!(fit.ship.type_id, 34317);
        assert_eq!(fit.ship.mode, Some(34319));
    }

    #[test]
    fn round_trips_through_json() {
        let fit = Fit {
            name: Some("Rifter".to_string()),
            ship: Ship {
                type_id: 587,
                mode: None,
            },
            items: vec![FitItem {
                type_id: 47408,
                slot: Slot::Medium(2),
                quantity: 1,
                state: State::Overload,
                charge: None,
                mutation: None,
                fighter_abilities: None,
                booster_side_effects: BTreeSet::new(),
                spool: None,
            }],
            character: Character::default(),
            environment: Environment::default(),
            incoming: Projection::default(),
        };

        let json = serde_json::to_string(&fit).unwrap();
        let parsed: Fit = serde_json::from_str(&json).unwrap();

        assert!(!json.contains("fighter_abilities"));
        assert!(!json.contains("booster_side_effects"));
        assert!(!json.contains("spool"));
        assert!(!json.contains("mutation"));
        assert!(!json.contains("mode"));
        assert!(!json.contains("incoming"));
        assert_eq!(parsed.items[0].slot, Slot::Medium(2));
        assert_eq!(parsed.items[0].state, State::Overload);
    }
}