azalea/azalea-chat/src/component.rs

use crate::{
    base_component::BaseComponent,
    style::{ChatFormatting, Style},
    text_component::TextComponent,
    translatable_component::{StringOrComponent, TranslatableComponent},
};
#[cfg(feature = "azalea-buf")]
use azalea_buf::{BufReadError, McBufReadable, McBufWritable};
use once_cell::sync::Lazy;
use serde::{de, Deserialize, Deserializer, Serialize};
#[cfg(feature = "simdnbt")]
use simdnbt::{Deserialize as _, FromNbtTag as _, Serialize as _};
use std::fmt::Display;
use tracing::{trace, warn};

/// A chat component, basically anything you can see in chat.
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Hash)]
#[serde(untagged)]
pub enum FormattedText {
    Text(TextComponent),
    Translatable(TranslatableComponent),
}

pub static DEFAULT_STYLE: Lazy<Style> = Lazy::new(|| Style {
    color: Some(ChatFormatting::White.try_into().unwrap()),
    ..Style::default()
});

/// A chat component
impl FormattedText {
    pub fn get_base_mut(&mut self) -> &mut BaseComponent {
        match self {
            Self::Text(c) => &mut c.base,
            Self::Translatable(c) => &mut c.base,
        }
    }

    pub fn get_base(&self) -> &BaseComponent {
        match self {
            Self::Text(c) => &c.base,
            Self::Translatable(c) => &c.base,
        }
    }

    /// Add a component as a sibling of this one
    fn append(&mut self, sibling: FormattedText) {
        self.get_base_mut().siblings.push(sibling);
    }

    /// Get the "separator" component from the json
    fn parse_separator(
        json: &serde_json::Value,
    ) -> Result<Option<FormattedText>, serde_json::Error> {
        if let Some(separator) = json.get("separator") {
            return Ok(Some(FormattedText::deserialize(separator)?));
        }
        Ok(None)
    }

    #[cfg(feature = "simdnbt")]
    fn parse_separator_nbt(nbt: &simdnbt::borrow::NbtCompound) -> Option<FormattedText> {
        if let Some(separator) = nbt.get("separator") {
            FormattedText::from_nbt_tag(separator)
        } else {
            None
        }
    }

    /// Convert this component into an
    /// [ANSI string](https://en.wikipedia.org/wiki/ANSI_escape_code), so you
    /// can print it to your terminal and get styling.
    ///
    /// This is technically a shortcut for
    /// [`FormattedText::to_ansi_with_custom_style`] with a default [`Style`]
    /// colored white.
    ///
    /// # Examples
    ///
    /// ```rust
    /// use azalea_chat::FormattedText;
    /// use serde::de::Deserialize;
    ///
    /// let component = FormattedText::deserialize(&serde_json::json!({
    ///    "text": "Hello, world!",
    ///    "color": "red",
    /// })).unwrap();
    ///
    /// println!("{}", component.to_ansi());
    /// ```
    pub fn to_ansi(&self) -> String {
        // default the default_style to white if it's not set
        self.to_ansi_with_custom_style(&DEFAULT_STYLE)
    }

    /// Convert this component into an
    /// [ANSI string](https://en.wikipedia.org/wiki/ANSI_escape_code).
    ///
    /// This is the same as [`FormattedText::to_ansi`], but you can specify a
    /// default [`Style`] to use.
    pub fn to_ansi_with_custom_style(&self, default_style: &Style) -> String {
        // this contains the final string will all the ansi escape codes
        let mut built_string = String::new();
        // this style will update as we visit components
        let mut running_style = Style::default();

        for component in self.clone().into_iter() {
            let component_text = match &component {
                Self::Text(c) => c.text.to_string(),
                Self::Translatable(c) => c.to_string(),
            };

            let component_style = &component.get_base().style;

            let ansi_text = running_style.compare_ansi(component_style, default_style);
            built_string.push_str(&ansi_text);
            built_string.push_str(&component_text);

            running_style.apply(component_style);
        }

        if !running_style.is_empty() {
            built_string.push_str("\u{1b}[m");
        }

        built_string
    }
}

impl IntoIterator for FormattedText {
    /// Recursively call the function for every component in this component
    fn into_iter(self) -> Self::IntoIter {
        let base = self.get_base();
        let siblings = base.siblings.clone();
        let mut v: Vec<FormattedText> = Vec::with_capacity(siblings.len() + 1);
        v.push(self);
        for sibling in siblings {
            v.extend(sibling);
        }

        v.into_iter()
    }

    type Item = FormattedText;
    type IntoIter = std::vec::IntoIter<Self::Item>;
}

impl<'de> Deserialize<'de> for FormattedText {
    fn deserialize<D>(de: D) -> Result<Self, D::Error>
    where
        D: Deserializer<'de>,
    {
        let json: serde_json::Value = serde::Deserialize::deserialize(de)?;

        // we create a component that we might add siblings to
        let mut component: FormattedText;

        // if it's primitive, make it a text component
        if !json.is_array() && !json.is_object() {
            return Ok(FormattedText::Text(TextComponent::new(
                json.as_str().unwrap_or("").to_string(),
            )));
        }
        // if it's an object, do things with { text } and stuff
        else if json.is_object() {
            if let Some(text) = json.get("text") {
                let text = text.as_str().unwrap_or("").to_string();
                component = FormattedText::Text(TextComponent::new(text));
            } else if let Some(translate) = json.get("translate") {
                let translate = translate
                    .as_str()
                    .ok_or_else(|| de::Error::custom("\"translate\" must be a string"))?
                    .into();
                if let Some(with) = json.get("with") {
                    let with = with
                        .as_array()
                        .ok_or_else(|| de::Error::custom("\"with\" must be an array"))?;
                    let mut with_array = Vec::with_capacity(with.len());
                    for item in with {
                        // if it's a string component with no styling and no siblings, just add a
                        // string to with_array otherwise add the component
                        // to the array
                        let c = FormattedText::deserialize(item).map_err(de::Error::custom)?;
                        if let FormattedText::Text(text_component) = c {
                            if text_component.base.siblings.is_empty()
                                && text_component.base.style.is_empty()
                            {
                                with_array.push(StringOrComponent::String(text_component.text));
                                continue;
                            }
                        }
                        with_array.push(StringOrComponent::FormattedText(
                            FormattedText::deserialize(item).map_err(de::Error::custom)?,
                        ));
                    }
                    component = FormattedText::Translatable(TranslatableComponent::new(
                        translate, with_array,
                    ));
                } else {
                    // if it doesn't have a "with", just have the with_array be empty
                    component = FormattedText::Translatable(TranslatableComponent::new(
                        translate,
                        Vec::new(),
                    ));
                }
            } else if let Some(score) = json.get("score") {
                // object = GsonHelper.getAsJsonObject(jsonObject, "score");
                if score.get("name").is_none() || score.get("objective").is_none() {
                    return Err(de::Error::missing_field(
                        "A score component needs at least a name and an objective",
                    ));
                }
                // TODO
                return Err(de::Error::custom(
                    "score text components aren't yet supported",
                ));
            } else if json.get("selector").is_some() {
                return Err(de::Error::custom(
                    "selector text components aren't yet supported",
                ));
            } else if json.get("keybind").is_some() {
                return Err(de::Error::custom(
                    "keybind text components aren't yet supported",
                ));
            } else {
                let Some(_nbt) = json.get("nbt") else {
                    return Err(de::Error::custom(
                        format!("Don't know how to turn {json} into a FormattedText").as_str(),
                    ));
                };
                let _separator =
                    FormattedText::parse_separator(&json).map_err(de::Error::custom)?;

                let _interpret = match json.get("interpret") {
                    Some(v) => v.as_bool().ok_or(Some(false)).unwrap(),
                    None => false,
                };
                if let Some(_block) = json.get("block") {}
                return Err(de::Error::custom(
                    "nbt text components aren't yet supported",
                ));
            }
            if let Some(extra) = json.get("extra") {
                let Some(extra) = extra.as_array() else {
                    return Err(de::Error::custom("Extra isn't an array"));
                };
                if extra.is_empty() {
                    return Err(de::Error::custom("Unexpected empty array of components"));
                }
                for extra_component in extra {
                    let sibling =
                        FormattedText::deserialize(extra_component).map_err(de::Error::custom)?;
                    component.append(sibling);
                }
            }

            let style = Style::deserialize(&json);
            component.get_base_mut().style = style;

            return Ok(component);
        }
        // ok so it's not an object, if it's an array deserialize every item
        else if !json.is_array() {
            return Err(de::Error::custom(
                format!("Don't know how to turn {json} into a FormattedText").as_str(),
            ));
        }
        let json_array = json.as_array().unwrap();
        // the first item in the array is the one that we're gonna return, the others
        // are siblings
        let mut component =
            FormattedText::deserialize(&json_array[0]).map_err(de::Error::custom)?;
        for i in 1..json_array.len() {
            component.append(
                FormattedText::deserialize(json_array.get(i).unwrap())
                    .map_err(de::Error::custom)?,
            );
        }
        Ok(component)
    }
}

#[cfg(feature = "simdnbt")]
impl simdnbt::Serialize for FormattedText {
    fn to_compound(self) -> simdnbt::owned::NbtCompound {
        match self {
            FormattedText::Text(c) => c.to_compound(),
            FormattedText::Translatable(c) => c.to_compound(),
        }
    }
}

#[cfg(feature = "simdnbt")]
impl simdnbt::FromNbtTag for FormattedText {
    fn from_nbt_tag(tag: &simdnbt::borrow::NbtTag) -> Option<Self> {
        // we create a component that we might add siblings to
        let mut component: FormattedText;

        match tag {
            // if it's a string, return a text component with that string
            simdnbt::borrow::NbtTag::String(string) => {
                Some(FormattedText::Text(TextComponent::new(string.to_string())))
            }
            // if it's a compound, make it do things with { text } and stuff
            simdnbt::borrow::NbtTag::Compound(compound) => {
                if let Some(text) = compound.get("text") {
                    let text = text.string().unwrap_or_default().to_string();
                    component = FormattedText::Text(TextComponent::new(text));
                } else if let Some(translate) = compound.get("translate") {
                    let translate = translate.string()?.into();
                    if let Some(with) = compound.get("with") {
                        let with = with.list()?.compounds()?;
                        let mut with_array = Vec::with_capacity(with.len());
                        for item in with {
                            // if it's a string component with no styling and no siblings, just add
                            // a string to with_array otherwise add the
                            // component to the array
                            if let Some(primitive) = item.get("") {
                                // minecraft does this sometimes, for example
                                // for the /give system messages
                                match primitive {
                                    simdnbt::borrow::NbtTag::Byte(b) => {
                                        // interpreted as boolean
                                        with_array.push(StringOrComponent::String(
                                            if *b != 0 { "true" } else { "false" }.to_string(),
                                        ));
                                    }
                                    simdnbt::borrow::NbtTag::Short(s) => {
                                        with_array.push(StringOrComponent::String(s.to_string()));
                                    }
                                    simdnbt::borrow::NbtTag::Int(i) => {
                                        with_array.push(StringOrComponent::String(i.to_string()));
                                    }
                                    simdnbt::borrow::NbtTag::Long(l) => {
                                        with_array.push(StringOrComponent::String(l.to_string()));
                                    }
                                    simdnbt::borrow::NbtTag::Float(f) => {
                                        with_array.push(StringOrComponent::String(f.to_string()));
                                    }
                                    simdnbt::borrow::NbtTag::Double(d) => {
                                        with_array.push(StringOrComponent::String(d.to_string()));
                                    }
                                    simdnbt::borrow::NbtTag::String(s) => {
                                        with_array.push(StringOrComponent::String(s.to_string()));
                                    }
                                    _ => {
                                        warn!("couldn't parse {item:?} as FormattedText because it has a disallowed primitive");
                                        with_array.push(StringOrComponent::String("?".to_string()));
                                    }
                                }
                            } else if let Some(c) = FormattedText::from_nbt_tag(
                                &simdnbt::borrow::NbtTag::Compound(item.clone()),
                            ) {
                                if let FormattedText::Text(text_component) = c {
                                    if text_component.base.siblings.is_empty()
                                        && text_component.base.style.is_empty()
                                    {
                                        with_array
                                            .push(StringOrComponent::String(text_component.text));
                                        continue;
                                    }
                                }
                                with_array.push(StringOrComponent::FormattedText(
                                    FormattedText::from_nbt_tag(
                                        &simdnbt::borrow::NbtTag::Compound(item.clone()),
                                    )?,
                                ));
                            } else {
                                warn!("couldn't parse {item:?} as FormattedText");
                                with_array.push(StringOrComponent::String("?".to_string()));
                            }
                        }
                        component = FormattedText::Translatable(TranslatableComponent::new(
                            translate, with_array,
                        ));
                    } else {
                        // if it doesn't have a "with", just have the with_array be empty
                        component = FormattedText::Translatable(TranslatableComponent::new(
                            translate,
                            Vec::new(),
                        ));
                    }
                } else if let Some(score) = compound.compound("score") {
                    // object = GsonHelper.getAsJsonObject(jsonObject, "score");
                    if score.get("name").is_none() || score.get("objective").is_none() {
                        // A score component needs at least a name and an objective
                        trace!("A score component needs at least a name and an objective");
                        return None;
                    }
                    // TODO, score text components aren't yet supported
                    return None;
                } else if compound.get("selector").is_some() {
                    // selector text components aren't yet supported
                    trace!("selector text components aren't yet supported");
                    return None;
                } else if compound.get("keybind").is_some() {
                    // keybind text components aren't yet supported
                    trace!("keybind text components aren't yet supported");
                    return None;
                } else {
                    let Some(_nbt) = compound.get("nbt") else {
                        return None;
                    };
                    let _separator = FormattedText::parse_separator_nbt(compound)?;

                    let _interpret = match compound.get("interpret") {
                        Some(v) => v.byte().unwrap_or_default() != 0,
                        None => false,
                    };
                    if let Some(_block) = compound.get("block") {}
                    trace!("nbt text components aren't yet supported");
                    return None;
                }
                if let Some(extra) = compound.get("extra") {
                    let extra = extra.list()?.as_nbt_tags();
                    if extra.is_empty() {
                        // Unexpected empty array of components
                        return None;
                    }
                    for extra_component in extra {
                        let sibling = FormattedText::from_nbt_tag(&extra_component)?;
                        component.append(sibling);
                    }
                }

                let style = Style::from_compound(compound).ok()?;
                component.get_base_mut().style = style;

                Some(component)
            }
            // ok so it's not a compound, if it's a list deserialize every item
            simdnbt::borrow::NbtTag::List(list) => {
                let list = list.compounds()?;
                let mut component = FormattedText::from_nbt_tag(
                    &simdnbt::borrow::NbtTag::Compound(list.first()?.clone()),
                )?;
                for i in 1..list.len() {
                    component.append(FormattedText::from_nbt_tag(
                        &simdnbt::borrow::NbtTag::Compound(list.get(i)?.clone()),
                    )?);
                }
                Some(component)
            }
            _ => Some(FormattedText::Text(TextComponent::new("".to_owned()))),
        }
    }
}

#[cfg(feature = "azalea-buf")]
impl McBufReadable for FormattedText {
    fn read_from(buf: &mut std::io::Cursor<&[u8]>) -> Result<Self, BufReadError> {
        let nbt = simdnbt::borrow::NbtTag::read_optional(buf)?;
        if let Some(nbt) = nbt {
            FormattedText::from_nbt_tag(&nbt)
                .ok_or(BufReadError::Custom("couldn't read nbt".to_owned()))
        } else {
            Ok(FormattedText::default())
        }
    }
}

#[cfg(feature = "azalea-buf")]
#[cfg(feature = "simdnbt")]
impl McBufWritable for FormattedText {
    fn write_into(&self, buf: &mut impl std::io::Write) -> Result<(), std::io::Error> {
        let mut out = Vec::new();
        simdnbt::owned::BaseNbt::write_unnamed(&(self.clone().to_compound().into()), &mut out);
        buf.write_all(&out)
    }
}

impl From<String> for FormattedText {
    fn from(s: String) -> Self {
        FormattedText::Text(TextComponent {
            text: s,
            base: BaseComponent::default(),
        })
    }
}
impl From<&str> for FormattedText {
    fn from(s: &str) -> Self {
        Self::from(s.to_string())
    }
}

impl Display for FormattedText {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            FormattedText::Text(c) => c.fmt(f),
            FormattedText::Translatable(c) => c.fmt(f),
        }
    }
}

impl Default for FormattedText {
    fn default() -> Self {
        FormattedText::Text(TextComponent::default())
    }
}