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>

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

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();

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;