Nice Work

box2/player/base_player.py

@@ -0,0 +1,19 @@
+"""Base player interface for audio playback."""
+
+from __future__ import annotations
+
+from typing import Protocol
+
+
+class BasePlayer(Protocol):
+    def play(self, media_ref: str) -> None:
+        raise NotImplementedError
+
+    def pause(self) -> None:
+        raise NotImplementedError
+
+    def stop(self) -> None:
+        raise NotImplementedError
+
+    def set_volume(self, volume: int) -> None:
+        raise NotImplementedError

box2/player/mock_player.py

@@ -0,0 +1,23 @@
+"""Mock player for Phase 1a (no real audio)."""
+
+from __future__ import annotations
+
+from player.base_player import BasePlayer
+
+
+class MockPlayer(BasePlayer):
+    def __init__(self) -> None:
+        self._current: str | None = None
+        self._volume: int = 0
+
+    def play(self, media_ref: str) -> None:
+        self._current = media_ref
+
+    def pause(self) -> None:
+        return None
+
+    def stop(self) -> None:
+        self._current = None
+
+    def set_volume(self, volume: int) -> None:
+        self._volume = volume