# ArmedRow

The list row that composes the grammar: arm ring, live chip, readiness dot, in-place rename, hover-revealed actions, context menu, reorder handle.

Install: `npx candlelight-ds add armed-row`

Category: instrument · Grammar: G1, G3, G6, G7, G8, G9, G10

## Use when

Rows in a SplitShell/StageShell list that arm an object for editing or performing.

## Don't use when

Multi-select tables (compose useSelection's styling contract yourself) or uniform archive rows (C5).

## States

- resting
- hover (actions reveal)
- armed (fill-active + accent ring)
- live (fill-selected + chip)
- renaming (Ink line seat)
- present-tense accent rule

## Keyboard

- `click / ↑↓ via surface map` — arms — staging, never execution (G1)
- `R via surface map` — flips `editing` — the Ink seat selects all

## Acceptance tests

- Clicking the row arms; it never plays (G3 — the audition trigger is explicit).
- Hover reveals affordances or nothing — no dead hover (G10).

## Files

- components/instruments/ArmedRow.tsx

npm dependencies: @candlelight-ds/tokens, clsx, tailwind-merge

Rendered twin: https://candlelight-docs.vercel.app/components/armed-row · Full spec: https://candlelight-docs.vercel.app/spec.md