# Camera setup card

> A camera position prepared for the crew: the shots it covers, the creative approach, optics, and what was actually recorded.

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

## Usage

### When to use
In Camera & Light, Setups: one card per camera position, built from the screenplay and the existing shot list. It ends in an issued crew packet, and on the day records what was actually shot, for the camera report.

### When not to
- For a single shot's framing. That is the [Shot card](https://kwark.space/designSystem/components/shot-card.md).
- For a lens calculator detached from a setup.

### Anatomy in use
- **Setup tabs**: name, the shots it covers, status.
- **Status**: Draft, Review, Ready to issue.
- **Main**: shots covered, creative approach, lighting plan (or *Available light only*), support and rig, crew notes.
- **Optics side**: camera and mode, lens, T-stop, EI / ISO, white balance in kelvin, angle of view, lens to subject, frame width, hyperfocal, circle of confusion.
- **Actual**: on the day, actual camera, recording, EI, white balance, T-stop, and *Differences from plan*.

### Conventions
T-stops (T2.8) for cine lenses, f-stops only for stills lenses. White balance in kelvin (3200K, 5600K). Distances in the project's unit, stated.

### Writing
Approaches are the DP's words. Kwark never rates a setup.

**Do:** *T2.8 · EI 800 · 3200K* with *Differences from plan: shot at T2 for the monitor*.

**Don't:** A setup marked *Ready* with no shots covered, or optics without units.

## Style

### Anatomy

Grid `1fr minmax(230px, 280px)`; both panes 14px on `--k-raise` with 10px corners. Side: definition list with values right-aligned in mono.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-raise` | #f1f5f9 | #252525 |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-accent` | #98633f | #98633f |
| `--k-font-mono` | ui-monospace, 'SF Mono', Menlo, Consolas, monospace |  |
| `--k-text-2` | #5b6779 | #9ca3af |

## Code

### React

In the Kwark app: `import SetupWorkspace from '@/pages/PreProduction/CameraLight/SetupWorkspace'`.

```tsx
// Camera & Light → Setups (SetupWorkspace.tsx, SetupOpticsPanel.tsx)
<SetupWorkspace production={production} />
```

| Prop | Type | Notes |
|---|---|---|
| `status` | `'draft' \| 'review' \| 'ready'` | Draft → Review → Ready to issue |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<div class="kw-setup-tabs" role="group" aria-label="Setups in Scene 12"><button type="button" aria-pressed="true">Setup 1<small>12A, 12C · Draft</small></button><button type="button" aria-pressed="false">Setup 2<small>12B · Ready to issue</small></button></div>
<div class="kw-setup">
  <div class="kw-setup__main">
    <h3 class="kw-setup__title">Setup 1 · doorway</h3>
    <span class="kw-setup__state" aria-label="Status"><span aria-current="step">Draft</span><span>Review</span><span>Ready to issue</span></span>
    <dl class="kw-dl" style="margin-top:12px"><dt>Shots covered</dt><dd>12A, 12C</dd><dt>Creative approach</dt><dd>Observational, locked off</dd><dt>Lighting</dt><dd>Available light only</dd><dt>Support / rig</dt><dd>Sticks, low hi-hat</dd></dl>
  </div>
  <aside class="kw-setup__side"><h4>Optics</h4><dl><dt>Camera / mode</dt><dd>S35 4K</dd><dt>Lens</dt><dd>40mm</dd><dt>T-stop</dt><dd>T2.8</dd><dt>EI / ISO</dt><dd>800</dd><dt>White balance</dt><dd>3200K</dd><dt>Angle of view</dt><dd>33.4°</dd><dt>Hyperfocal</dt><dd>9.6 m</dd></dl></aside>
</div>
```

## Accessibility

- Status steps use `aria-current="step"`.
- Every value has a visible label and unit.
- Setup tabs are toggle buttons with `aria-pressed`.

## For agents

### Rules

- **Must** state the unit of every optical value.
- **Must** use T-stops for cine lenses.
- **Always** keep planned and actual values side by side once shot.

### AI readiness test

**Task:** Record the actual values for Setup 1 after the shoot.

**Give the agent:** Camera setup card, Call sheet, Dailies frame.

**Constraint:** The DP changed the stop on the day.

**A reliable answer:**
- Actual T-stop recorded separately from plan
- Differences from plan written
- Units shown
- Plan unchanged
