Changelog

v0.0.5 (Apr 20, 2026)

:count option for assert_has: assert exact number of matching elements (e.g. assert_has(session, "li", count: 3)).
:label option for assert_has and refute_has: filter elements by their associated <label> text (e.g. assert_has(session, "input", label: "Email", value: "foo@bar.com")).
click/click_button now finds submit buttons outside a <form> that reference it via the HTML form attribute.
open_browser now centres mounted components by default. Disable per-call with open_browser(session, wrap: false) or globally with config :mirage, open_browser: [wrap: false].

assert_page/3 — optional keyword list of expected params to assert against after navigation.

mount/2 redesigned around ~HOLO templates. Props, cid, and slot content are declared in markup; context is the only argument to mount. Accepts a single {Namespace, key: value} tuple or a list of tuples for multiple namespaces.
visit/2 now takes a keyword list instead of a map.

:at option for assert_has and refute_has — match by 1-based position among all elements matching the selector.
Option validation — all functions that accept options now raise ArgumentError for unknown keys (via Keyword.validate!/2).
open_browser/1 wraps mounted components in a bare HTML layout with your app's stylesheets.

mount/4 — mount a component in isolation for testing, without a page or layout. Accepts :props and :context options; context values populate from_context props.
reload/1 — revisit the current page with the current params, resetting all client-side state.
within_section/4 — accepts an optional CSS selector argument to scope to elements other than <section> (e.g. div[role=article]).
Target support — event attributes with target: "cid" now dispatch actions and commands to stateful child components identified by their cid.

fill_in, choose, check, uncheck, select, and select_text now raise when the matched input is hidden (hidden attribute or type="hidden"), disabled, or readonly.

Initial release.