@pokertools/engine 1.0.8 → 1.0.10

package/dist/engine/{gameReducer.js → game-reducer.js}

@@ -5,11 +5,11 @@ const validation_1 = require("../actions/validation");
 const dealing_1 = require("../actions/dealing");
 const betting_1 = require("../actions/betting");
 const management_1 = require("../actions/management");
-const showdownActions_1 = require("../actions/showdownActions");
+const showdown_actions_1 = require("../actions/showdown-actions");
 const tournament_1 = require("../actions/tournament");
 const special_1 = require("../actions/special");
-const streetProgression_1 = require("../actions/streetProgression");
-const sidePots_1 = require("../rules/sidePots");
+const street_progression_1 = require("../actions/street-progression");
+const side_pots_1 = require("../rules/side-pots");
 const showdown_1 = require("../rules/showdown");
 const invariants_1 = require("../utils/invariants");
 const constants_1 = require("../utils/constants");
@@ -22,12 +22,9 @@ const constants_1 = require("../utils/constants");
  * @returns New game state
  */
 function gameReducer(state, action) {
-    // Validate action
     (0, validation_1.validateAction)(state, action);
-    // Apply action based on type
     let newState;
     switch (action.type) {
-        // Management actions
         case "SIT" /* ActionType.SIT */:
             newState = (0, management_1.handleSit)(state, action);
             break;
@@ -40,11 +37,9 @@ function gameReducer(state, action) {
         case "RESERVE_SEAT" /* ActionType.RESERVE_SEAT */:
             newState = (0, management_1.handleReserveSeat)(state, action);
             break;
-        // Dealing
         case "DEAL" /* ActionType.DEAL */:
             newState = (0, dealing_1.handleDeal)(state, action);
             break;
-        // Betting actions
         case "FOLD" /* ActionType.FOLD */:
             newState = (0, betting_1.handleFold)(state, action);
             break;
@@ -54,14 +49,12 @@ function gameReducer(state, action) {
         case "CALL" /* ActionType.CALL */:
             newState = (0, betting_1.handleCall)(state, action);
             break;
+        // Auto-convert BET to RAISE/CALL when there's already a wager.
+        // Note: action.amount is the TOTAL bet, not the increment.
         case "BET" /* ActionType.BET */:
-            // Auto-convert BET to appropriate action if there's already a bet
-            // This handles UI implementations that don't distinguish between BET/CALL/RAISE buttons
-            // Note: action.amount is the TOTAL bet size, not the amount to add
             const currentBet = Math.max(...Array.from(state.currentBets.values()), 0);
             if (currentBet > 0 && "amount" in action) {
                 if (action.amount === currentBet) {
-                    // Amount equals current bet -> Convert to CALL
                     const callAction = {
                         type: "CALL" /* ActionType.CALL */,
                         playerId: action.playerId,
@@ -70,7 +63,6 @@ function gameReducer(state, action) {
                     newState = (0, betting_1.handleCall)(state, callAction);
                 }
                 else if (action.amount > currentBet) {
-                    // Amount exceeds current bet -> Convert to RAISE
                     const raiseAction = {
                         type: "RAISE" /* ActionType.RAISE */,
                         playerId: action.playerId,
@@ -80,7 +72,7 @@ function gameReducer(state, action) {
                     newState = (0, betting_1.handleRaise)(state, raiseAction);
                 }
                 else {
-                    // Amount is less than current bet -> Keep as BET (will fail validation)
+                    // amount < currentBet: pass through (will fail validation)
                     newState = (0, betting_1.handleBet)(state, action);
                 }
             }
@@ -91,14 +83,12 @@ function gameReducer(state, action) {
         case "RAISE" /* ActionType.RAISE */:
             newState = (0, betting_1.handleRaise)(state, action);
             break;
-        // Showdown actions
         case "SHOW" /* ActionType.SHOW */:
-            newState = (0, showdownActions_1.handleShow)(state, action);
+            newState = (0, showdown_actions_1.handleShow)(state, action);
             break;
         case "MUCK" /* ActionType.MUCK */:
-            newState = (0, showdownActions_1.handleMuck)(state, action);
+            newState = (0, showdown_actions_1.handleMuck)(state, action);
             break;
-        // Special actions
         case "TIMEOUT" /* ActionType.TIMEOUT */:
             newState = (0, special_1.handleTimeout)(state, action);
             break;
@@ -109,30 +99,24 @@ function gameReducer(state, action) {
             newState = (0, tournament_1.handleNextBlindLevel)(state, action);
             break;
         default:
-            // Unknown action type
             newState = state;
             break;
     }
-    // Check if we should progress to next street
-    if ((0, streetProgression_1.shouldProgressStreet)(newState)) {
-        // Recalculate pots before progressing
-        newState = (0, sidePots_1.recalculatePots)(newState);
-        newState = (0, streetProgression_1.progressStreet)(newState);
+    // Recalculate pots, then progress street.
+    if ((0, street_progression_1.shouldProgressStreet)(newState)) {
+        newState = (0, side_pots_1.recalculatePots)(newState);
+        newState = (0, street_progression_1.progressStreet)(newState);
     }
-    // Check if we should go to showdown
     if ((0, showdown_1.shouldShowdown)(newState)) {
-        newState = {
-            ...newState,
-            street: newState.street, // Keep current street for showdown
-        };
         newState = (0, showdown_1.determineWinners)(newState);
     }
-    // Audit chip conservation (throws on failure)
-    // Enabled by default, can be disabled via config (not recommended for production)
+    if (newState.actionTo !== null && newState.players[newState.actionTo]?.isSittingOut) {
+        newState = { ...newState, actionTo: null };
+    }
+    // Integrity check; can be disabled via config (not recommended for production).
     if (newState.config.validateIntegrity !== false) {
         (0, invariants_1.validateGameStateIntegrity)(newState);
     }
-    // Add to previous states for undo
     const previousStates = [...newState.previousStates, state].slice(-constants_1.MAX_UNDO_HISTORY);
     return {
         ...newState,

package/dist/engine/{PokerEngine.js → poker-engine.js}

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PokerEngine = void 0;
-const gameReducer_1 = require("./gameReducer");
-const viewMasking_1 = require("../utils/viewMasking");
+const game_reducer_1 = require("./game-reducer");
+const view_masking_1 = require("../utils/view-masking");
 const serialization_1 = require("../utils/serialization");
-const ConfigError_1 = require("../errors/ConfigError");
+const config_error_1 = require("../errors/config-error");
 const exporter_1 = require("../history/exporter");
 const validation_1 = require("../utils/validation");
 /**
@@ -12,20 +12,18 @@ const validation_1 = require("../utils/validation");
  * Wraps the pure reducer with a stateful API
  */
 class PokerEngine {
+    currentState;
+    listeners = [];
+    timeProvider;
     constructor(config, timeProvider = () => Date.now()) {
-        this.listeners = [];
-        // Validate config
         this.validateConfig(config);
-        // Initialize time provider
         this.timeProvider = timeProvider;
-        // Initialize state
         this.currentState = this.createInitialState(config);
     }
     /**
      * Add a player to the table
      */
     sit(seat, id, name, stack) {
-        // Validate chip amount is a non-negative integer
         (0, validation_1.validateChipAmount)(stack, "Sit stack");
         const action = {
             type: "SIT" /* ActionType.SIT */,
@@ -63,13 +61,10 @@ class PokerEngine {
      * If action.timestamp is not provided, the engine will automatically set it
      */
     act(action) {
-        // Ensure timestamp is set
         const timestamp = action.timestamp ?? this.timeProvider();
-        // Validate timestamp if provided by caller
         if (action.timestamp !== undefined) {
             (0, validation_1.validateTimestamp)(timestamp, this.currentState.timestamp);
         }
-        // Validate chip amounts for betting actions
         if ("amount" in action && typeof action.amount === "number") {
             (0, validation_1.validateChipAmount)(action.amount, `${action.type} amount`);
         }
@@ -86,10 +81,8 @@ class PokerEngine {
      */
     validate(action) {
         try {
-            // Dry-run the reducer
-            // We don't need to deep clone state because reducer is immutable
-            // and pure, and we discard the result.
-            (0, gameReducer_1.gameReducer)(this.currentState, action);
+            // Dry-run the reducer; we discard the result since it's immutable and pure.
+            (0, game_reducer_1.gameReducer)(this.currentState, action);
             return { valid: true };
         }
         catch (err) {
@@ -110,11 +103,8 @@ class PokerEngine {
         // Hydrate PublicState into GameState if needed
         const newState = {
             ...serverState,
-            // Ensure deck exists (empty for client/public state)
             deck: "deck" in serverState ? serverState.deck : [],
-            // Ensure players map correctly (PublicPlayer.hand is compatible with Player.hand)
-            players: serverState.players, // Type assertion needed due to deep readonly/mutable mismatch potential
-            // Ensure config carries isClient flag if set locally
+            players: serverState.players,
             config: {
                 ...serverState.config,
                 isClient: this.currentState.config.isClient,
@@ -129,7 +119,7 @@ class PokerEngine {
     optimisticAct(action) {
         const timestamp = action.timestamp ?? this.timeProvider();
         const actionWithTimestamp = { ...action, timestamp };
-        return (0, gameReducer_1.gameReducer)(this.currentState, actionWithTimestamp);
+        return (0, game_reducer_1.gameReducer)(this.currentState, actionWithTimestamp);
     }
     /**
      * Undo last action
@@ -152,7 +142,7 @@ class PokerEngine {
      * Get player view (masked)
      */
     view(playerId, version) {
-        return (0, viewMasking_1.createPublicView)(this.currentState, playerId ?? null, version ?? 0);
+        return (0, view_masking_1.createPublicView)(this.currentState, playerId ?? null, version ?? 0);
     }
     /**
      * Get snapshot for serialization
@@ -174,7 +164,6 @@ class PokerEngine {
      */
     on(callback) {
         this.listeners.push(callback);
-        // Return unsubscribe function
         return () => {
             const index = this.listeners.indexOf(callback);
             if (index > -1) {
@@ -191,9 +180,8 @@ class PokerEngine {
         }
         const nextLevel = this.currentState.blindLevel + 1;
         if (nextLevel >= this.currentState.config.blindStructure.length) {
-            return; // At max level
+            return;
         }
-        // Dispatch NEXT_BLIND_LEVEL action to notify listeners
         this.dispatch({
             type: "NEXT_BLIND_LEVEL" /* ActionType.NEXT_BLIND_LEVEL */,
             timestamp: this.timeProvider(),
@@ -222,14 +210,12 @@ class PokerEngine {
     dispatch(action) {
         const oldState = this.currentState;
         try {
-            this.currentState = (0, gameReducer_1.gameReducer)(this.currentState, action);
-            // Notify listeners
+            this.currentState = (0, game_reducer_1.gameReducer)(this.currentState, action);
             for (const listener of this.listeners) {
                 listener(action, oldState, this.currentState);
             }
         }
         catch (error) {
-            // Re-throw error but keep old state
             throw error;
         }
     }
@@ -238,19 +224,19 @@ class PokerEngine {
      */
     validateConfig(config) {
         if (config.smallBlind <= 0) {
-            throw new ConfigError_1.ConfigError("Small blind must be positive", {
+            throw new config_error_1.ConfigError("Small blind must be positive", {
                 smallBlind: config.smallBlind,
             });
         }
         if (config.bigBlind <= config.smallBlind) {
-            throw new ConfigError_1.ConfigError("Big blind must be greater than small blind", {
+            throw new config_error_1.ConfigError("Big blind must be greater than small blind", {
                 smallBlind: config.smallBlind,
                 bigBlind: config.bigBlind,
             });
         }
         const maxPlayers = config.maxPlayers ?? 9;
         if (maxPlayers < 2 || maxPlayers > 10) {
-            throw new ConfigError_1.ConfigError("Max players must be between 2 and 10", {
+            throw new config_error_1.ConfigError("Max players must be between 2 and 10", {
                 maxPlayers,
             });
         }

package/dist/errors/{ConfigError.d.ts → config-error.d.ts}

@@ -1,4 +1,4 @@
-import { PokerEngineError } from "./PokerEngineError";
+import { PokerEngineError } from "./poker-engine-error";
 /**
  * Error indicating invalid configuration
  * Should fail at engine initialization

package/dist/errors/{ConfigError.js → config-error.js}

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigError = void 0;
-const PokerEngineError_1 = require("./PokerEngineError");
+const poker_engine_error_1 = require("./poker-engine-error");
 /**
  * Error indicating invalid configuration
  * Should fail at engine initialization
  */
-class ConfigError extends PokerEngineError_1.PokerEngineError {
+class ConfigError extends poker_engine_error_1.PokerEngineError {
     constructor(message, context = {}) {
         super("INVALID_CONFIG", message, context);
         this.name = "ConfigError";

package/dist/errors/{CriticalStateError.d.ts → critical-state-error.d.ts}

@@ -1,4 +1,4 @@
-import { PokerEngineError } from "./PokerEngineError";
+import { PokerEngineError } from "./poker-engine-error";
 /**
  * Critical error indicating state corruption or invariant violation
  * When this occurs, the table should be FROZEN immediately

package/dist/errors/{CriticalStateError.js → critical-state-error.js}

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CriticalStateError = void 0;
-const PokerEngineError_1 = require("./PokerEngineError");
+const poker_engine_error_1 = require("./poker-engine-error");
 /**
  * Critical error indicating state corruption or invariant violation
  * When this occurs, the table should be FROZEN immediately
  */
-class CriticalStateError extends PokerEngineError_1.PokerEngineError {
+class CriticalStateError extends poker_engine_error_1.PokerEngineError {
     constructor(message, context = {}) {
         super("CRITICAL_INVARIANT_FAILURE", message, context);
         this.name = "CriticalStateError";

package/dist/errors/{IllegalActionError.d.ts → illegal-action-error.d.ts}

@@ -1,5 +1,5 @@
-import { PokerEngineError } from "./PokerEngineError";
-import { ErrorCode } from "./ErrorCodes";
+import { PokerEngineError } from "./poker-engine-error";
+import { ErrorCode } from "@pokertools/types";
 /**
  * Error indicating an illegal or invalid action
  * Action should be rejected and error sent to client

package/dist/errors/{IllegalActionError.js → illegal-action-error.js}

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IllegalActionError = void 0;
-const PokerEngineError_1 = require("./PokerEngineError");
+const poker_engine_error_1 = require("./poker-engine-error");
 /**
  * Error indicating an illegal or invalid action
  * Action should be rejected and error sent to client
  */
-class IllegalActionError extends PokerEngineError_1.PokerEngineError {
+class IllegalActionError extends poker_engine_error_1.PokerEngineError {
     constructor(code, message, context = {}) {
         super(code, message, context);
         this.name = "IllegalActionError";

package/dist/errors/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./PokerEngineError";
-export * from "./CriticalStateError";
-export * from "./IllegalActionError";
-export * from "./ConfigError";
+export * from "./poker-engine-error";
+export * from "./critical-state-error";
+export * from "./illegal-action-error";
+export * from "./config-error";

package/dist/errors/index.js

@@ -14,9 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-// Export all errors
-__exportStar(require("./PokerEngineError"), exports);
-__exportStar(require("./CriticalStateError"), exports);
-__exportStar(require("./IllegalActionError"), exports);
-__exportStar(require("./ConfigError"), exports);
-// ErrorCodes now exported from @pokertools/types
+__exportStar(require("./poker-engine-error"), exports);
+__exportStar(require("./critical-state-error"), exports);
+__exportStar(require("./illegal-action-error"), exports);
+__exportStar(require("./config-error"), exports);

package/dist/errors/{PokerEngineError.js → poker-engine-error.js}

@@ -5,6 +5,8 @@ exports.PokerEngineError = void 0;
  * Base error class for all poker engine errors
  */
 class PokerEngineError extends Error {
+    code;
+    context;
     constructor(code, message, context = {}) {
         super(message);
         this.name = "PokerEngineError";

package/dist/history/exporter.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.exportHandHistory = exportHandHistory;
 exports.getHandHistory = getHandHistory;
 exports.exportMultipleHands = exportMultipleHands;
-const handHistoryBuilder_1 = require("./handHistoryBuilder");
+const hand_history_builder_1 = require("./hand-history-builder");
 const pokerstars_1 = require("./formats/pokerstars");
 const json_1 = require("./formats/json");
 /**
@@ -18,7 +18,7 @@ const json_1 = require("./formats/json");
  */
 function exportHandHistory(state, options = { format: "json" }) {
     // Build structured history
-    const history = (0, handHistoryBuilder_1.buildHandHistory)(state);
+    const history = (0, hand_history_builder_1.buildHandHistory)(state);
     // Export to requested format
     switch (options.format) {
         case "pokerstars":
@@ -38,7 +38,7 @@ function exportHandHistory(state, options = { format: "json" }) {
  * @returns Structured hand history object
  */
 function getHandHistory(state) {
-    return (0, handHistoryBuilder_1.buildHandHistory)(state);
+    return (0, hand_history_builder_1.buildHandHistory)(state);
 }
 /**
  * Export multiple hands to a single file
@@ -54,7 +54,7 @@ function exportMultipleHands(states, options = { format: "json" }) {
     }
     else {
         // JSON format: array of hands
-        const histories = states.map((state) => (0, handHistoryBuilder_1.buildHandHistory)(state));
+        const histories = states.map((state) => (0, hand_history_builder_1.buildHandHistory)(state));
         return JSON.stringify(histories, null, options.format === "compact" ? 0 : 2);
     }
 }

package/dist/history/formats/pokerstars.js

@@ -11,25 +11,19 @@ exports.exportToPokerStars = exportToPokerStars;
  */
 function exportToPokerStars(history, options = { format: "pokerstars" }) {
     const lines = [];
-    // Header line
     lines.push(buildHeader(history));
     lines.push(buildTableInfo(history));
-    // Button and seats
     lines.push(`Button: seat #${history.buttonSeat + 1}`);
     lines.push("");
-    // Player stacks
     for (const player of history.players) {
         lines.push(`Seat ${player.seat + 1}: ${player.name} ($${player.startingStack.toFixed(2)} in chips)`);
     }
     lines.push("");
-    // Blinds and antes
     lines.push(buildBlindsLine(history));
     if (history.stakes.ante > 0) {
         lines.push(buildAntesLine(history));
     }
-    // Hole cards (dealt to)
     lines.push(buildHoleCardsLine(history, options));
-    // Each street
     for (const street of history.streets) {
         lines.push("");
         lines.push(buildStreetHeader(street));
@@ -37,7 +31,6 @@ function exportToPokerStars(history, options = { format: "pokerstars" }) {
             lines.push(buildActionLine(action, history));
         }
     }
-    // Summary
     lines.push("");
     lines.push(buildSummary(history));
     return lines.join("\n");
@@ -61,7 +54,6 @@ function buildTableInfo(history) {
  */
 function buildBlindsLine(history) {
     const lines = [];
-    // Find SB and BB seats (button+1 and button+2)
     const sbSeat = (history.buttonSeat + 1) % history.maxPlayers;
     const bbSeat = (history.buttonSeat + 2) % history.maxPlayers;
     const sbPlayer = history.players.find((p) => p.seat === sbSeat);

package/dist/history/{handHistoryBuilder.js → hand-history-builder.js}

@@ -84,10 +84,9 @@ function groupActionsByStreet(state) {
     grouped.set("TURN" /* Street.TURN */, []);
     grouped.set("RIVER" /* Street.RIVER */, []);
     grouped.set("SHOWDOWN" /* Street.SHOWDOWN */, []);
-    // Group action history by street
     for (const record of state.actionHistory) {
         if (record.seat === null)
-            continue; // Skip table-level actions
+            continue;
         const street = record.street ?? state.street;
         const existing = grouped.get(street) ?? [];
         const actionRecord = {

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export { PokerEngine } from "./engine/PokerEngine";
+export { PokerEngine } from "./engine/poker-engine";
 export * from "@pokertools/types";
 export * from "./errors";
 export { createSnapshot, restoreFromSnapshot, Snapshot } from "./utils/serialization";
-export { createPublicView } from "./utils/viewMasking";
+export { createPublicView } from "./utils/view-masking";
 export { calculateTotalChips, auditChipConservation } from "./utils/invariants";
 export { exportHandHistory, getHandHistory, exportMultipleHands } from "./history/exporter";
 export { HandHistory, HandHistoryPlayer, StreetHistory, ExportOptions } from "@pokertools/types";

package/dist/index.js

@@ -15,9 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.exportMultipleHands = exports.getHandHistory = exports.exportHandHistory = exports.auditChipConservation = exports.calculateTotalChips = exports.createPublicView = exports.restoreFromSnapshot = exports.createSnapshot = exports.PokerEngine = void 0;
-// Main Engine Class
-var PokerEngine_1 = require("./engine/PokerEngine");
-Object.defineProperty(exports, "PokerEngine", { enumerable: true, get: function () { return PokerEngine_1.PokerEngine; } });
+var poker_engine_1 = require("./engine/poker-engine");
+Object.defineProperty(exports, "PokerEngine", { enumerable: true, get: function () { return poker_engine_1.PokerEngine; } });
 // Types (re-exported from @pokertools/types for convenience)
 __exportStar(require("@pokertools/types"), exports);
 // Errors
@@ -26,8 +25,8 @@ __exportStar(require("./errors"), exports);
 var serialization_1 = require("./utils/serialization");
 Object.defineProperty(exports, "createSnapshot", { enumerable: true, get: function () { return serialization_1.createSnapshot; } });
 Object.defineProperty(exports, "restoreFromSnapshot", { enumerable: true, get: function () { return serialization_1.restoreFromSnapshot; } });
-var viewMasking_1 = require("./utils/viewMasking");
-Object.defineProperty(exports, "createPublicView", { enumerable: true, get: function () { return viewMasking_1.createPublicView; } });
+var view_masking_1 = require("./utils/view-masking");
+Object.defineProperty(exports, "createPublicView", { enumerable: true, get: function () { return view_masking_1.createPublicView; } });
 var invariants_1 = require("./utils/invariants");
 Object.defineProperty(exports, "calculateTotalChips", { enumerable: true, get: function () { return invariants_1.calculateTotalChips; } });
 Object.defineProperty(exports, "auditChipConservation", { enumerable: true, get: function () { return invariants_1.auditChipConservation; } });

package/dist/rules/{actionOrder.js → action-order.js}

@@ -4,15 +4,14 @@ exports.getNextToAct = getNextToAct;
 exports.getFirstToAct = getFirstToAct;
 exports.isActionComplete = isActionComplete;
 const positioning_1 = require("../utils/positioning");
-const headsUp_1 = require("./headsUp");
+const heads_up_1 = require("./heads-up");
 const blinds_1 = require("./blinds");
 /**
  * Determine the next player to act
  * Returns seat number or null if action is complete
  */
 function getNextToAct(state) {
-    // Special case: heads-up has different rules
-    if ((0, headsUp_1.isHeadsUp)(state)) {
+    if ((0, heads_up_1.isHeadsUp)(state)) {
         return getNextToActHeadsUp(state);
     }
     return getNextToActNormal(state);
@@ -32,8 +31,8 @@ function getNextToActNormal(state) {
     // Search for next player who can act
     while (seat !== startSeat) {
         const player = state.players[seat];
-        // Skip if: no player, folded, all-in, or busted
-        if (player?.status !== "ACTIVE" /* PlayerStatus.ACTIVE */ || player.stack === 0) {
+        // Skip if: no player, folded, all-in, busted, or sitting out
+        if (player?.status !== "ACTIVE" /* PlayerStatus.ACTIVE */ || player.stack === 0 || player.isSittingOut) {
             seat = (0, positioning_1.getNextSeat)(seat, state.maxPlayers);
             continue;
         }
@@ -42,12 +41,10 @@ function getNextToActNormal(state) {
         // 2. Current bet is higher than their bet
         const playerBet = state.currentBets.get(seat) ?? 0;
         if (playerBet < currentBet) {
-            return seat; // Player needs to respond to bet
+            return seat;
         }
-        // Player has matched current bet
-        // Check if they've already acted
         if (!hasActedThisStreet(state, seat)) {
-            return seat; // Player hasn't acted yet
+            return seat;
         }
         foundActionable = true;
         seat = (0, positioning_1.getNextSeat)(seat, state.maxPlayers);
@@ -65,7 +62,7 @@ function getNextToActHeadsUp(state) {
     if (state.buttonSeat === null) {
         return null;
     }
-    const actionOrder = (0, headsUp_1.getHeadsUpActionOrder)(state, state.street);
+    const actionOrder = (0, heads_up_1.getHeadsUpActionOrder)(state, state.street);
     if (actionOrder.length === 0) {
         return null;
     }
@@ -77,7 +74,7 @@ function getNextToActHeadsUp(state) {
     // Check both players
     for (const seat of actionOrder) {
         const player = state.players[seat];
-        if (player?.status !== "ACTIVE" /* PlayerStatus.ACTIVE */ || player.stack === 0) {
+        if (player?.status !== "ACTIVE" /* PlayerStatus.ACTIVE */ || player.stack === 0 || player.isSittingOut) {
             continue;
         }
         const playerBet = state.currentBets.get(seat) ?? 0;
@@ -94,8 +91,8 @@ function getFirstToAct(state) {
     if (state.buttonSeat === null) {
         return null;
     }
-    if ((0, headsUp_1.isHeadsUp)(state)) {
-        const order = (0, headsUp_1.getHeadsUpActionOrder)(state, state.street);
+    if ((0, heads_up_1.isHeadsUp)(state)) {
+        const order = (0, heads_up_1.getHeadsUpActionOrder)(state, state.street);
         if (order.length > 0) {
             return order[0];
         }
@@ -125,10 +122,9 @@ function getFirstToAct(state) {
 function getNextActionableSeat(startSeat, state) {
     let seat = (0, positioning_1.getNextSeat)(startSeat, state.maxPlayers);
     const endSeat = startSeat;
-    // Scan full circle
     while (seat !== endSeat) {
         const player = state.players[seat];
-        if (player?.status === "ACTIVE" /* PlayerStatus.ACTIVE */ && player.stack > 0) {
+        if (player?.status === "ACTIVE" /* PlayerStatus.ACTIVE */ && player.stack > 0 && !player.isSittingOut) {
             return seat;
         }
         seat = (0, positioning_1.getNextSeat)(seat, state.maxPlayers);
@@ -159,7 +155,7 @@ function isActionComplete(state) {
         if (!player)
             continue;
         // Count active players who can still act
-        if (player.status === "ACTIVE" /* PlayerStatus.ACTIVE */ && player.stack > 0) {
+        if (player.status === "ACTIVE" /* PlayerStatus.ACTIVE */ && player.stack > 0 && !player.isSittingOut) {
             activeCount++;
             const playerBet = state.currentBets.get(seat) ?? 0;
             // Player has matched bet and acted
@@ -183,7 +179,6 @@ function isActionComplete(state) {
  * This is tracked by checking if they appear in the action history for this street
  */
 function hasActedThisStreet(state, seat) {
-    // Find actions from current street
     const streetStartIndex = findStreetStartIndex(state);
     for (let i = streetStartIndex; i < state.actionHistory.length; i++) {
         if (state.actionHistory[i].seat === seat) {

package/dist/rules/blinds.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBlindPositions = getBlindPositions;
 exports.calculateAntes = calculateAntes;
 const positioning_1 = require("../utils/positioning");
-const headsUp_1 = require("./headsUp");
+const heads_up_1 = require("./heads-up");
 /**
  * Determine which seats should post blinds
  *
@@ -24,7 +24,7 @@ function getBlindPositions(state) {
     const buttonSeat = state.buttonSeat;
     const isTournament = !!state.config.blindStructure;
     // Heads-up specific logic (Button is SB)
-    if ((0, headsUp_1.isHeadsUp)(state)) {
+    if ((0, heads_up_1.isHeadsUp)(state)) {
         const bbSeat = getNextActiveOrOccupiedSeat(buttonSeat, state.players, state.maxPlayers, isTournament);
         if (bbSeat === null) {
             return null;
@@ -66,7 +66,7 @@ function getNextActiveOrOccupiedSeat(currentSeat, players, maxPlayers, isTournam
         }
         seat = (0, positioning_1.getNextSeat)(seat, maxPlayers);
     }
-    return null; // No eligible seats
+    return null;
 }
 /**
  * Calculate blind amounts for antes

package/dist/rules/{headsUp.js → heads-up.js}

@@ -32,7 +32,6 @@ function getHeadsUpActionOrder(state, street) {
     }
     // Find the two seats
     const [seat1, seat2] = activePlayers.sort((a, b) => a - b);
-    // Check if button is one of the active players
     const isButtonActive = activePlayers.includes(buttonSeat);
     if (!isButtonActive) {
         // Dead button scenario - button is not one of the active players