From e2372623bafe70730f1fa69611ed943ad0f9f152 Mon Sep 17 00:00:00 2001
From: Kieran Kihn <114803508+kierankihn@users.noreply.github.com>
Date: Sun, 16 Nov 2025 11:42:05 +0800
Subject: [PATCH] feat(game): add `getFront` and `front` for `DiscardTile`

---
 src/game/CardTile.cpp | 10 ++++++++++
 src/game/CardTile.h   | 10 ++++++++++
 2 files changed, 20 insertions(+)

diff --git a/src/game/CardTile.cpp b/src/game/CardTile.cpp
index b6836fc..fb9d2a0 100644
--- a/src/game/CardTile.cpp
+++ b/src/game/CardTile.cpp
@@ -39,6 +39,11 @@ namespace UNO::GAME {
         return card;
     }
 
+    Card CardTile::front() const
+    {
+        return cards_.front();
+    }
+
     bool CardTile::isEmpty() const
     {
         return cards_.empty();
@@ -63,6 +68,11 @@ namespace UNO::GAME {
         this->pushFront(card);
     }
 
+    Card DiscardPile::getFront()
+    {
+        return this->front();
+    }
+
     Deck::Deck() = default;
 
     void Deck::init()
diff --git a/src/game/CardTile.h b/src/game/CardTile.h
index 94c9725..7138e2f 100644
--- a/src/game/CardTile.h
+++ b/src/game/CardTile.h
@@ -48,6 +48,11 @@ namespace UNO::GAME {
         */
         Card popBack();
 
+        /**
+         * @return 牌堆中最上方的牌
+         */
+        [[nodiscard]] Card front() const;
+
         /**
          * @return 牌堆是否为空
          */
@@ -78,6 +83,11 @@ namespace UNO::GAME {
          * 向弃牌堆中添加 @param card 卡牌
          */
         void add(Card card);
+
+        /**
+         * @return 牌堆中最上方的牌
+         */
+        Card getFront();
     };
 
     /**