F022 — Card Display

Field	Value
ID	F022
Phase	3 — UI
Jira	HEDGE-135
Status	TS ✅ fixed · JS ⬜ · UMA ⬜

Business Rule

At the hole stage, all hole cards for all hands must be face-up and visible to the player. Community cards (flop/turn/river) are dealt face-down and revealed progressively as each betting stage is reached.

JavaScript Reference

JS Source: hedgeem-v4/odobo/src/js/control.js The JS state machine deals all 13 cards (2 per hand × up to 4 hands + 5 community) via a sequence of CC_DEAL_CARDx states, all of which are CC_AUTO_ADVANCE. Each call to DealCard() reveals the card immediately. All hole cards are face-up before the first betting window (CC_ALLOW_BETS_1) is reached.

// control.js — CC_DEAL_CARD1 … CC_DEAL_CARD13 (auto-advance, no player input)
// DealCard() renders each card face-up as it is dealt.
// After CC_DEAL_CARD13 → CC_ALLOW_BETS_1 (hole betting window opens).

Community cards are initially rendered face-down and flipped when their stage is reached.

TypeScript Implementation

File: standalone_reference_client/src/scenes/GameScene.ts

Bug fixed (HEDGE-135)

The original face-up logic was:

const faceUp = hand === 0 || dealStatus >= 1;

This only revealed hole cards for hand 0. Hands 1, 2, and 3 were face-down at hole stage. Fix applied:

// All hole cards face-up once dealt — JS CC_DEAL_CARDx reveals all hands before CC_ALLOW_BETS_1.
// HEDGE-135.
const faceUp = true;

Community cards (hand === -1) are handled separately: face-up when dealStatus >= the stage that reveals them (flop=1, turn=2, river=3).

Acceptance Criteria

#	Criterion	JS	TS	UMA
AC1	All hole cards face-up at hole stage for all hands	⬜	✅	⬜
AC2	Community cards face-down at hole stage	⬜	✅	⬜
AC3	Flop cards revealed when flop stage reached	⬜	✅	⬜
AC4	Turn card revealed when turn stage reached	⬜	✅	⬜
AC5	River card revealed when river stage reached	⬜	✅	⬜
AC6	`cardData.length === 13` at page load (no player interaction)	⬜	✅	⬜

Version Parity

Version	Status	Notes
JS (reference)	⬜ Not audited	Auto-reveals via CC_DEAL_CARDx — assumed correct
TS	✅ Fixed	HEDGE-135 — was only revealing hand 0
UMA	⬜ Not audited	Phase 5

Test Coverage

Test	Location
All hole cards face-up at hole stage	`tests/features/F022-card-display.spec.ts`
Smoke — game renders at hole stage	`standalone_reference_client/tests/e2e/smoke.spec.ts`

F020 — Deal Button / Auto-deal on Load F043 — Config and Sound Controls

Overview

Game Engine

Betting

UI

Config

Bonus

V7 Horse Race

Platform

Lobby

F022 — Card Display

F022 — Card Display

Business Rule

JavaScript Reference

TypeScript Implementation

Bug fixed (HEDGE-135)

Acceptance Criteria

Version Parity

Test Coverage

​F022 — Card Display

​Business Rule

​JavaScript Reference

​TypeScript Implementation

​Bug fixed (HEDGE-135)

​Acceptance Criteria

​Version Parity

​Test Coverage

F022 — Card Display

Business Rule

JavaScript Reference

TypeScript Implementation

Bug fixed (HEDGE-135)

Acceptance Criteria

Version Parity

Test Coverage