Changelog

v0.5.0 (Apr 26, 2026)

visit now takes a %Hologram.Session{} as its first arg. This allows for setting cookie and session data.

use Mirage.Page — extension module that imports Mirage and sets up an ExUnit setup block providing %{server: %Hologram.Server{}} in test context.
use Mirage.Component — extension module that imports Mirage and sigil_HOLO for component-level tests.
Init lifecycle drain — visit/3 now drains next_command, next_action (recursive), and next_page set during init/3, matching Hologram's runtime behaviour.
fill_in_hidden/3 — fill in a hidden input by its name attribute. Validates the input is actually hidden and not disabled or readonly. Triggers $change on both the input and its enclosing form.

Server state now persists across client-side navigation (link clicks and action redirects no longer reset the server).
Shorthand event syntax now supports target: option (e.g. $click={:my_action, target: "cid"}).

assert_has and refute_has now trim whitespace (including newlines) when comparing :text and :value options.

Form-level $change now receives all named field values in the event data, matching Hologram's runtime behaviour.
Form $submit now includes all named field values in the event data (e.g. hidden inputs, filled text fields, checked radios).
open_browser's :wrap is now used to control the minimal layout wrapped around components. :center is now used to center the component in the viewport.

filled_inputs bookkeeping — tracks values set via fill_in so form data collection works even for inputs without a value binding in the template.

: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.