from dataclasses import dataclass
from typing import Any, Dict, List, Protocol

import matplotlib.pyplot as plt
from matplotlib.axes import Axes
from matplotlib.font_manager import FontProperties


@dataclass
class Frame:
    title: str

    def render(self, ax: Axes, mono_font: FontProperties) -> None:
        raise NotImplementedError

@dataclass
class BigFrame:
    """
    Nimmt eine halbe PDF-Seite ein (Renderer packt 2 BigFrames pro Seite).
    """
    title: str

    def render(self, ax: Axes, mono_font: FontProperties) -> None:
        raise NotImplementedError

@dataclass
class ModuleResult:
    summary_text: str               # NEU: wird im Hauptprogramm in die Konsole gedruckt
    frames: List[Frame]             # Kacheln (optional)
    bigframes: List[BigFrame]
    pages: List[plt.Figure]         # Vollseiten (optional)


class Module(Protocol):
    name: str

    def process(self, df, context: Dict[str, Any]) -> ModuleResult:
        ...