# Clips and grade versions

> The grading timeline as pictures: numbered clips with timecode, Graded or Not graded in words, the version in use, the scene's grade note, and the clip's versions including a machine suggestion that is never applied on its own.

Source: https://kwark.space/designSystem/components/grade-clip-strip

## Usage

### What it is
Colourists move clip by clip. The strip shows each clip as a graded picture with its number and timecode, so a jump in the look between neighbours is visible before it is seen on the monitor.

### Kwark's angle: the scene carries the brief
Above the strip is the scene's **grade note**, written by the DP or director in Kwark and carried with the scene: *Keep the monitor cool and Mira's skin warm. Night, not blue.* The Look Book references for the scene open from [Looks and LUTs](https://kwark.space/designSystem/components/look-picker.md).

### Versions
Every clip keeps its versions: *v1 Balance*, *v2 Night look*, *v3 Night, warmer skin*. A machine suggestion (a shot match to a still) arrives as a **new version with a revision mark**, never as an edit to the current one, and is applied only when the colourist chooses it (Decision 0002, [AI and authorship](https://kwark.space/designSystem/foundations/ai-and-authorship.md)).

### States
| State | How it shows |
|---|---|
| Selected | 1.5px `--k-text` outline |
| Graded | *Graded* in words; version on the picture |
| Not graded | *Not graded*, the picture shown through the conversion only, version — |
| Suggested version | Dashed revision-mark chip with * |

**Do:** *v4 Suggested match to still 3* as a separate dashed chip beside the colourist's versions.

**Don't:** *Auto-matched 8 clips* with the previous grades replaced.

## Style

### Anatomy

1. **Head**: clip count and graded count; Grab still, Compare with still.
2. **Grade note** (Kwark): note glyph, 12px text, who and when.
3. **Clip**: 128px picture at 16:9, number (11px on black) top-left, version top-right; timecode and status under it.
4. **Versions row**: chips for each version of the selected clip; the current one pressed with a check.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-pro-panel` | #f6f7f9 | #19191b |
| `--k-pro-control` | #ffffff | #2a2a2e |
| `--k-pro-line` | #d3d9e0 | rgba(255, 255, 255, .09) |
| `--k-pro-picture` | #0b0b0c |  |
| `--k-rev` | #346a58 | #9fd4bf |
| `--k-rev-bg` | #e4f1eb | #1b2b25 |
| `--k-rev-line` | #8cc3ae | #4f8a74 |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |

### Numbers
| Part | Value |
|---|---|
| Clip | 128px wide, 6px gap, scrolls horizontally |
| Number and version | 11px figures, on `--k-pro-picture` at 75% |
| Version chip | 24px, 12px text, 4px corners |
| Suggested chip | `--k-rev-bg`, dashed `--k-rev-line`, `--k-rev` text |

## 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
<section class="kw-pro kw-pro-panel kw-pro-gstrip" aria-label="Clips in Scene 12 with grade versions">
  <div class="kw-pro-bar"><strong>Clips</strong><span class="kw-pro-dim kw-pro-ellip">Scene 12 · 8 clips · 5 graded</span><span class="kw-pro-sp"></span><button class="kw-pro-btn" type="button" aria-label="Grab still (G)" title="Grab still (G)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="6" width="18" height="14" rx="2"/><circle cx="12" cy="13" r="3.5"/><path d="M8 6l1.5-2.5h5L16 6"/></svg></button><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="Compare with still (W)" title="Compare with still (W)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="5" width="18" height="14" rx="1"/><path d="M12 3v18"/></svg></button></div>
  <div class="kw-pro-gnote"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/></svg><p><b>Scene 12 grade note</b> Keep the monitor cool and Mira’s skin warm. Night, not blue. <span class="kw-pro-dim">DP · 14 Nov</span></p></div>
  <div class="kw-pro-gstrip__scroll"><ol class="kw-pro-gstrip__list" role="listbox" aria-label="Clips"><li role="option" tabindex="-1" aria-selected="false" aria-label="Clip 01, 01:04:00:00, graded, version v2"><span class="kw-pro-gstrip__pic"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" data-look="night" aria-hidden="true"><rect class="w" width="160" height="90"/><rect class="d" y="60" width="160" height="30"/><rect class="d" x="92" y="21" width="54" height="36" rx="1"/><rect class="m" x="95" y="24" width="48" height="30"/><circle class="f" cx="119" cy="34" r="3.5"/><path class="f" d="M112 54c0-7 3-10 7-10s7 3 7 10z"/><rect class="d" x="115" y="57" width="8" height="4"/><circle class="l" cx="24" cy="27" r="7"/><rect class="f" x="23" y="34" width="2" height="26"/><path class="b" d="M48 62c0-11 8-16 18-16s18 5 18 16z"/><circle class="s" cx="66" cy="37" r="7.5"/><path class="h" d="M58.5 37a7.5 7.5 0 0 1 15 0c-1-4-4-6-7.5-6s-6.5 2-7.5 6z"/></svg><b>01</b><em>v2</em></span><span class="kw-pro-gstrip__meta"><span class="kw-pro-tc">01:04:00:00</span><span>Graded</span></span></li><li role="option" tabindex="-1" aria-selected="false" aria-label="Clip 02, 01:04:06:12, graded, version v3"><span class="kw-pro-gstrip__pic"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" data-look="night" aria-hidden="true"><rect class="w" width="160" height="90"/><circle class="l" cx="26" cy="22" r="11" opacity=".35"/><circle class="l" cx="46" cy="33" r="5" opacity=".25"/><path class="b" d="M40 90c0-19 19-29 44-29s44 10 44 29z"/><rect class="s" x="76" y="52" width="16" height="14"/><ellipse class="s" cx="84" cy="40" rx="17" ry="21"/><path class="h" d="M66 42c0-17 8-25 19-25s18 8 18 23c-4-9-10-13-18-13s-14 7-19 15z"/><path class="m" d="M99 29c4 5 5 13 3 21l-3 4c2-9 2-17 0-25z" opacity=".85"/></svg><b>02</b><em>v3</em></span><span class="kw-pro-gstrip__meta"><span class="kw-pro-tc">01:04:06:12</span><span>Graded</span></span></li><li role="option" tabindex="-1" aria-selected="false" aria-label="Clip 03, 01:04:12:18, graded, version v2"><span class="kw-pro-gstrip__pic"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" data-look="cool" aria-hidden="true"><rect class="d" width="160" height="90"/><rect class="m" x="12" y="9" width="136" height="70"/><rect class="f" x="12" y="62" width="136" height="17" opacity=".55"/><circle class="f" cx="80" cy="34" r="9"/><path class="f" d="M62 79c0-15 8-23 18-23s18 8 18 23z"/></svg><b>03</b><em>v2</em></span><span class="kw-pro-gstrip__meta"><span class="kw-pro-tc">01:04:12:18</span><span>Graded</span></span></li><li role="option" tabindex="0" aria-selected="true" aria-label="Clip 04, 01:04:17:00, graded, version v3"><span class="kw-pro-gstrip__pic"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" data-look="night" aria-hidden="true"><rect class="w" width="160" height="90"/><circle class="l" cx="26" cy="22" r="11" opacity=".35"/><circle class="l" cx="46" cy="33" r="5" opacity=".25"/><path class="b" d="M40 90c0-19 19-29 44-29s44 10 44 29z"/><rect class="s" x="76" y="52" width="16" height="14"/><ellipse class="s" cx="84" cy="40" rx="17" ry="21"/><path class="h" d="M66 42c0-17 8-25 19-25s18 8 18 23c-4-9-10-13-18-13s-14 7-19 15z"/><path class="m" d="M99 29c4 5 5 13 3 21l-3 4c2-9 2-17 0-25z" opacity=".85"/></svg><b>04</b><em>v3</em></span><span class="kw-pro-gstrip__meta"><span class="kw-pro-tc">01:04:17:00</span><span>Graded</span></span></li><li role="option" tabindex="-1" aria-selected="false" aria-label="Clip 05, 01:04:24:14, graded, version v1"><span class="kw-pro-gstrip__pic"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" data-look="night" aria-hidden="true"><rect class="w" width="160" height="90"/><rect class="d" x="70" y="14" width="76" height="50" rx="1"/><rect class="m" x="74" y="18" width="68" height="42"/><circle class="f" cx="108" cy="33" r="6"/><path class="f" d="M97 60c0-10 5-15 11-15s11 5 11 15z"/><path class="h" d="M-10 90c0-30 14-48 36-48s36 18 36 48z"/></svg><b>05</b><em>v1</em></span><span class="kw-pro-gstrip__meta"><span class="kw-pro-tc">01:04:24:14</span><span>Graded</span></span></li><li role="option" tabindex="-1" aria-selected="false" aria-label="Clip 06, 01:04:29:02, not graded"><span class="kw-pro-gstrip__pic"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" data-look="log" aria-hidden="true"><rect class="w" width="160" height="90"/><circle class="l" cx="26" cy="22" r="11" opacity=".35"/><circle class="l" cx="46" cy="33" r="5" opacity=".25"/><path class="b" d="M40 90c0-19 19-29 44-29s44 10 44 29z"/><rect class="s" x="76" y="52" width="16" height="14"/><ellipse class="s" cx="84" cy="40" rx="17" ry="21"/><path class="h" d="M66 42c0-17 8-25 19-25s18 8 18 23c-4-9-10-13-18-13s-14 7-19 15z"/><path class="m" d="M99 29c4 5 5 13 3 21l-3 4c2-9 2-17 0-25z" opacity=".85"/></svg><b>06</b><em>—</em></span><span class="kw-pro-gstrip__meta"><span class="kw-pro-tc">01:04:29:02</span><span class="kw-pro-dim">Not graded</span></span></li><li role="option" tabindex="-1" aria-selected="false" aria-label="Clip 07, 01:04:33:00, not graded"><span class="kw-pro-gstrip__pic"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" data-look="log" aria-hidden="true"><rect class="w" width="160" height="90"/><rect class="d" y="60" width="160" height="30"/><rect class="d" x="92" y="21" width="54" height="36" rx="1"/><rect class="m" x="95" y="24" width="48" height="30"/><circle class="f" cx="119" cy="34" r="3.5"/><path class="f" d="M112 54c0-7 3-10 7-10s7 3 7 10z"/><rect class="d" x="115" y="57" width="8" height="4"/><circle class="l" cx="24" cy="27" r="7"/><rect class="f" x="23" y="34" width="2" height="26"/><path class="b" d="M48 62c0-11 8-16 18-16s18 5 18 16z"/><circle class="s" cx="66" cy="37" r="7.5"/><path class="h" d="M58.5 37a7.5 7.5 0 0 1 15 0c-1-4-4-6-7.5-6s-6.5 2-7.5 6z"/></svg><b>07</b><em>—</em></span><span class="kw-pro-gstrip__meta"><span class="kw-pro-tc">01:04:33:00</span><span class="kw-pro-dim">Not graded</span></span></li><li role="option" tabindex="-1" aria-selected="false" aria-label="Clip 08, 01:04:38:10, not graded"><span class="kw-pro-gstrip__pic"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" data-look="log" aria-hidden="true"><rect class="d" width="160" height="90"/><rect class="m" x="12" y="9" width="136" height="70"/><rect class="f" x="12" y="62" width="136" height="17" opacity=".55"/><circle class="f" cx="80" cy="34" r="9"/><path class="f" d="M62 79c0-15 8-23 18-23s18 8 18 23z"/></svg><b>08</b><em>—</em></span><span class="kw-pro-gstrip__meta"><span class="kw-pro-tc">01:04:38:10</span><span class="kw-pro-dim">Not graded</span></span></li></ol></div>
  <div class="kw-pro-gver" role="group" aria-label="Versions of clip 04"><span class="kw-pro-dim">Clip 04 versions</span><button class="kw-pro-chipv" type="button" aria-pressed="false">v1 Balance</button><button class="kw-pro-chipv" type="button" aria-pressed="false">v2 Night look</button><button class="kw-pro-chipv" type="button" aria-pressed="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 6 9 17l-5-5"/></svg>v3 Night, warmer skin</button><button class="kw-pro-chipv kw-pro-chipv--rev" type="button" aria-pressed="false" title="Suggested by shot match. Not applied until you choose it.">* v4 Suggested match to still 3</button></div>
</section>
```

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| ← / → | Previous / next clip |
| ⌥ ↑ / ⌥ ↓ | Previous / next version of the clip |
| G | Grab still |
| W | Compare with the selected still |

### ARIA
- The strip is a `listbox` of clips named *Clip 04, 01:04:17:00, graded, version v3*.
- Versions are a group of toggle buttons; the suggested one includes *Suggested* in its name and says it is not applied.

## For agents

### Rules

- **Must** write Graded or Not graded in words on every clip.
- **Must** add a machine-suggested grade only as a new, marked version.
- **Never** overwrite a version; a change creates the next one.
- **Always** show the scene's grade note above its clips when one exists.

### AI readiness test

**Task:** Show a DP the grade versions of Scene 12 for approval.

**Give the agent:** Clips and grade versions, Compare viewer, Colour grading kit.

**Constraint:** The DP approves on a laptop; the colourist keeps all versions.

**A reliable answer:**
- Clips numbered with timecode
- Graded in words
- Version chips with current pressed
- Scene grade note shown
- Suggested match as marked new version
- Nothing overwritten
