from typing import Any, Optional, Sequence
from modules.message_studio.button_builder import ButtonGridBuilder
from modules.message_studio.models import BotMessageButton, BotMessageTemplate
from modules.message_studio.schemas import ButtonSchema, PreviewButton, PreviewResponse
from modules.message_studio.validators import MessageValidator
from modules.message_studio.variable_resolver import VariableResolver


class PreviewService:
    """
    Renders live Telegram previews with variable interpolation, button grid ordering,
    and validation diagnostics.
    """

    @classmethod
    def render_preview(
        cls,
        message_text: str,
        buttons: Sequence[BotMessageButton | ButtonSchema | dict[str, Any]],
        parse_mode: str = "HTML",
        media_type: str = "none",
        media_file_id: Optional[str] = None,
        variables: Optional[dict[str, Any]] = None,
        validate: bool = True,
    ) -> PreviewResponse:
        # 1. Interpolate variables
        rendered_text = VariableResolver.resolve(message_text, variables)

        # 2. Validate if requested
        if validate:
            if parse_mode.upper() == "HTML":
                MessageValidator.validate_html(rendered_text)
            MessageValidator.validate_length(rendered_text, media_type=media_type)

        # 3. Build keyboard matrix
        matrix = ButtonGridBuilder.build_matrix(buttons)
        preview_keyboard = [
            [
                PreviewButton(
                    text=btn["text"],
                    button_type=btn["button_type"],
                    action_value=btn["action_value"],
                )
                for btn in row
            ]
            for row in matrix
        ]

        return PreviewResponse(
            rendered_text=rendered_text,
            parse_mode=parse_mode,
            media_type=media_type,
            media_file_id=media_file_id,
            keyboard=preview_keyboard,
        )

    @classmethod
    def preview_template(
        cls,
        template: BotMessageTemplate,
        variables: Optional[dict[str, Any]] = None,
        validate: bool = False,
    ) -> PreviewResponse:
        return cls.render_preview(
            message_text=template.message_text,
            buttons=template.buttons,
            parse_mode=template.parse_mode,
            media_type=template.media_type,
            media_file_id=template.media_file_id,
            variables=variables,
            validate=validate,
        )
