import re
from typing import Optional


class EmojiManager:
    """
    Manages Telegram Custom Emoji embedding, shortcode parsing, and HTML/Markdown generation.
    Supports Telegram Premium Custom Emojis with custom_emoji_id (stored as string to preserve 64-bit precision).
    """

    SHORTCODE_PATTERN = re.compile(r":([a-zA-Z0-9_-]+):")

    @classmethod
    def format_html(cls, custom_emoji_id: str, fallback_char: str = "⭐") -> str:
        """
        Formats custom emoji for Telegram HTML parse mode.
        Example: `<tg-emoji emoji-id="5368324170671202286">🐸</tg-emoji>`
        """
        clean_id = str(custom_emoji_id).strip()
        return f'<tg-emoji emoji-id="{clean_id}">{fallback_char}</tg-emoji>'

    @classmethod
    def format_markdown(cls, custom_emoji_id: str, fallback_char: str = "⭐") -> str:
        """
        Formats custom emoji for Telegram MarkdownV2 parse mode.
        Example: `![🐸](tg://emoji?id=5368324170671202286)`
        """
        clean_id = str(custom_emoji_id).strip()
        return f"![{fallback_char}](tg://emoji?id={clean_id})"

    @classmethod
    def replace_shortcodes(
        cls,
        text: str,
        emoji_map: dict[str, tuple[str, str]],
        parse_mode: str = "HTML",
    ) -> str:
        """
        Replaces `:shortcode:` with Telegram custom emoji tags.
        `emoji_map`: dict mapping shortcode -> (custom_emoji_id, fallback_char)
        """
        if not emoji_map:
            return text

        def replacer(match: re.Match) -> str:
            code = match.group(1)
            if code in emoji_map:
                emoji_id, fallback = emoji_map[code]
                if parse_mode.upper() == "HTML":
                    return cls.format_html(emoji_id, fallback)
                elif parse_mode.upper() == "MARKDOWNV2":
                    return cls.format_markdown(emoji_id, fallback)
            return match.group(0)

        return cls.SHORTCODE_PATTERN.sub(replacer, text)
