Struct SurfaceNode 

pub struct SurfaceNode {
    pub component_type: String,
    pub props: BTreeMap<String, PropValue>,
    pub children: Vec<SurfaceNode>,
}

A single node in the abstract UI tree.

Matches the JSON schema from host-integration.md:

{
  "type": "Column",
  "props": { "spacing": 8 },
  "children": [ ... ]
}

Props use BTreeMap for deterministic serialization order.

Fields

component_type: String

Component type name (e.g., “Column”, “Text”, “Button”).

props: BTreeMap<String, PropValue>

Component properties. Uses BTreeMap for deterministic key ordering.

children: Vec<SurfaceNode>

Child nodes (empty for leaf components like Text, Button).

Implementations

impl SurfaceNode

pub fn new(component_type: impl Into<String>) -> Self

Create a new node with the given component type and no props or children.

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

Builder: add a prop.

pub fn with_child(self, child: SurfaceNode) -> Self

Builder: add a child node.

pub fn with_children(self, children: Vec<SurfaceNode>) -> Self

Builder: set children.

pub fn set_prop(&mut self, key: impl Into<String>, value: PropValue)

Add a prop (mutable).

pub fn add_child(&mut self, child: SurfaceNode)

Add a child (mutable).

Trait Implementations

impl Clone for SurfaceNode

fn clone(&self) -> SurfaceNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SurfaceNode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SurfaceNode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SurfaceNode

fn eq(&self, other: &SurfaceNode) -> 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 SurfaceNode

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 SurfaceNode