# Meter

> A measured amount against a known limit, like a shoot day’s pages against its target. A fact, never a judgement of the work.

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

## Usage

### What it is
On the stripboard each shoot day carries a 3px bar under its heading: how many pages (in eighths, as a 1st AD counts them) are on the day, against the day’s target. Over the target it turns amber; the title says *6 1/8 of 5 pages*. That is the meter: a quantity inside a known range.

### When to use
- Pages on a shoot day, hours on a call sheet day, storage used for offline copies, minutes of runtime against the length the writer set.

### When not to use
- For anything that grades the story. No "script health", no "pacing score", no completeness bar on a draft (Decision 0002, no AI judgement).
- For progress of a task that ends: that is [Progress](https://kwark.space/designSystem/components/progress.md).

### Variants
| Variant | Use for |
|---|---|
| Within | `--k-ok` fill |
| Over | `--k-warn` fill and the overage in words; never red, over is a planning fact, not a fault |

### Writing
Always pair the bar with the numbers in words: *4 3/8 of 5 pages*.

## Style

### Anatomy

1. **Track**: 3px tall, 3px corners, `--k-line`, inset 12px inside its card.
2. **Fill**: `--k-ok`, or `--k-warn` with `data-over`.
3. **Label**: 12px Poppins, `--k-text-2`, above or beside the bar; the overage in `--k-warn`.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-ok` | #2c6e49 | #6cc08a |
| `--k-warn` | #8a5a00 | #d8a44a |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-fs-meta` | 12px |  |

## 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-meter-demo">
  <div class="kw-meter-label"><span>Day 3 · 4 3/8 of 5 pages</span></div>
  <div class="kw-meter" role="meter" aria-valuemin="0" aria-valuemax="40" aria-valuenow="35" aria-valuetext="4 3/8 of 5 pages"><b style="width:87.5%"></b></div>
  <div class="kw-meter-label"><span>Day 4 · 6 1/8 of 5 pages</span><span class="kw-meter-over">Over by 1 1/8</span></div>
  <div class="kw-meter" data-over role="meter" aria-valuemin="0" aria-valuemax="40" aria-valuenow="40" aria-valuetext="6 1/8 of 5 pages, over by 1 1/8"><b style="width:100%"></b></div>
</div>
```

## Accessibility

### Keyboard
Not interactive.

### ARIA
- `role="meter"` with `aria-valuemin`, `aria-valuemax`, `aria-valuenow` and an `aria-valuetext` in the same words as the label. The app uses `title` today; the visible label is required for touch screens.

## For agents

### Rules

- **Never** use a meter to rate, score or judge writing (Decision 0002).
- **Must** show the numbers in words beside the bar.
- **Never** use red for over-target; use `--k-warn`.
- **Always** set role="meter" with aria-valuetext.

### AI readiness test

**Task:** Show how much of the 90-minute runtime the current draft covers.

**Give the agent:** This page, Decision 0002.

**Constraint:** The page count is 98; one page is roughly one minute.

**A reliable answer:**
- Shows "about 98 of 90 min" as a fact with the over state in warn
- Does not call the draft too long or score it
- Labels the estimate as an estimate
