Plushie.Automation.Element (Plushie v0.6.0)

Represents a widget element found in the UI tree during automation.

Created by find/2 and used for scoped assertions, automation flows, and runtime inspection. Contains the widget's ID, type, props, and children.

Summary

t()

a11y(element)

Returns the a11y props map from the element, or nil if not set.

from_node(node)

Creates an Element from a ui_node map (%{id, type, props, children}).

Returns the inferred accessibility role for this element.

text(element)

Extracts text content from an element.

@type t() :: %Plushie.Automation.Element{
  children: [t()],
  id: String.t(),
  props: map(),
  type: String.t()
}

@spec from_node(node :: map()) :: t()

Creates an Element from a ui_node map (%{id, type, props, children}).

@spec inferred_role(element :: t()) :: String.t()

Returns the inferred accessibility role for this element.

Mirrors the renderer-side role mapping in plushie_ext::widgets::a11y. If the element has an explicit a11y role override, that takes precedence.

@spec text(element :: t()) :: String.t() | nil

Extracts text content from an element.

Checks props in order: "content", "label", "value", "placeholder". Returns nil if no text prop is found.