Struct Reference 

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

Re-export core types for convenience. 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>) -> Reference

Create a local reference (no type qualifier).

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

Create a qualified reference with type name.

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

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<(), Error>

Formats the value using the given formatter.

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 StructuralPartialEq for Reference