test: add unit tests for Blackjack and TicTacToe

- Add xUnit test projects for both games - Implement game flow tests for Blackjack - Implement game flow tests for TicTacToe - Rename namespaces and projects to follow `Game.*` convention - Add documentation for testing games
2026-07-20 16:41:10 +08:00
parent 7946f4bafd
commit b4661e714e
38 changed files with 578 additions and 34 deletions
@@ -0,0 +1,50 @@
+using MessagePack;
+using OECS;
+
+namespace Game.TicTacToe;
+
+/// <summary>
+/// Places the current player's mark on the cell at (Row, Col).
+/// Validates that the cell is empty and the game is still playing.
+/// </summary>
+[MessagePackObject]
+public struct PlaceMarkCommand : ICommand
+{
+    [Key(0)] public int Row;
+    [Key(1)] public int Col;
+
+    public void Execute(World world)
+    {
+        ref var state = ref world.GetSingleton<GameState>();
+
+        if (state.Status != GameStatus.Playing)
+            return;
+
+        // Find the cell entity at (Row, Col) that has no Mark.
+        // Use the iterator API with early-exit via break.
+        var query = world.Query().With<Cell>().Without<Mark>().Build();
+        Entity? target = null;
+
+        using var iter = world.Select<Cell>(query);
+        while (iter.MoveNext())
+        {
+            if (iter.Current1.Row == Row && iter.Current1.Col == Col)
+            {
+                target = iter.CurrentEntity;
+                break;
+            }
+        }
+
+        if (target == null)
+            return; // Cell already occupied or invalid position.
+
+        // Place the mark. ComponentAdded is sufficient — MarkModified
+        // is only needed when mutating an existing component via GetComponent<T>.
+        world.AddComponent(target.Value, new Mark { Player = state.CurrentPlayer });
+
+        // Advance turn.
+        state.MoveCount++;
+        state.CurrentPlayer = state.CurrentPlayer == Player.X ? Player.O : Player.X;
+        world.MarkModified<GameState>(World.SingletonEntity);
+    }
+}