# Stat

> The call sheet's top band as figures: Day 7 of 24, crew call, sunrise, wrap +1, pages in eighths. Big tabular numbers, a label above, one quiet line of context.

Source: https://kwark.space/designSystem/components/stat

## Usage

### What it is
A stat is a figure big enough to read across a room, with its label and one line of context. Kwark's model is the **top band of a call sheet**: the shoot day, crew call, sun times, the wrap and the pages, which the crew reads before anything else. Figures are facts. A stat never carries a target, a trend arrow or praise.

### When to use
- Two to five facts about the whole: the day on a call sheet, the script on project home, the schedule above the stripboard.
- When the number is the point and the reader needs it in a second.

### When not to
- For progress against a goal Kwark invented. Kwark measures; it does not judge (Decision 0002).
- For one figure. Put it in a sentence: *The script runs about 1 h 44 min*.
- **Never** with arrows, red or green, or *+12% this week* about a person's work (Decision 0036).

### Film conventions it keeps
- **Times in 24-hour form** with a colon, tabular, as call sheets print them.
- **Overnight**: a wrap after midnight carries a small **+1** (the next day), as night-shoot call sheets mark it. Never *3:30 AM* alone, which reads as the morning before.
- **Pages in eighths**: *4 6/8*, the eighths set smaller after the whole pages.
- **Day n of N**: the lead cell says where the shoot is.

### Variants
| Variant | Use |
|---|---|
| Band (default) | The call sheet and the schedule: 28px figures, the lead cell on a raised ground |
| Compact (`--compact`) | Project home and panels: 20px figures |

### Writing
Labels are nouns in sentence case (*Crew call*, *Wrap, about*). Estimates say *about*. Context lines are facts (*2 omitted*, *Night exterior*), never praise or blame.

**Do:** *Wrap, about 03:30 +1 · Night exterior*.

**Don't:** *Wrap 3:30* with no sign it is the next morning, or *58 scenes* in green with an up arrow and *Great progress*.

## Style

### Anatomy

1. **Band**: `<dl class="kw-statband">`, cells at least 120px wide that wrap and grow to fill each row, 1px `--k-line` hairlines between cells on a 10px-cornered frame, like a contact sheet.
2. **Label** (`dt`): 12px 500 `--k-text-2`, above the figure.
3. **Figure** (`dd`): Poppins 600 at `--k-fs-display` (28px), tabular, line height 1.1; compact 20px.
4. **Suffix** (`small`): *of 24*, eighths; 12px 500 `--k-text-2` on the baseline.
5. **+1**: a 10px-high pill, 600, `--k-chart-aqua` at 22% on the surface, raised to the cap height; the words *the next day* for screen readers.
6. **Context**: 12px `--k-text-2`, one line.
7. **Lead cell**: `--k-raise` ground.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-surface` | #ffffff | #1a1a1a |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-raise` | #f1f5f9 | #252525 |
| `--k-chart-aqua` | #509ca0 | var(--k-brand-aqua) |
| `--k-fs-display` | 28px |  |
| `--k-fs-head` | 20px |  |
| `--k-fs-meta` | 12px |  |
| `--k-radius-card` | 10px |  |

### States
| State | Look |
|---|---|
| Value not known | The label stays; the figure reads *Not set* in 14px `--k-text-2` |
| Estimate | *about* in the label, never a tilde |
| Phone | Two columns; the lead cell spans both |

## 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
<dl class="kw-statband" aria-label="Day 7 at a glance">
  <div class="kw-statband__cell kw-statband__cell--lead"><dt>Shoot day</dt><dd>7<small>of 24</small></dd><span>Mon 25 Nov</span></div>
  <div class="kw-statband__cell"><dt>Crew call</dt><dd>16:30</dd><span>Shooting 17:30</span></div>
  <div class="kw-statband__cell"><dt>Sunset</dt><dd>17:44</dd><span>Sunrise 06:31</span></div>
  <div class="kw-statband__cell"><dt>Wrap, about</dt><dd>03:30<sup class="kw-plus1">+1<span class="kw-visually-hidden">, the next day</span></sup></dd><span>Night exterior</span></div>
  <div class="kw-statband__cell"><dt>Pages</dt><dd>4<small class="kw-eighths">6/8</small></dd><span>5 scenes</span></div>
</dl>
<dl class="kw-statband kw-statband--compact" aria-label="Blank Pages in numbers">
  <div class="kw-statband__cell"><dt>Pages</dt><dd>104</dd><span>Draft 5</span></div>
  <div class="kw-statband__cell"><dt>Scenes</dt><dd>58</dd><span>2 omitted</span></div>
  <div class="kw-statband__cell"><dt>Speaking parts</dt><dd>11</dd></div>
  <div class="kw-statband__cell"><dt>Shoot days</dt><dd>12</dd><span>Not scheduled yet: 3 scenes</span></div>
</dl>
```

### Markup
Keep the DOM order label, figure, context so screen readers say *Crew call, 16:30*. The band is a `<dl>`; each cell a `<div>` holding `dt`, `dd` and a context `span`.

## Accessibility

### Screen readers
- Each cell is a term and its definition.
- The **+1** includes visually hidden words: *03:30, the next day*.
- Eighths read as written (*4 6/8*); add a `title` only if a page reads them as a date.

### Motion
Never count numbers up on arrival.

## For agents

### Rules

- **Never** show targets, trends or praise in a stat about someone's work.
- **Must** mark a time after midnight with +1 and say "the next day" to screen readers.
- **Must** write page counts in eighths and times in 24-hour form.
- **Must** use two to five stats in a band.
- **Never** animate numbers.

### AI readiness test

**Task:** Put the day's essentials at the top of the Day 9 call sheet, a split day ending in a night exterior.

**Give the agent:** Stat, Call sheet, Production calendar.

**Constraint:** Wrap is after midnight; sunrise and sunset come from the location.

**A reliable answer:**
- Day 9 of 24 as the lead cell
- Crew call and shooting call in 24-hour form
- Sunset with sunrise as context
- Wrap with +1 and hidden words
- Pages in eighths
