Struct Node 

pub struct Node {
    pub id: u32,
    pub anchor: Name,
    pub value: Option<FieldPresence>,
    pub discriminator: Option<Name>,
    pub extra_fields: HashMap<String, Value>,
    pub position: Option<u32>,
    pub shape: NodeShape,
    pub annotations: HashMap<String, Value>,
}

A node in a W-type instance tree.

Each node is anchored to a schema vertex and carries optional value data, a discriminator (for union vertices), and extra fields for round-trip fidelity.

Fields

id: u32

Unique numeric identifier within the instance.

anchor: Name

The schema vertex this node is anchored to.

value: Option<FieldPresence>

The node’s value, if it is a leaf.

discriminator: Option<Name>

Discriminator for union-typed vertices (e.g., "$type" value).

extra_fields: HashMap<String, Value>

Extra fields preserved for round-trip fidelity.

position: Option<u32>

Position in an ordered collection (if any).

shape: NodeShape

Structural shape of the node, orthogonal to the schema anchor.

Defaults to NodeShape::Plain. Set to NodeShape::List, NodeShape::XmlElement, or NodeShape::XmlTextSegment by the CST extractors when they recover a list / aliased element / inline text run from a parsed document; consumed by the corresponding emitters to drive serialisation choices.

annotations: HashMap<String, Value>

Out-of-band annotations (metadata distinct from data).

Implementations

impl Node

pub fn new(id: u32, anchor: impl Into<Name>) -> Self

Create a new node with the given id and anchor vertex.

pub fn with_shape(self, shape: NodeShape) -> Self

Set the node’s structural shape.

pub const fn is_list(&self) -> bool

Returns true iff the node represents an ordered collection (the source of a free-monoid structure). Equivalent to matches!(self.shape, NodeShape::List).

pub const fn is_xml_text_segment(&self) -> bool

Returns true iff the node is an inline XML text segment.

pub const fn xml_tag(&self) -> Option<&Name>

Returns the original XML tag name when the node was produced by an aliased XML element; None otherwise.

pub fn with_value(self, value: FieldPresence) -> Self

Set the node’s value.

pub fn with_discriminator(self, disc: impl Into<Name>) -> Self

Set the node’s discriminator.

pub fn with_extra_field(self, key: impl Into<String>, value: Value) -> Self

Add an extra field for round-trip preservation.

pub fn has_value(&self) -> bool

Returns true if this node has a present value.

pub const fn is_leaf(&self) -> bool

Returns true if this node is a leaf (has a value or is null).

Trait Implementations

impl Clone for Node

fn clone(&self) -> Node

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Node

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Node

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Node

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

where __S: Serializer,

Serialize this value into the given Serde serializer.