prezo 0.3.1__py3-none-any.whl

prezo/screens/help.py

@@ -0,0 +1,140 @@
+"""Help screen for Prezo."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, ClassVar
+
+from textual.binding import Binding, BindingType
+from textual.containers import VerticalScroll
+from textual.widgets import Markdown, Static
+
+from .base import ThemedModalScreen
+
+if TYPE_CHECKING:
+    from textual.app import ComposeResult
+
+HELP_CONTENT = """\
+# Prezo Help
+
+## Navigation Keys
+
+| Key | Action |
+|-----|--------|
+| **→** / **j** / **Space** | Next slide |
+| **←** / **k** | Previous slide |
+| **Home** / **g** | First slide |
+| **End** / **G** | Last slide |
+| **:** | Go to specific slide |
+| **/** | Search slides |
+| **o** | Slide overview grid |
+| **t** | Table of contents |
+
+## Display Options
+
+| Key | Action |
+|-----|--------|
+| **p** | Toggle presenter notes |
+| **c** | Cycle clock/timer modes |
+| **T** | Cycle through themes |
+| **b** | Blackout screen |
+| **w** | Whiteout screen |
+
+## Editing & Files
+
+| Key | Action |
+|-----|--------|
+| **e** | Edit current slide in $EDITOR |
+| **r** | Reload presentation |
+
+## Other
+
+| Key | Action |
+|-----|--------|
+| **Ctrl+P** | Command palette |
+| **?** | Show this help |
+| **q** | Quit |
+| **Escape** | Close dialogs |
+
+## Presentation Format
+
+Prezo supports **MARP/Deckset** style Markdown:
+
+- YAML frontmatter for metadata
+- `---` to separate slides
+- `???` or `<!-- notes: -->` for presenter notes
+
+### Prezo Directives
+
+Add configuration to your presentation:
+
+```markdown
+<!-- prezo
+theme: dark
+show_clock: true
+countdown_minutes: 45
+-->
+```
+
+### Supported Directives
+
+- `theme`: dark, light, dracula, solarized-dark, nord, gruvbox
+- `show_clock`: true/false
+- `show_elapsed`: true/false
+- `countdown_minutes`: number
+
+## Documentation
+
+- **GitHub**: https://github.com/abilian/prezo
+- **SourceHut**: https://git.sr.ht/~sfermigier/prezo
+- **Issues**: https://github.com/abilian/prezo/issues
+
+---
+
+*Press Escape or ? to close*
+"""
+
+
+class HelpScreen(ThemedModalScreen[None]):
+    """Modal screen showing help content."""
+
+    CSS = """
+    HelpScreen {
+        align: center middle;
+    }
+
+    #help-container {
+        width: 80%;
+        max-width: 100;
+        height: 80%;
+        background: $surface;
+        border: solid $primary;
+        padding: 1 2;
+    }
+
+    #help-title {
+        text-align: center;
+        text-style: bold;
+        color: $primary;
+        padding: 0 0 1 0;
+    }
+
+    #help-content {
+        width: 100%;
+    }
+    """
+
+    BINDINGS: ClassVar[list[BindingType]] = [
+        Binding("escape", "close", "Close"),
+        Binding("question_mark", "close", "Close"),
+        Binding("q", "close", "Close"),
+    ]
+
+    def compose(self) -> ComposeResult:
+        """Compose the help screen layout."""
+        with VerticalScroll(id="help-container"):
+            yield Static("Prezo Help", id="help-title")
+            yield Markdown(HELP_CONTENT, id="help-content")
+
+    def action_close(self) -> None:
+        """Close the help screen."""
+        self.dismiss(None)

prezo/screens/overview.py

@@ -0,0 +1,184 @@
+"""Slide overview screen for prezo."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, ClassVar
+
+from textual.binding import Binding, BindingType
+from textual.containers import Grid, VerticalScroll
+from textual.widgets import Button, Static
+
+from prezo.widgets import SlideButton
+
+from .base import ThemedModalScreen
+
+if TYPE_CHECKING:
+    from textual.app import ComposeResult
+
+    from prezo.parser import Presentation
+
+
+class SlideOverviewScreen(ThemedModalScreen[int | None]):
+    """Modal screen showing grid overview of all slides."""
+
+    GRID_COLUMNS = 4  # Number of columns in the grid
+
+    CSS = """
+    SlideOverviewScreen {
+        align: center middle;
+    }
+
+    #overview-container {
+        width: 90%;
+        height: 90%;
+        background: $surface;
+        border: thick $primary;
+        padding: 1 2;
+    }
+
+    #overview-title {
+        width: 100%;
+        height: 3;
+        content-align: center middle;
+        text-style: bold;
+        background: $primary;
+        color: $text;
+    }
+
+    #slide-grid {
+        width: 100%;
+        height: 1fr;
+        grid-size: 4;
+        grid-gutter: 1;
+        padding: 1;
+        overflow-y: auto;
+    }
+
+    SlideButton {
+        width: 100%;
+        height: 3;
+    }
+
+    SlideButton.current {
+        background: $success;
+    }
+
+    SlideButton:focus {
+        background: $primary;
+    }
+
+    SlideButton.current:focus {
+        background: $success-darken-1;
+    }
+    """
+
+    BINDINGS: ClassVar[list[BindingType]] = [
+        Binding("escape", "cancel", "Cancel"),
+        Binding("q", "cancel", "Cancel"),
+        Binding("enter", "select", "Select", show=True),
+        Binding("space", "select", "Select", show=False),
+        Binding("left", "move(-1, 0)", "Left", show=False),
+        Binding("right", "move(1, 0)", "Right", show=False),
+        Binding("up", "move(0, -1)", "Up", show=False),
+        Binding("down", "move(0, 1)", "Down", show=False),
+        Binding("h", "move(-1, 0)", "Left", show=False),
+        Binding("l", "move(1, 0)", "Right", show=False),
+        Binding("k", "move(0, -1)", "Up", show=False),
+        Binding("j", "move(0, 1)", "Down", show=False),
+        Binding("home", "first", "First", show=False),
+        Binding("end", "last", "Last", show=False),
+    ]
+
+    def __init__(self, presentation: Presentation, current_slide: int) -> None:
+        """Initialize the slide overview screen.
+
+        Args:
+            presentation: The presentation to display.
+            current_slide: Index of the currently active slide.
+
+        """
+        super().__init__()
+        self.presentation = presentation
+        self.current_slide = current_slide
+        self.selected_index = current_slide
+
+    def compose(self) -> ComposeResult:
+        """Compose the overview grid layout."""
+        with VerticalScroll(id="overview-container"):
+            yield Static(
+                " Slide Overview (Enter to jump, Esc to cancel) ",
+                id="overview-title",
+            )
+            with Grid(id="slide-grid"):
+                for i, slide in enumerate(self.presentation.slides):
+                    yield SlideButton(
+                        i,
+                        slide.content,
+                        is_current=(i == self.current_slide),
+                    )
+
+    def on_mount(self) -> None:
+        """Focus the current slide button on mount."""
+        super().on_mount()
+        self._focus_selected()
+
+    def _focus_selected(self) -> None:
+        """Focus the currently selected slide button."""
+        try:
+            button = self.query_one(f"#slide-{self.selected_index}", SlideButton)
+            button.focus()
+            button.scroll_visible()
+        except (KeyError, LookupError):
+            # Button not found - can happen during initialization
+            pass
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        """Handle slide button press to navigate to that slide."""
+        if isinstance(event.button, SlideButton):
+            self.dismiss(event.button.slide_index)
+
+    def action_cancel(self) -> None:
+        """Cancel and dismiss the overview."""
+        self.dismiss(None)
+
+    def action_select(self) -> None:
+        """Select the currently focused slide."""
+        self.dismiss(self.selected_index)
+
+    def action_move(self, dx: int, dy: int) -> None:
+        """Move selection in the grid."""
+        total = self.presentation.total_slides
+        cols = self.GRID_COLUMNS
+
+        # Calculate new position
+        row = self.selected_index // cols
+        col = self.selected_index % cols
+
+        new_col = col + dx
+        new_row = row + dy
+
+        # Handle horizontal wrapping
+        if new_col < 0:
+            new_col = cols - 1
+            new_row -= 1
+        elif new_col >= cols:
+            new_col = 0
+            new_row += 1
+
+        # Calculate new index
+        new_index = new_row * cols + new_col
+
+        # Clamp to valid range
+        if 0 <= new_index < total:
+            self.selected_index = new_index
+            self._focus_selected()
+
+    def action_first(self) -> None:
+        """Jump to first slide."""
+        self.selected_index = 0
+        self._focus_selected()
+
+    def action_last(self) -> None:
+        """Jump to last slide."""
+        self.selected_index = self.presentation.total_slides - 1
+        self._focus_selected()

prezo/screens/search.py

@@ -0,0 +1,252 @@
+"""Slide search screen for prezo."""
+
+from __future__ import annotations
+
+import re
+from typing import TYPE_CHECKING, ClassVar
+
+from textual.binding import Binding, BindingType
+from textual.containers import Vertical, VerticalScroll
+from textual.widgets import Input, Static
+
+from .base import ThemedModalScreen
+
+if TYPE_CHECKING:
+    from textual.app import ComposeResult
+
+    from prezo.parser import Presentation
+
+
+class SearchResultItem(Static):
+    """A single search result item."""
+
+    def __init__(self, slide_index: int, title: str, context: str, **kwargs) -> None:
+        """Initialize a search result item.
+
+        Args:
+            slide_index: Index of the slide this result refers to.
+            title: Title of the slide.
+            context: Context text showing the search match.
+            **kwargs: Additional arguments for Static widget.
+
+        """
+        super().__init__(**kwargs)
+        self.slide_index = slide_index
+        self.title = title
+        self.context = context
+
+    def render(self) -> str:
+        """Render the search result item."""
+        return f"[{self.slide_index + 1}] {self.title}\n    {self.context}"
+
+
+class SlideSearchScreen(ThemedModalScreen[int | None]):
+    """Modal screen for searching slides by content."""
+
+    CSS = """
+    SlideSearchScreen {
+        align: center middle;
+    }
+
+    #search-container {
+        width: 80%;
+        height: 80%;
+        background: $surface;
+        border: thick $primary;
+        padding: 1 2;
+    }
+
+    #search-title {
+        width: 100%;
+        text-align: center;
+        text-style: bold;
+        margin-bottom: 1;
+    }
+
+    #search-input {
+        width: 100%;
+        margin-bottom: 1;
+    }
+
+    #search-results {
+        width: 100%;
+        height: 1fr;
+        border: solid $primary-darken-2;
+        padding: 1;
+    }
+
+    .search-result {
+        width: 100%;
+        height: auto;
+        padding: 0 1;
+        margin-bottom: 1;
+    }
+
+    .search-result:hover {
+        background: $primary-darken-2;
+    }
+
+    .search-result.selected {
+        background: $primary;
+    }
+
+    #no-results {
+        width: 100%;
+        text-align: center;
+        color: $text-muted;
+        padding: 2;
+    }
+    """
+
+    BINDINGS: ClassVar[list[BindingType]] = [
+        Binding("escape", "cancel", "Cancel"),
+        Binding("enter", "select", "Select"),
+        Binding("up", "move_up", "Up", show=False),
+        Binding("down", "move_down", "Down", show=False),
+        Binding("ctrl+p", "move_up", "Up", show=False),
+        Binding("ctrl+n", "move_down", "Down", show=False),
+    ]
+
+    def __init__(self, presentation: Presentation) -> None:
+        """Initialize the search screen.
+
+        Args:
+            presentation: The presentation to search through.
+
+        """
+        super().__init__()
+        self.presentation = presentation
+        self.results: list[int] = []  # Slide indices
+        self.selected_index = 0
+
+    def compose(self) -> ComposeResult:
+        """Compose the search screen layout."""
+        with Vertical(id="search-container"):
+            yield Static("Search Slides", id="search-title")
+            yield Input(placeholder="Type to search...", id="search-input")
+            with VerticalScroll(id="search-results"):
+                yield Static("Type to search slide content", id="no-results")
+
+    def on_mount(self) -> None:
+        """Focus the search input on mount."""
+        super().on_mount()
+        self.query_one("#search-input", Input).focus()
+
+    def on_input_changed(self, event: Input.Changed) -> None:
+        """Handle input changes to perform live search."""
+        self._perform_search(event.value)
+
+    def on_input_submitted(self, event: Input.Submitted) -> None:
+        """Handle Enter key in the search input."""
+        self.action_select()
+
+    def _perform_search(self, query: str) -> None:
+        """Search slides for the query string."""
+        results_container = self.query_one("#search-results", VerticalScroll)
+
+        # Clear previous results
+        for child in list(results_container.children):
+            child.remove()
+
+        if not query.strip():
+            results_container.mount(
+                Static("Type to search slide content", id="no-results"),
+            )
+            self.results = []
+            return
+
+        query_lower = query.lower()
+        self.results = []
+
+        for i, slide in enumerate(self.presentation.slides):
+            if (
+                query_lower in slide.content.lower()
+                or query_lower in slide.raw_content.lower()
+            ):
+                self.results.append(i)
+
+        if not self.results:
+            results_container.mount(
+                Static(f"No results for '{query}'", id="no-results"),
+            )
+            return
+
+        self.selected_index = 0
+        for idx, slide_idx in enumerate(self.results):
+            slide = self.presentation.slides[slide_idx]
+            title = self._extract_title(slide.content)
+            context = self._extract_context(slide.content, query_lower)
+
+            item = SearchResultItem(
+                slide_idx,
+                title,
+                context,
+                classes="search-result" + (" selected" if idx == 0 else ""),
+            )
+            results_container.mount(item)
+
+    def _extract_title(self, content: str) -> str:
+        """Extract title from slide content."""
+        for line in content.strip().split("\n"):
+            line = line.strip()
+            match = re.match(r"^#{1,6}\s+(.+)$", line)
+            if match:
+                return match.group(1).strip()[:50]
+        return content.strip().split("\n")[0][:50] if content.strip() else "Untitled"
+
+    def _extract_context(self, content: str, query: str) -> str:
+        """Extract context around the search match."""
+        content_lower = content.lower()
+        pos = content_lower.find(query)
+        if pos == -1:
+            return ""
+
+        start = max(0, pos - 20)
+        end = min(len(content), pos + len(query) + 30)
+
+        context = content[start:end].replace("\n", " ")
+        if start > 0:
+            context = "..." + context
+        if end < len(content):
+            context = context + "..."
+
+        return context
+
+    def _update_selection(self) -> None:
+        """Update visual selection."""
+        results_container = self.query_one("#search-results", VerticalScroll)
+        for idx, child in enumerate(results_container.query(".search-result")):
+            if idx == self.selected_index:
+                child.add_class("selected")
+                child.scroll_visible()
+            else:
+                child.remove_class("selected")
+
+    def action_cancel(self) -> None:
+        """Cancel and dismiss the search screen."""
+        self.dismiss(None)
+
+    def action_select(self) -> None:
+        """Select the currently highlighted search result."""
+        if self.results and 0 <= self.selected_index < len(self.results):
+            self.dismiss(self.results[self.selected_index])
+        else:
+            self.dismiss(None)
+
+    def action_move_up(self) -> None:
+        """Move selection up in the results list."""
+        if self.results and self.selected_index > 0:
+            self.selected_index -= 1
+            self._update_selection()
+
+    def action_move_down(self) -> None:
+        """Move selection down in the results list."""
+        if self.results and self.selected_index < len(self.results) - 1:
+            self.selected_index += 1
+            self._update_selection()
+
+    def on_click(self, event) -> None:
+        """Handle clicking on a search result."""
+        widget = self.get_widget_at(event.screen_x, event.screen_y)
+        if widget and isinstance(widget, SearchResultItem):
+            self.dismiss(widget.slide_index)