Struct Reference 

pub struct Reference {
    pub type_name: Option<Box<str>>,
    pub id: Box<str>,
}

A reference to another node.

Optimized memory layout:

• 16 bytes on 64-bit systems (without heap allocation for short IDs)
• Type names are interned during parsing to reduce duplication
• Uses Box<str> to minimize heap overhead compared to String

Fields

type_name: Option<Box<str>>

Optional type qualifier (e.g., “User” in “@User:id”). Boxed to reduce size when None (common case).

id: Box<str>

The ID being referenced. Uses Box<str> for compact representation (16 bytes vs 24 for String).

Implementations

impl Reference

pub fn local(id: impl Into<String>) -> Self

Create a local reference (no type qualifier).

pub fn qualified(type_name: impl Into<String>, id: impl Into<String>) -> Self

Create a qualified reference with type name.

pub fn unqualified(id: impl Into<String>) -> Self

Create an unqualified reference (alias for local).

An unqualified reference has no type qualifier and will be resolved based on context (current type in matrix lists, or global search with ambiguity detection in key-value context).

pub fn to_ref_string(&self) -> String

Format as a reference string (with @).

Trait Implementations

impl Clone for Reference

fn clone(&self) -> Reference

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Reference

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Reference

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Reference

fn eq(&self, other: &Reference) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Reference

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Reference