1
use crate::ast::serde::{AsId, HasId};
2
use crate::{ast::DeclarationPtr, bug};
3
use derivative::Derivative;
4
use parking_lot::MappedRwLockReadGuard;
5
use serde::{Deserialize, Serialize};
6
use serde_with::serde_as;
7
use std::fmt::{Display, Formatter};
8
use uniplate::Uniplate;
9

            
10
use super::{
11
    Atom, DeclarationKind, DomainPtr, Expression, GroundDomain, Literal, Metadata, Moo, Name,
12
    categories::{Category, CategoryOf},
13
    domains::HasDomain,
14
};
15

            
16
/// A reference to a declaration (variable, parameter, etc.)
17
///
18
/// This is a thin wrapper around [`DeclarationPtr`] with two main purposes:
19
/// 1. Encapsulate the serde pragmas (e.g., serializing as IDs rather than full objects)
20
/// 2. Enable type-directed traversals of references via uniplate
21
#[serde_as]
22
#[derive(
23
    Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize, Uniplate, Derivative,
24
)]
25
#[derivative(Hash)]
26
#[uniplate()]
27
#[biplate(to=DeclarationPtr)]
28
#[biplate(to=Name)]
29
pub struct Reference {
30
    #[serde_as(as = "AsId")]
31
    pub ptr: DeclarationPtr,
32
}
33

            
34
impl Reference {
35
358214
    pub fn new(ptr: DeclarationPtr) -> Self {
36
358214
        Reference { ptr }
37
358214
    }
38

            
39
5199114
    pub fn ptr(&self) -> &DeclarationPtr {
40
5199114
        &self.ptr
41
5199114
    }
42

            
43
260
    pub fn into_ptr(self) -> DeclarationPtr {
44
260
        self.ptr
45
260
    }
46

            
47
29259744
    pub fn name(&self) -> MappedRwLockReadGuard<'_, Name> {
48
29259744
        self.ptr.name()
49
29259744
    }
50

            
51
1760
    pub fn id(&self) -> crate::ast::serde::ObjId {
52
1760
        self.ptr.id()
53
1760
    }
54

            
55
906804
    pub fn domain(&self) -> Option<DomainPtr> {
56
906804
        self.ptr.domain()
57
906804
    }
58

            
59
893140
    pub fn resolved_domain(&self) -> Option<Moo<GroundDomain>> {
60
893140
        self.domain()?.resolve()
61
893140
    }
62

            
63
    /// Returns the expression behind a value-letting reference, if this is one.
64
4552702
    pub fn resolve_expression(&self) -> Option<Expression> {
65
4552702
        if let Some(expr) = self.ptr().as_value_letting() {
66
538518
            return Some(expr.clone());
67
4014184
        }
68

            
69
4014184
        let generator = {
70
4014184
            let kind = self.ptr.kind();
71
4014184
            if let DeclarationKind::Quantified(inner) = &*kind {
72
59700
                inner.generator().cloned()
73
            } else {
74
3954484
                None
75
            }
76
        };
77

            
78
4014184
        if let Some(generator) = generator
79
40
            && let Some(expr) = generator.as_value_letting()
80
        {
81
            return Some(expr.clone());
82
4014184
        }
83

            
84
4014184
        None
85
4552702
    }
86

            
87
    /// Evaluates this reference to a literal if it resolves to a constant.
88
4486046
    pub fn resolve_constant(&self) -> Option<Literal> {
89
4486046
        self.resolve_expression()
90
4486046
            .and_then(|expr| super::eval::eval_constant(&expr))
91
4486046
    }
92

            
93
    /// Resolves this reference to an atomic expression, if possible.
94
66656
    pub fn resolve_atomic(&self) -> Option<Atom> {
95
66656
        self.resolve_expression().and_then(|expr| match expr {
96
            Expression::Atomic(_, atom) => Some(atom),
97
            _ => None,
98
        })
99
66656
    }
100
}
101

            
102
impl From<Reference> for Expression {
103
180
    fn from(value: Reference) -> Self {
104
180
        Expression::Atomic(Metadata::new(), value.into())
105
180
    }
106
}
107

            
108
impl From<DeclarationPtr> for Reference {
109
    fn from(ptr: DeclarationPtr) -> Self {
110
        Reference::new(ptr)
111
    }
112
}
113

            
114
impl CategoryOf for Reference {
115
616032
    fn category_of(&self) -> Category {
116
616032
        self.ptr.category_of()
117
616032
    }
118
}
119

            
120
impl HasDomain for Reference {
121
528206
    fn domain_of(&self) -> DomainPtr {
122
528206
        self.ptr.domain().unwrap_or_else(|| {
123
            bug!(
124
                "reference ({name}) should have a domain",
125
                name = self.ptr.name()
126
            )
127
        })
128
528206
    }
129
}
130

            
131
impl Display for Reference {
132
401913954
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
133
401913954
        self.ptr.name().fmt(f)
134
401913954
    }
135
}