prezo 2026.1.1__py3-none-any.whl → 2026.1.3__py3-none-any.whl

prezo/__init__.py

@@ -128,6 +128,13 @@ def main() -> None:
         action="store_true",
         help="Export without window decorations (for printing)",
     )
+    parser.add_argument(
+        "--pdf-backend",
+        metavar="BACKEND",
+        choices=["auto", "chrome", "inkscape", "cairosvg"],
+        default="auto",
+        help="PDF conversion backend (auto, chrome, inkscape, cairosvg). Default: auto",
+    )
     parser.add_argument(
         "--scale",
         metavar="FACTOR",
@@ -218,6 +225,7 @@ def main() -> None:
                     width=width,
                     height=height,
                     chrome=not args.no_chrome,
+                    pdf_backend=args.pdf_backend,
                 ),
             )
     else:

prezo/app.py

@@ -39,7 +39,7 @@ from .screens import (
 )
 from .terminal import ImageCapability, detect_image_capability
 from .themes import get_next_theme, get_theme
-from .widgets import ImageDisplay, StatusBar
+from .widgets import ImageDisplay, SlideContent, StatusBar
 
 WELCOME_MESSAGE = """\
 # Welcome to Prezo
@@ -199,7 +199,7 @@ class PrezoApp(App):
 
     ENABLE_COMMAND_PALETTE = True
     COMMAND_PALETTE_BINDING = "ctrl+p"
-    COMMANDS: ClassVar[set[type[Provider]]] = {PrezoCommands}  # type: ignore[assignment]
+    COMMANDS: ClassVar[set[type[Provider]]] = {PrezoCommands}
 
     CSS = """
     Screen {
@@ -389,7 +389,7 @@ class PrezoApp(App):
                             yield ImageDisplay(id="slide-image")
                         # Text container
                         with VerticalScroll(id="slide-container"):
-                            yield Markdown("", id="slide-content")
+                            yield SlideContent("", id="slide-content")
                 with Vertical(id="notes-panel"):
                     yield Static("Notes", id="notes-title")
                     yield Markdown("", id="notes-content")
@@ -519,7 +519,7 @@ class PrezoApp(App):
         recent_section = _format_recent_files(self.state.recent_files)
         if recent_section:
             welcome += recent_section
-        self.query_one("#slide-content", Markdown).update(welcome)
+        self.query_one("#slide-content", SlideContent).set_content(welcome)
         status = self.query_one("#status-bar", StatusBar)
         status.current = 0
         status.total = 1
@@ -555,35 +555,27 @@ class PrezoApp(App):
                 image_container.add_class("visible")
 
                 # Apply layout based on MARP directive
-                layout = first_image.layout
-                if layout == "left":
-                    image_container.add_class("layout-left")
-                    # Ensure image is before text
-                    horizontal_container.move_child(
-                        image_container, before=slide_container
-                    )
-                elif layout == "right":
-                    image_container.add_class("layout-right")
-                    # Move image after text
-                    horizontal_container.move_child(
-                        image_container, after=slide_container
-                    )
-                elif layout == "inline":
-                    image_container.add_class("layout-inline")
-                    horizontal_container.move_child(
-                        image_container, before=slide_container
-                    )
-                elif layout in ("background", "fit"):
-                    # Background/fit images: show image full width behind/above text
-                    image_container.add_class("layout-inline")
-                    horizontal_container.move_child(
-                        image_container, before=slide_container
-                    )
+                match first_image.layout:
+                    case "left":
+                        image_container.add_class("layout-left")
+                        horizontal_container.move_child(
+                            image_container, before=slide_container
+                        )
+                    case "right":
+                        image_container.add_class("layout-right")
+                        horizontal_container.move_child(
+                            image_container, after=slide_container
+                        )
+                    case "inline" | "background" | "fit":
+                        image_container.add_class("layout-inline")
+                        horizontal_container.move_child(
+                            image_container, before=slide_container
+                        )
 
                 # Apply dynamic width if size_percent is specified
                 default_size = 50
                 has_custom_size = first_image.size_percent != default_size
-                if has_custom_size and layout in ("left", "right"):
+                if has_custom_size and first_image.layout in ("left", "right"):
                     image_container.styles.width = f"{first_image.size_percent}%"
                 else:
                     image_container.styles.width = None  # Reset to CSS default
@@ -591,7 +583,9 @@ class PrezoApp(App):
                 image_widget.clear()
 
         # Use cleaned content (bg images already removed by parser)
-        self.query_one("#slide-content", Markdown).update(slide.content.strip())
+        self.query_one("#slide-content", SlideContent).set_content(
+            slide.content.strip()
+        )
 
         container = self.query_one("#slide-container", VerticalScroll)
         container.scroll_home(animate=False)
@@ -738,7 +732,7 @@ class PrezoApp(App):
     def watch_app_theme(self, theme_name: str) -> None:
         """Apply theme when it changes."""
         # Only apply to widgets after mount (watcher fires during init)
-        if not self.is_mounted:  # type: ignore[truthy-function]
+        if not self.is_mounted:
             return
         self._apply_theme(theme_name)
         self.notify(f"Theme: {theme_name}", timeout=1)

prezo/config.py

@@ -11,7 +11,7 @@ from typing import Any
 try:
     import tomllib
 except ImportError:
-    import tomli as tomllib  # type: ignore[no-redef]
+    import tomli as tomllib
 
 
 CONFIG_DIR = Path.home() / ".config" / "prezo"

prezo/export/__init__.py

@@ -0,0 +1,36 @@
+"""Export functionality for prezo presentations.
+
+Exports presentations to PDF, HTML, PNG, and SVG formats.
+
+IMPORTANT: PDF/PNG/SVG export must be a faithful image of the TUI console.
+This requires proper monospace font loading. If Fira Code is not available,
+alignment may be incorrect.
+"""
+
+from __future__ import annotations
+
+from .common import (
+    ExportError,
+    check_font_availability,
+    print_font_warnings,
+)
+from .html import export_to_html, render_slide_to_html, run_html_export
+from .images import export_slide_to_image, export_to_images, run_image_export
+from .pdf import combine_svgs_to_pdf, export_to_pdf, run_export
+from .svg import render_slide_to_svg
+
+__all__ = [
+    "ExportError",
+    "check_font_availability",
+    "combine_svgs_to_pdf",
+    "export_slide_to_image",
+    "export_to_html",
+    "export_to_images",
+    "export_to_pdf",
+    "print_font_warnings",
+    "render_slide_to_html",
+    "render_slide_to_svg",
+    "run_export",
+    "run_html_export",
+    "run_image_export",
+]

prezo/export/common.py

@@ -0,0 +1,77 @@
+"""Common utilities and constants for export functionality."""
+
+from __future__ import annotations
+
+import shutil
+import subprocess
+import sys
+
+
+class ExportError(Exception):
+    """Raised when an export operation fails."""
+
+
+# Exit codes for CLI (only used in run_* wrapper functions)
+EXIT_SUCCESS = 0
+EXIT_FAILURE = 2
+
+# Backwards compatibility aliases (deprecated, use exceptions instead)
+EXPORT_SUCCESS = EXIT_SUCCESS
+EXPORT_FAILED = EXIT_FAILURE
+
+
+def check_font_availability() -> list[str]:
+    """Check if required fonts are available on the system.
+
+    Returns a list of warning messages (empty if all fonts are available).
+    """
+    warnings = []
+
+    # Check for fc-list (fontconfig) to query system fonts
+    fc_list_path = shutil.which("fc-list")
+    if fc_list_path:
+        try:
+            result = subprocess.run(
+                [fc_list_path, ":family"],
+                capture_output=True,
+                text=True,
+                timeout=5,
+                check=False,
+            )
+            fonts = result.stdout.lower()
+
+            # Check for Fira Code (primary monospace font)
+            if "fira code" not in fonts and "firacode" not in fonts:
+                warnings.append(
+                    "Fira Code font not found. Install it for best results:\n"
+                    "  macOS: brew install --cask font-fira-code\n"
+                    "  Ubuntu: sudo apt install fonts-firacode\n"
+                    "  Or download from: https://github.com/tonsky/FiraCode"
+                )
+
+        except (subprocess.TimeoutExpired, subprocess.SubprocessError):
+            # Can't check fonts, skip warning
+            pass
+    else:
+        # No fontconfig available (Windows or minimal system)
+        # We can't easily check fonts, so just note the requirement
+        warnings.append(
+            "Cannot verify font availability. For correct alignment, ensure "
+            "Fira Code font is installed."
+        )
+
+    return warnings
+
+
+def print_font_warnings(warnings: list[str]) -> None:
+    """Print font warnings to stderr."""
+    if warnings:
+        print("\n⚠️  Font Warning:", file=sys.stderr)
+        for warning in warnings:
+            for line in warning.split("\n"):
+                print(f"   {line}", file=sys.stderr)
+        print(
+            "\n   Without proper fonts, column alignment may be incorrect in exports.",
+            file=sys.stderr,
+        )
+        print(file=sys.stderr)

prezo/export/html.py

@@ -0,0 +1,340 @@
+"""HTML export functionality."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from prezo.parser import clean_marp_directives, extract_notes, parse_presentation
+from prezo.themes import get_theme
+
+from .common import EXIT_FAILURE, EXIT_SUCCESS, ExportError
+
+# HTML export templates
+HTML_TEMPLATE = """\
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{title}</title>
+    <style>
+        * {{
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }}
+        body {{
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
+            background: {background};
+            color: {text};
+            min-height: 100vh;
+        }}
+        .slides {{
+            max-width: 1200px;
+            margin: 0 auto;
+            padding: 2rem;
+        }}
+        .slide {{
+            background: {surface};
+            border: 1px solid {border};
+            border-radius: 8px;
+            padding: 3rem 4rem;
+            margin-bottom: 3rem;
+            min-height: 70vh;
+            display: flex;
+            flex-direction: column;
+            page-break-after: always;
+        }}
+        .slide-number {{
+            color: {text_muted};
+            font-size: 0.9rem;
+            margin-bottom: 1rem;
+            padding-bottom: 0.5rem;
+            border-bottom: 1px solid {border};
+        }}
+        .slide-content {{
+            flex: 1;
+        }}
+        h1 {{
+            font-size: 2.5rem;
+            margin-bottom: 1.5rem;
+            color: {primary};
+        }}
+        h2 {{
+            font-size: 2rem;
+            margin-bottom: 1.2rem;
+            color: {primary};
+        }}
+        h3 {{
+            font-size: 1.5rem;
+            margin-bottom: 1rem;
+            color: {text};
+        }}
+        p {{
+            font-size: 1.2rem;
+            line-height: 1.6;
+            margin-bottom: 1rem;
+        }}
+        ul, ol {{
+            margin: 1rem 0;
+            padding-left: 2rem;
+        }}
+        li {{
+            font-size: 1.2rem;
+            line-height: 1.6;
+            margin-bottom: 0.5rem;
+        }}
+        pre {{
+            background: {background};
+            border-radius: 4px;
+            padding: 1rem;
+            overflow-x: auto;
+            font-family: 'Fira Code', 'Consolas', monospace;
+            font-size: 1rem;
+            margin: 1rem 0;
+        }}
+        code {{
+            font-family: 'Fira Code', 'Consolas', monospace;
+            background: {background};
+            padding: 0.2rem 0.4rem;
+            border-radius: 3px;
+            font-size: 0.95em;
+        }}
+        pre code {{
+            padding: 0;
+            background: none;
+        }}
+        table {{
+            width: 100%;
+            border-collapse: collapse;
+            margin: 1rem 0;
+        }}
+        th, td {{
+            border: 1px solid {border};
+            padding: 0.75rem;
+            text-align: left;
+        }}
+        th {{
+            background: {background};
+        }}
+        blockquote {{
+            border-left: 4px solid {primary};
+            padding-left: 1rem;
+            margin: 1rem 0;
+            font-style: italic;
+            color: {text_muted};
+        }}
+        a {{
+            color: {primary};
+        }}
+        img {{
+            max-width: 100%;
+            height: auto;
+        }}
+        /* Multi-column layouts */
+        .columns {{
+            display: flex;
+            gap: 2rem;
+            align-items: flex-start;
+        }}
+        .columns > div {{
+            flex: 1;
+            min-width: 0;
+        }}
+        .notes {{
+            margin-top: 2rem;
+            padding: 1rem;
+            background: {background};
+            border-radius: 4px;
+            font-size: 0.9rem;
+            color: {text_muted};
+        }}
+        .notes-title {{
+            font-weight: bold;
+            margin-bottom: 0.5rem;
+        }}
+        @media print {{
+            .slide {{
+                break-inside: avoid;
+                page-break-inside: avoid;
+            }}
+            body {{
+                background: white;
+                color: black;
+            }}
+        }}
+    </style>
+</head>
+<body>
+    <div class="slides">
+{slides}
+    </div>
+</body>
+</html>
+"""
+
+SLIDE_TEMPLATE = """\
+        <div class="slide" id="slide-{num}">
+            <div class="slide-number">Slide {display_num} of {total}</div>
+            <div class="slide-content">
+{content}
+            </div>
+{notes}
+        </div>
+"""
+
+NOTES_TEMPLATE = """\
+            <div class="notes">
+                <div class="notes-title">Presenter Notes</div>
+{notes_content}
+            </div>
+"""
+
+
+def render_slide_to_html(content: str) -> str:
+    """Convert markdown content to basic HTML.
+
+    Args:
+        content: Markdown content of the slide.
+
+    Returns:
+        HTML string for the slide content.
+
+    """
+    try:
+        import markdown  # noqa: PLC0415
+
+        html = markdown.markdown(
+            content,
+            extensions=["tables", "fenced_code", "codehilite"],
+        )
+    except ImportError:
+        # Fallback: basic markdown-to-html conversion
+        import html as html_mod  # noqa: PLC0415
+
+        html = html_mod.escape(content)
+        # Basic transformations
+        html = html.replace("\n\n", "</p><p>")
+        html = f"<p>{html}</p>"
+
+    return html
+
+
+def export_to_html(
+    source: Path,
+    output: Path,
+    *,
+    theme: str = "dark",
+    include_notes: bool = False,
+) -> Path:
+    """Export presentation to HTML.
+
+    Args:
+        source: Path to the markdown presentation.
+        output: Path for the output HTML file.
+        theme: Theme to use for styling.
+        include_notes: Whether to include presenter notes.
+
+    Returns:
+        Path to the created HTML file.
+
+    Raises:
+        ExportError: If export fails.
+
+    """
+    if not source.exists():
+        msg = f"Source file not found: {source}"
+        raise ExportError(msg)
+
+    try:
+        presentation = parse_presentation(source)
+    except Exception as e:
+        msg = f"Failed to parse presentation: {e}"
+        raise ExportError(msg) from e
+
+    if presentation.total_slides == 0:
+        msg = "Presentation has no slides"
+        raise ExportError(msg)
+
+    theme_obj = get_theme(theme)
+
+    # Render each slide
+    slides_html = []
+    for i, slide in enumerate(presentation.slides):
+        # Use raw_content and clean with keep_divs=True to preserve column layouts
+        slide_content, _ = extract_notes(slide.raw_content)
+        cleaned_content = clean_marp_directives(slide_content, keep_divs=True)
+        content_html = render_slide_to_html(cleaned_content)
+
+        # Handle notes
+        notes_html = ""
+        if include_notes and slide.notes:
+            notes_content = render_slide_to_html(slide.notes)
+            notes_html = NOTES_TEMPLATE.format(notes_content=notes_content)
+
+        slide_html = SLIDE_TEMPLATE.format(
+            num=i,
+            display_num=i + 1,
+            total=presentation.total_slides,
+            content=content_html,
+            notes=notes_html,
+        )
+        slides_html.append(slide_html)
+
+    # Build final HTML
+    title = presentation.title or source.stem
+    html = HTML_TEMPLATE.format(
+        title=title,
+        background=theme_obj.background,
+        surface=theme_obj.surface,
+        text=theme_obj.text,
+        text_muted=theme_obj.text_muted,
+        primary=theme_obj.primary,
+        border=theme_obj.text_muted,
+        slides="\n".join(slides_html),
+    )
+
+    try:
+        output.write_text(html)
+        return output
+    except Exception as e:
+        msg = f"Failed to write HTML: {e}"
+        raise ExportError(msg) from e
+
+
+def run_html_export(
+    source: str,
+    output: str | None = None,
+    *,
+    theme: str = "light",
+    include_notes: bool = False,
+) -> int:
+    """Run HTML export from command line.
+
+    Args:
+        source: Path to the markdown presentation (string).
+        output: Optional path for the output HTML (string).
+        theme: Theme to use for styling.
+        include_notes: Whether to include presenter notes.
+
+    Returns:
+        Exit code (0 for success).
+
+    """
+    import sys  # noqa: PLC0415
+
+    source_path = Path(source)
+    output_path = Path(output) if output else source_path.with_suffix(".html")
+
+    try:
+        result_path = export_to_html(
+            source_path,
+            output_path,
+            theme=theme,
+            include_notes=include_notes,
+        )
+        print(f"Exported to {result_path}")
+        return EXIT_SUCCESS
+    except ExportError as e:
+        print(f"error: {e}", file=sys.stderr)
+        return EXIT_FAILURE