belote-cli 0.9.2__tar.gz → 0.9.4__tar.gz

{belote_cli-0.9.2 → belote_cli-0.9.4}/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.4] - 2026-04-26
+
+### Added
+- Detailed Round Score History pop-up (accessible via 'H').
+- Global Statistics screen in main menu.
+- Hotseat (2P) Mode for local multiplayer.
+- Undo Support (accessible via 'Z' during play).
+- Terminal Sound Effects for key events.
+- Seat-specific AI Difficulty configuration.
+- Support for skipping animations (Space/Esc).
+
+### Improved
+- Significant performance optimization for real-time HUD scoring.
+- UI rendering speed and smooth ASCII art animations.
+- O(1) rank lookup performance.
+
+### Fixed
+- Indentation and template errors in `main.py` and `ui.py`.
+
 ## [0.9.2] - 2026-04-26
 
 ### Fixed

{belote_cli-0.9.2 → belote_cli-0.9.4}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: belote-cli
-Version: 0.9.2
+Version: 0.9.4
 Summary: A 4-player terminal card game
 Project-URL: Homepage, https://github.com/ElysiumDisc/belote
 Project-URL: Repository, https://github.com/ElysiumDisc/belote
 Project-URL: Issues, https://github.com/ElysiumDisc/belote/issues
-Author-email: Benjamin <benjamin@example.com>
+Author-email: elysium <discelysioum@delicious.com>
 License: MIT License
         
         Copyright (c) 2026 Benjamin
@@ -111,9 +111,10 @@ pip install belote-cli
 belote
 
 # Custom settings
-belote --difficulty hard --target 500
+belote --difficulty hard --target 500 --seed 123 --speed fast
 ```
 
+
 ## Controls
 
 **Main Menu:**
@@ -130,12 +131,18 @@ belote --difficulty hard --target 500
 ## Features
 
 - **Rich Terminal UI:** Full-screen green felt table with detailed card graphics, face card art (Roi ♔, Dame ♕, Valet ⚔), and distinct color palettes.
-- **Main Menu:** Configure Difficulty, Target Score, and Game Speed, and access **Rules & History** (EN/FR) without restarting the app.
+- **Main Menu:** Configure Mode, Difficulty, Target Score, and Game Speed, and access **Rules & History** (EN/FR) without restarting the app.
+- **Undo/Redo:** Press `Z` to undo your last move during bidding or play.
+- **Statistics:** Global tracking of games played/won, win rate, capots, and streaks.
+- **Hotseat Mode:** Play with a friend locally (Human vs Human vs 2 AI).
+- **Sound Effects:** Auditory feedback for trick wins, Belote, Chute, and Capot.
+- **Animation Skip:** Press `Space` or `Esc` to skip AI delays and scoring animations.
 - **Live HUD:** Real-time round scoring displays points won during the current round, with a smooth "rolling" numerical animation for total scores.
 - **Trick History:** Visual "Last Trick" panel helps track the flow of the game.
 - **High Fidelity:** Full implementation of French Belote rules including a two-round bidding system, "Dix de Der", and "Capot" (250 pts) announcements.
 - **Rules & History Viewer:** A scrollable, bilingual (English/French) in-game reference for the game's heritage and mechanics.
 - **Robust Input:** High-performance unbuffered key reading for responsive navigation and 'q' to quit functionality.
+- **Replayability:** Use `--seed <number>` to reproduce the exact same deck and AI choices.
 
 ## AI
 

{belote_cli-0.9.2 → belote_cli-0.9.4}/README.md

@@ -72,9 +72,10 @@ pip install belote-cli
 belote
 
 # Custom settings
-belote --difficulty hard --target 500
+belote --difficulty hard --target 500 --seed 123 --speed fast
 ```
 
+
 ## Controls
 
 **Main Menu:**
@@ -91,12 +92,18 @@ belote --difficulty hard --target 500
 ## Features
 
 - **Rich Terminal UI:** Full-screen green felt table with detailed card graphics, face card art (Roi ♔, Dame ♕, Valet ⚔), and distinct color palettes.
-- **Main Menu:** Configure Difficulty, Target Score, and Game Speed, and access **Rules & History** (EN/FR) without restarting the app.
+- **Main Menu:** Configure Mode, Difficulty, Target Score, and Game Speed, and access **Rules & History** (EN/FR) without restarting the app.
+- **Undo/Redo:** Press `Z` to undo your last move during bidding or play.
+- **Statistics:** Global tracking of games played/won, win rate, capots, and streaks.
+- **Hotseat Mode:** Play with a friend locally (Human vs Human vs 2 AI).
+- **Sound Effects:** Auditory feedback for trick wins, Belote, Chute, and Capot.
+- **Animation Skip:** Press `Space` or `Esc` to skip AI delays and scoring animations.
 - **Live HUD:** Real-time round scoring displays points won during the current round, with a smooth "rolling" numerical animation for total scores.
 - **Trick History:** Visual "Last Trick" panel helps track the flow of the game.
 - **High Fidelity:** Full implementation of French Belote rules including a two-round bidding system, "Dix de Der", and "Capot" (250 pts) announcements.
 - **Rules & History Viewer:** A scrollable, bilingual (English/French) in-game reference for the game's heritage and mechanics.
 - **Robust Input:** High-performance unbuffered key reading for responsive navigation and 'q' to quit functionality.
+- **Replayability:** Use `--seed <number>` to reproduce the exact same deck and AI choices.
 
 ## AI
 

{belote_cli-0.9.2 → belote_cli-0.9.4}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "belote-cli"
-version = "0.9.2"
+version = "0.9.4"
 description = "A 4-player terminal card game"
 readme = "README.md"
 requires-python = ">=3.10"
 license = {file = "LICENSE"}
 authors = [
-    { name = "Benjamin", email = "benjamin@example.com" },
+    { name = "elysium", email = "discelysioum@delicious.com" },
 ]
 classifiers = [
     "Programming Language :: Python :: 3",

{belote_cli-0.9.2 → belote_cli-0.9.4}/src/belote/ansi.py

@@ -90,52 +90,52 @@ def scroll_region(top: int, bottom: int) -> str:
 
 # Palette constants
 def felt_bg() -> str:
-    return bg(20, 90, 50)
+    return bg(25, 75, 45) # Deeper, more muted green
 
 
 def red_fg() -> str:
-    return fg(220, 60, 60)
+    return fg(190, 45, 45) # Muted crimson
 
 
 def black_fg() -> str:
-    return fg(20, 20, 20)
+    return fg(40, 40, 40) # Slightly softer black
 
 
 def card_face_bg() -> str:
-    return bg(245, 245, 235)
+    return bg(248, 245, 230) # Richer cream/parchment
 
 
 def face_card_bg() -> str:
-    return bg(255, 245, 180)
+    return bg(250, 240, 200) # Golden-aged parchment
 
 
 def card_back_bg() -> str:
-    return bg(120, 30, 30)
+    return bg(110, 35, 35) # Deep burgundy
 
 
 def highlight_bg() -> str:
-    return bg(240, 200, 80)
+    return bg(230, 190, 70) # Brass/Gold highlight
 
 
 def gold_fg() -> str:
-    return fg(240, 200, 80)
+    return fg(210, 170, 60) # Antique gold
 
 
 def white_fg() -> str:
-    return fg(240, 240, 240)
+    return fg(235, 235, 230) # Off-white
 
 
 def light_gray_fg() -> str:
-    return fg(180, 180, 180)
+    return fg(160, 160, 155) # Muted stone gray
 
 
 def green_fg() -> str:
-    return fg(80, 220, 120)
+    return fg(60, 160, 90) # Sage green
 
 
 def banner_bg() -> str:
-    return bg(60, 60, 180)
+    return bg(50, 65, 120) # Muted royal blue
 
 
 def banner_fg() -> str:
-    return fg(255, 255, 100)
+    return fg(240, 220, 150) # Pale gold text

{belote_cli-0.9.2 → belote_cli-0.9.4}/src/belote/game.py

@@ -5,7 +5,7 @@ from dataclasses import dataclass, replace
 from enum import Enum
 from typing import Final
 
-from .deck import Card, Rank, Suit, trick_rank
+from .deck import Card, Rank, Suit, trick_rank, make_deck, shuffle as shuffle_deck_, deal as deal_cards_, card_points
 
 # ---------------------------------------------------------------------------
 # Enums
@@ -110,6 +110,21 @@ class TrickCard:
     card: Card
 
 
+@dataclass(frozen=True, slots=True)
+class RoundScore:
+    taker_team: int
+    ns_card_pts: int
+    ew_card_pts: int
+    ns_decl_pts: int
+    ew_decl_pts: int
+    ns_belote_pts: int
+    ew_belote_pts: int
+    ns_total: int
+    ew_total: int
+    is_failed: bool
+    is_capot: bool
+
+
 @dataclass(frozen=True, slots=True)
 class GameState:
     hands: tuple[tuple[Card, ...], ...]  # indexed by Seat.value
@@ -127,6 +142,8 @@ class GameState:
     declarations_resolved: bool
     team_scores: tuple[int, int]  # (NS, EW)
     round_scores: tuple[int, int]  # this round declaration points (NS, EW)
+    current_round_points: tuple[int, int]  # this round card points (NS, EW)
+    score_history: tuple[RoundScore, ...]
     target: int
     up_card: Card | None  # The card turned up during bidding phase
     remaining_cards: tuple[Card, ...]  # The 11 cards to be dealt after bidding
@@ -170,6 +187,8 @@ def new_game(target: int = 1000) -> GameState:
         declarations_resolved=False,
         team_scores=(0, 0),
         round_scores=(0, 0),
+        current_round_points=(0, 0),
+        score_history=(),
         target=target,
         up_card=None,
         remaining_cards=(),
@@ -204,6 +223,7 @@ def start_round(state: GameState, rng: random.Random) -> GameState:
         declarations=(),
         declarations_resolved=False,
         round_scores=(0, 0),
+        current_round_points=(0, 0),
         up_card=up_card,
         remaining_cards=remaining,
         bidder_index=0,
@@ -216,26 +236,13 @@ def start_round(state: GameState, rng: random.Random) -> GameState:
 
 
 def shuffle_deck(rng: random.Random) -> tuple[Card, ...]:
-    from .deck import make_deck, shuffle as shuffle_deck_
     return shuffle_deck_(make_deck(), rng)
 
 
-def deal_cards(deck: tuple[Card, ...]) -> tuple[tuple[Card, ...], ...]:
-    from .deck import deal as deal_cards_
+def deal_cards(deck: tuple[Card, ...]) -> tuple[tuple[tuple[Card, ...], ...], Card, tuple[Card, ...]]:
     return deal_cards_(deck)
 
 
-def bidding_order(dealer: Seat) -> tuple[Seat, ...]:
-    """Return seats in bidding order (counter-clockwise from left of dealer)."""
-    start = dealer.next_seat()
-    return tuple(start.next_seat().next_seat().next_seat() if i == 0 else
-                 (start if i == 0 else
-                  (start.next_seat() if i == 1 else
-                   (start.next_seat().next_seat() if i == 2 else
-                    start.next_seat().next_seat().next_seat())))
-                 for i in range(4))
-
-
 def get_bidder(dealer: Seat, index: int) -> Seat:
     """Get the seat of the bidder at the given index."""
     start = dealer.next_seat()
@@ -481,10 +488,26 @@ def play_card(state: GameState, card: Card) -> GameState:
         new_completed = state.completed_tricks + (new_trick,)
         tricks_count = len(new_completed)
 
+        # Update current round points
+        trick_pts = sum(card_points(tc.card, state.trump) for tc in new_trick) # type: ignore[arg-type]
+        ns_pts, ew_pts = state.current_round_points
+        if team_of(winner) == 0:
+            ns_pts += trick_pts
+        else:
+            ew_pts += trick_pts
+
+        # Last trick bonus
+        if tricks_count == 8:
+            if team_of(winner) == 0:
+                ns_pts += 10
+            else:
+                ew_pts += 10
+
+        new_round_points = (ns_pts, ew_pts)
+
         # Check if round is complete (8 tricks)
         if tricks_count >= 8:
             # Round over
-            ns_round, ew_round = state.round_scores
             return replace(
                 state,
                 hands=tuple(new_hands),
@@ -497,6 +520,7 @@ def play_card(state: GameState, card: Card) -> GameState:
                 announced=announced,
                 belote_tracker=tuple(belote_tracker),
                 first_trick_done=True,
+                current_round_points=new_round_points,
             )
         else:
             # Next trick led by winner
@@ -513,6 +537,7 @@ def play_card(state: GameState, card: Card) -> GameState:
                 announced=announced,
                 belote_tracker=tuple(belote_tracker),
                 first_trick_done=first_trick_done,
+                current_round_points=new_round_points,
             )
     else:
         # Next player in trick