Struct Node 

pub struct Node {

    pub id: String,
    pub parent_id: Option<String>,
    pub role: Role,
    pub name: String,
    pub description: Option<String>,
    pub value: Option<SemanticValueObservation>,
    pub state: Option<State>,
    pub extended: Option<BTreeMap<String, Value>>,
    pub actions: Option<Vec<Action>>,
    pub input_recipes: Option<Vec<PhysicalInputRecipe>>,
    pub labelled_by: Option<Vec<String>>,
    pub described_by: Option<Vec<String>>,
    pub text_ranges: Option<Vec<TextRange>>,
    pub test_id: Option<String>,
    pub framework_type: Option<String>,
    pub opaque_children: bool,
    pub p: Option<Provenance>,
    pub px: Option<BTreeMap<String, Provenance>>,
    pub geometry: NodeGeometryObservations,
    pub scroll: Option<Observation<ScrollState>>,
    pub painted_region: Option<Observation<SemanticPaintedRegion>>,
}

One accessible node with evidence-qualified geometry.

Fields

id: String

Stable identity within the session.

parent_id: Option<String>

Parent node, or None for a root.

role: Role

Semantic role from the current closed set.

name: String

Accessible name; empty when the node has none.

description: Option<String>

Longer description, when one exists.

value: Option<SemanticValueObservation>

Current value of a value-bearing node, without collapsing secrets.

state: Option<State>

Asserted state flags; unset members are not claims.

extended: Option<BTreeMap<String, Value>>

Application-defined JSON state, separate from portable state flags.

actions: Option<Vec<Action>>

Capability hints, never callback endpoints.

input_recipes: Option<Vec<PhysicalInputRecipe>>

Authoritative physical recipe executed only by Termwright devices.

labelled_by: Option<Vec<String>>

Ids of nodes that name this one.

described_by: Option<Vec<String>>

Ids of nodes that describe this one.

text_ranges: Option<Vec<TextRange>>

Offset-to-cell mapping for this node’s text.

test_id: Option<String>

Author-supplied test id.

framework_type: Option<String>

What the UI framework calls this widget. Required when role is Role::Generic: an unrecognised widget must at least name its own type, so a reader can tell one unknown thing from another.

opaque_children: bool

This node may own children the framework cannot enumerate.

p: Option<Provenance>

Where this node’s facts came from, as a whole.

px: Option<BTreeMap<String, Provenance>>

Where individual fields came from, when they differ from p.

geometry: NodeGeometryObservations

Qualified layout facts for this committed observation.

scroll: Option<Observation<ScrollState>>

Production application viewport state, not terminal scrollback.

painted_region: Option<Observation<SemanticPaintedRegion>>

Exact production-painted cells, distinct from layout and pointer ownership.

Implementations

impl Node

pub fn new(id: impl Into<String>, role: Role, name: impl Into<String>) -> Self

A node with only the required fields set.

pub fn with_framework_type(self, framework_type: impl Into<String>) -> Self

Name what the framework calls this widget, which the protocol requires for a Role::Generic node.

pub fn with_opaque_children(self) -> Self

Declare that this node may own children the probe cannot enumerate.

pub fn with_parent(self, parent_id: impl Into<String>) -> Self

Attach this node to a parent.

pub fn with_geometry(self, geometry: NodeGeometryObservations) -> Self

Set evidence-qualified layout facts.

pub fn with_state(self, state: State) -> Self

Set the state flags, dropping them when nothing is asserted.

pub fn with_extended(self, extended: BTreeMap<String, Value>) -> Self

Attach application-defined JSON state.

pub fn with_actions(self, actions: Vec<Action>) -> Self

Declare which actions the node supports.

pub fn with_test_id(self, test_id: impl Into<String>) -> Self

Set the author-supplied test id.

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 Eq for Node

impl PartialEq for Node

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

Equality operator ==.

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

Inequality operator !=.

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.

impl StructuralPartialEq for Node