prezo 2026.1.4__tar.gz → 2026.2.1__tar.gz

{prezo-2026.1.4 → prezo-2026.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: prezo
-Version: 2026.1.4
+Version: 2026.2.1
 Summary: A TUI-based presentation tool for the terminal, built with Textual.
 Author: Stefane Fermigier
 Author-email: Stefane Fermigier <sf@fermigier.com>
@@ -20,6 +20,7 @@ Display presentations written in Markdown using conventions similar to those of
 
 - **Markdown presentations** - MARP/Deckset format with `---` slide separators
 - **Column layouts** - Pandoc-style fenced divs for multi-column slides (`::: columns`)
+- **Incremental lists** - Reveal list items one at a time (`-I` flag, like Pandoc)
 - **Live reload** - Auto-refresh when file changes (1s polling)
 - **Keyboard navigation** - Vim-style keys, arrow keys, and more
 - **Slide overview** - Grid view for quick navigation (`o`)
@@ -71,6 +72,9 @@ prezo -c myconfig.toml presentation.md
 # Set image rendering mode
 prezo --image-mode ascii presentation.md   # Options: auto, kitty, sixel, iterm, ascii, none
 
+# Incremental list reveal (reveal items one at a time)
+prezo -I presentation.md
+
 # Export to PDF
 prezo -e pdf presentation.md
 
@@ -92,6 +96,7 @@ prezo -e pdf presentation.md --theme light --size 100x30 --no-chrome
 | `t` | Table of contents |
 | `p` | Toggle notes panel |
 | `c` | Cycle clock display |
+| `s` | Start/stop timer |
 | `T` | Cycle theme |
 | `b` | Blackout screen |
 | `w` | Whiteout screen |

{prezo-2026.1.4 → prezo-2026.2.1}/README.md

@@ -8,6 +8,7 @@ Display presentations written in Markdown using conventions similar to those of
 
 - **Markdown presentations** - MARP/Deckset format with `---` slide separators
 - **Column layouts** - Pandoc-style fenced divs for multi-column slides (`::: columns`)
+- **Incremental lists** - Reveal list items one at a time (`-I` flag, like Pandoc)
 - **Live reload** - Auto-refresh when file changes (1s polling)
 - **Keyboard navigation** - Vim-style keys, arrow keys, and more
 - **Slide overview** - Grid view for quick navigation (`o`)
@@ -59,6 +60,9 @@ prezo -c myconfig.toml presentation.md
 # Set image rendering mode
 prezo --image-mode ascii presentation.md   # Options: auto, kitty, sixel, iterm, ascii, none
 
+# Incremental list reveal (reveal items one at a time)
+prezo -I presentation.md
+
 # Export to PDF
 prezo -e pdf presentation.md
 
@@ -80,6 +84,7 @@ prezo -e pdf presentation.md --theme light --size 100x30 --no-chrome
 | `t` | Table of contents |
 | `p` | Toggle notes panel |
 | `c` | Cycle clock display |
+| `s` | Start/stop timer |
 | `T` | Cycle theme |
 | `b` | Blackout screen |
 | `w` | Whiteout screen |

{prezo-2026.1.4 → prezo-2026.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "prezo"
-version = "2026.1.4"
+version = "2026.2.1"
 description = "A TUI-based presentation tool for the terminal, built with Textual."
 readme = "README.md"
 authors = [

{prezo-2026.1.4 → prezo-2026.2.1}/src/prezo/__init__.py

@@ -78,6 +78,16 @@ def _validate_file(path: Path, must_exist: bool = True) -> Path:
     return resolved
 
 
+def _get_version() -> str:
+    """Get the package version from metadata."""
+    from importlib.metadata import version  # noqa: PLC0415
+
+    try:
+        return version("prezo")
+    except Exception:
+        return "unknown"
+
+
 def main() -> None:
     """Entry point for Prezo."""
     parser = argparse.ArgumentParser(
@@ -85,6 +95,12 @@ def main() -> None:
         description="TUI-based presentation tool for Markdown slides",
         epilog="For more information, visit: https://github.com/abilian/prezo",
     )
+    parser.add_argument(
+        "-v",
+        "--version",
+        action="version",
+        version=f"%(prog)s {_get_version()}",
+    )
     parser.add_argument(
         "file",
         nargs="?",
@@ -165,6 +181,12 @@ def main() -> None:
         action="store_true",
         help="Display lists incrementally, one item at a time (like Pandoc)",
     )
+    parser.add_argument(
+        "--time-budget",
+        metavar="MINUTES",
+        type=int,
+        help="Time budget in minutes for pacing indicator (shows if ahead/behind)",
+    )
 
     args = parser.parse_args()
 
@@ -247,4 +269,5 @@ def main() -> None:
             watch=not args.no_watch,
             config=config,
             incremental=args.incremental,
+            time_budget=args.time_budget,
         )

{prezo-2026.1.4 → prezo-2026.2.1}/src/prezo/app.py

@@ -67,6 +67,7 @@ prezo <presentation.md>
 | **t** | Table of contents |
 | **p** | Toggle notes |
 | **c** | Toggle clock |
+| **s** | Start/stop timer |
 | **b** | Blackout screen |
 | **e** | Edit current slide |
 | **r** | Reload file |
@@ -258,6 +259,7 @@ class PrezoCommands(Provider):
                 ("Search Slides", "search", "Search slides by content (/)"),
                 ("Toggle Notes", "toggle_notes", "Show/hide presenter notes (p)"),
                 ("Toggle Clock", "toggle_clock", "Cycle clock display mode (c)"),
+                ("Start/Stop Timer", "toggle_timer", "Start or stop elapsed timer (S)"),
                 ("Help", "show_help", "Show keyboard shortcuts (?)"),
             ]
         )
@@ -446,6 +448,8 @@ class PrezoApp(App):
         Binding("t", "show_toc", "TOC", show=True),
         Binding("p", "toggle_notes", "Notes", show=True),
         Binding("c", "toggle_clock", "Clock", show=False),
+        Binding("s", "toggle_timer", "Timer", show=False),
+        Binding("S", "toggle_timer", "Timer", show=False),
         Binding("T", "cycle_theme", "Theme", show=False),
         Binding("b", "blackout", "Blackout", show=False),
         Binding("w", "whiteout", "Whiteout", show=False),
@@ -469,6 +473,7 @@ class PrezoApp(App):
         watch: bool | None = None,
         config: Config | None = None,
         incremental: bool = False,
+        time_budget: int | None = None,
     ) -> None:
         """Initialize the Prezo application.
 
@@ -477,6 +482,7 @@ class PrezoApp(App):
             watch: Whether to enable file watching for live reload.
             config: Optional config override. Uses global config if None.
             incremental: Whether to display lists incrementally (-I flag).
+            time_budget: Time budget in minutes for pacing indicator.
 
         """
         super().__init__()
@@ -489,6 +495,9 @@ class PrezoApp(App):
         # Incremental lists: CLI flag overrides config
         self.incremental_cli = incremental
 
+        # Time budget: CLI flag overrides config/presentation directives
+        self.time_budget_cli = time_budget
+
         # Use config for watch if not explicitly set
         if watch is None:
             self.watch_enabled = self.config.behavior.auto_reload
@@ -706,6 +715,7 @@ class PrezoApp(App):
         show_clock = self.config.timer.show_clock
         show_elapsed = self.config.timer.show_elapsed
         countdown = self.config.timer.countdown_minutes
+        time_budget = self.config.timer.time_budget_minutes
 
         # Override with presentation directives if specified
         if self.presentation:
@@ -716,12 +726,19 @@ class PrezoApp(App):
                 show_elapsed = directives.show_elapsed
             if directives.countdown_minutes is not None:
                 countdown = directives.countdown_minutes
+            if directives.time_budget_minutes is not None:
+                time_budget = directives.time_budget_minutes
+
+        # CLI flag takes highest priority for time budget
+        if self.time_budget_cli is not None:
+            time_budget = self.time_budget_cli
 
         # Apply to status bar
         status_bar.show_clock = show_clock
         status_bar.show_elapsed = show_elapsed
         status_bar.countdown_minutes = countdown
         status_bar.show_countdown = countdown > 0
+        status_bar.time_budget_minutes = time_budget
 
     def _show_welcome(self) -> None:
         """Show welcome message when no presentation is loaded."""
@@ -977,6 +994,10 @@ class PrezoApp(App):
         """Cycle through clock display modes."""
         self.query_one("#status-bar", StatusBar).toggle_clock()
 
+    def action_toggle_timer(self) -> None:
+        """Start or stop the elapsed timer."""
+        self.query_one("#status-bar", StatusBar).toggle_timer()
+
     def action_cycle_theme(self) -> None:
         """Cycle through available themes."""
         self.app_theme = get_next_theme(self.app_theme)
@@ -1188,6 +1209,7 @@ def run_app(
     watch: bool | None = None,
     config: Config | None = None,
     incremental: bool = False,
+    time_budget: int | None = None,
 ) -> None:
     """Run the Prezo application.
 
@@ -1196,9 +1218,14 @@ def run_app(
         watch: Whether to watch for file changes. Uses config default if None.
         config: Optional config override. Uses global config if None.
         incremental: Whether to display lists incrementally (-I flag).
+        time_budget: Time budget in minutes for pacing indicator.
 
     """
     app = PrezoApp(
-        presentation_path, watch=watch, config=config, incremental=incremental
+        presentation_path,
+        watch=watch,
+        config=config,
+        incremental=incremental,
+        time_budget=time_budget,
     )
     app.run()

{prezo-2026.1.4 → prezo-2026.2.1}/src/prezo/config.py

@@ -61,6 +61,7 @@ class TimerConfig:
     show_clock: bool = True
     show_elapsed: bool = True
     countdown_minutes: int = 0
+    time_budget_minutes: int = 0  # Total time budget for pacing indicator
 
 
 @dataclass

{prezo-2026.1.4 → prezo-2026.2.1}/src/prezo/export/svg.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import io
+import re
 
 from rich.console import Console
 from rich.markdown import Markdown
@@ -13,66 +14,62 @@ from rich.text import Text
 from prezo.layout import has_layout_blocks, parse_layout, render_layout
 from prezo.themes import get_theme
 
-# SVG template without window chrome (for printing)
-# Uses Rich's template format: {var} for substitution, {{ }} for literal braces
-SVG_FORMAT_NO_CHROME = """\
-<svg class="rich-terminal" viewBox="0 0 {width} {height}" xmlns="http://www.w3.org/2000/svg">
-    <!-- Generated with Rich https://www.textualize.io -->
-    <style>
-
-    @font-face {{
-        font-family: "Fira Code";
-        src: local("FiraCode-Regular"),
-                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"),
-                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff");
-        font-style: normal;
-        font-weight: 400;
-    }}
-    @font-face {{
-        font-family: "Fira Code";
-        src: local("FiraCode-Bold"),
-                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Bold.woff2") format("woff2"),
-                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Bold.woff") format("woff");
-        font-style: bold;
-        font-weight: 700;
-    }}
-
-    .{{unique_id}}-matrix {{
-        font-family: Fira Code, "Apple Color Emoji", "Segoe UI Emoji", "Noto Color Emoji", monospace;
-        font-size: {{char_height}}px;
-        line-height: {{line_height}}px;
-        font-variant-east-asian: full-width;
-        /* Disable ligatures and ensure consistent character widths */
-        font-feature-settings: "liga" 0, "calt" 0, "dlig" 0;
-        font-variant-ligatures: none;
-        letter-spacing: 0;
-        word-spacing: 0;
-        white-space: pre;
-    }}
-
-    .{{unique_id}}-matrix text {{
-        /* Force uniform character spacing for box-drawing chars */
-        text-rendering: geometricPrecision;
-    }}
-
-    {{styles}}
-    </style>
-
-    <defs>
-    <clipPath id="{{unique_id}}-clip-terminal">
-      <rect x="0" y="0" width="{{width}}" height="{{height}}" />
-    </clipPath>
-    {{lines}}
-    </defs>
-
-    <g transform="translate(0, 0)" clip-path="url(#{{unique_id}}-clip-terminal)">
-    {{backgrounds}}
-    <g class="{{unique_id}}-matrix">
-    {{matrix}}
-    </g>
-    </g>
-</svg>
-"""
+# Patterns for stripping window chrome from SVG
+# Window border rect with rounded corners
+_WINDOW_BORDER_PATTERN = re.compile(
+    r'<rect fill="[^"]*" stroke="rgba\(255,255,255,[^"]*\)" '
+    r'stroke-width="1" x="1" y="1" [^/]*/>'
+)
+# Title text element
+_TITLE_TEXT_PATTERN = re.compile(r'<text class="[^"]*-title"[^>]*>[^<]*</text>')
+# Traffic light buttons group
+_TRAFFIC_LIGHTS_PATTERN = re.compile(
+    r'<g transform="translate\(26,22\)">\s*'
+    r"<circle[^/]*/>\s*<circle[^/]*/>\s*<circle[^/]*/>\s*</g>"
+)
+# Content group transform (to adjust offset)
+_CONTENT_TRANSFORM_PATTERN = re.compile(
+    r'<g transform="translate\((\d+(?:\.\d+)?), (\d+(?:\.\d+)?)\)" '
+    r'clip-path="url\(#([^"]+)\)">'
+)
+
+
+def _strip_window_chrome(svg: str) -> str:
+    """Remove window decorations from SVG for printing.
+
+    Removes:
+    - Window border (rounded rect with stroke)
+    - Title text
+    - Traffic light buttons (red/yellow/green circles)
+
+    Also adjusts the content position to start at origin.
+
+    Args:
+        svg: SVG string with window chrome.
+
+    Returns:
+        SVG string without window chrome.
+
+    """
+    # Remove window border
+    svg = _WINDOW_BORDER_PATTERN.sub("", svg)
+
+    # Remove title text
+    svg = _TITLE_TEXT_PATTERN.sub("", svg)
+
+    # Remove traffic lights
+    svg = _TRAFFIC_LIGHTS_PATTERN.sub("", svg)
+
+    # Adjust content transform to remove offset
+    # The content is typically at translate(9, 41) with chrome
+    # Move it to translate(0, 0) for clean output
+    def adjust_transform(match: re.Match) -> str:
+        clip_id = match.group(3)
+        return f'<g transform="translate(0, 0)" clip-path="url(#{clip_id})">'
+
+    svg = _CONTENT_TRANSFORM_PATTERN.sub(adjust_transform, svg)
+
+    return svg
 
 
 def render_slide_to_svg(
@@ -121,8 +118,11 @@ def render_slide_to_svg(
     else:
         slide_content = Markdown(content)
 
-    # Create a panel with the slide content (height - 2 for status bar and padding)
-    panel_height = height - 2
+    # Create a panel with the slide content
+    # Panel takes full height minus status bar line
+    # Note: Rich's export_svg adds chrome which takes ~2 lines at top
+    # So we use height to maximize content area
+    panel_height = height
     panel = Panel(
         slide_content,
         title=f"[{theme.text_muted}]Slide {slide_num + 1}/{total_slides}[/]",
@@ -134,8 +134,8 @@ def render_slide_to_svg(
         height=panel_height,
     )
 
-    # Print to the recording console with background
-    console.print(panel, style=base_style)
+    # Print to the recording console with background (no trailing newline)
+    console.print(panel, style=base_style, end="")
 
     # Add status bar at the bottom
     progress = (slide_num + 1) / total_slides
@@ -146,13 +146,10 @@ def render_slide_to_svg(
     # Pad status bar to full width
     status_text = status_text.ljust(width)
     status = Text(status_text, style=Style(bgcolor=theme.primary, color=theme.text))
-    console.print(status, style=base_style)
+    console.print(status, style=base_style, end="")
 
-    # Export to SVG
-    if chrome:
-        svg = console.export_svg(title=f"Slide {slide_num + 1}")
-    else:
-        svg = console.export_svg(code_format=SVG_FORMAT_NO_CHROME)
+    # Export to SVG (always with Rich's default chrome first)
+    svg = console.export_svg(title=f"Slide {slide_num + 1}")
 
     # Add emoji font fallbacks to font-family declarations
     # Rich only specifies "Fira Code, monospace" which lacks emoji glyphs
@@ -164,7 +161,13 @@ def render_slide_to_svg(
     # Add background color to SVG (Rich doesn't set it by default)
     # Insert a rect element right after the opening svg tag
     bg_rect = f'<rect width="100%" height="100%" fill="{theme.background}"/>'
-    return svg.replace(
+    svg = svg.replace(
         'xmlns="http://www.w3.org/2000/svg">',
         f'xmlns="http://www.w3.org/2000/svg">\n    {bg_rect}',
     )
+
+    # Remove window chrome if requested (for printing)
+    if not chrome:
+        svg = _strip_window_chrome(svg)
+
+    return svg

{prezo-2026.1.4 → prezo-2026.2.1}/src/prezo/parser.py

@@ -51,6 +51,7 @@ class PresentationConfig:
     show_clock: bool | None = None
     show_elapsed: bool | None = None
     countdown_minutes: int | None = None
+    time_budget_minutes: int | None = None  # Time budget for pacing indicator
     image_mode: str | None = None
     incremental_lists: bool | None = None
 
@@ -65,6 +66,10 @@ class PresentationConfig:
             result.setdefault("timer", {})["show_elapsed"] = self.show_elapsed
         if self.countdown_minutes is not None:
             result.setdefault("timer", {})["countdown_minutes"] = self.countdown_minutes
+        if self.time_budget_minutes is not None:
+            result.setdefault("timer", {})["time_budget_minutes"] = (
+                self.time_budget_minutes
+            )
         if self.image_mode is not None:
             result.setdefault("images", {})["mode"] = self.image_mode
         if self.incremental_lists is not None:
@@ -239,6 +244,9 @@ def extract_prezo_directives(content: str) -> PresentationConfig:
         elif key in ("countdown_minutes", "countdown", "countdownminutes"):
             with contextlib.suppress(ValueError):
                 config.countdown_minutes = int(value)
+        elif key in ("time_budget", "time_budget_minutes", "timebudget"):
+            with contextlib.suppress(ValueError):
+                config.time_budget_minutes = int(value)
         elif key in ("image_mode", "imagemode", "images"):
             config.image_mode = value
         elif key in ("incremental_lists", "incremental", "incrementallists"):

{prezo-2026.1.4 → prezo-2026.2.1}/src/prezo/screens/help.py

@@ -35,9 +35,11 @@ HELP_CONTENT = """\
 |-----|--------|
 | **p** | Toggle presenter notes |
 | **c** | Cycle clock/timer modes |
+| **s** | Start/stop timer |
 | **T** | Cycle through themes |
 | **b** | Blackout screen |
 | **w** | Whiteout screen |
+| **i** | View image (native quality) |
 
 ## Editing & Files
 
@@ -81,6 +83,8 @@ countdown_minutes: 45
 - `show_clock`: true/false
 - `show_elapsed`: true/false
 - `countdown_minutes`: number
+- `time_budget`: minutes (shows pacing indicator)
+- `incremental`: true/false (reveal list items one at a time)
 
 ## Documentation
 

{prezo-2026.1.4 → prezo-2026.2.1}/src/prezo/widgets/status_bar.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from datetime import datetime, timezone
 from typing import TYPE_CHECKING
 
+from rich.text import Text
 from textual.reactive import reactive
 from textual.widgets import Static
 
@@ -59,11 +60,16 @@ class StatusBar(Static):
     # Incremental reveal indicator
     reveal_current: reactive[int] = reactive(-1)  # -1 = not in reveal mode
     reveal_total: reactive[int] = reactive(0)
+    # Timer running state
+    timer_running: reactive[bool] = reactive(True)
+    # Time budget for pacing indicator (0 = disabled)
+    time_budget_minutes: reactive[int] = reactive(0)
 
     def __init__(self, **kwargs) -> None:
         """Initialize the status bar."""
         super().__init__(**kwargs)
         self._start_time: datetime | None = None
+        self._elapsed_when_paused: float = 0.0  # Accumulated time when paused
         self._timer: Timer | None = None
 
     def on_mount(self) -> None:
@@ -75,18 +81,26 @@ class StatusBar(Static):
         """Timer callback to refresh the display."""
         self.refresh()
 
-    def render(self) -> str:
+    def render(self) -> Text:
         """Render the status bar content."""
+        result = Text()
+
         # Progress part
         bar = format_progress_bar(self.current, self.total, width=20)
-        progress = f"{bar} {self.current + 1}/{self.total}"
+        progress = f" {bar} {self.current + 1}/{self.total}"
+        result.append(progress)
 
         # Reveal indicator (shows remaining list items)
-        reveal = ""
         if self.reveal_current >= 0 and self.reveal_total > 0:
             remaining = self.reveal_total - self.reveal_current - 1
             if remaining > 0:
-                reveal = f" [+{remaining}]"
+                result.append(f" [+{remaining}]")
+
+        # Pacing indicator (if time budget is set)
+        pacing = self._get_pacing_indicator()
+        if pacing:
+            result.append("    ")
+            result.append_text(pacing)
 
         # Clock part
         clock_parts = []
@@ -96,26 +110,100 @@ class StatusBar(Static):
             )
 
         if self.show_elapsed and self._start_time:
-            elapsed = datetime.now(tz=timezone.utc) - self._start_time
-            elapsed_secs = int(elapsed.total_seconds())
-            clock_parts.append(f"+{format_time(elapsed_secs)}")
+            elapsed_secs = self._get_elapsed_seconds()
+            # Show pause indicator when timer is stopped
+            pause_indicator = " ⏸" if not self.timer_running else ""
+            clock_parts.append(f"+{format_time(elapsed_secs)}{pause_indicator}")
 
         if self.show_countdown and self.countdown_minutes > 0 and self._start_time:
             total_secs = self.countdown_minutes * 60
-            elapsed = datetime.now(tz=timezone.utc) - self._start_time
-            remaining = total_secs - int(elapsed.total_seconds())
+            elapsed_secs = self._get_elapsed_seconds()
+            remaining = total_secs - elapsed_secs
             clock_parts.append(f"-{format_time(remaining)}")
 
-        clock = " │ ".join(clock_parts) if clock_parts else ""
+        if clock_parts:
+            # Add separator if we have pacing or progress
+            result.append("    ")
+            result.append(" │ ".join(clock_parts))
+
+        result.append(" ")
+        return result
+
+    def _get_pacing_indicator(self) -> Text | None:
+        """Get the pacing indicator with color based on time budget.
+
+        Returns colored indicator:
+        - Green (▲ -Xm) if more than 10% ahead
+        - Red (▼ +Xm) if more than 10% behind
+        - None if no time budget or on track
 
-        # Combine with spacing
-        if clock:
-            return f" {progress}{reveal}    {clock} "
-        return f" {progress}{reveal} "
+        """
+        if self.time_budget_minutes <= 0 or self.total <= 0:
+            return None
+
+        elapsed_secs = self._get_elapsed_seconds()
+        total_budget_secs = self.time_budget_minutes * 60
+
+        # Expected time for current slide position
+        # (current is 0-indexed, so current+1 gives slides completed)
+        expected_secs = (total_budget_secs / self.total) * (self.current + 1)
+
+        # Calculate difference (positive = behind, negative = ahead)
+        diff_secs = elapsed_secs - expected_secs
+        diff_pct = diff_secs / expected_secs if expected_secs > 0 else 0
+
+        # More than 10% threshold
+        if diff_pct > 0.1:
+            # Behind schedule - need to speed up (red background, white text)
+            diff_mins = int(abs(diff_secs) / 60)
+            diff_remaining = int(abs(diff_secs) % 60)
+            if diff_mins > 0:
+                indicator = f" ▼ +{diff_mins}m{diff_remaining:02d}s "
+            else:
+                indicator = f" ▼ +{diff_remaining}s "
+            return Text(indicator, style="bold white on red")
+        if diff_pct < -0.1:
+            # Ahead of schedule (green background, white text)
+            diff_mins = int(abs(diff_secs) / 60)
+            diff_remaining = int(abs(diff_secs) % 60)
+            if diff_mins > 0:
+                indicator = f" ▲ -{diff_mins}m{diff_remaining:02d}s "
+            else:
+                indicator = f" ▲ -{diff_remaining}s "
+            return Text(indicator, style="bold white on green")
+
+        # On track - no indicator needed
+        return None
+
+    def _get_elapsed_seconds(self) -> int:
+        """Get total elapsed seconds, accounting for pauses."""
+        if not self._start_time:
+            return 0
+        if self.timer_running:
+            current_elapsed = datetime.now(tz=timezone.utc) - self._start_time
+            return int(current_elapsed.total_seconds() + self._elapsed_when_paused)
+        # When paused, just return the accumulated time
+        return int(self._elapsed_when_paused)
 
     def reset_timer(self) -> None:
         """Reset the elapsed timer."""
         self._start_time = datetime.now(tz=timezone.utc)
+        self._elapsed_when_paused = 0.0
+        self.timer_running = True
+        self.refresh()
+
+    def toggle_timer(self) -> None:
+        """Start or stop the elapsed timer."""
+        if self.timer_running:
+            # Pausing: save current elapsed time
+            if self._start_time:
+                current_elapsed = datetime.now(tz=timezone.utc) - self._start_time
+                self._elapsed_when_paused += current_elapsed.total_seconds()
+            self.timer_running = False
+        else:
+            # Resuming: reset start time (accumulated time is preserved)
+            self._start_time = datetime.now(tz=timezone.utc)
+            self.timer_running = True
         self.refresh()
 
     def toggle_clock(self) -> None:
@@ -160,6 +248,14 @@ class StatusBar(Static):
         """React to reveal total changes."""
         self.refresh()
 
+    def watch_timer_running(self, value: bool) -> None:
+        """React to timer running state changes."""
+        self.refresh()
+
+    def watch_time_budget_minutes(self, value: int) -> None:
+        """React to time budget changes."""
+        self.refresh()
+
 
 # Keep these for backwards compatibility and separate use
 class ProgressBar(Static):