Merge branch 'main' into feature/one-click-copy-installation-commands

Author: steam-bell-92

games/2048-Game/2048-Game.py

@@ -87,6 +87,8 @@ def __init__(self, root):
         self.board = [[0] * GRID_SIZE for _ in range(GRID_SIZE)]
 
         self.game_over_label = None
+        self.win_label = None
+        self.game_won = False
 
         self.create_grid()
         self.start_new_game()
@@ -146,6 +148,7 @@ def start_new_game(self):
         self.board = [[0] * GRID_SIZE for _ in range(GRID_SIZE)]
         self.score = 0
         self.moves_left = TOTAL_MOVES
+        self.game_won = False
 
         self.add_new_tile()
         self.add_new_tile()
@@ -261,6 +264,9 @@ def check_game_over(self):
 
         return True
 
+    def check_win(self):
+        return any(2048 in row for row in self.board)
+
     def handle_keypress(self, event):
         key = event.keysym.lower() if len(event.keysym) == 1 else event.keysym
         move_map = {
@@ -284,11 +290,32 @@ def handle_keypress(self, event):
 
             self.update_grid()
 
-        # FIXED BUG:
-        # Game over is now checked even when no movement happens
+            if not self.game_won and self.check_win():
+                self.you_win()
+                return
+
+        # Check for game over even if no movement happens
         if self.check_game_over() or self.moves_left <= 0:
             self.game_over()
 
+    def you_win(self):
+
+        if self.game_won:
+            return
+
+        self.game_won = True
+
+        self.root.unbind("<Key>")
+
+        self.win_label = tk.Label(
+            self.root,
+            text="🎉 YOU WIN! 🎉",
+            font=("Arial", 24, "bold"),
+            fg="green"
+        )
+
+        self.win_label.grid(pady=10)
+
     def game_over(self):
 
         # Prevent duplicate labels
@@ -314,6 +341,11 @@ def restart_game(self):
             self.game_over_label.destroy()
             self.game_over_label = None
 
+        # Remove old win label
+        if self.win_label is not None:
+            self.win_label.destroy()
+            self.win_label = None
+
         self.start_new_game()
 
         # Re-enable keyboard controls
@@ -325,5 +357,6 @@ def main():
     game = Game2048(root)
     root.mainloop()
 
+
 if __name__ == "__main__":
     main()

games/Emoji-Memory-Game/Emoji-Memory-Game.py

@@ -4,6 +4,8 @@
 import sys
 import threading
 
+# Note: Works best in a terminal. Browser version (Pyodide) uses simplified input.
+
 EMOJIS = ["🍎", "🚗", "⚽", "🐍", "🎧", "🔥", "🌈", "🚀"]
 HIGH_SCORE_FILE = "highscore.txt"
 
@@ -20,6 +22,11 @@
 }
 
 
+# Detect if running in browser (Pyodide)
+def is_browser():
+    """Return True if running in a browser environment (Pyodide)."""
+    return sys.platform == "emscripten"
+
 
 # Core, testable logic (no I/O, no global state)
 
@@ -34,11 +41,7 @@ def get_input_limit(choice):
 
 
 def generate_sequence(emojis, level):
-    """Generate a random emoji sequence for the given level.
-
-    Sequence length grows with level (level + 2), matching the
-    original game's difficulty curve.
-    """
+    """Generate a random emoji sequence for the given level."""
     if level < 1:
         raise ValueError("level must be >= 1")
     return random.choices(emojis, k=level + 2)
@@ -72,17 +75,12 @@ def format_countdown_message(remaining_seconds):
 
 
 def calculate_score(level, streak):
-    """Calculate score for a correctly-answered round.
-
-    Base score scales with level; a streak bonus rewards consecutive
-    correct answers.
-    """
+    """Calculate score for a correctly-answered round."""
     base = level * 10
     streak_bonus = streak * 2
     return base + streak_bonus
 
 
-
 # I/O helpers
 
 def load_high_score():
@@ -110,34 +108,25 @@ def save_high_score(score):
 
 
 def clear_screen():
-    os.system('cls' if os.name == 'nt' else 'clear')
+    """Safe clear screen that works in both terminal and browser."""
+    if is_browser():
+        print("\n" * 3)  # Simple spacing for browser
+    else:
+        os.system('cls' if os.name == 'nt' else 'clear')
 
 
 def run_countdown(duration, stop_event):
-    """Update a single countdown line once per second while waiting for input.
-
-    Runs in a background thread. Instead of printing a new line each
-    tick, it:
-      1. Saves the cursor's current position (which is on the input
-         line, wherever the user has typed so far).
-      2. Moves the cursor up 2 lines to the dedicated countdown line.
-      3. Clears that line and writes the new remaining-time message.
-      4. Restores the cursor back to the input line, so the user's
-         typing is completely undisturbed.
-
-    stop_event is set as soon as the user submits their answer, so the
-    countdown stops immediately rather than continuing to update.
-    """
+    """Original fancy countdown (terminal only)."""
     remaining = duration
     while remaining > 0:
         if stop_event.wait(timeout=1):
-            return  # user already answered, stop counting
+            return
         remaining -= 1
-        sys.stdout.write("\0337")        # save cursor position
-        sys.stdout.write("\033[2A")      # move up 2 lines -> countdown line
-        sys.stdout.write("\r\033[2K")    # jump to col 0 and clear the line
+        sys.stdout.write("\0337")
+        sys.stdout.write("\033[2A")
+        sys.stdout.write("\r\033[2K")
         sys.stdout.write(format_countdown_message(remaining))
-        sys.stdout.write("\0338")        # restore cursor -> back to input line
+        sys.stdout.write("\0338")
         sys.stdout.flush()
 
 
@@ -184,26 +173,33 @@ def main():
             time.sleep(display_time)
             clear_screen()
 
-            # Line 1: countdown line (updated in place by run_countdown)
-            # Line 2: static prompt text
-            # Line 3: "> " where the user actually types
+            # Input Phase
             print(format_countdown_message(input_time))
             print("Type the emojis in order (separated by spaces):")
             sys.stdout.write("> ")
             sys.stdout.flush()
 
-            stop_event = threading.Event()
-            timer_thread = threading.Thread(
-                target=run_countdown, args=(input_time, stop_event), daemon=True
-            )
-            timer_thread.start()
+            if is_browser():
+                # Simplified version for browser (no threads/ANSI)
+                print("\n⚠️ Browser mode active - enter your answer below.")
+                start_time = time.time()
+                user_input_raw = input().strip()
+                elapsed = time.time() - start_time
+            else:
+                # Original fancy terminal version
+                stop_event = threading.Event()
+                timer_thread = threading.Thread(
+                    target=run_countdown, args=(
+                        input_time, stop_event), daemon=True
+                )
+                timer_thread.start()
 
-            start_time = time.time()
-            user_input_raw = input().strip()
-            elapsed = time.time() - start_time
+                start_time = time.time()
+                user_input_raw = input().strip()
+                elapsed = time.time() - start_time
 
-            stop_event.set()
-            timer_thread.join(timeout=0.2)
+                stop_event.set()
+                timer_thread.join(timeout=0.2)
 
             user_input = parse_input(user_input_raw)
             timed_out = is_timeout(elapsed, input_time)
@@ -261,4 +257,4 @@ def main():
 
 
 if __name__ == '__main__':
-    main()
+    main()

games/FLAMES-Game/FLAMES-Game.py

@@ -4,6 +4,23 @@
 
 def main():
     global char, choice, count, final, flames, index, mapping, matched_chars, name1, name1_list, name2, name2_list, original_name1, original_name2, result, score, share_text, total_len, valid_game
+
+    # Session statistics tracker
+    session = {
+        "rounds": 0,
+        "results": {r: 0 for r in "FLAMES"},
+        "total_score": 0,
+    }
+
+    mapping = {
+        'F': {"rel": "Friends",  "emoji": "🤝", "metric": "Bond Strength"},
+        'L': {"rel": "Love",     "emoji": "❤️", "metric": "Compatibility Score"},
+        'A': {"rel": "Affection","emoji": "😊", "metric": "Crush Intensity"},
+        'M': {"rel": "Marriage", "emoji": "💍", "metric": "Marital Bliss"},
+        'E': {"rel": "Enemies",  "emoji": "😈", "metric": "Rivalry Quotient"},
+        'S': {"rel": "Siblings", "emoji": "🏠", "metric": "Nuisance Factor"},
+    }
+
     while True:
         print("\n" + "=" * 50)
         print("🔥 FLAMES GAME - FIND YOUR RELATIONSHIP STATUS! 🔥")
@@ -71,17 +88,13 @@ def main():
                 flames.pop(index)
 
             result = flames[0]
-
-            mapping = {
-                'F': {"rel": "Friends", "emoji": "🤝", "metric": "Bond Strength"},
-                'L': {"rel": "Love", "emoji": "❤️", "metric": "Compatibility Score"},
-                'A': {"rel": "Affection", "emoji": "😊", "metric": "Crush Intensity"},
-                'M': {"rel": "Marriage", "emoji": "💍", "metric": "Marital Bliss"},
-                'E': {"rel": "Enemies", "emoji": "😈", "metric": "Rivalry Quotient"},
-                'S': {"rel": "Siblings", "emoji": "🏠", "metric": "Nuisance Factor"}
-            }
             final = mapping[result]
 
+            # Update session statistics
+            session["rounds"] += 1
+            session["results"][result] += 1
+            session["total_score"] += score
+
             print("\n" + "=" * 50)
             print("📝 MATCH REPORT CARD")
             print("=" * 50)
@@ -107,6 +120,23 @@ def main():
             print("⚠️ Invalid choice. Please enter 'y' or 'n'.")
 
         if choice in ('n', 'no'):
+            # Display session statistics on exit
+            if session["rounds"] > 0:
+                avg = session["total_score"] / session["rounds"]
+                top = max(session["results"], key=session["results"].get)
+                print("\n" + "=" * 50)
+                print("📊 SESSION STATS")
+                print("=" * 50)
+                print(f"  Total Rounds Played : {session['rounds']}")
+                print("-" * 50)
+                for letter, count in session["results"].items():
+                    label = mapping[letter]["rel"]
+                    bar   = "█" * session["results"][letter]
+                    print(f"  {label:<12}: {count:>2}  {bar}")
+                print("-" * 50)
+                print(f"  Most Common Result  : {mapping[top]['rel']} {mapping[top]['emoji']}")
+                print(f"  Avg Score           : {avg:.1f}%")
+                print("=" * 50)
             print("\n👋 Thanks for playing FLAMES! Goodbye!")
             break
 

games/Word-Building/word_building.py

@@ -35,7 +35,10 @@ def Main():
     # Game loop
     while True:
         # User input and validation
-        user_word = input("Your word: ")
+        user_word = input("Your word: ").strip()
+        if not user_word:
+            print("\nPlease enter a valid word!")
+            continue
         if (bot_word is not None) and (user_word[0].lower() != bot_word[-1].lower()):
             print("\nInvalid word! Your word must start with the last letter of bot's word.")
             win = False