belote-cli 2.9.0__tar.gz → 2.9.5__tar.gz

{belote_cli-2.9.0 → belote_cli-2.9.5}/CHANGELOG.md

@@ -5,6 +5,81 @@ 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).
 
+## [2.9.5] - 2026-05-07
+
+In-game keyboard shortcuts cleaned up, the trick mat now anchors every played card inside a visible per-seat slot, the round history overlay carries the full per-round picture, and the cards have been redrawn in a GRIMAUD-1898 style with both-corner indices and patterned pip layouts.
+
+### Fixed
+
+- **`src/belote/input.py`** — `Key.THEME` was defined but never mapped to a keystroke; the help text falsely advertised `Shift+T` (which terminals can't generally distinguish in raw mode). Theme cycling during gameplay was unreachable. New mapping: `t/T → Key.THEME`, `h/H → Key.HIST`, `?` → `Key.HELP`, `o/O → Key.SORT`. Both the Unix and Windows readers updated.
+- **`src/belote/input.py`** — `s` was previously stolen by `Key.SORT`, so pressing `S` in round-2 bidding triggered a sort instead of the **Sans Atout** quick-bid the help text promised. Sort now lives on `O` (matching what the help screen always claimed) and `s` falls through to `Key.CHAR` so SA bidding works.
+- **`src/belote/gameflow.py::run_play`** — when the user had already pressed any key earlier in the round (which sets `skip_anims`), the post-trick pause was skipped entirely and the 4th card vanished before it could be read. New `MIN_TRICK_DWELL = 0.5s` non-skippable hold runs after every completed trick (even on the `instant` speed preset) so the player always sees all four cards before the mat clears.
+
+### Added
+
+- **`src/belote/ui/render.py`** — visible **slot frames** drawn around each compass position on the trick mat. Implemented via three new helpers (`_slot_anchors`, `_slot_frame_row`, `_felt_pad_ns`, `_we_row`) that paint thin `─`/`│` borders on the felt cells immediately surrounding each card slot, in the felt-placeholder dim colour. Total mat dimensions (`6 + 3*card_h`) are unchanged, so `_calculate_base_row` and `patch_trick_card` continue to work without any coordinate adjustments — patched cards land exactly inside the existing frame.
+- **`src/belote/game.py::RoundScore`** — eight new optional fields (`contract`, `trump`, `taker_seat`, `tricks_ns`, `tricks_ew`, `last_trick_winner`, `decl_summary_ns`, `decl_summary_ew`) populated from `state` and `state.completed_tricks` at scoring time. All fields default so existing test fixtures and any historical `RoundScore` constructions remain valid.
+- **`src/belote/scoring.py::apply_round_score`** — now computes per-team trick counts via `trick_winner_seat`/`team_of`, builds short declaration labels (`"100♥"`, `"Belote"`, `"Carré-J"`, …) gated on the team's `*_decl_pts > 0` so only the *scored* declarations appear, and threads everything into `RoundScore`. New helper `_decl_short_label` covers belote/rebelote/sequence/carre.
+- **`src/belote/ui/prompts.py::show_history`** — rewritten as an 8-column table (`RD | TAKER | CONTRACT | TRICKS | DECLARATIONS | NS | EW | STATUS`) for terminals ≥78 cols, with a 2-line-per-round fallback for narrower terminals. Status colouring: gold `CAPOT`, red `CHUTE`, dim `LITIGE`. Existing scrolling, view-height clamp, and exit-on-any-key behaviour preserved.
+- **`src/belote/ui/render.py::_card_face_internal`** — full GRIMAUD-1898-inspired redraw:
+  - Both corners now carry a 3-cell `rank+suit` index (`A♠` top-left, `♠A` bottom-right). The index padding scales with `inner_w`.
+  - Pip cards (7-10) at `card_h ≥ 7` get a recognisable pip arrangement instead of a single centred suit symbol.
+  - Court cards J/Q/K each get a distinct multi-row motif (sword, jewelled headdress, crown).
+  - Aces get a decorative `╭─◆─╮` / `╰─◆─╯` wreath around the central suit.
+  - Compact 6×5 layout keeps the single inner row but still benefits from both-corner indices.
+  - All variants honour the active theme (`face_card_bg`, `card_face_bg`, `highlight_bg`, `red_fg`/`black_fg`) and the `DIM` prefix for illegal cards. ASCII fallback paths preserved.
+- **`tests/test_extended.py::test_round_score_history_extra_fields`** — pins the new `RoundScore` fields end-to-end through `apply_round_score`.
+
+### Changed
+
+- **`src/belote/ui/menu.py`** — main-menu loop now handles `Key.THEME` (cycles forward through `THEMES`), so the new in-game `T` shortcut works at the menu too.
+- **`src/belote/main.py`**, **`src/belote/ui/render.py`** — game-over hint and HUD compact hint updated to advertise the new `[H] History` / `[T] Theme` shortcuts.
+- **`src/belote/ui/prompts.py::show_help`** — help-screen text rewritten to match the new bindings.
+- **`README.md`** — Controls section rewritten; theme section now lists all six themes by name.
+- **`tests/test_layout.py::test_hud_compact_omits_help_hints_and_theme`** — assertion updated for the new compact-HUD hint substring.
+
+### Notes
+
+436/436 tests pass. No gameplay, scoring, or AI-decision changes — all updates are UX (keys, slot framing, dwell, history depth, card glyphs).
+
+## [2.9.2] - 2026-05-07
+
+Render-pipeline fix for Konsole (KDE/Kubuntu) and other strict ANSI terminals where UI elements visibly stacked on top of each other — the top HUD repeating ~6 times, "Theme: Sepia Vintage" duplicating in the right column, "Partner" doubling, the bid prompt repainting below itself, and bid history accumulating between frames. The bug existed in the code on every terminal but VTE-based emulators (LXTerminal, GNOME Terminal, xterm) auto-blanked the leaking cells, masking it. Konsole's Vt102Emulation does not, so the leakage was visible.
+
+### Fixed
+
+- **`src/belote/ui/render.py::render`** — the bidding selector (Round 1 inline highlighted Take/Pass; Round 2 boxed grid; optional `partner_bid_tendency_text` line) is now painted inside the main render frame via the new `bid_selection: int | None` parameter on `render()` and `display()`. Previously `prompt_bid` paid display() and then wrote 8+ extra `\r\n` lines, which scrolled the alt-screen on the bottom row and left stale rows that the next frame's blank padding never repainted.
+- **`src/belote/ui/render.py::render`** — every line in the rendered frame now ends with `clear_to_eol()` (`\x1b[K`), including blank vertical-centering padding rows. The previous `line + clear_to_eol() if line else line` branch skipped the escape on padding rows, betting the previous frame's content area had already cleared them — but that bet broke whenever an external write (announcement, prompt artifact) deposited debris on a padding row. Cost is one 3-byte escape per row; benefit is correct rendering on any ANSI-compliant terminal regardless of strictness.
+- **`src/belote/ui/prompts.py::prompt_bid`** — gutted of all post-`display()` `sys.stdout.write` calls. Each loop iteration is now a single `display(state, None, bid_selection=sel)` + `reader.read()`. Removed unused `REVERSE` and `black_fg` imports (the box-rendering code that consumed them moved to `render.py::_build_bid_prompt_lines`).
+- **`src/belote/ui/announce.py::announce`** — replaced the `\r\n`-bracketed banner with absolute cursor positioning (`move(term_h - 1, 1) + clear_line()`) so the banner can never trigger a scroll, even when the cursor is parked on the bottom row of the alt-screen.
+
+### Added
+
+- **`src/belote/ui/render.py::_build_bid_prompt_lines`** — pure helper that returns the in-frame bidding selector lines. Encapsulates the Round 1 inline form, the Round 2 60-column boxed form, and the optional partner-tendency line so the main render loop reads as one coherent paint.
+
+### Notes
+
+No gameplay, scoring, or AI changes. 435/435 tests pass. The fix is observable when running under Konsole — start a Belote round, force a Round 2 bid (pass on the up-card), and arrow-navigate the selector: previously the box stacked between iterations; now it repaints in place.
+
+## [2.9.1] - 2026-05-06
+
+UI polish patch on top of 2.9.0. Two pieces of menu art had drifted; this release fixes both and tightens the menu plumbing so the cup walls hold for every label combination.
+
+### Fixed
+
+- **`src/belote/ui/menu.py::get_cards_art`** — the croissant Braille had a corrupted line 8 (`⠘⢿⡿⠋⣠⣾⣿⣿⣿⠟⠁⣿⣿⣿⣿⣿⠟⢁⣀`, 21 cells) that broke the right curl, and was missing the 13th-line `⠉⠉⠉` crumb under the tip entirely. Restored to the canonical 13-line, 25-cell-wide reference. Each line now uses U+2800 Braille blanks for its leading indent (uniform 25-cell width) rather than mixed ASCII spaces, so callers don't have to re-pad.
+- **`src/belote/ui/menu.py::CUP_TEMPLATE`** — body inner width was 47 chars (29-char opt + 16 trailing dead space + 2 gutter), much wider than the 23-char lid and saucer. Now 29 chars flush so menu options sit between the cup walls with no padding. Steam line 2 now correctly shows the two-puff frame (`)     (`) — previously the template's leading-indent disagreement with `STEAMS[..][1]` pushed the second puff out of view.
+- **`src/belote/ui/menu.py::_render_main_menu_art`** — selected-row markers tightened from ` > {label} < ` (6-char overhead) to `> {label} <` (4-char overhead) so the selected row uses the same width budget as unselected (`  {label}  `, also 4-char overhead). Without this, a selected `Theme: < Sepia Vintage >` would bust the right cup wall.
+- **`src/belote/ui/menu.py::show_main_menu`** — settings labels shortened to fit the new 25-char usable label width: `AI Config:` → `AI:`, `Target Score:` → `Target:`. `Speed:` and `Theme:` keep their names with tightened spacing. All four `<` markers still column-align.
+
+### Changed
+
+- **`src/belote/ui/menu.py::_render_main_menu_art`** — opt-slot loop and assertion bound dropped from 12 → 9 to match the new template. The error message ("add opt slots to CUP_TEMPLATE") still points at the right fix if the menu ever grows past 9 entries.
+
+### Notes
+
+No gameplay or scoring changes; classic and BelAtro behavior is bit-for-bit identical. 435/435 tests pass; ruff and mypy clean on `src/`. Pre-existing lint/type debt in `tests/` and `scripts/benchmark.py` (18 ruff, 69 mypy strict-mode annotations) is untouched and tracked separately.
+
 ## [2.9.0] - 2026-05-06
 
 Audit-driven sweep on top of 2.8.0: four engine bugs fixed and the long-deferred Tout Atout / Sans Atout bidding affordance shipped end-to-end. The README's "future work" line for those contracts is gone — both contracts are now bidable in classic Belote and BelAtro, and the two jokers / two unlock counters that had been waiting on the affordance now fire in real play. Plan: `plans/bug-hunt-code-performance-elegant-starlight.md`.

{belote_cli-2.9.0 → belote_cli-2.9.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: belote-cli
-Version: 2.9.0
+Version: 2.9.5
 Summary: A 4-player terminal card game
 Project-URL: Homepage, https://github.com/ElysiumDisc/belote
 Project-URL: Repository, https://github.com/ElysiumDisc/belote
@@ -88,18 +88,19 @@ belatro
 
 ### Main Menu
 ```text
-      ⢠⣴⣶⣶⣶⣄
-      ⣿⣿⣿⣿⣿⣿⣦
-     ⢰⣿⣿⣿⣿⡿⠟⠁⣠⣴⣶⣦⠄
-     ⢸⣿⣿⠟⠉⣠⣴⣿⣿⣿⠟⠁⣠⣾⣿⣦⡀
-      ⠉⣀⣴⣾⣿⣿⣿⠟⢁⣤⣾⣿⣿⣿⣿⣿⡆
-    ⢀⣤⣾⣿⣿⣿⡿⠛⢁⣴⣿⣿⣿⡿⠛⢁⣴⣿⣿⣿⣿⣿⣿⣿⠟⠁⡀
-    ⢼⣿⣿⣿⡿⠋⣀⣴⣿⣿⣿⣿⣿⣿⣿⡿⠉⣠⣾⣿⡆
-    ⠘⢿⡿⠋⣠⣾⣿⣿⣿⠟⠁⣿⣿⣿⣿⣿⠟⢁⣀
-      ⣠⣾⣿⣿⣿⣿⣿⣿⣿⣿⠏⢀⣴⣿⣿⣿⠋⢠⣾⣿⣷⣦⡀
-      ⢻⣿⣿⣿⣿⣿⣿⣿⠟⢁⣴⣿⣿⣿⡿⠁⣰⣿⣿⣿⣿⣿⣿
-       ⠹⢿⣿⣿⣿⡿⠋⣠⣾⣿⣿⣿⠟⢀⣼⣿⣿⣿⣿⣿⣿⡟
-         ⠉⠉⠉⠀⢾⣿⣿⣿⣿⠋⠀⠚⠛⠛⠛⠛⠛⠛⠁
+  ⢠⣴⣶⣶⣶⣄
+  ⣿⣿⣿⣿⣿⣿⣦
+ ⢰⣿⣿⣿⣿⡿⠟⠁⣠⣴⣶⣦⠄
+ ⢸⣿⣿⠟⠉⣠⣴⣿⣿⣿⠟⠁⣠⣾⣿⣦⡀
+  ⠉⣀⣴⣾⣿⣿⣿⠟⢁⣤⣾⣿⣿⣿⣿⣿⡆
+⢀⣤⣾⣿⣿⣿⡿⠛⢁⣴⣿⣿⣿⣿⣿⣿⣿⠟⠁⡀
+⢼⣿⣿⣿⡿⠋⣀⣴⣿⣿⣿⣿⣿⣿⣿⡿⠉⣠⣾⣿⡆
+⠘⢿⡿⠋⣠⣾⣿⣿⣿⣿⣿⣿⣿⡿⠋⢀⣾⣿⣿⠟⢁⣀
+  ⣠⣾⣿⣿⣿⣿⣿⣿⣿⣿⠏⢀⣴⣿⣿⣿⠋⢠⣾⣿⣷⣦⡀
+  ⢻⣿⣿⣿⣿⣿⣿⣿⠟⢁⣴⣿⣿⣿⡿⠁⣰⣿⣿⣿⣿⣿⣿
+   ⠹⢿⣿⣿⣿⡿⠋⣠⣾⣿⣿⣿⠟⢀⣼⣿⣿⣿⣿⣿⣿⡟
+     ⠉⠉⠉ ⢾⣿⣿⣿⣿⠋ ⠚⠛⠛⠛⠛⠛⠛⠁
+          ⠉⠉⠉
 
                        (
                         )     (
@@ -107,12 +108,17 @@ belatro
              .-''       )    (          ''-.
        .-'``'|-._             )         _.-|
       /  .--.|   `''---...........---''`   |
-     /  /    |       > Start Game <        |
-     |  |    |     Difficulty: Medium      |
-      \  \   |    Target Score: 1000       |
-       `\ `\ |       Speed: Normal         |
-         `\ `|      Rules & History        |
-         _/ /\           Quit              /
+     /  /    |           BelAtro           |
+     |  |    |       > Start Game <        |
+     |  |    |      AI:     < Hard >       |
+     |  |    |      Target: < 1000 >       |
+     |  |    |     Speed:  < Normal >      |
+     |  |    |  Theme:  < Classic Green >  |
+     |  |    |       Rules & History       |
+      \  \   |         Statistics          |
+       `\ `\ |            Quit             |
+         `\ `|                             |
+         _/ /\                             /
         (__/  \                           /
      _..---''` \                         /`''---.._
   .-'           \                       /          '-.
@@ -164,12 +170,12 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 ## Controls
 
 **General:**
-- `?` or `H`: Show keyboard shortcut help
+- `?`: Show keyboard shortcut help
 - `M`: Toggle sound effects on/off
-- `I`: Toggle BelAtro score overlay (per-trick breakdown popup)
+- `I` or `V`: Toggle BelAtro score overlay (per-trick breakdown popup)
 - `Q`: Quit to main menu or exit
-- `t`: View Game History (Round-by-round)
-- `T`: Switch UI Theme
+- `H`: View Game History (round-by-round, with contract / taker / tricks / declarations)
+- `T`: Cycle UI Theme
 
 **Classic Belote:**
 - `↑` `↓`: Navigate options
@@ -177,7 +183,6 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 - `Enter`: Select option / Enter submenu
 
 **BelAtro (Roguelite):**
-- `S`: View current Run State and Jokers
 - `1`-`5`: Inspect specific Jokers in the Shop
 - `U`: Use a consumable (Tarot/Planet) during gameplay
 
@@ -188,6 +193,7 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 - `O`: Sort hand by suit and rank
 - `Z`: Undo last move
 - `Space` or `Esc`: Skip animations
+- During bidding round 2: `P` = Pass, `A` = Tout Atout, `S` = Sans Atout
 
 ## Features
 
@@ -198,7 +204,7 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 - **Partner Trust:** Build a relationship with your AI partner to unlock synergies.
 - **Rich Terminal UI:** Full-screen green felt table with detailed card graphics and "You" vs "Partner" terminology.
 - **Enhanced Hard AI**: Advanced void inference and 2-ply lookahead for critical tricks (Dix de Der).
-- **Customizable Themes:** Switch between different color palettes (e.g., Classic Green, Dark Blue, Royal Purple) using the `T` key during gameplay.
+- **Customizable Themes:** Switch between six color palettes (Classic Green, Dark Mode, Blue Velvet, Red Casino, Sepia Vintage, High Contrast) using the `T` key during gameplay.
 - **Incremental Rendering:** High-performance cursor-based updates for zero-flicker gameplay even at high speeds.
 - **Hand Sorting:** Strategic "play value" organization (honors grouped together) for better tactical awareness.
 - **Main Menu:** Simple single-player entry point with configurable AI difficulty, Target Score, and Speed.
@@ -289,3 +295,5 @@ This will wipe all global statistics and reset your discovered item Almanac in B
 ## Terminal Hygiene
 
 Signal handlers (SIGINT, SIGTERM) and atexit hooks ensure the terminal is always restored — cursor visible, colors reset, alt-screen off — even after Ctrl+C or crashes.
+
+Every rendered row ends with `\x1b[K` (clear-to-end-of-line) and every interactive prompt (bid selector, card selector, full-screen overlays) repaints in a single in-frame pass — no `\r\n`-bracketed writes outside the render. This keeps the game free of stale-cell artifacts on strict ANSI emulators like Konsole (KDE), in addition to the more lenient VTE-based terminals (GNOME Terminal, LXTerminal, xterm).

{belote_cli-2.9.0 → belote_cli-2.9.5}/README.md

@@ -45,18 +45,19 @@ belatro
 
 ### Main Menu
 ```text
-      ⢠⣴⣶⣶⣶⣄
-      ⣿⣿⣿⣿⣿⣿⣦
-     ⢰⣿⣿⣿⣿⡿⠟⠁⣠⣴⣶⣦⠄
-     ⢸⣿⣿⠟⠉⣠⣴⣿⣿⣿⠟⠁⣠⣾⣿⣦⡀
-      ⠉⣀⣴⣾⣿⣿⣿⠟⢁⣤⣾⣿⣿⣿⣿⣿⡆
-    ⢀⣤⣾⣿⣿⣿⡿⠛⢁⣴⣿⣿⣿⡿⠛⢁⣴⣿⣿⣿⣿⣿⣿⣿⠟⠁⡀
-    ⢼⣿⣿⣿⡿⠋⣀⣴⣿⣿⣿⣿⣿⣿⣿⡿⠉⣠⣾⣿⡆
-    ⠘⢿⡿⠋⣠⣾⣿⣿⣿⠟⠁⣿⣿⣿⣿⣿⠟⢁⣀
-      ⣠⣾⣿⣿⣿⣿⣿⣿⣿⣿⠏⢀⣴⣿⣿⣿⠋⢠⣾⣿⣷⣦⡀
-      ⢻⣿⣿⣿⣿⣿⣿⣿⠟⢁⣴⣿⣿⣿⡿⠁⣰⣿⣿⣿⣿⣿⣿
-       ⠹⢿⣿⣿⣿⡿⠋⣠⣾⣿⣿⣿⠟⢀⣼⣿⣿⣿⣿⣿⣿⡟
-         ⠉⠉⠉⠀⢾⣿⣿⣿⣿⠋⠀⠚⠛⠛⠛⠛⠛⠛⠁
+  ⢠⣴⣶⣶⣶⣄
+  ⣿⣿⣿⣿⣿⣿⣦
+ ⢰⣿⣿⣿⣿⡿⠟⠁⣠⣴⣶⣦⠄
+ ⢸⣿⣿⠟⠉⣠⣴⣿⣿⣿⠟⠁⣠⣾⣿⣦⡀
+  ⠉⣀⣴⣾⣿⣿⣿⠟⢁⣤⣾⣿⣿⣿⣿⣿⡆
+⢀⣤⣾⣿⣿⣿⡿⠛⢁⣴⣿⣿⣿⣿⣿⣿⣿⠟⠁⡀
+⢼⣿⣿⣿⡿⠋⣀⣴⣿⣿⣿⣿⣿⣿⣿⡿⠉⣠⣾⣿⡆
+⠘⢿⡿⠋⣠⣾⣿⣿⣿⣿⣿⣿⣿⡿⠋⢀⣾⣿⣿⠟⢁⣀
+  ⣠⣾⣿⣿⣿⣿⣿⣿⣿⣿⠏⢀⣴⣿⣿⣿⠋⢠⣾⣿⣷⣦⡀
+  ⢻⣿⣿⣿⣿⣿⣿⣿⠟⢁⣴⣿⣿⣿⡿⠁⣰⣿⣿⣿⣿⣿⣿
+   ⠹⢿⣿⣿⣿⡿⠋⣠⣾⣿⣿⣿⠟⢀⣼⣿⣿⣿⣿⣿⣿⡟
+     ⠉⠉⠉ ⢾⣿⣿⣿⣿⠋ ⠚⠛⠛⠛⠛⠛⠛⠁
+          ⠉⠉⠉
 
                        (
                         )     (
@@ -64,12 +65,17 @@ belatro
              .-''       )    (          ''-.
        .-'``'|-._             )         _.-|
       /  .--.|   `''---...........---''`   |
-     /  /    |       > Start Game <        |
-     |  |    |     Difficulty: Medium      |
-      \  \   |    Target Score: 1000       |
-       `\ `\ |       Speed: Normal         |
-         `\ `|      Rules & History        |
-         _/ /\           Quit              /
+     /  /    |           BelAtro           |
+     |  |    |       > Start Game <        |
+     |  |    |      AI:     < Hard >       |
+     |  |    |      Target: < 1000 >       |
+     |  |    |     Speed:  < Normal >      |
+     |  |    |  Theme:  < Classic Green >  |
+     |  |    |       Rules & History       |
+      \  \   |         Statistics          |
+       `\ `\ |            Quit             |
+         `\ `|                             |
+         _/ /\                             /
         (__/  \                           /
      _..---''` \                         /`''---.._
   .-'           \                       /          '-.
@@ -121,12 +127,12 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 ## Controls
 
 **General:**
-- `?` or `H`: Show keyboard shortcut help
+- `?`: Show keyboard shortcut help
 - `M`: Toggle sound effects on/off
-- `I`: Toggle BelAtro score overlay (per-trick breakdown popup)
+- `I` or `V`: Toggle BelAtro score overlay (per-trick breakdown popup)
 - `Q`: Quit to main menu or exit
-- `t`: View Game History (Round-by-round)
-- `T`: Switch UI Theme
+- `H`: View Game History (round-by-round, with contract / taker / tricks / declarations)
+- `T`: Cycle UI Theme
 
 **Classic Belote:**
 - `↑` `↓`: Navigate options
@@ -134,7 +140,6 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 - `Enter`: Select option / Enter submenu
 
 **BelAtro (Roguelite):**
-- `S`: View current Run State and Jokers
 - `1`-`5`: Inspect specific Jokers in the Shop
 - `U`: Use a consumable (Tarot/Planet) during gameplay
 
@@ -145,6 +150,7 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 - `O`: Sort hand by suit and rank
 - `Z`: Undo last move
 - `Space` or `Esc`: Skip animations
+- During bidding round 2: `P` = Pass, `A` = Tout Atout, `S` = Sans Atout
 
 ## Features
 
@@ -155,7 +161,7 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 - **Partner Trust:** Build a relationship with your AI partner to unlock synergies.
 - **Rich Terminal UI:** Full-screen green felt table with detailed card graphics and "You" vs "Partner" terminology.
 - **Enhanced Hard AI**: Advanced void inference and 2-ply lookahead for critical tricks (Dix de Der).
-- **Customizable Themes:** Switch between different color palettes (e.g., Classic Green, Dark Blue, Royal Purple) using the `T` key during gameplay.
+- **Customizable Themes:** Switch between six color palettes (Classic Green, Dark Mode, Blue Velvet, Red Casino, Sepia Vintage, High Contrast) using the `T` key during gameplay.
 - **Incremental Rendering:** High-performance cursor-based updates for zero-flicker gameplay even at high speeds.
 - **Hand Sorting:** Strategic "play value" organization (honors grouped together) for better tactical awareness.
 - **Main Menu:** Simple single-player entry point with configurable AI difficulty, Target Score, and Speed.
@@ -246,3 +252,5 @@ This will wipe all global statistics and reset your discovered item Almanac in B
 ## Terminal Hygiene
 
 Signal handlers (SIGINT, SIGTERM) and atexit hooks ensure the terminal is always restored — cursor visible, colors reset, alt-screen off — even after Ctrl+C or crashes.
+
+Every rendered row ends with `\x1b[K` (clear-to-end-of-line) and every interactive prompt (bid selector, card selector, full-screen overlays) repaints in a single in-frame pass — no `\r\n`-bracketed writes outside the render. This keeps the game free of stale-cell artifacts on strict ANSI emulators like Konsole (KDE), in addition to the more lenient VTE-based terminals (GNOME Terminal, LXTerminal, xterm).

{belote_cli-2.9.0 → belote_cli-2.9.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "belote-cli"
-version = "2.9.0"
+version = "2.9.5"
 description = "A 4-player terminal card game"
 readme = "README.md"
 requires-python = ">=3.10"

{belote_cli-2.9.0 → belote_cli-2.9.5}/src/belote/__init__.py

@@ -1,3 +1,3 @@
-__version__ = "2.8.0"
+__version__ = "2.9.5"
 
 __all__ = ["__version__"]

{belote_cli-2.9.0 → belote_cli-2.9.5}/src/belote/game.py

@@ -149,6 +149,14 @@ class RoundScore:
     is_capot: bool
     is_litige: bool = False
     litige_points: int = 0
+    contract: str | None = None
+    trump: Suit | None = None
+    taker_seat: Seat | None = None
+    tricks_ns: int = 0
+    tricks_ew: int = 0
+    last_trick_winner: Seat | None = None
+    decl_summary_ns: tuple[str, ...] = ()
+    decl_summary_ew: tuple[str, ...] = ()
 
 
 @dataclass(frozen=True, slots=True)

{belote_cli-2.9.0 → belote_cli-2.9.5}/src/belote/gameflow.py

@@ -50,6 +50,12 @@ from .ui import (
 )
 
 
+# Minimum time the four cards stay on the mat before a trick clears. This
+# applies even when the user has skipped earlier animations (so a fast-paced
+# session still lets the player read every completed trick).
+MIN_TRICK_DWELL: float = 0.5
+
+
 def create_ai_players(diffs_map: dict[Seat, str]) -> dict[Seat, AIPlayer]:
     """Create AI players for seats not occupied by humans."""
     ai_seats = {Seat.EAST, Seat.NORTH, Seat.WEST}
@@ -177,6 +183,10 @@ def run_play(
         # 3. If this completes a trick, pause longer and show announcements
         if len(display_state.current_trick) == 4:
             play_sound("trick")
+            # Non-skippable minimum dwell so all four cards are always visible
+            # before the trick clears, even when the user has skipped earlier
+            # animations or is on the "instant" speed preset.
+            interruptible_sleep(MIN_TRICK_DWELL, None)
             if len(current.completed_tricks) == 7:  # This was the 8th trick
                 se_trump = current.boss_modifiers.seven_eight_trump
                 is_sa = current.contract == "sans_atout"

{belote_cli-2.9.0 → belote_cli-2.9.5}/src/belote/input.py

@@ -143,14 +143,16 @@ class _UnixKeyReader:
             ch = chr(byte)
             if ch.lower() == "q":
                 return KeyEvent(Key.QUIT)
-            if ch.lower() == "h":
+            if ch == "?":
                 return KeyEvent(Key.HELP)
-            if ch.lower() == "s":
+            if ch.lower() == "h":
+                return KeyEvent(Key.HIST)
+            if ch.lower() == "t":
+                return KeyEvent(Key.THEME)
+            if ch.lower() == "o":
                 return KeyEvent(Key.SORT)
             if ch.lower() == "m":
                 return KeyEvent(Key.MUTE)
-            if ch.lower() == "t":
-                return KeyEvent(Key.HIST)
             if ch.lower() == "i" or ch.lower() == "v":
                 return KeyEvent(Key.OVERLAY)
 
@@ -262,14 +264,16 @@ if os.name == "nt":
                 return KeyEvent(Key.SPACE)
             if ch.lower() == b"q":
                 return KeyEvent(Key.QUIT)
-            if ch.lower() == b"h":
+            if ch == b"?":
                 return KeyEvent(Key.HELP)
-            if ch.lower() == b"s":
+            if ch.lower() == b"h":
+                return KeyEvent(Key.HIST)
+            if ch.lower() == b"t":
+                return KeyEvent(Key.THEME)
+            if ch.lower() == b"o":
                 return KeyEvent(Key.SORT)
             if ch.lower() == b"m":
                 return KeyEvent(Key.MUTE)
-            if ch.lower() == b"t":
-                return KeyEvent(Key.HIST)
             if ch.lower() in (b"i", b"v"):
                 return KeyEvent(Key.OVERLAY)
 

{belote_cli-2.9.0 → belote_cli-2.9.5}/src/belote/main.py

@@ -240,7 +240,7 @@ def main() -> None:
                     # Wait for Enter/R/Q/T
                     sys.stdout.write(f"\n  {BOLD}{gold_fg()}GAME OVER{RESET}")
                     sys.stdout.write(
-                        f"\n  {white_fg()}[Enter/Q] Menu  [R] Rematch  [T] History{RESET} "
+                        f"\n  {white_fg()}[Enter/Q] Menu  [R] Rematch  [H] History{RESET} "
                     )
                     sys.stdout.flush()
 
@@ -254,7 +254,7 @@ def main() -> None:
                             show_final_screen(state)
                             sys.stdout.write(f"\n  {BOLD}{gold_fg()}GAME OVER{RESET}")
                             sys.stdout.write(
-                                f"\n  {white_fg()}[Enter/Q] Menu  [R] Rematch  [t] History{RESET} "
+                                f"\n  {white_fg()}[Enter/Q] Menu  [R] Rematch  [H] History{RESET} "
                             )
                             sys.stdout.flush()
                         if ev.key in (Key.ENTER, Key.QUIT):

{belote_cli-2.9.0 → belote_cli-2.9.5}/src/belote/scoring.py

@@ -719,6 +719,20 @@ def score_round(state: GameState) -> ScoringBreakdown:
     )
 
 
+def _decl_short_label(d: Declaration) -> str:
+    if d.kind == "belote":
+        return "Belote"
+    if d.kind == "rebelote":
+        return "Rebelote"
+    if d.kind == "carre" and isinstance(d.detail, Carre):
+        rank = _VALUE_TO_RANK.get(d.detail.rank)
+        return f"Carré-{rank.value}" if rank else "Carré"
+    if d.kind == "sequence" and isinstance(d.detail, Sequence):
+        pts = _SEQUENCE_POINTS.get(d.detail.length, 0)
+        return f"{pts}{d.detail.suit.symbol}"
+    return d.kind
+
+
 def apply_round_score(state: GameState, breakdown: ScoringBreakdown) -> GameState:
     """Apply round scoring result to team scores and advance state."""
     ns, ew = state.team_scores
@@ -731,6 +745,46 @@ def apply_round_score(state: GameState, breakdown: ScoringBreakdown) -> GameStat
 
     new_scores = (ns, ew)
 
+    # Trick counts per team across the played round.
+    se_trump = state.boss_modifiers.seven_eight_trump
+    is_sa = state.contract == "sans_atout"
+    tricks_ns = 0
+    tricks_ew = 0
+    for trick in state.completed_tricks:
+        winner = trick_winner_seat(trick, state.trump, se_trump, is_sa)
+        if winner is None:
+            continue
+        if team_of(winner) == 0:
+            tricks_ns += 1
+        else:
+            tricks_ew += 1
+
+    # Declaration summaries — only show the team(s) that actually scored decls,
+    # which matches Belote's "best team takes all decls" rule.
+    ns_decl_total = breakdown.taker_declarations if breakdown.taker_team == 0 else breakdown.defender_declarations
+    ew_decl_total = breakdown.defender_declarations if breakdown.taker_team == 0 else breakdown.taker_declarations
+    ns_decls = tuple(
+        _decl_short_label(d) for d in state.declarations if team_of(d.seat) == 0
+    ) if ns_decl_total > 0 else ()
+    ew_decls = tuple(
+        _decl_short_label(d) for d in state.declarations if team_of(d.seat) == 1
+    ) if ew_decl_total > 0 else ()
+
+    common_kwargs = dict(
+        is_failed=breakdown.is_failed,
+        is_capot=breakdown.is_capot,
+        is_litige=breakdown.is_litige,
+        litige_points=breakdown.litige_points_awarded,
+        contract=state.contract,
+        trump=state.trump,
+        taker_seat=state.taker,
+        tricks_ns=tricks_ns,
+        tricks_ew=tricks_ew,
+        last_trick_winner=state.last_trick_winner,
+        decl_summary_ns=ns_decls,
+        decl_summary_ew=ew_decls,
+    )
+
     # Create RoundScore for history
     if breakdown.taker_team == 0:
         round_score = RoundScore(
@@ -745,10 +799,7 @@ def apply_round_score(state: GameState, breakdown: ScoringBreakdown) -> GameStat
             ew_rebelote=breakdown.defender_rebelote,
             ns_total=breakdown.taker_total,
             ew_total=breakdown.defender_total,
-            is_failed=breakdown.is_failed,
-            is_capot=breakdown.is_capot,
-            is_litige=breakdown.is_litige,
-            litige_points=breakdown.litige_points_awarded,
+            **common_kwargs,
         )
     else:
         round_score = RoundScore(
@@ -763,10 +814,7 @@ def apply_round_score(state: GameState, breakdown: ScoringBreakdown) -> GameStat
             ew_rebelote=breakdown.taker_rebelote,
             ns_total=breakdown.defender_total,
             ew_total=breakdown.taker_total,
-            is_failed=breakdown.is_failed,
-            is_capot=breakdown.is_capot,
-            is_litige=breakdown.is_litige,
-            litige_points=breakdown.litige_points_awarded,
+            **common_kwargs,
         )
 
     new_history = state.score_history + (round_score,)

{belote_cli-2.9.0 → belote_cli-2.9.5}/src/belote/ui/announce.py

@@ -12,9 +12,11 @@ from ..ansi import (
     ansi_center,
     banner_bg,
     banner_fg,
+    clear_line,
     clear_screen,
     gold_fg,
     hide_cursor,
+    move,
     white_fg,
 )
 from ..context import AUDIO
@@ -33,8 +35,19 @@ def toggle_mute() -> bool:
 
 
 def announce(message: str, duration: float = 2.0, reader: KeyReader | None = None) -> None:
-    """Display a transient announcement banner."""
-    sys.stdout.write(f"\r\n{banner_bg()}{banner_fg()}  {BOLD} {message} {RESET}\r\n")
+    """Display a transient announcement banner.
+
+    Painted with absolute cursor positioning + clear_line so it never triggers
+    a scroll, even when the cursor is parked on the bottom row of the alt
+    screen. Writing \\r\\n at the bottom row scrolls the alt-screen on Konsole
+    and other strict emulators, which leaks the previous frame onto rows the
+    next render's blank padding doesn't repaint.
+    """
+    term_w, term_h = get_term_size()
+    banner = ansi_center(
+        f"{banner_bg()}{banner_fg()}  {BOLD} {message} {RESET}", term_w
+    )
+    sys.stdout.write(move(max(1, term_h - 1), 1) + clear_line() + banner)
     sys.stdout.flush()
     if reader and duration > 0:
         interruptible_sleep(duration, reader)