feat(player): 7-way content-dial resolution (design §6)

tests/test_player_content.py

@@ -0,0 +1,34 @@
+import pytest
+
+from player.content import AUDIO_SOURCES, ContentResolution, resolve_content
+
+
+def test_audio_sources_are_the_four_distinct_sources():
+    assert AUDIO_SOURCES == frozenset({"none", "white_noise", "music", "audio_track"})
+
+
+# The §6 table, row by row: position -> (audio_source, video).
+@pytest.mark.parametrize(
+    "position,audio_source,video",
+    [
+        ("off", "none", False),
+        ("white_noise", "white_noise", False),
+        ("music", "music", False),
+        ("audio_track", "audio_track", False),
+        ("video", "none", True),
+        ("music_video", "music", True),
+        ("audio_video", "audio_track", True),
+    ],
+)
+def test_resolve_content_matches_spec_table(position, audio_source, video):
+    assert resolve_content(position) == ContentResolution(audio_source=audio_source, video=video)
+
+
+def test_off_is_void_state_black_and_silent():
+    r = resolve_content("off")
+    assert r.video is False and r.audio_source == "none"
+
+
+def test_resolve_content_rejects_unknown_position():
+    with pytest.raises(ValueError):
+        resolve_content("bogus")