j3w1/theme implementation brief — toast
theme: j3w1-theme 1.1.0  profile: default  sourceDigest: sha256-C+iD5Q7l0XPU/boMj003wPbPLBOq3C3ZM7s4OfzJ6mc=
pin: https://raw.githubusercontent.com/j3w1/theme/v1.1.0/exports/components/toast.json
spec: spec/components/toast.md  site: https://j3w1.github.io/theme/reference/#c-toast
maturity: stable  priority: R1

Summary: A brief notification in a fixed corner stack; canvas surface behind a 1px overlay border, status tints for the four polite statuses and the danger fill for critical ones.

Use the pinned approved default profile. Pending roles in that profile use-and-report their decision IDs; this does not approve them. Proposed profiles are preview-only and blocked for delivery. Heritage profiles are historical-only. Deprecated or heritage roles are blocked for new approved-profile mappings. Consume roles within their documented scope, never primitives. Release numbering does not approve profiles or tokens.
Tokens (resolved):
  root.bg                 #000000  ({color.surface.canvas})  use
  root.border             #e53935  ({color.border.overlay})  use-and-report (D-008)
  root.text               #e99499  ({color.text.default})  use
  glyph.text              #7e9ebb  ({color.status.info.text})  use
  warning.bg              #1f1a0c  ({color.status.warning.tint})  use
  warning.border          #c9973f  ({color.status.warning.border})  use
  warning.text            #c9973f  ({color.status.warning.text})  use
  success.bg              #0f1a0e  ({color.status.success.tint})  use
  success.border          #86a46f  ({color.status.success.border})  use
  success.text            #86a46f  ({color.status.success.text})  use
  info.bg                 #0f141c  ({color.status.info.tint})  use
  info.border             #7e9ebb  ({color.status.info.border})  use
  info.text               #7e9ebb  ({color.status.info.text})  use
  neutral.bg              #241010  ({color.status.neutral.tint})  use
  neutral.border          #a3676b  ({color.status.neutral.border})  use
  neutral.text            #bd787d  ({color.status.neutral.text})  use
  danger.bg               #dc282e  ({color.status.danger.fill})  use
  danger.text             #f9faf9  ({color.status.danger.on-fill})  use
  danger.button-bg-hover  #ae1914  ({color.action.destructive.pressed-bg})  use
  action.text             #f73f35  ({color.text.link})  use
  action.bg-hover         #630f0d  ({color.interaction.hover.bg-strong})  use
  action.text-hover       #f4eeee  ({color.text.link-hover})  use
  close.text              #e99499  ({color.action.tertiary.text})  use
  close.bg-hover          #1c0a09  ({color.action.tertiary.hover-bg})  use
  close.ring              #e53935  ({color.interaction.focus.ring})  use
  count.text              #bd787d  ({color.text.muted})  use
  stack.z                 40  ({z.toast})  use
State dependency disclosures: D-008

States: default, hover, focus-visible, stacked, reduced-motion
  default: canvas surface, 1px overlay border, glyph in the status text colour [the glyph; the worded text]
  hover: action → {color.interaction.hover.bg-strong} with {color.text.link-hover}; Dismiss → {color.action.tertiary.hover-bg}; the timeout pauses [cursor: pointer; underline thickens on the action]
  focus-visible: ring 1px dashed {color.interaction.focus.ring} at −2px on the focused button; on the danger fill the ring takes {color.status.danger.on-fill}; the timeout pauses [the ring]
  stacked: toasts sit in one column with a 4px gap, newest at the end; the last visible toast shows "+n" in {color.text.muted} for queued ones [the count text; at most three visible]
  reduced-motion: no transition; the toast is simply present or absent [`prefers-reduced-motion`; nothing moves]

Keyboard:
  F6 / a host shortcut: Moves focus into the notification region; toasts never steal focus when they appear.
  Tab / Shift+Tab: Within the region, reaches the action and then Dismiss of each toast in order.
  Enter / Space: Activates the action or dismisses.
  Escape: Dismisses the focused toast and returns focus to the region, then to the page.

ARIA: native <div role=status> (role=alert for danger) inside a region named Notifications; native buttons for the action and dismiss (https://www.w3.org/WAI/ARIA/apg/patterns/alert/)
Responsive: The stack is at most 24rem wide and fills the viewport width minus the 8px gutter below 360px; text wraps, buttons keep their size; at 320px nothing is clipped. RTL mirrors the corner and the button order.
Portability: a <div role=region aria-label=Notifications> fixed in the end corner at z.toast holding <div role=status> toasts (role=alert for danger); the timeout pauses on hover and focus and is at least 8 s; appearance is an opacity change within the motion budget, never a slide.
  native: GTK4 Toast in a ToastOverlay; the danger fill is not available and is recorded.
  native: Desktop notifications through the host daemon (the historical dunst configuration is the origin of the danger fill); urgency critical maps to danger.
  native: Terminal UI: a message line at the bottom edge; no stacking.

Rules: use only these values; no invented colours; radius 0; borders 1px (2px emphasis); focus is a 1px dashed ring, selection is a fill;
do not restyle unrelated elements; report deviations per agents/consume.md; record theme.lock.json at the pinned revision.