from typing import Any, Sequence
from aiogram.types import InlineKeyboardMarkup
from modules.message_studio.models import BotMessageButton
from modules.message_studio.variable_resolver import VariableResolver
from modules.message_studio.button_builder import ButtonGridBuilder


DEFAULT_SYSTEM_TEMPLATES = {
    "welcome": {
        "title": "Default Welcome Screen",
        "message_text": "🙏 <b>Welcome, {first_name}!</b>\n\nWelcome to our premium service. Choose an option below:",
        "parse_mode": "HTML",
        "media_type": "none",
        "media_file_id": None,
        "buttons": [
            {"text": "💎 Buy Premium", "button_type": "callback_data", "action_value": "action:buy_premium", "row_position": 0, "column_position": 0, "sort_order": 0},
            {"text": "👤 My Account", "button_type": "callback_data", "action_value": "action:account", "row_position": 1, "column_position": 0, "sort_order": 0},
            {"text": "📞 Support", "button_type": "callback_data", "action_value": "action:support", "row_position": 1, "column_position": 1, "sort_order": 1},
            {"text": "🌐 Website", "button_type": "url", "action_value": "https://example.com", "row_position": 2, "column_position": 0, "sort_order": 0},
        ],
    },
    "help": {
        "title": "Default Help Screen",
        "message_text": "❓ <b>Need Assistance?</b>\n\nUse the buttons below to contact support or view documentation.",
        "parse_mode": "HTML",
        "media_type": "none",
        "media_file_id": None,
        "buttons": [
            {"text": "📞 Contact Support", "button_type": "callback_data", "action_value": "action:support", "row_position": 0, "column_position": 0, "sort_order": 0},
            {"text": "📖 FAQ", "button_type": "url", "action_value": "https://example.com/faq", "row_position": 0, "column_position": 1, "sort_order": 1},
        ],
    },
    "profile": {
        "title": "Default User Profile",
        "message_text": "👤 <b>User Profile</b>\n\n<b>Name:</b> {first_name}\n<b>Username:</b> @{username}\n<b>Plan:</b> {plan_name}\n<b>Token Balance:</b> {balance}",
        "parse_mode": "HTML",
        "media_type": "none",
        "media_file_id": None,
        "buttons": [
            {"text": "💎 Upgrade Plan", "button_type": "callback_data", "action_value": "action:upgrade", "row_position": 0, "column_position": 0, "sort_order": 0},
            {"text": "🎁 Refer Friends", "button_type": "callback_data", "action_value": "action:referral", "row_position": 0, "column_position": 1, "sort_order": 1},
        ],
    },
}


class TemplateRenderer:
    @staticmethod
    def interpolate_text(template_text: str, variables: dict[str, Any] | None = None) -> str:
        """Safely replaces `{var_name}` placeholders without crashing if variables are missing."""
        return VariableResolver.resolve(template_text, variables)

    @staticmethod
    def build_keyboard_matrix(
        buttons: Sequence[BotMessageButton | dict[str, Any]],
    ) -> list[list[dict[str, str]]]:
        """
        Organizes button list into 2D row/column grid based on row_position and column_position.
        """
        return ButtonGridBuilder.build_matrix(buttons)

    @classmethod
    def to_aiogram_keyboard(
        cls,
        buttons: Sequence[BotMessageButton | dict[str, Any]],
    ) -> InlineKeyboardMarkup | None:
        """Converts template button definitions to an Aiogram 3 InlineKeyboardMarkup."""
        return ButtonGridBuilder.to_aiogram(buttons)
