"""Engine errors and warnings."""

from __future__ import annotations

from dataclasses import dataclass, field
from typing import Any


class RenderError(Exception):
    """Permanent render failure with a stable machine-readable code (TZ 2.8.2)."""

    def __init__(self, code: str, message: str, details: list[dict[str, Any]] | None = None) -> None:
        super().__init__(f"{code}: {message}")
        self.code = code
        self.message = message
        self.details = details or []


class RenderTimeout(RenderError):
    def __init__(self, message: str = "Render deadline exceeded") -> None:
        super().__init__("RENDER_TIMEOUT", message)


class RenderCanceled(RenderError):
    def __init__(self) -> None:
        super().__init__("CANCELED", "Render canceled")


@dataclass
class Warnings:
    """Collects deduplicated, bounded render warnings (VAR_MISSING, TEXT_OVERFLOW, ...)."""

    limit: int = 200
    items: list[dict[str, Any]] = field(default_factory=list)
    _seen: set[tuple[Any, ...]] = field(default_factory=set)

    def add(self, code: str, **info: Any) -> None:
        key = (code, *sorted((k, str(v)) for k, v in info.items()))
        if key in self._seen or len(self.items) >= self.limit:
            return
        self._seen.add(key)
        self.items.append({"code": code, **info})
