# Location card

> A candidate place for a scene's location: photo, status from Idea to Locked, address and what it costs.

Source: https://kwark.space/designSystem/components/location-card

## Usage

### When to use
In Locations: each place the script names (EDIT SUITE, ROOFTOP) has candidates, each a card. Locking a candidate shortlists any other lock for the same place, so a place has one locked location.

### When not to
- For the story's places in the World module. Those are fiction; this is a real address.
- For reference photos without a candidacy. Use the [Media grid](https://kwark.space/designSystem/components/media-grid.md).

### Statuses
Idea, Recce, Shortlist, Locked, Dropped. Locked has a green edge; Dropped fades to 55% and stays, because the reason it was dropped matters next time. The place list beside the cards shows a dot: red ring (nothing yet), amber (searching), green (locked).

### Writing
The card says what it is for in the script's terms: *for EDIT SUITE · Scenes 12, 15*. Dropped cards keep the reason: *No night permits*.

**Do:** *Lumen Studios, Stage 2 · Locked · for EDIT SUITE · 45,000 a day*.

**Don't:** Three cards marked Locked for the same scene location.

## Style

### Anatomy

Grid of 240px minimum. Photo 16:10 with a hatched empty state; status label top left; body 10px × 12px with 15px name.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-raise` | #f1f5f9 | #252525 |
| `--k-surface` | #ffffff | #1a1a1a |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-ok` | #2c6e49 | #6cc08a |
| `--k-warn` | #8a5a00 | #d8a44a |
| `--k-danger` | #b4382c | #e0685c |
| `--k-strip-ink` | #1f2427 |  |
| `--k-paper` | #fbfbf8 |  |

## Code

### React

In the Kwark app: `import LocationsPage from '@/pages/PreProduction/LocationsModule/LocationsPage'`.

```tsx
// .po-candidate; statuses in shared/locations.ts LOCATION_STATUSES
```

| Prop | Type | Notes |
|---|---|---|
| `status` | `'idea' \| 'recce' \| 'shortlist' \| 'locked' \| 'dropped'` | locking one unlocks the previous lock for the same place |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<div class="kw-locations">
  <article class="kw-location" data-status="locked"><button class="kw-location__open" type="button"><span class="kw-location__photo"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-5-5L5 21"/></svg><span class="kw-location__status">Locked</span></span><span class="kw-location__body"><strong>Lumen Studios, Stage 2</strong><small>for EDIT SUITE · Scenes 12, 15</small><span class="kw-location__meta"><span>Andheri East</span><span>45,000 a day</span></span></span></button></article>
  <article class="kw-location" data-status="recce"><button class="kw-location__open" type="button"><span class="kw-location__photo"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-5-5L5 21"/></svg><span class="kw-location__status">Recce</span></span><span class="kw-location__body"><strong>Old Film Lab rooftop</strong><small>for ROOFTOP · Scene 13</small><span class="kw-location__meta"><span>Recce Tue 19, 16:00</span></span></span></button></article>
  <article class="kw-location" data-status="dropped"><button class="kw-location__open" type="button"><span class="kw-location__photo"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-5-5L5 21"/></svg><span class="kw-location__status">Dropped</span></span><span class="kw-location__body"><strong>Hotel terrace</strong><small>for ROOFTOP · Scene 13</small><span class="kw-location__meta"><span>No night permits</span></span></span></button></article>
</div>
<p class="kw-meta" style="display:flex;gap:8px;align-items:center"><span class="kw-place-dot" data-progress="locked"></span>Edit suite, locked <span class="kw-place-dot" data-progress="searching"></span>Rooftop, searching <span class="kw-place-dot"></span>Street, nothing yet</p>
```

## Accessibility

- The card is one button opening the candidate; status is in its text.
- The place dots are paired with words.

## For agents

### Rules

- **Must** allow only one locked candidate per scripted place.
- **Always** keep dropped candidates and their reason.
- **Must** name the scripted place on each card.

### AI readiness test

**Task:** Lock the rooftop candidate after the recce.

**Give the agent:** Location card, Budget top sheet, Call sheet.

**Constraint:** Another candidate was locked earlier.

**A reliable answer:**
- New candidate Locked
- Previous moves to Shortlist
- Budget line follows the new cost per day
- Call sheet location updates in the draft only
