lumen_engine/node/

deferred.rs

use crate::expr::Expression;

use super::{
    delegate::{DelegateEvalContext, DelegateEvaluable, DelegateValue, Delegated},
    ids::NodeId,
    property::{PropertyExpression, PropertyValue},
    vector,
};

#[derive(Debug, Clone)]
pub enum Deferred<T> {
    Value(T),
    Expr(Expression),
}

impl<T> Deferred<T> {
    pub fn value(value: T) -> Self {
        Self::Value(value)
    }

    pub fn eval(
        &self,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<T>
    where
        T: DeferredValue,
    {
        T::eval_deferred(self, node_id, property_path, ctx)
    }

    pub fn to_property_value(&self) -> PropertyValue
    where
        T: DeferredValue,
    {
        match self {
            Self::Value(value) => T::to_property_value(value),
            Self::Expr(_) => {
                panic!(
                    "Deferred::to_property_value called on expression; use to_property_expression"
                )
            }
        }
    }

    pub fn to_property_expression(&self) -> PropertyExpression
    where
        T: DeferredValue,
    {
        match self {
            Self::Value(value) => PropertyExpression::Value(T::to_property_value(value)),
            Self::Expr(expr) => PropertyExpression::Expr(expr.clone()),
        }
    }

    pub fn from_property_expression(value: PropertyExpression) -> crate::Result<Self>
    where
        T: DeferredValue,
    {
        match value {
            PropertyExpression::Value(value) => T::from_property_value(value)
                .map(Self::Value)
                .ok_or_else(|| {
                    PropertyValue::invalid_type(
                        NodeId::new(0),
                        "",
                        T::property_kind_name(),
                        "property",
                    )
                }),
            PropertyExpression::Expr(expr) => Ok(Self::Expr(expr)),
        }
    }
}

impl<T> From<T> for Deferred<T> {
    fn from(value: T) -> Self {
        Self::Value(value)
    }
}

impl Deferred<f64> {
    pub fn resolve_float(
        &self,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<f64> {
        self.eval(node_id, property_path, ctx)
    }
}

impl Deferred<i64> {
    pub fn resolve_int(
        &self,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<i64> {
        self.eval(node_id, property_path, ctx)
    }

    pub fn resolve_float(
        &self,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<f64> {
        self.eval(node_id, property_path, ctx)
            .map(|value| value as f64)
    }
}

impl Deferred<bool> {
    pub fn resolve_bool(
        &self,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<bool> {
        self.eval(node_id, property_path, ctx)
    }
}

impl Deferred<String> {
    pub fn resolve_string(
        &self,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<String> {
        self.eval(node_id, property_path, ctx)
    }
}

impl Deferred<[u8; 4]> {
    pub fn resolve_color(
        &self,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<[u8; 4]> {
        self.eval(node_id, property_path, ctx)
    }
}

impl Deferred<vector::paint::Paint> {
    pub fn resolve_paint(
        &self,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<vector::paint::Paint> {
        self.eval(node_id, property_path, ctx)
    }
}

impl Deferred<(f64, f64)> {
    pub fn resolve_vec2(
        &self,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<(f64, f64)> {
        self.eval(node_id, property_path, ctx)
    }
}

#[cfg(feature = "json")]
impl<'de, T> serde::Deserialize<'de> for Deferred<T>
where
    T: DeferredJsonValue,
{
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: serde::Deserializer<'de>,
    {
        let value = serde_json::Value::deserialize(deserializer)?;
        if let Some(text) = value.as_str()
            && let Some(source) = text.strip_prefix('=')
        {
            return Expression::parse(source)
                .map(Self::Expr)
                .map_err(serde::de::Error::custom);
        }
        T::from_json_value(&value)
            .map(Self::Value)
            .map_err(serde::de::Error::custom)
    }
}

#[cfg(feature = "json")]
pub trait DeferredJsonValue: Sized {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String>;
}

pub trait DeferredValue: Clone {
    fn eval_deferred(
        deferred: &Deferred<Self>,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<Self>
    where
        Self: Sized;

    fn to_property_value(value: &Self) -> PropertyValue;
    fn from_property_value(value: PropertyValue) -> Option<Self>
    where
        Self: Sized;
    fn property_kind_name() -> &'static str;
}

impl<T> DelegateEvaluable for Deferred<T>
where
    T: DeferredValue,
{
    type Evaluated = T;

    fn eval(&self, ctx: &DelegateEvalContext<'_>) -> crate::Result<Self::Evaluated> {
        Deferred::eval(self, ctx.node_id, ctx.property_path, ctx.expr)
    }
}

impl<T> DelegateValue for Deferred<T>
where
    T: DeferredValue,
{
    fn to_property_value(&self) -> PropertyValue {
        Deferred::to_property_value(self)
    }

    fn to_property_expression(&self) -> PropertyExpression {
        Deferred::to_property_expression(self)
    }

    fn from_property_expression(value: PropertyExpression) -> crate::Result<Self> {
        Deferred::from_property_expression(value)
    }
}

macro_rules! impl_delegated_deferred {
    ($($ty:ty),* $(,)?) => {
        $(
            impl Delegated for $ty {
                type Delegate = Deferred<$ty>;

                fn into_delegate(self) -> Self::Delegate {
                    Deferred::value(self)
                }
            }
        )*
    };
}

impl_delegated_deferred!(
    f64,
    f32,
    i64,
    u32,
    u8,
    bool,
    String,
    [u8; 4],
    (f64, f64),
    [f32; 2]
);

macro_rules! impl_deferred_float_expr {
    ($ty:ty, $conv:expr) => {
        impl DeferredValue for $ty {
            fn eval_deferred(
                deferred: &Deferred<Self>,
                node_id: NodeId,
                property_path: &str,
                ctx: &crate::expr::ExpressionContext<'_>,
            ) -> crate::Result<Self> {
                match deferred {
                    Deferred::Value(value) => Ok(*value),
                    Deferred::Expr(expr) => {
                        expr.evaluate(ctx)?.as_f64().map($conv).ok_or_else(|| {
                            PropertyValue::invalid_type(
                                node_id,
                                property_path,
                                "Float",
                                "expression",
                            )
                        })
                    }
                }
            }

            fn to_property_value(value: &Self) -> PropertyValue {
                PropertyValue::Float(f64::from(*value))
            }

            fn from_property_value(value: PropertyValue) -> Option<Self> {
                value.coerce_float().map($conv)
            }

            fn property_kind_name() -> &'static str {
                "Float"
            }
        }
    };
}

impl_deferred_float_expr!(f64, |value: f64| value);

impl DeferredValue for f32 {
    fn eval_deferred(
        deferred: &Deferred<Self>,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<Self> {
        match deferred {
            Deferred::Value(value) => Ok(*value),
            Deferred::Expr(expr) => expr
                .evaluate(ctx)?
                .as_f64()
                .map(|value| value as f32)
                .ok_or_else(|| {
                    PropertyValue::invalid_type(node_id, property_path, "Float", "expression")
                }),
        }
    }

    fn to_property_value(value: &Self) -> PropertyValue {
        PropertyValue::Float(f64::from(*value))
    }

    fn from_property_value(value: PropertyValue) -> Option<Self> {
        value.coerce_float().map(|value| value as f32)
    }

    fn property_kind_name() -> &'static str {
        "Float"
    }
}

impl DeferredValue for i64 {
    fn eval_deferred(
        deferred: &Deferred<Self>,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<Self> {
        match deferred {
            Deferred::Value(value) => Ok(*value),
            Deferred::Expr(expr) => {
                let value = expr.evaluate(ctx)?.as_f64().ok_or_else(|| {
                    PropertyValue::invalid_type(node_id, property_path, "Int", "expression")
                })?;
                Ok(value as i64)
            }
        }
    }

    fn to_property_value(value: &Self) -> PropertyValue {
        PropertyValue::Int(*value)
    }

    fn from_property_value(value: PropertyValue) -> Option<Self> {
        value.coerce_int()
    }

    fn property_kind_name() -> &'static str {
        "Int"
    }
}

impl DeferredValue for u32 {
    fn eval_deferred(
        deferred: &Deferred<Self>,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<Self> {
        let value = match deferred {
            Deferred::Value(value) => i64::from(*value),
            Deferred::Expr(expr) => expr.evaluate(ctx)?.as_f64().ok_or_else(|| {
                PropertyValue::invalid_type(node_id, property_path, "UInt", "expression")
            })? as i64,
        };
        u32::try_from(value)
            .map_err(|_| PropertyValue::invalid_type(node_id, property_path, "UInt", "range"))
    }

    fn to_property_value(value: &Self) -> PropertyValue {
        PropertyValue::Int(i64::from(*value))
    }

    fn from_property_value(value: PropertyValue) -> Option<Self> {
        value
            .coerce_int()
            .and_then(|value| u32::try_from(value).ok())
    }

    fn property_kind_name() -> &'static str {
        "UInt"
    }
}

impl DeferredValue for u8 {
    fn eval_deferred(
        deferred: &Deferred<Self>,
        node_id: NodeId,
        property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<Self> {
        let value = match deferred {
            Deferred::Value(value) => i64::from(*value),
            Deferred::Expr(expr) => expr.evaluate(ctx)?.as_f64().ok_or_else(|| {
                PropertyValue::invalid_type(node_id, property_path, "Int", "expression")
            })? as i64,
        };
        u8::try_from(value)
            .map_err(|_| PropertyValue::invalid_type(node_id, property_path, "U8", "range"))
    }

    fn to_property_value(value: &Self) -> PropertyValue {
        PropertyValue::Int(i64::from(*value))
    }

    fn from_property_value(value: PropertyValue) -> Option<Self> {
        value
            .coerce_int()
            .and_then(|value| u8::try_from(value).ok())
    }

    fn property_kind_name() -> &'static str {
        "U8"
    }
}

impl DeferredValue for bool {
    fn eval_deferred(
        deferred: &Deferred<Self>,
        _node_id: NodeId,
        _property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<Self> {
        match deferred {
            Deferred::Value(value) => Ok(*value),
            Deferred::Expr(expr) => Ok(expr.evaluate(ctx)?.as_bool()),
        }
    }

    fn to_property_value(value: &Self) -> PropertyValue {
        PropertyValue::Bool(*value)
    }

    fn from_property_value(value: PropertyValue) -> Option<Self> {
        value.coerce_bool()
    }

    fn property_kind_name() -> &'static str {
        "Bool"
    }
}

impl DeferredValue for String {
    fn eval_deferred(
        deferred: &Deferred<Self>,
        _node_id: NodeId,
        _property_path: &str,
        ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<Self> {
        match deferred {
            Deferred::Value(value) => Ok(value.clone()),
            Deferred::Expr(expr) => Ok(expr.evaluate(ctx)?.as_string()),
        }
    }

    fn to_property_value(value: &Self) -> PropertyValue {
        PropertyValue::String(value.clone())
    }

    fn from_property_value(value: PropertyValue) -> Option<Self> {
        value.coerce_string()
    }

    fn property_kind_name() -> &'static str {
        "String"
    }
}

macro_rules! impl_deferred_literal {
    ($ty:ty, $kind:literal, $variant:ident, $expr_err:literal) => {
        impl DeferredValue for $ty {
            fn eval_deferred(
                deferred: &Deferred<Self>,
                node_id: NodeId,
                property_path: &str,
                _ctx: &crate::expr::ExpressionContext<'_>,
            ) -> crate::Result<Self> {
                match deferred {
                    Deferred::Value(value) => Ok(*value),
                    Deferred::Expr(_) => Err(PropertyValue::invalid_type(
                        node_id,
                        property_path,
                        $expr_err,
                        "expression",
                    )),
                }
            }

            fn to_property_value(value: &Self) -> PropertyValue {
                PropertyValue::$variant(*value)
            }

            fn from_property_value(value: PropertyValue) -> Option<Self> {
                match value {
                    PropertyValue::$variant(value) => Some(value),
                    _ => None,
                }
            }

            fn property_kind_name() -> &'static str {
                $kind
            }
        }
    };
}

impl_deferred_literal!([u8; 4], "Color", Color, "Color");

impl DeferredValue for vector::paint::Paint {
    fn eval_deferred(
        deferred: &Deferred<Self>,
        node_id: NodeId,
        property_path: &str,
        _ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<Self> {
        match deferred {
            Deferred::Value(value) => Ok(value.clone()),
            Deferred::Expr(_) => Err(PropertyValue::invalid_type(
                node_id,
                property_path,
                "Paint",
                "expression",
            )),
        }
    }

    fn to_property_value(value: &Self) -> PropertyValue {
        PropertyValue::Paint(value.clone())
    }

    fn from_property_value(value: PropertyValue) -> Option<Self> {
        match value {
            PropertyValue::Paint(value) => Some(value),
            PropertyValue::Color(value) => Some(vector::paint::Paint::solid(value)),
            _ => None,
        }
    }

    fn property_kind_name() -> &'static str {
        "Paint"
    }
}

impl_deferred_literal!((f64, f64), "Vec2", Vec2, "Vec2");

impl DeferredValue for [f32; 2] {
    fn eval_deferred(
        deferred: &Deferred<Self>,
        node_id: NodeId,
        property_path: &str,
        _ctx: &crate::expr::ExpressionContext<'_>,
    ) -> crate::Result<Self> {
        match deferred {
            Deferred::Value(value) => Ok(*value),
            Deferred::Expr(_) => Err(PropertyValue::invalid_type(
                node_id,
                property_path,
                "Vec2",
                "expression",
            )),
        }
    }

    fn to_property_value(value: &Self) -> PropertyValue {
        PropertyValue::Vec2((f64::from(value[0]), f64::from(value[1])))
    }

    fn from_property_value(value: PropertyValue) -> Option<Self> {
        match value {
            PropertyValue::Vec2((x, y)) => Some([x as f32, y as f32]),
            _ => None,
        }
    }

    fn property_kind_name() -> &'static str {
        "Vec2"
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for f64 {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        value
            .as_f64()
            .or_else(|| value.as_i64().map(|value| value as f64))
            .ok_or_else(|| "expected float".to_string())
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for f32 {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        f64::from_json_value(value).map(|value| value as f32)
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for i64 {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        value
            .as_i64()
            .or_else(|| value.as_f64().map(|value| value as i64))
            .ok_or_else(|| "expected int".to_string())
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for u8 {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        let value = i64::from_json_value(value)?;
        u8::try_from(value).map_err(|_| "expected u8".to_string())
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for u32 {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        let value = i64::from_json_value(value)?;
        u32::try_from(value).map_err(|_| "expected u32".to_string())
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for bool {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        value
            .as_bool()
            .or_else(|| value.as_i64().map(|value| value != 0))
            .ok_or_else(|| "expected bool".to_string())
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for String {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        value
            .as_str()
            .map(ToString::to_string)
            .ok_or_else(|| "expected string".to_string())
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for [u8; 4] {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        crate::json::parse_color(value).ok_or_else(|| "expected color".to_string())
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for vector::paint::Paint {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        vector::paint::Paint::from_json_value(value).ok_or_else(|| "expected paint".to_string())
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for (f64, f64) {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        let values = value
            .as_array()
            .ok_or_else(|| "expected vec2".to_string())?;
        if values.len() != 2 {
            return Err(format!(
                "expected vec2, got array of length {}",
                values.len()
            ));
        }
        let x = values[0]
            .as_f64()
            .ok_or_else(|| "expected vec2 x number".to_string())?;
        let y = values[1]
            .as_f64()
            .ok_or_else(|| "expected vec2 y number".to_string())?;
        Ok((x, y))
    }
}

#[cfg(feature = "json")]
impl DeferredJsonValue for [f32; 2] {
    fn from_json_value(value: &serde_json::Value) -> Result<Self, String> {
        let (x, y) = <(f64, f64)>::from_json_value(value)?;
        Ok([x as f32, y as f32])
    }
}