@spec message(atom(), map()) :: String.t()

Resolves key (with bindings) to English text.

Keys

• :search_placeholder — placeholder text for the search input.
• :loading — shown in the listbox while a search is in flight.
• :no_results — shown when a search returns no results.
• :error — shown when the provider returns an error.
• :keep_typing — shown when more results exist than are displayed (limit+1 came back) — "keep typing to narrow" rather than paginate.
• :min_chars_hint — %{min_chars: n} — shown while the typed text is shorter than the configured min_chars.
• :invalid_<reason> — one per validation reason a facet value can fail with (Spec 018, ADR-012): :invalid_integer, :invalid_float, :invalid_boolean, :invalid_date, :invalid_datetime, :invalid_duration, :invalid_range, :invalid_incomplete_range, :invalid_reversed_range, :invalid_incomplete_list, :invalid_not_in_values (%{values: [...]}), :invalid_out_of_bounds (%{min:, max:}), :invalid_constraint_violation (%{message:}), :invalid_custom (%{message:}), and :invalid_value as the catch-all for a reason this module doesn't know. Rendered against the invalid facet pill; the parser itself never produces English.
• :dispatch_blocked — shown, and announced, when on_invalid: :require is withholding the query because a facet value is invalid (Spec 023).
• :did_you_mean — %{label: name} — the top correction suggestion.
• :apply_fix — the accept affordance for a mechanical fix (a reversed range's swap, an out-of-bounds clamp).
• :invalid_facet — %{key: key} — the accessible name for an invalid facet pill.
• :edit_facet — %{label: name} — aria-label for the control that reopens a committed facet's editor (Spec 019).
• :facet_editor_opened — %{label: name} — the live-region announcement when a facet editor's pop-out opens (Spec 019), naming the facet and the fact that it is a dialog, since entering a modal sub-context must be audible and not merely visible.
• :close_facet_editor, :preset_group_suggested, :previous_month, :next_month, :range_from, :range_to, :facet_values, :facet_editor_done, :pick_an_end_date — every visible string inside a Spec 019 facet editor. Routed through here rather than hardcoded so the key list stays the complete, auditable inventory of user-facing text (ADR-009, and Spec 007's "a grep for literals in templates finds none").
• :active_filters — aria-label for the committed-facet pill row in Flicker.select/1 (Spec 015), naming it as filters rather than as the selection chips beside it.
• :press_enter_to_search — shown, and referenced by the input's aria-describedby, while dispatch: :enter holds typed text that hasn't been searched yet (Spec 020). A search box that has silently stopped searching is a broken search box, so this state is always both visible and announced.
• :results_count — %{count: n} — the live-region announcement after results update.
• :item_selected — %{label: name} — the live-region announcement after a single-select selection is made, naming the selected item.
• :clear_selection — visible text and aria-label for the button that clears the current selection.
• :selected_items — aria-label for the multi-select chip list.
• :remove_chip — %{label: name} — aria-label for a chip's remove button, naming the chip it removes.
• :remove_icon — the visible glyph on a chip's remove button.
• :clear_all — visible text and aria-label for the multi-select "clear all" button.
• :selected_count — %{count: n} — the live-region announcement after the multi-select selection changes.
• :max_selections_reached — %{max: n} — shown in the listbox once max_selections is reached.
• :keyboard_shortcut_hint — %{chord: text} — title on the activate_with_keyboard kbd hint (Spec 006), naming the chord that focuses and opens the search from anywhere on the page.
• :facet_key_context — the live-region announcement (Spec 003) when the cursor moves into facet-key position (stat| before any :) — key suggestions are now driving the dropdown.
• :facet_value_context — %{facet: label} — the live-region announcement when the cursor moves into a known facet's value position (status:|) — that facet's picklist/nested search is now driving the dropdown.
• :free_text_context — the live-region announcement when the cursor is in plain free-text position — no facet is driving the dropdown.
• :facet_key_suggestions_count — %{count: n} — the live-region announcement after facet-key suggestions update.
• :facet_value_suggestions_count — %{count: n} — the live-region announcement after facet-value suggestions (enum picklist or nested search) update.
• :facet_trigger_hint — %{triggers: ["@", "#"]} — the discoverability affordance shown when facet_trigger is set (Spec 024). With a trigger configured, a bare word no longer volunteers facet keys, so this is the only thing telling the user the facets exist — it is both visible text and the input's aria-describedby.
• :facet_search_placeholder — placeholder text for Flicker.search/1's input. Given %{trigger: "@", example: "status"} when a Spec 024 trigger is configured, where example is a facet that trigger actually reaches — the no-bindings clause teaches the status:active form instead.
• :palette_label — aria-label for Flicker.palette/1's dialog (role="dialog").
• :close_palette — visible text and aria-label for the palette's close button.
• :footer_navigate_hint — the palette footer's "navigate" kbd hint label (next to the ↑↓ keys).
• :footer_select_hint — the palette footer's "select" kbd hint label (next to the ↵ key).
• :footer_close_hint — the palette footer's "close" kbd hint label (next to the esc key).
• :loading_more — paginate-d select only (Spec 010): shown in the themed tail row while the next window loads.
• :more_results_appended — %{count: n, total: total} — paginate-d select only: the live-region announcement after a window appends (Spec 010), naming how many were just added and the new running total.