# Cast board

> Every part the screenplay wrote, each opening to the people who might play it and how far each has got.

Source: https://kwark.space/designSystem/components/cast-board

## Usage

### When to use
In Cast & Crew, for the parts. Every part on the board came out of the screenplay; there is no way to invent a role here, because a role nobody wrote is a role nobody shoots (CastingBoard.tsx).

### When not to
- For crew, whom nobody wrote. Crew is a separate list in the same module.
- For the character as a story person. That is the [Character card](https://kwark.space/designSystem/components/character-card.md).

### The stages
Kwark's stages, with the line it shows under each:

| Stage | Line | Mark |
|---|---|---|
| Idea | A name somebody said out loud. | plain |
| Approached | The agent has the script. | blue edge |
| Read | They have auditioned or sent a tape. | blue edge |
| Callback | Back for a second look, or a chemistry read. | amber |
| Offer out | Terms are with them. | amber |
| Cast | Signed, and in the schedule. | green |
| Passed | Not this one, kept, because the next film exists. | faded |

The part's number is its cast ID, the same number the [Stripboard strip](https://kwark.space/designSystem/components/stripboard-strip.md) and call sheet use.

### Writing
Fees and contacts are behind Cast & Crew permission. Never copy a fee anywhere a wider role can read it (Decision 0022 review).

**Do:** Arjun, *Supporting · 6 scenes · 4 shoot days*, with *Offer out* in amber and three candidates.

**Don't:** A candidate rated with stars, or a part typed in by hand that is not in the script.

## Style

### Anatomy

Role row 11px × 14px, grid `40px 1fr auto 18px`; number box 32px mono; stage pill; caret rotates when open. Candidates 10px × 12px with a 3px left edge in the stage colour, on `--k-bg`.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-surface` | #ffffff | #1a1a1a |
| `--k-bg` | #f8fafc | #191919 |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-ok` | #2c6e49 | #6cc08a |
| `--k-ok-bg` | #e7f3ec | #17281e |
| `--k-warn` | #8a5a00 | #d8a44a |
| `--k-strip-int-night` | #8fb4d6 |  |
| `--k-accent` | #98633f | #98633f |

## Code

### React

In the Kwark app: `import { CastingBoard } from '@/pages/PreProduction/CastCrewModule/components/CastingBoard'`.

```tsx
<CastingBoard project={project} scenes={scenes} canEdit={canEdit} save={saveCasting} />
```

| Prop | Type | Notes |
|---|---|---|
| `project` | `Project \| null` |  |
| `scenes` | `ProductionScene[]` | roles come from the screenplay only |
| `canEdit` | `boolean` |  |
| `save` | `(record: CastingRecord) => void` |  |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<ul class="kw-roles">
  <li class="kw-role" data-open>
    <button class="kw-role__head" type="button" aria-expanded="true"><span class="kw-role__number">2</span><span class="kw-role__name"><strong>Arjun</strong><small>Supporting · 6 scenes · 4 shoot days</small></span><span class="kw-stage" data-stage="offer">Offer out</span><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="kw-caret"><path d="m6 9 6 6 6-6"/></svg></button>
    <div class="kw-role__body">
      <div class="kw-candidate" data-status="offer"><div><strong>Dev Malhotra</strong> <small>via Sana at Lumen Talent</small><br><small>Terms are with them.</small></div><button class="kw-button kw-button--sm" type="button">Mark as cast</button></div>
      <div class="kw-candidate" data-status="reading"><div><strong>Kabir Sethi</strong> <small>self-tape</small><br><small>They have auditioned or sent a tape.</small></div><button class="kw-button kw-button--sm" type="button">Call back</button></div>
      <div class="kw-candidate" data-status="passed"><div><strong>Rohan Iyer</strong> <small>Passed</small><br><small>Kept, because the next film exists.</small></div></div>
    </div>
  </li>
  <li class="kw-role" data-cast>
    <button class="kw-role__head" type="button" aria-expanded="false"><span class="kw-role__number">1</span><span class="kw-role__name"><strong>Mira</strong><small>Lead · 14 scenes · 9 shoot days</small></span><span class="kw-stage" data-stage="confirmed">Cast</span><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="kw-caret"><path d="m6 9 6 6 6-6"/></svg></button>
  </li>
</ul>
```

## Accessibility

- Each part is a disclosure: a button with `aria-expanded`.
- Stage is written as a word; the edge colour repeats it.
- Passed candidates stay in the accessibility tree; they are faded, not hidden.

## For agents

### Rules

- **Never** let anyone add a part that is not in the screenplay.
- **Must** write each stage as a word, with colour only repeating it.
- **Never** rate or rank actors.
- **Must** keep fees behind Cast & Crew permission.

### AI readiness test

**Task:** Add a chemistry-read note to a callback for Arjun.

**Give the agent:** Cast board, Sharing by film role.

**Constraint:** Only casting and the director can read notes.

**A reliable answer:**
- Note on the candidate, not the part
- Stage stays Callback
- Visible only to the allowed roles
- No ratings
