# Clip inspector

> Properties of the selected clip in dense rows: scrubbable numbers with units, a keyframe diamond per row, reset per section, and the slate and script line the clip came from.

Source: https://kwark.space/designSystem/components/clip-inspector

## Usage

### What it is
The right-hand panel of an editor. It shows what the selected clip does to the picture and sound, and where it came from. Every value is a number you can type, drag or reset.

### When to use
- Beside the timeline when one clip is selected. With several selected, show shared values and *Mixed* for the rest.

### When not to
- For project settings (those live in Settings) or for grades (the [Colour wheels](https://kwark.space/designSystem/components/colour-wheels.md) and nodes).

### Rows
- Label left (12px), value right with its unit (%, px, °), keyframe diamond at the end.
- **Diamond states**: outline = no animation; outline in mango = animated, playhead between keys; filled = a key at this frame.
- Drag a number left or right to scrub it; ⇧ for fine steps. Click to type.
- Each section has *Reset* (a glyph with a name).

### Kwark's angle
The last section, *From the slate and the script*, reads scene, shot, take, circled, camera, source range and the line. *Page 14 · “Who put you there?”* opens the screenplay at that line.

**Do:** *Zoom 104.0 %* with an animated diamond; *Position X 0.0 px Y −18.0 px* with a key here.

**Don't:** An unlabelled slider from 0 to 100 with no unit and no way to type.

## Style

### Anatomy

1. **Tabs** (28px): Video, Audio, Speed, Slate.
2. **Section head** (26px): 12px 600 title, reset button.
3. **Row** (28px): 88px label column, fields, 22px keyframe button.
4. **Number field**: 22px, `--k-pro-control`, 1px `--k-pro-line`, 4px corners, value right-aligned tabular, unit in `--k-text-2`; `ew-resize` cursor.
5. **Slate list**: description list, 12px, labels in `--k-text-2`.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-pro-panel` | #f6f7f9 | #19191b |
| `--k-pro-head` | #eceff3 | #202023 |
| `--k-pro-control` | #ffffff | #2a2a2e |
| `--k-pro-line` | #d3d9e0 | rgba(255, 255, 255, .09) |
| `--k-pro-trim` | #9a6200 | #fac374 |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |

### Numbers
| Part | Value |
|---|---|
| Label column | 88px |
| Field | 22px tall, min 64px wide |
| Keyframe button | 22 × 22px, 12px diamond |
| Animated diamond | 1.75px `--k-pro-trim` outline |
| Key here | filled `--k-pro-trim` |

## 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-insp" aria-label="Inspector, 12B-1 Mira CU">
  <div class="kw-pro-bar"><strong>Inspector</strong><span class="kw-pro-dim kw-pro-ellip">12B-1 · Mira CU</span></div>
  <div class="kw-pro-tabs" role="tablist" aria-label="Clip properties"><button role="tab" type="button" aria-selected="true">Video</button><button role="tab" type="button" aria-selected="false">Audio</button><button role="tab" type="button" aria-selected="false">Speed</button><button role="tab" type="button" aria-selected="false">Slate</button></div>
  <div class="kw-pro-insp__sec"><div class="kw-pro-insp__h"><strong>Transform</strong><button class="kw-pro-btn" type="button" aria-label="Reset transform" title="Reset transform"><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="M3 12a9 9 0 1 0 2.7-6.4L3 8M3 3v5h5"/></svg></button></div>
    <div class="kw-pro-insp__row"><span class="kw-pro-insp__label">Zoom</span><span class="kw-pro-insp__fields"><label class="kw-pro-num"><input type="text" inputmode="decimal" value="104.0" aria-label="Zoom"><em>%</em></label></span><button class="kw-pro-btn kw-pro-kf is-anim" type="button" aria-label="Zoom: add keyframe" title="Zoom: add keyframe"><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="M12 3.5 20.5 12 12 20.5 3.5 12z"/></svg></button></div>
    <div class="kw-pro-insp__row"><span class="kw-pro-insp__label">Position</span><span class="kw-pro-insp__fields"><label class="kw-pro-num"><span>X</span><input type="text" inputmode="decimal" value="0.0" aria-label="Position X"><em>px</em></label><label class="kw-pro-num"><span>Y</span><input type="text" inputmode="decimal" value="−18.0" aria-label="Position Y"><em>px</em></label></span><button class="kw-pro-btn kw-pro-kf is-on" type="button" aria-label="Position: remove keyframe here" title="Position: remove keyframe here"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M12 3.5 20.5 12 12 20.5 3.5 12z"/></svg></button></div>
    <div class="kw-pro-insp__row"><span class="kw-pro-insp__label">Rotation</span><span class="kw-pro-insp__fields"><label class="kw-pro-num"><input type="text" inputmode="decimal" value="0.0" aria-label="Rotation"><em>°</em></label></span><button class="kw-pro-btn kw-pro-kf" type="button" aria-label="Rotation: add keyframe" title="Rotation: add keyframe"><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="M12 3.5 20.5 12 12 20.5 3.5 12z"/></svg></button></div>
  </div>
  <div class="kw-pro-insp__sec"><div class="kw-pro-insp__h"><strong>Composite</strong><button class="kw-pro-btn" type="button" aria-label="Reset composite" title="Reset composite"><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="M3 12a9 9 0 1 0 2.7-6.4L3 8M3 3v5h5"/></svg></button></div>
    <div class="kw-pro-insp__row"><span class="kw-pro-insp__label">Opacity</span><span class="kw-pro-insp__fields"><label class="kw-pro-num"><input type="text" inputmode="decimal" value="100.0" aria-label="Opacity"><em>%</em></label></span><button class="kw-pro-btn kw-pro-kf" type="button" aria-label="Opacity: add keyframe" title="Opacity: add keyframe"><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="M12 3.5 20.5 12 12 20.5 3.5 12z"/></svg></button></div>
    <div class="kw-pro-insp__row"><span class="kw-pro-insp__label">Blend</span><span class="kw-pro-insp__fields"><button class="kw-pro-btn kw-pro-btn--menu kw-pro-btn--field" type="button" aria-haspopup="listbox" aria-label="Blend mode: Normal">Normal<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="m6 9 6 6 6-6"/></svg></button></span><span></span></div>
  </div>
  <div class="kw-pro-insp__sec" data-slate><div class="kw-pro-insp__h"><strong>From the slate and the script</strong></div>
    <dl class="kw-pro-dl"><dt>Scene</dt><dd>12 · INT. EDIT SUITE – NIGHT</dd><dt>Shot · take</dt><dd>12B · take 1 <span class="kw-pro-take" data-circled>1</span> circled</dd><dt>Camera</dt><dd>A · 40 mm · A003C012</dd><dt>Source</dt><dd class="kw-pro-tc">14:22:27:00 – 14:22:33:06</dd><dt>Script</dt><dd><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>Page 14 · <span class="kw-pro-line">“Who put you there?”</span></span></a></dd></dl>
  </div>
</section>
```

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| Tab | Next field |
| ↑ / ↓ in a field | +1 / −1 (⇧ ×10, ⌥ ×0.1) |
| Enter | Commit; Esc reverts |
| K | Toggle a keyframe on the focused property |

### ARIA
- Fields are text inputs with `inputmode="decimal"` and a label that includes the axis (*Position Y*).
- Keyframe buttons name the property and the action: *Position: remove keyframe here*.
- Mixed values read *Mixed* as the value, not an empty field.

## For agents

### Rules

- **Must** show a unit beside every number.
- **Must** allow typing, dragging and arrow-key steps on every value.
- **Always** show keyframe state with shape (outline, filled), never colour alone.
- **Always** give each section a named Reset.
- **Never** hide where a clip came from; show slate and script line.

### AI readiness test

**Task:** Add speed and transform properties to a clip inspector.

**Give the agent:** Clip inspector, Edit timeline, Timecode display.

**Constraint:** Several clips may be selected at once.

**A reliable answer:**
- Units on every value
- Typed and dragged entry
- Keyframe diamonds outline/filled
- Mixed for differing values
- Slate section with the script line
