formualizer_eval/engine/
vertex.rs

1/// 🔮 Scalability Hook: Engine-internal vertex identity (opaque for future sharding support)
2#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq, PartialOrd, Ord)]
3pub struct VertexId(pub(crate) u32);
4
5impl VertexId {
6    pub(crate) fn new(id: u32) -> Self {
7        Self(id)
8    }
9
10    pub(crate) fn as_index(self) -> usize {
11        self.0 as usize
12    }
13
14    // 🔮 Scalability Hook: Future sharding support
15    #[allow(dead_code)]
16    fn shard_id(&self) -> u16 {
17        (self.0 >> 16) as u16
18    }
19
20    #[allow(dead_code)]
21    fn local_id(&self) -> u16 {
22        self.0 as u16
23    }
24}
25
26#[repr(u8)]
27#[derive(Debug, Clone, Copy, PartialEq, Eq)]
28pub enum VertexKind {
29    /// An implicitly created placeholder cell that has not been defined.
30    Empty = 0,
31
32    /// Cell with a literal value (value stored in arena/hashmap)
33    Cell = 1,
34
35    /// Formula that evaluates to a scalar (AST stored separately)
36    FormulaScalar = 2,
37
38    /// Formula that returns an array (AST stored separately)
39    FormulaArray = 3,
40
41    /// Infinite range placeholder (A:A, 1:1)
42    InfiniteRange = 4,
43
44    /// Range reference
45    Range = 5,
46
47    /// External reference
48    External = 6,
49}
50
51impl VertexKind {
52    #[inline]
53    pub fn from_tag(tag: u8) -> Self {
54        match tag {
55            0 => VertexKind::Empty,
56            1 => VertexKind::Cell,
57            2 => VertexKind::FormulaScalar,
58            3 => VertexKind::FormulaArray,
59            4 => VertexKind::InfiniteRange,
60            5 => VertexKind::Range,
61            6 => VertexKind::External,
62            _ => VertexKind::Empty,
63        }
64    }
65
66    #[inline]
67    pub fn to_tag(self) -> u8 {
68        self as u8
69    }
70}