From 9a5b974fda631f324abe1014ec0592b544054117 Mon Sep 17 00:00:00 2001
From: JoshHeaps <joheaps98@gmail.com>
Date: Mon, 31 Aug 2026 23:35:59 -0600
Subject: [PATCH] Add a rulings reference for the calls that come up mid-hand
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The tool handles the money; the other half of dealing is the calls. A home-game
dealer who isn't a pro has to rule on a misdeal or a prematurely turned board
card with a table watching, and the usual outcome is an argument settled by
whoever is loudest.

A "Common rulings" link under the table opens a reference for exactly the
situations that come up: what counts as a misdeal, what to do when the fourth
board card gets turned before the betting is finished, and how acting out of
turn is normally treated. It follows the Tournament Directors Association
rules, and says plainly that house rules win and that a dispute gets settled
between hands rather than during one.

It's a sheet rather than a sixth sidebar panel — a dealer consults this rarely
and needs it immediately, which is the opposite of what a panel is for.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015bnp7xKUPFFSpwkYNFaPgb
---
 JoshHeaps.Net/Pages/Casino/TexasHoldem.cshtml |  51 ++++++++
 JoshHeaps.Net/wwwroot/css/casino/holdem.css   | 115 ++++++++++++++++++
 .../wwwroot/js/casino/holdem/main.js          |  11 ++
 .../wwwroot/js/casino/holdem/shortcuts.js     |   2 +-
 4 files changed, 178 insertions(+), 1 deletion(-)

diff --git a/JoshHeaps.Net/Pages/Casino/TexasHoldem.cshtml b/JoshHeaps.Net/Pages/Casino/TexasHoldem.cshtml
index 8c2b5df..62684cd 100644
--- a/JoshHeaps.Net/Pages/Casino/TexasHoldem.cshtml
+++ b/JoshHeaps.Net/Pages/Casino/TexasHoldem.cshtml
@@ -35,6 +35,9 @@
                 <div id="seatsLayer"></div>
             </div>
             <p id="tableHint" class="tableHint"></p>
+            <p class="tableHintActions">
+                <button type="button" id="openRulingsBtn" class="linkBtn">Common rulings</button>
+            </p>
         </section>
 
         <aside id="holdemSidebar">
@@ -235,6 +238,54 @@
     </div>
 </template>
 
+<div id="rulingsOverlay" hidden>
+    <div id="rulingsSheet" role="dialog" aria-labelledby="rulingsTitle">
+        <div class="seatSheetGrip" aria-hidden="true"></div>
+        <div class="rulingsHeader">
+            <h2 id="rulingsTitle">Common rulings</h2>
+            <button id="closeRulingsBtn" class="holdemBtn holdemBtnSmall holdemBtnGhost" type="button">Done</button>
+        </div>
+
+        <p class="rulingsIntro">
+            The conventions most rooms follow, for the calls that come up mid-hand.
+            Your house rules always win — and settle a dispute before the next hand,
+            not during it.
+        </p>
+
+        <section class="ruling">
+            <h3>Redeal it — misdeal</h3>
+            <ul>
+                <li>The first card goes to the wrong seat.</li>
+                <li>A seat entitled to a hand gets dealt out, or a seat that isn't entitled gets dealt in.</li>
+                <li>Two or more boxed cards turn up on the initial deal.</li>
+                <li>Either of the first two cards is exposed by dealer error.</li>
+            </ul>
+        </section>
+
+        <section class="ruling">
+            <h3>A board card turned too early</h3>
+            <p>
+                If the fourth board card gets turned before the betting round is finished,
+                that card is out of play for the round. Finish the betting, then burn and
+                turn what would have been the fifth card in the fourth card's place.
+            </p>
+        </section>
+
+        <section class="ruling">
+            <h3>Acting out of turn</h3>
+            <p>
+                A one-off is usually just backed up if no one has acted behind them.
+                Doing it repeatedly is what earns a penalty.
+            </p>
+        </section>
+
+        <p class="rulingsSource">
+            Follows the Tournament Directors Association rules, which most rooms and
+            home games take their lead from.
+        </p>
+    </div>
+</div>
+
 <div id="seatMenuOverlay" hidden>
     <div id="seatMenuSheet" role="dialog" aria-labelledby="seatMenuTitle">
         <div class="seatSheetGrip" aria-hidden="true"></div>
diff --git a/JoshHeaps.Net/wwwroot/css/casino/holdem.css b/JoshHeaps.Net/wwwroot/css/casino/holdem.css
index 23b169e..0e48f2c 100644
--- a/JoshHeaps.Net/wwwroot/css/casino/holdem.css
+++ b/JoshHeaps.Net/wwwroot/css/casino/holdem.css
@@ -585,6 +585,121 @@ body {
     font-weight: 400;
 }
 
+/* ---------- Rulings reference ---------- */
+
+.tableHintActions {
+    margin: 0.35rem 0 0;
+    text-align: center;
+}
+
+.linkBtn {
+    background: none;
+    border: none;
+    padding: 0;
+    color: #a9782f;
+    font-family: inherit;
+    font-size: 0.78rem;
+    text-decoration: underline;
+    text-underline-offset: 2px;
+    cursor: pointer;
+}
+
+.linkBtn:hover {
+    color: #d8b46a;
+}
+
+#rulingsOverlay {
+    position: fixed;
+    inset: 0;
+    background: rgba(0, 0, 0, 0.72);
+    display: flex;
+    align-items: flex-end;
+    justify-content: center;
+    z-index: 97;
+}
+
+#rulingsOverlay[hidden] {
+    display: none;
+}
+
+#rulingsSheet {
+    width: 100%;
+    max-width: 460px;
+    max-height: 86vh;
+    overflow-y: auto;
+    background: linear-gradient(180deg, #242424, #1a1a1a);
+    border: 1px solid #3a3a3a;
+    border-bottom: none;
+    border-radius: 16px 16px 0 0;
+    padding: 0.35rem 1.1rem calc(1.2rem + env(safe-area-inset-bottom, 0px));
+    box-shadow: 0 -14px 40px rgba(0, 0, 0, 0.65);
+}
+
+.rulingsHeader {
+    display: flex;
+    align-items: center;
+    gap: 0.6rem;
+    margin-bottom: 0.5rem;
+}
+
+.rulingsHeader h2 {
+    flex: 1;
+    margin: 0;
+    font-size: 1.05rem;
+    font-weight: 500;
+    color: #f5f5f5;
+}
+
+.rulingsIntro {
+    margin: 0 0 1rem;
+    color: #9a9a9a;
+    font-size: 0.8rem;
+    line-height: 1.5;
+}
+
+.ruling {
+    margin-bottom: 1rem;
+    padding-left: 0.7rem;
+    border-left: 2px solid rgba(216, 180, 106, 0.4);
+}
+
+.ruling h3 {
+    margin: 0 0 0.35rem;
+    color: #d8b46a;
+    font-size: 0.82rem;
+    font-weight: 600;
+    letter-spacing: 0.03em;
+}
+
+.ruling p,
+.ruling li {
+    color: #c4c4c4;
+    font-size: 0.82rem;
+    line-height: 1.5;
+}
+
+.ruling p {
+    margin: 0;
+}
+
+.ruling ul {
+    margin: 0;
+    padding-left: 1.1rem;
+}
+
+.ruling li + li {
+    margin-top: 0.25rem;
+}
+
+.rulingsSource {
+    margin: 0;
+    padding-top: 0.6rem;
+    border-top: 1px solid #2c2c2c;
+    color: #7a7a7a;
+    font-size: 0.72rem;
+    line-height: 1.45;
+}
+
 /* ---------- Seat long-press menu ---------- */
 
 /* Held down, before the menu opens — the only feedback that a press is being
diff --git a/JoshHeaps.Net/wwwroot/js/casino/holdem/main.js b/JoshHeaps.Net/wwwroot/js/casino/holdem/main.js
index cb2cc36..a68cc98 100644
--- a/JoshHeaps.Net/wwwroot/js/casino/holdem/main.js
+++ b/JoshHeaps.Net/wwwroot/js/casino/holdem/main.js
@@ -260,6 +260,17 @@ document.addEventListener("DOMContentLoaded", () => {
 
     document.getElementById("closeSeatEditorBtn").addEventListener("click", () => Render.closeSeatEditor());
 
+    const rulingsOverlay = document.getElementById("rulingsOverlay");
+    const closeRulings = () => { rulingsOverlay.hidden = true; };
+    document.getElementById("openRulingsBtn").addEventListener("click", () => { rulingsOverlay.hidden = false; });
+    document.getElementById("closeRulingsBtn").addEventListener("click", closeRulings);
+    rulingsOverlay.addEventListener("click", e => {
+        if (e.target === rulingsOverlay) closeRulings();
+    });
+    document.addEventListener("keydown", e => {
+        if (e.key === "Escape" && !rulingsOverlay.hidden) closeRulings();
+    });
+
     document.getElementById("seatMenuCancelBtn").addEventListener("click", () => SeatMenu.close());
     document.getElementById("seatMenuOverlay").addEventListener("click", e => {
         if (e.target.id === "seatMenuOverlay") SeatMenu.close();
diff --git a/JoshHeaps.Net/wwwroot/js/casino/holdem/shortcuts.js b/JoshHeaps.Net/wwwroot/js/casino/holdem/shortcuts.js
index eb1077b..15ae99d 100644
--- a/JoshHeaps.Net/wwwroot/js/casino/holdem/shortcuts.js
+++ b/JoshHeaps.Net/wwwroot/js/casino/holdem/shortcuts.js
@@ -35,7 +35,7 @@ const Shortcuts = {
     // An overlay owns the keyboard while it's up: the confirm dialog already binds
     // Enter and Escape, and the card picker and seat menu are modal.
     overlayOpen() {
-        return ["confirmOverlay", "potWizardOverlay", "cardPickerOverlay", "seatMenuOverlay"]
+        return ["confirmOverlay", "potWizardOverlay", "cardPickerOverlay", "seatMenuOverlay", "rulingsOverlay"]
             .some(id => {
                 const el = document.getElementById(id);
                 return el && !el.hidden;
-- 
2.43.0