blocks.py

"""Block primitives. Receipt composers return lists of these; `printer.py` renders them."""

from dataclasses import dataclass


# ── List rows ────────────────────────────────────────────────────────────────

@dataclass
class Item:
    """Receipt row: name left, value right. `bold=True` for the column header.

    `name` and `value` are coerced to str, so a provider can return a number
    (e.g. Item("CPU TEMP", 47)) without breaking the receipt.
    """
    name: str
    value: str
    bold: bool = False

    def __post_init__(self):
        self.name = str(self.name)
        self.value = str(self.value)


@dataclass
class Checkbox:
    """Checklist item: '[ ] text' with hanging indent on wrap."""
    text: str


# ── Receipt accents ──────────────────────────────────────────────────────────

@dataclass
class Banner:
    """Black bar with white text, snug-fit around the text."""
    text: str


@dataclass
class Total:
    """Right-aligned 'LABEL: value'. `big=True` for the final TOTAL line."""
    label: str
    value: str
    big: bool = False


@dataclass
class Underline:
    """Centered text with thin lines hugging it top and bottom."""
    text: str


@dataclass
class Footer:
    """Final centered bold footer line."""
    text: str


@dataclass
class UpsideDown:
    """Text rasterized and rotated 180° — 'secret message from below'."""
    text: str


@dataclass
class Barcode:
    """Code128 barcode encoding `text`, centered."""
    text: str


# ── Structural ───────────────────────────────────────────────────────────────

@dataclass
class Divider:
    """Horizontal divider: 'dash', 'dot', or 'solid'."""
    style: str = "dash"


@dataclass
class Spacer:
    """Vertical gap in body-line heights."""
    lines: int = 1


Block = (
    Item | Checkbox |
    Banner | Total | Underline | Footer | UpsideDown | Barcode |
    Divider | Spacer
)