feat(ui): draw pane frames, page keys and a scroll thumb

beefy_player/widgets/spectrum.py

@@ -7,11 +7,12 @@ from collections import deque
 from collections.abc import Sequence
 from typing import TYPE_CHECKING, cast
 
-from rich.console import Group, RenderableType
+from rich.console import RenderableType
 from rich.text import Text
 from textual.widget import Widget
 
 from ..spectrum import Frame, SpectrumEngine
+from . import frame
 from .common import LEVELS, SPECTRUM_STOPS, gradient
 
 if TYPE_CHECKING:
@@ -63,38 +64,40 @@ class SpectrumPanel(Widget):
 
     def render(self) -> RenderableType:
         app = cast("BeefyPlayerApp", self.app)
-        frame = self.engine.snapshot()
-        width = max(8, self.size.width)
-        height = max(2, self.size.height)
+        snapshot = self.engine.snapshot()
+        outer_width, outer_height = max(12, self.size.width), max(4, self.size.height)
+        width, height = frame.inner_size(outer_width, outer_height)
         mode = getattr(app, "visualizer", "both")
         phase = int(getattr(app, "tick_count", 0) // 2)
-        dim = frame.status == "idle"
-        self._record(frame, int(getattr(app, "tick_count", 0)))
+        dim = snapshot.status == "idle"
+        self._record(snapshot, int(getattr(app, "tick_count", 0)))
 
         lines: list[Text]
         if mode == "wave":
-            lines = self._wave(frame, width, height, phase, dim)
+            lines = self._wave(snapshot, width, height, phase, dim)
         elif mode == "braille":
-            lines = self._braille(frame, width, height, phase, dim)
+            lines = self._braille(snapshot, width, height, phase, dim)
         elif mode == "waterfall":
             lines = self._waterfall(width, height, dim)
         elif mode == "radial":
-            lines = self._radial(frame, width, height, phase, dim)
+            lines = self._radial(snapshot, width, height, phase, dim)
         elif mode == "bars" or height < 8:
-            lines = self._bars(frame, width, height, phase, dim)
+            lines = self._bars(snapshot, width, height, phase, dim)
         else:
             # Default mode: a full-height mirrored spectrum.  The top half
             # grows up from the centre line, the bottom half grows down from
             # it (same values, flipped rows, dimmed like a reflection).
             top_height = height // 2
             bottom_height = height - top_height
-            lines = self._bars(frame, width, top_height, phase, dim)
+            lines = self._bars(snapshot, width, top_height, phase, dim)
             mirrored = self._bars(
-                frame, width, bottom_height, phase + 5, True, peaks=False
+                snapshot, width, bottom_height, phase + 5, True, peaks=False
             )
             mirrored.reverse()
             lines.extend(mirrored)
-        return Group(*lines)
+        return frame.wrap(
+            lines, outer_width, outer_height, self.border_title
+        )
 
     # ------------------------------------------------------------------ #
     # history