Struct SemanticTree 

pub struct SemanticTree { /* private fields */ }

The retained accessibility tree. Persists node identity across frames and diffs each refresh against the previous.

Implementations

impl SemanticTree

pub fn new() -> SemanticTree

pub fn refresh( &mut self, root: &dyn Widget, node_map: &HashMap<NodeId, *mut dyn Widget>, focused: Option<NodeId>, resources: &[Resource], ) -> TreeDelta

Rebuild the tree from the live UI and diff it against the retained frame.

node_map is used read-only (never dereferenced) to assign each widget its stable id. Ambiguous registrations remain structural and receive no layout dispatch id. focused folds into each node’s AccessState::focused. resources is the focused app’s open-resource forest ([Widget::resources]); each exported ActionSpec becomes an invokable affordance.

pub fn root(&self) -> &SemanticId

pub fn node(&self, id: &SemanticId) -> Option<&SemanticNode>

pub fn len(&self) -> usize

Includes the root.

pub fn is_empty(&self) -> bool

Whether the tree holds only the root.

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

Stable DFS reading order.

pub fn duplicate_ids(&self) -> &[SemanticId]

Duplicate durable keys are never silently accepted as stable identity.

pub fn find_by_name(&self, name: &str) -> Option<&SemanticNode>

The first node whose accessible name equals name, in reading order — the ergonomic handle for a CLI / agent that addresses elements by label (“focus the node called ‘Volume’”).

pub fn control_paths(&self, control_id: &str) -> Vec<Vec<SemanticId>>

Every live semantic path to a control binding id, shortest first. Multiple buttons may intentionally bind the same domain action; this gives agents and presence projection a deterministic way to prefer the nearest currently rendered affordance without replacing direct action invocation with simulated clicks.

pub fn action(&self, id: &SemanticId, name: &str) -> Option<&SemanticAction>

pub fn build_prompted( &self, id: &SemanticId, name: &str, arg: &str, ) -> Option<EncodedAction>

None if (id, name) is not a prompted action.

Trait Implementations

impl Default for SemanticTree

fn default() -> SemanticTree

Returns the “default value” for a type.