turn-based-mcp-shared 1.0.0

package/dist/constants/game-constants.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Shared game constants
+ * Single source of truth for game types, difficulties, player IDs, and default values
+ */
+/**
+ * Supported game types
+ */
+export declare const GAME_TYPES: readonly ["tic-tac-toe", "rock-paper-scissors"];
+/**
+ * Available AI difficulty levels
+ */
+export declare const DIFFICULTIES: readonly ["easy", "medium", "hard"];
+/**
+ * Standard player IDs used across the system
+ */
+export declare const PLAYER_IDS: {
+    readonly HUMAN: "player1";
+    readonly PLAYER2: "player2";
+    readonly AI: "ai";
+};
+/**
+ * Game status values
+ */
+export declare const GAME_STATUSES: readonly ["waiting", "playing", "finished"];
+/**
+ * Derive types from constants
+ */
+export type GameType = typeof GAME_TYPES[number];
+export type Difficulty = typeof DIFFICULTIES[number];
+export type PlayerId = typeof PLAYER_IDS[keyof typeof PLAYER_IDS];
+export type GameStatus = typeof GAME_STATUSES[number];
+/**
+ * Default player configurations
+ */
+export declare const DEFAULT_PLAYER_NAME = "Player";
+export declare const DEFAULT_AI_DIFFICULTY: Difficulty;
+/**
+ * Difficulty display configuration
+ */
+export declare const DIFFICULTY_DISPLAY: {
+    readonly easy: {
+        readonly emoji: "😌";
+        readonly label: "Easy";
+    };
+    readonly medium: {
+        readonly emoji: "🎯";
+        readonly label: "Medium";
+    };
+    readonly hard: {
+        readonly emoji: "🔥";
+        readonly label: "Hard";
+    };
+};
+/**
+ * Type guard to check if a string is a supported game type
+ */
+export declare function isSupportedGameType(gameType: string): gameType is GameType;
+/**
+ * Type guard to check if a string is a valid difficulty level
+ */
+export declare function isValidDifficulty(difficulty: string): difficulty is Difficulty;
+/**
+ * Type guard to check if a string is a valid player ID
+ */
+export declare function isValidPlayerId(playerId: string): playerId is PlayerId;
+/**
+ * Type guard to check if a string is a valid game status
+ */
+export declare function isValidGameStatus(status: string): status is GameStatus;
+/**
+ * Get difficulty display configuration
+ */
+export declare function getDifficultyDisplay(difficulty: Difficulty): {
+    emoji: string;
+    label: string;
+};
+//# sourceMappingURL=game-constants.d.ts.map

package/dist/constants/game-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-constants.d.ts","sourceRoot":"","sources":["../../src/constants/game-constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,iDAAkD,CAAA;AAEzE;;GAEG;AACH,eAAO,MAAM,YAAY,qCAAsC,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,UAAU;;;;CAIb,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,aAAa,6CAA8C,CAAA;AAExE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAA;AAChD,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAA;AACpD,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA;AACjE,MAAM,MAAM,UAAU,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAA;AAErD;;GAEG;AACH,eAAO,MAAM,mBAAmB,WAAW,CAAA;AAC3C,eAAO,MAAM,qBAAqB,EAAE,UAAqB,CAAA;AAEzD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAIrB,CAAA;AAEV;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,QAAQ,CAE1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,IAAI,UAAU,CAE9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,QAAQ,CAEtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,UAAU,CAEtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAE7F"}

package/dist/constants/game-constants.js

@@ -0,0 +1,68 @@
+/**
+ * Shared game constants
+ * Single source of truth for game types, difficulties, player IDs, and default values
+ */
+/**
+ * Supported game types
+ */
+export const GAME_TYPES = ['tic-tac-toe', 'rock-paper-scissors'];
+/**
+ * Available AI difficulty levels
+ */
+export const DIFFICULTIES = ['easy', 'medium', 'hard'];
+/**
+ * Standard player IDs used across the system
+ */
+export const PLAYER_IDS = {
+    HUMAN: 'player1',
+    PLAYER2: 'player2',
+    AI: 'ai'
+};
+/**
+ * Game status values
+ */
+export const GAME_STATUSES = ['waiting', 'playing', 'finished'];
+/**
+ * Default player configurations
+ */
+export const DEFAULT_PLAYER_NAME = 'Player';
+export const DEFAULT_AI_DIFFICULTY = 'medium';
+/**
+ * Difficulty display configuration
+ */
+export const DIFFICULTY_DISPLAY = {
+    easy: { emoji: '😌', label: 'Easy' },
+    medium: { emoji: '🎯', label: 'Medium' },
+    hard: { emoji: '🔥', label: 'Hard' }
+};
+/**
+ * Type guard to check if a string is a supported game type
+ */
+export function isSupportedGameType(gameType) {
+    return GAME_TYPES.includes(gameType);
+}
+/**
+ * Type guard to check if a string is a valid difficulty level
+ */
+export function isValidDifficulty(difficulty) {
+    return DIFFICULTIES.includes(difficulty);
+}
+/**
+ * Type guard to check if a string is a valid player ID
+ */
+export function isValidPlayerId(playerId) {
+    return Object.values(PLAYER_IDS).includes(playerId);
+}
+/**
+ * Type guard to check if a string is a valid game status
+ */
+export function isValidGameStatus(status) {
+    return GAME_STATUSES.includes(status);
+}
+/**
+ * Get difficulty display configuration
+ */
+export function getDifficultyDisplay(difficulty) {
+    return DIFFICULTY_DISPLAY[difficulty];
+}
+//# sourceMappingURL=game-constants.js.map

package/dist/constants/game-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-constants.js","sourceRoot":"","sources":["../../src/constants/game-constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,aAAa,EAAE,qBAAqB,CAAU,CAAA;AAEzE;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAA;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,EAAE,EAAE,IAAI;CACA,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAU,CAAA;AAUxE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAA;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAe,QAAQ,CAAA;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;IACpC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;IACxC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;CAC5B,CAAA;AAEV;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,UAAU,CAAC,QAAQ,CAAC,QAAoB,CAAC,CAAA;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,YAAY,CAAC,QAAQ,CAAC,UAAwB,CAAC,CAAA;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,QAAoB,CAAC,CAAA;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,aAAa,CAAC,QAAQ,CAAC,MAAoB,CAAC,CAAA;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAsB;IACzD,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAA;AACvC,CAAC"}

package/dist/constants/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Constants index - exports all game constants
+ */
+export * from './game-constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAA"}

package/dist/constants/index.js

@@ -0,0 +1,5 @@
+/**
+ * Constants index - exports all game constants
+ */
+export * from './game-constants.js';
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAA"}

package/dist/games/index.d.ts

@@ -0,0 +1,3 @@
+export { TicTacToeGame } from './tic-tac-toe.js';
+export { RockPaperScissorsGame } from './rock-paper-scissors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/games/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/games/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/games/index.js

@@ -0,0 +1,3 @@
+export { TicTacToeGame } from './tic-tac-toe.js';
+export { RockPaperScissorsGame } from './rock-paper-scissors.js';
+//# sourceMappingURL=index.js.map

package/dist/games/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/games/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/games/rock-paper-scissors.d.ts

@@ -0,0 +1,117 @@
+import { Game, Player, PlayerId, GameResult } from '../types/game.js';
+import { RPSGameState, RPSMove } from '../types/games.js';
+/**
+ * Implementation of the classic Rock Paper Scissors game
+ *
+ * A best-of-N rounds game where players simultaneously choose rock, paper, or scissors.
+ * Rock beats scissors, scissors beats paper, paper beats rock.
+ * The first player to win the majority of rounds wins the match.
+ *
+ * @example
+ * ```typescript
+ * const game = new RockPaperScissorsGame();
+ * const players = [
+ *   { id: 'player1', name: 'Human', isAI: false },
+ *   { id: 'ai', name: 'Computer', isAI: true }
+ * ];
+ * const initialState = game.getInitialState(players); // Creates best-of-3 game
+ * ```
+ */
+export declare class RockPaperScissorsGame implements Game<RPSGameState, RPSMove> {
+    /**
+     * Validates whether a move is legal in the current game state
+     *
+     * @param gameState - The current state of the rock-paper-scissors game
+     * @param move - The move to validate (choice of rock, paper, or scissors)
+     * @param playerId - The ID of the player attempting the move
+     * @returns true if the move is valid, false otherwise
+     *
+     * @description
+     * A move is valid if:
+     * - The choice is one of: 'rock', 'paper', 'scissors'
+     * - The game status is 'playing'
+     * - The current round hasn't exceeded max rounds
+     * - The player hasn't already made a choice in the current round
+     */
+    validateMove(gameState: RPSGameState, move: RPSMove, playerId: PlayerId): boolean;
+    /**
+     * Applies a validated move to the game state and returns the new state
+     *
+     * @param gameState - The current state of the rock-paper-scissors game
+     * @param move - The move to apply (must be valid)
+     * @param playerId - The ID of the player making the move
+     * @returns A new game state with the move applied
+     * @throws Error if the move is invalid
+     *
+     * @description
+     * This method handles both partial and complete rounds:
+     * - If first player choice: records choice and switches to other player
+     * - If second player choice: records choice, determines round winner,
+     *   updates scores, and advances to next round or ends game
+     */
+    applyMove(gameState: RPSGameState, move: RPSMove, playerId: PlayerId): RPSGameState;
+    /**
+     * Checks if the game has ended and determines the winner
+     *
+     * @param gameState - The current state of the rock-paper-scissors game
+     * @returns GameResult with winner and reason if game ended, null if game continues
+     *
+     * @description
+     * The game ends when all rounds are complete (currentRound >= maxRounds).
+     * Winner is determined by comparing final scores:
+     * - Player with higher score wins
+     * - Equal scores result in a draw
+     * - Reason includes the final score (e.g., "Won 2-1")
+     */
+    checkGameEnd(gameState: RPSGameState): GameResult | null;
+    /**
+     * Gets all valid moves for a player in the current game state
+     *
+     * @param gameState - The current state of the rock-paper-scissors game
+     * @param playerId - The ID of the player to get moves for
+     * @returns Array of valid RPSMove objects (all choices if player can move)
+     *
+     * @description
+     * Returns all three choices [rock, paper, scissors] if:
+     * - Game is still playing
+     * - Current round is within max rounds
+     * - Player hasn't made a choice in the current round
+     * Otherwise returns an empty array.
+     */
+    getValidMoves(gameState: RPSGameState, playerId: PlayerId): RPSMove[];
+    /**
+     * Creates the initial game state for a new rock-paper-scissors game
+     *
+     * @param players - Array of exactly 2 players
+     * @param options - Optional configuration including maxRounds
+     * @returns Initial RPSGameState set up for a configurable number of rounds
+     *
+     * @description
+     * Sets up a new game with:
+     * - Configurable number of rounds (default: 3 for best-of-3 format)
+     * - All scores initialized to 0
+     * - First player goes first
+     * - Game status set to 'playing'
+     * - Current round set to 0
+     */
+    getInitialState(players: Player[], options?: {
+        maxRounds?: number;
+    }): RPSGameState;
+    /**
+     * Determines the winner of a single round based on the classic RPS rules
+     *
+     * @param choice1 - First player's choice
+     * @param choice2 - Second player's choice
+     * @returns 'player1' if choice1 wins, 'player2' if choice2 wins, 'draw' if same
+     *
+     * @private
+     * @description
+     * Implements the classic rules:
+     * - Rock beats Scissors
+     * - Paper beats Rock
+     * - Scissors beats Paper
+     * - Same choices result in a draw
+     */
+    private determineRoundWinner;
+}
+//# sourceMappingURL=rock-paper-scissors.d.ts.map

package/dist/games/rock-paper-scissors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rock-paper-scissors.d.ts","sourceRoot":"","sources":["../../src/games/rock-paper-scissors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAa,MAAM,gBAAgB,CAAC;AAElE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,qBAAsB,YAAW,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;IACvE;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO;IA4BjF;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,YAAY;IAsDnF;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,SAAS,EAAE,YAAY,GAAG,UAAU,GAAG,IAAI;IA2BxD;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAAE;IAsBrE;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY;IAuBlF;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,oBAAoB;CAa7B"}

package/dist/games/rock-paper-scissors.js

@@ -0,0 +1,247 @@
+/**
+ * Implementation of the classic Rock Paper Scissors game
+ *
+ * A best-of-N rounds game where players simultaneously choose rock, paper, or scissors.
+ * Rock beats scissors, scissors beats paper, paper beats rock.
+ * The first player to win the majority of rounds wins the match.
+ *
+ * @example
+ * ```typescript
+ * const game = new RockPaperScissorsGame();
+ * const players = [
+ *   { id: 'player1', name: 'Human', isAI: false },
+ *   { id: 'ai', name: 'Computer', isAI: true }
+ * ];
+ * const initialState = game.getInitialState(players); // Creates best-of-3 game
+ * ```
+ */
+export class RockPaperScissorsGame {
+    /**
+     * Validates whether a move is legal in the current game state
+     *
+     * @param gameState - The current state of the rock-paper-scissors game
+     * @param move - The move to validate (choice of rock, paper, or scissors)
+     * @param playerId - The ID of the player attempting the move
+     * @returns true if the move is valid, false otherwise
+     *
+     * @description
+     * A move is valid if:
+     * - The choice is one of: 'rock', 'paper', 'scissors'
+     * - The game status is 'playing'
+     * - The current round hasn't exceeded max rounds
+     * - The player hasn't already made a choice in the current round
+     */
+    validateMove(gameState, move, playerId) {
+        const { choice } = move;
+        // Check if it's a valid choice
+        if (!['rock', 'paper', 'scissors'].includes(choice)) {
+            return false;
+        }
+        // Check if game is still ongoing
+        if (gameState.status !== 'playing') {
+            return false;
+        }
+        // Check if current round is valid
+        if (gameState.currentRound >= gameState.maxRounds) {
+            return false;
+        }
+        const currentRound = gameState.rounds[gameState.currentRound];
+        // Check if player hasn't made a choice yet in this round
+        if (playerId === 'player1' || playerId === gameState.players[0].id) {
+            return !currentRound.player1Choice;
+        }
+        else {
+            return !currentRound.player2Choice;
+        }
+    }
+    /**
+     * Applies a validated move to the game state and returns the new state
+     *
+     * @param gameState - The current state of the rock-paper-scissors game
+     * @param move - The move to apply (must be valid)
+     * @param playerId - The ID of the player making the move
+     * @returns A new game state with the move applied
+     * @throws Error if the move is invalid
+     *
+     * @description
+     * This method handles both partial and complete rounds:
+     * - If first player choice: records choice and switches to other player
+     * - If second player choice: records choice, determines round winner,
+     *   updates scores, and advances to next round or ends game
+     */
+    applyMove(gameState, move, playerId) {
+        if (!this.validateMove(gameState, move, playerId)) {
+            throw new Error('Invalid move');
+        }
+        const newRounds = [...gameState.rounds];
+        const currentRound = { ...newRounds[gameState.currentRound] };
+        // Apply the move
+        if (playerId === gameState.players[0].id) {
+            currentRound.player1Choice = move.choice;
+        }
+        else {
+            currentRound.player2Choice = move.choice;
+        }
+        newRounds[gameState.currentRound] = currentRound;
+        let newCurrentRound = gameState.currentRound;
+        const newScores = { ...gameState.scores };
+        let newCurrentPlayerId = gameState.currentPlayerId;
+        // If both players have made their choices, resolve the round
+        if (currentRound.player1Choice && currentRound.player2Choice) {
+            const roundWinner = this.determineRoundWinner(currentRound.player1Choice, currentRound.player2Choice);
+            currentRound.winner = roundWinner;
+            // Update scores
+            if (roundWinner !== 'draw') {
+                const winnerId = roundWinner === 'player1' ? gameState.players[0].id : gameState.players[1].id;
+                newScores[winnerId] = (newScores[winnerId] || 0) + 1;
+            }
+            // Move to next round
+            newCurrentRound++;
+            newCurrentPlayerId = gameState.players[0].id; // Reset to first player
+        }
+        else {
+            // Switch to other player
+            newCurrentPlayerId = gameState.players.find(p => p.id !== playerId)?.id || gameState.players[0].id;
+        }
+        return {
+            ...gameState,
+            rounds: newRounds,
+            currentRound: newCurrentRound,
+            scores: newScores,
+            currentPlayerId: newCurrentPlayerId,
+            updatedAt: new Date(),
+        };
+    }
+    /**
+     * Checks if the game has ended and determines the winner
+     *
+     * @param gameState - The current state of the rock-paper-scissors game
+     * @returns GameResult with winner and reason if game ended, null if game continues
+     *
+     * @description
+     * The game ends when all rounds are complete (currentRound >= maxRounds).
+     * Winner is determined by comparing final scores:
+     * - Player with higher score wins
+     * - Equal scores result in a draw
+     * - Reason includes the final score (e.g., "Won 2-1")
+     */
+    checkGameEnd(gameState) {
+        // Game ends when all rounds are complete
+        if (gameState.currentRound >= gameState.maxRounds) {
+            const player1Score = gameState.scores[gameState.players[0].id] || 0;
+            const player2Score = gameState.scores[gameState.players[1].id] || 0;
+            if (player1Score > player2Score) {
+                return {
+                    winner: gameState.players[0].id,
+                    reason: `Won ${player1Score}-${player2Score}`
+                };
+            }
+            else if (player2Score > player1Score) {
+                return {
+                    winner: gameState.players[1].id,
+                    reason: `Won ${player2Score}-${player1Score}`
+                };
+            }
+            else {
+                return {
+                    winner: 'draw',
+                    reason: `Tied ${player1Score}-${player2Score}`
+                };
+            }
+        }
+        return null; // Game continues
+    }
+    /**
+     * Gets all valid moves for a player in the current game state
+     *
+     * @param gameState - The current state of the rock-paper-scissors game
+     * @param playerId - The ID of the player to get moves for
+     * @returns Array of valid RPSMove objects (all choices if player can move)
+     *
+     * @description
+     * Returns all three choices [rock, paper, scissors] if:
+     * - Game is still playing
+     * - Current round is within max rounds
+     * - Player hasn't made a choice in the current round
+     * Otherwise returns an empty array.
+     */
+    getValidMoves(gameState, playerId) {
+        if (gameState.status !== 'playing' || gameState.currentRound >= gameState.maxRounds) {
+            return [];
+        }
+        const currentRound = gameState.rounds[gameState.currentRound];
+        // Check if player can make a move in current round
+        const canMove = (playerId === gameState.players[0].id && !currentRound.player1Choice) ||
+            (playerId === gameState.players[1].id && !currentRound.player2Choice);
+        if (!canMove) {
+            return [];
+        }
+        return [
+            { choice: 'rock' },
+            { choice: 'paper' },
+            { choice: 'scissors' }
+        ];
+    }
+    /**
+     * Creates the initial game state for a new rock-paper-scissors game
+     *
+     * @param players - Array of exactly 2 players
+     * @param options - Optional configuration including maxRounds
+     * @returns Initial RPSGameState set up for a configurable number of rounds
+     *
+     * @description
+     * Sets up a new game with:
+     * - Configurable number of rounds (default: 3 for best-of-3 format)
+     * - All scores initialized to 0
+     * - First player goes first
+     * - Game status set to 'playing'
+     * - Current round set to 0
+     */
+    getInitialState(players, options) {
+        const maxRounds = options?.maxRounds || 3; // Default to best of 3
+        const rounds = Array.from({ length: maxRounds }, () => ({}));
+        const scores = {};
+        players.forEach(player => {
+            scores[player.id] = 0;
+        });
+        return {
+            id: crypto.randomUUID(),
+            players,
+            currentPlayerId: players[0].id,
+            status: 'playing',
+            createdAt: new Date(),
+            updatedAt: new Date(),
+            rounds,
+            currentRound: 0,
+            maxRounds,
+            scores,
+        };
+    }
+    /**
+     * Determines the winner of a single round based on the classic RPS rules
+     *
+     * @param choice1 - First player's choice
+     * @param choice2 - Second player's choice
+     * @returns 'player1' if choice1 wins, 'player2' if choice2 wins, 'draw' if same
+     *
+     * @private
+     * @description
+     * Implements the classic rules:
+     * - Rock beats Scissors
+     * - Paper beats Rock
+     * - Scissors beats Paper
+     * - Same choices result in a draw
+     */
+    determineRoundWinner(choice1, choice2) {
+        if (choice1 === choice2) {
+            return 'draw';
+        }
+        const winConditions = {
+            rock: 'scissors',
+            paper: 'rock',
+            scissors: 'paper'
+        };
+        return winConditions[choice1] === choice2 ? 'player1' : 'player2';
+    }
+}
+//# sourceMappingURL=rock-paper-scissors.js.map

package/dist/games/rock-paper-scissors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rock-paper-scissors.js","sourceRoot":"","sources":["../../src/games/rock-paper-scissors.ts"],"names":[],"mappings":"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"}