Sidebar status badge. Two variants:

• :warning — preview_props/0 raised; shows an exclamation-triangle Heroicon + the literal copy "Error" (per 05-UI-SPEC Badge section).
• :stub — mailable has no preview_props/0 defined; shows the "—" glyph in Slate (secondary) color.

Attributes

• variant (:atom) (required) - Must be one of :warning, or :stub.

Renders the thin group-surface shell: border, radius, surface tone, and outer padding only.

This is the single source for the group-surface shell. It deliberately owns no layout engine — no header/footer/grid slots, no inter-card rhythm, no dl/ol spacing. shadow-raised and data-group-card are applied at call sites, not baked in here. Padding is the one closed knob (:md -> p-md, :lg -> p-lg).

Attributes

• padding (:atom) - Defaults to :md. Must be one of :md, or :lg.
• Global attributes are accepted.

Slots

• inner_block (required)

Renders one of four distinct data-state templates.

Each kind maps to a unique testid, icon, and icon color so that permission-denied is never mistaken for no-data, and error is never conflated with stale-data.

Kinds

• :empty — no records; rendered with hero-inbox and text-secondary
• :error — unavailable/error; rendered with hero-exclamation-circle and text-error
• :permission_denied — access restricted; rendered with hero-lock-closed and text-warning
• :stale — data may be out of date; rendered with hero-clock and text-secondary

Attributes

• kind (:atom) (required) - Must be one of :empty, :error, :permission_denied, or :stale.
• title (:string) (required)
• body (:string) (required)
• icon (:string) - Defaults to nil.
• Global attributes are accepted.

Renders one explicit, labelled filter control.

Defaults derive from Phoenix.HTML.FormField metadata when field is provided. Explicit id, name, and value remain supported for gallery and certification surfaces that render without a form struct.

Attributes

• field (:any) - Defaults to nil.
• id (:string) - Defaults to nil.
• name (:string) - Defaults to nil.
• value (:any) - Defaults to nil.
• type (:atom) - Defaults to :text. Must be one of :text, :number, :select, :textarea, or :checkbox.
• label (:string) (required)
• help (:string) - Defaults to nil.
• error (:any) - Defaults to nil.
• options (:list) - Defaults to [].
• prompt (:string) - Defaults to nil.
• disabled (:boolean) - Defaults to false.
• readonly (:boolean) - Defaults to false.
• display_value (:string) - Defaults to nil.
• submit_readonly (:boolean) - Defaults to true.
• Global attributes are accepted. Supports all globals plus: ["autocomplete", "inputmode", "max", "min", "pattern", "placeholder", "step"].

Renders a visible filter control group.

The primitive uses native fieldset/legend semantics so pages can group related filters without duplicating page-local label/control wrappers.

Attributes

• title (:string) (required)
• description (:string) - Defaults to nil.
• Global attributes are accepted.

Slots

• inner_block (required)

Renders a brand-voice flash message in a daisyUI toast wrapper.

Used for LiveReload notifications ("Reloaded: {file}") and other transient signals. Includes role="status" + aria-live="polite" per the 05-UI-SPEC Accessibility Interactions contract.

Attributes

• kind (:atom) - Defaults to :info. Must be one of :info, :success, :warning, or :error.
• message (:string) (required)

Renders a Heroicon via the vendored heroicons.js Tailwind plugin.

The plugin resolves classes matching hero-<name> into inline SVG at build time. Usage: <.icon name="hero-envelope" class="w-5 h-5" />.

Attributes

• name (:string) (required)
• class (:any) - Defaults to nil.

Renders the sealed-flap mailglass lockup inline for theme-aware color.

The public logo.svg route remains served by MailglassAdmin.Controllers.Assets at <mount>/logo.svg; the admin UI renders inline so the currentColor paths inherit text-base-content in light and dark chrome.

Attributes

• class (:any) - Defaults to nil.

@spec mask_email(String.t(), String.t()) :: String.t()

Masks the local/domain halves of an already-split email address. Public so the inbound components can mask address-shaped values that are pre-split.

@spec mask_recipient(String.t() | nil) :: String.t()

Masks a recipient email for operator display (PII minimization).

The ONE audited masking definition in the admin package: both MailglassAdmin.Operator.DeliveriesList (outbound) and the inbound components call this so there is never a second, drifting copy. Keeps the first grapheme of each segment and stars the rest, preserving the email shape:

mask_recipient("alice@example.com") #=> "a****@e******.com"
mask_recipient(nil)                 #=> "Unavailable"

@spec mask_value(String.t()) :: String.t()

Masks a single value: keeps the first grapheme, stars the rest. Public so other admin surfaces reuse the one masking primitive rather than reinventing it.

Renders the desktop operator navigation link primitive.

Disabled links are rendered as inert text with link semantics, aria-disabled, and no LiveView navigation attribute.

Attributes

• label (:string) (required)
• icon (:string) (required)
• href (:string) (required)
• active (:boolean) - Defaults to false.
• disabled (:boolean) - Defaults to false.
• Global attributes are accepted.

Renders the compact operator navigation pill primitive.

Disabled pills are visibly inactive and expose aria-disabled without a LiveView navigation attribute.

Attributes

• label (:string) (required)
• href (:string) (required)
• active (:boolean) - Defaults to false.
• disabled (:boolean) - Defaults to false.
• Global attributes are accepted.

@spec normalize_inbound_outcome(atom() | nil) :: atom() | nil

Normalizes inbound @outcomes singular atoms to the canonical past-tense atoms expected by status_badge/1. The mailglass_inbound @outcomes schema (locked 1.0 contract) is never modified; normalization is admin-side only.

Maps: :accept → :accepted, :reject → :rejected, :bounce → :bounced. All other atoms (including nil) pass through unchanged.

Renders a canonical stat card with label, no-wrap value, and severity.

Severity is a closed set and always renders as icon plus visible label plus semantic color.

Attributes

• id (:string) - Defaults to nil.
• label (:string) (required)
• value (:any) - Defaults to nil.
• severity (:atom) - Defaults to :neutral. Must be one of :neutral, :info, :success, :warning, or :error.
• severity_label (:string) - Defaults to nil.
• state (:atom) - Defaults to :ready. Must be one of :ready, :empty, :loading, or :unavailable.
• empty_text (:string) - Defaults to "No data yet".
• loading_text (:string) - Defaults to "Resolving".
• unavailable_text (:string) - Defaults to "Unavailable".
• Global attributes are accepted.

Unified delivery, inbound, and timeline status badge. Renders an outline Heroicon (decorative, aria-hidden) and a text label inside a daisyUI badge container.

The base badge class is always emitted by this component — call sites must NOT prepend 'badge' or 'badge badge-sm'. Use size: :sm (default) for list rows; size: :md for detail headers.

Attributes

• status (:atom) (required) - Must be one of :dispatched, :queued, :sent, :delivered, :deferred, :bounced, :failed, :rejected, :complained, :unsubscribed, :opened, :clicked, :autoresponded, :unknown, :accepted, :no_match, :ignore, :failed_ingest, :webhook_replay_requested, :webhook_replay_succeeded, :webhook_replay_failed, :reconciled, or :suppressed.
• size (:atom) - Defaults to :sm. Must be one of :sm, or :md.

Renders the read-only tenant context chip.

The chip intentionally does not expose switching, loading, or navigation behavior.

Attributes

• tenant (:string) - Defaults to nil.
• Global attributes are accepted.

Renders the three-choice theme picker primitive.

The primitive owns radio semantics only. Persistence, cookie naming, root theme resolution, browser storage, and first-paint behavior are downstream shell concerns.

Attributes

• selected (:atom) - Defaults to :system. Must be one of :system, :light, or :dark.
• name (:string) - Defaults to "theme".
• disabled (:boolean) - Defaults to false.
• event (:string) - Defaults to nil.
• target (:any) - Defaults to nil.
• Global attributes are accepted.