# Status dot

> A small shape and a word for a state: saved, on this device, offline. Its film use is the call sheet’s read receipts, where each crew member is confirmed, read or not yet reached.

Source: https://kwark.space/designSystem/components/status-dot

## Usage

### What it is
An 8px mark and a word. The word carries the state; the mark lets a column of states be scanned at a glance. It is never shown alone.

### The Kwark idea: shapes that survive a photocopy
Status dots in most systems are coloured circles, which mean nothing to someone with colour blindness, on a greyscale printout, or on a phone in sunlight on set. Kwark's dots change **shape** as well as colour, in an order that reads as progress, so a call sheet's receipts can be read from a printout:

| Shape | Means | Call sheet | Saving |
|---|---|---|---|
| Filled | Done | Confirmed | Saved (in the cloud) |
| Half | Part way | Read, not confirmed | On this device, not yet in the cloud |
| Ring | Started, nothing back yet | Sent | Offline |
| Diamond | Needs a person | Bounced: check the email | – |
| Dash | Does not apply | Not on this sheet | Not shared |

### When to use
- A column of the same kind of state: crew receipts on an issued call sheet (Decision 0020), who has read Rev 2, a list of exports.
- A save state where space is tight, beside [sync status](https://kwark.space/designSystem/components/sync-status.md).

### When not to use
- For a problem the person must fix: an [inline notice](https://kwark.space/designSystem/components/inline-notice.md) or [banner](https://kwark.space/designSystem/components/banner.md).
- For counts: a [badge](https://kwark.space/designSystem/components/badge.md).
- For presence of a person: their [avatar](https://kwark.space/designSystem/components/avatar.md) with the here mark.

### Motion
Only *Saving* pulses, and only while a save is in flight: motion that answers an action. Nothing else moves.

## Style

### Anatomy

1. **Mark**: 8px (10px at `--lg`), `--kw-sdot` set by `data-tone`; shapes by `data-shape`: filled, `half` (1.5px ring, left half filled), `ring` (1.5px), `diamond` (7px turned 45°, 1px corners), `dash` (9 × 2px).
2. **Gap**: 8px.
3. **Word**: Poppins 500 12px in `--k-text`, tabular; a time or detail in 400 `--k-text-2`.
4. **Tones**: ok, info, warn, danger, accent (for *Saving*), and the quiet default `--k-text-2`.
5. **Receipts list**: 44px rows with a 1px line, the person and their role and call time on the left, the state on the right; a summary row of counts above.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-ok` | #2c6e49 | #6cc08a |
| `--k-info` | #255799 | #7db4f0 |
| `--k-warn` | #8a5a00 | #d8a44a |
| `--k-danger` | #b4382c | #e0685c |
| `--k-accent-soft` | #e8b58b | #e8b58b |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-tap` | 44px |  |
| `--k-fs-meta` | 12px |  |
| `--k-fs-body` | 14px |  |
| `--k-ease-in-out` | cubic-bezier(.65, 0, .35, 1) |  |

## Code

### React

Use the HTML below with `kwark.css`. The example shows the markup and styling. Supply any application behavior described on this page.

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<div class="kw-receipts__sum">
  <span class="kw-sdot kw-sdot--lg" data-tone="ok"><span class="kw-sdot__mark" aria-hidden="true"></span>18 confirmed</span>
  <span class="kw-sdot kw-sdot--lg" data-tone="info" data-shape="half"><span class="kw-sdot__mark" aria-hidden="true"></span>3 read</span>
  <span class="kw-sdot kw-sdot--lg" data-shape="ring"><span class="kw-sdot__mark" aria-hidden="true"></span>2 sent</span>
  <span class="kw-sdot kw-sdot--lg" data-tone="warn" data-shape="diamond"><span class="kw-sdot__mark" aria-hidden="true"></span>1 bounced</span>
</div>
<ul class="kw-receipts" aria-label="Call sheet Rev 2, read receipts">
  <li><span class="kw-receipts__who">Tara Sen<small>Mira · call 06:30</small></span><span class="kw-sdot" data-tone="ok"><span class="kw-sdot__mark" aria-hidden="true"></span>Confirmed <small>06:42</small></span></li>
  <li><span class="kw-receipts__who">Devika Nair<small>Aanya · call 07:15</small></span><span class="kw-sdot" data-tone="info" data-shape="half"><span class="kw-sdot__mark" aria-hidden="true"></span>Read <small>06:58</small></span></li>
  <li><span class="kw-receipts__who">Kabir Shah<small>Gaffer · call 06:00</small></span><span class="kw-sdot" data-shape="ring"><span class="kw-sdot__mark" aria-hidden="true"></span>Sent <small>06:10</small></span></li>
  <li><span class="kw-receipts__who">Riya Das<small>Sound mixer · call 07:30</small></span><span class="kw-sdot" data-tone="warn" data-shape="diamond"><span class="kw-sdot__mark" aria-hidden="true"></span>Bounced</span></li>
</ul>
<div style="display:flex;flex-wrap:wrap;gap:20px">
  <span class="kw-sdot" data-tone="ok"><span class="kw-sdot__mark" aria-hidden="true"></span>Saved</span>
  <span class="kw-sdot" data-tone="accent" data-live><span class="kw-sdot__mark" aria-hidden="true"></span>Saving</span>
  <span class="kw-sdot" data-tone="warn" data-shape="half"><span class="kw-sdot__mark" aria-hidden="true"></span>On this device</span>
  <span class="kw-sdot" data-shape="ring"><span class="kw-sdot__mark" aria-hidden="true"></span>Offline</span>
  <span class="kw-sdot" data-shape="dash"><span class="kw-sdot__mark" aria-hidden="true"></span>Not shared</span>
</div>
```

## Accessibility

### ARIA
- The mark is `aria-hidden="true"`; the word is the state. Screen readers hear *Confirmed, 06:42*.
- When a state changes while the person watches (*Saving* to *Saved*), the text sits in a polite live region; a list of receipts does not announce each change, only the summary (*19 confirmed*).

### Contrast
- Marks are at least 3:1 against their ground (WCAG 1.4.11); the shape is the second cue, the word the first.
- The pulse stops under `prefers-reduced-motion`.

## For agents

### Rules

- **Must** pair every dot with a word; never a dot alone.
- **Must** use the shape order filled, half, ring, diamond, dash so states read without colour.
- **Never** animate a dot except Saving while a save is in flight.
- **Never** use a status dot for an error the person must fix; use an inline notice or banner.
- **Always** give the time or detail of a receipt in the quiet second colour.

### AI readiness test

**Task:** Show who has received the Day 7 call sheet, Rev 2.

**Give the agent:** This page, Call sheet, Decision 0020.

**Constraint:** Some crew read it on paper; the sheet may be printed in black and white.

**A reliable answer:**
- A receipts list with Confirmed (filled), Read (half), Sent (ring), Bounced (diamond)
- Each with a word and time
- A summary of counts above
- Readable on a greyscale printout
