Struct StructureAst 

pub struct StructureAst { /* private fields */ }

Arena-based structure AST.

Nodes are stored in a Vec indexed by NodeId. Insertion order is preserved for deterministic canonical rendering (Rev.1 M-1).

Implementations

impl StructureAst

pub fn new() -> Self

Create a new AST with an empty Sequence as root.

pub fn add_node(&mut self, kind: NodeKind) -> NodeId

Add a node to the arena and return its assigned NodeId.

pub fn get(&self, id: NodeId) -> Option<&StructureNode>

Get a reference to a node by ID.

pub fn get_mut(&mut self, id: NodeId) -> Option<&mut StructureNode>

Get a mutable reference to a node by ID.

pub fn remove(&mut self, id: NodeId) -> Option<StructureNode>

Remove a node from the arena, returning it if it existed.

pub fn root(&self) -> NodeId

Returns the root node ID.

pub fn set_root(&mut self, id: NodeId)

Set a new root node ID.

pub fn contains(&self, id: NodeId) -> bool

Check if a node exists in the arena.

pub fn len(&self) -> usize

Returns the count of live (non-removed) nodes.

pub fn is_empty(&self) -> bool

Returns true if the arena has no live nodes.

pub fn iter(&self) -> impl Iterator<Item = &StructureNode>

Iterate over all live nodes in arena order.

pub fn next_id(&self) -> u64

Returns the next ID that will be assigned.

pub fn arena_raw(&self) -> &[Option<StructureNode>]

Returns a raw view of the arena including tombstone (None) slots.

Used by serialization layers that need lossless arena snapshots.

pub fn from_raw_parts( root: NodeId, arena: Vec<Option<StructureNode>>, next_id: u64, ) -> Self

Reconstruct a StructureAst from raw parts.

Used by deserialization layers for lossless arena restoration. The caller must ensure arena consistency (IDs match indices, etc.).

Trait Implementations

impl Clone for StructureAst

fn clone(&self) -> StructureAst

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StructureAst

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

Formats the value using the given formatter.

impl Default for StructureAst

fn default() -> Self

Returns the “default value” for a type.