pdf/rendering/client_overlay.py

"""Metodo A — overlay lato client (PDF.js + div CSS).

Il rendering avviene nel browser usando /api/pdf/raw e /api/pdf/overlay: il
server non produce un'immagine. Questo metodo porta solo i metadati, cosi' da
comparire (o essere escluso) nello stesso registry degli altri.
"""

from __future__ import annotations

from pdf.rendering.base import MethodInfo, RenderKind, RenderMethod, RenderOutput, RenderParams


class ClientOverlayMethod(RenderMethod):
    info = MethodInfo(
        key="overlay",
        label="A · PDF.js + overlay",
        kind=RenderKind.CLIENT,
        media_type="application/json",
        styles=("fill", "outline"),
        default_style="fill",
        description=(
            "Rendering client-side con PDF.js e box come div CSS. "
            "Testo selezionabile; richiede la libreria PDF.js."
        ),
    )

    def render(self, params: RenderParams) -> RenderOutput:  # pragma: no cover
        raise NotImplementedError(
            "Il metodo 'overlay' e' renderizzato lato client (raw + overlay)."
        )