Control finder

Fluent API for building complex control queries.

using Avalonia.HeadlessTestingFramework;

// Basic usage
var buttons = ControlFinder.From(window)
    .OfType<Button>()
    .FindAll();

// Complex query
var results = ControlFinder.From(window)
    .InVisualTree()           // or .InLogicalTree()
    .IncludeSelf()
    .MaxDepth(5)
    .OfType<Button>()
    .WithNameStartingWith("btn_")
    .Where<Button>(b => b.IsEnabled)
    .Skip(2)
    .Take(5)
    .FindAll();

// Find single element
Button? button = ControlFinder.From(window)
    .OfType<Button>()
    .WithName("submit")
    .FindFirst<Button>();

// Filter by property
var visibleButtons = ControlFinder.From(window)
    .OfType<Button>()
    .WithProperty(Visual.IsVisibleProperty, true)
    .FindAll();

// Filter by class/style
var primaryButtons = ControlFinder.From(window)
    .OfType<Button>()
    .WithClass("primary")
    .FindAll();

// Filter by automation ID
var loginBtn = ControlFinder.From(window)
    .Where<Control>(c => AutomationProperties.GetAutomationId(c) == "login_button")
    .FindFirst();

// Check existence
bool hasErrors = ControlFinder.From(form)
    .OfType<TextBlock>()
    .WithClass("error")
    .Any();

// Count matching
int buttonCount = ControlFinder.From(toolbar)
    .OfType<Button>()
    .Count();