The living catalog

Elements13/15

Announcer + Toast

G4G5

G5 embodied: announce() renders the one quiet transient line per surface region (Undo lives in the line); the toast viewport is for async outcomes only, max two.

Posture

The announcer — one quiet line, Undo in the line (G5)

Toasts — async outcomes only, max two

npx candlelight-ds add announcer

Use when

Announcer: confirming a direct manipulation. Toast: an async job finished or failed while the user was elsewhere.

Don't use when

Celebration toasts for direct actions — the change itself is the confirmation.

States
announcement visible (5.5s wall)announcement with Undotoast ready/danger/warn/infotwo toasts (the cap)
Acceptance
  • One announcement at a time, in a fixed spot, in voice.
  • Max two toasts; the oldest yields.
  • Every destructive outcome carries Undo.

Raw twin: /components/announcer.md·Registry item: /r/announcer.json