Changelog

All notable changes to this project will be documented in this file.

[0.6.1] - 2026-10-02

wait_until() no longer includes None in the type of its result: it only returns once the condition returns a true value, so wait_until(lambda: next(iter(query.find_all()), None)) is now typed as Element instead of Element | None.

wait_until(), which waits for a condition on asynchronously changing UI state, and raises the new WaitTimeoutError if it isn’t met in time. Elements from tracking queries used in the condition don’t wait past its timeout.
Element.absolute_rect, the element’s position and size as a LogicalRect, both read from the same instance of the element.

AccessibleRole.WindowTitleBar, for the window-title-bar value of accessible-role in Slint 1.18 or newer. Previously, such elements reported AccessibleRole.Unknown.
Element.single_click() and Element.double_click() take an optional KeyboardModifiers, to hold Shift, Control, Alt, or Meta during the click. This needs Slint 1.19 or newer; older versions ignore the modifiers.

Breaking: ElementQuery.match_accessible_label() now requires an application built with Slint 1.19 or newer, which evaluates the match itself. A label query is now a single request, instead of one extra request per candidate element. With older Slint versions, running the query raises RequestError. Matching an empty label now only finds elements whose label is explicitly empty, not elements without one.

ElementQuery.tracking(): elements found by a tracking query run the query again every time they are used, and wait up to a timeout for it to match. They keep working when the UI replaces the element, for example when an if condition toggles, a popup is shown again, or a live preview reloads.
ElementQuery.find_one(), which returns the only match of a query and raises the new ElementLookupError if there are none or several.
ElementQuery.match_accessible_label(), to match elements by their accessible label.
Window.query_descendants(), a query over the whole window that looks up the window’s root element each time it runs.

Breaking: Errors reported by the application under test are no longer silently ignored. They now raise the new RequestError. For example, invoking an accessibility action on, or reading a property of, an Element that has since been removed from the UI used to do nothing or return a default value such as "", 0 or False; it now raises. Element.is_valid is unchanged and still returns False for such elements. Likewise, Window.grab_window_with_mime_type now raises instead of returning empty bytes when the application does not support the requested image format.

The ApplicationConnectionError raised when the application does not connect back in time now reports the actual launch_timeout instead of always saying 10 seconds.

New accessibility properties on Element: accessible_item_selectable, accessible_item_selected, accessible_item_count, accessible_item_index, accessible_orientation, and accessible_live_region.
New Orientation and AccessibleLiveness enums, for the values of the accessible-orientation and accessible-live-region properties in Slint.
New ApplicationConnectionError, raised when the application under test does not connect back within the launch timeout or the connection drops part-way through a request. These paths previously raised a plain Exception; it subclasses Exception, so an existing except Exception still catches it.

Breaking: Element.size/absolute_position now return LogicalSize/LogicalPosition and Window.size/position now return PhysicalSize/PhysicalPosition, instead of plain tuples. Tuple unpacking (width, height = element.size) still works, and the components are also available as .width/.height and .x/.y. But these are no longer tuples: comparing a logical to a physical value (e.g. element.size == window.size) is now False instead of a silent unit bug, and comparing against a plain tuple or indexing by position is no longer supported.
Breaking: LogicalPosition is now an immutable (frozen) dataclass; you can no longer assign to its fields.
The protobuf dependency moved from 5.28.1 to 7.35.1.
Regenerated the protocol bindings against slint commit 3f26906 ↗, which is now the minimum version your application must be built against.

New PointerEventButton values: Back, Forward, and Other.
New AccessibleRole landmark values: RadioGroup, Banner, Complementary, ContentInfo, Form, Main, Navigation, Region, and Search.