add pause key binding to TUI

Author: Nejc Stebe

plain2code_events.py

@@ -61,3 +61,10 @@ class RenderModuleCompleted(BaseEvent):
 @dataclass
 class RenderModuleStarted(BaseEvent):
     module_name: str
+
+
+@dataclass
+class PauseRequested(BaseEvent):
+    """Event emitted when the user requests to pause rendering."""
+
+    pass

tui/components.py

@@ -13,7 +13,7 @@
 class CustomFooter(Horizontal):
     """A custom footer with keyboard shortcuts and render ID."""
 
-    FOOTER_TEXT = "ctrl+c: copy  *  ctrl+d: quit  *  ctrl+l: toggle logs"
+    FOOTER_TEXT = "ctrl+c: copy  *  ctrl+d: quit  *  ctrl+l: toggle logs  *  ctrl+shift+p: pause"
     RENDER_FINISHED_TEXT = "enter: exit  *  ctrl+c: copy  *  ctrl+l: toggle logs"
 
     def __init__(self, render_id: str = "", **kwargs):

tui/plain2code_tui.py

@@ -9,6 +9,7 @@
 from event_bus import EventBus
 from plain2code_events import (
     LogMessageEmitted,
+    PauseRequested,
     RenderCompleted,
     RenderContextSnapshot,
     RenderFailed,
@@ -51,6 +52,7 @@ class Plain2CodeTUI(App):
         Binding("ctrl+c", "copy_selection", "Copy", show=False),
         Binding("ctrl+d", "quit", "Quit", show=False),
         Binding("enter", "enter_exit", "Exit", show=False),
+        Binding("ctrl+shift+p", "pause", "Pause", show=False),
         ("ctrl+l", "toggle_logs", "Toggle Logs"),
     ]
 
@@ -270,6 +272,11 @@ async def action_copy_selection(self) -> None:
             self.screen.clear_selection()
             self.notify("Copied to clipboard", timeout=2)
 
+    def action_pause(self) -> None:
+        """Handle ctrl+shift+p: request the render machine to pause."""
+        if not self._render_finished:
+            self.event_bus.publish(PauseRequested())
+
     def action_enter_exit(self) -> None:
         """Handle enter: exit the TUI only after rendering has finished."""
         if self._render_finished: