Nice Work

box2/audio/base.py

@@ -0,0 +1,16 @@
+"""Audio backend interface (placeholder)."""
+
+from __future__ import annotations
+
+from typing import Protocol
+
+
+class AudioBackend(Protocol):
+    def play(self, media_ref: str) -> None:
+        raise NotImplementedError
+
+    def pause(self) -> None:
+        raise NotImplementedError
+
+    def stop(self) -> None:
+        raise NotImplementedError

box2/audio/mock.py

@@ -0,0 +1,19 @@
+"""Mock audio backend (no real playback)."""
+
+from __future__ import annotations
+
+from audio.base import AudioBackend
+
+
+class MockAudioBackend(AudioBackend):
+    def __init__(self) -> None:
+        self._current: str | None = None
+
+    def play(self, media_ref: str) -> None:
+        self._current = media_ref
+
+    def pause(self) -> None:
+        return None
+
+    def stop(self) -> None:
+        self._current = None