Add optional card mode: server deals cards and settles showdowns automatically

- New "カードを配る" switch on the create-table screen (default off); the lobby
  shows "カードあり" for tables that use it
- Card mode (server/cards.js restored): crypto-shuffled deck kept server-side,
  hole cards sent only to their owner until showdown/all-in reveal, board dealt
  per street with burns, all-in runout on a timer (frozen while paused)
- Showdown is evaluated and every pot (incl. side pots, split pots) is paid out
  automatically; host winner selection is only used when card mode is off
- Play UI: board, hole cards, own cards in the action bar, hand names, winning
  cards highlighted; layout tuned for 7+ seats and short screens
- Playing-card styles use .pcard so they don't clash with the existing .card panel
- Tests for hand evaluation, card privacy, runout, side pots, ties and random play

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

server/hand.js

@@ -1,19 +1,29 @@
 'use strict';
 
-// 1ハンド分のチップの動き（ブラインド・ベッティング・ポット分配）。
-// カードは実物で配るので扱わない。ショーダウンでは勝者をプレイヤーが選ぶ。
+const { newDeck, bestHand, compareScore } = require('./cards');
+
+// 1ハンド分の進行（ブラインド・ベッティング・ポット分配）。
+// cards = false: カードは実物で配るので扱わない。ショーダウンでは勝者をホストが選ぶ。
+// cards = true : サーバが配り、ショーダウンで役を判定して自動で分配する。
 // seats は Table.seats への参照で、スタックはここで直接増減する。
 // 参加者の席はハンド終了まで空席にならない（退席者は Table 側で予約したまま）。
 const STREETS = ['PREFLOP', 'FLOP', 'TURN', 'RIVER'];
 
 class Hand {
-  constructor({ number, seats, order, button, sb, bb }) {
+  constructor({ number, seats, order, button, sb, bb, cards = false }) {
     this.number = number;
     this.seats = seats;
     this.order = order; // 参加者の席番号。ボタンの次から時計回り
     this.button = button;
     this.sb = sb;
     this.bb = bb;
+    this.cards = cards;
+
+    // 山札はサーバの外に出さない
+    this.deck = cards ? newDeck() : null;
+    this.board = [];
+    this.revealed = false; // ショーダウン・オールイン時に残った人の手札を公開
+    this.runout = false; // オールインでこれ以上ベットが無く、残りの場札を順にめくっている
 
     this.street = 'PREFLOP'; // PREFLOP / FLOP / TURN / RIVER / SHOWDOWN
     this.pot = 0; // 前のストリートまでに集めた額
@@ -29,6 +39,8 @@ class Hand {
       this.players.set(i, {
         seat: i,
         token: seats[i].token,
+        cards: [],
+        best: null, // ショーダウンでの最強の5枚
         bet: 0, // このストリートで出した額
         committed: 0, // このハンドで出した合計
         folded: false,
@@ -38,6 +50,7 @@ class Hand {
         won: 0,
       });
     }
+    if (cards) for (let r = 0; r < 2; r++) for (const i of order) this.players.get(i).cards.push(this.deck.pop());
 
     // ヘッズアップはボタンが SB
     const headsUp = order.length === 2;
@@ -53,8 +66,9 @@ class Hand {
     return this.order.map((i) => this.players.get(i));
   }
 
+  // 勝者の選択待ち（カードありのときは自動で判定するので来ない）
   get awaitingWinners() {
-    return this.street === 'SHOWDOWN' && !this.finished;
+    return !this.cards && this.street === 'SHOWDOWN' && !this.finished;
   }
 
   live() {
@@ -212,15 +226,41 @@ class Hand {
     this.currentBet = 0;
     this.minRaise = this.bb;
 
-    // リバーが終わった、または全員オールインでこれ以上ベットが無い → ショーダウン
-    if (this.street === 'RIVER' || this.live().filter((p) => !p.allIn).length < 2) {
-      this.street = 'SHOWDOWN';
-      return;
+    const noMoreBetting = this.live().filter((p) => !p.allIn).length < 2;
+    if (!this.cards) {
+      // リバーが終わった、または全員オールインでこれ以上ベットが無い → ショーダウン
+      if (this.street === 'RIVER' || noMoreBetting) {
+        this.street = 'SHOWDOWN';
+        return;
+      }
+      this.street = STREETS[STREETS.indexOf(this.street) + 1];
+    } else {
+      if (this.street === 'RIVER') return this.finishShowdown();
+      if (noMoreBetting) {
+        // 手札を公開して、残りの場札は Table のタイマーで順にめくる（runoutStep）
+        this.revealed = true;
+        this.runout = true;
+        return;
+      }
+      this.dealStreet();
     }
-    this.street = STREETS[STREETS.indexOf(this.street) + 1];
     this.setNextActor(this.button);
   }
 
+  dealStreet() {
+    this.deck.pop(); // バーン
+    if (this.street === 'PREFLOP') this.board.push(this.deck.pop(), this.deck.pop(), this.deck.pop());
+    else this.board.push(this.deck.pop());
+    this.street = STREETS[STREETS.indexOf(this.street) + 1];
+  }
+
+  // オールイン後に場札を1ストリート分めくる。リバーまでめくり終えていたらショーダウン
+  runoutStep() {
+    if (!this.runout || this.finished) return;
+    if (this.street === 'RIVER') this.finishShowdown();
+    else this.dealStreet();
+  }
+
   // メインポット・サイドポット（同じ参加者のポットはまとめる）
   buildPots() {
     const all = this.list;
@@ -258,38 +298,71 @@ class Hand {
       if (new Set(w).size !== w.length || !w.every((s) => pots[i].eligible.includes(s))) return '勝者の指定が不正です';
     }
 
-    const results = [];
-    pots.forEach((pot, i) => {
-      // 割り切れない端数はボタンの左から順に
-      const ws = this.order.filter((s) => winners[i].includes(s));
-      const share = Math.floor(pot.amount / ws.length);
-      let rest = pot.amount - share * ws.length;
-      for (const s of ws) {
-        const amount = share + (rest > 0 ? 1 : 0);
-        if (rest > 0) rest--;
-        this.players.get(s).won += amount;
-        this.seats[s].stack += amount;
-      }
-      results.push({ amount: pot.amount, winners: ws });
-    });
+    const results = pots.map((pot, i) => ({ amount: pot.amount, winners: this.payout(pot.amount, winners[i]) }));
     this.end(true, results);
     return null;
   }
 
+  // カードありのショーダウン: ポットごとに役を比べて分配する
+  finishShowdown() {
+    this.revealed = true;
+    for (const p of this.live()) p.best = bestHand(p.cards.concat(this.board));
+    const results = this.buildPots().map((pot) => {
+      const contenders = pot.eligible.map((s) => this.players.get(s));
+      let top = null;
+      for (const c of contenders) if (!top || compareScore(c.best.score, top) > 0) top = c.best.score;
+      const best = contenders.filter((c) => compareScore(c.best.score, top) === 0);
+      return {
+        amount: pot.amount,
+        winners: this.payout(pot.amount, best.map((c) => c.seat)),
+        handName: best[0].best.name,
+        bestCards: best[0].best.cards,
+      };
+    });
+    this.end(true, results);
+  }
+
+  // amount を seats で山分けする。割り切れない端数はボタンの左から順に。分配した順の席番号を返す
+  payout(amount, seats) {
+    const ws = this.order.filter((s) => seats.includes(s));
+    const share = Math.floor(amount / ws.length);
+    let rest = amount - share * ws.length;
+    for (const s of ws) {
+      const a = share + (rest > 0 ? 1 : 0);
+      if (rest > 0) rest--;
+      this.players.get(s).won += a;
+      this.seats[s].stack += a;
+    }
+    return ws;
+  }
+
   end(showdown, results) {
     this.finished = true;
+    this.runout = false;
     this.showdown = showdown;
     this.toAct = null;
     this.results = results;
   }
 
-  view() {
+  // 閲覧者に見せてよい情報だけを返す（他人の手札は公開時のみ）
+  view(viewerSeat, viewerToken) {
     const players = {};
     for (const p of this.list) {
-      players[p.seat] = { bet: p.bet, folded: p.folded, allIn: p.allIn, last: p.last, won: p.won };
+      const v = { bet: p.bet, folded: p.folded, allIn: p.allIn, last: p.last, won: p.won };
+      if (this.cards) {
+        const mine = p.seat === viewerSeat && p.token === viewerToken;
+        const shown = mine || (this.revealed && !p.folded);
+        v.cards = shown ? p.cards : null;
+        v.handName =
+          shown && !p.folded && this.board.length >= 3 ? (p.best || bestHand(p.cards.concat(this.board))).name : null;
+      }
+      players[p.seat] = v;
     }
     return {
       number: this.number,
+      cards: this.cards,
+      board: this.board,
+      runout: this.runout,
       street: this.street,
       pot: this.pot,
       potTotal: this.pot + this.list.reduce((sum, p) => sum + p.bet, 0),