"""Static terminal mascot art for Omnigent startup banners."""

from __future__ import annotations

import hashlib
from typing import TypedDict


class MascotPayload(TypedDict):
    """
    Stable mascot art plus hex color for a given identity.

    :param lines: Multi-line ASCII mascot art.
    :param color: Hex color used to render the mascot,
        e.g. ``"#F43BA6"``.
    """

    lines: list[str]
    color: str


# Otto the starfish — a compact Braille (U+28xx) silhouette of a
# five-point star with two tall carved eyes, rasterized from a star
# polygon and packed two-dots-wide by four-dots-tall per cell. Replaces
# the old 29x12 PNG-converted blob with a 9x5 glyph that keeps the welcome
# box at header height. Blanks are the Braille blank (U+2800) so every row
# is a solid 9 cells wide.
MASCOT_ART_LINES: tuple[str, ...] = (
    "⠀⠀⠀⢠⣿⡄⠀⠀⠀",
    "⢴⣶⣶⠉⣿⠉⣶⣶⡦",
    "⠀⠙⣿⣶⣿⣶⣿⠋⠀",
    "⠀⢠⣿⡿⠿⢿⣿⡄⠀",
    "⠀⠈⠁⠀⠀⠀⠈⠁⠀",
)

MASCOT_ART_COL_WIDTH = max(len(line) for line in MASCOT_ART_LINES)

# Truecolor hex: must stay in sync with the interactive welcome ``Panel`` border in
# ``omnigent.cli``. Otto's starfish magenta-pink — the Omnigent brand accent.
MASCOT_ART_COLOR = "#F43BA6"


def random_mascot_color() -> str:
    """
    Return the brand color used for mascot glyphs.

    :returns: Hex color string for the Omnigent accent,
        e.g. ``"#F43BA6"``.
    """

    return MASCOT_ART_COLOR


def random_mascot_lines() -> list[str]:
    """
    Return the startup mascot ASCII art.

    The function name is kept for compatibility with the old procedural
    mascot API, but the TUI now uses the single static Omnigent mascot.

    :returns: The multi-row Otto-the-starfish mascot art.
    """

    return list(MASCOT_ART_LINES)


def mascot_payload_for_identity(agent_identity: str) -> MascotPayload:
    """
    Return stable mascot art and color for an arbitrary identity.

    The art is static. The color remains identity-derived for callers that
    use this payload outside the startup banner.

    :param agent_identity: Stable identity seed, e.g.
        ``"demo\\x00tool_a,tool_b\\x00You are a helper."``.
    :returns: Mascot payload containing static art and a hex color.
    """

    digest = hashlib.sha256(agent_identity.encode("utf-8")).digest()
    # Starfish magenta-pink range from hash bytes, centered on the brand
    # accent ``#F43BA6`` (244, 59, 166).
    r = 223 + (digest[8] % 33)
    g = 39 + (digest[9] % 40)
    b = 146 + (digest[10] % 40)
    color = f"#{r:02x}{g:02x}{b:02x}"
    return {"lines": list(MASCOT_ART_LINES), "color": color}