Window_controller (controller.window_controller)¶

class WindowController:
    """Oversees GUI application window lifecycle, dialog alerts, and timer ticking."""

    def __init__(
        self,
        game_controller: Optional[GameController] = None,
        title: str = "ChessWithQuests",
        dimensions: Tuple[int, int] = (800, 600),
    ):
        """Initialize a WindowController instance.

        Args:
            game_controller: Optional GameController instance.
            title: Window title string (default: "ChessWithQuests").
            dimensions: (width, height) pixel tuple (default: (800, 600)).
        """
        self.game_controller: GameController = game_controller or GameController()
        self.title: str = title
        self.width, self.height = dimensions
        self.is_running: bool = False
        self.status_message: str = "Welcome to ChessWithQuests"
        self.active_dialog: Optional[str] = None

    def start(self) -> None:
        """Start the window loop and set running state."""
        self.is_running = True
        self.status_message = "Game Started"

    def stop(self) -> None:
        """Stop the window loop and reset running state."""
        self.is_running = False
        self.status_message = "Game Stopped"

    def set_status(self, message: str) -> None:
        """Update window footer status message.

        Args:
            message: Text message to display.
        """
        self.status_message = message

    def show_dialog(self, message: str) -> None:
        """Trigger an active popup dialog with a message.

        Args:
            message: Dialog body text.
        """
        self.active_dialog = message

    def close_dialog(self) -> None:
        """Dismiss active popup dialog."""
        self.active_dialog = None

    def on_square_clicked(self, position: Tuple[int, int]) -> Dict[str, Any]:
        """Dispatch square click to GameController and update UI status text.

        Args:
            position: (row, col) coordinates clicked.

        Returns:
            Dictionary result from GameController.
        """
        result = self.game_controller.handle_square_click(position)
        if result["action"] == "moved":
            self.set_status(f"Move played to {position}")
        elif result["action"] == "selected":
            self.set_status(f"Square selected at {position}")
        elif result["action"] == "invalid":
            self.set_status("Invalid move!")
        return result

    def tick_timer(self) -> None:
        """Advance timer tick by one second for active player and update status if expired."""
        active_color = self.game_controller.game_manager.active_player
        self.game_controller.game_manager.timer.tick(active_color, 1)
        if self.game_controller.game_manager.timer.is_expired(active_color):
            self.set_status("Time Expired!")