Status, progress, and notification visuals.
File Components/Toast.swift · UIKit only
(#if canImport(UIKit))
A blurred, rounded toast: leading status icon, message, and an optional dismiss (✕)
button. Background is a systemUltraThinMaterialDark blur under Color.dash.toastBackground.
Toast(
style: .success,
message: "Done",
onDismiss: { /* hide */ } // nil → no dismiss button
)ToastStyle — .warning · .info · .error · .success · .copied · .loading
· .noInternet. Each draws a DashIcon.Toast case (.warning, .info, …, .noWifi
for .noInternet). .loading instead renders the DS LoadingSpinner.
VoiceOver reads only the message; the icon is hidden from it. When the style matters to a
listener and the message does not say it, pass an accessibilityLabel: to read instead of
the message. It is a Text: a literal Text("…") is looked up in the app's main bundle,
Text("…", bundle: .module) in a package's, and a String variable is read as is. VoiceOver
reads it when focus lands on the message (the dismiss button is a separate stop); announcing
the toast as it appears is the host's job, like its presentation. The label replaces the
message's, for UI tests too, so build it from the same localized message, and add the new
key to the host's strings like any other:
Toast(style: .error, message: paymentFailed,
accessibilityLabel: Text("Error, \(paymentFailed)")) // key "Error, %@"This is just the toast view — presentation/animation/auto-dismiss timing is the host's responsibility (e.g. overlay it and drive visibility yourself).
File Components/SystemMessageView.swift
An icon-led system banner with optional subtitle, up to two action buttons, and an
optional close button. The default icon is the bundled warning_triangle asset, and the
default background is a lightly tinted DS gray.
SystemMessageView(
title: "Address expired",
subtitle: "Generate a new receiving address.",
buttonName: "Renew",
onAction: { /* handle action */ },
onClose: { /* dismiss */ }
)The action buttons are regular DashButtons, so use the host to decide whether to show
one or two of them.
File Components/ModalDialog.swift
A dialog card: an optional icon (.warning, the yellow tile), a heading, any number of
paragraphs drawn as one text with a blank line between them, and one or two full-width
buttons. The secondary action sits above the primary one; a .destructive action is drawn
tintedRed whichever button it is, every other one tintedGray. The card is at most 330 pt wide and only
lays itself out: the host presents it, over a dim, centred. Text taller than the space
the host gives scrolls inside the card, and the buttons stay visible.
ModalDialog(
icon: .warning,
heading: "Keys left on your identity",
paragraphs: [question, warning],
primaryAction: .init(title: "Turn them off", role: .destructive) { /* … */ },
secondaryAction: .init(title: "Leave them") { /* … */ }
)VoiceOver reads the heading as a header, then the paragraphs in order; the icon is
hidden. The card carries the isModal trait, so VoiceOver does not reach the screen
behind it while it is shown, even in a host's ZStack. The heading uses the headline token, which is bold where the Figma Dialogue
component draws it semibold.
File Components/Illustrations/LoadingIllustration.swift
LoadingSpinner is an iOS-style activity indicator built from spokeCount capsules in a
ring. The spokes are static; a bright "head" steps clockwise while the others fade
(comet-tail opacity), crossfading between steps — mirroring UIActivityIndicatorView.
LoadingSpinner(size: 24, color: .gray, spokeCount: 12, duration: 1)LoadingIllustration wraps the spinner centered in a fixed square frame (defaults match
the Maya design: a 61.73 spinner in a 90×90 frame).
LoadingIllustration() // 61.73 spinner, DS blue, 90×90
LoadingIllustration(size: 32, color: .red, containerSize: 64)Defaults: size: 61.73, color: LoadingSpinner.defaultColor (DS blue), containerSize: 90.
Files Components/Illustrations/SuccessIllustration.swift,
Components/Illustrations/ErrorIllustration.swift
90×90 circular status badges — a green circle with a checkmark, and a red circle with an ✕ (both from bundled assets). No parameters.
SuccessIllustration()
ErrorIllustration()File Components/Icons/InfoRoundIcon.swift · public
A code-drawn round "i" — a filled disc with a white glyph — for the "there is more to say
about this" affordance. Geometry is normalized from a 19×19 SVG, so stem and dot keep
their weight and position at any size.
InfoRoundIcon() // 19pt, Blue disc
InfoRoundIcon(size: 20, color: Color.dash.gray300Alpha70) // muted, beside a menu titleThe disc reads Color.dash.blue by default and the glyph Color.dash.white, so both
follow the palette instead of a baked-in hex. MenuItem renders it for
MenuItemInfo.round.
File Components/Icons/XmarkIcon.swift · public
A code-drawn "✕" close icon (a Shape with two round-capped diagonals, mirroring a 9×9
SVG), so it scales cleanly to any size without an asset. Used by Toast's dismiss button.
XmarkIcon(size: 24, color: .white, lineWidth: 2)Prefer this over the bundled
navigationbar-closeasset when the close control is drawn at a non-standard size or needs to take the surrounding tint: being aShape, it stays crisp at anysizeand honourscolor/lineWidth. The asset remains the right choice where the navigation bar's exact artwork is wanted.
File Components/Icons/CheckmarkIcon.swift · public
A code-drawn "✓" selection mark (a Shape stroking the polyline of a 15×12 SVG, round
caps and joins). Backs MenuItemAccessory.selection.
CheckmarkIcon(size: 24, color: .white, lineWidth: 3)
sizesets the width; the height follows the source aspect ratio (12/15), unlikeXmarkIcon, whose artwork is square. The default colour isColor.dash.blue— the token the source SVG's#008DE4corresponds to — so the mark follows the palette rather than a frozen hex.
File Components/Icons/ChevronIcon.swift · public
A code-drawn chevron, in any of the four directions (a Shape stroking the polyline of a
7×12 SVG, round caps and joins). ConverterCard puts one on every row that carries an
onTap, so a row that opens a picker reads as one at rest.
ChevronIcon() // points right, 12pt tall
ChevronIcon(direction: .down, size: 16)
ChevronIcon(direction: .left, color: Color.dash.blue, lineWidth: 2)| Property | Default | Notes |
|---|---|---|
direction |
.right |
.right / .left / .up / .down |
size |
12 |
The long side — height for left/right, width for up/down |
color |
Color.dash.gray300Alpha90 |
The palette entry for the source SVG's #B0B6BC at 90% |
lineWidth |
1.6 |
Source stroke width |
Only the
.rightchevron is drawn; the rest are that glyph rotated, so all four share one geometry and one line weight. The frame swaps axes with the rotation, so a.up/.downchevron measures wider than tall and lays out without a gap beside it.