Api.lua

-- Api.lua
-- @Author : Dencer (tdaddon@163.com)
-- @Link   : https://dengsir.github.io
-- @Date   : 10/18/2019, 1:11:20 PM
--
---- LUA
local _G = _G
local type, next = type, next
local pairs, ipairs = pairs, ipairs
local select = select
local format = string.format
local tinsert = table.insert
local tonumber = tonumber
local assert = assert
local unpack = unpack
local nop = nop

---- C
local C = LibStub('C_Everywhere')

---- WOW
local GetScreenHeight = GetScreenHeight
local GetScreenWidth = GetScreenWidth
local PlaySound = PlaySound
local Ambiguate = Ambiguate
local GetInventorySlotInfo = GetInventorySlotInfo
local GetGuildInfo = GetGuildInfo
local GetNormalizedRealmName = GetNormalizedRealmName
local GetRealmName = GetRealmName

---- UI
local GameTooltip = GameTooltip

---- G
local MAX_GUILDBANK_TABS = MAX_GUILDBANK_TABS
local RAID_CLASS_COLORS = RAID_CLASS_COLORS
local BACKPACK_CONTAINER = Enum.BagIndex.Backpack
local BANK_CONTAINER = Enum.BagIndex.Bank
local KEYRING_CONTAINER = Enum.BagIndex.Keyring
local NUM_BAG_SLOTS = NUM_TOTAL_EQUIPPED_BAG_SLOTS or Constants.InventoryConstants.NumBagSlots
local NUM_BANKBAGSLOTS = Constants.InventoryConstants.NumBankBagSlots
local EQUIP_CONTAINER = 'equip'
local MAIL_CONTAINER = 'mail'
local COD_CONTAINER = 'cod'

local GLOBAL_SEARCH_OWNER = '$search'

---@class ns
local ns = select(2, ...)

local BUILD = tonumber(GetBuildInfo():match('^(%d+)%.')) or 0

ns.BUILD_VANILLA = BUILD == 1
ns.BUILD_MAINLINE = BUILD >= 11

ns.FEATURE_GUILDBANK = BUILD >= 2
ns.FEATURE_CURRENCY = BUILD >= 3
ns.FEATURE_RUNE = BUILD == 1
ns.FEATURE_RANGED_WEAPON = BUILD < 5
ns.FEATURE_KEYRING = BUILD >= 2 and BUILD < 5

ns.VERSION = tonumber((C.AddOns.GetAddOnMetadata('tdBag2', 'Version'):gsub('(%d+)%.?', function(x)
    return format('%02d', tonumber(x))
end))) or 0

ns.DEFAULT_STYLE = 'Blizzard'

ns.EQUIP_CONTAINER = EQUIP_CONTAINER
ns.MAIL_CONTAINER = MAIL_CONTAINER
ns.COD_CONTAINER = COD_CONTAINER

ns.GLOBAL_SEARCH_OWNER = GLOBAL_SEARCH_OWNER

ns.ITEM_SIZE = 37
ns.ITEM_SPACING = 2

ns.SECONDS_OF_DAY = 24 * 60 * 60

ns.KEYRING_FAMILY = ns.BUILD_VANILLA and 9 or 256

ns.ITEM_BUTTON_CLASS = ns.BUILD_MAINLINE and 'ItemButton' or 'Button'

ns.LEFT_MOUSE_BUTTON = [[|TInterface\TutorialFrame\UI-Tutorial-Frame:12:12:0:0:512:512:10:65:228:283|t]]
ns.RIGHT_MOUSE_BUTTON = [[|TInterface\TutorialFrame\UI-Tutorial-Frame:12:12:0:0:512:512:10:65:330:385|t]]

ns.RACE_ICON_TCOORDS = ns.BUILD_VANILLA and {
    ['HUMAN_MALE'] = {0, 0.25, 0, 0.25},
    ['DWARF_MALE'] = {0.25, 0.5, 0, 0.25},
    ['GNOME_MALE'] = {0.5, 0.75, 0, 0.25},
    ['NIGHTELF_MALE'] = {0.75, 1.0, 0, 0.25},

    ['TAUREN_MALE'] = {0, 0.25, 0.25, 0.5},
    ['SCOURGE_MALE'] = {0.25, 0.5, 0.25, 0.5},
    ['TROLL_MALE'] = {0.5, 0.75, 0.25, 0.5},
    ['ORC_MALE'] = {0.75, 1.0, 0.25, 0.5},

    ['HUMAN_FEMALE'] = {0, 0.25, 0.5, 0.75},
    ['DWARF_FEMALE'] = {0.25, 0.5, 0.5, 0.75},
    ['GNOME_FEMALE'] = {0.5, 0.75, 0.5, 0.75},
    ['NIGHTELF_FEMALE'] = {0.75, 1.0, 0.5, 0.75},

    ['TAUREN_FEMALE'] = {0, 0.25, 0.75, 1.0},
    ['SCOURGE_FEMALE'] = {0.25, 0.5, 0.75, 1.0},
    ['TROLL_FEMALE'] = {0.5, 0.75, 0.75, 1.0},
    ['ORC_FEMALE'] = {0.75, 1.0, 0.75, 1.0},
} or {
    ['HUMAN_MALE'] = {0, 0.125, 0, 0.25},
    ['DWARF_MALE'] = {0.125, 0.25, 0, 0.25},
    ['GNOME_MALE'] = {0.25, 0.375, 0, 0.25},
    ['NIGHTELF_MALE'] = {0.375, 0.5, 0, 0.25},

    ['TAUREN_MALE'] = {0, 0.125, 0.25, 0.5},
    ['SCOURGE_MALE'] = {0.125, 0.25, 0.25, 0.5},
    ['TROLL_MALE'] = {0.25, 0.375, 0.25, 0.5},
    ['ORC_MALE'] = {0.375, 0.5, 0.25, 0.5},

    ['HUMAN_FEMALE'] = {0, 0.125, 0.5, 0.75},
    ['DWARF_FEMALE'] = {0.125, 0.25, 0.5, 0.75},
    ['GNOME_FEMALE'] = {0.25, 0.375, 0.5, 0.75},
    ['NIGHTELF_FEMALE'] = {0.375, 0.5, 0.5, 0.75},

    ['TAUREN_FEMALE'] = {0, 0.125, 0.75, 1.0},
    ['SCOURGE_FEMALE'] = {0.125, 0.25, 0.75, 1.0},
    ['TROLL_FEMALE'] = {0.25, 0.375, 0.75, 1.0},
    ['ORC_FEMALE'] = {0.375, 0.5, 0.75, 1.0},

    ['BLOODELF_MALE'] = {0.5, 0.625, 0.25, 0.5},
    ['BLOODELF_FEMALE'] = {0.5, 0.625, 0.75, 1.0},

    ['DRAENEI_MALE'] = {0.5, 0.625, 0, 0.25},
    ['DRAENEI_FEMALE'] = {0.5, 0.625, 0.5, 0.75},
}

ns.TOKENS = {20560, 20559, 20558}

-- @debug@
local L = LibStub('AceLocale-3.0'):GetLocale('tdBag2')
-- @end-debug@
--[===[@non-debug@
local L = LibStub('AceLocale-3.0'):GetLocale('tdBag2', true)
--@end-non-debug@]===]
ns.L = L

local BAG_ID = { --
    BAG = 'bag',
    BANK = 'bank',
    MAIL = 'mail',
    EQUIP = 'equip',
    SEARCH = 'global-search',
}

local BAG_ICONS = { --
    [BAG_ID.BAG] = [[Interface\Buttons\Button-Backpack-Up]],
    [BAG_ID.BANK] = [[Interface\ICONS\INV_Misc_Bag_13]],
    [BAG_ID.MAIL] = [[Interface\MailFrame\Mail-Icon]],
    [BAG_ID.EQUIP] = [[Interface\ICONS\INV_Helmet_51]],
    [BAG_ID.SEARCH] = [[Interface\ICONS\INV_Misc_Spyglass_03]],
}

local BAG_TITLES = { --
    [BAG_ID.BAG] = L.TITLE_BAG,
    [BAG_ID.BANK] = L.TITLE_BANK,
    [BAG_ID.MAIL] = L.TITLE_MAIL,
    [BAG_ID.EQUIP] = L.TITLE_EQUIP,
    [BAG_ID.SEARCH] = L['Global search'],
}

local BAG_TOOLTIPS = {
    [BAG_ID.BAG] = L['Inventory'],
    [BAG_ID.BANK] = L['Bank'],
    [BAG_ID.MAIL] = L['Mail'],
    [BAG_ID.EQUIP] = L['Equipped'],
    [BAG_ID.SEARCH] = L['Global search'],
}

local BAGS = { --
    [BAG_ID.BAG] = {BACKPACK_CONTAINER},
    [BAG_ID.BANK] = {BANK_CONTAINER},
    [BAG_ID.MAIL] = {MAIL_CONTAINER, COD_CONTAINER},
    [BAG_ID.EQUIP] = {EQUIP_CONTAINER},
    [BAG_ID.SEARCH] = {},
}

if ns.FEATURE_GUILDBANK then
    BAG_ID.GUILDBANK = 'guild'
    BAG_TOOLTIPS[BAG_ID.GUILDBANK] = L['Guild bank']
    BAGS[BAG_ID.GUILDBANK] = {}
end

local BAG_CLASSES = {
    [BAG_ID.BAG] = {Frame = 'InventoryFrame', Item = 'Item', Container = 'Container'},
    [BAG_ID.BANK] = {Frame = 'BankFrame', Item = 'Item', Container = 'Container'},
    [BAG_ID.MAIL] = {Frame = 'SimpleFrame', Item = 'ItemBase', Container = 'TitleContainer'},
    [BAG_ID.EQUIP] = {Frame = 'EquipFrame', Item = 'EquipItem', Container = 'EquipContainer'},
    [BAG_ID.SEARCH] = {Frame = 'GlobalSearchFrame', Item = 'ItemBase', Container = 'GlobalSearchContainer'},
}

local BAG_SETS = {}
local BAG_IDS = {}
local INV_IDS = {}
do
    local function touch(bag, bagId)
        local slot = C.Container.ContainerIDToInventoryID(bag)
        INV_IDS[slot] = bag
        BAG_IDS[bag] = slot

        tinsert(BAGS[bagId], bag)
    end

    for i = 1, NUM_BAG_SLOTS do
        touch(i, BAG_ID.BAG)
    end

    for i = 1, NUM_BANKBAGSLOTS do
        touch(i + NUM_BAG_SLOTS, BAG_ID.BANK)
    end

    if ns.FEATURE_KEYRING then
        tinsert(BAGS[BAG_ID.BAG], KEYRING_CONTAINER)
    end

    if Constants.InventoryConstants.NumReagentBagSlots then
        tinsert(BAGS[BAG_ID.BANK], Enum.BagIndex.Reagentbank)
    end

    for bagId, v in pairs(BAGS) do
        for _, bag in pairs(v) do
            BAG_SETS[bag] = bagId
        end
    end

    if ns.FEATURE_GUILDBANK then
        for i = 1, MAX_GUILDBANK_TABS do
            tinsert(BAGS[BAG_ID.GUILDBANK], 50 + i)
        end
    end
end

local INV_TOOLTIPS = {}
local INV_ANCHORS = {}
local INV_ICONS = {}
do
    local function left(i)
        return {anchor = 'LEFT', index = i}
    end

    local function right(i)
        return {anchor = 'RIGHT', index = i}
    end

    local function bottom(i)
        return {anchor = 'BOTTOM', index = i}
    end

    local INV_DATA = { --
        HEADSLOT = left(0),
        NECKSLOT = left(1),
        SHOULDERSLOT = left(2),
        BACKSLOT = left(3),
        CHESTSLOT = left(4),
        SHIRTSLOT = left(5),
        TABARDSLOT = left(6),
        WRISTSLOT = left(7),

        HANDSSLOT = right(0),
        WAISTSLOT = right(1),
        LEGSSLOT = right(2),
        FEETSLOT = right(3),
        FINGER0SLOT = right(4),
        FINGER1SLOT = right(5),
        TRINKET0SLOT = right(6),
        TRINKET1SLOT = right(7),

        -- @non-retail@
        -- @end-non-retail@

    }

    if not ns.FEATURE_RANGED_WEAPON then
        INV_DATA.MAINHANDSLOT = bottom(-0.5)
        INV_DATA.SECONDARYHANDSLOT = bottom(0.5)
    else
        INV_DATA.MAINHANDSLOT = bottom(-1)
        INV_DATA.SECONDARYHANDSLOT = bottom(0)
        INV_DATA.RANGEDSLOT = bottom(1)
    end

    for key, pos in pairs(INV_DATA) do
        local slot, icon = GetInventorySlotInfo(key)

        INV_ICONS[slot] = icon
        INV_ANCHORS[slot] = pos
        INV_TOOLTIPS[slot] = _G[key]
    end
end

ns.BAG_ID = BAG_ID
ns.BAG_ICONS = BAG_ICONS
ns.BAG_TITLES = BAG_TITLES
ns.BAG_TOOLTIPS = BAG_TOOLTIPS
ns.BAG_CLASSES = BAG_CLASSES

ns.INV_TOOLTIPS = INV_TOOLTIPS
ns.INV_ANCHORS = INV_ANCHORS
ns.INV_ICONS = INV_ICONS

ns.PLAYER = nil
ns.REALM = nil

ns.DEFAULT_WATCHES = { --
    WARLOCK = {6265},
    PRIEST = {17028, 17029},
    MAGE = {17020, 17031, 17032},
    DRUID = {17038, 17026},
    PALADIN = {21177, 17033},
    ROGUE = {5140, 5530},
    SHAMAN = {17057, 17058},
}

ns.TRADE_BAG_ORDER = { --
    NONE = 'none',
    TOP = 'top',
    BOTTOM = 'bottom',
}

ns.BREAK_TYPE = { --
    NONE = 'none',
    TYPE = 'type',
    BAG = 'bag',
}

ns.FRAME_OPTION_EVENTS = { --
    bagFrame = 'BAG_FRAME_TOGGLED',
    managed = 'MANAGED_TOGGLED',
    tokenFrame = 'TOKEN_FRAME_TOGGLED',
    pluginButtons = 'PLUGIN_FRAME_TOGGLED',

    scale = 'CONTAINER_LAYOUT',
    column = 'CONTAINER_LAYOUT',
    reverseSlot = 'CONTAINER_LAYOUT',

    reverseBag = 'BAG_ORDER_CHANGED',
    tradeBagOrder = 'BAG_ORDER_CHANGED',

    iconCharacter = 'ICON_CHARACTER_TOGGLED',
}

ns.OPTION_EVENTS = { --
    textOffline = 'TEXT_OFFLINE_TOGGLED',

    iconJunk = 'ITEM_BORDER_UPDATE',
    iconQuestStarter = 'ITEM_BORDER_UPDATE',
    glowQuest = 'ITEM_BORDER_UPDATE',
    glowUnusable = 'ITEM_BORDER_UPDATE',
    glowQuality = 'ITEM_BORDER_UPDATE',
    glowEquipSet = 'ITEM_BORDER_UPDATE',
    glowNew = 'ITEM_BORDER_UPDATE',
    glowAlpha = 'ITEM_BORDER_UPDATE',

    colorSlots = 'ITEM_COLOR_UPDATE',
    colorNormal = 'ITEM_COLOR_UPDATE',
    colorQuiver = 'ITEM_COLOR_UPDATE',
    colorSoul = 'ITEM_COLOR_UPDATE',
    colorEnchant = 'ITEM_COLOR_UPDATE',
    colorHerb = 'ITEM_COLOR_UPDATE',
    colorKeyring = 'ITEM_COLOR_UPDATE',
    emptyAlpha = 'ITEM_COLOR_UPDATE',

    remainLimit = 'REMAIN_LIMIT_CHANGED',

    tipCount = function()
        return ns.Tooltip:Update()
    end,
}

ns.CHARACTER_PROFILE = { --
    ---@type ProfileWatchItem[]
    watches = {first = true},
    hiddenBags = {[KEYRING_CONTAINER] = true},
}

---@class Database: AceDB.Schema
ns.PROFILE = {
    global = { --
        forever = {},
        characters = {},
    },
    ---@class Profile
    profile = {
        plugins = {},
        frames = {
            [BAG_ID.BAG] = { --
                window = {point = 'BOTTOMRIGHT', x = -50, y = 100},
                disableButtons = {},
                column = 8,
                reverseBag = false,
                reverseSlot = false,
                managed = false,
                bagFrame = true,
                tokenFrame = true,
                pluginButtons = true,
                scale = 1,
                tradeBagOrder = ns.TRADE_BAG_ORDER.BOTTOM,
                iconCharacter = false,
                hiddenBags = {},
                breakType = ns.BREAK_TYPE.TYPE,
                breakHeight = 10,
            },
            [BAG_ID.BANK] = { --
                window = {point = 'TOPLEFT', x = 50, y = -100},
                disableButtons = {},
                column = 12,
                reverseBag = false,
                reverseSlot = false,
                managed = true,
                bagFrame = true,
                tokenFrame = true,
                pluginButtons = true,
                scale = 1,
                tradeBagOrder = ns.TRADE_BAG_ORDER.NONE,
                iconCharacter = false,
                hiddenBags = {},
                breakType = ns.BREAK_TYPE.TYPE,
                breakHeight = 10,
            },
            [BAG_ID.MAIL] = { --
                window = {point = 'TOPLEFT', x = 50, y = -100},
                column = 12,
                reverseSlot = false,
                managed = true,
                scale = 1,
                iconCharacter = false,
            },
            [BAG_ID.EQUIP] = {
                window = {point = 'TOPLEFT', x = 50, y = -100},
                column = 6,
                reverseSlot = false,
                managed = true,
                scale = 1,
                iconCharacter = true,
                tdInspect = true,
            },

            [BAG_ID.SEARCH] = {
                window = {point = 'CENTER', x = 0, y = 0},
                column = 16,
                reverseSlot = false,
                managed = true,
                scale = 1,
            },
        },

        displayMail = true,
        displayMerchant = true,
        displayCharacter = false,
        displayAuction = true,
        displayTrade = true,
        displayCraft = true,
        displayBank = true,

        closeMail = true,
        closeMerchant = true,
        closeCharacter = false,
        closeAuction = true,
        closeTrade = true,
        closeCraft = true,
        closeBank = true,
        closeCombat = false,

        glowQuest = true,
        glowUnusable = true,
        glowQuality = true,
        glowEquipSet = true,
        glowNew = true,
        glowAlpha = 0.5,

        lockFrame = false,
        iconJunk = true,
        iconQuestStarter = true,
        textOffline = true,
        tipCount = true,
        tipCountGuild = true,
        remainLimit = 0,
        borderStyle = 'Default',

        colorSlots = true,

        emptyAlpha = 0.9,

        searches = {first = true},

        style = 'Blizzard',

        -- @debug@
        colorNormal = {},
        tokens = 1,
        -- @end-debug@
    },
}

ns.BAG_FAMILIES = {}
ns.BAG_FAMILY_KEYS = {}

local function familyColor(families, key, name, profile)
    local t = type(families)
    if t == 'table' then
        for _, family in ipairs(families) do
            ns.BAG_FAMILY_KEYS[family] = key
        end
    elseif t == 'number' then
        ns.BAG_FAMILY_KEYS[families] = key
    end
    ns.PROFILE.profile[key] = profile
    tinsert(ns.BAG_FAMILIES, {key = key, name = name})
end

familyColor(nil, 'colorNormal', L['Normal Color'], {r = 1, g = 1, b = 1})
familyColor({1, 2}, 'colorQuiver', L['Quiver Color'], {r = 1, g = 0.87, b = 0.68})

if ns.BUILD_VANILLA then
    familyColor({3, 4}, 'colorSoul', L['Soul Color'], {r = 0.64, g = 0.39, b = 1})
    familyColor(6, 'colorHerb', L['Herbalism Color'], {r = 0.5, g = 1, b = 0.5})
    familyColor(7, 'colorEnchant', L['Enchanting Color'], {r = 0.64, g = 0.83, b = 1})
    familyColor(9, 'colorKeyring', L['Keyring Color'], {r = 1, g = 0.67, b = 0.95})
else
    familyColor(4, 'colorSoul', L['Soul Color'], {r = 0.64, g = 0.39, b = 1})
    familyColor(8, 'colorLeather', L['Leatherworking Color'], {r = 0.98, g = 0.44, b = 0.44})
    familyColor(32, 'colorHerb', L['Herbalism Color'], {r = 0.5, g = 1, b = 0.5})
    familyColor(64, 'colorEnchant', L['Enchanting Color'], {r = 0.64, g = 0.83, b = 1})
    familyColor(128, 'colorEngineer', L['Engineering Color'], {r = 0.96, g = 1, b = 0})
    familyColor(512, 'colorGems', L['Gems Color'], {r = 0.32, g = 0.61, b = 1})
    familyColor(512, 'colorMine', L['Mining Color'], {r = 0.96, g = 0.27, b = 0.90})
    familyColor(256, 'colorKeyring', L['Keyring Color'], {r = 1, g = 0.67, b = 0.95})
end

function ns.memorize(func)
    local cache = {}
    return function(arg1, ...)
        local value = cache[arg1]
        if value == nil then
            value = func(arg1, ...)
            cache[arg1] = value
        end
        return value
    end
end

function ns.GetBags(bagId)
    return BAGS[bagId]
end

function ns.GetBagId(bag)
    return BAG_SETS[bag]
end

function ns.IsInBag(bag)
    return BAG_SETS[bag] == BAG_ID.BAG
end

function ns.IsInBank(bag)
    return BAG_SETS[bag] == BAG_ID.BANK
end

function ns.IsBackpack(bag)
    return bag == BACKPACK_CONTAINER
end

function ns.IsBank(bag)
    return bag == BANK_CONTAINER
end

function ns.IsKeyring(bag)
    return bag == KEYRING_CONTAINER
end

function ns.IsEquip(bag)
    return bag == EQUIP_CONTAINER
end

function ns.IsMail(bag)
    return bag == MAIL_CONTAINER
end

function ns.IsBaseBag(bag)
    return ns.IsBackpack(bag) or ns.IsBank(bag) or ns.IsKeyring(bag)
end

function ns.IsCustomBag(bag)
    return ns.IsContainerBag(bag) and bag > BACKPACK_CONTAINER
end

function ns.IsReagentBank(bag)
    return bag == Enum.BagIndex.Reagentbank
end

function ns.IsReagentBag(bag)
    return bag == Enum.BagIndex.ReagentBag
end

function ns.IsContainerBag(bag)
    return tonumber(bag)
end

function ns.SlotToBag(inv)
    return INV_IDS[inv]
end

function ns.BagToSlot(bag)
    return BAG_IDS[bag]
end

function ns.IsSelf(owner)
    return not owner or owner == ns.PLAYER
end

function ns.AnchorTooltip(frame)
    if frame:GetRight() >= (GetScreenWidth() / 2) then
        GameTooltip:SetOwner(frame, 'ANCHOR_LEFT')
    else
        GameTooltip:SetOwner(frame, 'ANCHOR_RIGHT')
    end
end

function ns.AnchorTooltip2(frame, anchor, x, y, owner)
    GameTooltip:SetOwner(owner or frame, 'ANCHOR_NONE')
    if frame:GetTop() > (GetScreenHeight() / 2) then
        GameTooltip:SetPoint('TOP' .. anchor, frame, 'BOTTOM' .. anchor, x, y)
    else
        GameTooltip:SetPoint('BOTTOM' .. anchor, frame, 'TOP' .. anchor, x, y)
    end
end

function ns.GetOwnerAddress(owner)
    return ns.REALM, owner or ns.PLAYER, owner == GLOBAL_SEARCH_OWNER
end

local function NormalizedRealmName(realm)
    return realm:gsub('[%s-]+', '')
end

function ns.GetNormalizedRealmName()
    local realm = GetNormalizedRealmName()
    if not realm or realm == '' then
        realm = NormalizedRealmName(GetRealmName())
    end
    return realm
end

function ns.GetCurrentGuildOwner()
    local name, _, _, realm = GetGuildInfo('player')
    if not name then
        return
    end
    if not realm or realm == '' then
        realm = ns.GetNormalizedRealmName()
    end
    return format('@%s-%s', name, realm)
end

function ns.IsGuildOwner(key)
    return key and key:find('^@')
end
ns.IsGuildOwner = ns.memorize(ns.IsGuildOwner)

function ns.GetCharacterProfileKey(name, realm)
    if name:find('-') then
        name, realm = name:match('(.+)-(.+)')
    end
    return format('%s - %s', name, realm)
end

function ns.PlayToggleSound(flag)
    return PlaySound(flag and 856 or 857)
end

function ns.GetOwnerColoredName(owner)
    local color = RAID_CLASS_COLORS[owner.class or 'PRIEST']
    return format('|cff%02x%02x%02x%s|r', color.r * 0xFF, color.g * 0xFF, color.b * 0xFF, Ambiguate(owner.name, 'none'))
end

function ns.LeftButtonTip(text)
    return ns.LEFT_MOUSE_BUTTON .. text, 1, 1, 1
end

function ns.RightButtonTip(text)
    return ns.RIGHT_MOUSE_BUTTON .. text, 1, 1, 1
end

function ns.Spawned(method)
    return function(a1, a2, a3, a4, a5, a6, a7, a8, a9)
        return C.Timer.After(0, function()
            return method(a1, a2, a3, a4, a5, a6, a7, a8, a9)
        end)
    end
end

function ns.NameGenerator(name)
    local index = 0
    return function()
        index = index + 1
        return name .. index
    end
end

function ns.CopyDefaults(dest, src)
    dest = dest or {}
    for k, v in pairs(src) do
        if type(v) == 'table' then
            dest[k] = ns.CopyDefaults(dest[k], v)
        elseif dest[k] == nil then
            dest[k] = v
        end
    end
    return dest
end

function ns.RemoveDefaults(dest, src)
    if dest == nil then
        return
    end
    for k, v in pairs(src) do
        if type(v) == 'table' then
            dest[k] = ns.RemoveDefaults(dest[k], v)
        elseif dest[k] == v then
            dest[k] = nil
        end
    end
    return next(dest) and dest or nil
end

function ns.Hook(...)
    local tbl, key, func
    local n = select('#', ...)
    if n == 3 then
        tbl, key, func = ...
    elseif n == 2 then
        tbl, key, func = _G, ...
    else
        assert(false)
    end

    local function pack(...)
        return select('#', ...), {...}
    end

    local orig = tbl[key]
    tbl[key] = function(...)
        local l, r = pack(orig(...))
        func(...)
        return unpack(r, 1, l)
    end
end

---@generic T: table, V
---@param t T
---@return fun(table: V[], i?: integer):integer, V
---@return T
---@return integer i
function ns.safeipairs(t)
    if t then
        return ipairs(t)
    else
        ---@diagnostic disable-next-line: missing-return-value
        return nop
    end
end

local LibShowUIPanel = LibStub('LibShowUIPanel-1.0')
ns.ShowUIPanel = LibShowUIPanel.ShowUIPanel
ns.HideUIPanel = LibShowUIPanel.HideUIPanel