-- KeyVote.lua
-- Feature: Group vote on which Mythic+ keystone to run
-- State machine, event wiring, feature registration

-- Get namespace reference
local QoL = Fuloh_QoL
if not QoL then
    error("Fuloh_QoL namespace not found. Core.lua must load first.")
    return
end

-- Create feature object
local KeyVote = {
    name = "KeyVote",
    label = "Key Vote",
    tooltip = "Opens a group vote to decide which Mythic+ keystone to run next.",
    shortcut = "vote",
    isEnabled = false,
    alwaysEnabled = true,
}

-- Constants and Comms references (populated in Initialize)
local C, L
local SendStart, SendKey, SendVote, SendCancel, SendPing, SendPong, ParseMessage
local SendWheelOpen, SendSpin
local ShowVotingPopup, UpdateVotingPopup, LockVotingPopup, UpdateWaitingCount
local HideVotingPopup, ShowResults, HideResults
local ShowSetupPopup, UpdateSetupKeys, UpdateSetupPlayers, HideSetupPopup
local ShowWheelPopup, StartWheelSpin, HideWheelPopup
local TestWheelUI

-- Private state
local eventFrame = CreateFrame("Frame")

local STATE_IDLE    = "IDLE"
local STATE_VOTING  = "VOTING"
local STATE_RESULTS = "RESULTS"
local STATE_WHEEL   = "WHEEL"

local session = {
    id = "",
    state = STATE_IDLE,
    initiator = "",
    startTime = 0,
    participants = {},    -- { [playerName] = { mapID=N, level=N, name="..." } }
    votes = {},           -- { [playerName] = { "mapID-level", ... } }
    myVoteSubmitted = false,
    timerHandle = nil,
    resultsTimerHandle = nil,
    wheelDungeons    = nil,   -- {{name, spellID, mapID}, ...}
    wheelTimerHandle = nil,   -- 90-second safety timer (non-initiators)
}

-- Private setup state
local setupPingID = nil
local setupPlayers = {}   -- { [playerName] = { mapID, level, name } }

-- Forward declarations for functions referenced before definition
local StartVote, DismissResults, HandlePing, HandlePong

-- Color codes
local COLOR_PREFIX  = "|cff00bfff"
local COLOR_RESET   = "|r"
local COLOR_SUCCESS = "|cff44ff44"
local COLOR_GOLD    = "|cffffff00"

local function Print(msg)
    print(COLOR_PREFIX .. "[Key Vote]" .. COLOR_RESET .. " " .. msg)
end

-- Database accessor
local function GetDB()
    return Fuloh_QoLDB and Fuloh_QoLDB.KeyVote or {}
end

-- ResolveDungeonInfo reference (populated in Initialize)
local ResolveDungeonInfo

--------------------------------------------------------------------------------
-- Keystone Detection (local player)
--------------------------------------------------------------------------------

-- Scan bags for keystone display name (fallback when C_ChallengeMode returns nil).
-- Locale-independent: detects keystones via |Hkeystone: hyperlink tag, then strips
-- the localized prefix (e.g. "Keystone: " / "Clé de voûte : ") and level suffix.
local function ScanKeystoneName()
    for bag = 0, NUM_BAG_SLOTS do
        for slot = 1, C_Container.GetContainerNumSlots(bag) do
            local info = C_Container.GetContainerItemInfo(bag, slot)
            if info and info.hyperlink and info.hyperlink:find("|Hkeystone:", 1, true) then
                local displayName = info.hyperlink:match("%[(.+)%]")
                if displayName then
                    -- Strip everything up to and including the first ": " (works for all locales)
                    local name = displayName:match("^.+:%s*(.+)$") or displayName
                    -- Strip level suffix like " [10]"
                    name = name:gsub("%s*%[%d+%]$", "")
                    return name
                end
            end
        end
    end
    return nil
end

local function GetOwnKeystone()
    local mapID = C_MythicPlus.GetOwnedKeystoneMapID()
    local level = C_MythicPlus.GetOwnedKeystoneLevel()

    if not mapID or mapID == 0 or not level or level == 0 then
        return 0, 0, nil
    end

    -- Get display name: try C_ChallengeMode first, then bag scan
    local name = C_ChallengeMode.GetMapUIInfo(mapID)
    if not name then
        name = ScanKeystoneName()
    end

    return mapID, level, name
end

--------------------------------------------------------------------------------
-- Session Helpers
--------------------------------------------------------------------------------

local function ResetSession()
    if session.timerHandle then
        session.timerHandle:Cancel()
        session.timerHandle = nil
    end
    if session.resultsTimerHandle then
        session.resultsTimerHandle:Cancel()
        session.resultsTimerHandle = nil
    end
    session.id = ""
    session.state = STATE_IDLE
    session.initiator = ""
    session.startTime = 0
    session.participants = {}
    session.votes = {}
    session.myVoteSubmitted = false
    session.wheelDungeons    = nil
    session.wheelTimerHandle = nil
end

-- Get the local player's name (without realm if same server)
local function GetPlayerName()
    local name = UnitName("player")
    return name or "Unknown"
end

-- Count participants and voters
local function GetParticipantCount()
    local count = 0
    for _ in pairs(session.participants) do count = count + 1 end
    return count
end

local function GetVoteCount()
    local count = 0
    for _ in pairs(session.votes) do count = count + 1 end
    return count
end

-- Build sorted keystone list from participants for UI display.
-- Groups by mapID-level, aggregates owner names.
local function BuildKeystoneList()
    local keyMap = {}  -- { ["mapID-level"] = { mapID, level, name, owners={} } }
    local order = {}   -- insertion order

    for playerName, data in pairs(session.participants) do
        local keyID = data.mapID .. "-" .. data.level
        if not keyMap[keyID] then
            keyMap[keyID] = {
                keyID = keyID,
                mapID = data.mapID,
                level = data.level,
                name = data.name,
                owners = {},
            }
            order[#order + 1] = keyID
        end
        local owners = keyMap[keyID].owners
        owners[#owners + 1] = playerName
    end

    -- Sort: real keys first (by level desc), then no-key entries
    local result = {}
    for _, keyID in ipairs(order) do
        result[#result + 1] = keyMap[keyID]
    end
    table.sort(result, function(a, b)
        if a.mapID == 0 and b.mapID ~= 0 then return false end
        if a.mapID ~= 0 and b.mapID == 0 then return true end
        if a.level ~= b.level then return a.level > b.level end
        return (a.name or "") < (b.name or "")
    end)

    return result
end

-- Tally votes and produce results.
-- Returns sorted array of { keyID, mapID, level, name, voteCount, isWinner }
local function TallyVotes()
    local tally = {}  -- { ["mapID-level"] = count }

    for _, selectedKeys in pairs(session.votes) do
        for _, keyID in ipairs(selectedKeys) do
            tally[keyID] = (tally[keyID] or 0) + 1
        end
    end

    -- Find max votes
    local maxVotes = 0
    for _, count in pairs(tally) do
        if count > maxVotes then maxVotes = count end
    end

    -- Build results from participant keystones (only real keys)
    local results = {}
    local seen = {}
    for _, data in pairs(session.participants) do
        if data.mapID ~= 0 then
            local keyID = data.mapID .. "-" .. data.level
            if not seen[keyID] then
                seen[keyID] = true
                local count = tally[keyID] or 0
                results[#results + 1] = {
                    keyID = keyID,
                    mapID = data.mapID,
                    level = data.level,
                    name = data.name,
                    voteCount = count,
                    isWinner = (count > 0 and count == maxVotes),
                }
            end
        end
    end

    -- Sort by vote count desc
    table.sort(results, function(a, b)
        if a.voteCount ~= b.voteCount then return a.voteCount > b.voteCount end
        return a.level > b.level
    end)

    return results
end

--------------------------------------------------------------------------------
-- State Transitions
--------------------------------------------------------------------------------

local function TransitionToResults()
    session.state = STATE_RESULTS

    if session.timerHandle then
        session.timerHandle:Cancel()
        session.timerHandle = nil
    end

    HideVotingPopup()

    local results = TallyVotes()
    ShowResults(results)

    -- Print local summary
    if #results > 0 and results[1].voteCount > 0 then
        local winner = results[1]
        local name = winner.name or C_ChallengeMode.GetMapUIInfo(winner.mapID) or "?"
        local totalVoters = GetVoteCount()
        Print(COLOR_GOLD .. name .. " +" .. winner.level .. COLOR_RESET .. " " .. L["wins"] .. " (" .. winner.voteCount .. "/" .. totalVoters .. " " .. L["votes"] .. ")")
    else
        Print(L["No active vote"])
    end

    -- Results stay visible until the user clicks to dismiss (no auto-hide)
end

DismissResults = function()
    HideResults()
    ResetSession()
end

local function CheckAllVoted()
    if session.state ~= STATE_VOTING then return end

    local participantCount = GetParticipantCount()
    local voteCount = GetVoteCount()

    if voteCount >= participantCount and participantCount > 0 then
        TransitionToResults()
    end
end

--------------------------------------------------------------------------------
-- Protocol Handlers
--------------------------------------------------------------------------------

local function HandleStart(senderName, msg)
    if session.state ~= STATE_IDLE then return end

    session.id = msg.sessionID
    session.state = STATE_VOTING
    session.initiator = senderName
    session.startTime = GetTime()
    session.duration = msg.duration or C.VOTE_DURATION
    session.participants = {}
    session.votes = {}
    session.myVoteSubmitted = false

    -- Send own key (including name so other clients can use it)
    local mapID, level, name = GetOwnKeystone()
    SendKey(session.id, mapID, level, name)

    -- Add self as participant immediately
    session.participants[GetPlayerName()] = { mapID = mapID, level = level, name = name }

    -- Show voting popup
    local keystones = BuildKeystoneList()
    ShowVotingPopup(session, keystones)

    -- Start vote timer
    session.timerHandle = C_Timer.NewTimer(session.duration, function()
        if session.state == STATE_VOTING then
            TransitionToResults()
        end
    end)
end

local function HandleKey(senderName, msg)
    if session.state ~= STATE_VOTING then return end
    if msg.sessionID ~= session.id then return end

    -- Resolve display name: prefer sender's name (from protocol), then local resolution,
    -- then keep any existing name we already have for this participant.
    local displayName = msg.name
    if not displayName and msg.mapID ~= 0 then
        displayName = ResolveDungeonInfo(msg.mapID)
    end
    local existing = session.participants[senderName]
    if not displayName and existing then
        displayName = existing.name
    end

    session.participants[senderName] = {
        mapID = msg.mapID,
        level = msg.level,
        name = displayName,
    }

    -- Update UI
    local keystones = BuildKeystoneList()
    UpdateVotingPopup(session, keystones)
end

local function HandleVote(senderName, msg)
    if session.state ~= STATE_VOTING then return end
    if msg.sessionID ~= session.id then return end

    -- Record vote (use event sender, not payload)
    session.votes[senderName] = msg.selectedKeys

    -- Update waiting count in UI
    local voteCount = GetVoteCount()
    local totalCount = GetParticipantCount()
    UpdateWaitingCount(voteCount, totalCount)

    CheckAllVoted()
end

local function HandleCancel(senderName, msg)
    if session.state == STATE_IDLE then return end
    if msg.sessionID ~= session.id then return end

    if session.state == STATE_WHEEL then
        if session.wheelTimerHandle then
            session.wheelTimerHandle:Cancel()
            session.wheelTimerHandle = nil
        end
        HideWheelPopup()
    end

    HideVotingPopup()
    HideResults()
    ResetSession()
    Print(L["Vote cancelled"])
end

--------------------------------------------------------------------------------
-- Wheel: dungeon list builder
--------------------------------------------------------------------------------

local function BuildWheelDungeonList()
    local seen   = {}
    local result = {}

    local getSpell = QoL.Features.JoinedGroupReminder_GetDungeonTeleportSpellByMapID

    -- Track max level per mapID (multiple players may hold the same dungeon)
    local maxLevel = {}

    for _, data in pairs(setupPlayers) do
        local mapID = data.mapID
        if mapID and mapID ~= 0 then
            local lvl = data.level or 0
            if not seen[mapID] then
                seen[mapID]     = true
                maxLevel[mapID] = lvl
                local name    = data.name or ResolveDungeonInfo(mapID)
                local spellID = getSpell and getSpell(mapID)
                result[#result + 1] = { name = name, spellID = spellID, mapID = mapID, level = lvl }
            elseif lvl > maxLevel[mapID] then
                -- Update level to the higher of the two
                maxLevel[mapID] = lvl
                for _, d in ipairs(result) do
                    if d.mapID == mapID then d.level = lvl; break end
                end
            end
        end
    end

    -- Fallback: if every player has no key, include the initiator's entry anyway
    if #result == 0 then
        local playerName = GetPlayerName()
        local data = setupPlayers[playerName]
        if data then
            local name    = data.name or ResolveDungeonInfo(data.mapID or 0)
            local spellID = getSpell and data.mapID and getSpell(data.mapID)
            result[1] = { name = name or "?", spellID = spellID, mapID = data.mapID or 0, level = data.level or 0 }
        end
    end

    return result
end

--------------------------------------------------------------------------------
-- Wheel: callbacks
--------------------------------------------------------------------------------

local function OnWheelDone(winnerIndex)
    local d = session.wheelDungeons and session.wheelDungeons[winnerIndex]
    if not d then return end

    session.state = STATE_RESULTS

    local level = d.level or 0
    local fakeResults = {{
        keyID     = tostring(d.mapID) .. "-" .. level,
        mapID     = d.mapID,
        level     = level,
        name      = d.name,
        voteCount = 1,
        isWinner  = true,
    }}
    HideWheelPopup()
    ShowResults(fakeResults)
    Print(COLOR_GOLD .. (d.name or "?") .. COLOR_RESET .. " wins the spin!")
end

local function OnSetupSpin()
    HideSetupPopup()
    setupPingID  = nil
    local playerName = GetPlayerName()
    local sessionID  = playerName .. "-wheel-" .. math.floor(GetTime())

    local dungeons = BuildWheelDungeonList()
    setupPlayers   = {}   -- no longer needed; clear now

    session.id            = sessionID
    session.initiator     = playerName
    session.state         = STATE_WHEEL
    session.wheelDungeons = dungeons

    SendWheelOpen(sessionID, dungeons)

    ShowWheelPopup(dungeons, true,
        function(tSpin, dur)             -- onSpinRequested
            SendSpin(sessionID, tSpin, dur)
            StartWheelSpin(tSpin, dur)   -- start locally immediately
        end,
        OnWheelDone
    )
end

--------------------------------------------------------------------------------
-- Wheel: protocol handlers
--------------------------------------------------------------------------------

local function HandleWheelOpen(senderName, msg)
    if session.state ~= STATE_IDLE then return end

    session.id        = msg.sessionID
    session.initiator = senderName
    session.state     = STATE_WHEEL

    local getSpell = QoL.Features.JoinedGroupReminder_GetDungeonTeleportSpellByMapID
    local dungeons = {}
    for _, entry in ipairs(msg.dungeons) do
        local spellID = getSpell and getSpell(entry.mapID)
        -- entry.name comes from the initiator (already resolved); fall back to local only as last resort
        local name = entry.name ~= "" and entry.name or ResolveDungeonInfo(entry.mapID)
        dungeons[#dungeons + 1] = { name = name, mapID = entry.mapID, spellID = spellID, level = entry.level }
    end
    session.wheelDungeons = dungeons

    -- Safety timer: hide wheel if initiator never clicks Spin
    session.wheelTimerHandle = C_Timer.NewTimer(90, function()
        if session.state == STATE_WHEEL then
            HideWheelPopup()
            ResetSession()
        end
    end)

    ShowWheelPopup(dungeons, false, nil, OnWheelDone)
end

local function HandleSpin(senderName, msg)
    if session.state ~= STATE_WHEEL then return end
    if msg.sessionID ~= session.id then return end
    StartWheelSpin(msg.targetSpin, msg.spinDuration)
end

--------------------------------------------------------------------------------
-- Event Handlers
--------------------------------------------------------------------------------

local function OnChatMsgAddon(prefix, payload, _, senderName)
    if prefix ~= C.ADDON_PREFIX then return end
    if not KeyVote.isEnabled then return end

    -- Strip realm name if present (e.g., "Player-Realm" -> "Player")
    local shortName = senderName:match("^([^-]+)") or senderName

    local msg = ParseMessage(payload)
    if not msg then return end

    if msg.opcode == C.OPCODE_START then
        HandleStart(shortName, msg)
    elseif msg.opcode == C.OPCODE_KEY then
        HandleKey(shortName, msg)
    elseif msg.opcode == C.OPCODE_VOTE then
        HandleVote(shortName, msg)
    elseif msg.opcode == C.OPCODE_CANCEL then
        HandleCancel(shortName, msg)
    elseif msg.opcode == C.OPCODE_PING then
        HandlePing(shortName, msg)
    elseif msg.opcode == C.OPCODE_PONG then
        HandlePong(shortName, msg)
    elseif msg.opcode == C.OPCODE_WHEELOPEN then
        HandleWheelOpen(shortName, msg)
    elseif msg.opcode == C.OPCODE_SPIN then
        HandleSpin(shortName, msg)
    end
end

local function OnGroupRosterUpdate()
    if session.state == STATE_IDLE then return end

    -- If we left the group entirely, cancel
    if not IsInGroup() then
        if session.state == STATE_WHEEL then
            if session.wheelTimerHandle then
                session.wheelTimerHandle:Cancel()
                session.wheelTimerHandle = nil
            end
            HideWheelPopup()
        end
        HideVotingPopup()
        HideResults()
        ResetSession()
        return
    end

    -- Remove participants who left the group
    local groupMembers = {}
    local numMembers = GetNumGroupMembers()
    for i = 1, numMembers do
        local name = GetRaidRosterInfo(i)
        if name then
            local shortName = name:match("^([^-]+)") or name
            groupMembers[shortName] = true
        end
    end

    local removed = false
    for playerName in pairs(session.participants) do
        if not groupMembers[playerName] then
            session.participants[playerName] = nil
            session.votes[playerName] = nil
            removed = true
        end
    end

    if removed and session.state == STATE_VOTING then
        local keystones = BuildKeystoneList()
        UpdateVotingPopup(session, keystones)
        CheckAllVoted()
    end
end

local function OnChatMsgParty(msg, senderName)
    if not KeyVote.isEnabled then return end

    local db = GetDB()
    if not db.enableChatTrigger then return end

    -- Only react to own messages
    local playerName = GetPlayerName()
    local shortSender = senderName:match("^([^-]+)") or senderName
    if shortSender ~= playerName then return end

    local lower = msg:lower()
    if lower == "!vote" or lower == "!keyvote" then
        StartVote()
    end
end

local function OnEvent(self, event, ...)
    if event == "CHAT_MSG_ADDON" then
        OnChatMsgAddon(...)
    elseif event == "GROUP_ROSTER_UPDATE" then
        OnGroupRosterUpdate()
    elseif event == "CHAT_MSG_PARTY" or event == "CHAT_MSG_PARTY_LEADER" then
        OnChatMsgParty(...)
    end
end

--------------------------------------------------------------------------------
-- Vote Actions
--------------------------------------------------------------------------------

StartVote = function(duration)
    if session.state ~= STATE_IDLE then
        Print(L["Already active"])
        return
    end

    if not IsInGroup() then
        Print(L["Not in group"])
        return
    end

    local playerName = GetPlayerName()
    local sessionID = playerName .. "-" .. math.floor(GetTime())
    local voteDuration = duration or C.VOTE_DURATION

    -- Broadcast KVSTART (with duration)
    SendStart(sessionID, voteDuration)

    -- Handle our own start directly for immediate UI response.
    -- The duplicate from CHAT_MSG_ADDON is safely ignored (state already VOTING).
    HandleStart(playerName, { opcode = C.OPCODE_START, sessionID = sessionID, duration = voteDuration })
end

local function CancelVote()
    if session.state == STATE_IDLE then
        Print(L["No active vote"])
        return
    end

    if session.initiator ~= GetPlayerName() then
        Print("Only the initiator can cancel the vote.")
        return
    end

    SendCancel(session.id)
    HideVotingPopup()
    HideResults()
    ResetSession()
    Print(L["Vote cancelled"])
end

--------------------------------------------------------------------------------
-- Setup Window
--------------------------------------------------------------------------------

-- Build a sorted keystone list from setupPlayers (same shape as BuildKeystoneList)
local function BuildSetupKeystoneList()
    local keyMap = {}
    local order = {}

    for playerName, data in pairs(setupPlayers) do
        local keyID = data.mapID .. "-" .. data.level
        if not keyMap[keyID] then
            keyMap[keyID] = {
                keyID  = keyID,
                mapID  = data.mapID,
                level  = data.level,
                name   = data.name,
                owners = {},
            }
            order[#order + 1] = keyID
        end
        local owners = keyMap[keyID].owners
        owners[#owners + 1] = playerName
    end

    local result = {}
    for _, keyID in ipairs(order) do
        result[#result + 1] = keyMap[keyID]
    end
    table.sort(result, function(a, b)
        if a.mapID == 0 and b.mapID ~= 0 then return false end
        if a.mapID ~= 0 and b.mapID == 0 then return true end
        if a.level ~= b.level then return a.level > b.level end
        return (a.name or "") < (b.name or "")
    end)

    return result
end

local function OpenSetupWindow()
    if session.state ~= STATE_IDLE then
        Print(L["Already active"])
        return
    end

    if not IsInGroup() then
        Print(L["Not in group"])
        return
    end

    -- Clear any stale setup state
    setupPingID = nil
    setupPlayers = {}

    local playerName = GetPlayerName()
    local mapID, level, name = GetOwnKeystone()

    setupPlayers[playerName] = { mapID = mapID, level = level, name = name }
    setupPingID = playerName .. "-setup-" .. math.floor(GetTime())

    ShowSetupPopup(playerName, mapID, level, name)
    SendPing(setupPingID)
end

HandlePing = function(senderName, msg)
    -- Only respond if we did not open the setup window ourselves.
    -- (If setupPingID ~= nil we are the initiator; own-echo is also suppressed here.)
    if setupPingID ~= nil then return end

    local mapID, level, name = GetOwnKeystone()
    SendPong(msg.pingID, mapID, level, name)
end

HandlePong = function(senderName, msg)
    if msg.pingID ~= setupPingID then return end

    setupPlayers[senderName] = { mapID = msg.mapID, level = msg.level, name = msg.name }
    UpdateSetupKeys(BuildSetupKeystoneList())
    UpdateSetupPlayers(setupPlayers)
end

local function OnSetupStart(duration)
    HideSetupPopup()
    setupPingID = nil
    setupPlayers = {}
    StartVote(duration)
end

local function OnSetupClose()
    HideSetupPopup()
    setupPingID = nil
    setupPlayers = {}
end

local function TestSetupUI()
    ShowSetupPopup(GetPlayerName(), 2660, 10, "Ara-Kara, City of Echoes")
    Print("Test setup UI shown.")
end

local function OnLocalVoteSubmit(selectedKeys)
    if session.state ~= STATE_VOTING then return end
    if session.myVoteSubmitted then return end

    session.myVoteSubmitted = true

    -- Broadcast our vote
    SendVote(session.id, selectedKeys)

    -- Record locally
    session.votes[GetPlayerName()] = selectedKeys

    -- Lock UI
    local voteCount = GetVoteCount()
    local totalCount = GetParticipantCount()
    LockVotingPopup(voteCount, totalCount)

    CheckAllVoted()
end

local function OnLocalVoteClose()
    if session.state ~= STATE_VOTING then return end

    -- If initiator, cancel for everyone
    if session.initiator == GetPlayerName() then
        CancelVote()
    else
        -- Non-initiator: just hide locally (counts as abstain)
        HideVotingPopup()
    end
end

--------------------------------------------------------------------------------
-- Test Commands (debug UI preview)
--------------------------------------------------------------------------------

local function TestVotingUI()
    local fakeSession = {
        initiator = GetPlayerName(),
        startTime = GetTime(),
    }
    local fakeKeystones = {
        { keyID = "2660-10", mapID = 2660, level = 10, name = "Ara-Kara, City of Echoes", owners = { "PlayerA", "PlayerC" } },
        { keyID = "2652-12", mapID = 2652, level = 12, name = "The Stonevault", owners = { "PlayerB" } },
        { keyID = "2661-8",  mapID = 2661, level = 8,  name = "Cinderbrew Meadery", owners = { "PlayerD" } },
        { keyID = "0-0",     mapID = 0,    level = 0,  name = nil, owners = { "PlayerE" } },
    }
    ShowVotingPopup(fakeSession, fakeKeystones)
    Print("Test voting UI shown. Close with X or ESC.")
end

local function TestResultsUI()
    local fakeResults = {
        { keyID = "2652-12", mapID = 2652, level = 12, name = "The Stonevault", voteCount = 3, isWinner = true },
        { keyID = "2660-10", mapID = 2660, level = 10, name = "Ara-Kara, City of Echoes", voteCount = 2, isWinner = false },
        { keyID = "2661-8",  mapID = 2661, level = 8,  name = "Cinderbrew Meadery", voteCount = 1, isWinner = false },
    }
    ShowResults(fakeResults)
    Print("Test results UI shown. Click to dismiss.")
end

--------------------------------------------------------------------------------
-- Feature API Implementation
--------------------------------------------------------------------------------

function KeyVote:Initialize()
    -- Get references to constants and helpers
    C = QoL.Features.KeyVote_Constants
    L = C.L
    ResolveDungeonInfo = QoL.Features.KeyVote_ResolveDungeonInfo

    -- Get references to comms functions
    SendStart    = QoL.Features.KeyVote_SendStart
    SendKey      = QoL.Features.KeyVote_SendKey
    SendVote     = QoL.Features.KeyVote_SendVote
    SendCancel   = QoL.Features.KeyVote_SendCancel
    SendPing     = QoL.Features.KeyVote_SendPing
    SendPong     = QoL.Features.KeyVote_SendPong
    SendWheelOpen = QoL.Features.KeyVote_SendWheelOpen
    SendSpin      = QoL.Features.KeyVote_SendSpin
    ParseMessage = QoL.Features.KeyVote_ParseMessage

    -- Get references to UI functions
    ShowVotingPopup    = QoL.Features.KeyVote_ShowVotingPopup
    UpdateVotingPopup  = QoL.Features.KeyVote_UpdateVotingPopup
    LockVotingPopup    = QoL.Features.KeyVote_LockVotingPopup
    UpdateWaitingCount = QoL.Features.KeyVote_UpdateWaitingCount
    HideVotingPopup    = QoL.Features.KeyVote_HideVotingPopup
    ShowResults        = QoL.Features.KeyVote_ShowResults
    HideResults        = QoL.Features.KeyVote_HideResults
    ShowSetupPopup     = QoL.Features.KeyVote_ShowSetupPopup
    UpdateSetupKeys    = QoL.Features.KeyVote_UpdateSetupKeys
    UpdateSetupPlayers = QoL.Features.KeyVote_UpdateSetupPlayers
    HideSetupPopup     = QoL.Features.KeyVote_HideSetupPopup
    ShowWheelPopup     = QoL.Features.KeyVote_ShowWheelPopup
    StartWheelSpin     = QoL.Features.KeyVote_StartWheelSpin
    HideWheelPopup     = QoL.Features.KeyVote_HideWheelPopup

    -- Register UI callbacks
    QoL.Features.KeyVote_SetVoteSubmitCallback(OnLocalVoteSubmit)
    QoL.Features.KeyVote_SetVoteCloseCallback(OnLocalVoteClose)
    QoL.Features.KeyVote_SetResultsDismissCallback(DismissResults)
    QoL.Features.KeyVote_SetSetupStartCallback(OnSetupStart)
    QoL.Features.KeyVote_SetSetupCloseCallback(OnSetupClose)
    QoL.Features.KeyVote_SetSetupSpinCallback(OnSetupSpin)

    TestWheelUI = QoL.Features.KeyVote_TestWheelUI

    -- Register addon message prefix (must be eager — messages before registration are dropped)
    C_ChatInfo.RegisterAddonMessagePrefix(C.ADDON_PREFIX)

    -- Pre-warm the M+ map data cache so C_ChallengeMode.GetMapUIInfo() returns data
    if C_MythicPlus and C_MythicPlus.RequestMapInfo then
        C_MythicPlus.RequestMapInfo()
    end
end

function KeyVote:Enable()
    self.isEnabled = true

    eventFrame:SetScript("OnEvent", OnEvent)
    eventFrame:RegisterEvent("CHAT_MSG_ADDON")
    eventFrame:RegisterEvent("GROUP_ROSTER_UPDATE")
    eventFrame:RegisterEvent("CHAT_MSG_PARTY")
    eventFrame:RegisterEvent("CHAT_MSG_PARTY_LEADER")
end

function KeyVote:Disable()
    self.isEnabled = false

    eventFrame:UnregisterAllEvents()
    eventFrame:SetScript("OnEvent", nil)

    -- Clean up any active session
    HideWheelPopup()
    HideVotingPopup()
    HideResults()
    ResetSession()
end

function KeyVote:GetDefaults()
    return {
        enableChatTrigger = true,
        votingPosition = nil,
        resultsPosition = nil,
        setupPosition = nil,
    }
end

function KeyVote:HandleCommand(args)
    local cmd = args:lower():match("^(%S+)") or args:lower()

    if cmd == "" or cmd == "start" then
        OpenSetupWindow()
    elseif cmd == "cancel" then
        CancelVote()
    elseif cmd == "test" then
        TestVotingUI()
    elseif cmd == "testresult" then
        TestResultsUI()
    elseif cmd == "testsetup" then
        TestSetupUI()
    elseif cmd == "wheeltest" then
        TestWheelUI()
    elseif cmd == "help" then
        Print("Commands:")
        print("  /fuloh vote            - Open vote setup window")
        print("  /fuloh vote cancel     - Cancel the current vote")
        print("  /fuloh vote test       - Preview the voting UI")
        print("  /fuloh vote testresult - Preview the results UI")
        print("  /fuloh vote testsetup  - Preview the setup window")
        print("  /fuloh vote wheeltest  - Preview the spinning wheel UI")
    else
        OpenSetupWindow()
    end
end

-- Register this feature
QoL:RegisterFeature(KeyVote)
