# Quickstart: Bottom Bar Overhaul

## Key Files to Modify

| File | Purpose |
|------|---------|
| `apps/web/src/components/action-bar.tsx` | Primary target: overhaul with batch queue, custom fields, stat block button |
| `apps/web/src/hooks/use-encounter.ts` | Extend `addCombatant` to accept optional fields (initiative, AC, maxHp) |
| `apps/web/src/App.tsx` | Wire stat block view callback to action bar |
| `apps/web/src/components/bestiary-search.tsx` | Likely removable after merging into unified action bar flow |

## Key Files to Read (context)

| File | Why |
|------|-----|
| `packages/domain/src/types.ts` | Combatant type definition |
| `packages/domain/src/add-combatant.ts` | Domain add function (not modified, but understand contract) |
| `packages/domain/src/auto-number.ts` | Name deduplication logic for batch adds |
| `apps/web/src/hooks/use-bestiary.ts` | SearchResult type, search function |
| `apps/web/src/components/stat-block-panel.tsx` | Stat block panel for viewer integration |

## Implementation Approach

1. **Batch add**: Add `QueuedCreature` state (`{ result, count } | null`) to action bar. On dropdown entry click: if same entry, increment count; if different, replace. On confirm/Enter, loop `addFromBestiary(result)` N times.

2. **Custom fields**: When `suggestions.length === 0` and query is non-empty, show initiative/AC/maxHP inputs. Extend `onAddCombatant` to accept optional stats object. In `use-encounter.ts`, patch the new combatant with provided values after creation.

3. **Stat block viewer**: Accept `onViewStatBlock(result: SearchResult)` prop. Repurpose the search button icon to trigger it with the currently highlighted dropdown entry. Wire in App.tsx to derive `CreatureId` and open stat block panel.

4. **Unified flow**: Remove `searchOpen` toggle state. The input field always shows bestiary suggestions inline. Remove or deprecate `BestiarySearch` component.

## Development Commands

```bash
pnpm --filter web dev          # Dev server at localhost:5173
pnpm test                      # Run all tests
pnpm check                     # Full merge gate (must pass before commit)
pnpm vitest run <file>         # Run single test file
```