wrkmon 1.0.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

wrkmon/data/migrations.py

@@ -64,6 +64,32 @@ MIGRATIONS: list[tuple[int, str, str]] = [
         );
         """,
     ),
+    (
+        2,
+        "Add queue persistence",
+        """
+        -- Queue table for persistent queue
+        CREATE TABLE IF NOT EXISTS queue (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            track_id INTEGER NOT NULL,
+            position INTEGER NOT NULL,
+            playback_position INTEGER DEFAULT 0,
+            added_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (track_id) REFERENCES tracks(id) ON DELETE CASCADE
+        );
+        CREATE INDEX IF NOT EXISTS idx_queue_position ON queue(position);
+
+        -- Queue state table (single row for current state)
+        CREATE TABLE IF NOT EXISTS queue_state (
+            id INTEGER PRIMARY KEY CHECK (id = 1),
+            current_index INTEGER DEFAULT -1,
+            shuffle_mode INTEGER DEFAULT 0,
+            repeat_mode TEXT DEFAULT 'none',
+            updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+        );
+        INSERT OR IGNORE INTO queue_state (id) VALUES (1);
+        """,
+    ),
 ]
 
 

wrkmon/ui/screens/help.py

@@ -0,0 +1,80 @@
+"""Help overlay screen for wrkmon."""
+
+from textual.app import ComposeResult
+from textual.containers import Container, Vertical, VerticalScroll
+from textual.screen import ModalScreen
+from textual.widgets import Static
+from textual.binding import Binding
+
+
+HELP_TEXT = """
+[bold cyan]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/]
+[bold cyan]                    WRKMON KEYBOARD SHORTCUTS[/]
+[bold cyan]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/]
+
+[bold orange1]NAVIGATION[/]
+  [bold purple]F1[/]          Switch to Search view
+  [bold purple]F2[/]          Switch to Queue view
+  [bold purple]F3[/]          Switch to History view
+  [bold purple]F4[/]          Switch to Playlists view
+  [bold purple]j / ↓[/]       Move down in list
+  [bold purple]k / ↑[/]       Move up in list
+  [bold purple]g / Home[/]    Jump to top of list
+  [bold purple]G / End[/]     Jump to bottom of list
+  [bold purple]Tab[/]         Next focusable element
+  [bold purple]Shift+Tab[/]   Previous focusable element
+
+[bold orange1]PLAYBACK[/]
+  [bold purple]F5 / Space[/]  Play / Pause
+  [bold purple]F6 / -[/]      Volume down
+  [bold purple]F7 / + =[/]    Volume up
+  [bold purple]F8 / n[/]      Next track
+  [bold purple]p[/]           Previous track
+  [bold purple]F9 / s[/]      Stop playback
+  [bold purple]r[/]           Cycle repeat mode (Off → One → All)
+  [bold purple]m[/]           Mute / Unmute
+
+[bold orange1]SEARCH & QUEUE[/]
+  [bold purple]/[/]           Focus search input
+  [bold purple]Enter[/]       Play selected track
+  [bold purple]a[/]           Add selected to queue
+  [bold purple]F10[/]         Add highlighted to queue
+  [bold purple]d / Del[/]     Remove from queue
+  [bold purple]c[/]           Clear queue
+
+[bold orange1]VIEW OPTIONS[/]
+  [bold purple]t[/]           Toggle thumbnail preview
+  [bold purple]?[/]           Show this help
+  [bold purple]Escape[/]      Close overlay / Go back
+
+[bold orange1]APPLICATION[/]
+  [bold purple]Ctrl+Q[/]      Quit application
+  [bold purple]Ctrl+C[/]      Quit application
+
+[bold cyan]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/]
+[dim]Press [bold]Escape[/bold] or [bold]?[/bold] to close this help[/]
+"""
+
+
+class HelpScreen(ModalScreen):
+    """Modal help screen showing keyboard shortcuts."""
+
+    BINDINGS = [
+        Binding("escape", "close", "Close", show=False),
+        Binding("?", "close", "Close", show=False),
+        Binding("q", "close", "Close", show=False),
+    ]
+
+    def compose(self) -> ComposeResult:
+        with Container(id="help-container"):
+            yield Static("[bold cyan]⌨  KEYBOARD SHORTCUTS[/]", id="help-title")
+            with VerticalScroll(id="help-scroll"):
+                yield Static(HELP_TEXT, id="help-content", markup=True)
+
+    def action_close(self) -> None:
+        """Close the help screen."""
+        self.dismiss()
+
+    def on_click(self) -> None:
+        """Close on click outside."""
+        self.dismiss()