# Card Reveal Rules

## Purpose
Defines when hole cards are revealed during gameplay, ensuring proper showdown and all-in card visibility while keeping folded cards hidden.

## Requirements

### Requirement: Showdown reveals all remaining player cards
When the betting round reaches `showdown`, the hole cards of all players who have not folded SHALL be visible to the human player.

#### Scenario: Normal showdown with multiple players
- **WHEN** `bettingRound` is `showdown` and two or more players are still active or all-in
- **THEN** all non-folded players' hole cards are revealed on the table

### Requirement: All-in player cards reveal when betting ends
When a player goes all-in and no further betting is possible among the remaining active players, the all-in player's hole cards SHALL be revealed.

#### Scenario: All-in with no further bets possible
- **WHEN** a player is `all-in` and all other active players have matched their bet (no more raises or calls possible)
- **THEN** the all-in player's hole cards become visible

### Requirement: Folded player cards remain hidden
Players who have folded SHALL never have their hole cards revealed, regardless of game state.

#### Scenario: Folded player at showdown
- **WHEN** a player has `status === 'folded'` and the hand reaches showdown
- **THEN** the folded player's cards remain face-down (mucked)