Library status surfaces
Design References
Contract
Status surfaces render visible state. StatusPill
shows compact semantic status. EmptyState,
LoadingState, ResultPanel,
and ErrorBanner render absence, loading,
operation result, and recoverable error states.
| Surface | Use When | Required Inputs | Behavior |
|---|---|---|---|
StatusPill |
A row or summary needs compact status. |
label string; optional status. |
status is neutral, working, success, warning, danger, or muted; default neutral; unknown values fail validation. |
EmptyState |
A collection or view has no items. | Public-safe title string. |
Optional event renders one recovery control and emits only surface id/path plus event name. |
LoadingState |
Data or work is pending. | Public-safe label string; default Loading. |
No events; replaced by loaded/error state. |
ResultPanel |
An operation completed. | Public-safe title string and status. |
status uses the same semantic values as StatusPill; optional details and event controls render when supplied. |
ErrorBanner |
A recoverable error blocks or degrades the view. | Public-safe title string. |
Optional retry and dismiss events emit only banner id/path plus event name. |
Public-safe text may include operation names, field names, status codes, and request ids. It must not include tokens, secrets, raw provider payloads, stack traces, SQL, private customer data, or credential headers.
Consequence
Product modules own state meaning. Library status surfaces make that state visible in a consistent form.