misc: replace Any with precise types

Curses screens, windows and pads are typed as curses.window, and the
widgets that may get no parent window take curses.window | None.

- EventHandler is generic over a ParamSpec, so each handler declares
  the arguments it passes, and MenuView is generic over the item its
  on_confirm hands out. Choice callbacks take no arguments.
- Scrollable is generic over its items, which DataTable and ListBox
  fix to tuple[str, str] and str.
- random.choice() and choice_low() are generic over the sequence, so
  the casts at their call sites are gone. BasicUserInterface.menu()
  and util.first() are generic too.
- Signal callbacks and their payloads are Callable[..., object] and
  object, since emit() only forwards them.
- JSON values in game_data are object and narrowed by isinstance,
  and data files are Traversable.
- Signal handlers take an int and a FrameType | None, and
  list_players() takes a TextIO.
- The focus_standout() context managers return
  Generator[None, None, None].

Any remains in three places: Player.__setstate__, whose pickled
__dict__ holds values of every type; Focusable.__init__, a mixin that
passes *args and **kwargs through to the next class; and the values
load_game_data() collects, whose element type depends on the field
each one fills.

pqcli/ui/curses/views/base_view.py

@@ -1,8 +1,8 @@
-from typing import Any
+import curses
 
 
 class BaseView:
-    def __init__(self, screen: Any) -> None:
+    def __init__(self, screen: curses.window) -> None:
         self.screen = screen
 
     def start(self) -> None:

pqcli/ui/curses/views/choose_character_view.py

@@ -1,14 +1,17 @@
+import curses
 import functools
-from typing import Any
 
 from pqcli.lingo import act_name, to_roman
+from pqcli.mechanic import Player
 from pqcli.roster import Roster
 from pqcli.ui.curses.util import KEYS_CANCEL, Choice
 from pqcli.ui.curses.views.menu_view import MenuView
 
 
-class ChooseCharacterView(MenuView):
-    def __init__(self, screen: Any, roster: Roster, title: str) -> None:
+class ChooseCharacterView(MenuView[Player]):
+    def __init__(
+        self, screen: curses.window, roster: Roster, title: str
+    ) -> None:
         super().__init__(screen, title)
 
         for y, player in enumerate(roster.players, 1):

pqcli/ui/curses/views/confirm_view.py

@@ -1,4 +1,4 @@
-from typing import Any
+import curses
 
 from pqcli.ui.curses.event_handler import EventHandler
 from pqcli.ui.curses.util import Choice
@@ -8,12 +8,12 @@ from .base_view import BaseView
 
 
 class ConfirmView(BaseView):
-    def __init__(self, screen: Any, title: str) -> None:
+    def __init__(self, screen: curses.window, title: str) -> None:
         super().__init__(screen)
 
         self.title = f"{title}:"
-        self.on_cancel = EventHandler()
-        self.on_confirm = EventHandler()
+        self.on_cancel = EventHandler[[]]()
+        self.on_confirm = EventHandler[[]]()
 
         self.choices: list[Choice] = [
             Choice(

pqcli/ui/curses/views/create_character_view/choose_character_class_view.py

@@ -1,16 +1,16 @@
+import curses
 import functools
 from collections.abc import Sequence
-from typing import Any
 
 from pqcli.config import Class
 from pqcli.ui.curses.util import KEYS_CANCEL, Choice
 from pqcli.ui.curses.views.menu_view import MenuView
 
 
-class ChooseCharacterClassView(MenuView):
+class ChooseCharacterClassView(MenuView[Class]):
     def __init__(
         self,
-        screen: Any,
+        screen: curses.window,
         classes: Sequence[Class],
         class_: Class | None = None,
     ) -> None:

pqcli/ui/curses/views/create_character_view/choose_character_name_view.py

@@ -1,6 +1,5 @@
 import curses
 import curses.ascii
-from typing import Any
 
 from pqcli.mechanic import generate_name
 from pqcli.ui.curses.event_handler import EventHandler
@@ -10,15 +9,17 @@ from pqcli.ui.curses.widgets.focusable import focus_standout
 
 
 class ChooseCharacterNameView(BaseView):
-    def __init__(self, screen: Any, character_name: str | None = None) -> None:
+    def __init__(
+        self, screen: curses.window, character_name: str | None = None
+    ) -> None:
         super().__init__(screen)
 
-        self.on_cancel = EventHandler()
-        self.on_confirm = EventHandler()
+        self.on_cancel = EventHandler[[]]()
+        self.on_confirm = EventHandler[[str]]()
 
         self._active_widget = 0
-        self._win: Any | None = None
-        self._text_win: Any | None = None
+        self._win: curses.window | None = None
+        self._text_win: curses.window | None = None
         self._text = character_name or generate_name()
 
     def start(self) -> None:

pqcli/ui/curses/views/create_character_view/choose_character_race_view.py

@@ -1,16 +1,16 @@
+import curses
 import functools
 from collections.abc import Sequence
-from typing import Any
 
 from pqcli.config import Race
 from pqcli.ui.curses.util import KEYS_CANCEL, Choice
 from pqcli.ui.curses.views.menu_view import MenuView
 
 
-class ChooseCharacterRaceView(MenuView):
+class ChooseCharacterRaceView(MenuView[Race]):
     def __init__(
         self,
-        screen: Any,
+        screen: curses.window,
         races: Sequence[Race],
         race: Race | None = None,
     ) -> None:

pqcli/ui/curses/views/create_character_view/choose_character_stats_view.py

@@ -1,8 +1,9 @@
+import curses
 import curses.ascii
-from typing import Any
 
 from pqcli.config import PRIME_STATS
-from pqcli.mechanic import StatsBuilder
+from pqcli.mechanic import Stats, StatsBuilder
+from pqcli.random import RngState
 from pqcli.ui.curses.event_handler import EventHandler
 from pqcli.ui.curses.util import KEYS_CANCEL, KEYS_CYCLE, KEYS_DOWN, KEYS_UP
 from pqcli.ui.curses.views.base_view import BaseView
@@ -10,15 +11,15 @@ from pqcli.ui.curses.widgets.focusable import focus_standout
 
 
 class ChooseCharacterStatsView(BaseView):
-    def __init__(self, screen: Any) -> None:
+    def __init__(self, screen: curses.window) -> None:
         super().__init__(screen)
 
-        self.on_cancel = EventHandler()
-        self.on_confirm = EventHandler()
+        self.on_cancel = EventHandler[[]]()
+        self.on_confirm = EventHandler[[Stats, RngState]]()
 
         self._active_widget = 0
-        self._win: Any | None = None
-        self._stats_win: Any | None = None
+        self._win: curses.window | None = None
+        self._stats_win: curses.window | None = None
 
         self._stats_builder = StatsBuilder()
         self._stats = self._stats_builder.roll()

pqcli/ui/curses/views/game_view/__init__.py

@@ -2,7 +2,7 @@ import argparse
 import curses
 import curses.ascii
 import datetime
-from typing import Any, Protocol, runtime_checkable
+from typing import Protocol, runtime_checkable
 
 from pqcli.game_data import GameData
 from pqcli.mechanic import Player, SignalMixin, Simulation
@@ -44,14 +44,14 @@ class PageScrollable(Protocol):
 class GameView(BaseView):
     def __init__(
         self,
-        screen: Any,
+        screen: curses.window,
         roster: Roster,
         player: Player,
         args: argparse.Namespace,
         data: GameData,
     ) -> None:
         super().__init__(screen)
-        self.on_exit = EventHandler()
+        self.on_exit = EventHandler[[]]()
 
         self._roster = roster
         self._player = player

pqcli/ui/curses/views/game_view/character_sheet_window.py

@@ -1,4 +1,4 @@
-from typing import Any
+import curses
 
 from pqcli.mechanic import Player, StatType
 
@@ -7,7 +7,13 @@ from .progress_bar_window import DataTableProgressBarWindow
 
 class CharacterSheetWindow(DataTableProgressBarWindow):
     def __init__(
-        self, player: Player, parent: Any, h: int, w: int, y: int, x: int
+        self,
+        player: Player,
+        parent: curses.window,
+        h: int,
+        w: int,
+        y: int,
+        x: int,
     ) -> None:
         super().__init__(
             parent,

pqcli/ui/curses/views/game_view/equipment_window.py

@@ -1,4 +1,4 @@
-from typing import Any
+import curses
 
 from pqcli.mechanic import EquipmentType, Player
 from pqcli.ui.curses.widgets import DataTable, Focusable, WindowWrapper
@@ -6,7 +6,13 @@ from pqcli.ui.curses.widgets import DataTable, Focusable, WindowWrapper
 
 class EquipmentWindow(Focusable, WindowWrapper):
     def __init__(
-        self, player: Player, parent: Any, h: int, w: int, y: int, x: int
+        self,
+        player: Player,
+        parent: curses.window,
+        h: int,
+        w: int,
+        y: int,
+        x: int,
     ) -> None:
         super().__init__(parent, h, w, y, x)
         self._on_focus_change += self._render

pqcli/ui/curses/views/game_view/inventory_window.py

@@ -1,4 +1,4 @@
-from typing import Any
+import curses
 
 from pqcli.mechanic import InventoryItem, Player
 
@@ -7,7 +7,13 @@ from .progress_bar_window import DataTableProgressBarWindow
 
 class InventoryWindow(DataTableProgressBarWindow):
     def __init__(
-        self, player: Player, parent: Any, h: int, w: int, y: int, x: int
+        self,
+        player: Player,
+        parent: curses.window,
+        h: int,
+        w: int,
+        y: int,
+        x: int,
     ) -> None:
         super().__init__(
             parent,

pqcli/ui/curses/views/game_view/plot_window.py

@@ -1,4 +1,4 @@
-from typing import Any
+import curses
 
 from pqcli.lingo import act_name
 from pqcli.mechanic import Player
@@ -10,7 +10,13 @@ class PlotWindow(ListBoxProgressBarWindow):
     cutoff = 100
 
     def __init__(
-        self, player: Player, parent: Any, h: int, w: int, y: int, x: int
+        self,
+        player: Player,
+        parent: curses.window,
+        h: int,
+        w: int,
+        y: int,
+        x: int,
     ) -> None:
         super().__init__(
             parent, h, w, y, x, " Plot Development ", show_time=True

pqcli/ui/curses/views/game_view/progress_bar_window.py

@@ -1,5 +1,4 @@
 import curses
-from typing import Any
 
 from pqcli.ui.curses.widgets import (
     DataTable,
@@ -13,7 +12,7 @@ from pqcli.ui.curses.widgets import (
 class ProgressBarWindow(Focusable, WindowWrapper):
     def __init__(
         self,
-        parent: Any,
+        parent: curses.window,
         h: int,
         w: int,
         y: int,
@@ -82,7 +81,7 @@ class ProgressBarWindow(Focusable, WindowWrapper):
 class DataTableProgressBarWindow(ProgressBarWindow):
     def __init__(
         self,
-        parent: Any,
+        parent: curses.window,
         h: int,
         w: int,
         y: int,
@@ -123,7 +122,7 @@ class DataTableProgressBarWindow(ProgressBarWindow):
 class ListBoxProgressBarWindow(ProgressBarWindow):
     def __init__(
         self,
-        parent: Any,
+        parent: curses.window,
         h: int,
         w: int,
         y: int,

pqcli/ui/curses/views/game_view/quest_book_window.py

@@ -1,4 +1,4 @@
-from typing import Any
+import curses
 
 from pqcli.mechanic import Player
 
@@ -9,7 +9,13 @@ class QuestBookWindow(ListBoxProgressBarWindow):
     cutoff = 100
 
     def __init__(
-        self, player: Player, parent: Any, h: int, w: int, y: int, x: int
+        self,
+        player: Player,
+        parent: curses.window,
+        h: int,
+        w: int,
+        y: int,
+        x: int,
     ) -> None:
         super().__init__(parent, h, w, y, x, " Quests ", show_time=True)
         self._on_focus_change += self._render

pqcli/ui/curses/views/game_view/spell_book_window.py

@@ -1,4 +1,4 @@
-from typing import Any
+import curses
 
 from pqcli.lingo import to_roman
 from pqcli.mechanic import Player, Spell
@@ -7,7 +7,13 @@ from pqcli.ui.curses.widgets import DataTable, Focusable, WindowWrapper
 
 class SpellBookWindow(Focusable, WindowWrapper):
     def __init__(
-        self, player: Player, parent: Any, h: int, w: int, y: int, x: int
+        self,
+        player: Player,
+        parent: curses.window,
+        h: int,
+        w: int,
+        y: int,
+        x: int,
     ) -> None:
         super().__init__(parent, h, w, y, x)
         self._on_focus_change += self._render

pqcli/ui/curses/views/game_view/task_progress_window.py

@@ -1,4 +1,4 @@
-from typing import Any
+import curses
 
 from pqcli.mechanic import Player
 from pqcli.ui.curses.widgets import (
@@ -11,7 +11,13 @@ from pqcli.ui.curses.widgets import (
 
 class TaskProgressWindow(Focusable, WindowWrapper):
     def __init__(
-        self, player: Player, parent: Any, h: int, w: int, y: int, x: int
+        self,
+        player: Player,
+        parent: curses.window,
+        h: int,
+        w: int,
+        y: int,
+        x: int,
     ) -> None:
         super().__init__(parent, h, w, y, x)
 

pqcli/ui/curses/views/menu_view.py

@@ -1,19 +1,22 @@
-from typing import Any
+import curses
+from typing import Generic, TypeVar
 
 from pqcli.ui.curses.event_handler import EventHandler
 from pqcli.ui.curses.util import Choice
 from pqcli.ui.curses.views.base_view import BaseView
 from pqcli.ui.curses.widgets import Menu
 
+ItemT = TypeVar("ItemT")
 
-class MenuView(BaseView):
+
+class MenuView(BaseView, Generic[ItemT]):
     def __init__(
-        self, screen: Any, title: str, active_choice: int = 0
+        self, screen: curses.window, title: str, active_choice: int = 0
     ) -> None:
         super().__init__(screen)
 
-        self.on_cancel = EventHandler()
-        self.on_confirm = EventHandler()
+        self.on_cancel = EventHandler[[]]()
+        self.on_confirm = EventHandler[[ItemT]]()
 
         self._title = f"{title}:"
         self._choices: list[Choice] = []

pqcli/ui/curses/views/roster_view.py

@@ -1,5 +1,4 @@
 import curses
-from typing import Any
 
 from pqcli.ui.curses.colors import COLOR_LOGO, COLOR_LOGO_ALT, has_colors
 from pqcli.ui.curses.event_handler import EventHandler
@@ -52,13 +51,13 @@ class MainMenu(Menu):
 
 
 class RosterView(BaseView):
-    def __init__(self, screen: Any) -> None:
+    def __init__(self, screen: curses.window) -> None:
         super().__init__(screen)
 
-        self.on_create = EventHandler()
-        self.on_play = EventHandler()
-        self.on_delete = EventHandler()
-        self.on_quit = EventHandler()
+        self.on_create = EventHandler[[]]()
+        self.on_play = EventHandler[[]]()
+        self.on_delete = EventHandler[[]]()
+        self.on_quit = EventHandler[[]]()
 
         self.choices: list[Choice] = [
             Choice(