# Marker list

> Every marker in the sequence by timecode, with colour and number, duration, the note or the screenplay line it points to, and who left it.

Source: https://kwark.space/designSystem/components/marker-list

## Usage

### What it is
Markers are how notes, VFX pulls and script references live in a cut. The list is where you read them all, jump to one, and export them for the people who act on them.

### When to use
- Beside the timeline in an editor or sound session; as the notes list in a review tool.

### When not to
- For tasks with owners and due dates: those belong in the production's task tools.

### Colours mean departments, words mean everything
| Colour | Default use |
|---|---|
| Mango | Director and producer notes |
| Aqua | Script lines (marker points at the screenplay) |
| Coral | VFX and picture fixes |
| Mint | Sound |

The colour helps the eye; the number, note and *From* column say the same thing in words. Teams can rename what each colour means in Settings.

### Kwark's angle
Script-linked markers show the line itself in screenplay type and *Scene 12 · page 14*. Choosing one moves the playhead; choosing the link opens the line in the screenplay. If the line is cut from the script, the marker stays and says *Line no longer in the script*.

**Do:** *M2 · 01:04:09:10 · 00:00:01:12 · “Who put you there?” · Scene 12 · page 14*.

**Don't:** A wall of coloured flags on the ruler with no list and no words.

## Style

### Anatomy

1. **Header**: title, count, filter (*All*, *Script lines*, *Notes*).
2. **Row** (26px): 10px colour swatch and number, timecode, duration (— for a point), the note or line, the source.
3. **Selected**: `--k-pro-control` row with a 2px `--k-text` bar.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-pro-panel` | #f6f7f9 | #19191b |
| `--k-pro-head` | #eceff3 | #202023 |
| `--k-pro-line` | #d3d9e0 | rgba(255, 255, 255, .09) |
| `--k-brand-mango` | #fac374 |  |
| `--k-brand-aqua` | #83cfd3 |  |
| `--k-brand-coral` | #f28b71 |  |
| `--k-brand-mint` | #badfcf |  |
| `--k-font-screenplay` | 'Courier Prime', 'Courier New', monospace |  |

### Numbers
| Part | Value |
|---|---|
| Row | 26px |
| Swatch | 10 × 10px, 2px corners |
| Line text | Courier Prime 12px |
| Narrow | *From* hides under 460px; it stays in the row's tooltip |

## 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-markers" aria-label="Markers, Scene 12 cut v4">
  <div class="kw-pro-bar"><strong>Markers</strong><span class="kw-pro-dim">5</span><span class="kw-pro-sp"></span><div class="kw-pro-seg kw-pro-seg--text" role="group" aria-label="Show"><button type="button" aria-pressed="true">All</button><button type="button" aria-pressed="false">Script lines</button><button type="button" aria-pressed="false">Notes</button></div></div>
  <div class="kw-pro-bin__scroll"><table class="kw-pro-table"><thead><tr><th scope="col"><span class="kw-visually-hidden">Colour</span></th><th scope="col">Timecode</th><th scope="col" class="kw-pro-c-num">Duration</th><th scope="col">Marker</th><th scope="col" class="kw-pro-c-line">From</th></tr></thead><tbody><tr tabindex="-1"><td><span class="kw-pro-swatch" style="--c:var(--k-brand-mango)"></span><span class="kw-pro-dim">M1</span></td><td class="kw-pro-tc">01:04:03:05</td><td class="kw-pro-c-num kw-pro-tc">—</td><td>Hold on the monitor longer</td><td class="kw-pro-c-line">Director · 14 Nov</td></tr><tr aria-selected="true" tabindex="0"><td><span class="kw-pro-swatch" style="--c:var(--k-brand-aqua)"></span><span class="kw-pro-dim">M2</span></td><td class="kw-pro-tc">01:04:09:10</td><td class="kw-pro-c-num kw-pro-tc">00:00:01:12</td><td><span class="kw-pro-line">“Who put you there?”</span></td><td class="kw-pro-c-line"><a class="kw-pro-link" href="#scene-12"><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="M15.5 3H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7.5z"/><path d="M15 3v5h5M8 13h8M8 17h5"/></svg><span>Scene 12 · page 14</span></a></td></tr><tr tabindex="-1"><td><span class="kw-pro-swatch" style="--c:var(--k-brand-aqua)"></span><span class="kw-pro-dim">M3</span></td><td class="kw-pro-tc">01:04:14:02</td><td class="kw-pro-c-num kw-pro-tc">00:00:02:05</td><td><span class="kw-pro-line">“I didn’t shoot this.”</span></td><td class="kw-pro-c-line"><a class="kw-pro-link" href="#scene-12"><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="M15.5 3H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7.5z"/><path d="M15 3v5h5M8 13h8M8 17h5"/></svg><span>Scene 12 · page 14</span></a></td></tr><tr tabindex="-1"><td><span class="kw-pro-swatch" style="--c:var(--k-brand-coral)"></span><span class="kw-pro-dim">M4</span></td><td class="kw-pro-tc">01:04:19:02</td><td class="kw-pro-c-num kw-pro-tc">—</td><td>VFX: replace the screen</td><td class="kw-pro-c-line">Editor · 15 Nov</td></tr><tr tabindex="-1"><td><span class="kw-pro-swatch" style="--c:var(--k-brand-mint)"></span><span class="kw-pro-dim">M5</span></td><td class="kw-pro-tc">01:04:22:00</td><td class="kw-pro-c-num kw-pro-tc">—</td><td>Room tone gap under the cut</td><td class="kw-pro-c-line">Sound · 15 Nov</td></tr></tbody></table></div>
</section>
```

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| ↑ / ↓ | Move selection |
| Enter | Move the playhead to the marker |
| ⌘ Enter | Open the linked script line |
| Delete | Remove the marker (Undo restores it) |

### ARIA
- A `<table>` with column headers; the colour column has a visually hidden header *Colour*.
- Rows use roving `tabindex` and `aria-selected`.

## For agents

### Rules

- **Must** list markers by timecode with number, note and source.
- **Never** rely on marker colour alone; the note and source say it in words.
- **Must** keep a script-linked marker when its line is cut, and say so.
- **Always** make deleting a marker undoable instead of asking for confirmation.

### AI readiness test

**Task:** Export the director's notes on cut v4 for the editor.

**Give the agent:** Marker list, Edit timeline, Timecode display.

**Constraint:** Some notes point at script lines.

**A reliable answer:**
- Rows by timecode
- Number, duration, note, source
- Script lines in screenplay type with scene and page
- Filter for script lines
- Delete is undoable
