From fc8c7eaa8ee407c52b67b9fc8517deb6a0a8b3b5 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 20:46:41 +0200 Subject: [PATCH 001/101] Restore SuperWoW and SuperAPI fallbacks --- Payload/Interface/Addons/SuperAPI/README.md | 22 + .../Interface/Addons/SuperAPI/SuperAPI.lua | 192 ++ .../Interface/Addons/SuperAPI/SuperAPI.toc | 25 + .../Addons/SuperAPI/SuperAPIOptions.lua | 416 +++ .../libs/AceAddon-2.0/AceAddon-2.0.lua | 1129 +++++++ .../libs/AceConsole-2.0/AceConsole-2.0.lua | 1920 ++++++++++++ .../SuperAPI/libs/AceDB-2.0/AceDB-2.0.lua | 1539 +++++++++ .../libs/AceDebug-2.0/AceDebug-2.0.lua | 245 ++ .../libs/AceEvent-2.0/AceEvent-2.0.lua | 973 ++++++ .../SuperAPI/libs/AceHook-2.1/AceHook-2.1.lua | 569 ++++ .../SuperAPI/libs/AceLibrary/AceLibrary.lua | 757 +++++ .../libs/AceLocale-2.2/AceLocale-2.2.lua | 538 ++++ .../AceModuleCore-2.0/AceModuleCore-2.0.lua | 462 +++ .../SuperAPI/libs/AceOO-2.0/AceOO-2.0.lua | 1006 ++++++ .../SuperAPI/libs/Dewdrop/Dewdrop-2.0.lua | 2602 +++++++++++++++ .../libs/FuBarPlugin/FuBarPlugin-2.0.lua | 1480 +++++++++ .../SuperAPI/libs/Tablet/Tablet-2.0.lua | 2784 +++++++++++++++++ Payload/SuperWoWhook.dll | Bin 0 -> 1000448 bytes 18 files changed, 16659 insertions(+) create mode 100644 Payload/Interface/Addons/SuperAPI/README.md create mode 100644 Payload/Interface/Addons/SuperAPI/SuperAPI.lua create mode 100644 Payload/Interface/Addons/SuperAPI/SuperAPI.toc create mode 100644 Payload/Interface/Addons/SuperAPI/SuperAPIOptions.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/AceAddon-2.0/AceAddon-2.0.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/AceConsole-2.0/AceConsole-2.0.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/AceDB-2.0/AceDB-2.0.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/AceDebug-2.0/AceDebug-2.0.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/AceEvent-2.0/AceEvent-2.0.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/AceHook-2.1/AceHook-2.1.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/AceLibrary/AceLibrary.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/AceLocale-2.2/AceLocale-2.2.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/AceModuleCore-2.0/AceModuleCore-2.0.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/AceOO-2.0/AceOO-2.0.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/Dewdrop/Dewdrop-2.0.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/FuBarPlugin/FuBarPlugin-2.0.lua create mode 100644 Payload/Interface/Addons/SuperAPI/libs/Tablet/Tablet-2.0.lua create mode 100644 Payload/SuperWoWhook.dll diff --git a/Payload/Interface/Addons/SuperAPI/README.md b/Payload/Interface/Addons/SuperAPI/README.md new file mode 100644 index 0000000..9f38a6a --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/README.md @@ -0,0 +1,22 @@ +### Addon to allow compability between the mod and vanilla default interface. Also adds a minimap icon to change some mod settings. It is recommended for addon makers to read this to get a gist of some of the mod's features + +### Settings +Right click the minimap icon to choose persistent options for: +- Autoloot +- Clickthrough +- GUID in combat log/events +- FoV +- Background Sound +- Uncapped Sounds +- Targetting circle style + +**NOTE: If using Vanilla Tweaks quickloot all of the Autoloot options will be reversed (always on will actually be always off, Shift to toggle on will be Shift to toggle off etc).** + +### Other features +- Adds "mouseover" support to all default blizzard unitframes +- Shows item charges in bag +- Allows Shift clicking a spell in your spellbook to link it to chat +- Adds chat command to toggle showing unit names or GUIDs in combat log + +## Modules: +https://github.com/balakethelock/SuperAPI_Castlib provides improved castbars, alternatively the latest version of pfui/shaguplates now do the same diff --git a/Payload/Interface/Addons/SuperAPI/SuperAPI.lua b/Payload/Interface/Addons/SuperAPI/SuperAPI.lua new file mode 100644 index 0000000..0161abd --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/SuperAPI.lua @@ -0,0 +1,192 @@ +-- No superwow, no superapi +local version = tonumber(SUPERWOW_VERSION) + +if not version or version < 2.2 then + StaticPopupDialogs["UPDATE_SUPERWOW"] = { + text = "No SuperWoW detected. Please download latest version.", + button1 = "Download", + button2 = TEXT(IGNORE), + OnAccept = function(data) + local url = "https://github.com/balakethelock/SuperWoW/releases/tag/Release" + + if not ChatFrameEditBox:IsVisible() then + ChatFrameEditBox:Show() + end + + ChatFrameEditBox:SetText(url) + ChatFrameEditBox:SetFocus() + ChatFrameEditBox:HighlightText() + end, + timeout = 0, + exclusive = 1, + whileDead = 1, + hideOnEscape = 1 + }; + + DEFAULT_CHAT_FRAME:AddMessage("No SuperWoW detected. Please download latest version https://github.com/balakethelock/SuperWoW "); + StaticPopup_Show("UPDATE_SUPERWOW"); + return +end + +SUPERAPI_ContainerItemsTable = {} + +SuperAPI = AceLibrary("AceAddon-2.0"):new("AceEvent-2.0", "AceDebug-2.0", "AceModuleCore-2.0", "AceConsole-2.0", "AceDB-2.0", "AceHook-2.1") +SuperAPI:RegisterDB("SuperAPIDB") +SuperAPI.frame = CreateFrame("Frame", "SuperAPI", UIParent) + +function SuperAPI:OnEnable() + -- Let macro frame allow 511 characters + MacroFrame_LoadUI(); + MacroFrameText:SetMaxLetters(511); + MACROFRAME_CHAR_LIMIT = "%d/511 Characters Used"; + + -- Change chat bubbles options name + OPTION_TOOLTIP_PARTY_CHAT_BUBBLES = "Shows whisper, party, raid, and battleground chat text in speech bubbles above characters' heads."; + PARTY_CHAT_BUBBLES_TEXT = "Show Whisper and Group Chat Bubbles"; + + SuperAPI.SetItemRefOriginal = SetItemRef + SuperAPI.SpellButton_OnClickOriginal = SpellButton_OnClick + SuperAPI.SetItemButtonCountOriginal = SetItemButtonCount + SuperAPI.SetActionOriginal = GameTooltip.SetAction + SuperAPI.UnitFrame_OnEnterOriginal = UnitFrame_OnEnter + SuperAPI.UnitFrame_OnLeaveOriginal = UnitFrame_OnLeave + SuperAPI.CombatText_AddMessageOriginal = CombatText_AddMessage + SuperAPI.QuestLogTitleButton_OnClickOriginal = QuestLogTitleButton_OnClick + + -- activate hooks + SetItemRef = SuperAPI.SetItemRef + SpellButton_OnClick = SuperAPI.SpellButton_OnClick + SetItemButtonCount = SuperAPI.SetItemButtonCount + GameTooltip.SetAction = SuperAPI.SetAction + UnitFrame_OnEnter = SuperAPI.UnitFrame_OnEnter + UnitFrame_OnLeave = SuperAPI.UnitFrame_OnLeave + CombatText_AddMessage = SuperAPI.CombatText_AddMessage + QuestLogTitleButton_OnClick = SuperAPI.QuestLogTitleButton_OnClick + + + -- SuperAPI.frame:RegisterEvent("BAG_UPDATE") + -- SuperAPI.frame:RegisterEvent("BAG_UPDATE_COOLDOWN") + SuperAPI.frame:SetScript("OnEvent", SuperAPI.OnEvent) + + -- this chatcommand is empty. It is essential for showing tooltips of macros + -- the format for showing a tooltip on a macro is EXACTLY this: /tooltip spell:spellid and then skip line + SLASH_MACROTOOLTIP1 = "/tooltip" + SlashCmdList["MACROTOOLTIP"] = function(cmd) + end + DEFAULT_CHAT_FRAME:AddMessage("|cffffcc00SuperAPI|cffffaaaa Loaded. Check the minimap icon for options.") +end + +function SuperAPI:OnEvent() + if (event == "BAG_UPDATE_COOLDOWN" or event == "BAG_UPDATE") then + SUPERAPI_ContainerItemsTable = {} + for ibag = 0, 4 do + for islot = 1, GetContainerNumSlots(ibag) do + local bagitemlink = GetContainerItemLink(ibag, islot) + if bagitemlink then + local _, _, bagitemID = strfind(bagitemlink, "item:(%d+)") + bagitemID = tonumber(bagitemID) + SUPERAPI_ContainerItemsTable[bagitemID] = { bag = ibag; slot = islot } + end + end + end + end +end + +-- HOOKS -- +-- Global function to get a spell link from its exact id +SuperAPI.GetSpellLink = function(id) + local spellname = SpellInfo(id) + local link = "\124cffffffff\124Henchant:" .. id .. "\124h[" .. spellname .. "]\124h\124r" + return link +end + +-- reformat "Enchant" itemlinks to better supported "Spell" itemlinks +SuperAPI.SetItemRef = function(link, text, button) + link = gsub(link, "spell:", "enchant:") + SuperAPI.SetItemRefOriginal(link, text, button) +end + +-- hooking spellbook frame to get a spell link on shift clicking a spell's button with chatframe open +SuperAPI.SpellButton_OnClick = function(drag) + if ((not drag) and IsShiftKeyDown() and ChatFrameEditBox:IsVisible() and (not MacroFrame or not MacroFrame:IsVisible())) then + local bookId = SpellBook_GetSpellID(this:GetID()); + local _, _, spellID = GetSpellName(bookId, SpellBookFrame.bookType) + local link = SuperAPI.GetSpellLink(spellID) + ChatFrameEditBox:Insert(link) + else + SuperAPI.SpellButton_OnClickOriginal(drag) + end +end + +-- hooking bags item button frames to show uses count +SuperAPI.SetItemButtonCount = function(button, count) + if not button or not count then + return SuperAPI.SetItemButtonCountOriginal(button, count) + end + if (count < 0) then + if (count < -999) then + count = "*"; + end + getglobal(button:GetName() .. "Count"):SetText(-count); + getglobal(button:GetName() .. "Count"):Show(); + getglobal(button:GetName() .. "Count"):SetFontObject(NumberFontNormalYellow); + else + getglobal(button:GetName() .. "Count"):SetFontObject(NumberFontNormal); + SuperAPI.SetItemButtonCountOriginal(button, count) + end +end + +-- hooking actionbutton tooltip to show item tooltip on macros +SuperAPI.SetAction = function(this, buttonID) + --local name, actiontype, macroID = GetActionText(buttonID) + --if actiontype == "MACRO" then + -- local _,_, body = GetMacroInfo(macroID) + -- local _,_, itemID = strfind(body, "^/tooltip item:(%d+)") + -- if itemID then + -- itemID = tonumber(itemID) + -- iteminfo = SUPERAPI_ContainerItemsTable[itemID] + -- if iteminfo then + -- return this:SetBagItem(iteminfo.bag, iteminfo.slot) + -- end + -- end + --end + -- + return SuperAPI.SetActionOriginal(this, buttonID) +end + +-- Add Mouseover casting to default blizzard unitframes and all unitframe addons that use the same function +SuperAPI.UnitFrame_OnEnter = function() + SuperAPI.UnitFrame_OnEnterOriginal() + SetMouseoverUnit(this.unit) +end + +SuperAPI.UnitFrame_OnLeave = function() + SuperAPI.UnitFrame_OnLeaveOriginal() + SetMouseoverUnit() +end + +-- Fix scrolling combat text healer name +SuperAPI.CombatText_AddMessage = function(message, scrollFunction, r, g, b, displayType, isStaggered) + local newMessage = gsub(message, "(%s%[)(0x%x%x%x%x%x%x%x%x%x%x%x%x%x%x%x%x)(%])", function(bracket1, hex, bracket2) + if UnitIsUnit(hex, "player") then return nil + else return " ["..UnitName(hex).."]" end + end) + return SuperAPI.CombatText_AddMessageOriginal(newMessage, scrollFunction, r, g, b, displayType, isStaggered) +end + +-- Link quest in chat from Blizzard QuestLog +SuperAPI.QuestLogTitleButton_OnClick = function(button) + local questIndex = this:GetID() + FauxScrollFrame_GetOffset(QuestLogListScrollFrame); + + if ( IsShiftKeyDown() ) then + if ( not this.isHeader ) then + if ( ChatFrameEditBox:IsVisible() ) then + local questLink = GetQuestLinkForLogIndex(questIndex) + ChatFrameEditBox:Insert(questLink); + return + end + end + end + + return SuperAPI.QuestLogTitleButton_OnClickOriginal(button) +end diff --git a/Payload/Interface/Addons/SuperAPI/SuperAPI.toc b/Payload/Interface/Addons/SuperAPI/SuperAPI.toc new file mode 100644 index 0000000..3204821 --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/SuperAPI.toc @@ -0,0 +1,25 @@ +## Interface: 11200 +## Title: SuperAPI |cFFFF8080-balake-|r +## Notes: the companion compatibility addon to the mod of the same name. +## Author: balake +## SavedVariablesPerCharacter: SuperAPIDB +## X-Embeds: Ace2, FuBarPlugin-2.0, CompostLib, DewDropLib, TabletLib + +libs\AceLibrary\AceLibrary.lua + +libs\AceOO-2.0\AceOO-2.0.lua +libs\AceAddon-2.0\AceAddon-2.0.lua +libs\AceConsole-2.0\AceConsole-2.0.lua +libs\AceHook-2.1\AceHook-2.1.lua +libs\AceDB-2.0\AceDB-2.0.lua +libs\AceDebug-2.0\AceDebug-2.0.lua +libs\AceEvent-2.0\AceEvent-2.0.lua +libs\AceLocale-2.2\AceLocale-2.2.lua +libs\AceModuleCore-2.0\AceModuleCore-2.0.lua + +libs\Dewdrop\Dewdrop-2.0.lua +libs\Tablet\Tablet-2.0.lua +libs\FuBarPlugin\FuBarPlugin-2.0.lua + +SuperAPI.lua +SuperAPIOptions.lua diff --git a/Payload/Interface/Addons/SuperAPI/SuperAPIOptions.lua b/Payload/Interface/Addons/SuperAPI/SuperAPIOptions.lua new file mode 100644 index 0000000..3fabab4 --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/SuperAPIOptions.lua @@ -0,0 +1,416 @@ +-- No superwow, no superapi +if not SuperAPI then + return +end + +SuperAPI.AUTOLOOT_OPTIONS = { + "Always on", + "Always off", + "Shift to toggle on", + "Shift to toggle off", +} + +SuperAPI.SELECTION_CIRCLE_STYLE = { + "Default - incomplete circle", + "Full circle (must download texture)", + "Full circle with arrow for facing direction (must download texture)", + "Classic incomplete circle oriented in facing direction", +} + +SuperAPI.NAMEPLATE_MOTION = { + "Overlap", + "Default spread", + "Smart spread", + "Compact spread", +} + +SuperAPI:RegisterDefaults("profile", { + autoloot = SuperAPI.AUTOLOOT_OPTIONS[3], + clickthrough = false, +}) + +SuperAPI.IfShiftAutoloot = function() + if IsShiftKeyDown() then + SetAutoloot(1) + else + SetAutoloot(0) + end +end + +SuperAPI.IfShiftNoAutoloot = function() + if IsShiftKeyDown() then + SetAutoloot(0) + else + SetAutoloot(1) + end +end + +SuperAPI.cmdtable = { + type = "group", + handler = SuperAPI, + args = { + autoloot = { + type = "text", + name = "Autoloot (Read tooltip)", + desc = "Specifies autoloot behavior. If using Vanilla Tweaks quickloot all of these will be reversed (always on will actually be always off, Shift to toggle on will be Shift to toggle off etc).", + order = 10, + validate = SuperAPI.AUTOLOOT_OPTIONS, + get = function() + return SuperAPI.db.profile.autoloot + end, + set = function(v) + SuperAPI.db.profile.autoloot = v + if v == SuperAPI.AUTOLOOT_OPTIONS[1] then + -- "Always on" + SetAutoloot(1) + SuperAPI.frame:SetScript("OnUpdate", nil) + elseif v == SuperAPI.AUTOLOOT_OPTIONS[2] then + -- "Always off" + SetAutoloot(0) + SuperAPI.frame:SetScript("OnUpdate", nil) + elseif v == SuperAPI.AUTOLOOT_OPTIONS[3] then + -- "Shift to toggle on" + SetAutoloot(0) + SuperAPI.frame:SetScript("OnUpdate", SuperAPI.IfShiftAutoloot) + elseif v == SuperAPI.AUTOLOOT_OPTIONS[4] then + -- "Shift to toggle off" + SetAutoloot(1) + SuperAPI.frame:SetScript("OnUpdate", SuperAPI.IfShiftNoAutoloot) + end + end, + }, + clickthrough = { + type = "toggle", + name = "Clickthrough corpses", + desc = "Allows you to click through corpses to loot corpses underneath them.", + order = 20, + get = function() + return Clickthrough() == 1 + end, + set = function(v) + if v == true then + Clickthrough(1) + else + Clickthrough(0) + end + SuperAPI.db.profile.clickthrough = v + end, + }, + fov = { + type = "range", + name = "Field of view", + desc = "Changes the field of view of the game. Requires UI Reload.", + order = 30, + min = 0.1, + max = 3.14, + step = 0.05, + get = function() + return GetCVar("FoV") + end, + set = function(v) + SetCVar("FoV", v) + end, + }, + selectioncircle = { + type = "text", + name = "Selection circle style", + desc = "Changes the style of the selection circle.", + order = 40, + validate = SuperAPI.SELECTION_CIRCLE_STYLE, + get = function() + local selectioncircle = GetCVar("SelectionCircleStyle") + if selectioncircle then + return SuperAPI.SELECTION_CIRCLE_STYLE[tonumber(selectioncircle)] + end + end, + set = function(v) + if v == SuperAPI.SELECTION_CIRCLE_STYLE[1] then + SetCVar("SelectionCircleStyle", "1") + elseif v == SuperAPI.SELECTION_CIRCLE_STYLE[2] then + SetCVar("SelectionCircleStyle", "2") + elseif v == SuperAPI.SELECTION_CIRCLE_STYLE[3] then + SetCVar("SelectionCircleStyle", "3") + elseif v == SuperAPI.SELECTION_CIRCLE_STYLE[4] then + SetCVar("SelectionCircleStyle", "4") + end + end, + }, + backgroundsound = { + type = "toggle", + name = "Background sound", + desc = "Allows game sound to play even when the window is in the background.", + order = 60, + get = function() + return GetCVar("BackgroundSound") == "1" + end, + set = function(v) + if v == true then + SetCVar("BackgroundSound", "1") + else + SetCVar("BackgroundSound", "0") + end + end, + }, + uncappedsounds = { + type = "toggle", + name = "Uncapped sounds", + desc = "Allows more game sounds to play at the same time by removing hardcoded limit. This will also set SoundSoftwareChannels and SoundMaxHardwareChannels to 64. If you experience any weird crashes you may want to turn this off.", + order = 70, + get = function() + return GetCVar("UncapSounds") == "1" + end, + set = function(v) + if v == true then + SetCVar("UncapSounds", "1") + SetCVar("SoundSoftwareChannels", "64") + SetCVar("SoundMaxHardwareChannels", "64") + else + SetCVar("UncapSounds", "0") + SetCVar("SoundSoftwareChannels", "12") + SetCVar("SoundMaxHardwareChannels", "12") + end + end, + }, + lootsparkle = { + type = "toggle", + name = "Loot Sparkle", + desc = "Toggle loot sparkle effect on lootable treasure.", + order = 80, + get = function() + return GetCVar("LootSparkle") == "1" + end, + set = function(v) + if v == true then + SetCVar("LootSparkle", "1") + else + SetCVar("LootSparkle", "0") + end + end, + }, + healingtext = { + type = "toggle", + name = "Floating Healing Text", + desc = "Toggle display of in-world healing feedback.", + order = 85, + get = function() + return GetCVar("HealingText") == "1" + end, + set = function(v) + if v == true then + SetCVar("HealingText", "1") + else + SetCVar("HealingText", "0") + end + end, + }, + nameplates = { + type = "group", + name = "Nameplate Settings", + desc = "Group of settings related to Nameplates", + order = 90, + args = { + nameplaterange = { + type = "range", + name = "Nameplate range", + desc = "Changes the range at which Nameplates appear.", + order = 1, + min = 10, + max = 80, + step = 1, + get = function() + return GetCVar("NameplateRange") + end, + set = function(v) + SetCVar("NameplateRange", v) + end, + }, + nameplatemotion = { + type = "text", + name = "Nameplate Motion", + desc = "Changes the behavior of moving nameplates.", + order = 2, + validate = SuperAPI.NAMEPLATE_MOTION, + get = function() + local nameplatemotionSetting = GetCVar("NameplateMotion") + if nameplatemotionSetting then + return SuperAPI.NAMEPLATE_MOTION[(tonumber(nameplatemotionSetting))+1] + end + end, + set = function(v) + if v == SuperAPI.NAMEPLATE_MOTION[1] then + SetCVar("NameplateMotion", "0") + elseif v == SuperAPI.NAMEPLATE_MOTION[2] then + SetCVar("NameplateMotion", "1") + elseif v == SuperAPI.NAMEPLATE_MOTION[3] then + SetCVar("NameplateMotion", "2") + elseif v == SuperAPI.NAMEPLATE_MOTION[4] then + SetCVar("NameplateMotion", "3") + end + end, + }, + } + }, + chatbubbles = { + type = "group", + name = "Chat Bubble Settings", + desc = "Group of settings related to Chat Bubbles that appear above units", + order = 100, + args = { + chatbubblerange = { + type = "range", + name = "Chat Bubbles range", + desc = "Changes the range at which Chat Bubbles appear.", + order = 1007, + min = 10, + max = 200, + step = 5, + get = function() + return GetCVar("ChatBubbleRange") + end, + set = function(v) + SetCVar("ChatBubbleRange", v) + end, + }, + togglesay = { + type = "toggle", + name = "Say Chat Bubbles", + desc = "Toggle say and yell chat bubbles on/off", + order = 1009, + get = function() + return GetCVar("ChatBubbles") == "1" + end, + set = function(v) + if v == true then + SetCVar("ChatBubbles", "1") + else + SetCVar("ChatBubbles", "0") + end + end, + }, + togglepartybubbles = { + type = "toggle", + name = "Party Chat Bubbles", + desc = "Toggle party chat bubbles on/off", + order = 1008, + get = function() + return GetCVar("ChatBubblesParty") == "1" + end, + set = function(v) + if v == true then + SetCVar("ChatBubblesParty", "1") + else + SetCVar("ChatBubblesParty", "0") + end + end, + }, + toggleraidbubbles = { + type = "toggle", + name = "Raid Chat Bubbles", + desc = "Toggle raid chat bubbles on/off", + order = 1010, + get = function() + return GetCVar("ChatBubblesRaid") == "1" + end, + set = function(v) + if v == true then + SetCVar("ChatBubblesRaid", "1") + else + SetCVar("ChatBubblesRaid", "0") + end + end, + }, + togglebgbubbles = { + type = "toggle", + name = "Battleground Chat Bubbles", + desc = "Toggle battleground chat bubbles on/off", + order = 1020, + get = function() + return GetCVar("ChatBubblesBattleground") == "1" + end, + set = function(v) + if v == true then + SetCVar("ChatBubblesBattleground", "1") + else + SetCVar("ChatBubblesBattleground", "0") + end + end, + }, + togglewhisperbubbles = { + type = "toggle", + name = "Whisper Chat Bubbles", + desc = "Toggle whisper chat bubbles on/off", + order = 1030, + get = function() + return GetCVar("ChatBubblesWhisper") == "1" + end, + set = function(v) + if v == true then + SetCVar("ChatBubblesWhisper", "1") + else + SetCVar("ChatBubblesWhisper", "0") + end + end, + }, + togglecreaturebubbles = { + type = "toggle", + name = "Creature Chat Bubbles", + desc = "Toggle chat bubbles on creatures on/off", + order = 1040, + get = function() + return GetCVar("ChatBubblesCreatures") == "1" + end, + set = function(v) + if v == true then + SetCVar("ChatBubblesCreatures", "1") + else + SetCVar("ChatBubblesCreatures", "0") + end + end, + }, + } + }, + superwowLink = { + type = "execute", + name = "Support The Project", + desc = "All your donations are deeply appreciated! The community support is what keeps SuperWoW going", + func = function() + local url = "https://ko-fi.com/balakesuperwow" + + if not ChatFrameEditBox:IsVisible() then + ChatFrameEditBox:Show() + end + + ChatFrameEditBox:SetText(url) + ChatFrameEditBox:SetFocus() + ChatFrameEditBox:HighlightText() + + end, + }, + } +} + +local deuce = SuperAPI:NewModule("SuperAPI Options Menu") +deuce.hasFuBar = IsAddOnLoaded("FuBar") and FuBar +deuce.consoleCmd = not deuce.hasFuBar + +SuperAPIOptions = AceLibrary("AceAddon-2.0"):new("AceDB-2.0", "FuBarPlugin-2.0") +SuperAPIOptions.name = "FuBar - SuperAPI" +SuperAPIOptions:RegisterDB("SuperAPIDB") +SuperAPIOptions.hasIcon = "Interface\\Icons\\inv_misc_book_06" +SuperAPIOptions.defaultMinimapPosition = 180 +SuperAPIOptions.independentProfile = true +SuperAPIOptions.hideWithoutStandby = false + +SuperAPIOptions.OnMenuRequest = SuperAPI.cmdtable +local args = AceLibrary("FuBarPlugin-2.0"):GetAceOptionsDataTable(SuperAPIOptions) +for k, v in pairs(args) do + if SuperAPIOptions.OnMenuRequest.args[k] == nil then + SuperAPIOptions.OnMenuRequest.args[k] = v + end +end + +function SuperAPIOptions:OnEnable() + -- activate saved settings + SuperAPI.cmdtable.args.autoloot.set(SuperAPI.db.profile.autoloot) + SuperAPI.cmdtable.args.clickthrough.set(SuperAPI.db.profile.clickthrough) +end diff --git a/Payload/Interface/Addons/SuperAPI/libs/AceAddon-2.0/AceAddon-2.0.lua b/Payload/Interface/Addons/SuperAPI/libs/AceAddon-2.0/AceAddon-2.0.lua new file mode 100644 index 0000000..1c5e2d5 --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/AceAddon-2.0/AceAddon-2.0.lua @@ -0,0 +1,1129 @@ +--[[ +Name: AceAddon-2.0 +Revision: $Rev: 17957 $ +Developed by: The Ace Development Team (http://www.wowace.com/index.php/The_Ace_Development_Team) +Inspired By: Ace 1.x by Turan (turan@gryphon.com) +Website: http://www.wowace.com/ +Documentation: http://www.wowace.com/index.php/AceAddon-2.0 +SVN: http://svn.wowace.com/root/trunk/Ace2/AceAddon-2.0 +Description: Base for all Ace addons to inherit from. +Dependencies: AceLibrary, AceOO-2.0, AceEvent-2.0, (optional) AceConsole-2.0 +]] + +local MAJOR_VERSION = "AceAddon-2.0" +local MINOR_VERSION = "$Revision: 17958 $" + +-- This ensures the code is only executed if the libary doesn't already exist, or is a newer version +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary.") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +if loadstring("return function(...) return ... end") and AceLibrary:HasInstance(MAJOR_VERSION) then return end -- lua51 check +if not AceLibrary:HasInstance("AceOO-2.0") then error(MAJOR_VERSION .. " requires AceOO-2.0.") end + +local function safecall(func,a1,a2,a3,a4,a5,a6,a7,a8,a9,a10) + local success, err = pcall(func,a1,a2,a3,a4,a5,a6,a7,a8,a9,a10) + if not success then geterrorhandler()(err) end +end + +-- Localization +local STANDBY, TITLE, NOTES, VERSION, AUTHOR, DATE, CATEGORY, EMAIL, CREDITS, WEBSITE, COMMANDS, CATEGORIES, ABOUT, PRINT_ADDON_INFO +if GetLocale() == "deDE" then + STANDBY = "|cffff5050(Standby)|r" -- capitalized + + TITLE = "Titel" + NOTES = "Anmerkung" + VERSION = "Version" + AUTHOR = "Autor" + DATE = "Datum" + CATEGORY = "Kategorie" + EMAIL = "E-mail" + WEBSITE = "Webseite" + CREDITS = "Credits" -- fix + COMMANDS = "Commands" + + ABOUT = "\195\188ber" + PRINT_ADDON_INFO = "Gibt Addondaten aus" + + CATEGORIES = { + ["Action Bars"] = "Aktionsleisten", + ["Auction"] = "Auktion", + ["Audio"] = "Audio", + ["Battlegrounds/PvP"] = "Schlachtfeld/PvP", + ["Buffs"] = "Buffs", + ["Chat/Communication"] = "Chat/Kommunikation", + ["Druid"] = "Druide", + ["Hunter"] = "Jger", + ["Mage"] = "Magier", + ["Paladin"] = "Paladin", + ["Priest"] = "Priester", + ["Rogue"] = "Schurke", + ["Shaman"] = "Schamane", + ["Warlock"] = "Hexenmeister", + ["Warrior"] = "Krieger", + ["Healer"] = "Heiler", + ["Tank"] = "Tank", -- noone use "Brecher"... + ["Caster"] = "Caster", + ["Combat"] = "Kampf", + ["Compilations"] = "Compilations", -- whats that o_O + ["Data Export"] = "Datenexport", + ["Development Tools"] = "Entwicklungs Tools", + ["Guild"] = "Gilde", + ["Frame Modification"] = "Frame Modifikation", + ["Interface Enhancements"] = "Interface Verbesserungen", + ["Inventory"] = "Inventar", + ["Library"] = "Library", + ["Map"] = "Map", + ["Mail"] = "Mail", + ["Miscellaneous"] = "Diverses", + ["Quest"] = "Quest", + ["Raid"] = "Schlachtzug", + ["Tradeskill"] = "Handelsf\195\164higkeit", + ["UnitFrame"] = "UnitFrame", + } +elseif GetLocale() == "esES" then + STANDBY = "|cffff5050(Espera)|r" + + TITLE = "T\195\173tulo" + NOTES = "Notas" + VERSION = "Versi\195\179n" + AUTHOR = "Autor" + DATE = "Fecha" + CATEGORY = "Categor\195\173a" + EMAIL = "E-mail" + WEBSITE = "Sitio de Web" + + ABOUT = "Sobre" + PRINT_ADDON_INFO = "Publica informaci\195\179n sobre addon" + + CATEGORIES = { + ["Action Bars"] = "Barras de Acci\195\179n", + ["Auction"] = "Subasta", + ["Audio"] = "Audio", + ["Battlegrounds/PvP"] = "Campos de Batalla/JcJ", + ["Buffs"] = "Buffs", + ["Chat/Communication"] = "Chat/Communicaci\195\179n", + ["Druid"] = "Druida", + ["Hunter"] = "Cazador", + ["Mage"] = "Mago", + ["Paladin"] = "Palad\195\173n", + ["Priest"] = "Sacerdote", + ["Rogue"] = "P\195\173caro", + ["Shaman"] = "Cham\195\161n", + ["Warlock"] = "Brujo", + ["Warrior"] = "Guerrero", + ["Healer"] = "Sanador", + ["Tank"] = "Tanque", + ["Caster"] = "Hechicero", + ["Combat"] = "Combate", + ["Compilations"] = "Compilaciones", + ["Data Export"] = "Exporta de Datos", + ["Development Tools"] = "Herramientas de Desarrollo", + ["Guild"] = "Hermandad", + ["Frame Modification"] = "Modificaci\195\179n del marco", + ["Interface Enhancements"] = "Mejora de Interfaz", + ["Inventory"] = "Inventario", + ["Library"] = "Biblioteca", + ["Map"] = "Mapa", + ["Mail"] = "Correo", + ["Miscellaneous"] = "Diverso", + ["Quest"] = "Misi\195\179n", + ["Raid"] = "Banda", + ["Tradeskill"] = "Habilidad de Comercio", + ["UnitFrame"] = "Marco de Unidad", + } +elseif GetLocale() == "frFR" then + STANDBY = "|cffff5050(attente)|r" + + TITLE = "Titre" + NOTES = "Notes" + VERSION = "Version" + AUTHOR = "Auteur" + DATE = "Date" + CATEGORY = "Cat\195\169gorie" + EMAIL = "E-mail" + WEBSITE = "Site web" + CREDITS = "Credits" -- fix + COMMANDS = "Commands" + + ABOUT = "A propos" + PRINT_ADDON_INFO = "Afficher les informations sur l'addon" + + CATEGORIES = { + ["Action Bars"] = "Barres d'action", + ["Auction"] = "H\195\180tel des ventes", + ["Audio"] = "Audio", + ["Battlegrounds/PvP"] = "Champs de bataille/JcJ", + ["Buffs"] = "Buffs", + ["Chat/Communication"] = "Chat/Communication", + ["Druid"] = "Druide", + ["Hunter"] = "Chasseur", + ["Mage"] = "Mage", + ["Paladin"] = "Paladin", + ["Priest"] = "Pr\195\170tre", + ["Rogue"] = "Voleur", + ["Shaman"] = "Chaman", + ["Warlock"] = "D\195\169moniste", + ["Warrior"] = "Guerrier", + ["Healer"] = "Soigneur", + ["Tank"] = "Tank", + ["Caster"] = "Casteur", + ["Combat"] = "Combat", + ["Compilations"] = "Compilations", + ["Data Export"] = "Exportation de donn\195\169es", + ["Development Tools"] = "Outils de d\195\169veloppement", + ["Guild"] = "Guilde", + ["Frame Modification"] = "Modification des fen\195\170tres", + ["Interface Enhancements"] = "Am\195\169liorations de l'interface", + ["Inventory"] = "Inventaire", + ["Library"] = "Biblioth\195\168ques", + ["Map"] = "Carte", + ["Mail"] = "Courrier", + ["Miscellaneous"] = "Divers", + ["Quest"] = "Qu\195\170tes", + ["Raid"] = "Raid", + ["Tradeskill"] = "M\195\169tiers", + ["UnitFrame"] = "Fen\195\170tres d'unit\195\169", + } +elseif GetLocale() == "koKR" then + STANDBY = "|cffff5050(사용가능)|r" + + TITLE = "제목" + NOTES = "노트" + VERSION = "버전" + AUTHOR = "저작자" + DATE = "날짜" + CATEGORY = "분류" + EMAIL = "E-mail" + WEBSITE = "웹사이트" + CREDITS = "Credits" -- fix + COMMANDS = "Commands" + + ABOUT = "정보" + PRINT_ADDON_INFO = "애드온 정보 출력" + + CATEGORIES = { + ["Action Bars"] = "액션바", + ["Auction"] = "경매", + ["Audio"] = "음향", + ["Battlegrounds/PvP"] = "전장/PvP", + ["Buffs"] = "버프", + ["Chat/Communication"] = "대화/의사소통", + ["Druid"] = "드루이드", + ["Hunter"] = "사냥꾼", + ["Mage"] = "마법사", + ["Paladin"] = "성기사", + ["Priest"] = "사제", + ["Rogue"] = "도적", + ["Shaman"] = "주술사", + ["Warlock"] = "흑마법사", + ["Warrior"] = "전사", + ["Healer"] = "힐러", + ["Tank"] = "탱커", + ["Caster"] = "캐스터", + ["Combat"] = "전투", + ["Compilations"] = "복합", + ["Data Export"] = "자료 출력", + ["Development Tools"] = "개발 도구", + ["Guild"] = "길드", + ["Frame Modification"] = "구조 변경", + ["Interface Enhancements"] = "인터페이스 강화", + ["Inventory"] = "인벤토리", + ["Library"] = "라이브러리", + ["Map"] = "지도", + ["Mail"] = "우편", + ["Miscellaneous"] = "기타", + ["Quest"] = "퀘스트", + ["Raid"] = "공격대", + ["Tradeskill"] = "전문기술", + ["UnitFrame"] = "유닛 프레임", + } +elseif GetLocale() == "zhTW" then + STANDBY = "|cffff5050(待命)|r" + + TITLE = "標題" + NOTES = "註記" + VERSION = "版本" + AUTHOR = "作者" + DATE = "日期" + CATEGORY = "類別" + EMAIL = "E-mail" + WEBSITE = "網站" + CREDITS = "Credits" -- fix + COMMANDS = "Commands" + + ABOUT = "關於" + PRINT_ADDON_INFO = "顯示插件資訊" + + CATEGORIES = { + ["Action Bars"] = "動作列", + ["Auction"] = "拍賣", + ["Audio"] = "音樂", + ["Battlegrounds/PvP"] = "戰場/PvP", + ["Buffs"] = "增益", + ["Chat/Communication"] = "聊天/通訊", + ["Druid"] = "德魯伊", + ["Hunter"] = "獵人", + ["Mage"] = "法師", + ["Paladin"] = "聖騎士", + ["Priest"] = "牧師", + ["Rogue"] = "盜賊", + ["Shaman"] = "薩滿", + ["Warlock"] = "術士", + ["Warrior"] = "戰士", + ["Healer"] = "治療者", + ["Tank"] = "坦克", + ["Caster"] = "施法者", + ["Combat"] = "戰鬥", + ["Compilations"] = "編輯", + ["Data Export"] = "資料匯出", + ["Development Tools"] = "開發工具", + ["Guild"] = "公會", + ["Frame Modification"] = "框架修改", + ["Interface Enhancements"] = "介面增強", + ["Inventory"] = "背包", + ["Library"] = "資料庫", + ["Map"] = "地圖", + ["Mail"] = "郵件", + ["Miscellaneous"] = "綜合", + ["Quest"] = "任務", + ["Raid"] = "團隊", + ["Tradeskill"] = "商業技能", + ["UnitFrame"] = "單位框架", + } +elseif GetLocale() == "zhCN" then + STANDBY = "|cffff5050(\230\154\130\230\140\130)|r" + + TITLE = "\230\160\135\233\162\152" + NOTES = "\233\153\132\230\179\168" + VERSION = "\231\137\136\230\156\172" + AUTHOR = "\228\189\156\232\128\133" + DATE = "\230\151\165\230\156\159" + CATEGORY = "\229\136\134\231\177\187" + EMAIL = "\231\148\181\229\173\144\233\130\174\228\187\182" + WEBSITE = "\231\189\145\231\171\153" + CREDITS = "Credits" -- fix + COMMANDS = "Commands" + + ABOUT = "\229\133\179\228\186\142" + PRINT_ADDON_INFO = "\229\141\176\229\136\151\229\135\186\230\143\146\228\187\182\228\191\161\230\129\175" + + CATEGORIES = { + ["Action Bars"] = "\229\138\168\228\189\156\230\157\161", + ["Auction"] = "\230\139\141\229\141\150", + ["Audio"] = "\233\159\179\233\162\145", + ["Battlegrounds/PvP"] = "\230\136\152\229\156\186/PvP", + ["Buffs"] = "\229\162\158\231\155\138\233\173\148\230\179\149", + ["Chat/Communication"] = "\232\129\138\229\164\169/\228\186\164\230\181\129", + ["Druid"] = "\229\190\183\233\178\129\228\188\138", + ["Hunter"] = "\231\140\142\228\186\186", + ["Mage"] = "\230\179\149\229\184\136", + ["Paladin"] = "\229\156\163\233\170\145\229\163\171", + ["Priest"] = "\231\137\167\229\184\136", + ["Rogue"] = "\231\155\151\232\180\188", + ["Shaman"] = "\232\144\168\230\187\161\231\165\173\229\143\184", + ["Warlock"] = "\230\156\175\229\163\171", + ["Warrior"] = "\230\136\152\229\163\171", +-- ["Healer"] = "\230\178\187\231\150\151\228\191\157\233\154\156", +-- ["Tank"] = "\232\191\145\230\136\152\230\142\167\229\136\182", +-- ["Caster"] = "\232\191\156\231\168\139\232\190\147\229\135\186", + ["Combat"] = "\230\136\152\230\150\151", + ["Compilations"] = "\231\188\150\232\175\145", + ["Data Export"] = "\230\149\176\230\141\174\229\175\188\229\135\186", + ["Development Tools"] = "\229\188\128\229\143\145\229\183\165\229\133\183", + ["Guild"] = "\229\133\172\228\188\154", + ["Frame Modification"] = "\230\161\134\230\158\182\228\191\174\230\148\185", + ["Interface Enhancements"] = "\231\149\140\233\157\162\229\162\158\229\188\186", + ["Inventory"] = "\232\131\140\229\140\133", + ["Library"] = "\229\186\147", + ["Map"] = "\229\156\176\229\155\190", + ["Mail"] = "\233\130\174\228\187\182", + ["Miscellaneous"] = "\230\157\130\233\161\185", + ["Quest"] = "\228\187\187\229\138\161", + ["Raid"] = "\229\155\162\233\152\159", + ["Tradeskill"] = "\229\149\134\228\184\154\230\138\128\232\131\189", + ["UnitFrame"] = "\229\164\180\229\131\143\230\161\134\230\158\182", + } +elseif GetLocale() == "ruRU" then + STANDBY = "|cffff5050(в режиме ожидания)|r" + + TITLE = "Название" + NOTES = "Описание" + VERSION = "Версия" + AUTHOR = "Автор" + DATE = "Дата" + CATEGORY = "Категория" + EMAIL = "E-mail" + WEBSITE = "Сайт" + CREDITS = "Титры" + COMMANDS = "Команды" + + ABOUT = "Об аддоне" + PRINT_ADDON_INFO = "Показать информацию об аддоне." + + CATEGORIES = { + ["Action Bars"] = "Панели команд", + ["Auction"] = "Аукцион", + ["Audio"] = "Аудио", + ["Battlegrounds/PvP"] = "Поля сражений/PvP", + ["Buffs"] = "Баффы", + ["Chat/Communication"] = "Чат/Коммуникация", + ["Druid"] = "Друид", + ["Hunter"] = "Охотник", + ["Mage"] = "Маг", + ["Paladin"] = "Паладин", + ["Priest"] = "Жрец", + ["Rogue"] = "Разбойник", + ["Shaman"] = "Шаман", + ["Warlock"] = "Чернокнижник", + ["Warrior"] = "Воин", + ["Healer"] = "Лекарь", + ["Tank"] = "Танк", + ["Caster"] = "Кастер", + ["Combat"] = "Сражения", + ["Compilations"] = "Компиляция", + ["Data Export"] = "Экспорт данных", + ["Development Tools"] = "Инструменты разработчика", + ["Guild"] = "Гильдия", + ["Frame Modification"] = "Модификация фреймов", + ["Interface Enhancements"] = "Улучшение интерфейса", + ["Inventory"] = "Инвентарь", + ["Library"] = "Библиотеки", + ["Map"] = "Карта", + ["Mail"] = "Почта", + ["Miscellaneous"] = "Разное", + ["Quest"] = "Задания", + ["Raid"] = "Рейд", + ["Tradeskill"] = "Умения", + ["UnitFrame"] = "Фреймы персонажей", + } + else -- enUS + STANDBY = "|cffff5050(standby)|r" + + TITLE = "Title" + NOTES = "Notes" + VERSION = "Version" + AUTHOR = "Author" + DATE = "Date" + CATEGORY = "Category" + EMAIL = "E-mail" + WEBSITE = "Website" + CREDITS = "Credits" + COMMANDS = "Commands" + + ABOUT = "About" + PRINT_ADDON_INFO = "Print out addon info" + + CATEGORIES = { + ["Action Bars"] = "Action Bars", + ["Auction"] = "Auction", + ["Audio"] = "Audio", + ["Battlegrounds/PvP"] = "Battlegrounds/PvP", + ["Buffs"] = "Buffs", + ["Chat/Communication"] = "Chat/Communication", + ["Druid"] = "Druid", + ["Hunter"] = "Hunter", + ["Mage"] = "Mage", + ["Paladin"] = "Paladin", + ["Priest"] = "Priest", + ["Rogue"] = "Rogue", + ["Shaman"] = "Shaman", + ["Warlock"] = "Warlock", + ["Warrior"] = "Warrior", + ["Healer"] = "Healer", + ["Tank"] = "Tank", + ["Caster"] = "Caster", + ["Combat"] = "Combat", + ["Compilations"] = "Compilations", + ["Data Export"] = "Data Export", + ["Development Tools"] = "Development Tools", + ["Guild"] = "Guild", + ["Frame Modification"] = "Frame Modification", + ["Interface Enhancements"] = "Interface Enhancements", + ["Inventory"] = "Inventory", + ["Library"] = "Library", + ["Map"] = "Map", + ["Mail"] = "Mail", + ["Miscellaneous"] = "Miscellaneous", + ["Quest"] = "Quest", + ["Raid"] = "Raid", + ["Tradeskill"] = "Tradeskill", + ["UnitFrame"] = "UnitFrame", + } +end + +setmetatable(CATEGORIES, { __index = function(self, key) -- case-insensitive + local lowerKey = string.lower(key) + for k,v in pairs(CATEGORIES) do + if string.lower(k) == lowerKey then + return v + end + end +end }) + +-- Create the library object + +local AceOO = AceLibrary("AceOO-2.0") +local AceAddon = AceOO.Class() +local AceEvent +local AceConsole +local AceModuleCore + +function AceAddon:ToString() + return "AceAddon" +end + +local function print(text) + DEFAULT_CHAT_FRAME:AddMessage(text) +end + +function AceAddon:ADDON_LOADED(name) + while table.getn(self.nextAddon) > 0 do + local addon = table.remove(self.nextAddon, 1) + table.insert(self.addons, addon) + if not self.addons[name] then + self.addons[name] = addon + end + self:InitializeAddon(addon, name) + end +end + +local function RegisterOnEnable(self) + if DEFAULT_CHAT_FRAME and DEFAULT_CHAT_FRAME.defaultLanguage then -- HACK + AceAddon.playerLoginFired = true + end + if AceAddon.playerLoginFired then + AceAddon.addonsStarted[self] = true + if (type(self.IsActive) ~= "function" or self:IsActive()) and (not AceModuleCore or not AceModuleCore:IsModule(self) or AceModuleCore:IsModuleActive(self)) then + local current = self.class + while true do + if current == AceOO.Class then + break + end + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedEnable) == "function" then + safecall(mixin.OnEmbedEnable,mixin,self) + end + end + end + current = current.super + end + if type(self.OnEnable) == "function" then + safecall(self.OnEnable,self) + end + if AceEvent then + AceEvent:TriggerEvent("Ace2_AddonEnabled", self) + end + end + else + if not AceAddon.addonsToOnEnable then + AceAddon.addonsToOnEnable = {} + end + table.insert(AceAddon.addonsToOnEnable, self) + end +end + +local function stripSpaces(text) + if type(text) == "string" then + return (string.gsub(string.gsub(text, "^%s*(.-)%s*$", "%1"), "%s%s+", " ")) + end + return text +end + +function AceAddon:InitializeAddon(addon, name) + if addon.name == nil then + addon.name = name + end + if GetAddOnMetadata then + -- TOC checks + if addon.title == nil then + addon.title = GetAddOnMetadata(name, "Title") + end + if addon.title then + local num = string.find(addon.title, " |cff7fff7f %-Ace2%-|r$") + if num then + addon.title = string.sub(addon.title, 1, num - 1) + end + addon.title = stripSpaces(addon.title) + end + + if addon.notes == nil then + addon.notes = GetAddOnMetadata(name, "Notes") + addon.notes = stripSpaces(addon.notes) + end + if addon.version == nil then + addon.version = GetAddOnMetadata(name, "Version") + end + if addon.version then + if string.find(addon.version, "%$Revision: (%d+) %$") then + addon.version = string.gsub(addon.version, "%$Revision: (%d+) %$", "%1") + elseif string.find(addon.version, "%$Rev: (%d+) %$") then + addon.version = string.gsub(addon.version, "%$Rev: (%d+) %$", "%1") + elseif string.find(addon.version, "%$LastChangedRevision: (%d+) %$") then + addon.version = string.gsub(addon.version, "%$LastChangedRevision: (%d+) %$", "%1") + end + end + addon.version = stripSpaces(addon.version) + if addon.author == nil then + addon.author = GetAddOnMetadata(name, "Author") + addon.author = stripSpaces(addon.author) + end + if addon.credits == nil then + addon.credits = GetAddOnMetadata(name, "X-Credits") + addon.credits = stripSpaces(addon.credits) + end + if addon.date == nil then + addon.date = GetAddOnMetadata(name, "X-Date") or GetAddOnMetadata(name, "X-ReleaseDate") + end + if addon.date then + if string.find(addon.date, "%$Date: (.-) %$") then + addon.date = string.gsub(addon.date, "%$Date: (.-) %$", "%1") + elseif string.find(addon.date, "%$LastChangedDate: (.-) %$") then + addon.date = string.gsub(addon.date, "%$LastChangedDate: (.-) %$", "%1") + end + end + addon.date = stripSpaces(addon.date) + + if addon.category == nil then + addon.category = GetAddOnMetadata(name, "X-Category") + addon.category = stripSpaces(addon.category) + end + if addon.email == nil then + addon.email = GetAddOnMetadata(name, "X-eMail") or GetAddOnMetadata(name, "X-Email") + addon.email = stripSpaces(addon.email) + end + if addon.website == nil then + addon.website = GetAddOnMetadata(name, "X-Website") + addon.website = stripSpaces(addon.website) + end + if addon.commands == nil then + addon.commands = GetAddOnMetadata(name, "X-Commands") + addon.commands = stripSpaces(addon.commands) + end + end + local current = addon.class + while true do + if current == AceOO.Class then + break + end + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedInitialize) == "function" then + mixin:OnEmbedInitialize(addon, name) + end + end + end + current = current.super + end + if type(addon.OnInitialize) == "function" then + safecall(addon.OnInitialize, addon, name) + end + if AceEvent then + AceEvent:TriggerEvent("Ace2_AddonInitialized", addon) + end + RegisterOnEnable(addon) +end + +function AceAddon.prototype:PrintAddonInfo() + local x + if self.title then + x = "|cffffff7f" .. tostring(self.title) .. "|r" + elseif self.name then + x = "|cffffff7f" .. tostring(self.name) .. "|r" + else + x = "|cffffff7f<" .. tostring(self.class) .. " instance>|r" + end + if type(self.IsActive) == "function" then + if not self:IsActive() then + x = x .. " " .. STANDBY + end + end + if self.version then + x = x .. " - |cffffff7f" .. tostring(self.version) .. "|r" + end + if self.notes then + x = x .. " - " .. tostring(self.notes) + end + print(x) + if self.author then + print(" - |cffffff7f" .. AUTHOR .. ":|r " .. tostring(self.author)) + end + if self.credits then + print(" - |cffffff7f" .. CREDITS .. ":|r " .. tostring(self.credits)) + end + if self.date then + print(" - |cffffff7f" .. DATE .. ":|r " .. tostring(self.date)) + end + if self.category then + local category = CATEGORIES[self.category] + if category then + print(" - |cffffff7f" .. CATEGORY .. ":|r " .. category) + end + end + if self.email then + print(" - |cffffff7f" .. EMAIL .. ":|r " .. tostring(self.email)) + end + if self.website then + print(" - |cffffff7f" .. WEBSITE .. ":|r " .. tostring(self.website)) + end + if self.commands then + print(" - |cffffff7f" .. COMMANDS .. ":|r " .. tostring(self.commands)) + end +end + +local options +function AceAddon:GetAceOptionsDataTable(target) + if not options then + options = { + about = { + name = ABOUT, + desc = PRINT_ADDON_INFO, + type = "execute", + func = "PrintAddonInfo", + order = -1, + } + } + end + return options +end + +function AceAddon:PLAYER_LOGIN() + self.playerLoginFired = true + if self.addonsToOnEnable then + while table.getn(self.addonsToOnEnable) > 0 do + local addon = table.remove(self.addonsToOnEnable, 1) + self.addonsStarted[addon] = true + if (type(addon.IsActive) ~= "function" or addon:IsActive()) and (not AceModuleCore or not AceModuleCore:IsModule(addon) or AceModuleCore:IsModuleActive(addon)) then + local current = addon.class + while true do + if current == AceOO.Class then + break + end + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedEnable) == "function" then + safecall(mixin.OnEmbedEnable,mixin,addon) + end + end + end + current = current.super + end + if type(addon.OnEnable) == "function" then + safecall(addon.OnEnable,addon) + end + if AceEvent then + AceEvent:TriggerEvent("Ace2_AddonEnabled", addon) + end + end + end + self.addonsToOnEnable = nil + end +end + +function AceAddon.prototype:Inject(t) + AceAddon:argCheck(t, 2, "table") + for k,v in pairs(t) do + self[k] = v + end +end + +function AceAddon.prototype:init() + if not AceEvent then + error(MAJOR_VERSION .. " requires AceEvent-2.0", 4) + end + AceAddon.super.prototype.init(self) + + self.super = self.class.prototype + + AceAddon:RegisterEvent("ADDON_LOADED", "ADDON_LOADED", true) + table.insert(AceAddon.nextAddon, self) +end + +function AceAddon.prototype:ToString() + local x + if type(self.title) == "string" then + x = self.title + elseif type(self.name) == "string" then + x = self.name + else + x = "<" .. tostring(self.class) .. " instance>" + end + if (type(self.IsActive) == "function" and not self:IsActive()) or (AceModuleCore and AceModuleCore:IsModule(addon) and AceModuleCore:IsModuleActive(addon)) then + x = x .. " " .. STANDBY + end + return x +end + +AceAddon.new = function(self, m1, m2, m3, m4, m5, m6, m7, m8, m9, m10, m11, m12, m13, m14, m15, m16, m17, m18, m19, m20) + local class = AceAddon:pcall(AceOO.Classpool, self, m1, m2, m3, m4, m5, m6, m7, m8, m9, m10, m11, m12, m13, m14, m15, m16, m17, m18, m19, m20) + return class:new() +end + +local function external(self, major, instance) + if major == "AceEvent-2.0" then + AceEvent = instance + + AceEvent:embed(self) + + self:RegisterEvent("PLAYER_LOGIN", "PLAYER_LOGIN", true) + elseif major == "AceConsole-2.0" then + AceConsole = instance + + local slashCommands = { "/ace2" } + local _,_,_,enabled,loadable = GetAddOnInfo("Ace") + if not enabled or not loadable then + table.insert(slashCommands, "/ace") + end + local function listAddon(addon, depth) + if not depth then + depth = 0 + end + + local s = string.rep(" ", depth) .. " - " .. tostring(addon) + if rawget(addon, 'version') then + s = s .. " - |cffffff7f" .. tostring(addon.version) .. "|r" + end + if rawget(addon, 'slashCommand') then + s = s .. " |cffffff7f(" .. tostring(addon.slashCommand) .. ")|r" + end + print(s) + if type(rawget(addon, 'modules')) == "table" then + local i = 0 + for k,v in pairs(addon.modules) do + i = i + 1 + if i == 6 then + print(string.rep(" ", depth + 1) .. " - more...") + break + else + listAddon(v, depth + 1) + end + end + end + end + local function listNormalAddon(i) + local name,_,_,enabled,loadable = GetAddOnInfo(i) + if not loadable then + enabled = false + end + if self.addons[name] then + local addon = self.addons[name] + if not AceCoreAddon or not AceCoreAddon:IsModule(addon) then + listAddon(addon) + end + else + local s = " - " .. tostring(GetAddOnMetadata(i, "Title") or name) + local version = GetAddOnMetadata(i, "Version") + if version then + if string.find(version, "%$Revision: (%d+) %$") then + version = string.gsub(version, "%$Revision: (%d+) %$", "%1") + elseif string.find(version, "%$Rev: (%d+) %$") then + version = string.gsub(version, "%$Rev: (%d+) %$", "%1") + elseif string.find(version, "%$LastChangedRevision: (%d+) %$") then + version = string.gsub(version, "%$LastChangedRevision: (%d+) %$", "%1") + end + s = s .. " - |cffffff7f" .. version .. "|r" + end + if not enabled then + s = s .. " |cffff0000(disabled)|r" + end + if IsAddOnLoadOnDemand(i) then + s = s .. " |cff00ff00[LoD]|r" + end + print(s) + end + end + local function mySort(alpha, bravo) + return tostring(alpha) < tostring(bravo) + end + AceConsole.RegisterChatCommand(self, slashCommands, { + desc = "AddOn development framework", + name = "Ace2", + type = "group", + args = { + about = { + desc = "Get information about Ace2", + name = "About", + type = "execute", + func = function() + print("|cffffff7fAce2|r - |cffffff7f2.0." .. string.gsub(MINOR_VERSION, "%$Revision: (%d+) %$", "%1") .. "|r - AddOn development framework") + print(" - |cffffff7f" .. AUTHOR .. ":|r Ace Development Team") + print(" - |cffffff7f" .. WEBSITE .. ":|r http://www.wowace.com/") + end + }, + list = { + desc = "List addons", + name = "List", + type = "group", + args = { + ace2 = { + desc = "List addons using Ace2", + name = "Ace2", + type = "execute", + func = function() + print("|cffffff7fAddon list:|r") + local AceCoreAddon = AceLibrary:HasInstance("AceCoreAddon-2.0") and AceLibrary("AceCoreAddon-2.0") + table.sort(self.addons, mySort) + for _,v in ipairs(self.addons) do + if not AceCoreAddon or not AceCoreAddon:IsModule(v) then + listAddon(v) + end + end + end + }, + all = { + desc = "List all addons", + name = "All", + type = "execute", + func = function() + print("|cffffff7fAddon list:|r") + local AceCoreAddon = AceLibrary:HasInstance("AceCoreAddon-2.0") and AceLibrary("AceCoreAddon-2.0") + local count = GetNumAddOns() + for i = 1, count do + listNormalAddon(i) + end + end + }, + enabled = { + desc = "List all enabled addons", + name = "Enabled", + type = "execute", + func = function() + print("|cffffff7fAddon list:|r") + local AceCoreAddon = AceLibrary:HasInstance("AceCoreAddon-2.0") and AceLibrary("AceCoreAddon-2.0") + local count = GetNumAddOns() + for i = 1, count do + local _,_,_,enabled,loadable = GetAddOnInfo(i) + if enabled and loadable then + listNormalAddon(i) + end + end + end + }, + disabled = { + desc = "List all disabled addons", + name = "Disabled", + type = "execute", + func = function() + print("|cffffff7fAddon list:|r") + local AceCoreAddon = AceLibrary:HasInstance("AceCoreAddon-2.0") and AceLibrary("AceCoreAddon-2.0") + local count = GetNumAddOns() + for i = 1, count do + local _,_,_,enabled,loadable = GetAddOnInfo(i) + if not enabled or not loadable then + listNormalAddon(i) + end + end + end + }, + lod = { + desc = "List all LoadOnDemand addons", + name = "LoadOnDemand", + type = "execute", + func = function() + print("|cffffff7fAddon list:|r") + local AceCoreAddon = AceLibrary:HasInstance("AceCoreAddon-2.0") and AceLibrary("AceCoreAddon-2.0") + local count = GetNumAddOns() + for i = 1, count do + if IsAddOnLoadOnDemand(i) then + listNormalAddon(i) + end + end + end + }, + ace1 = { + desc = "List all addons using Ace1", + name = "Ace 1.x", + type = "execute", + func = function() + print("|cffffff7fAddon list:|r") + local count = GetNumAddOns() + for i = 1, count do + local dep1, dep2, dep3, dep4 = GetAddOnDependencies(i) + if dep1 == "Ace" or dep2 == "Ace" or dep3 == "Ace" or dep4 == "Ace" then + listNormalAddon(i) + end + end + end + }, + libs = { + desc = "List all libraries using AceLibrary", + name = "Libraries", + type = "execute", + func = function() + if type(AceLibrary) == "table" and type(AceLibrary.libs) == "table" then + print("|cffffff7fLibrary list:|r") + for name, data in pairs(AceLibrary.libs) do + local s + if data.minor then + s = " - " .. tostring(name) .. "." .. tostring(data.minor) + else + s = " - " .. tostring(name) + end + if AceLibrary(name).slashCommand then + s = s .. " |cffffff7f(" .. tostring(AceLibrary(name).slashCommand) .. "|cffffff7f)" + end + print(s) + end + end + end + }, + search = { + desc = "Search by name", + name = "Search", + type = "text", + usage = "", + input = true, + get = false, + set = function(...) + for i,v in ipairs(arg) do + arg[i] = string.lower(string.gsub(string.gsub(v, '%*', '.*'), '%%', '%%%%')) + end + local count = GetNumAddOns() + for i = 1, count do + local name = GetAddOnInfo(i) + local good = true + for _,v in ipairs(arg) do + if not string.find(string.lower(name), v) then + good = false + break + end + end + if good then + listNormalAddon(i) + end + end + end + } + }, + }, + enable = { + desc = "Enable addon", + name = "Enable", + type = "text", + usage = "", + get = false, + set = function(text) + local name,title,_,_,_,reason = GetAddOnInfo(text) + if reason == "MISSING" then + print(string.format("|cffffff7fAce2:|r AddOn %q does not exist", text)) + else + EnableAddOn(text) + print(string.format("|cffffff7fAce2:|r %s is now enabled", title or name)) + end + end, + }, + disable = { + desc = "Disable addon", + name = "Disable", + type = "text", + usage = "", + get = false, + set = function(text) + local name,title,_,_,_,reason = GetAddOnInfo(text) + if reason == "MISSING" then + print(string.format("|cffffff7fAce2:|r AddOn %q does not exist", text)) + else + DisableAddOn(text) + print(string.format("|cffffff7fAce2:|r %s is now disabled", title or name)) + end + end, + }, + load = { + desc = "Load addon", + name = "Load", + type = "text", + usage = "", + get = false, + set = function(text) + local name,title,_,_,loadable,reason = GetAddOnInfo(text) + if reason == "MISSING" then + print(string.format("|cffffff7fAce2:|r AddOn %q does not exist.", text)) + elseif not loadable then + print(string.format("|cffffff7fAce2:|r AddOn %q is not loadable. Reason: %s", text, reason)) + else + LoadAddOn(text) + print(string.format("|cffffff7fAce2:|r %s is now loaded", title or name)) + end + end + }, + info = { + desc = "Display information", + name = "Information", + type = "execute", + func = function() + local mem, threshold = gcinfo() + print(string.format(" - |cffffff7fMemory usage [|r%.3f MiB|cffffff7f]|r", mem / 1024)) + print(string.format(" - |cffffff7fThreshold [|r%.3f MiB|cffffff7f]|r", threshold / 1024)) + print(string.format(" - |cffffff7fFramerate [|r%.0f fps|cffffff7f]|r", GetFramerate())) + local bandwidthIn, bandwidthOut, latency = GetNetStats() + bandwidthIn, bandwidthOut = floor(bandwidthIn * 1024), floor(bandwidthOut * 1024) + print(string.format(" - |cffffff7fLatency [|r%.0f ms|cffffff7f]|r", latency)) + print(string.format(" - |cffffff7fBandwidth in [|r%.0f B/s|cffffff7f]|r", bandwidthIn)) + print(string.format(" - |cffffff7fBandwidth out [|r%.0f B/s|cffffff7f]|r", bandwidthOut)) + print(string.format(" - |cffffff7fTotal addons [|r%d|cffffff7f]|r", GetNumAddOns())) + print(string.format(" - |cffffff7fAce2 addons [|r%d|cffffff7f]|r", table.getn(self.addons))) + local ace = 0 + local enabled = 0 + local disabled = 0 + local lod = 0 + for i = 1, GetNumAddOns() do + local dep1, dep2, dep3, dep4 = GetAddOnDependencies(i) + if dep1 == "Ace" or dep2 == "Ace" or dep3 == "Ace" or dep4 == "Ace" then + ace = ace + 1 + end + if IsAddOnLoadOnDemand(i) then + lod = lod + 1 + end + local _,_,_,IsActive,loadable = GetAddOnInfo(i) + if not IsActive or not loadable then + disabled = disabled + 1 + else + enabled = enabled + 1 + end + end + print(string.format(" - |cffffff7fAce 1.x addons [|r%d|cffffff7f]|r", ace)) + print(string.format(" - |cffffff7fLoadOnDemand addons [|r%d|cffffff7f]|r", lod)) + print(string.format(" - |cffffff7fenabled addons [|r%d|cffffff7f]|r", enabled)) + print(string.format(" - |cffffff7fdisabled addons [|r%d|cffffff7f]|r", disabled)) + local libs = 0 + if type(AceLibrary) == "table" and type(AceLibrary.libs) == "table" then + for _ in pairs(AceLibrary.libs) do + libs = libs + 1 + end + end + print(string.format(" - |cffffff7fAceLibrary instances [|r%d|cffffff7f]|r", libs)) + end + } + } + }) + elseif major == "AceModuleCore-2.0" then + AceModuleCore = instance + end +end + +local function activate(self, oldLib, oldDeactivate) + AceAddon = self + + if oldLib then + self.playerLoginFired = oldLib.playerLoginFired or DEFAULT_CHAT_FRAME and DEFAULT_CHAT_FRAME.defaultLanguage + self.addonsToOnEnable = oldLib.addonsToOnEnable + self.addons = oldLib.addons + self.nextAddon = oldLib.nextAddon + self.addonsStarted = oldLib.addonsStarted + end + if not self.addons then + self.addons = {} + end + if not self.nextAddon then + self.nextAddon = {} + end + if not self.addonsStarted then + self.addonsStarted = {} + end + if oldDeactivate then + oldDeactivate(oldLib) + end +end + +AceLibrary:Register(AceAddon, MAJOR_VERSION, MINOR_VERSION, activate, nil, external) +AceAddon = AceLibrary(MAJOR_VERSION) diff --git a/Payload/Interface/Addons/SuperAPI/libs/AceConsole-2.0/AceConsole-2.0.lua b/Payload/Interface/Addons/SuperAPI/libs/AceConsole-2.0/AceConsole-2.0.lua new file mode 100644 index 0000000..d4d2f2a --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/AceConsole-2.0/AceConsole-2.0.lua @@ -0,0 +1,1920 @@ +--[[ +Name: AceConsole-2.0 +Revision: $Rev: 17638 $ +Developed by: The Ace Development Team (http://www.wowace.com/index.php/The_Ace_Development_Team) +Inspired By: Ace 1.x by Turan (turan@gryphon.com) +Website: http://www.wowace.com/ +Documentation: http://www.wowace.com/index.php/AceConsole-2.0 +SVN: http://svn.wowace.com/root/trunk/Ace2/AceConsole-2.0 +Description: Mixin to allow for input/output capabilities. This uses the + AceOptions data table format to determine input. + http://wiki.wowace.com/index.php/AceOptions_data_table +Dependencies: AceLibrary, AceOO-2.0 +]] + +local MAJOR_VERSION = "AceConsole-2.0" +local MINOR_VERSION = "$Revision: 17639 $" + +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary.") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +if loadstring("return function(...) return ... end") and AceLibrary:HasInstance(MAJOR_VERSION) then return end -- lua51 check +if not AceLibrary:HasInstance("AceOO-2.0") then error(MAJOR_VERSION .. " requires AceOO-2.0.") end + +local MAP_ONOFF, USAGE, IS_CURRENTLY_SET_TO, IS_NOW_SET_TO, IS_NOT_A_VALID_OPTION_FOR, IS_NOT_A_VALID_VALUE_FOR, NO_OPTIONS_AVAILABLE, OPTION_HANDLER_NOT_FOUND, OPTION_HANDLER_NOT_VALID, OPTION_IS_DISABLED +if GetLocale() == "deDE" then + MAP_ONOFF = { [false] = "|cffff0000Aus|r", [true] = "|cff00ff00An|r" } + USAGE = "Benutzung" + IS_CURRENTLY_SET_TO = "|cffffff7f%s|r steht momentan auf |cffffff7f[|r%s|cffffff7f]|r" + IS_NOW_SET_TO = "|cffffff7f%s|r ist nun auf |cffffff7f[|r%s|cffffff7f]|r gesetzt" + IS_NOT_A_VALID_OPTION_FOR = "[|cffffff7f%s|r] ist keine g\195\188ltige Option f\195\188r |cffffff7f%s|r" + IS_NOT_A_VALID_VALUE_FOR = "[|cffffff7f%s|r] ist kein g\195\188ltiger Wert f\195\188r |cffffff7f%s|r" + NO_OPTIONS_AVAILABLE = "Keine Optionen verfügbar" + OPTION_HANDLER_NOT_FOUND = "Optionen handler |cffffff7f%q|r nicht gefunden." + OPTION_HANDLER_NOT_VALID = "Optionen handler nicht g\195\188ltig." + OPTION_IS_DISABLED = "Option |cffffff7f%s|r deaktiviert." +elseif GetLocale() == "esES" then + MAP_ONOFF = { [false] = "|cffff0000Inactivo|r", [true] = "|cff00ff00Activo|r" } + USAGE = "Uso" + IS_CURRENTLY_SET_TO = "|cffffff7f%s|r es asignado a |cffffff7f[|r%s|cffffff7f]|r" + IS_NOW_SET_TO = "|cffffff7f%s|r es asignado a |cffffff7f[|r%s|cffffff7f]|r" + IS_NOT_A_VALID_OPTION_FOR = "[|cffffff7f%s|r] no es opción válida para |cffffff7f%s|r" + IS_NOT_A_VALID_VALUE_FOR = "[|cffffff7f%s|r] no es valor válido para |cffffff7f%s|r" + NO_OPTIONS_AVAILABLE = "No hay opciones" + OPTION_HANDLER_NOT_FOUND = "Operario de opción |cffffff7f%q|r no se encuentra." + OPTION_HANDLER_NOT_VALID = "Operario de opción no es válido." + OPTION_IS_DISABLED = "La opción |cffffff7f%s|r es desactivado." +elseif GetLocale() == "frFR" then + MAP_ONOFF = { [false] = "|cffff0000Inactif|r", [true] = "|cff00ff00Actif|r" } + USAGE = "Utilisation" + IS_CURRENTLY_SET_TO = "|cffffff7f%s|r est actuellement positionn\195\169 sur |cffffff7f[|r%s|cffffff7f]|r" + IS_NOW_SET_TO = "|cffffff7f%s|r est maintenant positionn\195\169 sur |cffffff7f[|r%s|cffffff7f]|r" + IS_NOT_A_VALID_OPTION_FOR = "[|cffffff7f%s|r] n'est pas une option valide pour |cffffff7f%s|r" + IS_NOT_A_VALID_VALUE_FOR = "[|cffffff7f%s|r] n'est pas une valeur valide pour |cffffff7f%s|r" + NO_OPTIONS_AVAILABLE = "Pas d'options disponibles" + OPTION_HANDLER_NOT_FOUND = "Le gestionnaire d'option |cffffff7f%q|r n'a pas \195\169t\195\169 trouv\195\169." + OPTION_HANDLER_NOT_VALID = "Le gestionnaire d'option n'est pas valide." + OPTION_IS_DISABLED = "L'option |cffffff7f%s|r est d\195\169sactiv\195\169e." +elseif GetLocale() == "koKR" then + MAP_ONOFF = { [false] = "|cffff0000끔|r", [true] = "|cff00ff00켬|r" } + USAGE = "사용법" + IS_CURRENTLY_SET_TO = "|cffffff7f%s|r|1은;는; 현재 상태는 |cffffff7f[|r%s|cffffff7f]|r|1으로;로; 설정되어 있습니다" + IS_NOW_SET_TO = "|cffffff7f%s|r|1을;를; |cffffff7f[|r%s|cffffff7f]|r 상태로 변경합니다" + IS_NOT_A_VALID_OPTION_FOR = "[|cffffff7f%s|r]|1은;는; |cffffff7f%s|r에서 사용불가능한 설정입니다" + IS_NOT_A_VALID_VALUE_FOR = "[|cffffff7f%s|r]|1은;는; |cffffff7f%s|r에서 사용불가능한 설정값입니다" + NO_OPTIONS_AVAILABLE = "가능한 설정이 없습니다" + OPTION_HANDLER_NOT_FOUND = "설정 조정값인 |cffffff7f%q|r|1을;를; 찾지 못했습니다." + OPTION_HANDLER_NOT_VALID = "설정 조정값이 올바르지 않습니다." + OPTION_IS_DISABLED = "|cffffff7f%s|r 설정은 사용할 수 없습니다." +elseif GetLocale() == "zhCN" then + MAP_ONOFF = { [false] = "|cffff0000\229\133\179\233\151\173|r", [true] = "|cff00ff00\229\188\128\229\144\175|r" } + USAGE = "\231\148\168\230\179\149" + IS_CURRENTLY_SET_TO = "|cffffff7f%s|r \229\189\147\229\137\141\232\162\171\232\174\190\231\189\174 |cffffff7f[|r%s|cffffff7f]|r" + IS_NOW_SET_TO = "|cffffff7f%s|r \231\142\176\229\156\168\232\162\171\232\174\190\231\189\174\228\184\186 |cffffff7f[|r%s|cffffff7f]|r" + IS_NOT_A_VALID_OPTION_FOR = "[|cffffff7f%s|r] \228\184\141\230\152\175\228\184\128\228\184\170\230\156\137\230\149\136\231\154\132\233\128\137\233\161\185 \228\184\186 |cffffff7f%s|r" + IS_NOT_A_VALID_VALUE_FOR = "[|cffffff7f%s|r] \228\184\141\230\152\175\228\184\128\228\184\170\230\156\137\230\149\136\229\128\188 \228\184\186 |cffffff7f%s|r" + NO_OPTIONS_AVAILABLE = "\230\178\161\230\156\137\233\128\137\233\161\185\229\143\175\231\148\168" + OPTION_HANDLER_NOT_FOUND = "\233\128\137\233\161\185\229\164\132\231\144\134\231\168\139\229\186\143 |cffffff7f%q|r \230\178\161\230\159\165\230\137\190." + OPTION_HANDLER_NOT_VALID = "\233\128\137\233\161\185\229\164\132\231\144\134\231\168\139\229\186\143 \230\151\160\230\149\136." + OPTION_IS_DISABLED = "\233\128\137\233\161\185 |cffffff7f%s|r \228\184\141\229\174\140\230\149\180." +elseif GetLocale() == "zhTW" then + MAP_ONOFF = { [false] = "|cffff0000關閉|r", [true] = "|cff00ff00開啟|r" } + USAGE = "用法" + IS_CURRENTLY_SET_TO = "|cffffff7f%s|r 目前的設定為 |cffffff7f[|r%s|cffffff7f]|r" + IS_NOW_SET_TO = "|cffffff7f%s|r 現在被設定為 |cffffff7f[|r%s|cffffff7f]|r" + IS_NOT_A_VALID_OPTION_FOR = "[|cffffff7f%s|r] 是一個不符合規定的選項,對 |cffffff7f%s|r" + IS_NOT_A_VALID_VALUE_FOR = "[|cffffff7f%s|r] 是一個不符合規定的數值,對 |cffffff7f%s|r" + NO_OPTIONS_AVAILABLE = "沒有可用的選項處理器。" + OPTION_HANDLER_NOT_FOUND = "找不到 |cffffff7f%q|r 選項處理器。" + OPTION_HANDLER_NOT_VALID = "選項處理器不符合規定。" + OPTION_IS_DISABLED = "|cffffff7f%s|r 已被停用。" +elseif GetLocale() == "ruRU" then + MAP_ONOFF = { [false] = "|cffff0000Выкл|r", [true] = "|cff00ff00Вкл|r" } + USAGE = "Использование" + IS_CURRENTLY_SET_TO = "|cffffff7f%s|r в настоящее время установлен на |cffffff7f[|r%s|cffffff7f]|r" + IS_NOW_SET_TO = "|cffffff7f%s|r теперь установлен |cffffff7f[|r%s|cffffff7f]|r" + IS_NOT_A_VALID_OPTION_FOR = "[|cffffff7f%s|r] - недействительная опция для |cffffff7f%s|r" + IS_NOT_A_VALID_VALUE_FOR = "[|cffffff7f%s|r] - недействительное значение для |cffffff7f%s|r" + NO_OPTIONS_AVAILABLE = "Нет доступных опций" + OPTION_HANDLER_NOT_FOUND = "Оператор опции |cffffff7f%q|r не найден." + OPTION_HANDLER_NOT_VALID = "Оператор опции недействителен." + OPTION_IS_DISABLED = "Опция |cffffff7f%s|r отключена." +else -- enUS + MAP_ONOFF = { [false] = "|cffff0000Off|r", [true] = "|cff00ff00On|r" } + USAGE = "Usage" + IS_CURRENTLY_SET_TO = "|cffffff7f%s|r is currently set to |cffffff7f[|r%s|cffffff7f]|r" + IS_NOW_SET_TO = "|cffffff7f%s|r is now set to |cffffff7f[|r%s|cffffff7f]|r" + IS_NOT_A_VALID_OPTION_FOR = "[|cffffff7f%s|r] is not a valid option for |cffffff7f%s|r" + IS_NOT_A_VALID_VALUE_FOR = "[|cffffff7f%s|r] is not a valid value for |cffffff7f%s|r" + NO_OPTIONS_AVAILABLE = "No options available" + OPTION_HANDLER_NOT_FOUND = "Option handler |cffffff7f%q|r not found." + OPTION_HANDLER_NOT_VALID = "Option handler not valid." + OPTION_IS_DISABLED = "Option |cffffff7f%s|r is disabled." +end + +local NONE = NONE or "None" + +local AceOO = AceLibrary("AceOO-2.0") +local AceEvent + +local AceConsole = AceOO.Mixin { "Print", "PrintComma", "CustomPrint", "RegisterChatCommand" } +local Dewdrop + +local _G = getfenv(0) + +local table_setn +do + local version = GetBuildInfo() + if string.find(version, "^2%.") then + -- 2.0.0 + table_setn = function() end + else + table_setn = table.setn + end +end + +local function print(text, name, r, g, b, frame, delay) + if not text or string.len(text) == 0 then + text = " " + end + if not name or name == AceConsole then + (frame or DEFAULT_CHAT_FRAME):AddMessage(text, r, g, b, nil, delay or 5) + else + (frame or DEFAULT_CHAT_FRAME):AddMessage("|cffffff78" .. tostring(name) .. ":|r " .. text, r, g, b, nil, delay or 5) + end +end + +local tmp +function AceConsole:CustomPrint(r, g, b, frame, delay, connector, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + a1 = tostring(a1) + if string.find(a1, "%%") then + print(string.format(a1, tostring(a2), tostring(a3), tostring(a4), tostring(a5), tostring(a6), tostring(a7), tostring(a8), tostring(a9), tostring(a10), tostring(a11), tostring(a12), tostring(a13), tostring(a14), tostring(a15), tostring(a16), tostring(a17), tostring(a18), tostring(a19), tostring(a20)), self, r, g, b, frame or self.printFrame, delay) + else + if not tmp then + tmp = {} + end + tmp[1] = a1 + tmp[2] = a2 + tmp[3] = a3 + tmp[4] = a4 + tmp[5] = a5 + tmp[6] = a6 + tmp[7] = a7 + tmp[8] = a8 + tmp[9] = a9 + tmp[10] = a10 + tmp[11] = a11 + tmp[12] = a12 + tmp[13] = a13 + tmp[14] = a14 + tmp[15] = a15 + tmp[16] = a16 + tmp[17] = a17 + tmp[18] = a18 + tmp[19] = a19 + tmp[20] = a20 + local n = 20 + while tmp[n] == nil do + n = n - 1 + end + table_setn(tmp, n) + for k = 1, n do + tmp[k] = tostring(tmp[k]) + end + print(table.concat(tmp, connector or " "), self, r, g, b, frame or self.printFrame, delay) + for k,v in pairs(tmp) do + tmp[k] = nil + end + table_setn(tmp, 0) + end +end + +function AceConsole:Print(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + return AceConsole.CustomPrint(self, nil, nil, nil, nil, nil, " ", a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) +end + +function AceConsole:PrintComma(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + return AceConsole.CustomPrint(self, nil, nil, nil, nil, nil, ", ", a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) +end + +local work +local argwork + +local string_gfind = string.gmatch or string.gfind + +local function findTableLevel(self, options, chat, text, index, passTable) + if not index then + index = 1 + if work then + for k,v in pairs(work) do + work[k] = nil + end + table_setn(work, 0) + for k,v in pairs(argwork) do + argwork[k] = nil + end + table_setn(argwork, 0) + else + work = {} + argwork = {} + end + local len = string.len(text) + local count + repeat + text, count = string.gsub(text, "(|cff%x%x%x%x%x%x|Hitem:%d-:%d-:%d-:%d-|h%[[^%]]-) (.-%]|h|r)", "%1\001%2") + until count == 0 + text = string.gsub(text, "(%]|h|r)(|cff%x%x%x%x%x%x|Hitem:%d-:%d-:%d-:%d-|h%[)", "%1 %2") + for token in string_gfind(text, "([^%s]+)") do + local token = token + local num = tonumber(token) + if num then + token = num + else + token = string.gsub(token, "\001", " ") + end + table.insert(work, token) + end + end + + local path = chat + for i = 1, index - 1 do + path = path .. " " .. tostring(work[i]) + end + + if type(options.args) == "table" then + local disabled, hidden = options.disabled, options.cmdHidden or options.hidden + if hidden then + if type(hidden) == "function" then + hidden = hidden() + elseif type(hidden) == "string" then + local handler = options.handler or self + if type(handler[hidden]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, hidden)) + end + hidden = handler[hidden](handler) + end + end + if hidden then + disabled = true + elseif disabled then + if type(disabled) == "function" then + disabled = disabled() + elseif type(disabled) == "string" then + local handler = options.handler or self + if type(handler[disabled]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, disabled)) + end + disabled = handler[disabled](handler) + end + end + if not disabled then + local next = work[index] and string.lower(work[index]) + if next then + for k,v in pairs(options.args) do + local good = false + if string.lower(k) == next then + good = true + elseif type(v.aliases) == "table" then + for _,alias in ipairs(v.aliases) do + if string.lower(alias) == next then + good = true + break + end + end + elseif type(v.aliases) == "string" and string.lower(v.aliases) == next then + good = true + end + if good then + return findTableLevel(options.handler or self, v, chat, text, index + 1, options.pass and options or nil) + end + end + end + end + end + for i = index, table.getn(work) do + table.insert(argwork, work[i]) + end + return options, path, argwork, options.handler or self, passTable, passTable and work[index - 1] +end + +local function validateOptionsMethods(self, options, position) + if type(options) ~= "table" then + return "Options must be a table.", position + end + self = options.handler or self + if options.type == "execute" then + if options.func and type(options.func) ~= "string" and type(options.func) ~= "function" then + return "func must be a string or function", position + end + if options.func and type(options.func) == "string" and type(self[options.func]) ~= "function" then + return string.format("%q is not a proper function", options.func), position + end + else + if options.get then + if type(options.get) ~= "string" and type(options.get) ~= "function" then + return "get must be a string or function", position + end + if type(options.get) == "string" and type(self[options.get]) ~= "function" then + return string.format("%q is not a proper function", options.get), position + end + end + if options.set then + if type(options.set) ~= "string" and type(options.set) ~= "function" then + return "set must be a string or function", position + end + if type(options.set) == "string" and type(self[options.set]) ~= "function" then + return string.format("%q is not a proper function", options.set), position + end + end + if options.validate and type(options.validate) ~= "table" then + if type(options.validate) ~= "string" and type(options.validate) ~= "function" then + return "validate must be a string or function", position + end + if type(options.validate) == "string" and type(self[options.validate]) ~= "function" then + return string.format("%q is not a proper function", options.validate), position + end + end + end + if options.disabled and type(options.disabled) == "string" and type(self[options.disabled]) ~= "function" then + return string.format("%q is not a proper function", options.disabled), position + end + if options.cmdHidden and type(options.cmdHidden) == "string" and type(self[options.cmdHidden]) ~= "function" then + return string.format("%q is not a proper function", options.cmdHidden), position + end + if options.guiHidden and type(options.guiHidden) == "string" and type(self[options.guiHidden]) ~= "function" then + return string.format("%q is not a proper function", options.guiHidden), position + end + if options.hidden and type(options.hidden) == "string" and type(self[options.hidden]) ~= "function" then + return string.format("%q is not a proper function", options.hidden), position + end + if options.type == "group" and type(options.args) == "table" then + for k,v in pairs(options.args) do + if type(v) == "table" then + local newposition + if position then + newposition = position .. ".args." .. k + else + newposition = "args." .. k + end + local err, pos = validateOptionsMethods(self, v, newposition) + if err then + return err, pos + end + end + end + end +end + +local function validateOptions(options, position, baseOptions, fromPass) + if not baseOptions then + baseOptions = options + end + if type(options) ~= "table" then + return "Options must be a table.", position + end + local kind = options.type + if type(kind) ~= "string" then + return '"type" must be a string.', position + elseif kind ~= "group" and kind ~= "range" and kind ~= "text" and kind ~= "execute" and kind ~= "toggle" and kind ~= "color" and kind ~= "header" then + return '"type" must either be "range", "text", "group", "toggle", "execute", "color", or "header".', position + end + if options.aliases then + if type(options.aliases) ~= "table" and type(options.aliases) ~= "string" then + return '"alias" must be a table or string', position + end + end + if not fromPass then + if kind == "execute" then + if type(options.func) ~= "string" and type(options.func) ~= "function" then + return '"func" must be a string or function', position + end + elseif kind == "range" or kind == "text" or kind == "toggle" then + if type(options.set) ~= "string" and type(options.set) ~= "function" then + return '"set" must be a string or function', position + end + if kind == "text" and options.get == false then + elseif type(options.get) ~= "string" and type(options.get) ~= "function" then + return '"get" must be a string or function', position + end + elseif kind == "group" and options.pass then + if options.pass ~= true then + return '"pass" must be either nil, true, or false', position + end + if not options.func then + if type(options.set) ~= "string" and type(options.set) ~= "function" then + return '"set" must be a string or function', position + end + if type(options.get) ~= "string" and type(options.get) ~= "function" then + return '"get" must be a string or function', position + end + elseif type(options.func) ~= "string" and type(options.func) ~= "function" then + return '"func" must be a string or function', position + end + end + else + if kind == "group" then + return 'cannot have "type" = "group" as a subgroup of a passing group', position + end + end + if options ~= baseOptions then + if kind == "header" then + elseif type(options.desc) ~= "string" then + return '"desc" must be a string', position + elseif string.len(options.desc) == 0 then + return '"desc" cannot be a 0-length string', position + end + end + + if options ~= baseOptions or kind == "range" or kind == "text" or kind == "toggle" or kind == "color" then + if options.type == "header" and not options.cmdName and not options.name then + elseif options.cmdName then + if type(options.cmdName) ~= "string" then + return '"cmdName" must be a string or nil', position + elseif string.len(options.cmdName) == 0 then + return '"cmdName" cannot be a 0-length string', position + end + if type(options.guiName) ~= "string" then + if not options.guiNameIsMap then + return '"guiName" must be a string or nil', position + end + elseif string.len(options.guiName) == 0 then + return '"guiName" cannot be a 0-length string', position + end + else + if type(options.name) ~= "string" then + return '"name" must be a string', position + elseif string.len(options.name) == 0 then + return '"name" cannot be a 0-length string', position + end + end + end + if options.guiNameIsMap then + if type(options.guiNameIsMap) ~= "boolean" then + return '"guiNameIsMap" must be a boolean or nil', position + elseif options.type ~= "toggle" then + return 'if "guiNameIsMap" is true, then "type" must be set to \'toggle\'', position + elseif type(options.map) ~= "table" then + return '"map" must be a table', position + end + end + if options.message and type(options.message) ~= "string" then + return '"message" must be a string or nil', position + end + if options.error and type(options.error) ~= "string" then + return '"error" must be a string or nil', position + end + if options.current and type(options.current) ~= "string" then + return '"current" must be a string or nil', position + end + if options.order then + if type(options.order) ~= "number" or (-1 < options.order and options.order < 0.999) then + return '"order" must be a non-zero number or nil', position + end + end + if options.disabled then + if type(options.disabled) ~= "function" and type(options.disabled) ~= "string" and options.disabled ~= true then + return '"disabled" must be a function, string, or boolean', position + end + end + if options.cmdHidden then + if type(options.cmdHidden) ~= "function" and type(options.cmdHidden) ~= "string" and options.cmdHidden ~= true then + return '"cmdHidden" must be a function, string, or boolean', position + end + end + if options.guiHidden then + if type(options.guiHidden) ~= "function" and type(options.guiHidden) ~= "string" and options.guiHidden ~= true then + return '"guiHidden" must be a function, string, or boolean', position + end + end + if options.hidden then + if type(options.hidden) ~= "function" and type(options.hidden) ~= "string" and options.hidden ~= true then + return '"hidden" must be a function, string, or boolean', position + end + end + if kind == "text" then + if type(options.validate) == "table" then + local t = options.validate + local iTable = nil + for k,v in pairs(t) do + if type(k) == "number" then + if iTable == nil then + iTable = true + elseif not iTable then + return '"validate" must either have all keys be indexed numbers or strings', position + elseif k < 1 or k > table.getn(t) then + return '"validate" numeric keys must be indexed properly. >= 1 and <= table.getn', position + end + else + if iTable == nil then + iTable = false + elseif iTable then + return '"validate" must either have all keys be indexed numbers or strings', position + end + end + if type(v) ~= "string" then + return '"validate" values must all be strings', position + end + end + else + if type(options.usage) ~= "string" then + return '"usage" must be a string', position + elseif options.validate and type(options.validate) ~= "string" and type(options.validate) ~= "function" then + return '"validate" must be a string, function, or table', position + end + end + elseif kind == "range" then + if options.min or options.max then + if type(options.min) ~= "number" then + return '"min" must be a number', position + elseif type(options.max) ~= "number" then + return '"max" must be a number', position + elseif options.min >= options.max then + return '"min" must be less than "max"', position + end + end + if options.step then + if type(options.step) ~= "number" then + return '"step" must be a number', position + elseif options.step < 0 then + return '"step" must be nonnegative', position + end + end + if options.isPercent and options.isPercent ~= true then + return '"isPercent" must either be nil, true, or false', position + end + elseif kind == "toggle" then + if options.map then + if type(options.map) ~= "table" then + return '"map" must be a table', position + elseif type(options.map[true]) ~= "string" then + return '"map[true]" must be a string', position + elseif type(options.map[false]) ~= "string" then + return '"map[false]" must be a string', position + end + end + elseif kind == "color" then + if options.hasAlpha and options.hasAlpha ~= true then + return '"hasAlpha" must be nil, true, or false', position + end + elseif kind == "group" then + if options.pass and options.pass ~= true then + return '"pass" must be nil, true, or false', position + end + if type(options.args) ~= "table" then + return '"args" must be a table', position + end + for k,v in pairs(options.args) do + if type(k) ~= "string" then + return '"args" keys must be strings', position + elseif string.find(k, "%s") then + return string.format('"args" keys must not include spaces. %q is not appropriate.', k), position + elseif string.len(k) == 0 then + return '"args" keys must not be 0-length strings.', position + end + if type(v) ~= "table" then + return '"args" values must be tables', position and position .. "." .. k or k + end + local newposition + if position then + newposition = position .. ".args." .. k + else + newposition = "args." .. k + end + local err, pos = validateOptions(v, newposition, baseOptions, options.pass) + if err then + return err, pos + end + end + end +end + +local colorTable +local colorFunc +local colorCancelFunc + +local order + +local mysort_args +local mysort + +local function printUsage(self, handler, realOptions, options, path, args, quiet, filter) + if filter then + filter = "^" .. string.gsub(filter, "([%(%)%.%*%+%-%[%]%?%^%$%%])", "%%%1") + end + local hidden, disabled = options.cmdHidden or options.hidden, options.disabled + if hidden then + if type(hidden) == "function" then + hidden = hidden() + elseif type(hidden) == "string" then + if type(handler[hidden]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, hidden)) + end + hidden = handler[hidden](handler) + end + end + if hidden then + disabled = true + elseif disabled then + if type(disabled) == "function" then + disabled = disabled() + elseif type(disabled) == "string" then + if type(handler[disabled]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, disabled)) + end + disabled = handler[disabled](handler) + end + end + local kind = string.lower(options.type or "group") + if disabled then + print(string.format(OPTION_IS_DISABLED, path), realOptions.cmdName or realOptions.name or self) + elseif kind == "text" then + local var + if passTable then + if not passTable.get then + elseif type(passTable.get) == "function" then + var = passTable.get(passValue) + else + local handler = passTable.handler or handler + if type(handler[passTable.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.get)) + end + var = handler[passTable.get](handler, passValue) + end + else + if not options.get then + elseif type(options.get) == "function" then + var = options.get() + else + local handler = options.handler or handler + if type(handler[options.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.get)) + end + var = handler[options.get](handler) + end + end + + local usage + if type(options.validate) == "table" then + if filter then + if not order then + order = {} + end + for k,v in pairs(options.validate) do + if string.find(v, filter) then + table.insert(order, v) + end + end + usage = "{" .. table.concat(order, " || ") .. "}" + for k in pairs(order) do + order[k] = nil + end + table_setn(order, 0) + else + if not order then + order = {} + end + for k,v in pairs(options.validate) do + table.insert(order, v) + end + usage = "{" .. table.concat(order, " || ") .. "}" + for k in pairs(order) do + order[k] = nil + end + table_setn(order, 0) + end + var = options.validate[var] or var + else + usage = options.usage or "" + end + if not quiet then + print(string.format("|cffffff7f%s:|r %s %s", USAGE, path, usage), realOptions.cmdName or realOptions.name or self) + end + if (passTable and passTable.get) or options.get then + print(string.format(options.current or IS_CURRENTLY_SET_TO, tostring(options.cmdName or options.name), tostring(var or NONE))) + end + elseif kind == "range" then + local var + if passTable then + if type(passTable.get) == "function" then + var = passTable.get(passValue) + else + local handler = passTable.handler or handler + if type(handler[passTable.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.get)) + end + var = handler[passTable.get](handler, passValue) + end + else + if type(options.get) == "function" then + var = options.get() + else + local handler = options.handler or handler + if type(handler[options.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.get)) + end + var = handler[options.get](handler) + end + end + + local usage + local min = options.min or 0 + local max = options.max or 1 + if options.isPercent then + min, max = min * 100, max * 100 + var = tostring(var * 100) .. "%" + end + local bit = "-" + if min < 0 or max < 0 then + bit = " - " + end + usage = string.format("(%s%s%s)", min, bit, max) + if not quiet then + print(string.format("|cffffff7f%s:|r %s %s", USAGE, path, usage), realOptions.cmdName or realOptions.name or self) + end + print(string.format(options.current or IS_CURRENTLY_SET_TO, tostring(options.cmdName or options.name), tostring(var or NONE))) + elseif kind == "group" then + local usage + if next(options.args) then + if not order then + order = {} + end + for k,v in pairs(options.args) do + if v.type ~= "header" then + local hidden = v.cmdHidden or v.hidden + if hidden then + if type(hidden) == "function" then + hidden = hidden() + elseif type(hidden) == "string" then + local handler = v.handler or handler + if type(handler[hidden]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, hidden)) + end + hidden = handler[hidden](handler) + end + end + if not hidden then + if filter then + if string.find(k, filter) then + table.insert(order, k) + elseif type(v.aliases) == "table" then + for _,bit in ipairs(v.aliases) do + if string.find(v.aliases, filter) then + table.insert(order, k) + break + end + end + elseif type(v.aliases) == "string" then + if string.find(v.aliases, filter) then + table.insert(order, k) + end + end + else + table.insert(order, k) + end + end + end + end + if not mysort then + mysort = function(a, b) + local alpha, bravo = mysort_args[a], mysort_args[b] + local alpha_order = alpha and alpha.order or 100 + local bravo_order = bravo and bravo.order or 100 + if alpha_order == bravo_order then + return tostring(a) < tostring(b) + else + if alpha_order < 0 then + if bravo_order > 0 then + return false + end + else + if bravo_order < 0 then + return true + end + end + if alpha_order > 0 and bravo_order > 0 then + return tostring(a) < tostring(b) + end + return alpha_order < bravo_order + end + end + end + mysort_args = options.args + table.sort(order, mysort) + mysort_args = nil + if not quiet then + if options == realOptions then + if options.desc then + print(tostring(options.desc), realOptions.cmdName or realOptions.name or self) + print(string.format("|cffffff7f%s:|r %s %s", USAGE, path, "{" .. table.concat(order, " || ") .. "}")) + elseif self.description or self.notes then + print(tostring(self.description or self.notes), realOptions.cmdName or realOptions.name or self) + print(string.format("|cffffff7f%s:|r %s %s", USAGE, path, "{" .. table.concat(order, " || ") .. "}")) + else + print(string.format("|cffffff7f%s:|r %s %s", USAGE, path, "{" .. table.concat(order, " || ") .. "}"), realOptions.cmdName or realOptions.name or self) + end + else + if options.desc then + print(string.format("|cffffff7f%s:|r %s %s", USAGE, path, "{" .. table.concat(order, " || ") .. "}"), realOptions.cmdName or realOptions.name or self) + print(tostring(options.desc)) + else + print(string.format("|cffffff7f%s:|r %s %s", USAGE, path, "{" .. table.concat(order, " || ") .. "}"), realOptions.cmdName or realOptions.name or self) + end + end + end + for _,k in ipairs(order) do + local v = options.args[k] + if v then + local disabled = v.disabled + if disabled then + if type(disabled) == "function" then + disabled = disabled() + elseif type(disabled) == "string" then + local handler = v.handler or handler + if type(handler[disabled]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, disabled)) + end + disabled = handler[disabled](handler) + end + end + if type(v.aliases) == "table" then + k = k .. " || " .. table.concat(v.aliases, " || ") + elseif type(v.aliases) == "string" then + k = k .. " || " .. v.aliases + end + if v.get then + local a1,a2,a3,a4 + if type(v.get) == "function" then + if options.pass then + a1,a2,a3,a4 = v.get(k) + else + a1,a2,a3,a4 = v.get() + end + else + local handler = v.handler or handler + if type(handler[v.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, v.get)) + end + if options.pass then + a1,a2,a3,a4 = handler[v.get](handler, k) + else + a1,a2,a3,a4 = handler[v.get](handler) + end + end + if v.type == "color" then + if v.hasAlpha then + if not a1 or not a2 or not a3 or not a4 then + s = NONE + else + s = string.format("|c%02x%02x%02x%02x%02x%02x%02x%02x|r", a4*255, a1*255, a2*255, a3*255, a4*255, a1*255, a2*255, a3*255) + end + else + if not a1 or not a2 or not a3 then + s = NONE + else + s = string.format("|cff%02x%02x%02x%02x%02x%02x|r", a1*255, a2*255, a3*255, a1*255, a2*255, a3*255) + end + end + elseif v.type == "toggle" then + if v.map then + s = tostring(v.map[a1 and true or false] or NONE) + else + s = tostring(MAP_ONOFF[a1 and true or false] or NONE) + end + elseif v.type == "range" then + if v.isPercent then + s = tostring(a1 * 100) .. "%" + else + s = tostring(a1) + end + elseif v.type == "text" and type(v.validate) == "table" then + s = tostring(v.validate[a1] or a1) + else + s = tostring(a1 or NONE) + end + if disabled then + local s = string.gsub(s, "|cff%x%x%x%x%x%x(.-)|r", "%1") + local desc = string.gsub(v.desc or NONE, "|cff%x%x%x%x%x%x(.-)|r", "%1") + print(string.format("|cffcfcfcf - %s: [%s] %s|r", k, s, desc)) + else + print(string.format(" - |cffffff7f%s: [|r%s|cffffff7f]|r %s", k, s, v.desc or NONE)) + end + else + if disabled then + local desc = string.gsub(v.desc or NONE, "|cff%x%x%x%x%x%x(.-)|r", "%1") + print(string.format("|cffcfcfcf - %s: %s", k, desc)) + else + print(string.format(" - |cffffff7f%s:|r %s", k, v.desc or NONE)) + end + end + end + end + for k in pairs(order) do + order[k] = nil + end + table_setn(order, 0) + else + if options.desc then + desc = options.desc + print(string.format("|cffffff7f%s:|r %s", USAGE, path), realOptions.cmdName or realOptions.name or self) + print(tostring(options.desc)) + elseif options == realOptions and (self.description or self.notes) then + print(tostring(self.description or self.notes), realOptions.cmdName or realOptions.name or self) + print(string.format("|cffffff7f%s:|r %s", USAGE, path)) + else + print(string.format("|cffffff7f%s:|r %s", USAGE, path), realOptions.cmdName or realOptions.name or self) + end + print(NO_OPTIONS_AVAILABLE) + end + end +end + +local function handlerFunc(self, chat, msg, options) + if not msg then + msg = "" + else + msg = string.gsub(msg, "^%s*(.-)%s*$", "%1") + msg = string.gsub(msg, "%s+", " ") + end + + local realOptions = options + local options, path, args, handler, passTable, passValue = findTableLevel(self, options, chat, msg) + + local hidden, disabled = options.cmdHidden or options.hidden, options.disabled + if hidden then + if type(hidden) == "function" then + hidden = hidden() + elseif type(hidden) == "string" then + if type(handler[hidden]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, hidden)) + end + hidden = handler[hidden](handler) + end + end + if hidden then + disabled = true + elseif disabled then + if type(disabled) == "function" then + disabled = disabled() + elseif type(disabled) == "string" then + if type(handler[disabled]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, disabled)) + end + disabled = handler[disabled](handler) + end + end + local _G_this = this + local kind = string.lower(options.type or "group") + if disabled then + print(string.format(OPTION_IS_DISABLED, path), realOptions.cmdName or realOptions.name or self) + elseif kind == "text" then + if table.getn(args) > 0 then + if (type(options.validate) == "table" and table.getn(args) > 1) or (type(options.validate) ~= "table" and not options.input) then + local arg = table.concat(args, " ") + for k,v in pairs(args) do + args[k] = nil + end + table_setn(args, 0) + table.insert(args, arg) + end + if options.validate then + local good + if type(options.validate) == "function" then + good = options.validate(unpack(args)) + elseif type(options.validate) == "table" then + local arg = args[1] + arg = string.lower(tostring(arg)) + for k,v in pairs(options.validate) do + if string.lower(v) == arg then + args[1] = type(k) == "string" and k or v + good = true + break + end + end + if not good and type((next(options.validate))) == "string" then + for k,v in pairs(options.validate) do + if type(k) == "string" and string.lower(k) == arg then + args[1] = k + good = true + break + end + end + end + else + if type(handler[options.validate]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.validate)) + end + good = handler[options.validate](handler, unpack(args)) + end + if not good then + local usage + if type(options.validate) == "table" then + if not order then + order = {} + end + for k,v in pairs(options.validate) do + table.insert(order, v) + end + usage = "{" .. table.concat(order, " || ") .. "}" + for k in pairs(order) do + order[k] = nil + end + table_setn(order, 0) + else + usage = options.usage or "" + end + print(string.format(options.error or IS_NOT_A_VALID_OPTION_FOR, tostring(table.concat(args, " ")), path), realOptions.cmdName or realOptions.name or self) + print(string.format("|cffffff7f%s:|r %s %s", USAGE, path, usage)) + return + end + end + + local var + if passTable then + if not passTable.get then + elseif type(passTable.get) == "function" then + var = passTable.get(passValue) + else + if type(handler[passTable.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.get)) + end + var = handler[passTable.get](handler, passValue) + end + else + if not options.get then + elseif type(options.get) == "function" then + var = options.get() + else + if type(handler[options.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.get)) + end + var = handler[options.get](handler) + end + end + + if var ~= args[1] then + if passTable then + if type(passTable.set) == "function" then + passTable.set(passValue, unpack(args)) + else + if type(handler[passTable.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.set)) + end + handler[passTable.set](handler, passTable.set, unpack(args)) + end + else + if type(options.set) == "function" then + options.set(unpack(args)) + else + if type(handler[options.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.set)) + end + handler[options.set](handler, unpack(args)) + end + end + end + end + + if table.getn(args) > 0 then + local var + if passTable then + if not passTable.get then + elseif type(passTable.get) == "function" then + var = passTable.get(passValue) + else + if type(handler[passTable.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.get)) + end + var = handler[passTable.get](handler, passValue) + end + else + if not options.get then + elseif type(options.get) == "function" then + var = options.get() + else + if type(handler[options.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.get)) + end + var = handler[options.get](handler) + end + end + if type(options.validate) == "table" then + var = options.validate[var] or var + end + if (passTable and passTable.get) or options.get then + print(string.format(options.message or IS_NOW_SET_TO, tostring(options.cmdName or options.name), tostring(var or NONE)), realOptions.cmdName or realOptions.name or self) + end + if var == args[1] then + return + end + else + printUsage(self, handler, realOptions, options, path, args) + return + end + elseif kind == "execute" then + if passTable then + if type(passFunc) == "function" then + set(passValue) + else + if type(handler[passFunc]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passFunc)) + end + handler[passFunc](handler, passValue) + end + else + local ret, msg + if type(options.func) == "function" then + options.func() + else + local handler = options.handler or self + if type(handler[options.func]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.func)) + end + handler[options.func](handler) + end + end + elseif kind == "toggle" then + local var + if passTable then + if type(passTable.get) == "function" then + var = passTable.get(passValue) + else + if type(handler[passTable.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.get)) + end + var = handler[passTable.get](handler, passValue) + end + if type(passTable.set) == "function" then + passTable.set(passValue, not var) + else + if type(handler[passTable.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.set)) + end + handler[passTable.set](handler, passValue, not var) + end + if type(passTable.get) == "function" then + var = passTable.get(passValue) + else + var = handler[passTable.get](handler, passValue) + end + else + local handler = options.handler or self + if type(options.get) == "function" then + var = options.get() + else + if type(handler[options.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.get)) + end + var = handler[options.get](handler) + end + if type(options.set) == "function" then + options.set(not var) + else + if type(handler[options.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.set)) + end + handler[options.set](handler, not var) + end + if type(options.get) == "function" then + var = options.get() + else + var = handler[options.get](handler) + end + end + + print(string.format(options.message or IS_NOW_SET_TO, tostring(options.cmdName or options.name), (options.map or MAP_ONOFF)[var and true or false] or NONE), realOptions.cmdName or realOptions.name or self) + elseif kind == "range" then + local arg + if table.getn(args) <= 1 then + arg = args[1] + else + arg = table.concat(args, " ") + end + + if arg then + local min = options.min or 0 + local max = options.max or 1 + local good = false + if type(arg) == "number" then + if options.isPercent then + arg = arg / 100 + end + + if arg >= min and arg <= max then + good = true + end + + if good and type(options.step) == "number" and options.step > 0 then + local step = options.step + arg = math.floor((arg - min) / step + 0.5) * step + min + if arg > max then + arg = max + elseif arg < min then + arg = min + end + end + end + if not good then + local usage + local min = options.min or 0 + local max = options.max or 1 + if options.isPercent then + min, max = min * 100, max * 100 + end + local bit = "-" + if min < 0 or max < 0 then + bit = " - " + end + usage = string.format("(%s%s%s)", min, bit, max) + print(string.format(options.error or IS_NOT_A_VALID_VALUE_FOR, tostring(arg), path), realOptions.cmdName or realOptions.name or self) + print(string.format("|cffffff7f%s:|r %s %s", USAGE, path, usage)) + return + end + + local var + if passTable then + if type(passTable.get) == "function" then + var = passTable.get(passValue) + else + if type(handler[passTable.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.get)) + end + var = handler[passTable.get](handler, passValue) + end + else + if type(options.get) == "function" then + var = options.get() + else + local handler = options.handler or self + if type(handler[options.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.get)) + end + var = handler[options.get](handler) + end + end + + if var ~= arg then + if passTable then + if type(passTable.set) == "function" then + passTable.set(passValue, arg) + else + if type(handler[passTable.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.set)) + end + handler[passTable.set](handler, passValue, arg) + end + else + if type(options.set) == "function" then + options.set(arg) + else + local handler = options.handler or self + if type(handler[options.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.set)) + end + handler[options.set](handler, arg) + end + end + end + end + + if arg then + local var + if passTable then + if type(passTable.get) == "function" then + var = passTable.get(passValue) + else + if type(handler[passTable.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.get)) + end + var = handler[passTable.get](handler, passValue) + end + else + if type(options.get) == "function" then + var = options.get() + else + local handler = options.handler or self + if type(handler[options.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.get)) + end + var = handler[options.get](handler) + end + end + + if var and options.isPercent then + var = tostring(var * 100) .. "%" + end + print(string.format(options.message or IS_NOW_SET_TO, tostring(options.cmdName or options.name), tostring(var or NONE)), realOptions.cmdName or realOptions.name or self) + if var == arg then + return + end + else + printUsage(self, handler, realOptions, options, path, args) + return + end + elseif kind == "color" then + if table.getn(args) > 0 then + local r,g,b,a + if table.getn(args) == 1 then + local arg = tostring(args[1]) + if options.hasAlpha then + if string.len(arg) == 8 and string.find(arg, "^%x*$") then + r,g,b,a = tonumber(string.sub(arg, 1, 2), 16) / 255, tonumber(string.sub(arg, 3, 4), 16) / 255, tonumber(string.sub(arg, 5, 6), 16) / 255, tonumber(string.sub(arg, 7, 8), 16) / 255 + end + else + if string.len(arg) == 6 and string.find(arg, "^%x*$") then + r,g,b = tonumber(string.sub(arg, 1, 2), 16) / 255, tonumber(string.sub(arg, 3, 4), 16) / 255, tonumber(string.sub(arg, 5, 6), 16) / 255 + end + end + elseif table.getn(args) == 4 and options.hasAlpha then + local a1,a2,a3,a4 = args[1], args[2], args[3], args[4] + if type(a1) == "number" and type(a2) == "number" and type(a3) == "number" and type(a4) == "number" and a1 <= 1 and a2 <= 1 and a3 <= 1 and a4 <= 1 then + r,g,b,a = a1,a2,a3,a4 + elseif (type(a1) == "number" or string.len(a1) == 2) and string.find(a1, "^%x*$") and (type(a2) == "number" or string.len(a2) == 2) and string.find(a2, "^%x*$") and (type(a3) == "number" or string.len(a3) == 2) and string.find(a3, "^%x*$") and (type(a4) == "number" or string.len(a4) == 2) and string.find(a4, "^%x*$") then + r,g,b,a = tonumber(a1, 16) / 255, tonumber(a2, 16) / 255, tonumber(a3, 16) / 255, tonumber(a4, 16) / 255 + end + elseif table.getn(args) == 3 and not options.hasAlpha then + local a1,a2,a3 = args[1], args[2], args[3] + if type(a1) == "number" and type(a2) == "number" and type(a3) == "number" and a1 <= 1 and a2 <= 1 and a3 <= 1 then + r,g,b = a1,a2,a3 + elseif (type(a1) == "number" or string.len(a1) == 2) and string.find(a1, "^%x*$") and (type(a2) == "number" or string.len(a2) == 2) and string.find(a2, "^%x*$") and (type(a3) == "number" or string.len(a3) == 2) and string.find(a3, "^%x*$") then + r,g,b = tonumber(a1, 16) / 255, tonumber(a2, 16) / 255, tonumber(a3, 16) / 255 + end + end + if not r then + print(string.format(options.error or IS_NOT_A_VALID_OPTION_FOR, table.concat(args, ' '), path), realOptions.cmdName or realOptions.name or self) + print(string.format("|cffffff7f%s:|r %s {0-1} {0-1} {0-1}%s", USAGE, path, options.hasAlpha and " {0-1}" or "")) + return + end + if passTable then + if type(passTable.set) == "function" then + passTable.set(passValue, r,g,b,a) + else + if type(handler[passTable.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.set)) + end + handler[passTable.set](handler, passValue, r,g,b,a) + end + else + if type(options.set) == "function" then + options.set(r,g,b,a) + else + if type(handler[options.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.set)) + end + handler[options.set](handler, r,g,b,a) + end + end + + local r,g,b,a + if passTable then + if type(passTable.get) == "function" then + r,g,b,a = passTable.get(passValue) + else + if type(handler[passTable.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.get)) + end + r,g,b,a = handler[passTable.get](handler, passValue) + end + else + if type(options.get) == "function" then + r,g,b,a = options.get() + else + if type(handler[options.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.get)) + end + r,g,b,a = handler[options.get](handler) + end + end + + local s + if type(r) == "number" and type(g) == "number" and type(b) == "number" then + if options.hasAlpha and type(a) == "number" then + s = string.format("|c%02x%02x%02x%02x%02x%02x%02x%02x|r", a*255, r*255, g*255, b*255, r*255, g*255, b*255, a*255) + else + s = string.format("|cff%02x%02x%02x%02x%02x%02x|r", r*255, g*255, b*255, r*255, g*255, b*255) + end + else + s = NONE + end + print(string.format(options.message or IS_NOW_SET_TO, tostring(options.cmdName or options.name), s), realOptions.cmdName or realOptions.name or self) + else + local r,g,b,a + if passTable then + if type(passTable.get) == "function" then + r,g,b,a = passTable.get(passValue) + else + if type(handler[passTable.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, passTable.get)) + end + r,g,b,a = handler[passTable.get](handler, passValue) + end + else + if type(options.get) == "function" then + r,g,b,a = options.get() + else + if type(handler[options.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, options.get)) + end + r,g,b,a = handler[options.get](handler) + end + end + + if not colorTable then + colorTable = {} + local t = colorTable + + if ColorPickerOkayButton then + local ColorPickerOkayButton_OnClick = ColorPickerOkayButton:GetScript("OnClick") + ColorPickerOkayButton:SetScript("OnClick", function() + if ColorPickerOkayButton_OnClick then + ColorPickerOkayButton_OnClick() + end + if t.active then + ColorPickerFrame.cancelFunc = nil + ColorPickerFrame.func = nil + ColorPickerFrame.opacityFunc = nil + local r,g,b,a + if t.passValue then + if type(t.get) == "function" then + r,g,b,a = t.get(t.passValue) + else + if type(t.handler[t.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, t.get)) + end + r,g,b,a = t.handler[t.get](t.handler, t.passValue) + end + else + if type(t.get) == "function" then + r,g,b,a = t.get() + else + if type(t.handler[t.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, t.get)) + end + r,g,b,a = t.handler[t.get](t.handler) + end + end + if r ~= t.r or g ~= t.g or b ~= t.b or (t.hasAlpha and a ~= t.a) then + local s + if type(r) == "number" and type(g) == "number" and type(b) == "number" then + if t.hasAlpha and type(a) == "number" then + s = string.format("|c%02x%02x%02x%02x%02x%02x%02x%02x|r", a*255, r*255, g*255, b*255, r*255, g*255, b*255, a*255) + else + s = string.format("|cff%02x%02x%02x%02x%02x%02x|r", r*255, g*255, b*255, r*255, g*255, b*255) + end + else + s = NONE + end + print(string.format(t.message, tostring(t.name), s), t.realOptions.cmdName or t.realOptions.name or self) + end + for k,v in pairs(t) do + t[k] = nil + end + end + end) + end + else + for k,v in pairs(colorTable) do + colorTable[k] = nil + end + end + + if type(r) ~= "number" or type(g) ~= "number" or type(b) ~= "number" then + r,g,b = 1, 1, 1 + end + if type(a) ~= "number" then + a = 1 + end + local t = colorTable + t.r = r + t.g = g + t.b = b + if hasAlpha then + t.a = a + end + t.realOptions = realOptions + t.hasAlpha = options.hasAlpha + t.handler = handler + t.set = passTable and passTable.set or options.set + t.get = passTable and passTable.get or options.get + t.name = options.cmdName or options.name + t.message = options.message or IS_NOW_SET_TO + t.passValue = passValue + t.active = true + + if not colorFunc then + colorFunc = function() + local r,g,b = ColorPickerFrame:GetColorRGB() + if t.hasAlpha then + local a = 1 - OpacitySliderFrame:GetValue() + if type(t.set) == "function" then + if t.passValue then + t.set(t.passValue, r,g,b,a) + else + t.set(r,g,b,a) + end + else + if type(t.handler[t.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, t.set)) + end + if t.passValue then + t.handler[t.set](t.handler, t.passValue, r,g,b,a) + else + t.handler[t.set](t.handler, r,g,b,a) + end + end + else + if type(t.set) == "function" then + if t.passValue then + t.set(t.passValue, r,g,b) + else + t.set(r,g,b) + end + else + if type(t.handler[t.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, t.set)) + end + if t.passValue then + t.handler[t.set](t.handler, t.passValue, r,g,b) + else + t.handler[t.set](t.handler, r,g,b) + end + end + end + end + end + + ColorPickerFrame.func = colorFunc + ColorPickerFrame.hasOpacity = options.hasAlpha + if options.hasAlpha then + ColorPickerFrame.opacityFunc = ColorPickerFrame.func + ColorPickerFrame.opacity = 1 - a + end + ColorPickerFrame:SetColorRGB(r,g,b) + + if not colorCancelFunc then + colorCancelFunc = function() + if t.hasAlpha then + if type(t.set) == "function" then + if t.passValue then + t.set(t.passValue, t.r,t.g,t.b,t.a) + else + t.set(t.r,t.g,t.b,t.a) + end + else + if type(t.handler[t.get]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, t.get)) + end + if t.passValue then + t.handler[t.set](t.handler, t.passValue, t.r,t.g,t.b,t.a) + else + t.handler[t.set](t.handler, t.r,t.g,t.b,t.a) + end + end + else + if type(t.set) == "function" then + if t.passValue then + t.set(t.passValue, t.r,t.g,t.b) + else + t.set(t.r,t.g,t.b) + end + else + if type(t.handler[t.set]) ~= "function" then + AceConsole:error("%s: %s", tostring(handler), string.format(OPTION_HANDLER_NOT_FOUND, t.set)) + end + if t.passValue then + t.handler[t.set](t.handler, t.passValue, t.r,t.g,t.b) + else + t.handler[t.set](t.handler, t.r,t.g,t.b) + end + end + end + for k,v in pairs(t) do + t[k] = nil + end + ColorPickerFrame.cancelFunc = nil + ColorPickerFrame.func = nil + ColorPickerFrame.opacityFunc = nil + end + end + + ColorPickerFrame.cancelFunc = colorCancelFunc + + ShowUIPanel(ColorPickerFrame) + end + return + elseif kind == "group" then + if table.getn(args) == 0 then + printUsage(self, handler, realOptions, options, path, args) + else + -- invalid argument + print(string.format(options.error or IS_NOT_A_VALID_OPTION_FOR, args[1], path), realOptions.cmdName or realOptions.name or self) + end + return + end + this = _G_this + if Dewdrop then + Dewdrop:Refresh(1) + Dewdrop:Refresh(2) + Dewdrop:Refresh(3) + Dewdrop:Refresh(4) + Dewdrop:Refresh(5) + end +end + +local external +function AceConsole:RegisterChatCommand(slashCommands, options, name) + if type(slashCommands) ~= "table" and slashCommands ~= false then + AceConsole:error("Bad argument #2 to `RegisterChatCommand' (expected table, got %s)", type(slashCommands)) + end + if not slashCommands and type(name) ~= "string" then + AceConsole:error("Bad argument #4 to `RegisterChatCommand' (expected string, got %s)", type(name)) + end + if type(options) ~= "table" and type(options) ~= "function" and options ~= nil then + AceConsole:error("Bad argument #3 to `RegisterChatCommand' (expected table, function, or nil, got %s)", type(options)) + end + if name then + if type(name) ~= "string" then + AceConsole:error("Bad argument #4 to `RegisterChatCommand' (expected string or nil, got %s)", type(name)) + elseif not string.find(name, "^%w+$") or string.upper(name) ~= name or string.len(name) == 0 then + AceConsole:error("Argument #4 must be an uppercase, letters-only string with at least 1 character") + end + end + if slashCommands then + if table.getn(slashCommands) == 0 then + AceConsole:error("Argument #2 to `RegisterChatCommand' must include at least one string") + end + + for k,v in pairs(slashCommands) do + if type(k) ~= "number" then + AceConsole:error("All keys in argument #2 to `RegisterChatCommand' must be numbers") + end + if type(v) ~= "string" then + AceConsole:error("All values in argument #2 to `RegisterChatCommand' must be strings") + elseif not string.find(v, "^/[A-Za-z][A-Za-z0-9_]*$") then + AceConsole:error("All values in argument #2 to `RegisterChatCommand' must be in the form of \"/word\"") + end + end + end + + if not options then + options = { + type = 'group', + args = {}, + handler = self + } + end + + if type(options) == "table" then + local err, position = validateOptions(options) + if err then + if position then + AceConsole:error(position .. ": " .. err) + else + AceConsole:error(err) + end + end + + if not options.handler then + options.handler = self + end + + if options.handler == self and string.lower(options.type) == "group" and self.class then + AceConsole:InjectAceOptionsTable(self, options) + end + end + + local chat + if slashCommands then + chat = slashCommands[1] + else + chat = _G["SLASH_"..name..1] + end + + local handler + if type(options) == "function" then + handler = options + for k,v in pairs(_G) do + if handler == v then + local k = k + handler = function(msg) + return _G[k](msg) + end + end + end + else + function handler(msg) + handlerFunc(self, chat, msg, options) + end + end + + if not _G.SlashCmdList then + _G.SlashCmdList = {} + end + + if not name then + repeat + name = string.char(math.random(26) + string.byte('A') - 1) .. string.char(math.random(26) + string.byte('A') - 1) .. string.char(math.random(26) + string.byte('A') - 1) .. string.char(math.random(26) + string.byte('A') - 1) .. string.char(math.random(26) + string.byte('A') - 1) .. string.char(math.random(26) + string.byte('A') - 1) .. string.char(math.random(26) + string.byte('A') - 1) .. string.char(math.random(26) + string.byte('A') - 1) + until not _G.SlashCmdList[name] + end + + if slashCommands then + if _G.SlashCmdList[name] then + local i = 0 + while true do + i = i + 1 + if _G["SLASH_"..name..i] then + _G["SLASH_"..name..i] = nil + else + break + end + end + end + + local i = 0 + for _,command in ipairs(slashCommands) do + i = i + 1 + _G["SLASH_"..name..i] = command + if string.lower(command) ~= command then + i = i + 1 + _G["SLASH_"..name..i] = string.lower(command) + end + end + end + _G.SlashCmdList[name] = handler + if self ~= AceConsole and self.slashCommand == nil then + self.slashCommand = chat + end + + if not AceEvent and AceLibrary:HasInstance("AceEvent-2.0") then + external(AceConsole, "AceEvent-2.0", AceLibrary("AceEvent-2.0")) + end + if AceEvent then + if not AceConsole.nextAddon then + AceConsole.nextAddon = {} + end + if type(options) == "table" then + AceConsole.nextAddon[self] = options + if not self.playerLogin then + AceConsole:RegisterEvent("PLAYER_LOGIN", "PLAYER_LOGIN", true) + end + end + end + + AceConsole.registry[name] = options +end + +function AceConsole:InjectAceOptionsTable(handler, options) + self:argCheck(handler, 2, "table") + self:argCheck(options, 3, "table") + if string.lower(options.type) ~= "group" then + self:error('Cannot inject into options table argument #3 if its type is not "group"') + end + if options.handler ~= nil and options.handler ~= handler then + self:error("Cannot inject into options table argument #3 if it has a different handler than argument #2") + end + options.handler = handler + local class = handler.class + if not class then + self:error("Cannot retrieve AceOptions tables from a non-object argument #2") + end + while class and class ~= AceOO.Class do + if type(class.GetAceOptionsDataTable) == "function" then + local t = class:GetAceOptionsDataTable(handler) + for k,v in pairs(t) do + if type(options.args) ~= "table" then + options.args = {} + end + if options.args[k] == nil then + options.args[k] = v + end + end + end + local mixins = class.mixins + if mixins then + for mixin in pairs(mixins) do + if type(mixin.GetAceOptionsDataTable) == "function" then + local t = mixin:GetAceOptionsDataTable(handler) + for k,v in pairs(t) do + if type(options.args) ~= "table" then + options.args = {} + end + if options.args[k] == nil then + options.args[k] = v + end + end + end + end + end + class = class.super + end + return options +end + +function AceConsole:PLAYER_LOGIN() + self.playerLogin = true + for addon, options in pairs(self.nextAddon) do + local err, position = validateOptionsMethods(addon, options) + if err then + if position then + error(tostring(addon) .. ": AceConsole: " .. position .. ": " .. err) + else + error(tostring(addon) .. ": AceConsole: " .. err) + end + end + self.nextAddon[addon] = nil + end + + self:RegisterChatCommand({ "/reload", "/rl", "/reloadui" }, ReloadUI, "RELOAD") + + local version = GetBuildInfo() + if string.find(version, "^2%.") then + -- 2.0.0 + self:RegisterChatCommand({ "/print" }, function(text) + RunScript("local function func(...) local arg = {...}; for k = 1,select('#', ...) do arg[k] = tostring(arg[k]) end DEFAULT_CHAT_FRAME:AddMessage(table.concat(arg, ' ')) end func(" .. text .. ")") + end, "PRINT") + else + self:RegisterChatCommand({ "/print" }, function(text) + RunScript("local function func(...) for k = 1,table.getn(arg) do arg[k] = tostring(arg[k]) end DEFAULT_CHAT_FRAME:AddMessage(table.concat(arg, ' ')) end func(" .. text .. ")") + end, "PRINT") + end +end + +function AceConsole:TabCompleteInfo(cmdpath) + local _, _, cmd = string.find(cmdpath, "(/%S+)") + if not cmd then + return + end + local path = string.sub(cmdpath, string.len(cmd) + 2) + for name in pairs(SlashCmdList) do --global + if AceConsole.registry[name] then + local i = 0 + while true do + i = i + 1 + local scmd = _G["SLASH_"..name..i] + if not scmd then break end + if cmd == scmd then + return name, cmd, path + end + end + end + end +end + +function external(self, major, instance) + if major == "AceEvent-2.0" then + if not AceEvent then + AceEvent = instance + + AceEvent:embed(self) + end + elseif major == "AceTab-2.0" then + instance:RegisterTabCompletion("AceConsole", "%/.*", function(t, cmdpath, pos) + local ac = AceLibrary("AceConsole-2.0") + local name, cmd, path = ac:TabCompleteInfo(string.sub(cmdpath, 1, pos)) + + if not ac.registry[name] then + return false + else + local validArgs = findTableLevel(ac, ac.registry[name], cmd, path or "") + if validArgs.args then + for arg in pairs(validArgs.args) do + table.insert(t, arg) + end + end + end + end, function(u, matches, gcs, cmdpath) + local ac = AceLibrary("AceConsole-2.0") + local name, cmd, path = ac:TabCompleteInfo(cmdpath) + if ac.registry[name] then + local validArgs, path2, argwork = findTableLevel(ac, ac.registry[name], cmd, path) + printUsage(ac, validArgs.handler, ac.registry[name], validArgs, path2, argwork, not gcs or gcs ~= "", gcs) + end + end) + elseif major == "Dewdrop-2.0" then + Dewdrop = instance + end +end + +local function activate(self, oldLib, oldDeactivate) + AceConsole = self + + self.super.activate(self, oldLib, oldDeactivate) + + if oldLib then + self.registry = oldLib.registry + self.nextAddon = oldLib.nextAddon + end + if not self.registry then + self.registry = {} + else + for name,options in pairs(self.registry) do + self:RegisterChatCommand(false, options, name) + end + end + + if oldDeactivate then + oldDeactivate(oldLib) + end +end + +AceLibrary:Register(AceConsole, MAJOR_VERSION, MINOR_VERSION, activate, nil, external) +AceConsole = AceLibrary(MAJOR_VERSION) diff --git a/Payload/Interface/Addons/SuperAPI/libs/AceDB-2.0/AceDB-2.0.lua b/Payload/Interface/Addons/SuperAPI/libs/AceDB-2.0/AceDB-2.0.lua new file mode 100644 index 0000000..a6bbd10 --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/AceDB-2.0/AceDB-2.0.lua @@ -0,0 +1,1539 @@ +--[[ +Name: AceDB-2.0 +Revision: $Rev: 17797 $ +Developed by: The Ace Development Team (http://www.wowace.com/index.php/The_Ace_Development_Team) +Inspired By: Ace 1.x by Turan (turan@gryphon.com) +Website: http://www.wowace.com/ +Documentation: http://www.wowace.com/index.php/AceDB-2.0 +SVN: http://svn.wowace.com/root/trunk/Ace2/AceDB-2.0 +Description: Mixin to allow for fast, clean, and featureful saved variable + access. +Dependencies: AceLibrary, AceOO-2.0, AceEvent-2.0 +]] + +local MAJOR_VERSION = "AceDB-2.0" +local MINOR_VERSION = "$Revision: 17798 $" + +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +if loadstring("return function(...) return ... end") and AceLibrary:HasInstance(MAJOR_VERSION) then return end -- lua51 check +if not AceLibrary:HasInstance("AceOO-2.0") then error(MAJOR_VERSION .. " requires AceOO-2.0") end + +local ACTIVE, ENABLED, STATE, TOGGLE_ACTIVE, MAP_ACTIVESUSPENDED, SET_PROFILE, SET_PROFILE_USAGE, PROFILE, PLAYER_OF_REALM, CHOOSE_PROFILE_DESC, CHOOSE_PROFILE_GUI, COPY_PROFILE_DESC, COPY_PROFILE_GUI, OTHER_PROFILE_DESC, OTHER_PROFILE_GUI, OTHER_PROFILE_USAGE, CHARACTER, REALM, CLASS + +local function safecall(func,a,b,c,d,e,f,g,h,i) + local success, err = pcall(func,a,b,c,d,e,f,g,h,i) + if not success then geterrorhandler()(err) end +end + +if GetLocale() == "deDE" then + ACTIVE = "Aktiv" + ENABLED = "Aktiviert" + STATE = "Status" + TOGGLE_ACTIVE = "Stoppt/Aktiviert dieses Addon." + MAP_ACTIVESUSPENDED = { [true] = "|cff00ff00Aktiv|r", [false] = "|cffff0000Gestoppt|r" } + SET_PROFILE = "Setzt das Profil f\195\188r dieses Addon." + SET_PROFILE_USAGE = "{Charakter || Klasse || Realm || }" + PROFILE = "Profil" + PLAYER_OF_REALM = "%s von %s" + CHOOSE_PROFILE_DESC = "W\195\164hle ein Profil." + CHOOSE_PROFILE_GUI = "W\195\164hle" + COPY_PROFILE_DESC = "Kopiert Einstellungen von einem anderem Profil." + COPY_PROFILE_GUI = "Kopiere von" + OTHER_PROFILE_DESC = "W\195\164hle ein anderes Profil." + OTHER_PROFILE_GUI = "Anderes" + OTHER_PROFILE_USAGE = "" + + CHARACTER = "Charakter: " + REALM = "Realm: " + CLASS = "Klasse: " +elseif GetLocale() == "esES" then + ACTIVE = "Activo" + ENABLED = "Activado" + STATE = "Estado" + TOGGLE_ACTIVE = "Suspende/reanuda este addon." + MAP_ACTIVESUSPENDED = { [true] = "|cff00ff00Activo|r", [false] = "|cffff0000Suspendido|r" } + SET_PROFILE = "Asigna perfil para este addon." + SET_PROFILE_USAGE = "{personaje || clase || reino || }" + PROFILE = "Perfil" + PLAYER_OF_REALM = "%s de %s" + CHOOSE_PROFILE_DESC = "Elige un perfil." + CHOOSE_PROFILE_GUI = "Elige" + COPY_PROFILE_DESC = "Copia configuración de otro perfil." + COPY_PROFILE_GUI = "Copia" + OTHER_PROFILE_DESC = "Elige otro perfil." + OTHER_PROFILE_GUI = "Otro" + OTHER_PROFILE_USAGE = "" + + CHARACTER = "Personaje: " + REALM = "Reino: " + CLASS = "Clase: " +elseif GetLocale() == "frFR" then + ACTIVE = "Actif" + ENABLED = "Activ\195\169" + STATE = "Etat" + TOGGLE_ACTIVE = "Suspend/active cet addon." + MAP_ACTIVESUSPENDED = { [true] = "|cff00ff00Actif|r", [false] = "|cffff0000Suspendu|r" } + SET_PROFILE = "S\195\169lectionne le profil pour cet addon." + SET_PROFILE_USAGE = "{perso || classe || royaume || }" + PROFILE = "Profil" + PLAYER_OF_REALM = "%s de %s" + CHOOSE_PROFILE_DESC = "Choisissez un profil." + CHOOSE_PROFILE_GUI = "Choix" + COPY_PROFILE_DESC = "Copier les param\195\168tres d'un autre profil." + COPY_PROFILE_GUI = "Copier \195\160 partir de" + OTHER_PROFILE_DESC = "Choisissez un autre profil." + OTHER_PROFILE_GUI = "Autre" + OTHER_PROFILE_USAGE = "" + + CHARACTER = "Personnage: " + REALM = "Royaume: " + CLASS = "Classe: " +elseif GetLocale() == "koKR" then + ACTIVE = "활성화" + ENABLED = "활성화" + STATE = "상태" + TOGGLE_ACTIVE = "이 애드온 중지/계속 실행" + MAP_ACTIVESUSPENDED = { [true] = "|cff00ff00활성화|r", [false] = "|cffff0000중지됨|r" } + SET_PROFILE = "이 애드온에 프로필 설정" + SET_PROFILE_USAGE = "{캐릭터명 || 직업 || 서버명 || <프로필명>}" + PROFILE = "프로필" + PLAYER_OF_REALM = "%s (%s 서버)" + CHOOSE_PROFILE_DESC = "프로파일을 선택합니다." + CHOOSE_PROFILE_GUI = "선택" + COPY_PROFILE_DESC = "다른 프로파일에서 설정을 복사합니다." + COPY_PROFILE_GUI = "복사" + OTHER_PROFILE_DESC = "다른 프로파일을 선택합니다." + OTHER_PROFILE_GUI = "기타" + OTHER_PROFILE_USAGE = "<프로파일명>" + + CHARACTER = "캐릭터: " + REALM = "서버: " + CLASS = "직업: " +elseif GetLocale() == "zhTW" then + ACTIVE = "啟動" + ENABLED = "啟用" + STATE = "狀態" + TOGGLE_ACTIVE = "暫停/重啟這個插件。" + MAP_ACTIVESUSPENDED = { [true] = "|cff00ff00啟動|r", [false] = "|cffff0000已暫停|r" } + SET_PROFILE = "設定這插件的記錄檔。" + SET_PROFILE_USAGE = "{角色 || 聯業 || 伺服器 || <記錄檔名稱>}" + PROFILE = "記錄檔" + PLAYER_OF_REALM = "%s 於 %s" + CHOOSE_PROFILE_DESC = "選擇一個記錄檔" + CHOOSE_PROFILE_GUI = "選擇" + COPY_PROFILE_DESC = "由其他記錄檔複製設定。" + COPY_PROFILE_GUI = "複製由" + OTHER_PROFILE_DESC = "選擇其他記錄檔。" + OTHER_PROFILE_GUI = "其他" + OTHER_PROFILE_USAGE = "<記錄檔名稱>" + + CHARACTER = "角色:" + REALM = "伺服器:" + CLASS = "聯業:" +elseif GetLocale() == "zhCN" then + ACTIVE = "\230\156\137\230\149\136" + ENABLED = "\229\144\175\231\148\168" + STATE = "\231\138\182\230\128\129" + TOGGLE_ACTIVE = "\230\154\130\229\129\156/\230\129\162\229\164\141 \230\173\164\230\143\146\228\187\182." + MAP_ACTIVESUSPENDED = { [true] = "|cff00ff00\230\156\137\230\149\136|r", [false] = "|cffff0000\230\154\130\229\129\156|r" } + SET_PROFILE = "\232\174\190\231\189\174\233\133\141\231\189\174\230\150\135\228\187\182\228\184\186\232\191\153\230\143\146\228\187\182." + SET_PROFILE_USAGE = "{\229\173\151\231\172\166 || \233\128\137\228\187\182\231\177\187 || \229\159\159 || <\233\133\141\231\189\174\230\150\135\228\187\182\229\144\141\229\173\151>}" + PROFILE = "\233\133\141\231\189\174\230\150\135\228\187\182" + PLAYER_OF_REALM = "%s \231\154\132 %s" + CHOOSE_PROFILE_DESC = "\233\128\137\230\139\169\233\133\141\231\189\174\230\150\135\228\187\182." + CHOOSE_PROFILE_GUI = "\233\128\137\230\139\169" + COPY_PROFILE_DESC = "\229\164\141\229\136\182\232\174\190\231\189\174\228\187\142\229\143\166\228\184\128\228\184\170\233\133\141\231\189\174\230\150\135\228\187\182." + COPY_PROFILE_GUI = "\229\164\141\229\136\182\228\187\142" + OTHER_PROFILE_DESC = "\233\128\137\230\139\169\229\143\166\228\184\128\228\184\170\233\133\141\231\189\174\230\150\135\228\187\182." + OTHER_PROFILE_GUI = "\229\133\182\228\187\150" + OTHER_PROFILE_USAGE = "<\233\133\141\231\189\174\230\150\135\228\187\182\229\144\141\229\173\151>" + + CHARACTER = "\229\173\151\231\172\166: " + REALM = "\229\159\159: " + CLASS = "\233\128\137\228\187\182\231\177\187: " +elseif GetLocale() == "ruRU" then + ACTIVE = "Активный" + ENABLED = "Включён" + STATE = "Состояние" + TOGGLE_ACTIVE = "Отключить/Запустить аддон." + MAP_ACTIVESUSPENDED = { [true] = "|cff00ff00Активный|r", [false] = "|cffff0000Приостановленный|r" } + SET_PROFILE = "Установить профиль для этого аддона." + SET_PROFILE_USAGE = "{чар || класс || сервер || <название профиля>}" + PROFILE = "Профиль" + PLAYER_OF_REALM = "%s из %s" + CHOOSE_PROFILE_DESC = "Выберите профиль." + CHOOSE_PROFILE_GUI = "Выбор" + COPY_PROFILE_DESC = "Cкопировать настройки из другого профиля." + COPY_PROFILE_GUI = "Скопировать из" + OTHER_PROFILE_DESC = "Выбрать другой профиль." + OTHER_PROFILE_GUI = "Другое" + OTHER_PROFILE_USAGE = "<название профиля>" + + CHARACTER = "Персонаж: " + REALM = "Сервер: " + CLASS = "Класс: " +else -- enUS + ACTIVE = "Active" + ENABLED = "Enabled" + STATE = "State" + TOGGLE_ACTIVE = "Suspend/resume this addon." + MAP_ACTIVESUSPENDED = { [true] = "|cff00ff00Active|r", [false] = "|cffff0000Suspended|r" } + SET_PROFILE = "Set profile for this addon." + SET_PROFILE_USAGE = "{char || class || realm || }" + PROFILE = "Profile" + PLAYER_OF_REALM = "%s of %s" + CHOOSE_PROFILE_DESC = "Choose a profile." + CHOOSE_PROFILE_GUI = "Choose" + COPY_PROFILE_DESC = "Copy settings from another profile." + COPY_PROFILE_GUI = "Copy from" + OTHER_PROFILE_DESC = "Choose another profile." + OTHER_PROFILE_GUI = "Other" + OTHER_PROFILE_USAGE = "" + + CHARACTER = "Character: " + REALM = "Realm: " + CLASS = "Class: " +end + +local AceOO = AceLibrary("AceOO-2.0") +local AceEvent +local Mixin = AceOO.Mixin +local AceDB = Mixin { + "RegisterDB", + "RegisterDefaults", + "ResetDB", + "SetProfile", + "GetProfile", + "ToggleActive", + "IsActive", + "AcquireDBNamespace", + } +local Dewdrop = AceLibrary:HasInstance("Dewdrop-2.0") and AceLibrary("Dewdrop-2.0") + +local _G = getfenv(0) + +local table_setn +do + local version = GetBuildInfo() + if string.find(version, "^2%.") then + -- 2.0.0 + table_setn = function() end + else + table_setn = table.setn + end +end + +local function inheritDefaults(t, defaults) + if not defaults then + return t + end + for k,v in pairs(defaults) do + if k == "*" then + local v = v + if type(v) == "table" then + setmetatable(t, { + __index = function(self, key) + if key == nil then + return nil + end + self[key] = {} + inheritDefaults(self[key], v) + return self[key] + end + } ) + else + setmetatable(t, { + __index = function(self, key) + if key == nil then + return nil + end + self[key] = v + return self[key] + end + } ) + end + for key in pairs(t) do + if (defaults[key] == nil or key == "*") and type(t[key]) == "table" then + inheritDefaults(t[key], v) + end + end + else + if type(v) == "table" then + if type(t[k]) ~= "table" then + t[k] = {} + end + inheritDefaults(t[k], v) + elseif t[k] == nil then + t[k] = v + end + end + end + return t +end + +local _,race = UnitRace("player") +local faction +if race == "Orc" or race == "Scourge" or race == "Troll" or race == "Tauren" then + faction = FACTION_HORDE +else + faction = FACTION_ALLIANCE +end +local charID = string.format(PLAYER_OF_REALM, UnitName("player"), (string.gsub(GetRealmName(), "^%s*(.-)%s*$", "%1"))) +local realm = string.gsub(GetRealmName(), "^%s*(.-)%s*$", "%1") +local realmID = realm .. " - " .. faction +local classID = UnitClass("player") + +AceDB.CHAR_ID = charID +AceDB.REALM_ID = realmID +AceDB.CLASS_ID = classID + +AceDB.FACTION = faction +AceDB.REALM = realm +AceDB.NAME = UnitName("player") + +local new, del +do + local list = setmetatable({}, {__mode="k"}) + function new() + local t = next(list) + if t then + list[t] = nil + return t + else + return {} + end + end + + function del(t) + setmetatable(t, nil) + for k in pairs(t) do + t[k] = nil + end + table_setn(t, 0) + list[t] = true + end +end + +local caseInsensitive_mt = { + __index = function(self, key) + if type(key) ~= "string" then + return nil + end + local lowerKey = string.lower(key) + for k,v in pairs(self) do + if string.lower(k) == lowerKey then + return self[k] + end + end + end, + __newindex = function(self, key, value) + if type(key) ~= "string" then + return error("table index is nil", 2) + end + local lowerKey = string.lower(key) + for k in pairs(self) do + if string.lower(k) == lowerKey then + rawset(self, k, nil) + rawset(self, key, value) + return + end + end + rawset(self, key, value) + end +} + +local db_mt = { __index = function(db, key) + if key == "char" then + if db.charName then + if type(_G[db.charName]) ~= "table" then + _G[db.charName] = {} + end + if type(_G[db.charName].global) ~= "table" then + _G[db.charName].global = {} + end + rawset(db, 'char', _G[db.charName].global) + else + if type(db.raw.chars) ~= "table" then + db.raw.chars = {} + end + local id = charID + if type(db.raw.chars[id]) ~= "table" then + db.raw.chars[id] = {} + end + rawset(db, 'char', db.raw.chars[id]) + end + if db.defaults and db.defaults.char then + inheritDefaults(db.char, db.defaults.char) + end + return db.char + elseif key == "realm" then + if type(db.raw.realms) ~= "table" then + db.raw.realms = {} + end + local id = realmID + if type(db.raw.realms[id]) ~= "table" then + db.raw.realms[id] = {} + end + rawset(db, 'realm', db.raw.realms[id]) + if db.defaults and db.defaults.realm then + inheritDefaults(db.realm, db.defaults.realm) + end + return db.realm + elseif key == "account" then + if type(db.raw.account) ~= "table" then + db.raw.account = {} + end + rawset(db, 'account', db.raw.account) + if db.defaults and db.defaults.account then + inheritDefaults(db.account, db.defaults.account) + end + return db.account + elseif key == "class" then + if type(db.raw.classes) ~= "table" then + db.raw.classes = {} + end + local id = classID + if type(db.raw.classes[id]) ~= "table" then + db.raw.classes[id] = {} + end + rawset(db, 'class', db.raw.classes[id]) + if db.defaults and db.defaults.class then + inheritDefaults(db.class, db.defaults.class) + end + return db.class + elseif key == "profile" then + if type(db.raw.profiles) ~= "table" then + db.raw.profiles = setmetatable({}, caseInsensitive_mt) + else + setmetatable(db.raw.profiles, caseInsensitive_mt) + end + local id = db.raw.currentProfile[charID] + if id == "char" then + id = "char/" .. charID + elseif id == "class" then + id = "class/" .. classID + elseif id == "realm" then + id = "realm/" .. realmID + end + if type(db.raw.profiles[id]) ~= "table" then + db.raw.profiles[id] = {} + end + rawset(db, 'profile', db.raw.profiles[id]) + if db.defaults and db.defaults.profile then + inheritDefaults(db.profile, db.defaults.profile) + end + return db.profile + elseif key == "raw" or key == "defaults" or key == "name" or key == "charName" or key == "namespaces" then + return nil + end + error(string.format('Cannot access key %q in db table. You may want to use db.profile[%q]', tostring(key), tostring(key)), 2) +end, __newindex = function(db, key, value) + error(string.format('Cannot access key %q in db table. You may want to use db.profile[%q]', tostring(key), tostring(key)), 2) +end } + +local CrawlForSerialization +local CrawlForDeserialization + +local function SerializeObject(o) + local t = { o:Serialize() } + t[0] = o.class:GetLibraryVersion() + CrawlForSerialization(t) + return t +end + +local function DeserializeObject(t) + CrawlForDeserialization(t) + local className = t[0] + for i = 20, 1, -1 do + if t[i] then + table_setn(t, i) + break + end + end + local o = AceLibrary(className):Deserialize(unpack(t)) + table_setn(t, 0) + return o +end + +local function IsSerializable(t) + return AceOO.inherits(t, AceOO.Class) and t.class and type(t.class.Deserialize) == "function" and type(t.Serialize) == "function" and type(t.class.GetLibraryVersion) == "function" +end + +function CrawlForSerialization(t) + local tmp = new() + for k,v in pairs(t) do + tmp[k] = v + end + for k,v in pairs(tmp) do + if type(v) == "table" and type(v[0]) ~= "userdata" then + if IsSerializable(v) then + v = SerializeObject(v) + t[k] = v + else + CrawlForSerialization(v) + end + end + if type(k) == "table" and type(k[0]) ~= "userdata" then + if IsSerializable(k) then + t[k] = nil + t[SerializeObject(k)] = v + else + CrawlForSerialization(k) + end + end + tmp[k] = nil + k = nil + end + tmp = del(tmp) +end + +local function IsDeserializable(t) + return type(t[0]) == "string" and AceLibrary:HasInstance(t[0]) +end + +function CrawlForDeserialization(t) + local tmp = new() + for k,v in pairs(t) do + tmp[k] = v + end + for k,v in pairs(tmp) do + if type(v) == "table" then + if IsDeserializable(v) then + t[k] = DeserializeObject(v) + del(v) + v = t[k] + elseif type(v[0]) ~= "userdata" then + CrawlForDeserialization(v) + end + end + if type(k) == "table" then + if IsDeserializable(k) then + t[k] = nil + t[DeserializeObject(k)] = v + del(k) + elseif type(k[0]) ~= "userdata" then + CrawlForDeserialization(k) + end + end + tmp[k] = nil + k = nil + end + tmp = del(tmp) +end + +local namespace_mt = { __index = function(namespace, key) + local db = namespace.db + local name = namespace.name + if key == "char" then + if db.charName then + if type(_G[db.charName]) ~= "table" then + _G[db.charName] = {} + end + if type(_G[db.charName].namespaces) ~= "table" then + _G[db.charName].namespaces = {} + end + if type(_G[db.charName].namespaces[name]) ~= "table" then + _G[db.charName].namespaces[name] = {} + end + rawset(namespace, 'char', _G[db.charName].namespaces[name]) + else + if type(db.raw.namespaces) ~= "table" then + db.raw.namespaces = {} + end + if type(db.raw.namespaces[name]) ~= "table" then + db.raw.namespaces[name] = {} + end + if type(db.raw.namespaces[name].chars) ~= "table" then + db.raw.namespaces[name].chars = {} + end + local id = charID + if type(db.raw.namespaces[name].chars[id]) ~= "table" then + db.raw.namespaces[name].chars[id] = {} + end + rawset(namespace, 'char', db.raw.namespaces[name].chars[id]) + end + if namespace.defaults and namespace.defaults.char then + inheritDefaults(namespace.char, namespace.defaults.char) + end + return namespace.char + elseif key == "realm" then + if type(db.raw.namespaces) ~= "table" then + db.raw.namespaces = {} + end + if type(db.raw.namespaces[name]) ~= "table" then + db.raw.namespaces[name] = {} + end + if type(db.raw.namespaces[name].realms) ~= "table" then + db.raw.namespaces[name].realms = {} + end + local id = realmID + if type(db.raw.namespaces[name].realms[id]) ~= "table" then + db.raw.namespaces[name].realms[id] = {} + end + rawset(namespace, 'realm', db.raw.namespaces[name].realms[id]) + if namespace.defaults and namespace.defaults.realm then + inheritDefaults(namespace.realm, namespace.defaults.realm) + end + return namespace.realm + elseif key == "account" then + if type(db.raw.namespaces) ~= "table" then + db.raw.namespaces = {} + end + if type(db.raw.namespaces[name]) ~= "table" then + db.raw.namespaces[name] = {} + end + if type(db.raw.namespaces[name].account) ~= "table" then + db.raw.namespaces[name].account = {} + end + rawset(namespace, 'account', db.raw.namespaces[name].account) + if namespace.defaults and namespace.defaults.account then + inheritDefaults(namespace.account, namespace.defaults.account) + end + return namespace.account + elseif key == "class" then + if type(db.raw.namespaces) ~= "table" then + db.raw.namespaces = {} + end + if type(db.raw.namespaces[name]) ~= "table" then + db.raw.namespaces[name] = {} + end + if type(db.raw.namespaces[name].classes) ~= "table" then + db.raw.namespaces[name].classes = {} + end + local id = classID + if type(db.raw.namespaces[name].classes[id]) ~= "table" then + db.raw.namespaces[name].classes[id] = {} + end + rawset(namespace, 'class', db.raw.namespaces[name].classes[id]) + if namespace.defaults and namespace.defaults.class then + inheritDefaults(namespace.class, namespace.defaults.class) + end + return namespace.class + elseif key == "profile" then + if type(db.raw.namespaces) ~= "table" then + db.raw.namespaces = {} + end + if type(db.raw.namespaces[name]) ~= "table" then + db.raw.namespaces[name] = {} + end + if type(db.raw.namespaces[name].profiles) ~= "table" then + db.raw.namespaces[name].profiles = setmetatable({}, caseInsensitive_mt) + else + setmetatable(db.raw.namespaces[name].profiles, caseInsensitive_mt) + end + local id = db.raw.currentProfile[charID] + if id == "char" then + id = "char/" .. charID + elseif id == "class" then + id = "class/" .. classID + elseif id == "realm" then + id = "realm/" .. realmID + end + if type(db.raw.namespaces[name].profiles[id]) ~= "table" then + db.raw.namespaces[name].profiles[id] = {} + end + rawset(namespace, 'profile', db.raw.namespaces[name].profiles[id]) + if namespace.defaults and namespace.defaults.profile then + inheritDefaults(namespace.profile, namespace.defaults.profile) + end + return namespace.profile + elseif key == "defaults" or key == "name" or key == "db" then + return nil + end + error(string.format('Cannot access key %q in db table. You may want to use db.profile[%q]', tostring(key), tostring(key)), 2) +end, __newindex = function(db, key, value) + error(string.format('Cannot access key %q in db table. You may want to use db.profile[%q]', tostring(key), tostring(key)), 2) +end } + +function AceDB:InitializeDB(addonName) + local db = self.db + + if not db then + if addonName then + AceDB.addonsLoaded[addonName] = true + end + return + end + + if db.raw then + -- someone manually initialized + return + end + + if type(_G[db.name]) ~= "table" then + _G[db.name] = {} + else + CrawlForDeserialization(_G[db.name]) + end + if type(_G[db.charName]) == "table" then + CrawlForDeserialization(_G[db.charName]) + end + rawset(db, 'raw', _G[db.name]) + if not db.raw.currentProfile then + db.raw.currentProfile = {} + end + if not db.raw.currentProfile[charID] then + db.raw.currentProfile[charID] = "Default" + end + if db.raw.disabled then + setmetatable(db.raw.disabled, caseInsensitive_mt) + end + if self['acedb-profile-copylist'] then + local t = self['acedb-profile-copylist'] + for k,v in pairs(t) do + t[k] = nil + end + if db.raw.profiles then + for k in pairs(db.raw.profiles) do + if string.find(k, '^char/') then + local name = string.sub(k, 6) + if name ~= charID then + t[k] = CHARACTER .. name + end + elseif string.find(k, '^realm/') then + local name = string.sub(k, 7) + if name ~= realmID then + t[k] = REALM .. name + end + elseif string.find(k, '^class/') then + local name = string.sub(k, 7) + if name ~= classID then + t[k] = CLASS .. name + end + end + end + end + end + if self['acedb-profile-list'] then + local t = self['acedb-profile-list'] + for k,v in pairs(t) do + t[k] = nil + end + t.char = CHARACTER .. charID + t.realm = REALM .. realmID + t.class = CLASS .. classID + t.Default = "Default" + if db.raw.profiles then + for k in pairs(db.raw.profiles) do + if not string.find(k, '^char/') and not string.find(k, '^realm/') and not string.find(k, '^class/') then + t[k] = k + end + end + end + end + setmetatable(db, db_mt) +end + +function AceDB:OnEmbedInitialize(target, name) + if name then + self:ADDON_LOADED(name) + end + self.InitializeDB(target, name) +end + +function AceDB:RegisterDB(name, charName) + AceDB:argCheck(name, 2, "string") + AceDB:argCheck(charName, 3, "string", "nil") + if self.db then + AceDB:error("Cannot call \"RegisterDB\" if self.db is set.") + end + local stack = debugstack() + local addonName = string.gsub(stack, ".-\n.-\\AddOns\\(.-)\\.*", "%1") + self.db = { + name = name, + charName = charName + } + if AceDB.addonsLoaded[addonName] then + AceDB.InitializeDB(self, addonName) + else + AceDB.addonsToBeInitialized[self] = addonName + end + AceDB.registry[self] = true +end + +function AceDB:RegisterDefaults(kind, defaults, a3) + local name + if a3 then + name, kind, defaults = kind, defaults, a3 + AceDB:argCheck(name, 2, "string") + AceDB:argCheck(kind, 3, "string") + AceDB:argCheck(defaults, 4, "table") + if kind ~= "char" and kind ~= "class" and kind ~= "profile" and kind ~= "account" and kind ~= "realm" then + AceDB:error("Bad argument #3 to `RegisterDefaults' (\"char\", \"class\", \"profile\", \"account\", or \"realm\" expected, got %q)", kind) + end + else + AceDB:argCheck(kind, 2, "string") + AceDB:argCheck(defaults, 3, "table") + if kind ~= "char" and kind ~= "class" and kind ~= "profile" and kind ~= "account" and kind ~= "realm" then + AceDB:error("Bad argument #2 to `RegisterDefaults' (\"char\", \"class\", \"profile\", \"account\", or \"realm\" expected, got %q)", kind) + end + end + if type(self.db) ~= "table" or type(self.db.name) ~= "string" then + AceDB:error("Cannot call \"RegisterDefaults\" unless \"RegisterDB\" has been previously called.") + end + local db + if name then + local namespace = self:AcquireDBNamespace(name) + if namespace.defaults and namespace.defaults[kind] then + AceDB:error("\"RegisterDefaults\" has already been called for %q::%q.", name, kind) + end + db = namespace + else + if self.db.defaults and self.db.defaults[kind] then + AceDB:error("\"RegisterDefaults\" has already been called for %q.", kind) + end + db = self.db + end + if not db.defaults then + rawset(db, 'defaults', {}) + end + db.defaults[kind] = defaults + if rawget(db, kind) then + inheritDefaults(db[kind], defaults) + end +end + +function AceDB:ResetDB(kind) + AceDB:argCheck(kind, 2, "nil", "string") + if not self.db or not self.db.raw then + AceDB:error("Cannot call \"ResetDB\" before \"RegisterDB\" has been called and before \"ADDON_LOADED\" has been fired.") + end + local db = self.db + if kind == nil then + if db.charName then + _G[db.charName] = nil + end + _G[db.name] = nil + rawset(db, 'raw', nil) + AceDB.InitializeDB(self) + if db.namespaces then + for name,v in pairs(db.namespaces) do + rawset(v, 'account', nil) + rawset(v, 'char', nil) + rawset(v, 'class', nil) + rawset(v, 'profile', nil) + rawset(v, 'realm', nil) + end + end + elseif kind == "account" then + db.raw.account = nil + rawset(db, 'account', nil) + if db.namespaces then + for name,v in pairs(db.namespaces) do + rawset(v, 'account', nil) + end + end + elseif kind == "char" then + if db.charName then + _G[db.charName] = nil + else + if db.raw.chars then + db.raw.chars[charID] = nil + end + if db.raw.namespaces then + for name,v in pairs(db.raw.namespaces) do + if v.chars then + v.chars[charID] = nil + end + end + end + end + rawset(db, 'char', nil) + if db.namespaces then + for name,v in pairs(db.namespaces) do + rawset(v, 'char', nil) + end + end + elseif kind == "realm" then + if db.raw.realms then + db.raw.realms[realmID] = nil + end + rawset(db, 'realm', nil) + if db.raw.namespaces then + for name,v in pairs(db.raw.namespaces) do + if v.realms then + v.realms[realmID] = nil + end + end + end + if db.namespaces then + for name,v in pairs(db.namespaces) do + rawset(v, 'realm', nil) + end + end + elseif kind == "class" then + if db.raw.realms then + db.raw.realms[classID] = nil + end + rawset(db, 'class', nil) + if db.raw.namespaces then + for name,v in pairs(db.raw.namespaces) do + if v.classes then + v.classes[classID] = nil + end + end + end + if db.namespaces then + for name,v in pairs(db.namespaces) do + rawset(v, 'class', nil) + end + end + elseif kind == "profile" then + local id = db.raw.currentProfile and db.raw.currentProfile[charID] or "Default" + if id == "char" then + id = "char/" .. charID + elseif id == "class" then + id = "class/" .. classID + elseif id == "realm" then + id = "realm/" .. realmID + end + if db.raw.profiles then + db.raw.profiles[id] = nil + end + rawset(db, 'profile', nil) + if db.raw.namespaces then + for name,v in pairs(db.raw.namespaces) do + if v.profiles then + v.profiles[id] = nil + end + end + end + if db.namespaces then + for name,v in pairs(db.namespaces) do + rawset(v, 'profile', nil) + end + end + end +end + +local function cleanDefaults(t, defaults) + if defaults then + for k,v in pairs(defaults) do + if k == "*" then + if type(v) == "table" then + for k in pairs(t) do + if (defaults[k] == nil or k == "*") and type(t[k]) == "table" then + if cleanDefaults(t[k], v) then + t[k] = nil + end + end + end + else + for k in pairs(t) do + if (defaults[k] == nil or k == "*") and t[k] == v then + t[k] = nil + end + end + end + else + if type(v) == "table" then + if type(t[k]) == "table" then + if cleanDefaults(t[k], v) then + t[k] = nil + end + end + elseif t[k] == v then + t[k] = nil + end + end + end + end + return t and not next(t) +end + +function AceDB:GetProfile() + if not self.db or not self.db.raw then + return nil + end + if not self.db.raw.currentProfile then + self.db.raw.currentProfile = {} + end + if not self.db.raw.currentProfile[charID] then + self.db.raw.currentProfile[charID] = "Default" + end + local profile = self.db.raw.currentProfile[charID] + if profile == "char" then + return "char", "char/" .. charID + elseif profile == "class" then + return "class", "class/" .. classID + elseif profile == "realm" then + return "realm", "realm/" .. realmID + end + return profile, profile +end + +local function copyTable(to, from) + setmetatable(to, nil) + for k,v in pairs(from) do + if type(k) == "table" then + k = copyTable({}, k) + end + if type(v) == "table" then + v = copyTable({}, v) + end + to[k] = v + end + table_setn(to, table.getn(from)) + setmetatable(to, from) + return to +end + +function AceDB:SetProfile(name, copyFrom) + AceDB:argCheck(name, 2, "string") + AceDB:argCheck(copyFrom, 3, "string", "nil") + if not self.db or not self.db.raw then + AceDB:error("Cannot call \"SetProfile\" before \"RegisterDB\" has been called and before \"ADDON_LOADED\" has been fired.") + end + local db = self.db + local copy = false + local lowerName = string.lower(name) + local lowerCopyFrom = copyFrom and string.lower(copyFrom) + if string.sub(lowerName, 1, 5) == "char/" or string.sub(lowerName, 1, 6) == "realm/" or string.sub(lowerName, 1, 6) == "class/" then + if string.sub(lowerName, 1, 5) == "char/" then + name, copyFrom = "char", name + else + name, copyFrom = string.sub(lowerName, 1, 5), name + end + lowerName = string.lower(name) + lowerCopyFrom = string.lower(copyFrom) + end + if copyFrom then + if string.sub(lowerCopyFrom, 1, 5) == "char/" then + AceDB:assert(lowerName == "char", "If argument #3 starts with `char/', argument #2 must be `char'") + elseif string.sub(lowerCopyFrom, 1, 6) == "realm/" then + AceDB:assert(lowerName == "realm", "If argument #3 starts with `realm/', argument #2 must be `realm'") + elseif string.sub(lowerCopyFrom, 1, 6) == "class/" then + AceDB:assert(lowerName == "class", "If argument #3 starts with `class/', argument #2 must be `class'") + else + AceDB:assert(lowerName ~= "char" and lowerName ~= "realm" and lowerName ~= "class", "If argument #3 does not start with a special prefix, that prefix cannot be copied to.") + end + if not db.raw.profiles or not db.raw.profiles[copyFrom] then + AceDB:error("Cannot copy profile %q, it does not exist.", copyFrom) + elseif (string.sub(lowerName, 1, 5) == "char/" and string.sub(lowerName, 6) == string.lower(charID)) or (string.sub(lowerName, 1, 6) == "realm/" and string.sub(lowerName, 7) == string.lower(realmID)) or (string.sub(lowerName, 1, 6) == "class/" and string.sub(lowerName, 7) == string.lower(classID)) then + AceDB:error("Cannot copy profile %q, it is currently in use.", name) + end + end + local oldName = db.raw.currentProfile[charID] + if string.lower(oldName) == string.lower(name) then + return + end + local oldProfileData = db.profile + local realName = name + if lowerName == "char" then + realName = name .. "/" .. charID + elseif lowerName == "realm" then + realName = name .. "/" .. realmID + elseif lowerName == "class" then + realName = name .. "/" .. classID + end + local current = self.class + while current and current ~= AceOO.Class do + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedProfileDisable) == "function" then + safecall(mixin.OnEmbedProfileDisable, mixin, self, realName) + end + end + end + current = current.super + end + if type(self.OnProfileDisable) == "function" then + safecall(self.OnProfileDisable, self, realName) + end + local active = self:IsActive() + db.raw.currentProfile[charID] = name + rawset(db, 'profile', nil) + if db.namespaces then + for k,v in pairs(db.namespaces) do + rawset(v, 'profile', nil) + end + end + if copyFrom then + for k,v in pairs(db.profile) do + db.profile[k] = nil + end + copyTable(db.profile, db.raw.profiles[copyFrom]) + inheritDefaults(db.profile, db.defaults and db.defaults.profile) + if db.namespaces then + for l,u in pairs(db.namespaces) do + for k,v in pairs(u.profile) do + u.profile[k] = nil + end + copyTable(u.profile, db.raw.namespaces[l].profiles[copyFrom]) + inheritDefaults(u.profile, u.defaults and u.defaults.profile) + end + end + end + local current = self.class + while current and current ~= AceOO.Class do + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedProfileEnable) == "function" then + safecall(mixin.OnEmbedProfileEnable, mixin, self, oldName, oldProfileData, copyFrom) + end + end + end + current = current.super + end + if type(self.OnProfileEnable) == "function" then + safecall(self.OnProfileEnable, self, oldName, oldProfileData, copyFrom) + end + if cleanDefaults(oldProfileData, db.defaults and db.defaults.profile) then + db.raw.profiles[oldName] = nil + if not next(db.raw.profiles) then + db.raw.profiles = nil + end + end + local newactive = self:IsActive() + if active ~= newactive then + if AceOO.inherits(self, "AceAddon-2.0") then + local AceAddon = AceLibrary("AceAddon-2.0") + if not AceAddon.addonsStarted[self] then + return + end + end + if newactive then + local current = self.class + while current and current ~= AceOO.Class do + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedEnable) == "function" then + safecall(mixin.OnEmbedEnable, mixin, self) + end + end + end + current = current.super + end + if type(self.OnEnable) == "function" then + safecall(self.OnEnable, self) + end + if AceEvent then + AceEvent:TriggerEvent("Ace2_AddonEnabled", self) + end + else + local current = self.class + while current and current ~= AceOO.Class do + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedDisable) == "function" then + safecall(mixin.OnEmbedDisable, mixin, self) + end + end + end + current = current.super + end + if type(self.OnDisable) == "function" then + safecall(self.OnDisable, self) + end + if AceEvent then + AceEvent:TriggerEvent("Ace2_AddonDisabled", self) + end + end + end + if self['acedb-profile-list'] then + if not self['acedb-profile-list'][name] then + self['acedb-profile-list'][name] = name + end + end + if Dewdrop then + Dewdrop:Refresh(1) + Dewdrop:Refresh(2) + Dewdrop:Refresh(3) + Dewdrop:Refresh(4) + Dewdrop:Refresh(5) + end +end + +function AceDB:IsActive() + return not self.db or not self.db.raw or not self.db.raw.disabled or not self.db.raw.disabled[self.db.raw.currentProfile[charID]] +end + +function AceDB:ToggleActive(state) + AceDB:argCheck(state, 2, "boolean", "nil") + if not self.db or not self.db.raw then + AceDB:error("Cannot call \"ToggleActive\" before \"RegisterDB\" has been called and before \"ADDON_LOADED\" has been fired.") + end + local db = self.db + if not db.raw.disabled then + db.raw.disabled = setmetatable({}, caseInsensitive_mt) + end + local profile = db.raw.currentProfile[charID] + local disable + if state == nil then + disable = not db.raw.disabled[profile] + else + disable = not state + if disable == db.raw.disabled[profile] then + return + end + end + db.raw.disabled[profile] = disable or nil + if AceOO.inherits(self, "AceAddon-2.0") then + local AceAddon = AceLibrary("AceAddon-2.0") + if not AceAddon.addonsStarted[self] then + return + end + end + if not disable then + local current = self.class + while current and current ~= AceOO.Class do + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedEnable) == "function" then + safecall(mixin.OnEmbedEnable, mixin, self) + end + end + end + current = current.super + end + if type(self.OnEnable) == "function" then + safecall(self.OnEnable, self) + end + if AceEvent then + AceEvent:TriggerEvent("Ace2_AddonEnabled", self) + end + else + local current = self.class + while current and current ~= AceOO.Class do + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedDisable) == "function" then + safecall(mixin.OnEmbedDisable, mixin, self) + end + end + end + current = current.super + end + if type(self.OnDisable) == "function" then + safecall(self.OnDisable, self) + end + if AceEvent then + AceEvent:TriggerEvent("Ace2_AddonDisabled", self) + end + end + return not disable +end + +function AceDB:embed(target) + self.super.embed(self, target) + if not AceEvent then + AceDB:error(MAJOR_VERSION .. " requires AceEvent-2.0") + end +end + +function AceDB:ADDON_LOADED(name) + AceDB.addonsLoaded[name] = true + for addon, addonName in pairs(AceDB.addonsToBeInitialized) do + if name == addonName then + AceDB.InitializeDB(addon, name) + AceDB.addonsToBeInitialized[addon] = nil + end + end +end + +function AceDB:PLAYER_LOGOUT() + for addon in pairs(AceDB.registry) do + local db = addon.db + if db then + setmetatable(db, nil) + CrawlForSerialization(db.raw) + if type(_G[db.charName]) == "table" then + CrawlForSerialization(_G[db.charName]) + end + if db.char and cleanDefaults(db.char, db.defaults and db.defaults.char) then + if db.charName and _G[db.charName] and _G[db.charName].global == db.char then + _G[db.charName].global = nil + if not next(_G[db.charName]) then + _G[db.charName] = nil + end + else + if db.raw.chars then + db.raw.chars[charID] = nil + if not next(db.raw.chars) then + db.raw.chars = nil + end + end + end + end + if db.realm and cleanDefaults(db.realm, db.defaults and db.defaults.realm) then + if db.raw.realms then + db.raw.realms[realmID] = nil + if not next(db.raw.realms) then + db.raw.realms = nil + end + end + end + if db.class and cleanDefaults(db.class, db.defaults and db.defaults.class) then + if db.raw.classes then + db.raw.classes[classID] = nil + if not next(db.raw.classes) then + db.raw.classes = nil + end + end + end + if db.account and cleanDefaults(db.account, db.defaults and db.defaults.account) then + db.raw.account = nil + end + if db.profile and cleanDefaults(db.profile, db.defaults and db.defaults.profile) then + if db.raw.profiles then + db.raw.profiles[db.raw.currentProfile and db.raw.currentProfile[charID] or "Default"] = nil + if not next(db.raw.profiles) then + db.raw.profiles = nil + end + end + end + if db.namespaces and db.raw.namespaces then + for name,v in pairs(db.namespaces) do + if db.raw.namespaces[name] then + setmetatable(v, nil) + if v.char and cleanDefaults(v.char, v.defaults and v.defaults.char) then + if db.charName and _G[db.charName] and _G[db.charName].namespaces and _G[db.charName].namespaces[name] == v then + _G[db.charName].namespaces[name] = nil + if not next(_G[db.charName].namespaces) then + _G[db.charName].namespaces = nil + if not next(_G[db.charName]) then + _G[db.charName] = nil + end + end + else + if db.raw.namespaces[name].chars then + db.raw.namespaces[name].chars[charID] = nil + if not next(db.raw.namespaces[name].chars) then + db.raw.namespaces[name].chars = nil + end + end + end + end + if v.realm and cleanDefaults(v.realm, v.defaults and v.defaults.realm) then + if db.raw.namespaces[name].realms then + db.raw.namespaces[name].realms[realmID] = nil + if not next(db.raw.namespaces[name].realms) then + db.raw.namespaces[name].realms = nil + end + end + end + if v.class and cleanDefaults(v.class, v.defaults and v.defaults.class) then + if db.raw.namespaces[name].classes then + db.raw.namespaces[name].classes[classID] = nil + if not next(db.raw.namespaces[name].classes) then + db.raw.namespaces[name].classes = nil + end + end + end + if v.account and cleanDefaults(v.account, v.defaults and v.defaults.account) then + db.raw.namespaces[name].account = nil + end + if v.profile and cleanDefaults(v.profile, v.defaults and v.defaults.profile) then + if db.raw.namespaces[name].profiles then + db.raw.namespaces[name].profiles[db.raw.currentProfile and db.raw.currentProfile[charID] or "Default"] = nil + if not next(db.raw.namespaces[name].profiles) then + db.raw.namespaces[name].profiles = nil + end + end + end + if not next(db.raw.namespaces[name]) then + db.raw.namespaces[name] = nil + end + end + end + if not next(db.raw.namespaces) then + db.raw.namespaces = nil + end + end + if db.raw.disabled and not next(db.raw.disabled) then + db.raw.disabled = nil + end + if db.raw.currentProfile then + for k,v in pairs(db.raw.currentProfile) do + if string.lower(v) == "default" then + db.raw.currentProfile[k] = nil + end + end + if not next(db.raw.currentProfile) then + db.raw.currentProfile = nil + end + end + if _G[db.name] and not next(_G[db.name]) then + _G[db.name] = nil + end + end + end +end + +function AceDB:AcquireDBNamespace(name) + AceDB:argCheck(name, 2, "string") + local db = self.db + if not db then + AceDB:error("Cannot call `AcquireDBNamespace' before `RegisterDB' has been called.", 2) + end + if not db.namespaces then + rawset(db, 'namespaces', {}) + end + if not db.namespaces[name] then + local namespace = {} + db.namespaces[name] = namespace + namespace.db = db + namespace.name = name + setmetatable(namespace, namespace_mt) + end + return db.namespaces[name] +end + +function AceDB:GetAceOptionsDataTable(target) + if not target['acedb-profile-list'] then + target['acedb-profile-list'] = setmetatable({}, caseInsensitive_mt) + local t = target['acedb-profile-list'] + for k,v in pairs(t) do + t[k] = nil + end + t.char = CHARACTER .. charID + t.realm = REALM .. realmID + t.class = CLASS .. classID + t.Default = "Default" + if target.db and target.db.raw then + local db = target.db + if db.raw.profiles then + for k in pairs(db.raw.profiles) do + if not string.find(k, '^char/') and not string.find(k, '^realm/') and not string.find(k, '^class/') then + t[k] = k + end + end + end + end + end + if not target['acedb-profile-copylist'] then + target['acedb-profile-copylist'] = setmetatable({}, caseInsensitive_mt) + if target.db and target.db.raw then + local t = target['acedb-profile-copylist'] + local db = target.db + + if db.raw.profiles then + for k in pairs(db.raw.profiles) do + if string.find(k, '^char/') then + local name = string.sub(k, 6) + if name ~= charID then + t[k] = CHARACTER .. name + end + elseif string.find(k, '^realm/') then + local name = string.sub(k, 7) + if name ~= realmID then + t[k] = REALM .. name + end + elseif string.find(k, '^class/') then + local name = string.sub(k, 7) + if name ~= classID then + t[k] = CLASS .. name + end + end + end + end + end + end + return { + standby = { + cmdName = STATE, + guiName = ENABLED, + name = ACTIVE, + desc = TOGGLE_ACTIVE, + type = "toggle", + get = "IsActive", + set = "ToggleActive", + map = MAP_ACTIVESUSPENDED, + order = -3, + }, + profile = { + type = 'group', + name = PROFILE, + desc = SET_PROFILE, + order = -3.5, + get = "GetProfile", + args = { + choose = { + guiName = CHOOSE_PROFILE_GUI, + cmdName = PROFILE, + desc = CHOOSE_PROFILE_DESC, + type = 'text', + get = "GetProfile", + set = "SetProfile", + validate = target['acedb-profile-list'] + }, + copy = { + guiName = COPY_PROFILE_GUI, + cmdName = PROFILE, + desc = COPY_PROFILE_DESC, + type = 'text', + get = "GetProfile", + set = "SetProfile", + validate = target['acedb-profile-copylist'], + disabled = function() + return not next(target['acedb-profile-copylist']) + end, + }, + other = { + guiName = OTHER_PROFILE_GUI, + cmdName = PROFILE, + desc = OTHER_PROFILE_DESC, + usage = OTHER_PROFILE_USAGE, + type = 'text', + get = "GetProfile", + set = "SetProfile", + } + } + }, + } +end + +local function activate(self, oldLib, oldDeactivate) + AceDB = self + AceEvent = AceLibrary:HasInstance("AceEvent-2.0") and AceLibrary("AceEvent-2.0") + + self.super.activate(self, oldLib, oldDeactivate) + + for t in pairs(self.embedList) do + if t.db then + rawset(t.db, 'char', nil) + rawset(t.db, 'realm', nil) + rawset(t.db, 'class', nil) + rawset(t.db, 'account', nil) + rawset(t.db, 'profile', nil) + setmetatable(t.db, db_mt) + end + end + + if oldLib then + self.addonsToBeInitialized = oldLib.addonsToBeInitialized + self.addonsLoaded = oldLib.addonsLoaded + self.registry = oldLib.registry + end + if not self.addonsToBeInitialized then + self.addonsToBeInitialized = {} + end + if not self.addonsLoaded then + self.addonsLoaded = {} + end + if not self.registry then + self.registry = {} + end + + if oldLib then + oldDeactivate(oldLib) + end +end + +local function external(self, major, instance) + if major == "AceEvent-2.0" then + AceEvent = instance + + AceEvent:embed(self) + + self:RegisterEvent("ADDON_LOADED") + self:RegisterEvent("PLAYER_LOGOUT") + elseif major == "Dewdrop-2.0" then + Dewdrop = instance + end +end + +AceLibrary:Register(AceDB, MAJOR_VERSION, MINOR_VERSION, activate, nil, external) +AceDB = AceLibrary(MAJOR_VERSION) diff --git a/Payload/Interface/Addons/SuperAPI/libs/AceDebug-2.0/AceDebug-2.0.lua b/Payload/Interface/Addons/SuperAPI/libs/AceDebug-2.0/AceDebug-2.0.lua new file mode 100644 index 0000000..8683c8c --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/AceDebug-2.0/AceDebug-2.0.lua @@ -0,0 +1,245 @@ +--[[ +Name: AceDebug-2.0 +Revision: $Rev: 17638 $ +Developed by: The Ace Development Team (http://www.wowace.com/index.php/The_Ace_Development_Team) +Inspired By: Ace 1.x by Turan (turan@gryphon.com) +Website: http://www.wowace.com/ +Documentation: http://www.wowace.com/index.php/AceDebug-2.0 +SVN: http://svn.wowace.com/root/trunk/Ace2/AceDebug-2.0 +Description: Mixin to allow for simple debugging capabilities. +Dependencies: AceLibrary, AceOO-2.0 +]] + +local MAJOR_VERSION = "AceDebug-2.0" +local MINOR_VERSION = "$Revision: 17639 $" + +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +if loadstring("return function(...) return ... end") and AceLibrary:HasInstance(MAJOR_VERSION) then return end -- lua51 check +if not AceLibrary:HasInstance("AceOO-2.0") then error(MAJOR_VERSION .. " requires AceOO-2.0") end + +local DEBUGGING, TOGGLE_DEBUGGING + +if GetLocale() == "frFR" then + DEBUGGING = "D\195\169boguage" + TOGGLE_DEBUGGING = "Activer/d\195\169sactiver le d\195\169boguage" +elseif GetLocale() == "esES" then + DEBUGGING = "Depurar" + TOGGLE_DEBUGGING = "Activar/desactivar depurar" +elseif GetLocale() == "deDE" then + DEBUGGING = "Debuggen" + TOGGLE_DEBUGGING = "Aktiviert/Deaktiviert Debugging" +elseif GetLocale() == "koKR" then + DEBUGGING = "디버깅" + TOGGLE_DEBUGGING = "디버깅 기능 사용함/사용안함" +elseif GetLocale() == "zhTW" then + DEBUGGING = "除錯" + TOGGLE_DEBUGGING = "啟用/停用除錯功能" +elseif GetLocale() == "zhCN" then + DEBUGGING = "\232\176\131\232\175\149" + TOGGLE_DEBUGGING = "\229\144\175\231\148\168/\231\166\129\231\148\168 \232\176\131\232\175\149" +elseif GetLocale() == "ruRU" then + DEBUGGING = "Отладка" + TOGGLE_DEBUGGING = "Вкл/Выкл отладку для этого аддона." +else -- enUS + DEBUGGING = "Debugging" + TOGGLE_DEBUGGING = "Enable/disable debugging" +end + +local table_setn +do + local version = GetBuildInfo() + if string.find(version, "^2%.") then + -- 2.0.0 + table_setn = function() end + else + table_setn = table.setn + end +end + +local math_mod = math.mod or math.fmod + +local AceOO = AceLibrary:GetInstance("AceOO-2.0") +local AceDebug = AceOO.Mixin {"Debug", "CustomDebug", "IsDebugging", "SetDebugging", "SetDebugLevel", "LevelDebug", "CustomLevelDebug", "GetDebugLevel"} + +local function print(text, r, g, b, frame, delay) + (frame or DEFAULT_CHAT_FRAME):AddMessage(text, r, g, b, 1, delay or 5) +end + +local tmp + +function AceDebug:CustomDebug(r, g, b, frame, delay, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if not self.debugging then return end + + local output = string.format("|cff7fff7f(DEBUG) %s:[%s%3d]|r", tostring(self), date("%H:%M:%S"), math_mod(GetTime(), 1) * 1000) + + if string.find(tostring(a1), "%%") then + output = output .. " " .. string.format(tostring(a1), tostring(a2), tostring(a3), tostring(a4), tostring(a5), tostring(a6), tostring(a7), tostring(a8), tostring(a9), tostring(a10), tostring(a11), tostring(a12), tostring(a13), tostring(a14), tostring(a15), tostring(a16), tostring(a17), tostring(a18), tostring(a19), tostring(a20)) + else + if not tmp then + tmp = {} + end + + -- This block dynamically rebuilds the tmp array stopping on the first nil. + table.insert(tmp, output) + + table.insert(tmp, tostring(a1)) + table.insert(tmp, a2) + table.insert(tmp, a3) + table.insert(tmp, a4) + table.insert(tmp, a5) + table.insert(tmp, a6) + table.insert(tmp, a7) + table.insert(tmp, a8) + table.insert(tmp, a9) + table.insert(tmp, a10) + table.insert(tmp, a11) + table.insert(tmp, a12) + table.insert(tmp, a13) + table.insert(tmp, a14) + table.insert(tmp, a15) + table.insert(tmp, a16) + table.insert(tmp, a17) + table.insert(tmp, a18) + table.insert(tmp, a19) + table.insert(tmp, a20) + while tmp[table.getn(tmp)] == nil do + table.remove(tmp) + end + for k = 1, table.getn(tmp) do + tmp[k] = tostring(tmp[k]) + end + + output = table.concat(tmp, " ") + + for k,v in pairs(tmp) do + tmp[k] = nil + end + table_setn(tmp, 0) + end + + print(output, r, g, b, frame or self.debugFrame, delay) +end + +function AceDebug:Debug(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + AceDebug.CustomDebug(self, nil, nil, nil, nil, nil, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) +end + +function AceDebug:IsDebugging() + return self.debugging +end + +function AceDebug:SetDebugging(debugging) + self.debugging = debugging +end + +-- Takes a number 1-3 +-- Level 1: Critical messages that every user should receive +-- Level 2: Should be used for local debugging (function calls, etc) +-- Level 3: Very verbose debugging, will dump everything and anything +-- If set to nil, you will receive no debug information +function AceDebug:SetDebugLevel(level) + AceDebug:argCheck(level, 1, "number", "nil") + if not level then + self.debuglevel = nil + return + end + if level < 1 or level > 3 then + AceDebug:error("Bad argument #1 to `SetDebugLevel`, must be a number 1-3") + end + self.debuglevel = level +end + +function AceDebug:GetDebugLevel() + return self.debuglevel +end + +function AceDebug:CustomLevelDebug(level, r, g, b, frame, delay, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if not self.debugging or not self.debuglevel then return end + AceDebug:argCheck(level, 1, "number") + if level < 1 or level > 3 then + AceDebug:error("Bad argument #1 to `LevelDebug`, must be a number 1-3") + end + if level > self.debuglevel then return end + + local output = string.format("|cff7fff7f(DEBUG) %s:[%s.%3d]|r", tostring(self), date("%H:%M:%S"), math_mod(GetTime(), 1) * 1000) + + if string.find(tostring(a1), "%%") then + output = output .. " " .. string.format(tostring(a1), tostring(a2), tostring(a3), tostring(a4), tostring(a5), tostring(a6), tostring(a7), tostring(a8), tostring(a9), tostring(a10), tostring(a11), tostring(a12), tostring(a13), tostring(a14), tostring(a15), tostring(a16), tostring(a17), tostring(a18), tostring(a19), tostring(a20)) + else + if not tmp then + tmp = {} + end + + -- This block dynamically rebuilds the tmp array stopping on the first nil. + table.insert(tmp, output) + + table.insert(tmp, tostring(a1)) + table.insert(tmp, a2) + table.insert(tmp, a3) + table.insert(tmp, a4) + table.insert(tmp, a5) + table.insert(tmp, a6) + table.insert(tmp, a7) + table.insert(tmp, a8) + table.insert(tmp, a9) + table.insert(tmp, a10) + table.insert(tmp, a11) + table.insert(tmp, a12) + table.insert(tmp, a13) + table.insert(tmp, a14) + table.insert(tmp, a15) + table.insert(tmp, a16) + table.insert(tmp, a17) + table.insert(tmp, a18) + table.insert(tmp, a19) + table.insert(tmp, a20) + while tmp[table.getn(tmp)] == nil do + table.remove(tmp) + end + for k = 1, table.getn(tmp) do + tmp[k] = tostring(tmp[k]) + end + + output = table.concat(tmp, " ") + + for k,v in pairs(tmp) do + tmp[k] = nil + end + table_setn(tmp, 0) + end + + print(output, r, g, b, frame or self.debugFrame, delay) +end + +function AceDebug:LevelDebug(level, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if not self.debugging or not self.debuglevel then return end + AceDebug:argCheck(level, 1, "number") + if level < 1 or level > 3 then + AceDebug:error("Bad argument #1 to `LevelDebug`, must be a number 1-3") + end + if level > self.debuglevel then return end + + AceDebug.CustomLevelDebug(self, level, nil, nil, nil, nil, nil, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) +end + + +local options +function AceDebug:GetAceOptionsDataTable(target) + if not options then + options = { + debug = { + name = DEBUGGING, + desc = TOGGLE_DEBUGGING, + type = "toggle", + get = "IsDebugging", + set = "SetDebugging", + order = -2, + } + } + end + return options +end +AceLibrary:Register(AceDebug, MAJOR_VERSION, MINOR_VERSION, AceDebug.activate) +AceDebug = AceLibrary(MAJOR_VERSION) diff --git a/Payload/Interface/Addons/SuperAPI/libs/AceEvent-2.0/AceEvent-2.0.lua b/Payload/Interface/Addons/SuperAPI/libs/AceEvent-2.0/AceEvent-2.0.lua new file mode 100644 index 0000000..c654568 --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/AceEvent-2.0/AceEvent-2.0.lua @@ -0,0 +1,973 @@ +--[[ +Name: AceEvent-2.0 +Revision: $Rev: 17803 $ +Developed by: The Ace Development Team (http://www.wowace.com/index.php/The_Ace_Development_Team) +Inspired By: Ace 1.x by Turan (turan@gryphon.com) +Website: http://www.wowace.com/ +Documentation: http://www.wowace.com/index.php/AceEvent-2.0 +SVN: http://svn.wowace.com/root/trunk/Ace2/AceEvent-2.0 +Description: Mixin to allow for event handling, scheduling, and inter-addon + communication. +Dependencies: AceLibrary, AceOO-2.0 +]] + +local MAJOR_VERSION = "AceEvent-2.0" +local MINOR_VERSION = "$Revision: 17803 $" + +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +if loadstring("return function(...) return ... end") and AceLibrary:HasInstance(MAJOR_VERSION) then return end -- lua51 check +if not AceLibrary:HasInstance("AceOO-2.0") then error(MAJOR_VERSION .. " requires AceOO-2.0") end + +local AceOO = AceLibrary:GetInstance("AceOO-2.0") +local Mixin = AceOO.Mixin +local AceEvent = Mixin { + "RegisterEvent", + "RegisterAllEvents", + "UnregisterEvent", + "UnregisterAllEvents", + "TriggerEvent", + "ScheduleEvent", + "ScheduleRepeatingEvent", + "CancelScheduledEvent", + "CancelAllScheduledEvents", + "IsEventRegistered", + "IsEventScheduled", + "RegisterBucketEvent", + "UnregisterBucketEvent", + "UnregisterAllBucketEvents", + "IsBucketEventRegistered", + } + +local table_setn +do + local version = GetBuildInfo() + if string.find(version, "^2%.") then + -- 2.0.0 + table_setn = function() end + else + table_setn = table.setn + end +end + +local weakKey = {__mode="k"} +local new, del +do + local list = setmetatable({}, weakKey) + function new() + local t = next(list) + if t then + list[t] = nil + return t + else + return {} + end + end + + function del(t) + setmetatable(t, nil) + for k in pairs(t) do + t[k] = nil + end + list[t] = true + end +end + +local FAKE_NIL +local RATE + +local eventsWhichHappenOnce = { + PLAYER_LOGIN = true, + AceEvent_FullyInitialized = true, + VARIABLES_LOADED = true, + PLAYER_LOGOUT = true, +} + +local registeringFromAceEvent +function AceEvent:RegisterEvent(event, method, once) + AceEvent:argCheck(event, 2, "string") + if self == AceEvent and not registeringFromAceEvent then + AceEvent:argCheck(method, 3, "function") + self = method + else + AceEvent:argCheck(method, 3, "string", "function", "nil", "boolean", "number") + if type(method) == "boolean" or type(method) == "number" then + AceEvent:argCheck(once, 4, "nil") + once, method = method, event + end + end + AceEvent:argCheck(once, 4, "number", "boolean", "nil") + if eventsWhichHappenOnce[event] then + once = true + end + local throttleRate + if type(once) == "number" then + throttleRate, once = once + end + if not method then + method = event + end + if type(method) == "string" and type(self[method]) ~= "function" then + AceEvent:error("Cannot register event %q to method %q, it does not exist", event, method) + else + assert(type(method) == "function" or type(method) == "string") + end + + local AceEvent_registry = AceEvent.registry + if not AceEvent_registry[event] then + AceEvent_registry[event] = new() + AceEvent.frame:RegisterEvent(event) + end + + local remember = true + if AceEvent_registry[event][self] then + remember = false + end + AceEvent_registry[event][self] = method + + local AceEvent_onceRegistry = AceEvent.onceRegistry + if once then + if not AceEvent_onceRegistry then + AceEvent.onceRegistry = new() + AceEvent_onceRegistry = AceEvent.onceRegistry + end + if not AceEvent_onceRegistry[event] then + AceEvent_onceRegistry[event] = new() + end + AceEvent_onceRegistry[event][self] = true + else + if AceEvent_onceRegistry and AceEvent_onceRegistry[event] then + AceEvent_onceRegistry[event][self] = nil + if not next(AceEvent_onceRegistry[event]) then + AceEvent_onceRegistry[event] = del(AceEvent_onceRegistry[event]) + end + end + end + + local AceEvent_throttleRegistry = AceEvent.throttleRegistry + if throttleRate then + if not AceEvent_throttleRegistry then + AceEvent.throttleRegistry = new() + AceEvent_throttleRegistry = AceEvent.throttleRegistry + end + if not AceEvent_throttleRegistry[event] then + AceEvent_throttleRegistry[event] = new() + end + if AceEvent_throttleRegistry[event][self] then + AceEvent_throttleRegistry[event][self] = del(AceEvent_throttleRegistry[event][self]) + end + AceEvent_throttleRegistry[event][self] = setmetatable(new(), weakKey) + local t = AceEvent_throttleRegistry[event][self] + t[RATE] = throttleRate + else + if AceEvent_throttleRegistry and AceEvent_throttleRegistry[event] then + if AceEvent_throttleRegistry[event][self] then + AceEvent_throttleRegistry[event][self] = del(AceEvent_throttleRegistry[event][self]) + end + if not next(AceEvent_throttleRegistry[event]) then + AceEvent_throttleRegistry[event] = del(AceEvent_throttleRegistry[event]) + end + end + end + + if remember then + AceEvent:TriggerEvent("AceEvent_EventRegistered", self, event) + end +end + +local ALL_EVENTS + +function AceEvent:RegisterAllEvents(method) + if self == AceEvent then + AceEvent:argCheck(method, 1, "function") + self = method + else + AceEvent:argCheck(method, 1, "string", "function") + if type(method) == "string" and type(self[method]) ~= "function" then + AceEvent:error("Cannot register all events to method %q, it does not exist", method) + end + end + + local AceEvent_registry = AceEvent.registry + if not AceEvent_registry[ALL_EVENTS] then + AceEvent_registry[ALL_EVENTS] = new() + AceEvent.frame:RegisterAllEvents() + end + + AceEvent_registry[ALL_EVENTS][self] = method +end + +local _G = getfenv(0) +local memstack, timestack = {}, {} +local memdiff, timediff +function AceEvent:TriggerEvent(event, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + AceEvent:argCheck(event, 2, "string") + local AceEvent_registry = AceEvent.registry + if (not AceEvent_registry[event] or not next(AceEvent_registry[event])) and (not AceEvent_registry[ALL_EVENTS] or not next(AceEvent_registry[ALL_EVENTS])) then + return + end + local _G_event = _G.event + _G.event = event + local lastEvent = AceEvent.currentEvent + AceEvent.currentEvent = event + + local AceEvent_onceRegistry = AceEvent.onceRegistry + local AceEvent_debugTable = AceEvent.debugTable + if AceEvent_onceRegistry and AceEvent_onceRegistry[event] then + local tmp = new() + for obj, method in pairs(AceEvent_onceRegistry[event]) do + tmp[obj] = AceEvent_registry[event] and AceEvent_registry[event][obj] or nil + end + local obj = next(tmp) + while obj do + local mem, time + if AceEvent_debugTable then + if not AceEvent_debugTable[event] then + AceEvent_debugTable[event] = new() + end + if not AceEvent_debugTable[event][obj] then + AceEvent_debugTable[event][obj] = new() + AceEvent_debugTable[event][obj].mem = 0 + AceEvent_debugTable[event][obj].time = 0 + AceEvent_debugTable[event][obj].count = 0 + end + if memdiff then + table.insert(memstack, memdiff) + table.insert(timestack, timediff) + end + memdiff, timediff = 0, 0 + mem, time = gcinfo(), GetTime() + end + local method = tmp[obj] + AceEvent.UnregisterEvent(obj, event) + if type(method) == "string" then + local obj_method = obj[method] + if obj_method then + obj_method(obj, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + end + elseif method then -- function + method(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + end + if AceEvent_debugTable then + local dmem, dtime = memdiff, timediff + mem, time = gcinfo() - mem - memdiff, GetTime() - time - timediff + AceEvent_debugTable[event][obj].mem = AceEvent_debugTable[event][obj].mem + mem + AceEvent_debugTable[event][obj].time = AceEvent_debugTable[event][obj].time + time + AceEvent_debugTable[event][obj].count = AceEvent_debugTable[event][obj].count + 1 + + memdiff, timediff = table.remove(memstack), table.remove(timestack) + if memdiff then + memdiff = memdiff + mem + dmem + timediff = timediff + time + dtime + end + end + tmp[obj] = nil + obj = next(tmp) + end + del(tmp) + end + + local AceEvent_throttleRegistry = AceEvent.throttleRegistry + local throttleTable = AceEvent_throttleRegistry and AceEvent_throttleRegistry[event] + if AceEvent_registry[event] then + local tmp = new() + for obj, method in pairs(AceEvent_registry[event]) do + tmp[obj] = method + end + local obj = next(tmp) + while obj do + local method = tmp[obj] + local continue = false + if throttleTable and throttleTable[obj] then + local a1 = a1 + if a1 == nil then + a1 = FAKE_NIL + end + if not throttleTable[obj][a1] or GetTime() - throttleTable[obj][a1] >= throttleTable[obj][RATE] then + throttleTable[obj][a1] = GetTime() + else + continue = true + end + end + if not continue then + local mem, time + if AceEvent_debugTable then + if not AceEvent_debugTable[event] then + AceEvent_debugTable[event] = new() + end + if not AceEvent_debugTable[event][obj] then + AceEvent_debugTable[event][obj] = new() + AceEvent_debugTable[event][obj].mem = 0 + AceEvent_debugTable[event][obj].time = 0 + AceEvent_debugTable[event][obj].count = 0 + end + if memdiff then + table.insert(memstack, memdiff) + table.insert(timestack, timediff) + end + memdiff, timediff = 0, 0 + mem, time = gcinfo(), GetTime() + end + if type(method) == "string" then + local obj_method = obj[method] + if obj_method then + obj_method(obj, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + end + elseif method then -- function + method(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + end + if AceEvent_debugTable then + local dmem, dtime = memdiff, timediff + mem, time = gcinfo() - mem - memdiff, GetTime() - time - timediff + AceEvent_debugTable[event][obj].mem = AceEvent_debugTable[event][obj].mem + mem + AceEvent_debugTable[event][obj].time = AceEvent_debugTable[event][obj].time + time + AceEvent_debugTable[event][obj].count = AceEvent_debugTable[event][obj].count + 1 + + memdiff, timediff = table.remove(memstack), table.remove(timestack) + if memdiff then + memdiff = memdiff + mem + dmem + timediff = timediff + time + dtime + end + end + end + tmp[obj] = nil + obj = next(tmp) + end + del(tmp) + end + if AceEvent_registry[ALL_EVENTS] then + local tmp = new() + for obj, method in pairs(AceEvent_registry[ALL_EVENTS]) do + tmp[obj] = method + end + local obj = next(tmp) + while obj do + local method = tmp[obj] + local mem, time + if AceEvent_debugTable then + if not AceEvent_debugTable[event] then + AceEvent_debugTable[event] = new() + end + if not AceEvent_debugTable[event][obj] then + AceEvent_debugTable[event][obj] = new() + AceEvent_debugTable[event][obj].mem = 0 + AceEvent_debugTable[event][obj].time = 0 + AceEvent_debugTable[event][obj].count = 0 + end + if memdiff then + table.insert(memstack, memdiff) + table.insert(timestack, timediff) + end + memdiff, timediff = 0, 0 + mem, time = gcinfo(), GetTime() + end + if type(method) == "string" then + local obj_method = obj[method] + if obj_method then + obj_method(obj, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + end + elseif method then -- function + method(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + end + if AceEvent_debugTable then + local dmem, dtime = memdiff, timediff + mem, time = gcinfo() - mem - memdiff, GetTime() - time - timediff + AceEvent_debugTable[event][obj].mem = AceEvent_debugTable[event][obj].mem + mem + AceEvent_debugTable[event][obj].time = AceEvent_debugTable[event][obj].time + time + AceEvent_debugTable[event][obj].count = AceEvent_debugTable[event][obj].count + 1 + + memdiff, timediff = table.remove(memstack), table.remove(timestack) + if memdiff then + memdiff = memdiff + mem + dmem + timediff = timediff + time + dtime + end + end + tmp[obj] = nil + obj = next(tmp) + end + del(tmp) + end + _G.event = _G_event + AceEvent.currentEvent = lastEvent +end + +-- local accessors +local getn = table.getn +local tinsert = table.insert +local tremove = table.remove +local floor = math.floor +local GetTime = GetTime +local next = next +local pairs = pairs +local unpack = unpack + +local delayRegistry +local tmp = {} +local function OnUpdate() + local t = GetTime() + for k,v in pairs(delayRegistry) do + tmp[k] = true + end + for k in pairs(tmp) do + local v = delayRegistry[k] + if v then + local v_time = v.time + if not v_time then + delayRegistry[k] = del(v) + elseif v_time <= t then + local v_repeatDelay = v.repeatDelay + if v_repeatDelay then + -- use the event time, not the current time, else timing inaccuracies add up over time + v.time = v_time + v_repeatDelay + end + local event = v.event + local mem, time + if AceEvent_debugTable then + mem, time = gcinfo(), GetTime() + end + if type(event) == "function" then + event(unpack(v)) + else + AceEvent:TriggerEvent(event, unpack(v)) + end + if AceEvent_debugTable then + mem, time = gcinfo() - mem, GetTime() - time + v.mem = v.mem + mem + v.timeSpent = v.timeSpent + time + v.count = v.count + 1 + end + if not v_repeatDelay then + local x = delayRegistry[k] + if x and x.time == v_time then -- check if it was manually reset + delayRegistry[k] = del(v) + end + end + end + end + end + for k in pairs(tmp) do + tmp[k] = nil + end + if not next(delayRegistry) then + AceEvent.frame:Hide() + end +end + +local function ScheduleEvent(self, repeating, event, delay, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + local id + if type(event) == "string" or type(event) == "table" then + if type(event) == "table" then + if not delayRegistry or not delayRegistry[event] then + AceEvent:error("Bad argument #2 to `ScheduleEvent'. Improper id table fed in.") + end + end + if type(delay) ~= "number" then + id, event, delay, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20 = event, delay, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20 + AceEvent:argCheck(event, 3, "string", "function", --[[ so message is right ]] "number") + AceEvent:argCheck(delay, 4, "number") + self:CancelScheduledEvent(id) + end + else + AceEvent:argCheck(event, 2, "string", "function") + AceEvent:argCheck(delay, 3, "number") + end + + if not delayRegistry then + AceEvent.delayRegistry = new() + delayRegistry = AceEvent.delayRegistry + AceEvent.frame:SetScript("OnUpdate", OnUpdate) + end + local t + if type(id) == "table" then + for k in pairs(id) do + id[k] = nil + end + t = id + else + t = new() + end + t[1] = a1 + t[2] = a2 + t[3] = a3 + t[4] = a4 + t[5] = a5 + t[6] = a6 + t[7] = a7 + t[8] = a8 + t[9] = a9 + t[10] = a10 + t[11] = a11 + t[12] = a12 + t[13] = a13 + t[14] = a14 + t[15] = a15 + t[16] = a16 + t[17] = a17 + t[18] = a18 + t[19] = a19 + t[20] = a20 + table_setn(t, 20) + t.event = event + t.time = GetTime() + delay + t.self = self + t.id = id or t + t.repeatDelay = repeating and delay + if AceEvent_debugTable then + t.mem = 0 + t.count = 0 + t.timeSpent = 0 + end + delayRegistry[t.id] = t + AceEvent.frame:Show() + return t.id +end + +function AceEvent:ScheduleEvent(event, delay, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if type(event) == "string" or type(event) == "table" then + if type(event) == "table" then + if not delayRegistry or not delayRegistry[event] then + AceEvent:error("Bad argument #2 to `ScheduleEvent'. Improper id table fed in.") + end + end + if type(delay) ~= "number" then + AceEvent:argCheck(delay, 3, "string", "function", --[[ so message is right ]] "number") + AceEvent:argCheck(a1, 4, "number") + end + else + AceEvent:argCheck(event, 2, "string", "function") + AceEvent:argCheck(delay, 3, "number") + end + + return ScheduleEvent(self, false, event, delay, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) +end + +function AceEvent:ScheduleRepeatingEvent(event, delay, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if type(event) == "string" or type(event) == "table" then + if type(event) == "table" then + if not delayRegistry or not delayRegistry[event] then + AceEvent:error("Bad argument #2 to `ScheduleEvent'. Improper id table fed in.") + end + end + if type(delay) ~= "number" then + AceEvent:argCheck(delay, 3, "string", "function", --[[ so message is right ]] "number") + AceEvent:argCheck(a1, 4, "number") + end + else + AceEvent:argCheck(event, 2, "string", "function") + AceEvent:argCheck(delay, 3, "number") + end + + return ScheduleEvent(self, true, event, delay, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) +end + +function AceEvent:CancelScheduledEvent(t) + AceEvent:argCheck(t, 2, "string", "table") + if delayRegistry then + local v = delayRegistry[t] + if v then + delayRegistry[t] = del(v) + if not next(delayRegistry) then + AceEvent.frame:Hide() + end + return true + end + end + return false +end + +function AceEvent:IsEventScheduled(t) + AceEvent:argCheck(t, 2, "string", "table") + if delayRegistry then + local v = delayRegistry[t] + if v then + return true, v.time - GetTime() + end + end + return false, nil +end + +function AceEvent:UnregisterEvent(event) + AceEvent:argCheck(event, 2, "string") + local AceEvent_registry = AceEvent.registry + if AceEvent_registry[event] and AceEvent_registry[event][self] then + AceEvent_registry[event][self] = nil + local AceEvent_onceRegistry = AceEvent.onceRegistry + if AceEvent_onceRegistry and AceEvent_onceRegistry[event] and AceEvent_onceRegistry[event][self] then + AceEvent_onceRegistry[event][self] = nil + if not next(AceEvent_onceRegistry[event]) then + AceEvent_onceRegistry[event] = del(AceEvent_onceRegistry[event]) + end + end + local AceEvent_throttleRegistry = AceEvent.throttleRegistry + if AceEvent_throttleRegistry and AceEvent_throttleRegistry[event] and AceEvent_throttleRegistry[event][self] then + AceEvent_throttleRegistry[event][self] = del(AceEvent_throttleRegistry[event][self]) + if not next(AceEvent_throttleRegistry[event]) then + AceEvent_throttleRegistry[event] = del(AceEvent_throttleRegistry[event]) + end + end + if not next(AceEvent_registry[event]) then + AceEvent_registry[event] = del(AceEvent_registry[event]) + if not AceEvent_registry[ALL_EVENTS] or not next(AceEvent_registry[ALL_EVENTS]) then + AceEvent.frame:UnregisterEvent(event) + end + end + else + if self == AceEvent then + error(string.format("Cannot unregister event %q. Improperly unregistering from AceEvent-2.0.", event), 2) + else + AceEvent:error("Cannot unregister event %q. %q is not registered with it.", event, self) + end + end + AceEvent:TriggerEvent("AceEvent_EventUnregistered", self, event) +end + +function AceEvent:UnregisterAllEvents() + local AceEvent_registry = AceEvent.registry + if AceEvent_registry[ALL_EVENTS] and AceEvent_registry[ALL_EVENTS][self] then + AceEvent_registry[ALL_EVENTS][self] = nil + if not next(AceEvent_registry[ALL_EVENTS]) then + del(AceEvent_registry[ALL_EVENTS]) + AceEvent.frame:UnregisterAllEvents() + for k,v in pairs(AceEvent_registry) do + if k ~= ALL_EVENTS then + AceEvent.frame:RegisterEvent(k) + end + end + AceEvent_registry[event] = nil + end + end + local first = true + for event, data in pairs(AceEvent_registry) do + if first then + if AceEvent_registry.AceEvent_EventUnregistered then + event = "AceEvent_EventUnregistered" + else + first = false + end + end + local x = data[self] + data[self] = nil + if x and event ~= ALL_EVENTS then + if not next(data) then + del(data) + if not AceEvent_registry[ALL_EVENTS] or not next(AceEvent_registry[ALL_EVENTS]) then + AceEvent.frame:UnregisterEvent(event) + end + AceEvent_registry[event] = nil + end + AceEvent:TriggerEvent("AceEvent_EventUnregistered", self, event) + end + if first then + event = nil + end + end + if AceEvent.onceRegistry then + for event, data in pairs(AceEvent.onceRegistry) do + data[self] = nil + end + end +end + +function AceEvent:CancelAllScheduledEvents() + if delayRegistry then + for k,v in pairs(delayRegistry) do + if v.self == self then + delayRegistry[k] = del(v) + end + end + if not next(delayRegistry) then + AceEvent.frame:Hide() + end + end +end + +function AceEvent:IsEventRegistered(event) + AceEvent:argCheck(event, 2, "string") + local AceEvent_registry = AceEvent.registry + if self == AceEvent then + return AceEvent_registry[event] and next(AceEvent_registry[event]) and true or false + end + if AceEvent_registry[event] and AceEvent_registry[event][self] then + return true, AceEvent_registry[event][self] + end + return false, nil +end + +local bucketfunc +function AceEvent:RegisterBucketEvent(event, delay, method) + AceEvent:argCheck(event, 2, "string", "table") + if type(event) == "table" then + for k,v in pairs(event) do + if type(k) ~= "number" then + AceEvent:error("All keys to argument #2 to `RegisterBucketEvent' must be numbers.") + elseif type(v) ~= "string" then + AceEvent:error("All values to argument #2 to `RegisterBucketEvent' must be strings.") + end + end + end + AceEvent:argCheck(delay, 3, "number") + if AceEvent == self then + AceEvent:argCheck(method, 4, "function") + self = method + else + if type(event) == "string" then + AceEvent:argCheck(method, 4, "string", "function", "nil") + if not method then + method = event + end + else + AceEvent:argCheck(method, 4, "string", "function") + end + + if type(method) == "string" and type(self[method]) ~= "function" then + AceEvent:error("Cannot register event %q to method %q, it does not exist", event, method) + end + end + if not AceEvent.buckets then + AceEvent.buckets = new() + end + if not AceEvent.buckets[event] then + AceEvent.buckets[event] = new() + end + if not AceEvent.buckets[event][self] then + AceEvent.buckets[event][self] = new() + AceEvent.buckets[event][self].current = new() + AceEvent.buckets[event][self].self = self + else + AceEvent.CancelScheduledEvent(self, AceEvent.buckets[event][self].id) + end + local bucket = AceEvent.buckets[event][self] + bucket.method = method + + local func = function(arg1) + bucket.run = true + if arg1 then + bucket.current[arg1] = true + end + end + AceEvent.buckets[event][self].func = func + if type(event) == "string" then + AceEvent.RegisterEvent(self, event, func) + else + for _,v in ipairs(event) do + AceEvent.RegisterEvent(self, v, func) + end + end + if not bucketfunc then + bucketfunc = function(bucket) + local current = bucket.current + local method = bucket.method + local self = bucket.self + if bucket.run then + if type(method) == "string" then + self[method](self, current) + elseif method then -- function + method(current) + end + for k in pairs(current) do + current[k] = nil + k = nil + end + bucket.run = false + end + end + end + bucket.id = AceEvent.ScheduleRepeatingEvent(self, bucketfunc, delay, bucket) +end + +function AceEvent:IsBucketEventRegistered(event) + AceEvent:argCheck(event, 2, "string", "table") + return AceEvent.buckets and AceEvent.buckets[event] and AceEvent.buckets[event][self] +end + +function AceEvent:UnregisterBucketEvent(event) + AceEvent:argCheck(event, 2, "string", "table") + if not AceEvent.buckets or not AceEvent.buckets[event] or not AceEvent.buckets[event][self] then + AceEvent:error("Cannot unregister bucket event %q. %q is not registered with it.", event, self) + end + + local bucket = AceEvent.buckets[event][self] + + if type(event) == "string" then + AceEvent.UnregisterEvent(self, event) + else + for _,v in ipairs(event) do + AceEvent.UnregisterEvent(self, v) + end + end + AceEvent:CancelScheduledEvent(bucket.id) + + del(bucket.current) + AceEvent.buckets[event][self] = del(AceEvent.buckets[event][self]) + if not next(AceEvent.buckets[event]) then + AceEvent.buckets[event] = del(AceEvent.buckets[event]) + end +end + +function AceEvent:UnregisterAllBucketEvents() + if not AceEvent.buckets or not next(AceEvent.buckets) then + return + end + for k,v in pairs(AceEvent.buckets) do + if v == self then + AceEvent.UnregisterBucketEvent(self, k) + k = nil + end + end +end + +function AceEvent:OnEmbedDisable(target) + self.UnregisterAllEvents(target) + + self.CancelAllScheduledEvents(target) + + self.UnregisterAllBucketEvents(target) +end + +function AceEvent:EnableDebugging() + if not self.debugTable then + self.debugTable = new() + + if delayRegistry then + for k,v in pairs(self.delayRegistry) do + if not v.mem then + v.mem = 0 + v.count = 0 + v.timeSpent = 0 + end + end + end + end +end + +function AceEvent:IsFullyInitialized() + return self.postInit or false +end + +function AceEvent:IsPostPlayerLogin() + return self.playerLogin or false +end + +function AceEvent:activate(oldLib, oldDeactivate) + AceEvent = self + + if oldLib then + self.onceRegistry = oldLib.onceRegistry + self.throttleRegistry = oldLib.throttleRegistry + self.delayRegistry = oldLib.delayRegistry + self.buckets = oldLib.buckets + self.registry = oldLib.registry + self.frame = oldLib.frame + self.debugTable = oldLib.debugTable + self.playerLogin = oldLib.pew or DEFAULT_CHAT_FRAME and DEFAULT_CHAT_FRAME.defaultLanguage and true + self.postInit = oldLib.postInit or self.playerLogin and ChatTypeInfo and ChatTypeInfo.WHISPER and ChatTypeInfo.WHISPER.r and true + self.ALL_EVENTS = oldLib.ALL_EVENTS + self.FAKE_NIL = oldLib.FAKE_NIL + self.RATE = oldLib.RATE + end + if not self.registry then + self.registry = {} + end + if not self.frame then + self.frame = CreateFrame("Frame", "AceEvent20Frame") + end + if not self.ALL_EVENTS then + self.ALL_EVENTS = {} + end + if not self.FAKE_NIL then + self.FAKE_NIL = {} + end + if not self.RATE then + self.RATE = {} + end + ALL_EVENTS = self.ALL_EVENTS + FAKE_NIL = self.FAKE_NIL + RATE = self.RATE + local inPlw = false + local blacklist = { + UNIT_INVENTORY_CHANGED = true, + BAG_UPDATE = true, + ITEM_LOCK_CHANGED = true, + ACTIONBAR_SLOT_CHANGED = true, + } + self.frame:SetScript("OnEvent", function() + local event = event + if event == "PLAYER_ENTERING_WORLD" then + inPlw = false + elseif event == "PLAYER_LEAVING_WORLD" then + inPlw = true + end + if event and (not inPlw or not blacklist[event]) then + self:TriggerEvent(event, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) + end + end) + if self.delayRegistry then + delayRegistry = self.delayRegistry + self.frame:SetScript("OnUpdate", OnUpdate) + end + + self:UnregisterAllEvents() + self:CancelAllScheduledEvents() + + registeringFromAceEvent = true + self:RegisterEvent("LOOT_OPENED", function() + SendAddonMessage("LOOT_OPENED", "", "RAID") + end) + registeringFromAceEvent = nil + + if not self.playerLogin then + registeringFromAceEvent = true + self:RegisterEvent("PLAYER_LOGIN", function() + self.playerLogin = true + end, true) + registeringFromAceEvent = nil + end + + if not self.postInit then + local isReload = true + local function func() + self.postInit = true + self:TriggerEvent("AceEvent_FullyInitialized") + if self.registry["CHAT_MSG_CHANNEL_NOTICE"] and self.registry["CHAT_MSG_CHANNEL_NOTICE"][self] then + self:UnregisterEvent("CHAT_MSG_CHANNEL_NOTICE") + end + if self.registry["MEETINGSTONE_CHANGED"] and self.registry["MEETINGSTONE_CHANGED"][self] then + self:UnregisterEvent("MEETINGSTONE_CHANGED") + end + if self.registry["MINIMAP_ZONE_CHANGED"] and self.registry["MINIMAP_ZONE_CHANGED"][self] then + self:UnregisterEvent("MINIMAP_ZONE_CHANGED") + end + if self.registry["LANGUAGE_LIST_CHANGED"] and self.registry["LANGUAGE_LIST_CHANGED"][self] then + self:UnregisterEvent("LANGUAGE_LIST_CHANGED") + end + end + registeringFromAceEvent = true + local f = function() + self.playerLogin = true + self:ScheduleEvent("AceEvent_FullyInitialized", func, 1) + end + self:RegisterEvent("MEETINGSTONE_CHANGED", f, true) + self:RegisterEvent("CHAT_MSG_CHANNEL_NOTICE", function() + self:ScheduleEvent("AceEvent_FullyInitialized", func, 0.05) + end) + self:RegisterEvent("LANGUAGE_LIST_CHANGED", function() + if self.registry["MEETINGSTONE_CHANGED"] and self.registry["MEETINGSTONE_CHANGED"][self] then + registeringFromAceEvent = true + self:UnregisterEvent("MEETINGSTONE_CHANGED") + self:RegisterEvent("MINIMAP_ZONE_CHANGED", f, true) + registeringFromAceEvent = nil + end + end) + self:ScheduleEvent("AceEvent_FullyInitialized", func, 10) + registeringFromAceEvent = nil + end + + self.super.activate(self, oldLib, oldDeactivate) + if oldLib then + oldDeactivate(oldLib) + end +end + +AceLibrary:Register(AceEvent, MAJOR_VERSION, MINOR_VERSION, AceEvent.activate) +AceEvent = AceLibrary(MAJOR_VERSION) diff --git a/Payload/Interface/Addons/SuperAPI/libs/AceHook-2.1/AceHook-2.1.lua b/Payload/Interface/Addons/SuperAPI/libs/AceHook-2.1/AceHook-2.1.lua new file mode 100644 index 0000000..8beaf66 --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/AceHook-2.1/AceHook-2.1.lua @@ -0,0 +1,569 @@ +--[[ +Name: AceHook-2.1 +Revision: $Rev: 17638 $ +Developed by: The Ace Development Team (http://www.wowace.com/index.php/The_Ace_Development_Team) +Inspired By: Ace 1.x by Turan (turan@gryphon.com) +Website: http://www.wowace.com/ +Documentation: http://www.wowace.com/index.php/AceHook-2.1 +SVN: http://svn.wowace.com/root/trunk/Ace2/AceHook-2.1 +Description: Mixin to allow for safe hooking of functions, methods, and scripts. +Dependencies: AceLibrary, AceOO-2.0 +]] + +local MAJOR_VERSION = "AceHook-2.1" +local MINOR_VERSION = "$Revision: 17638 $" + +-- This ensures the code is only executed if the libary doesn't already exist, or is a newer version +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary.") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +if loadstring("return function(...) return ... end") and AceLibrary:HasInstance(MAJOR_VERSION) then return end -- lua51 check +if not AceLibrary:HasInstance("AceOO-2.0") then error(MAJOR_VERSION .. " requires AceOO-2.0") end + +--[[--------------------------------------------------------------------------------- + Create the library object +----------------------------------------------------------------------------------]] + +local AceOO = AceLibrary:GetInstance("AceOO-2.0") +local AceHook = AceOO.Mixin { + "Hook", + "HookScript", + "SecureHook", + "Unhook", + "UnhookAll", + "HookReport", + "IsHooked", + } + +--[[--------------------------------------------------------------------------------- + Library Definitions +----------------------------------------------------------------------------------]] + +local protFuncs = { + CameraOrSelectOrMoveStart = true, CameraOrSelectOrMoveStop = true, + TurnOrActionStart = true, TurnOrActionStop = true, + PitchUpStart = true, PitchUpStop = true, + PitchDownStart = true, PitchDownStop = true, + MoveBackwardStart = true, MoveBackwardStop = true, + MoveForwardStart = true, MoveForwardStop = true, + Jump = true, StrafeLeftStart = true, + StrafeLeftStop = true, StrafeRightStart = true, + StrafeRightStop = true, ToggleMouseMove = true, + ToggleRun = true, TurnLeftStart = true, + TurnLeftStop = true, TurnRightStart = true, + TurnRightStop = true, +} + +local function issecurevariable(x) + if protFuncs[x] then + return 1 + else + return nil + end +end + +local _G = getfenv(0) + +local function hooksecurefunc(arg1, arg2, arg3) + if type(arg1) == "string" then + arg1, arg2, arg3 = _G, arg1, arg2 + end + local orig = arg1[arg2] + arg1[arg2] = function(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + local x1,x2,x3,x4,x5,x6,x7,x8,x9,x10,x11,x12,x13,x14,x15,x16,x17,x18,x19,x20 = orig(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + + arg3(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + + return x1,x2,x3,x4,x5,x6,x7,x8,x9,x10,x11,x12,x13,x14,x15,x16,x17,x18,x19,x20 + end +end + +local protectedScripts = { + OnClick = true, +} + + +local handlers, scripts, actives, registry + +--[[--------------------------------------------------------------------------------- + Private definitions (Not exposed) +----------------------------------------------------------------------------------]] + +local new, del +do + local list = setmetatable({}, {__mode = "k"}) + function new() + local t = next(list) + if not t then + return {} + end + list[t] = nil + return t + end + + function del(t) + setmetatable(t, nil) + for k in pairs(t) do + t[k] = nil + end + list[t] = true + end +end + +local function createFunctionHook(self, func, handler, orig, secure) + if not secure then + if type(handler) == "string" then + -- The handler is a method, need to self it + local uid + uid = function(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + if actives[uid] then + return self[handler](self, a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + else + return orig(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + end + end + return uid + else + -- The handler is a function, just call it + local uid + uid = function(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + if actives[uid] then + return handler(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + else + return orig(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + end + end + return uid + end + else + -- secure hooks don't call the original method + if type(handler) == "string" then + -- The handler is a method, need to self it + local uid + uid = function(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + if actives[uid] then + return self[handler](self, a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + end + end + return uid + else + -- The handler is a function, just call it + local uid + uid = function(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + if actives[uid] then + return handler(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + end + end + return uid + end + end +end + +local function createMethodHook(self, object, method, handler, orig, secure, script) + if script then + if type(handler) == "string" then + local uid + uid = function() + if actives[uid] then + return self[handler](self, object) + else + return orig() + end + end + return uid + else + -- The handler is a function, just call it + local uid + uid = function() + if actives[uid] then + return handler(object) + else + return orig() + end + end + return uid + end + elseif not secure then + if type(handler) == "string" then + local uid + uid = function(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + if actives[uid] then + return self[handler](self, a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + else + return orig(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + end + end + return uid + else + -- The handler is a function, just call it + local uid + uid = function(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + if actives[uid] then + return handler(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + else + return orig(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + end + end + return uid + end + else + -- secure hooks don't call the original method + if type(handler) == "string" then + local uid + uid = function(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + if actives[uid] then + return self[handler](self, a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + end + end + return uid + else + -- The handler is a function, just call it + local uid + uid = function(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + if actives[uid] then + return handler(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,a16,a17,a18,a19,a20) + end + end + return uid + end + end +end + +local function hookFunction(self, func, handler, secure) + local orig = _G[func] + + if not orig or type(orig) ~= "function" then + AceHook:error("Attempt to hook a non-existant function %q", func) + end + + if not handler then + handler = func + end + + if registry[self][func] then + local uid = registry[self][func] + + if actives[uid] then + -- We have an active hook from this source. Don't multi-hook + AceHook:error("%q already has an active hook from this source.", func) + end + + if handlers[uid] == handler then + -- The hook is inactive, so reactivate it + actives[uid] = true + return + else + AceHook:error("There is a stale hook for %q can't hook or reactivate.", func) + end + end + + if type(handler) == "string" then + if type(self[handler]) ~= "function" then + AceHook:error("Could not find the the handler %q when hooking function %q", handler, func) + end + elseif type(handler) ~= "function" then + AceHook:error("Could not find the handler you supplied when hooking %q", func) + end + + local uid = createFunctionHook(self, func, handler, orig, secure) + registry[self][func] = uid + actives[uid] = true + handlers[uid] = handler + + if not secure then + _G[func] = uid + self.hooks[func] = orig + else + hooksecurefunc(func, uid) + end +end + +local function unhookFunction(self, func) + if not registry[self][func] then + AceHook:error("Tried to unhook %q which is not currently hooked.", func) + end + + local uid = registry[self][func] + + if actives[uid] then + -- See if we own the global function + if self.hooks[func] and _G[func] == uid then + _G[func] = self.hooks[func] + self.hooks[func] = nil + registry[self][func] = nil + handlers[uid] = nil + scripts[uid] = nil + actives[uid] = nil + -- Magically all-done + else + actives[uid] = nil + end + end +end + +local function hookMethod(self, obj, method, handler, script, secure) + if not handler then + handler = method + end + + if not obj or type(obj) ~= "table" then + AceHook:error("The object you supplied could not be found, or isn't a table.") + end + + local uid = registry[self][obj] and registry[self][obj][method] + if uid then + if actives[uid] then + -- We have an active hook from this source. Don't multi-hook + AceHook:error("%q already has an active hook from this source.", method) + end + + if handlers[uid] == handler then + -- The hook is inactive, reactivate it. + actives[uid] = true + return + else + AceHook:error("There is a stale hook for %q can't hook or reactivate.", method) + end + end + + if type(handler) == "string" then + if type(self[handler]) ~= "function" then + AceHook:error("Could not find the handler %q you supplied when hooking method %q", handler, method) + end + elseif type(handler) ~= "function" then + AceHook:error("Could not find the handler you supplied when hooking method %q", method) + end + + local orig + if script then + if not obj.GetScript then + AceHook:error("The object you supplied does not have a GetScript method.") + end + if not obj:HasScript(method) then + AceHook:error("The object you supplied doesn't allow the %q method.", method) + end + + orig = obj:GetScript(method) + if type(orig) ~= "function" then + -- Sometimes there is not a original function for a script. + orig = function() end + end + else + orig = obj[method] + end + if not orig then + AceHook:error("Could not find the method or script %q you are trying to hook.", method) + end + + if not registry[self][obj] then + registry[self][obj] = new() + end + + if not self.hooks[obj] then + self.hooks[obj] = new() + end + + local uid = createMethodHook(self, obj, method, handler, orig, secure, script) + registry[self][obj][method] = uid + actives[uid] = true + handlers[uid] = handler + scripts[uid] = script and true or nil + + if script then + obj:SetScript(method, uid) + self.hooks[obj][method] = orig + elseif not secure then + obj[method] = uid + self.hooks[obj][method] = orig + else + hooksecurefunc(obj, method, uid) + end +end + +local function unhookMethod(self, obj, method) + if not registry[self][obj] or not registry[self][obj][method] then + AceHook:error("Attempt to unhook a method %q that is not currently hooked.", method) + return + end + + local uid = registry[self][obj][method] + + if actives[uid] then + if scripts[uid] then -- If this is a script + if obj:GetScript(method) == uid then + -- We own the script. Revert to normal. + obj:SetScript(method, self.hooks[obj][method]) + self.hooks[obj][method] = nil + registry[self][obj][method] = nil + handlers[uid] = nil + scripts[uid] = nil + actives[uid] = nil + else + actives[uid] = nil + end + else + if self.hooks[obj] and self.hooks[obj][method] and obj[method] == uid then + -- We own the method. Revert to normal. + obj[method] = self.hooks[obj][method] + self.hooks[obj][method] = nil + registry[self][obj][method] = nil + handlers[uid] = nil + actives[uid] = nil + else + actives[uid] = nil + end + end + end + if self.hooks[obj] and not next(self.hooks[obj]) then + self.hooks[obj] = del(self.hooks[obj]) + end + if not next(registry[self][obj]) then + registry[self][obj] = del(registry[self][obj]) + end +end + +-- ("function" [, handler] [, hookSecure]) or (object, "method" [, handler] [, hookSecure]) +function AceHook:Hook(object, method, handler, hookSecure) + if type(object) == "string" then + method, handler, hookSecure = object, method, handler + if handler == true then + handler, hookSecure = nil, true + end + if not hookSecure and issecurevariable(method) then + AceHook:error("Attempt to hook secure function %q. Use `SecureHook' or add `true' to the argument list to override.", method) + end + AceHook:argCheck(handler, 3, "function", "string", "nil") + AceHook:argCheck(hookSecure, 4, "boolean", "nil") + hookFunction(self, method, handler, false) + else + if handler == true then + handler, hookSecure = nil, true + end + if not hookSecure and issecurevariable(object, method) then + AceHook:error("Attempt to hook secure method %q. Use `SecureHook' or add `true' to the argument list to override.", method) + end + AceHook:argCheck(object, 2, "table") + AceHook:argCheck(method, 3, "string") + AceHook:argCheck(handler, 4, "function", "string", "nil") + AceHook:argCheck(hookSecure, 5, "boolean", "nil") + hookMethod(self, object, method, handler, false, false) + end +end + +-- ("function", handler) or (object, "method", handler) +function AceHook:SecureHook(object, method, handler) + if type(object) == "string" then + method, handler = object, method + AceHook:argCheck(handler, 3, "function", "string", "nil") + hookFunction(self, method, handler, true) + else + AceHook:argCheck(object, 2, "table") + AceHook:argCheck(method, 3, "string") + AceHook:argCheck(handler, 4, "function", "string", "nil") + hookMethod(self, object, method, handler, false, true) + end +end + +function AceHook:HookScript(frame, script, handler) + AceHook:argCheck(frame, 2, "table") + if not frame[0] or type(frame.IsFrameType) ~= "function" then + AceHook:error("Bad argument #2 to `HookScript'. Expected frame.") + end + AceHook:argCheck(script, 3, "string") + AceHook:argCheck(handler, 4, "function", "string", "nil") + hookMethod(self, frame, script, handler, true, false) +end + +-- ("function") or (object, "method") +function AceHook:IsHooked(obj, method) + if type(obj) == "string" then + if registry[self][obj] and actives[registry[self][obj]] then + return true, handlers[registry[self][obj]] + end + else + AceHook:argCheck(obj, 2, "string", "table") + AceHook:argCheck(method, 3, "string") + if registry[self][obj] and registry[self][obj][method] and actives[registry[self][obj][method]] then + return true, handlers[registry[self][obj][method]] + end + end + + return false, nil +end + +-- ("function") or (object, "method") +function AceHook:Unhook(obj, method) + if type(obj) == "string" then + unhookFunction(self, obj) + else + AceHook:argCheck(obj, 2, "string", "table") + AceHook:argCheck(method, 3, "string") + unhookMethod(self, obj, method) + end +end + +function AceHook:UnhookAll() + for key, value in pairs(registry[self]) do + if type(key) == "table" then + for method in pairs(value) do + self:Unhook(key, method) + end + else + self:Unhook(key) + end + end +end + +function AceHook:HookReport() + DEFAULT_CHAT_FRAME:AddMessage("This is a list of all active hooks for this object:") + if not next(registry[self]) then + DEFAULT_CHAT_FRAME:AddMessage("No hooks") + end + + for key, value in pairs(registry[self]) do + if type(value) == "table" then + for method, uid in pairs(value) do + DEFAULT_CHAT_FRAME:AddMessage(string.format("object: %s method: %q |cff%s|r%s", tostring(key), method, actives[uid] and "00ff00Active" or "ffff00Inactive", not self.hooks[key][method] and " |cff7f7fff-Secure-|r" or "")) + end + else + DEFAULT_CHAT_FRAME:AddMessage(string.format("function: %q |cff%s|r%s", tostring(key), actives[value] and "00ff00Active" or "ffff00Inactive", not self.hooks[key] and " |cff7f7fff-Secure-|r" or "")) + end + end +end + +function AceHook:OnInstanceInit(object) + if not object.hooks then + object.hooks = new() + end + if not registry[object] then + registry[object] = new() + end +end + +AceHook.OnManualEmbed = AceHook.OnInstanceInit + +function AceHook:OnEmbedDisable(target) + self.UnhookAll(target) +end + +local function activate(self, oldLib, oldDeactivate) + AceHook = self + + self.handlers = oldLib and oldLib.handlers or {} + self.registry = oldLib and oldLib.registry or {} + self.scripts = oldLib and oldLib.scripts or {} + self.actives = oldLib and oldLib.actives or {} + + handlers = self.handlers + registry = self.registry + scripts = self.scripts + actives = self.actives + + AceHook.super.activate(self, oldLib, oldDeactivate) + + if oldDeactivate then + oldDeactivate(oldLib) + end +end + +AceLibrary:Register(AceHook, MAJOR_VERSION, MINOR_VERSION, activate) diff --git a/Payload/Interface/Addons/SuperAPI/libs/AceLibrary/AceLibrary.lua b/Payload/Interface/Addons/SuperAPI/libs/AceLibrary/AceLibrary.lua new file mode 100644 index 0000000..0f2b237 --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/AceLibrary/AceLibrary.lua @@ -0,0 +1,757 @@ +--[[ +Name: AceLibrary +Revision: $Rev: 17722 $ +Developed by: The Ace Development Team (http://www.wowace.com/index.php/The_Ace_Development_Team) +Inspired By: Iriel (iriel@vigilance-committee.org) + Tekkub (tekkub@gmail.com) + Revision: $Rev: 17722 $ +Website: http://www.wowace.com/ +Documentation: http://www.wowace.com/index.php/AceLibrary +SVN: http://svn.wowace.com/root/trunk/Ace2/AceLibrary +Description: Versioning library to handle other library instances, upgrading, + and proper access. + It also provides a base for libraries to work off of, providing + proper error tools. It is handy because all the errors occur in the + file that called it, not in the library file itself. +Dependencies: None +]] + +local ACELIBRARY_MAJOR = "AceLibrary" +local ACELIBRARY_MINOR = "$Revision: 17722 $" + +if loadstring("return function(...) return ... end") and AceLibrary and AceLibrary:HasInstance(ACELIBRARY_MAJOR) then return end -- lua51 check +local table_setn +do + local version = GetBuildInfo() + if string.find(version, "^2%.") then + -- 2.0.0 + table_setn = function() end + else + table_setn = table.setn + end +end + +local string_gfind = string.gmatch or string.gfind + +local _G = getfenv(0) +local previous = _G[ACELIBRARY_MAJOR] +if previous and not previous:IsNewVersion(ACELIBRARY_MAJOR, ACELIBRARY_MINOR) then return end + +local function safecall(func,a1,a2,a3,a4,a5,a6,a7,a8,a9,a10) + local success, err = pcall(func,a1,a2,a3,a4,a5,a6,a7,a8,a9,a10) + if not success then geterrorhandler()(err) end +end + +-- @table AceLibrary +-- @brief System to handle all versioning of libraries. +local AceLibrary = {} +local AceLibrary_mt = {} +setmetatable(AceLibrary, AceLibrary_mt) + +local tmp +local function error(self, message, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if type(self) ~= "table" then + _G.error(string.format("Bad argument #1 to `error' (table expected, got %s)", type(self)), 2) + end + if not tmp then + tmp = {} + else + for k in pairs(tmp) do tmp[k] = nil end + table_setn(tmp, 0) + end + + table.insert(tmp, a1) + table.insert(tmp, a2) + table.insert(tmp, a3) + table.insert(tmp, a4) + table.insert(tmp, a5) + table.insert(tmp, a6) + table.insert(tmp, a7) + table.insert(tmp, a8) + table.insert(tmp, a9) + table.insert(tmp, a10) + table.insert(tmp, a11) + table.insert(tmp, a12) + table.insert(tmp, a13) + table.insert(tmp, a14) + table.insert(tmp, a15) + table.insert(tmp, a16) + table.insert(tmp, a17) + table.insert(tmp, a18) + table.insert(tmp, a19) + table.insert(tmp, a20) + + local stack = debugstack() + if not message then + local _,_,second = string.find(stack, "\n(.-)\n") + message = "error raised! " .. second + else + for i = 1,table.getn(tmp) do + tmp[i] = tostring(tmp[i]) + end + for i = 1,10 do + table.insert(tmp, "nil") + end + message = string.format(message, unpack(tmp)) + end + + if getmetatable(self) and getmetatable(self).__tostring then + message = string.format("%s: %s", tostring(self), message) + elseif type(rawget(self, 'GetLibraryVersion')) == "function" and AceLibrary:HasInstance(self:GetLibraryVersion()) then + message = string.format("%s: %s", self:GetLibraryVersion(), message) + elseif type(rawget(self, 'class')) == "table" and type(rawget(self.class, 'GetLibraryVersion')) == "function" and AceLibrary:HasInstance(self.class:GetLibraryVersion()) then + message = string.format("%s: %s", self.class:GetLibraryVersion(), message) + end + + local first = string.gsub(stack, "\n.*", "") + local file = string.gsub(first, ".*\\(.*).lua:%d+: .*", "%1") + file = string.gsub(file, "([%(%)%.%*%+%-%[%]%?%^%$%%])", "%%%1") + + local i = 0 + for s in string_gfind(stack, "\n([^\n]*)") do + i = i + 1 + if not string.find(s, file .. "%.lua:%d+:") then + file = string.gsub(s, "^.*\\(.*).lua:%d+: .*", "%1") + file = string.gsub(file, "([%(%)%.%*%+%-%[%]%?%^%$%%])", "%%%1") + break + end + end + local j = 0 + for s in string_gfind(stack, "\n([^\n]*)") do + j = j + 1 + if j > i and not string.find(s, file .. "%.lua:%d+:") then + _G.error(message, j + 1) + return + end + end + _G.error(message, 2) + return +end + +local function assert(self, condition, message, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if not condition then + if not message then + local stack = debugstack() + local _,_,second = string.find(stack, "\n(.-)\n") + message = "assertion failed! " .. second + end + error(self, message, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + return + end + return condition +end + +local function argCheck(self, arg, num, kind, kind2, kind3, kind4, kind5) + if type(num) ~= "number" then + error(self, "Bad argument #3 to `argCheck' (number expected, got %s)", type(num)) + elseif type(kind) ~= "string" then + error(self, "Bad argument #4 to `argCheck' (string expected, got %s)", type(kind)) + end + local errored = false + arg = type(arg) + if arg ~= kind and arg ~= kind2 and arg ~= kind3 and arg ~= kind4 and arg ~= kind5 then + local _,_,func = string.find(debugstack(), "`argCheck'.-([`<].-['>])") + if not func then + _,_,func = string.find(debugstack(), "([`<].-['>])") + end + if kind5 then + error(self, "Bad argument #%s to %s (%s, %s, %s, %s, or %s expected, got %s)", tonumber(num) or 0/0, func, kind, kind2, kind3, kind4, kind5, arg) + elseif kind4 then + error(self, "Bad argument #%s to %s (%s, %s, %s, or %s expected, got %s)", tonumber(num) or 0/0, func, kind, kind2, kind3, kind4, arg) + elseif kind3 then + error(self, "Bad argument #%s to %s (%s, %s, or %s expected, got %s)", tonumber(num) or 0/0, func, kind, kind2, kind3, arg) + elseif kind2 then + error(self, "Bad argument #%s to %s (%s or %s expected, got %s)", tonumber(num) or 0/0, func, kind, kind2, arg) + else + error(self, "Bad argument #%s to %s (%s expected, got %s)", tonumber(num) or 0/0, func, kind, arg) + end + end +end + +local function pcall(self, func, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20 = _G.pcall(func, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if not a1 then + error(self, string.gsub(a2, ".-%.lua:%d-: ", "")) + else + return a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20 + end +end + +local recurse = {} +local function addToPositions(t, major) + if not AceLibrary.positions[t] or AceLibrary.positions[t] == major then + rawset(t, recurse, true) + AceLibrary.positions[t] = major + for k,v in pairs(t) do + if type(v) == "table" and not rawget(v, recurse) then + addToPositions(v, major) + end + if type(k) == "table" and not rawget(k, recurse) then + addToPositions(k, major) + end + end + local mt = getmetatable(t) + if mt and not rawget(mt, recurse) then + addToPositions(mt, major) + end + rawset(t, recurse, nil) + end +end + +local function svnRevisionToNumber(text) + if type(text) == "string" then + if string.find(text, "^%$Revision: (%d+) %$$") then + return tonumber((string.gsub(text, "^%$Revision: (%d+) %$$", "%1"))) + elseif string.find(text, "^%$Rev: (%d+) %$$") then + return tonumber((string.gsub(text, "^%$Rev: (%d+) %$$", "%1"))) + elseif string.find(text, "^%$LastChangedRevision: (%d+) %$$") then + return tonumber((string.gsub(text, "^%$LastChangedRevision: (%d+) %$$", "%1"))) + end + elseif type(text) == "number" then + return text + end + return nil +end + +local crawlReplace +do + local recurse = {} + local function func(t, to, from) + if recurse[t] then + return + end + recurse[t] = true + local mt = getmetatable(t) + setmetatable(t, nil) + rawset(t, to, rawget(t, from)) + rawset(t, from, nil) + for k,v in pairs(t) do + if v == from then + t[k] = to + elseif type(v) == "table" then + if not recurse[v] then + func(v, to, from) + end + end + + if type(k) == "table" then + if not recurse[k] then + func(k, to, from) + end + end + end + setmetatable(t, mt) + if mt then + if mt == from then + setmetatable(t, to) + elseif not recurse[mt] then + func(mt, to, from) + end + end + end + function crawlReplace(t, to, from) + func(t, to, from) + for k in pairs(recurse) do + recurse[k] = nil + end + end +end + +-- @function destroyTable +-- @brief remove all the contents of a table +-- @param t table to destroy +local function destroyTable(t) + setmetatable(t, nil) + for k,v in pairs(t) do t[k] = nil end + table_setn(t, 0) +end + +local function isFrame(frame) + return type(frame) == "table" and type(rawget(frame, 0)) == "userdata" and type(rawget(frame, 'IsFrameType')) == "function" and getmetatable(frame) and type(rawget(getmetatable(frame), '__index')) == "function" +end + +local new, del +do + local tables = setmetatable({}, {__mode = "k"}) + + function new() + local t = next(tables) + if t then + tables[t] = nil + return t + else + return {} + end + end + + function del(t, depth) + if depth and depth > 0 then + for k,v in pairs(t) do + if type(v) == "table" and not isFrame(v) then + del(v, depth - 1) + end + end + end + destroyTable(t) + tables[t] = true + end +end + +-- @function copyTable +-- @brief Create a shallow copy of a table and return it. +-- @param from The table to copy from +-- @return A shallow copy of the table +local function copyTable(from) + local to = new() + for k,v in pairs(from) do to[k] = v end + table_setn(to, table.getn(from)) + setmetatable(to, getmetatable(from)) + return to +end + +-- @function deepTransfer +-- @brief Fully transfer all data, keeping proper previous table +-- backreferences stable. +-- @param to The table with which data is to be injected into +-- @param from The table whose data will be injected into the first +-- @param saveFields If available, a shallow copy of the basic data is saved +-- in here. +-- @param list The account of table references +-- @param list2 The current status on which tables have been traversed. +local deepTransfer +do + -- @function examine + -- @brief Take account of all the table references to be shared + -- between the to and from tables. + -- @param to The table with which data is to be injected into + -- @param from The table whose data will be injected into the first + -- @param list An account of the table references + local function examine(to, from, list, major) + list[from] = to + for k,v in pairs(from) do + if rawget(to, k) and type(from[k]) == "table" and type(to[k]) == "table" and not list[from[k]] then + if from[k] == to[k] then + list[from[k]] = to[k] + elseif AceLibrary.positions[from[v]] ~= major and AceLibrary.positions[from[v]] then + list[from[k]] = from[k] + elseif not list[from[k]] then + examine(to[k], from[k], list, major) + end + end + end + return list + end + + function deepTransfer(to, from, saveFields, major, list, list2) + setmetatable(to, nil) + local createdList + if not list then + createdList = true + list = new() + list2 = new() + examine(to, from, list, major) + end + list2[to] = to + for k,v in pairs(to) do + if type(rawget(from, k)) ~= "table" or type(v) ~= "table" or isFrame(v) then + if saveFields then + saveFields[k] = v + end + to[k] = nil + elseif v ~= _G then + if saveFields then + saveFields[k] = copyTable(v) + end + end + end + for k in pairs(from) do + if rawget(to, k) and to[k] ~= from[k] and AceLibrary.positions[to[k]] == major and from[k] ~= _G then + if not list2[to[k]] then + deepTransfer(to[k], from[k], nil, major, list, list2) + end + to[k] = list[to[k]] or list2[to[k]] + else + rawset(to, k, from[k]) + end + end + table_setn(to, table.getn(from)) + setmetatable(to, getmetatable(from)) + local mt = getmetatable(to) + if mt then + if list[mt] then + setmetatable(to, list[mt]) + elseif mt.__index and list[mt.__index] then + mt.__index = list[mt.__index] + end + end + destroyTable(from) + if createdList then + del(list) + del(list2) + end + end +end + +-- @method TryToLoadStandalone +-- @brief Attempt to find and load a standalone version of the requested library +-- @param major A string representing the major version +-- @return If library is found, return values from the call to LoadAddOn are returned +-- If the library has been requested previously, nil is returned. +local function TryToLoadStandalone(major) + if not AceLibrary.scannedlibs then AceLibrary.scannedlibs = {} end + if AceLibrary.scannedlibs[major] then return end + + AceLibrary.scannedlibs[major] = true + + local name, _, _, enabled, loadable = GetAddOnInfo(major) + if loadable then + return LoadAddOn(name) + end + + for i=1,GetNumAddOns() do + if GetAddOnMetadata(i, "X-AceLibrary-"..major) then + local name, _, _, enabled, loadable = GetAddOnInfo(i) + if loadable then + return LoadAddOn(name) + end + end + end +end + +-- @method IsNewVersion +-- @brief Obtain whether the supplied version would be an upgrade to the +-- current version. This allows for bypass code in library +-- declaration. +-- @param major A string representing the major version +-- @param minor An integer or an svn revision string representing the minor version +-- @return whether the supplied version would be newer than what is +-- currently available. +function AceLibrary:IsNewVersion(major, minor) + argCheck(self, major, 2, "string") + TryToLoadStandalone(major) + + if type(minor) == "string" then + local m = svnRevisionToNumber(minor) + if m then + minor = m + else + _G.error(string.format("Bad argument #3 to `IsNewVersion'. Must be a number or SVN revision string. %q is not appropriate", minor), 2) + end + end + argCheck(self, minor, 3, "number") + local data = self.libs[major] + if not data then + return true + end + return data.minor < minor +end + +-- @method HasInstance +-- @brief Returns whether an instance exists. This allows for optional support of a library. +-- @param major A string representing the major version. +-- @param minor (optional) An integer or an svn revision string representing the minor version. +-- @return Whether an instance exists. +function AceLibrary:HasInstance(major, minor) + argCheck(self, major, 2, "string") + TryToLoadStandalone(major) + + if minor then + if type(minor) == "string" then + local m = svnRevisionToNumber(minor) + if m then + minor = m + else + _G.error(string.format("Bad argument #3 to `HasInstance'. Must be a number or SVN revision string. %q is not appropriate", minor), 2) + end + end + argCheck(self, minor, 3, "number") + if not self.libs[major] then + return + end + return self.libs[major].minor == minor + end + return self.libs[major] and true +end + +-- @method GetInstance +-- @brief Returns the library with the given major/minor version. +-- @param major A string representing the major version. +-- @param minor (optional) An integer or an svn revision string representing the minor version. +-- @return The library with the given major/minor version. +function AceLibrary:GetInstance(major, minor) + argCheck(self, major, 2, "string") + TryToLoadStandalone(major) + + local data = self.libs[major] + if not data then + _G.error(string.format("Cannot find a library instance of %s.", major), 2) + return + end + if minor then + if type(minor) == "string" then + local m = svnRevisionToNumber(minor) + if m then + minor = m + else + _G.error(string.format("Bad argument #3 to `GetInstance'. Must be a number or SVN revision string. %q is not appropriate", minor), 2) + end + end + argCheck(self, minor, 2, "number") + if data.minor ~= minor then + _G.error(string.format("Cannot find a library instance of %s, minor version %d.", major, minor), 2) + return + end + end + return data.instance +end + +-- Syntax sugar. AceLibrary("FooBar-1.0") +AceLibrary_mt.__call = AceLibrary.GetInstance + +local donothing + +local AceEvent + +-- @method Register +-- @brief Registers a new version of a given library. +-- @param newInstance the library to register +-- @param major the major version of the library +-- @param minor the minor version of the library +-- @param activateFunc (optional) A function to be called when the library is +-- fully activated. Takes the arguments +-- (newInstance [, oldInstance, oldDeactivateFunc]). If +-- oldInstance is given, you should probably call +-- oldDeactivateFunc(oldInstance). +-- @param deactivateFunc (optional) A function to be called by a newer library's +-- activateFunc. +-- @param externalFunc (optional) A function to be called whenever a new +-- library is registered. +function AceLibrary:Register(newInstance, major, minor, activateFunc, deactivateFunc, externalFunc) + argCheck(self, newInstance, 2, "table") + argCheck(self, major, 3, "string") + if type(minor) == "string" then + local m = svnRevisionToNumber(minor) + if m then + minor = m + else + _G.error(string.format("Bad argument #4 to `Register'. Must be a number or SVN revision string. %q is not appropriate", minor), 2) + end + end + argCheck(self, minor, 4, "number") + if math.floor(minor) ~= minor or minor < 0 then + error(self, "Bad argument #4 to `Register' (integer >= 0 expected, got %s)", minor) + end + argCheck(self, activateFunc, 5, "function", "nil") + argCheck(self, deactivateFunc, 6, "function", "nil") + argCheck(self, externalFunc, 7, "function", "nil") + if not deactivateFunc then + if not donothing then + donothing = function() end + end + deactivateFunc = donothing + end + local data = self.libs[major] + if not data then + -- This is new + local instance = copyTable(newInstance) + crawlReplace(instance, instance, newInstance) + destroyTable(newInstance) + if AceLibrary == newInstance then + self = instance + AceLibrary = instance + end + self.libs[major] = { + instance = instance, + minor = minor, + deactivateFunc = deactivateFunc, + externalFunc = externalFunc, + } + rawset(instance, 'GetLibraryVersion', function(self) + return major, minor + end) + if not rawget(instance, 'error') then + rawset(instance, 'error', error) + end + if not rawget(instance, 'assert') then + rawset(instance, 'assert', assert) + end + if not rawget(instance, 'argCheck') then + rawset(instance, 'argCheck', argCheck) + end + if not rawget(instance, 'pcall') then + rawset(instance, 'pcall', pcall) + end + addToPositions(instance, major) + if activateFunc then + safecall(activateFunc, instance, nil, nil) -- no old version, so explicit nil + end + + if externalFunc then + for k,data in pairs(self.libs) do + if k ~= major then + safecall(externalFunc, instance, k, data.instance) + end + end + end + + for k,data in pairs(self.libs) do + if k ~= major and data.externalFunc then + safecall(data.externalFunc, data.instance, major, instance) + end + end + if major == "AceEvent-2.0" then + AceEvent = instance + end + if AceEvent then + AceEvent.TriggerEvent(self, "AceLibrary_Register", major, instance) + end + + return instance + end + local instance = data.instance + if minor <= data.minor then + -- This one is already obsolete, raise an error. + _G.error(string.format("Obsolete library registered. %s is already registered at version %d. You are trying to register version %d. Hint: if not AceLibrary:IsNewVersion(%q, %d) then return end", major, data.minor, minor, major, minor), 2) + return + end + -- This is an update + local oldInstance = new() + + addToPositions(newInstance, major) + local isAceLibrary = (AceLibrary == newInstance) + local old_error, old_assert, old_argCheck, old_pcall + if isAceLibrary then + self = instance + AceLibrary = instance + + old_error = instance.error + old_assert = instance.assert + old_argCheck = instance.argCheck + old_pcall = instance.pcall + + self.error = error + self.assert = assert + self.argCheck = argCheck + self.pcall = pcall + end + deepTransfer(instance, newInstance, oldInstance, major) + crawlReplace(instance, instance, newInstance) + local oldDeactivateFunc = data.deactivateFunc + data.minor = minor + data.deactivateFunc = deactivateFunc + data.externalFunc = externalFunc + rawset(instance, 'GetLibraryVersion', function(self) + return major, minor + end) + if not rawget(instance, 'error') then + rawset(instance, 'error', error) + end + if not rawget(instance, 'assert') then + rawset(instance, 'assert', assert) + end + if not rawget(instance, 'argCheck') then + rawset(instance, 'argCheck', argCheck) + end + if not rawget(instance, 'pcall') then + rawset(instance, 'pcall', pcall) + end + if isAceLibrary then + for _,v in pairs(self.libs) do + local i = type(v) == "table" and v.instance + if type(i) == "table" then + if not rawget(i, 'error') or i.error == old_error then + rawset(i, 'error', error) + end + if not rawget(i, 'assert') or i.assert == old_assert then + rawset(i, 'assert', assert) + end + if not rawget(i, 'argCheck') or i.argCheck == old_argCheck then + rawset(i, 'argCheck', argCheck) + end + if not rawget(i, 'pcall') or i.pcall == old_pcall then + rawset(i, 'pcall', pcall) + end + end + end + end + if activateFunc then + safecall(activateFunc, instance, oldInstance, oldDeactivateFunc) + else + safecall(oldDeactivateFunc, oldInstance) + end + del(oldInstance) + + if externalFunc then + for k,data in pairs(self.libs) do + if k ~= major then + safecall(externalFunc, instance, k, data.instance) + end + end + end + + return instance +end + +local iter +function AceLibrary:IterateLibraries() + if not iter then + local function iter(t, k) + k = next(t, k) + if not k then + return nil + else + return k, t[k].instance + end + end + end + return iter, self.libs, nil +end + +-- @function Activate +-- @brief The activateFunc for AceLibrary itself. Called when +-- AceLibrary properly registers. +-- @param self Reference to AceLibrary +-- @param oldLib (optional) Reference to an old version of AceLibrary +-- @param oldDeactivate (optional) Function to deactivate the old lib +local function activate(self, oldLib, oldDeactivate) + if not self.libs then + if oldLib then + self.libs = oldLib.libs + self.scannedlibs = oldLib.scannedlibs + end + if not self.libs then + self.libs = {} + end + if not self.scannedlibs then + self.scannedlibs = {} + end + end + if not self.positions then + if oldLib then + self.positions = oldLib.positions + end + if not self.positions then + self.positions = setmetatable({}, { __mode = "k" }) + end + end + + -- Expose the library in the global environment + _G[ACELIBRARY_MAJOR] = self + + if oldDeactivate then + oldDeactivate(oldLib) + end +end + +if not previous then + previous = AceLibrary +end +if not previous.libs then + previous.libs = {} +end +AceLibrary.libs = previous.libs +if not previous.positions then + previous.positions = setmetatable({}, { __mode = "k" }) +end +AceLibrary.positions = previous.positions +AceLibrary:Register(AceLibrary, ACELIBRARY_MAJOR, ACELIBRARY_MINOR, activate) diff --git a/Payload/Interface/Addons/SuperAPI/libs/AceLocale-2.2/AceLocale-2.2.lua b/Payload/Interface/Addons/SuperAPI/libs/AceLocale-2.2/AceLocale-2.2.lua new file mode 100644 index 0000000..fbf9c87 --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/AceLocale-2.2/AceLocale-2.2.lua @@ -0,0 +1,538 @@ +--[[ +Name: AceLocale-2.2 +Revision: $Rev: 17638 $ +Developed by: The Ace Development Team (http://www.wowace.com/index.php/The_Ace_Development_Team) +Inspired By: Ace 1.x by Turan (turan@gryphon.com) +Website: http://www.wowace.com/ +Documentation: http://www.wowace.com/index.php/AceLocale-2.2 +SVN: http://svn.wowace.com/root/trunk/Ace2/AceLocale-2.2 +Description: Localization library for addons to use to handle proper + localization and internationalization. +Dependencies: AceLibrary +]] + +local MAJOR_VERSION = "AceLocale-2.2" +local MINOR_VERSION = "$Revision: 17639 $" + +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary.") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +if loadstring("return function(...) return ... end") and AceLibrary:HasInstance(MAJOR_VERSION) then return end -- lua51 check +local AceLocale = {} + +local DEFAULT_LOCALE = "enUS" +local _G = getfenv(0) + +local BASE_TRANSLATIONS, DEBUGGING, TRANSLATIONS, BASE_LOCALE, TRANSLATION_TABLES, REVERSE_TRANSLATIONS, STRICTNESS, DYNAMIC_LOCALES, CURRENT_LOCALE, NAME + +local rawget = rawget +local rawset = rawset +local type = type + +local newRegistries = {} +local scheduleClear + +local lastSelf +local __index = function(self, key) + lastSelf = self + local value = (rawget(self, TRANSLATIONS) or AceLocale.prototype)[key] + rawset(self, key, value) + return value +end + +local __newindex = function(self, k, v) + if type(v) ~= "function" and type(k) ~= "table" then + AceLocale.error(self, "Cannot change the values of an AceLocale instance.") + end + rawset(self, k, v) +end + +local __tostring = function(self) + if type(rawget(self, 'GetLibraryVersion')) == "function" then + return self:GetLibraryVersion() + else + return "AceLocale(" .. self[NAME] .. ")" + end +end + +local function clearCache(self) + if not rawget(self, BASE_TRANSLATIONS) then + return + end + + local cache = self[BASE_TRANSLATIONS] + rawset(self, REVERSE_TRANSLATIONS, nil) + + for k in pairs(self) do + if rawget(cache, k) ~= nil then + self[k] = nil + end + end + rawset(self, 'tmp', true) + self.tmp = nil +end + +local function refixInstance(instance) + if getmetatable(instance) then + setmetatable(instance, nil) + end + local translations = instance[TRANSLATIONS] + if translations then + if getmetatable(translations) then + setmetatable(translations, nil) + end + local baseTranslations = instance[BASE_TRANSLATIONS] + if getmetatable(baseTranslations) then + setmetatable(baseTranslations, nil) + end + if translations == baseTranslations or instance[STRICTNESS] then + setmetatable(instance, { + __index = __index, + __newindex = __newindex, + __tostring = __tostring + }) + + setmetatable(translations, { + __index = AceLocale.prototype + }) + else + setmetatable(instance, { + __index = __index, + __newindex = __newindex, + __tostring = __tostring + }) + + setmetatable(translations, { + __index = baseTranslations, + }) + + setmetatable(baseTranslations, { + __index = AceLocale.prototype, + }) + end + else + setmetatable(instance, { + __index = __index, + __newindex = __newindex, + __tostring = __tostring, + }) + end + clearCache(instance) + newRegistries[instance] = true + scheduleClear() + return instance +end + +function AceLocale:new(name) + self:argCheck(name, 2, "string") + + if self.registry[name] and type(rawget(self.registry[name], 'GetLibraryVersion')) ~= "function" then + return self.registry[name] + end + + AceLocale.registry[name] = refixInstance({ + [STRICTNESS] = false, + [NAME] = name, + }) + newRegistries[AceLocale.registry[name]] = true + return AceLocale.registry[name] +end + +AceLocale.prototype = { class = AceLocale } + +function AceLocale.prototype:EnableDebugging() + if rawget(self, BASE_TRANSLATIONS) then + AceLocale.error(self, "Cannot enable debugging after a translation has been registered.") + end + rawset(self, DEBUGGING, true) +end + +function AceLocale.prototype:EnableDynamicLocales(override) + AceLocale.argCheck(self, override, 2, "boolean", "nil") + if not override and rawget(self, BASE_TRANSLATIONS) then + AceLocale.error(self, "Cannot enable dynamic locales after a translation has been registered.") + end + if not rawget(self, DYNAMIC_LOCALES) then + rawset(self, DYNAMIC_LOCALES, true) + if rawget(self, BASE_LOCALE) then + if not rawget(self, TRANSLATION_TABLES) then + rawset(self, TRANSLATION_TABLES, {}) + end + self[TRANSLATION_TABLES][self[BASE_LOCALE]] = self[BASE_TRANSLATIONS] + self[TRANSLATION_TABLES][self[CURRENT_LOCALE]] = self[TRANSLATIONS] + end + end +end + +function AceLocale.prototype:RegisterTranslations(locale, func) + AceLocale.argCheck(self, locale, 2, "string") + AceLocale.argCheck(self, func, 3, "function") + + if locale == rawget(self, BASE_LOCALE) then + AceLocale.error(self, "Cannot provide the same locale more than once. %q provided twice.", locale) + end + + if rawget(self, BASE_TRANSLATIONS) and GetLocale() ~= locale then + if rawget(self, DEBUGGING) or rawget(self, DYNAMIC_LOCALES) then + if not rawget(self, TRANSLATION_TABLES) then + rawset(self, TRANSLATION_TABLES, {}) + end + if self[TRANSLATION_TABLES][locale] then + AceLocale.error(self, "Cannot provide the same locale more than once. %q provided twice.", locale) + end + local t = func() + func = nil + if type(t) ~= "table" then + AceLocale.error(self, "Bad argument #3 to `RegisterTranslations'. function did not return a table. (expected table, got %s)", type(t)) + end + self[TRANSLATION_TABLES][locale] = t + t = nil + end + func = nil + return + end + local t = func() + func = nil + if type(t) ~= "table" then + AceLocale.error(self, "Bad argument #3 to `RegisterTranslations'. function did not return a table. (expected table, got %s)", type(t)) + end + + rawset(self, TRANSLATIONS, t) + if not rawget(self, BASE_TRANSLATIONS) then + rawset(self, BASE_TRANSLATIONS, t) + rawset(self, BASE_LOCALE, locale) + for key,value in pairs(t) do + if value == true then + t[key] = key + end + end + else + for key, value in pairs(self[TRANSLATIONS]) do + if not rawget(self[BASE_TRANSLATIONS], key) then + AceLocale.error(self, "Improper translation exists. %q is likely misspelled for locale %s.", key, locale) + end + if value == true then + AceLocale.error(self, "Can only accept true as a value on the base locale. %q is the base locale, %q is not.", rawget(self, BASE_LOCALE), locale) + end + end + end + rawset(self, CURRENT_LOCALE, locale) + refixInstance(self) + if rawget(self, DEBUGGING) or rawget(self, DYNAMIC_LOCALES) then + if not rawget(self, TRANSLATION_TABLES) then + rawset(self, TRANSLATION_TABLES, {}) + end + self[TRANSLATION_TABLES][locale] = t + end + t = nil +end + +function AceLocale.prototype:SetLocale(locale) + AceLocale.argCheck(self, locale, 2, "string", "boolean") + if not rawget(self, DYNAMIC_LOCALES) then + AceLocale.error(self, "Cannot call `SetLocale' without first calling `EnableDynamicLocales'.") + end + if not rawget(self, TRANSLATION_TABLES) then + AceLocale.error(self, "Cannot call `SetLocale' without first calling `RegisterTranslations'.") + end + if locale == true then + locale = GetLocale() + if not self[TRANSLATION_TABLES][locale] then + locale = self[BASE_LOCALE] + end + end + + if self[CURRENT_LOCALE] == locale then + return + end + + if not self[TRANSLATION_TABLES][locale] then + AceLocale.error(self, "Locale %q not registered.", locale) + end + + self[TRANSLATIONS] = self[TRANSLATION_TABLES][locale] + self[CURRENT_LOCALE] = locale + refixInstance(self) +end + +function AceLocale.prototype:GetLocale() + if not rawget(self, TRANSLATION_TABLES) then + AceLocale.error(self, "Cannot call `GetLocale' without first calling `RegisterTranslations'.") + end + return self[CURRENT_LOCALE] +end + +local function iter(t, position) + return (next(t, position)) +end + +function AceLocale.prototype:IterateAvailableLocales() + if not rawget(self, DYNAMIC_LOCALES) then + AceLocale.error(self, "Cannot call `IterateAvailableLocales' without first calling `EnableDynamicLocales'.") + end + if not rawget(self, TRANSLATION_TABLES) then + AceLocale.error(self, "Cannot call `IterateAvailableLocales' without first calling `RegisterTranslations'.") + end + return iter, self[TRANSLATION_TABLES], nil +end + +function AceLocale.prototype:HasLocale(locale) + if not rawget(self, DYNAMIC_LOCALES) then + AceLocale.error(self, "Cannot call `HasLocale' without first calling `EnableDynamicLocales'.") + end + AceLocale.argCheck(self, locale, 2, "string") + return rawget(self, TRANSLATION_TABLES) and self[TRANSLATION_TABLES][locale] ~= nil +end + +function AceLocale.prototype:SetStrictness(strict) + AceLocale.argCheck(self, strict, 2, "boolean") + local mt = getmetatable(self) + if not mt then + AceLocale.error(self, "Cannot call `SetStrictness' without a metatable.") + end + if not rawget(self, TRANSLATIONS) then + AceLocale.error(self, "No translations registered.") + end + rawset(self, STRICTNESS, strict) + refixInstance(self) +end + +local function initReverse(self) + rawset(self, REVERSE_TRANSLATIONS, {}) + local alpha = self[TRANSLATIONS] + local bravo = self[REVERSE_TRANSLATIONS] + for base, localized in pairs(alpha) do + bravo[localized] = base + end +end + +function AceLocale.prototype:GetTranslation(text) + AceLocale.argCheck(self, text, 1, "string", "number") + if not rawget(self, TRANSLATIONS) then + AceLocale.error(self, "No translations registered") + end + return self[text] +end + +function AceLocale.prototype:GetStrictTranslation(text) + AceLocale.argCheck(self, text, 1, "string", "number") + local x = rawget(self, TRANSLATIONS) + if not x then + AceLocale.error(self, "No translations registered") + end + local value = rawget(x, text) + if value == nil then + AceLocale.error(self, "Translation %q does not exist for locale %s", text, self[CURRENT_LOCALE]) + end + return value +end + +function AceLocale.prototype:GetReverseTranslation(text) + local x = rawget(self, REVERSE_TRANSLATIONS) + if not x then + if not rawget(self, TRANSLATIONS) then + AceLocale.error(self, "No translations registered") + end + initReverse(self) + x = self[REVERSE_TRANSLATIONS] + end + local translation = x[text] + if not translation then + AceLocale.error(self, "Reverse translation for %q does not exist", text) + end + return translation +end + +function AceLocale.prototype:GetIterator() + local x = rawget(self, TRANSLATIONS) + if not x then + AceLocale.error(self, "No translations registered") + end + return next, x, nil +end + +function AceLocale.prototype:GetReverseIterator() + local x = rawget(self, REVERSE_TRANSLATIONS) + if not x then + if not rawget(self, TRANSLATIONS) then + AceLocale.error(self, "No translations registered") + end + initReverse(self) + x = self[REVERSE_TRANSLATIONS] + end + return next, x, nil +end + +function AceLocale.prototype:HasTranslation(text) + AceLocale.argCheck(self, text, 1, "string", "number") + local x = rawget(self, TRANSLATIONS) + if not x then + AceLocale.error(self, "No translations registered") + end + return rawget(x, text) and true +end + +function AceLocale.prototype:HasReverseTranslation(text) + local x = rawget(self, REVERSE_TRANSLATIONS) + if not x then + if not rawget(self, TRANSLATIONS) then + AceLocale.error(self, "No translations registered") + end + initReverse(self) + x = self[REVERSE_TRANSLATIONS] + end + return x[text] and true +end + +function AceLocale.prototype:Debug() + if not rawget(self, DEBUGGING) then + return + end + local words = {} + local locales = {"enUS", "ruRU", "deDE", "frFR", "koKR", "zhCN", "zhTW", "esES"} + local localizations = {} + DEFAULT_CHAT_FRAME:AddMessage("--- AceLocale Debug ---") + for _,locale in ipairs(locales) do + if not self[TRANSLATION_TABLES][locale] then + DEFAULT_CHAT_FRAME:AddMessage(string.format("Locale %q not found", locale)) + else + localizations[locale] = self[TRANSLATION_TABLES][locale] + end + end + local localeDebug = {} + for locale, localization in pairs(localizations) do + localeDebug[locale] = {} + for word in pairs(localization) do + if type(localization[word]) == "table" then + if type(words[word]) ~= "table" then + words[word] = {} + end + for bit in pairs(localization[word]) do + if type(localization[word][bit]) == "string" then + words[word][bit] = true + end + end + elseif type(localization[word]) == "string" then + words[word] = true + end + end + end + for word in pairs(words) do + if type(words[word]) == "table" then + for bit in pairs(words[word]) do + for locale, localization in pairs(localizations) do + if not rawget(localization, word) or not localization[word][bit] then + localeDebug[locale][word .. "::" .. bit] = true + end + end + end + else + for locale, localization in pairs(localizations) do + if not rawget(localization, word) then + localeDebug[locale][word] = true + end + end + end + end + for locale, t in pairs(localeDebug) do + if not next(t) then + DEFAULT_CHAT_FRAME:AddMessage(string.format("Locale %q complete", locale)) + else + DEFAULT_CHAT_FRAME:AddMessage(string.format("Locale %q missing:", locale)) + for word in pairs(t) do + DEFAULT_CHAT_FRAME:AddMessage(string.format(" %q", word)) + end + end + end + DEFAULT_CHAT_FRAME:AddMessage("--- End AceLocale Debug ---") +end + +setmetatable(AceLocale.prototype, { + __index = function(self, k) + if type(k) ~= "table" and k ~= 0 and k ~= "GetLibraryVersion" and k ~= "error" and k ~= "assert" and k ~= "argCheck" and k ~= "pcall" then -- HACK: remove "GetLibraryVersion" and such later. + AceLocale.error(lastSelf or self, "Translation %q does not exist.", k) + end + return nil + end +}) + +local function activate(self, oldLib, oldDeactivate) + AceLocale = self + + self.frame = oldLib and oldLib.frame or CreateFrame("Frame") + self.registry = oldLib and oldLib.registry or {} + self.BASE_TRANSLATIONS = oldLib and oldLib.BASE_TRANSLATIONS or {} + self.DEBUGGING = oldLib and oldLib.DEBUGGING or {} + self.TRANSLATIONS = oldLib and oldLib.TRANSLATIONS or {} + self.BASE_LOCALE = oldLib and oldLib.BASE_LOCALE or {} + self.TRANSLATION_TABLES = oldLib and oldLib.TRANSLATION_TABLES or {} + self.REVERSE_TRANSLATIONS = oldLib and oldLib.REVERSE_TRANSLATIONS or {} + self.STRICTNESS = oldLib and oldLib.STRICTNESS or {} + self.NAME = oldLib and oldLib.NAME or {} + self.DYNAMIC_LOCALES = oldLib and oldLib.DYNAMIC_LOCALES or {} + self.CURRENT_LOCALE = oldLib and oldLib.CURRENT_LOCALE or {} + + BASE_TRANSLATIONS = self.BASE_TRANSLATIONS + DEBUGGING = self.DEBUGGING + TRANSLATIONS = self.TRANSLATIONS + BASE_LOCALE = self.BASE_LOCALE + TRANSLATION_TABLES = self.TRANSLATION_TABLES + REVERSE_TRANSLATIONS = self.REVERSE_TRANSLATIONS + STRICTNESS = self.STRICTNESS + NAME = self.NAME + DYNAMIC_LOCALES = self.DYNAMIC_LOCALES + CURRENT_LOCALE = self.CURRENT_LOCALE + + + local GetTime = GetTime + local timeUntilClear = GetTime() + 5 + scheduleClear = function() + if next(newRegistries) then + self.frame:Show() + timeUntilClear = GetTime() + 5 + end + end + + if not self.registry then + self.registry = {} + else + for name, instance in pairs(self.registry) do + local name = name + local mt = getmetatable(instance) + setmetatable(instance, nil) + instance[NAME] = name + local strict + if instance[STRICTNESS] ~= nil then + strict = instance[STRICTNESS] + elseif instance[TRANSLATIONS] ~= instance[BASE_TRANSLATIONS] then + if getmetatable(instance[TRANSLATIONS]).__index == oldLib.prototype then + strict = true + end + end + instance[STRICTNESS] = strict and true or false + refixInstance(instance) + end + end + + self.frame:SetScript("OnEvent", scheduleClear) + self.frame:SetScript("OnUpdate", function() -- (this, elapsed) + if timeUntilClear - GetTime() <= 0 then + self.frame:Hide() + for k in pairs(newRegistries) do + clearCache(k) + newRegistries[k] = nil + k = nil + end + end + end) + self.frame:UnregisterAllEvents() + self.frame:RegisterEvent("ADDON_LOADED") + self.frame:RegisterEvent("PLAYER_ENTERING_WORLD") + self.frame:Show() + + if oldDeactivate then + oldDeactivate(oldLib) + end +end + +AceLibrary:Register(AceLocale, MAJOR_VERSION, MINOR_VERSION, activate) diff --git a/Payload/Interface/Addons/SuperAPI/libs/AceModuleCore-2.0/AceModuleCore-2.0.lua b/Payload/Interface/Addons/SuperAPI/libs/AceModuleCore-2.0/AceModuleCore-2.0.lua new file mode 100644 index 0000000..32c89fb --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/AceModuleCore-2.0/AceModuleCore-2.0.lua @@ -0,0 +1,462 @@ +--[[ +Name: AceModuleCore-2.0 +Revision: $Rev: 17998 $ +Developed by: The Ace Development Team (http://www.wowace.com/index.php/The_Ace_Development_Team) +Inspired By: Ace 1.x by Turan (turan@gryphon.com) +Website: http://www.wowace.com/ +Documentation: http://www.wowace.com/index.php/AceModuleCore-2.0 +SVN: http://svn.wowace.com/root/trunk/Ace2/AceModuleCore-2.0 +Description: Mixin to provide a module system so that modules or plugins can + use an addon as its core. +Dependencies: AceLibrary, AceOO-2.0, AceAddon-2.0, AceEvent-2.0 (optional), Compost-2.0 (optional) +]] + +local MAJOR_VERSION = "AceModuleCore-2.0" +local MINOR_VERSION = "$Revision: 17998 $" + +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +if loadstring("return function(...) return ... end") and AceLibrary:HasInstance(MAJOR_VERSION) then return end -- lua51 check +if not AceLibrary:HasInstance("AceOO-2.0") then error(MAJOR_VERSION .. " requires AceOO-2.0") end + +local function safecall(func,a,b,c,d,e,f,g) + local success, err = pcall(func,a,b,c,d,e,f,g) + if not success then geterrorhandler()(err) end +end + +local table_setn +do + local version = GetBuildInfo() + if string.find(version, "^2%.") then + -- 2.0.0 + table_setn = function() end + else + table_setn = table.setn + end +end + +local new, del +do + local list = setmetatable({}, {__mode = 'k'}) + function new() + local t = next(list) + if t then + list[t] = nil + return t + else + return {} + end + end + function del(t) + for k in pairs(t) do + t[k] = nil + end + table_setn(t, 0) + list[t] = true + return nil + end +end + +local AceOO = AceLibrary:GetInstance("AceOO-2.0") +local AceModuleCore = AceOO.Mixin { + "NewModule", + "HasModule", + "GetModule", + "IsModule", + "IterateModules", + "SetModuleMixins", + "SetModuleClass", + "IsModuleActive", + "ToggleModuleActive" + } +local AceEvent + +local Compost = AceLibrary:HasInstance("Compost-2.0") and AceLibrary("Compost-2.0") + +local function getlibrary(lib) + if type(lib) == "string" then + return AceLibrary(lib) + else + return lib + end +end + +local tmp +function AceModuleCore:NewModule(name, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if not self.modules then + AceModuleCore:error("CreatePrototype() must be called before attempting to create a new module.", 2) + end + AceModuleCore:argCheck(name, 2, "string") + if string.len(name) == 0 then + AceModuleCore:error("Bad argument #2 to `NewModule`, string must not be empty") + end + if self.modules[name] then + AceModuleCore:error("The module %q has already been registered", name) + end + + if not tmp then + tmp = {} + end + if a1 then table.insert(tmp, a1) + if a2 then table.insert(tmp, a2) + if a3 then table.insert(tmp, a3) + if a4 then table.insert(tmp, a4) + if a5 then table.insert(tmp, a5) + if a6 then table.insert(tmp, a6) + if a7 then table.insert(tmp, a7) + if a8 then table.insert(tmp, a8) + if a9 then table.insert(tmp, a9) + if a10 then table.insert(tmp, a10) + if a11 then table.insert(tmp, a11) + if a12 then table.insert(tmp, a12) + if a13 then table.insert(tmp, a13) + if a14 then table.insert(tmp, a14) + if a15 then table.insert(tmp, a15) + if a16 then table.insert(tmp, a16) + if a17 then table.insert(tmp, a17) + if a18 then table.insert(tmp, a18) + if a19 then table.insert(tmp, a19) + if a20 then table.insert(tmp, a20) + end end end end end end end end end end end end end end end end end end end end + for k,v in ipairs(tmp) do + tmp[k] = getlibrary(v) + end + + if self.moduleMixins then + for _,mixin in ipairs(self.moduleMixins) do + local exists = false + for _,v in ipairs(tmp) do + if mixin == v then + exists = true + break + end + end + if not exists then + table.insert(tmp, mixin) + end + end + end + + local module = AceOO.Classpool(self.moduleClass, unpack(tmp)):new(name) + self.modules[name] = module + module.name = name + module.title = name + + AceModuleCore.totalModules[module] = self + + if AceEvent then + AceEvent:TriggerEvent("Ace2_ModuleCreated", module) + end + + for k in pairs(tmp) do + tmp[k] = nil + end + table_setn(tmp, 0) + return module +end + +function AceModuleCore:HasModule(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if a1 then if not self.modules[a1] then return false end + if a2 then if not self.modules[a2] then return false end + if a3 then if not self.modules[a3] then return false end + if a4 then if not self.modules[a4] then return false end + if a5 then if not self.modules[a5] then return false end + if a6 then if not self.modules[a6] then return false end + if a7 then if not self.modules[a7] then return false end + if a8 then if not self.modules[a8] then return false end + if a9 then if not self.modules[a9] then return false end + if a10 then if not self.modules[a10] then return false end + if a11 then if not self.modules[a11] then return false end + if a12 then if not self.modules[a12] then return false end + if a13 then if not self.modules[a13] then return false end + if a14 then if not self.modules[a14] then return false end + if a15 then if not self.modules[a15] then return false end + if a16 then if not self.modules[a16] then return false end + if a17 then if not self.modules[a17] then return false end + if a18 then if not self.modules[a18] then return false end + if a19 then if not self.modules[a19] then return false end + if a20 then if not self.modules[a20] then return false end + end end end end end end end end end end end end end end end end end end end end + + return true +end + +function AceModuleCore:GetModule(name) + if not self.modules then + AceModuleCore:error("Error initializing class. Please report error.") + end + if not self.modules[name] then + AceModuleCore:error("Cannot find module %q.", name) + end + return self.modules[name] +end + +function AceModuleCore:IsModule(module) + if self == AceModuleCore then + return AceModuleCore.totalModules[module] + else + for k,v in pairs(self.modules) do + if v == module then + return true + end + end + return false + end +end + +function AceModuleCore:IterateModules() + local t = new() + for k in pairs(self.modules) do + table.insert(t, k) + end + table.sort(t) + local i = 0 + return function() + i = i + 1 + local x = t[i] + if x then + return x, self.modules[x] + else + t = del(t) + return nil + end + end, nil, nil +end + +function AceModuleCore:SetModuleMixins(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + if self.moduleMixins then + AceModuleCore:error('Cannot call "SetModuleMixins" twice') + elseif not self.modules then + AceModuleCore:error("Error initializing class. Please report error.") + elseif next(self.modules) then + AceModuleCore:error('Cannot call "SetModuleMixins" after "NewModule" has been called.') + end + + self.moduleMixins = Compost and Compost:Acquire(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) or {a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20} + for k,v in ipairs(self.moduleMixins) do + self.moduleMixins[k] = getlibrary(v) + end +end + +function AceModuleCore:SetModuleClass(class) + class = getlibrary(class) + AceModuleCore:assert(AceOO.inherits(class, AceOO.Class), "Bad argument #2 to `SetModuleClass' (Class expected)") + if not self.modules then + AceModuleCore:error("Error initializing class. Please report error.") + end + if self.customModuleClass then + AceModuleCore:error("Cannot call `SetModuleClass' twice.") + end + self.customModuleClass = true + self.moduleClass = class + self.modulePrototype = class.prototype +end + +function AceModuleCore:ToggleModuleActive(module, state) + AceModuleCore:argCheck(module, 2, "table", "string") + AceModuleCore:argCheck(state, 3, "nil", "boolean") + + if type(module) == "string" then + if not self:HasModule(module) then + AceModuleCore:error("Cannot find module %q", module) + end + module = self:GetModule(module) + else + if not self:IsModule(module) then + AceModuleCore:error("%q is not a module", module) + end + end + + local disable + if state == nil then + disable = self:IsModuleActive(module) + else + disable = not state + if disable ~= self:IsModuleActive(module) then + return + end + end + + if type(module.ToggleActive) == "function" then + return module:ToggleActive(not disable) + elseif AceOO.inherits(self, "AceDB-2.0") then + if not self.db or not self.db.raw then + AceModuleCore:error("Cannot toggle a module until `RegisterDB' has been called and `ADDON_LOADED' has been fireed.") + end + if type(self.db.raw.disabledModules) ~= "table" then + self.db.raw.disabledModules = Compost and Compost:Acquire() or {} + end + local _,profile = self:GetProfile() + if type(self.db.raw.disabledModules[profile]) ~= "table" then + self.db.raw.disabledModules[profile] = Compost and Compost:Acquire() or {} + end + if type(self.db.raw.disabledModules[profile][module.name]) ~= "table" then + self.db.raw.disabledModules[profile][module.name] = disable or nil + end + if not disable then + if not next(self.db.raw.disabledModules[profile]) then + if Compost then + Compost:Reclaim(self.db.raw.disabledModules[profile]) + end + self.db.raw.disabledModules[profile] = nil + end + if not next(self.db.raw.disabledModules) then + if Compost then + Compost:Reclaim(self.db.raw.disabledModules) + end + self.db.raw.disabledModules = nil + end + end + else + if type(self.disabledModules) ~= "table" then + self.disabledModules = Compost and Compost:Acquire() or {} + end + self.disabledModules[module.name] = disable or nil + end + if AceOO.inherits(module, "AceAddon-2.0") then + local AceAddon = AceLibrary("AceAddon-2.0") + if not AceAddon.addonsStarted[module] then + return + end + end + if not disable then + local current = module.class + while true do + if current == AceOO.Class then + break + end + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedEnable) == "function" then + safecall(mixin.OnEmbedEnable, mixin, module) + end + end + end + current = current.super + end + if type(module.OnEnable) == "function" then + safecall(module.OnEnable, module) + end + if AceEvent then + AceEvent:TriggerEvent("Ace2_AddonEnabled", module) + end + else + local current = module.class + while true do + if current == AceOO.Class then + break + end + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnEmbedDisable) == "function" then + safecall(mixin.OnEmbedDisable, mixin, module) + end + end + end + current = current.super + end + if type(module.OnDisable) == "function" then + safecall(module.OnDisable, module) + end + if AceEvent then + AceEvent:TriggerEvent("Ace2_AddonDisabled", module) + end + end + return not disable +end + +function AceModuleCore:IsModuleActive(module) + AceModuleCore:argCheck(module, 2, "table", "string") + + if AceModuleCore == self then + self:argCheck(module, 2, "table") + + local core = AceModuleCore.totalModules[module] + if not core then + self:error("Bad argument #2 to `IsModuleActive'. Not a module") + end + return core:IsModuleActive(module) + end + + if type(module) == "string" then + if not self:HasModule(module) then + AceModuleCore:error("Cannot find module %q", module) + end + module = self:GetModule(module) + else + if not self:IsModule(module) then + AceModuleCore:error("%q is not a module", module) + end + end + + if type(module.IsActive) == "function" then + return module:IsActive() + elseif AceOO.inherits(self, "AceDB-2.0") then + local _,profile = self:GetProfile() + return not self.db or not self.db.raw or not self.db.raw.disabledModules or not self.db.raw.disabledModules[profile] or not self.db.raw.disabledModules[profile][module.name] + else + return not self.disabledModules or not self.disabledModules[module.name] + end +end + +function AceModuleCore:OnInstanceInit(target) + if target.modules then + AceModuleCore:error("OnInstanceInit cannot be called twice") + end + target.modules = Compost and Compost:Acquire() or {} + + target.moduleClass = AceOO.Class("AceAddon-2.0") + target.modulePrototype = target.moduleClass.prototype +end + +AceModuleCore.OnManualEmbed = AceModuleCore.OnInstanceInit + +function AceModuleCore.OnEmbedProfileDisable(AceModuleCore, self, newProfile) + if not AceOO.inherits(self, "AceDB-2.0") then + return + end + local _,currentProfile = self:GetProfile() + for k, module in pairs(self.modules) do + if type(module.IsActive) == "function" or type(module.ToggleActive) == "function" then + -- continue + else + local currentActive = not self.db or not self.db.raw or not self.db.raw.disabledModules or not self.db.raw.disabledModules[currentProfile] or not self.db.raw.disabledModules[currentProfile][module.name] + local newActive = not self.db or not self.db.raw or not self.db.raw.disabledModules or not self.db.raw.disabledModules[newProfile] or not self.db.raw.disabledModules[newProfile][module.name] + if currentActive ~= newActive then + self:ToggleModuleActive(module) + if not self.db.raw.disabledModules then + self.db.raw.disabledModules = {} + end + if not self.db.raw.disabledModules[currentProfile] then + self.db.raw.disabledModules[currentProfile] = {} + end + self.db.raw.disabledModules[currentProfile][module.name] = not currentActive or nil + end + end + end +end + +local function activate(self, oldLib, oldDeactivate) + AceModuleCore = self + + if oldLib then + self.totalModules = oldLib.totalModules + end + if not self.totalModules then + self.totalModules = {} + end + + self.super.activate(self, oldLib, oldDeactivate) +end + +local function external(self, major, instance) + if major == "Compost-2.0" then + Compost = instance + elseif major == "AceEvent-2.0" then + AceEvent = instance + end +end + +AceLibrary:Register(AceModuleCore, MAJOR_VERSION, MINOR_VERSION, activate, nil, external) +AceModuleCore = AceLibrary(MAJOR_VERSION) diff --git a/Payload/Interface/Addons/SuperAPI/libs/AceOO-2.0/AceOO-2.0.lua b/Payload/Interface/Addons/SuperAPI/libs/AceOO-2.0/AceOO-2.0.lua new file mode 100644 index 0000000..cd372b4 --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/AceOO-2.0/AceOO-2.0.lua @@ -0,0 +1,1006 @@ +--[[ +Name: AceOO-2.0 +Revision: $Rev: 17638 $ +Developed by: The Ace Development Team (http://www.wowace.com/index.php/The_Ace_Development_Team) +Inspired By: Ace 1.x by Turan (turan@gryphon.com) +Website: http://www.wowace.com/ +Documentation: http://www.wowace.com/index.php/AceOO-2.0 +SVN: http://svn.wowace.com/root/trunk/Ace2/AceOO-2.0 +Description: Library to provide an object-orientation framework. +Dependencies: AceLibrary +]] + +local MAJOR_VERSION = "AceOO-2.0" +local MINOR_VERSION = "$Revision: 17639 $" + +-- This ensures the code is only executed if the libary doesn't already exist, or is a newer version +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary.") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +if loadstring("return function(...) return ... end") and AceLibrary:HasInstance(MAJOR_VERSION) then return end -- lua51 check +local table_setn +do + local version = GetBuildInfo() + if string.find(version, "^2%.") then + -- 2.0.0 + table_setn = function() end + else + table_setn = table.setn + end +end + +local AceOO = { + error = AceLibrary.error, + argCheck = AceLibrary.argCheck +} + +-- @function getuid +-- @brief Obtain a unique string identifier for the object in question. +-- @param t The object to obtain the uid for. +-- @return The uid string. +local function pad(cap) + return string.rep('0', 8 - string.len(cap)) .. cap +end +local function getuid(t) + local mt = getmetatable(t) + setmetatable(t, nil) + local str = tostring(t) + setmetatable(t, mt) + local _,_,cap = string.find(str, '[^:]*: 0x(.*)$') + if cap then return pad(cap) end + _,_,cap = string.find(str, '[^:]*: (.*)$') + if cap then return pad(cap) end +end + +local function getlibrary(o) + if type(o) == "table" then + return o + elseif type(o) == "string" then + if not AceLibrary:HasInstance(o) then + AceOO:error("Library %q does not exist.", o) + end + return AceLibrary(o) + end +end + +-- @function Factory +-- @brief Construct a factory for the creation of objects. +-- @param obj The object whose init method will be called on the new factory +-- object. +-- @param newobj The object whose init method will be called on the new +-- objects that the Factory creates, to initialize them. +-- @param (a1..a20) Arguments which will be passed to obj.init() in addition +-- to the Factory object. +-- @return The new factory which creates a newobj when its new method is called, +-- or when it is called directly (__call metamethod). +local Factory +do + local function new(obj, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, + a13, a14, a15, a16, a17, a18, a19, a20) + local t = {} + local uid = getuid(t) + local l = getlibrary + obj:init(t, l(a1), l(a2), l(a3), l(a4), l(a5), l(a6), l(a7), + l(a8), l(a9), l(a10), l(a11), l(a12), l(a13), + l(a14), l(a15), l(a16), l(a17), l(a18), l(a19), + l(a20)) + t.uid = uid + return t + end + + local function createnew(self, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, + a11, a12, a13, a14, a15, a16, a17, a18, + a19, a20) + local o = self.prototype + local l = getlibrary + return new(o, l(a1), l(a2), l(a3), l(a4), l(a5), l(a6), l(a7), + l(a8), l(a9), l(a10), l(a11), l(a12), l(a13), + l(a14), l(a15), l(a16), l(a17), l(a18), l(a19), + l(a20)) + end + + function Factory(obj, newobj, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, + a11, a12, a13, a14, a15, a16, a17, a18, + a19, a20) + local t = new(obj, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, + a13, a14, a15, a16, a17, a18, a19, a20) + t.prototype = newobj + t.new = createnew + getmetatable(t).__call = t.new + return t + end +end + + +local function objtostring(self) + if self.ToString then + return self:ToString() + elseif self.GetLibraryVersion then + return (self:GetLibraryVersion()) + elseif self.super then + local s = "Sub-" .. tostring(self.super) + local first = true + if self.interfaces then + for interface in pairs(self.interfaces) do + if first then + s = s .. "(" .. tostring(interface) + first = false + else + s = s .. ", " .. tostring(interface) + end + end + end + if self.mixins then + for mixin in pairs(self.mixins) do + if first then + s = s .. tostring(mixin) + first = false + else + s = s .. ", " .. tostring(mixin) + end + end + end + if first then + if self.uid then + return s .. ":" .. self.uid + else + return s + end + else + return s .. ")" + end + else + return self.uid and 'Subclass:' .. self.uid or 'Subclass' + end +end + +-- @table Object +-- @brief Base of all objects, including Class. +-- +-- @method init +-- @brief Initialize a new object. +-- @param newobject The object to initialize +-- @param class The class to make newobject inherit from +local Object +do + Object = {} + function Object:init(newobject, class) + local parent = class or self + if not rawget(newobject, 'uid') then + newobject.uid = getuid(newobject) + end + local mt = { + __index = parent, + __tostring = objtostring, + } + setmetatable(newobject, mt) + end + Object.uid = getuid(Object) + setmetatable(Object, { __tostring = function() return 'Object' end }) +end + +local Interface + +local function validateInterface(object, interface) + if not object.class and object.prototype then + object = object.prototype + end + for k,v in pairs(interface.interface) do + if tostring(type(object[k])) ~= v then + return false + end + end + if interface.superinterfaces then + for superinterface in pairs(interface.superinterfaces) do + if not validateInterface(object, superinterface) then + return false + end + end + end + if type(object.class) == "table" and rawequal(object.class.prototype, object) then + if not object.class.interfaces then + rawset(object.class, 'interfaces', {}) + end + object.class.interfaces[interface] = true + elseif type(object.class) == "table" and type(object.class.prototype) == "table" then + validateInterface(object.class.prototype, interface) + -- check if class is proper, thus preventing future checks. + end + return true +end + +-- @function inherits +-- @brief Return whether an Object or Class inherits from a given +-- parent. +-- @param object Object or Class to check +-- @param parent Parent to test inheritance from +-- @return whether an Object or Class inherits from a given +-- parent. +local function inherits(object, parent) + object = getlibrary(object) + if type(parent) == "string" then + if not AceLibrary:HasInstance(parent) then + return false + else + parent = AceLibrary(parent) + end + end + AceOO:argCheck(parent, 2, "table") + if type(object) ~= "table" then + return false + end + local current + if object.class then + current = object.class + else + current = object + end + if type(current) ~= "table" then + return false + end + if rawequal(current, parent) then + return true + end + if parent.class then + while true do + if rawequal(current, Object) then + break + end + if current.mixins then + for mixin in pairs(current.mixins) do + if rawequal(mixin, parent) then + return true + end + end + end + if current.interfaces then + for interface in pairs(current.interfaces) do + if rawequal(interface, parent) then + return true + end + end + end + current = current.super + if type(current) ~= "table" then + break + end + end + + local isInterface = false + local curr = parent.class + while true do + if rawequal(curr, Object) then + break + elseif rawequal(curr, Interface) then + isInterface = true + break + end + curr = curr.super + if type(curr) ~= "table" then + break + end + end + return isInterface and validateInterface(object, parent) + else + while true do + if rawequal(current, parent) then + return true + elseif rawequal(current, Object) then + return false + end + current = current.super + if type(current) ~= "table" then + return false + end + end + end +end + +-- @table Class +-- @brief An object factory which sets up inheritence and supports +-- 'mixins'. +-- +-- @metamethod Class call +-- @brief Call ClassFactory:new() to create a new class. +-- +-- @method Class new +-- @brief Construct a new object. +-- @param (a1..a20) Arguments to pass to the object init function. +-- @return The new object. +-- +-- @method Class init +-- @brief Initialize a new class. +-- @param parent Superclass. +-- @param (a1..a20) Mixins. +-- +-- @method Class ToString +-- @return A string representing the object, in this case 'Class'. +local initStatus +local Class +local Mixin +local autoEmbed = false +local function traverseInterfaces(bit, total) + if bit.superinterfaces then + for interface in pairs(bit.superinterfaces) do + if not total[interface] then + total[interface] = true + traverseInterfaces(interface, total) + end + end + end +end +local class_new +do + Class = Factory(Object, setmetatable({}, {__index = Object}), Object) + Class.super = Object + + local function protostring(t) + return '<' .. tostring(t.class) .. ' prototype>' + end + local function classobjectstring(t) + if t.ToString then + return t:ToString() + elseif t.GetLibraryVersion then + return (t:GetLibraryVersion()) + else + return '<' .. tostring(t.class) .. ' instance>' + end + end + local function classobjectequal(self, other) + if type(self) == "table" and self.Equals then + return self:Equals(other) + elseif type(other) == "table" and other.Equals then + return other:Equals(self) + elseif type(self) == "table" and self.CompareTo then + return self:CompareTo(other) == 0 + elseif type(other) == "table" and other.CompareTo then + return other:CompareTo(self) == 0 + else + return rawequal(self, other) + end + end + local function classobjectlessthan(self, other) + if type(self) == "table" and self.IsLessThan then + return self:IsLessThan(other) + elseif type(other) == "table" and other.IsLessThanOrEqualTo then + return not other:IsLessThanOrEqualTo(self) + elseif type(self) == "table" and self.CompareTo then + return self:CompareTo(other) < 0 + elseif type(other) == "table" and other.CompareTo then + return other:CompareTo(self) > 0 + elseif type(other) == "table" and other.IsLessThan and other.Equals then + return other:Equals(self) or other:IsLessThan(self) + else + AceOO:error("cannot compare two objects") + end + end + local function classobjectlessthanequal(self, other) + if type(self) == "table" and self.IsLessThanOrEqualTo then + return self:IsLessThanOrEqualTo(other) + elseif type(other) == "table" and other.IsLessThan then + return not other:IsLessThan(self) + elseif type(self) == "table" and self.CompareTo then + return self:CompareTo(other) <= 0 + elseif type(other) == "table" and other.CompareTo then + return other:CompareTo(self) >= 0 + elseif type(self) == "table" and self.IsLessThan and self.Equals then + return self:Equals(other) or self:IsLessThan(other) + else + AceOO:error("cannot compare two incompatible objects") + end + end + local function classobjectadd(self, other) + if type(self) == "table" and self.Add then + return self:Add(other) + else + AceOO:error("cannot add two incompatible objects") + end + end + local function classobjectsub(self, other) + if type(self) == "table" and self.Subtract then + return self:Subtract(other) + else + AceOO:error("cannot subtract two incompatible objects") + end + end + local function classobjectunm(self, other) + if type(self) == "table" and self.UnaryNegation then + return self:UnaryNegation(other) + else + AceOO:error("attempt to negate an incompatible object") + end + end + local function classobjectmul(self, other) + if type(self) == "table" and self.Multiply then + return self:Multiply(other) + else + AceOO:error("cannot multiply two incompatible objects") + end + end + local function classobjectdiv(self, other) + if type(self) == "table" and self.Divide then + return self:Divide(other) + else + AceOO:error("cannot divide two incompatible objects") + end + end + local function classobjectpow(self, other) + if type(self) == "table" and self.Exponent then + return self:Exponent(other) + else + AceOO:error("cannot exponentiate two incompatible objects") + end + end + local function classobjectconcat(self, other) + if type(self) == "table" and self.Concatenate then + return self:Concatenate(other) + else + AceOO:error("cannot concatenate two incompatible objects") + end + end + function class_new(self, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, + a13, a14, a15, a16, a17, a18, a19, a20) + if self.virtual then + AceOO:error("Cannot instantiate a virtual class.") + end + + local o = self.prototype + local newobj = {} + if o.class and o.class.instancemeta then + setmetatable(newobj, o.class.instancemeta) + else + Object:init(newobj, o) + end + + if self.interfaces and not self.interfacesVerified then + -- Verify the interfaces + + for interface in pairs(self.interfaces) do + for field,kind in pairs(interface.interface) do + if tostring(type(newobj[field])) ~= kind then + AceOO:error("Class did not satisfy all interfaces. %q is required to be a %s. It is a %s", field, kind, tostring(type(newobj[field]))) + end + end + end + self.interfacesVerified = true + end + local tmp = initStatus + initStatus = newobj + newobj:init(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, + a13, a14, a15, a16, a17, a18, a19, a20) + if initStatus then + initStatus = tmp + AceOO:error("Initialization not completed, be sure to call the superclass's init method.") + return + end + initStatus = tmp + return newobj + end + local classmeta = { + __tostring = objtostring, + __call = function(self, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, + a13, a14, a15, a16, a17, a18, a19, a20) + return self:new(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, + a13, a14, a15, a16, a17, a18, a19, a20) + end, + } + function Class:init(newclass, parent, a1, a2, a3, a4, a5, a6, a7, a8, a9, + a10, a11, a12, a13, a14, a15, a16, + a17, a18, a19, a20) + parent = parent or self + + local total + + if parent.class then + total = { + parent, a1, a2, a3, a4, a5, a6, a7, a8, a9, + a10, a11, a12, a13, a14, a15, a16, + a17, a18, a19, a20 + } + parent = self + else + total = { + a1, a2, a3, a4, a5, a6, a7, a8, a9, + a10, a11, a12, a13, a14, a15, a16, + a17, a18, a19, a20 + } + end + if not inherits(parent, Class) then + AceOO:error("Classes must inherit from a proper class") + end + if parent.sealed then + AceOO:error("Cannot inherit from a sealed class") + end + for i,v in ipairs(total) do + if inherits(v, Mixin) and v.class then + if not newclass.mixins then + newclass.mixins = {} + end + if newclass.mixins[v] then + AceOO:error("Cannot explicitly inherit from the same mixin twice") + end + newclass.mixins[v] = true + elseif inherits(v, Interface) and v.class then + if not newclass.interfaces then + newclass.interfaces = {} + end + if newclass.interfaces[v] then + AceOO:error("Cannot explicitly inherit from the same interface twice") + end + newclass.interfaces[v] = true + else + AceOO:error("Classes can only inherit from one or zero classes and any number of mixins or interfaces") + end + end + if parent.interfaces then + if newclass.interfaces then + for interface in pairs(parent.interfaces) do + newclass.interfaces[interface] = true + end + else + newclass.interfaces = parent.interfaces + end + end + for k in pairs(total) do + total[k] = nil + end + table_setn(total, 0) + + newclass.super = parent + + newclass.prototype = setmetatable(total, { + __index = parent.prototype, + __tostring = protostring, + }) + total = nil + + newclass.instancemeta = { + __index = newclass.prototype, + __tostring = classobjectstring, + __eq = classobjectequal, + __lt = classobjectlessthan, + __le = classobjectlessthanequal, + __add = classobjectadd, + __sub = classobjectsub, + __unm = classobjectunm, + __mul = classobjectmul, + __div = classobjectdiv, + __pow = classobjectpow, + __concat = classobjectconcat, + } + + setmetatable(newclass, classmeta) + + newclass.new = class_new + + if newclass.mixins then + -- Fold in the mixins + local err, msg + for mixin in pairs(newclass.mixins) do + local ret + autoEmbed = true + ret, msg = pcall(mixin.embed, mixin, newclass.prototype) + autoEmbed = false + if not ret then + err = true + break + end + end + + if err then + local pt = newclass.prototype + for k,v in pairs(pt) do + pt[k] = nil + end + + -- method conflict + AceOO:error(msg) + end + end + + newclass.prototype.class = newclass + + if newclass.interfaces then + for interface in pairs(newclass.interfaces) do + traverseInterfaces(interface, newclass.interfaces) + end + end + if newclass.mixins then + for mixin in pairs(newclass.mixins) do + if mixin.interfaces then + if not newclass.interfaces then + newclass.interfaces = {} + end + for interface in pairs(mixin.interfaces) do + newclass.interfaces[interface] = true + end + end + end + end + end + function Class:ToString() + if type(self.GetLibraryVersion) == "function" then + return (self:GetLibraryVersion()) + else + return "Class" + end + end + + local tmp + function Class.prototype:init() + if rawequal(self, initStatus) then + initStatus = nil + else + AceOO:error("Improper self passed to init. You must do MyClass.super.prototype.init(self, ...)", 2) + end + self.uid = getuid(self) + local current = self.class + while true do + if current == Class then + break + end + if current.mixins then + for mixin in pairs(current.mixins) do + if type(mixin.OnInstanceInit) == "function" then + mixin:OnInstanceInit(self) + end + end + end + current = current.super + end + end +end + + +-- @object ClassFactory +-- @brief A factory for creating classes. Rarely used directly. +local ClassFactory = Factory(Object, Class, Object) + +function Class:new(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, + a12, a13, a14, a15, a16, a17, a18, a19, a20) + local x = ClassFactory:new(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, + a12, a13, a14, a15, a16, a17, a18, a19, a20) + if AceOO.classes then + AceOO.classes[x] = true + end + return x +end +getmetatable(Class).__call = Class.new + +-- @class Mixin +-- @brief A class to create mixin objects, which contain methods that get +-- "mixed in" to class prototypes. +-- +-- @object Mixin prototype +-- @brief The prototype that mixin objects inherit their methods from. +-- +-- @method Mixin prototype embed +-- @brief Mix in the methods of our object which are listed in our interface +-- to the supplied target table. +-- +-- @method Mixin prototype init +-- @brief Initialize the mixin object. +-- @param newobj The new object we're initializing. +-- @param interface The interface we implement (the list of methods our +-- prototype provides which should be mixed into the target +-- table by embed). +do + Mixin = Class() + function Mixin:ToString() + if self.GetLibraryVersion then + return (self:GetLibraryVersion()) + else + return 'Mixin' + end + end + local function _Embed(state, field, target) + field = next(state.export, field) + if field == nil then + return + end + + if rawget(target, field) or (target[field] and target[field] ~= state[field]) then + AceOO:error("Method conflict in attempt to mixin. Field %q", field) + end + + target[field] = state[field] + + local ret,msg = pcall(_Embed, state, field, target) + if not ret then + -- Mix in the next method according to the defined interface. If that + -- fails due to a conflict, re-raise to back out the previous mixed + -- methods. + + target[field] = nil + AceOO:error(msg) + end + end + function Mixin.prototype:embed(target) + local mt = getmetatable(target) + setmetatable(target, nil) + local err, msg = pcall(_Embed, self, nil, target) + if not err then + setmetatable(target, mt) + AceOO:error(msg) + return + end + if type(self.embedList) == "table" then + self.embedList[target] = true + end + if type(target.class) ~= "table" then + target[self] = true + end + if not autoEmbed and type(self.OnManualEmbed) == "function" then + if not target.modules then + self:OnManualEmbed(target) + end + end + setmetatable(target, mt) + end + + function Mixin.prototype:activate(oldLib, oldDeactivate) + if oldLib and oldLib.embedList then + for target in pairs(oldLib.embedList) do + local mt = getmetatable(target) + setmetatable(target, nil) + for field in pairs(oldLib.export) do + target[field] = nil + end + setmetatable(target, mt) + end + self.embedList = oldLib.embedList + for target in pairs(self.embedList) do + self:embed(target) + end + else + self.embedList = setmetatable({}, {__mode="k"}) + end + end + + function Mixin.prototype:init(export, a1, a2, a3, a4, a5, a6, a7, a8, a9, + a10, a11, a12, a13, a14, a15, a16, + a17, a18, a19, a20) + AceOO:argCheck(export, 2, "table") + for k,v in pairs(export) do + if type(k) ~= "number" then + AceOO:error("All keys to argument #2 must be numbers.") + elseif type(v) ~= "string" then + AceOO:error("All values to argument #2 must be strings.") + end + end + local num = table.getn(export) + for i = 1, num do + local v = export[i] + export[i] = nil + export[v] = true + end + table_setn(export, 0) + local interfaces + if a1 then + local l = getlibrary + interfaces = { l(a1), l(a2), l(a3), l(a4), l(a5), l(a6), l(a7), l(a8), + l(a9), l(a10), l(a11), l(a12), l(a13), l(a14), l(a15), l(a16), + l(a17), l(a18), l(a19), l(a20) } + for _,v in ipairs(interfaces) do + if not v.class or not inherits(v, Interface) then + AceOO:error("Mixins can inherit only from interfaces") + end + end + local num = table.getn(interfaces) + for i = 1, num do + local v = interfaces[i] + interfaces[i] = nil + interfaces[v] = true + end + table_setn(interfaces, 0) + for interface in pairs(interfaces) do + traverseInterfaces(interface, interfaces) + end + for interface in pairs(interfaces) do + for field,kind in pairs(interface.interface) do + if kind ~= "nil" then + local good = false + for bit in pairs(export) do + if bit == field then + good = true + break + end + end + if not good then + AceOO:error("Mixin does not fully accommodate field %q", field) + end + end + end + end + end + self.super = Mixin.prototype + Mixin.super.prototype.init(self) + self.export = export + self.interfaces = interfaces + end +end + +-- @class Interface +-- @brief A class to create interfaces, which contain contracts that classes +-- which inherit from this must comply with. +-- +-- @object Interface prototype +-- @brief The prototype that interface objects must adhere to. +-- +-- @method Interface prototype init +-- @brief Initialize the mixin object. +-- @param interface The interface we contract (the hash of fields forced). +-- @param (a1..a20) Superinterfaces +do + Interface = Class() + function Interface:ToString() + if self.GetLibraryVersion then + return (self:GetLibraryVersion()) + else + return 'Instance' + end + end + function Interface.prototype:init(interface, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) + Interface.super.prototype.init(self) + AceOO:argCheck(interface, 2, "table") + for k,v in pairs(interface) do + if type(k) ~= "string" then + AceOO:error("All keys to argument #2 must be numbers.") + elseif type(v) ~= "string" then + AceOO:error("All values to argument #2 must be strings.") + elseif v ~= "nil" and v ~= "string" and v ~= "number" and v ~= "table" and v ~= "function" then + AceOO:error('All values to argument #2 must either be "nil", "string", "number", "table", or "function".') + end + end + local l = getlibrary + a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20 = l(a1), l(a2), l(a3), l(a4), l(a5), l(a6), l(a7), l(a8), l(a9), l(a10), l(a11), l(a12), l(a13), l(a14), l(a15), l(a16), l(a17), l(a18), l(a19), l(a20) + if a1 then + self.superinterfaces = {a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20} + for k,v in ipairs(self.superinterfaces) do + if not inherits(v, Interface) or not v.class then + AceOO:error('Cannot provide a non-Interface to inherit from') + end + end + local num = table.getn(self.superinterfaces) + for i = 1, num do + local v = self.superinterfaces[i] + self.superinterfaces[i] = nil + self.superinterfaces[v] = true + end + table_setn(self.superinterfaces, 0) + end + self.interface = interface + end +end + +-- @function Classpool +-- @brief Obtain a read only class from our pool of classes, indexed by the +-- superclass and mixins. +-- @param sc The superclass of the class we want. +-- @param (m1..m20) Mixins of the class we want's objects. +-- @return A read only class from the class pool. +local Classpool +do + local pool = setmetatable({}, {__mode = 'v'}) + local function newindex(k, v) + AceOO:error('Attempt to modify a read-only class.') + end + local function protonewindex(k, v) + AceOO:error('Attempt to modify a read-only class prototype.') + end + local function ts(bit) + if type(bit) ~= "table" then + return tostring(bit) + elseif getmetatable(bit) and bit.__tostring then + return tostring(bit) + elseif type(bit.GetLibraryVersion) == "function" then + return bit:GetLibraryVersion() + else + return tostring(bit) + end + end + local t + local function getcomplexuid(sc, m1, m2, m3, m4, m5, m6, m7, m8, m9, + m10, m11, m12, m13, m14, m15, m16, m17, m18, m19, m20) + if not t then t = {} end + if sc then if sc.uid then table.insert(t, sc.uid) else AceOO:error("%s is not an appropriate class/mixin", ts(sc)) end + if m1 then if m1.uid then table.insert(t, m1.uid) else AceOO:error("%s is not an appropriate mixin", ts(m1)) end + if m2 then if m2.uid then table.insert(t, m2.uid) else AceOO:error("%s is not an appropriate mixin", ts(m2)) end + if m3 then if m3.uid then table.insert(t, m3.uid) else AceOO:error("%s is not an appropriate mixin", ts(m3)) end + if m4 then if m4.uid then table.insert(t, m4.uid) else AceOO:error("%s is not an appropriate mixin", ts(m4)) end + if m5 then if m5.uid then table.insert(t, m5.uid) else AceOO:error("%s is not an appropriate mixin", ts(m5)) end + if m6 then if m6.uid then table.insert(t, m6.uid) else AceOO:error("%s is not an appropriate mixin", ts(m6)) end + if m7 then if m7.uid then table.insert(t, m7.uid) else AceOO:error("%s is not an appropriate mixin", ts(m7)) end + if m8 then if m8.uid then table.insert(t, m8.uid) else AceOO:error("%s is not an appropriate mixin", ts(m8)) end + if m9 then if m9.uid then table.insert(t, m9.uid) else AceOO:error("%s is not an appropriate mixin", ts(m9)) end + if m10 then if m10.uid then table.insert(t, m10.uid) else AceOO:error("%s is not an appropriate mixin", ts(m10)) end + if m11 then if m11.uid then table.insert(t, m11.uid) else AceOO:error("%s is not an appropriate mixin", ts(m11)) end + if m12 then if m12.uid then table.insert(t, m12.uid) else AceOO:error("%s is not an appropriate mixin", ts(m12)) end + if m13 then if m13.uid then table.insert(t, m13.uid) else AceOO:error("%s is not an appropriate mixin", ts(m13)) end + if m14 then if m14.uid then table.insert(t, m14.uid) else AceOO:error("%s is not an appropriate mixin", ts(m14)) end + if m15 then if m15.uid then table.insert(t, m15.uid) else AceOO:error("%s is not an appropriate mixin", ts(m15)) end + if m16 then if m16.uid then table.insert(t, m16.uid) else AceOO:error("%s is not an appropriate mixin", ts(m16)) end + if m17 then if m17.uid then table.insert(t, m17.uid) else AceOO:error("%s is not an appropriate mixin", ts(m17)) end + if m18 then if m18.uid then table.insert(t, m18.uid) else AceOO:error("%s is not an appropriate mixin", ts(m18)) end + if m19 then if m19.uid then table.insert(t, m19.uid) else AceOO:error("%s is not an appropriate mixin", ts(m19)) end + if m20 then if m20.uid then table.insert(t, m20.uid) else AceOO:error("%s is not an appropriate mixin", ts(m20)) end + end end end end end end end end end end end end end end end end end end end end end + table.sort(t) + local uid = table.concat(t, '') + for k in pairs(t) do t[k] = nil end + table_setn(t, 0) + return uid + end + local classmeta + function Classpool(sc, m1, m2, m3, m4, m5, m6, m7, m8, m9, + m10, m11, m12, m13, m14, m15, m16, + m17, m18, m19, m20) + local l = getlibrary + sc, m1, m2, m3, m4, m5, m6, m7, m8, m9, m10, m11, m12, m13, m14, m15, m16, m17, m18, m19, m20 = l(sc), l(m1), l(m2), l(m3), l(m4), l(m5), l(m6), l(m7), l(m8), l(m9), l(m10), l(m11), l(m12), l(m13), l(m14), l(m15), l(m16), l(m17), l(m18), l(m19), l(m20) + if sc and sc.class then + sc, m1, m2, m3, m4, m5, m6, m7, m8, m9, m10, m11, m12, m13, m14, m15, m16, m17, m18, m19, m20 = Class, sc, m1, m2, m3, m4, m5, m6, m7, m8, m9, m10, m11, m12, m13, m14, m15, m16, m17, m18, m19 + end + sc = sc or Class + local key = getcomplexuid(sc, m1, m2, m3, m4, m5, m6, m7, m8, m9, m10, m11, m12, m13, m14, m15, m16, m17, m18, m19, m20) + if not pool[key] then + local class = Class(sc, m1, m2, m3, m4, m5, m6, m7, m8, m9, + m10, m11, m12, m13, m14, m15, m16, m17, + m18, m19, m20) + if not classmeta then + classmeta = {} + local mt = getmetatable(class) + for k,v in pairs(mt) do + classmeta[k] = v + end + classmeta.__newindex = newindex + end + -- Prevent the user from adding methods to this class. + -- NOTE: I'm not preventing modifications of existing class members, + -- but it's likely that only a truly malicious user will be doing so. + class.sealed = true + setmetatable(class, classmeta) + getmetatable(class.prototype).__newindex = protonewindex + pool[key] = class + end + return pool[key] + end +end + +AceOO.Factory = Factory +AceOO.Object = Object +AceOO.Class = Class +AceOO.Mixin = Mixin +AceOO.Interface = Interface +AceOO.Classpool = Classpool +AceOO.inherits = inherits + +-- Library handling bits + +local function activate(self, oldLib, oldDeactivate) + AceOO = self + Factory = self.Factory + Object = self.Object + Class = self.Class + ClassFactory.prototype = Class + Mixin = self.Mixin + Interface = self.Interface + Classpool = self.Classpool + + if oldLib then + self.classes = oldLib.classes + end + if not self.classes then + self.classes = setmetatable({}, {__mode="k"}) + else + for class in pairs(self.classes) do + class.new = class_new + end + end + + if oldDeactivate then + oldDeactivate(oldLib) + end +end + +AceLibrary:Register(AceOO, MAJOR_VERSION, MINOR_VERSION, activate) +AceOO = AceLibrary(MAJOR_VERSION) diff --git a/Payload/Interface/Addons/SuperAPI/libs/Dewdrop/Dewdrop-2.0.lua b/Payload/Interface/Addons/SuperAPI/libs/Dewdrop/Dewdrop-2.0.lua new file mode 100644 index 0000000..bc72ba6 --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/Dewdrop/Dewdrop-2.0.lua @@ -0,0 +1,2602 @@ +--[[ +Name: Dewdrop-2.0 +Revision: $Rev: 15987 $ +Author(s): ckknight (ckknight@gmail.com) +Website: http://ckknight.wowinterface.com/ +Documentation: http://wiki.wowace.com/index.php/Dewdrop-2.0 +SVN: http://svn.wowace.com/root/trunk/DewdropLib/Dewdrop-2.0 +Description: A library to provide a clean dropdown menu interface. +Dependencies: AceLibrary +]] + +local MAJOR_VERSION = "Dewdrop-2.0" +local MINOR_VERSION = "$Revision: 15987 $" + +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +local Dewdrop = {} + +local lua51 = loadstring("return function(...) return ... end") and true or false + +local table_setn = lua51 and function() end or table.setn + +local function new(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20) + local t = {} + if k1 then t[k1] = v1 + if k2 then t[k2] = v2 + if k3 then t[k3] = v3 + if k4 then t[k4] = v4 + if k5 then t[k5] = v5 + if k6 then t[k6] = v6 + if k7 then t[k7] = v7 + if k8 then t[k8] = v8 + if k9 then t[k9] = v9 + if k10 then t[k10] = v10 + if k11 then t[k11] = v11 + if k12 then t[k12] = v12 + if k13 then t[k13] = v13 + if k14 then t[k14] = v14 + if k15 then t[k15] = v15 + if k16 then t[k16] = v16 + if k17 then t[k17] = v17 + if k18 then t[k18] = v18 + if k19 then t[k19] = v19 + if k20 then t[k20] = v20 + end end end end end end end end end end end end end end end end end end end end + return t +end +if lua51 then + new = loadstring("return function(...) local t = {}; for i = 1, select('#', ...), 2 do if select(i, ...) then t[select(i, ...)] = select(i+1, ...); else break; end; end; return t; end")() +end + +local tmp +do + local t = {} + function tmp(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20) + for k in pairs(t) do + t[k] = nil + end + if type(k1) == "table" then + for k,v in pairs(k1) do + t[k] = v + end + else + if k1 then t[k1] = v1 + if k2 then t[k2] = v2 + if k3 then t[k3] = v3 + if k4 then t[k4] = v4 + if k5 then t[k5] = v5 + if k6 then t[k6] = v6 + if k7 then t[k7] = v7 + if k8 then t[k8] = v8 + if k9 then t[k9] = v9 + if k10 then t[k10] = v10 + if k11 then t[k11] = v11 + if k12 then t[k12] = v12 + if k13 then t[k13] = v13 + if k14 then t[k14] = v14 + if k15 then t[k15] = v15 + if k16 then t[k16] = v16 + if k17 then t[k17] = v17 + if k18 then t[k18] = v18 + if k19 then t[k19] = v19 + if k20 then t[k20] = v20 + end end end end end end end end end end end end end end end end end end end end + end + return t + end + if lua51 then + tmp = loadstring("local t = {}; return function(...) for k in pairs(t) do t[k] = nil end; for i = 1, select('#', ...), 2 do if select(i, ...) then t[select(i, ...)] = select(i+1, ...) else break; end; end; return t; end")() + end +end +local tmp2 +do + local t = {} + function tmp2(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20) + for k in pairs(t) do + t[k] = nil + end + if k1 then t[k1] = v1 + if k2 then t[k2] = v2 + if k3 then t[k3] = v3 + if k4 then t[k4] = v4 + if k5 then t[k5] = v5 + if k6 then t[k6] = v6 + if k7 then t[k7] = v7 + if k8 then t[k8] = v8 + if k9 then t[k9] = v9 + if k10 then t[k10] = v10 + if k11 then t[k11] = v11 + if k12 then t[k12] = v12 + if k13 then t[k13] = v13 + if k14 then t[k14] = v14 + if k15 then t[k15] = v15 + if k16 then t[k16] = v16 + if k17 then t[k17] = v17 + if k18 then t[k18] = v18 + if k19 then t[k19] = v19 + if k20 then t[k20] = v20 + end end end end end end end end end end end end end end end end end end end end + return t + end + if lua51 then + tmp2 = loadstring("local t = {}; return function(...) for k in pairs(t) do t[k] = nil end; for i = 1, select('#', ...), 2 do if select(i, ...) then t[select(i, ...)] = select(i+1, ...) else break; end; end; return t; end")() + end +end +local levels +local buttons + +local function GetScaledCursorPosition() + local x, y = GetCursorPosition() + local scale = UIParent:GetEffectiveScale() + return x / scale, y / scale +end + +local function StartCounting(self, levelNum) + for i = levelNum, table.getn(levels) do + if levels[i] then + levels[i].count = 3 + end + end +end + +local function StopCounting(self, level) + for i = level, 1, -1 do + if levels[i] then + levels[i].count = nil + end + end +end + +local function OnUpdate(self, arg1) + for _,level in ipairs(levels) do + if level.count then + level.count = level.count - arg1 + if level.count < 0 then + level.count = nil + self:Close(level.num) + end + end + end +end + +local function CheckDualMonitor(self, frame) + local ratio = GetScreenWidth() / GetScreenHeight() + if ratio >= 2.4 and frame:GetRight() > GetScreenWidth() / 2 and frame:GetLeft() < GetScreenWidth() / 2 then + local offsetx + if GetCursorPosition() / GetScreenHeight() * 768 < GetScreenWidth() / 2 then + offsetx = GetScreenWidth() / 2 - frame:GetRight() + else + offsetx = GetScreenWidth() / 2 - frame:GetLeft() + end + local point, parent, relativePoint, x, y = frame:GetPoint(1) + frame:SetPoint(point, parent, relativePoint, (x or 0) + offsetx, y or 0) + end +end + +local function CheckSize(self, level) + if not level.buttons then + return + end + local height = 20 + for _, button in ipairs(level.buttons) do + height = height + button:GetHeight() + end + level:SetHeight(height) + local width = 160 + for _, button in ipairs(level.buttons) do + local extra = 1 + if button.hasArrow or button.hasColorSwatch then + extra = extra + 16 + end + if not button.notCheckable then + extra = extra + 24 + end + button.text:SetFont(STANDARD_TEXT_FONT, button.textHeight) + if button.text:GetWidth() + extra > width then + width = button.text:GetWidth() + extra + end + end + level:SetWidth(width + 20) + if level:GetLeft() and level:GetRight() and level:GetTop() and level:GetBottom() and (level:GetLeft() < 0 or level:GetRight() > GetScreenWidth() or level:GetTop() > GetScreenHeight() or level:GetBottom() < 0) then + level:ClearAllPoints() + if level.lastDirection == "RIGHT" then + if level.lastVDirection == "DOWN" then + level:SetPoint("TOPLEFT", level.parent or level:GetParent(), "TOPRIGHT", 5, 10) + else + level:SetPoint("BOTTOMLEFT", level.parent or level:GetParent(), "BOTTOMRIGHT", 5, -10) + end + else + if level.lastVDirection == "DOWN" then + level:SetPoint("TOPRIGHT", level.parent or level:GetParent(), "TOPLEFT", -5, 10) + else + level:SetPoint("BOTTOMRIGHT", level.parent or level:GetParent(), "BOTTOMLEFT", -5, -10) + end + end + end + local dirty = false + if not level:GetRight() then + self:Close() + return + end + if level:GetRight() > GetScreenWidth() and level.lastDirection == "RIGHT" then + level.lastDirection = "LEFT" + dirty = true + elseif level:GetLeft() < 0 and level.lastDirection == "LEFT" then + level.lastDirection = "RIGHT" + dirty = true + end + if level:GetTop() > GetScreenHeight() and level.lastVDirection == "UP" then + level.lastVDirection = "DOWN" + dirty = true + elseif level:GetBottom() < 0 and level.lastVDirection == "DOWN" then + level.lastVDirection = "UP" + dirty = true + end + if dirty then + level:ClearAllPoints() + if level.lastDirection == "RIGHT" then + if level.lastVDirection == "DOWN" then + level:SetPoint("TOPLEFT", level.parent or level:GetParent(), "TOPRIGHT", 5, 10) + else + level:SetPoint("BOTTOMLEFT", level.parent or level:GetParent(), "BOTTOMRIGHT", 5, -10) + end + else + if level.lastVDirection == "DOWN" then + level:SetPoint("TOPRIGHT", level.parent or level:GetParent(), "TOPLEFT", -5, 10) + else + level:SetPoint("BOTTOMRIGHT", level.parent or level:GetParent(), "BOTTOMLEFT", -5, -10) + end + end + end + if level:GetTop() > GetScreenHeight() then + local top = level:GetTop() + local point, parent, relativePoint, x, y = level:GetPoint(1) + level:ClearAllPoints() + level:SetPoint(point, parent, relativePoint, x or 0, (y or 0) + GetScreenHeight() - top) + elseif level:GetBottom() < 0 then + local bottom = level:GetBottom() + local point, parent, relativePoint, x, y = level:GetPoint(1) + level:ClearAllPoints() + level:SetPoint(point, parent, relativePoint, x or 0, (y or 0) - bottom) + end + CheckDualMonitor(self, level) + if mod(level.num, 5) == 0 then + local left, bottom = level:GetLeft(), level:GetBottom() + level:ClearAllPoints() + level:SetPoint("BOTTOMLEFT", UIParent, "BOTTOMLEFT", left, bottom) + end +end + +local Open +local OpenSlider +local OpenEditBox +local Refresh +local Clear +local function ReleaseButton(self, level, index) + if not level.buttons then + return + end + if not level.buttons[index] then + return + end + local button = level.buttons[index] + button:Hide() + if button.highlight then + button.highlight:Hide() + end +-- button.arrow:SetVertexColor(1, 1, 1) + button.arrow:SetHeight(16) + button.arrow:SetWidth(16) + table.remove(level.buttons, index) + table.insert(buttons, button) + for k in pairs(button) do + if k ~= 0 and k ~= "text" and k ~= "check" and k ~= "arrow" and k ~= "colorSwatch" and k ~= "highlight" and k ~= "radioHighlight" then + button[k] = nil + end + end + return true +end + +local function Scroll(self, level, down) + if down then + if level:GetBottom() < 0 then + local point, parent, relativePoint, x, y = level:GetPoint(1) + level:SetPoint(point, parent, relativePoint, x, y + 50) + if level:GetBottom() > 0 then + level:SetPoint(point, parent, relativePoint, x, y + 50 - level:GetBottom()) + end + end + else + if level:GetTop() > GetScreenHeight() then + local point, parent, relativePoint, x, y = level:GetPoint(1) + level:SetPoint(point, parent, relativePoint, x, y - 50) + if level:GetTop() < GetScreenHeight() then + level:SetPoint(point, parent, relativePoint, x, y - 50 + GetScreenHeight() - level:GetTop()) + end + end + end +end + +local sliderFrame +local editBoxFrame + +local numButtons = 0 +local function AcquireButton(self, level) + if not levels[level] then + return + end + level = levels[level] + if not level.buttons then + level.buttons = {} + end + local button + if table.getn(buttons) == 0 then + numButtons = numButtons + 1 + button = CreateFrame("Button", "Dewdrop20Button" .. numButtons, nil) + button:SetFrameStrata("FULLSCREEN_DIALOG") + button:SetHeight(16) + local highlight = button:CreateTexture(nil, "BACKGROUND") + highlight:SetTexture("Interface\\QuestFrame\\UI-QuestTitleHighlight") + button.highlight = highlight + highlight:SetBlendMode("ADD") + highlight:SetAllPoints(button) + highlight:Hide() + local check = button:CreateTexture(nil, "ARTWORK") + button.check = check + check:SetTexture("Interface\\Buttons\\UI-CheckBox-Check") + check:SetPoint("CENTER", button, "LEFT", 12, 0) + check:SetWidth(24) + check:SetHeight(24) + local radioHighlight = button:CreateTexture(nil, "ARTWORK") + button.radioHighlight = radioHighlight + radioHighlight:SetTexture("Interface\\Buttons\\UI-RadioButton") + radioHighlight:SetAllPoints(check) + radioHighlight:SetBlendMode("ADD") + radioHighlight:SetTexCoord(0.5, 0.75, 0, 1) + radioHighlight:Hide() + button:SetScript("OnEnter", function() + local this = this + if (sliderFrame and sliderFrame:IsShown() and sliderFrame.mouseDown and sliderFrame.level == this.level.num + 1) or (editBoxFrame and editBoxFrame:IsShown() and editBoxFrame.mouseDown and editBoxFrame.level == this.level.num + 1) then + for i = 1, this.level.num do + Refresh(self, levels[i]) + end + return + end + self:Close(this.level.num + 1) + if not this.disabled then + if this.hasSlider then + OpenSlider(self, this) + elseif this.hasEditBox then + OpenEditBox(self, this) + elseif this.hasArrow then + Open(self, this, nil, this.level.num + 1, this.value) + end + end + if not this.level then -- button reclaimed + return + end + StopCounting(self, this.level.num + 1) + if not this.disabled then + highlight:Show() + if this.isRadio then + button.radioHighlight:Show() + end + end + if this.tooltipTitle or this.tooltipText then + GameTooltip_SetDefaultAnchor(GameTooltip, this) + local disabled = not this.isTitle and this.disabled + if this.tooltipTitle then + if disabled then + GameTooltip:SetText(this.tooltipTitle, 0.5, 0.5, 0.5, 1) + else + GameTooltip:SetText(this.tooltipTitle, 1, 1, 1, 1) + end + if this.tooltipText then + if disabled then + GameTooltip:AddLine(this.tooltipText, (NORMAL_FONT_COLOR.r + 0.5) / 2, (NORMAL_FONT_COLOR.g + 0.5) / 2, (NORMAL_FONT_COLOR.b + 0.5) / 2, 1) + else + GameTooltip:AddLine(this.tooltipText, NORMAL_FONT_COLOR.r, NORMAL_FONT_COLOR.g, NORMAL_FONT_COLOR.b, 1) + end + end + else + if disabled then + GameTooltip:SetText(this.tooltipText, 0.5, 0.5, 0.5, 1) + else + GameTooltip:SetText(this.tooltipText, 1, 1, 1, 1) + end + end + GameTooltip:Show() + end + if this.tooltipFunc then + GameTooltip:SetOwner(this, "ANCHOR_NONE") + GameTooltip:SetPoint("TOPLEFT", this, "TOPRIGHT", 5, 0) + this.tooltipFunc(this.tooltipArg1, this.tooltipArg2, this.tooltipArg3, this.tooltipArg4) + GameTooltip:Show() + end + end) + button:SetScript("OnLeave", function() + highlight:Hide() + button.radioHighlight:Hide() + if this.level then + StartCounting(self, this.level.num) + end + GameTooltip:Hide() + end) + button:SetScript("OnClick", function() + if not this.disabled then + if this.hasColorSwatch then + local func = button.colorFunc + local a1,a2,a3,a4 = button.colorArg1, button.colorArg2, button.colorArg3, button.colorArg4 + local hasOpacity = this.hasOpacity + ColorPickerFrame.func = function() + if func then + local r,g,b = ColorPickerFrame:GetColorRGB() + local a = hasOpacity and 1 - OpacitySliderFrame:GetValue() or nil + if a1 == nil then + func(r, g, b, a) + elseif a2 == nil then + func(a1, r, g, b, a) + elseif a3 == nil then + func(a1, a2, r, g, b, a) + elseif a4 == nil then + func(a1, a2, a3, r, g, b, a) + else + func(a1, a2, a3, a4, r, g, b, a) + end + end + end + ColorPickerFrame.hasOpacity = this.hasOpacity + ColorPickerFrame.opacityFunc = ColorPickerFrame.func + ColorPickerFrame.opacity = 1 - this.opacity + ColorPickerFrame:SetColorRGB(this.r, this.g, this.b) + local r, g, b, a = this.r, this.g, this.b, this.opacity + ColorPickerFrame.cancelFunc = function() + if a1 == nil then + func(r, g, b, a) + elseif a2 == nil then + func(a1, r, g, b, a) + elseif a3 == nil then + func(a1, a2, r, g, b, a) + else + func(a1, a2, a3, r, g, b, a) + end + end + self:Close(1) + ShowUIPanel(ColorPickerFrame) + elseif this.func then + local level = button.level + if type(this.func) == "string" then + self:assert(type(this.arg1[this.func]) == "function", "Cannot call method " .. this.func) + this.arg1[this.func](this.arg1, this.arg2, this.arg3, this.arg4) + else + this.func(this.arg1, this.arg2, this.arg3, this.arg4) + end + if this.closeWhenClicked then + self:Close() + elseif level:IsShown() then + for i = 1, level.num do + Refresh(self, levels[i]) + end + end + elseif this.closeWhenClicked then + self:Close() + end + end + end) + local text = button:CreateFontString(nil, "ARTWORK") + button.text = text + text:SetFontObject(GameFontHighlightSmall) + button.text:SetFont(STANDARD_TEXT_FONT, UIDROPDOWNMENU_DEFAULT_TEXT_HEIGHT) + button:SetScript("OnMouseDown", function() + if not this.disabled and (this.func or this.colorFunc or this.closeWhenClicked) then + text:SetPoint("LEFT", button, "LEFT", this.notCheckable and 1 or 25, -1) + end + end) + button:SetScript("OnMouseUp", function() + if not this.disabled and (this.func or this.colorFunc or this.closeWhenClicked) then + text:SetPoint("LEFT", button, "LEFT", this.notCheckable and 0 or 24, 0) + end + end) + local arrow = button:CreateTexture(nil, "ARTWORK") + button.arrow = arrow + arrow:SetPoint("LEFT", button, "RIGHT", -16, 0) + arrow:SetWidth(16) + arrow:SetHeight(16) + arrow:SetTexture("Interface\\ChatFrame\\ChatFrameExpandArrow") + local colorSwatch = button:CreateTexture(nil, "OVERLAY") + button.colorSwatch = colorSwatch + colorSwatch:SetWidth(20) + colorSwatch:SetHeight(20) + colorSwatch:SetTexture("Interface\\ChatFrame\\ChatFrameColorSwatch") + local texture = button:CreateTexture(nil, "OVERLAY") + colorSwatch.texture = texture + texture:SetTexture(1, 1, 1) + texture:SetWidth(11.5) + texture:SetHeight(11.5) + texture:Show() + texture:SetPoint("CENTER", colorSwatch, "CENTER") + colorSwatch:SetPoint("RIGHT", button, "RIGHT", 0, 0) + else + button = buttons[table.getn(buttons)] + table.remove(buttons, table.getn(buttons)) + end + button:ClearAllPoints() + button:SetParent(level) + button:SetFrameStrata(level:GetFrameStrata()) + button:SetFrameLevel(level:GetFrameLevel() + 1) + button:SetPoint("LEFT", level, "LEFT", 10, 0) + button:SetPoint("RIGHT", level, "RIGHT", -10, 0) + if table.getn(level.buttons) == 0 then + button:SetPoint("TOP", level, "TOP", 0, -10) + else + button:SetPoint("TOP", level.buttons[table.getn(level.buttons)], "BOTTOM", 0, 0) + end + button.text:SetPoint("LEFT", button, "LEFT", 24, 0) + button:Show() + button.level = level + table.insert(level.buttons, button) + if not level.parented then + level.parented = true + level:ClearAllPoints() + if level.num == 1 then + if level.parent ~= UIParent then + level:SetPoint("TOPRIGHT", level.parent, "TOPLEFT") + else + level:SetPoint("CENTER", level.parent, "CENTER") + end + else + if level.lastDirection == "RIGHT" then + if level.lastVDirection == "DOWN" then + level:SetPoint("TOPLEFT", level.parent, "TOPRIGHT", 5, 10) + else + level:SetPoint("BOTTOMLEFT", level.parent, "BOTTOMRIGHT", 5, -10) + end + else + if level.lastVDirection == "DOWN" then + level:SetPoint("TOPRIGHT", level.parent, "TOPLEFT", -5, 10) + else + level:SetPoint("BOTTOMRIGHT", level.parent, "BOTTOMLEFT", -5, -10) + end + end + end + level:SetFrameStrata("FULLSCREEN_DIALOG") + end + button:SetAlpha(1) + return button +end + +local numLevels = 0 +local function AcquireLevel(self, level) + if not levels[level] then + for i = table.getn(levels) + 1, level, -1 do + local i = i + numLevels = numLevels + 1 + local frame = CreateFrame("Button", "Dewdrop20Level" .. numLevels, nil) + if i == 1 then + local old_CloseWindows = CloseWindows + function CloseWindows(ignoreCenter) + local found = old_CloseWindows(ignoreCenter) + if levels[1]:IsShown() then + self:Close() + return 1 + end + return found + end + end + levels[i] = frame + frame.num = i + frame:SetParent(UIParent) + frame:SetFrameStrata("FULLSCREEN_DIALOG") + frame:Hide() + frame:SetWidth(180) + frame:SetHeight(10) + frame:SetFrameLevel(i * 3) + frame:SetScript("OnHide", function() + self:Close(level + 1) + end) + if frame.SetTopLevel then + frame:SetTopLevel(true) + end + frame:EnableMouse(true) + frame:EnableMouseWheel(true) + local backdrop = CreateFrame("Frame", nil, frame) + backdrop:SetAllPoints(frame) + backdrop:SetBackdrop(tmp( + 'bgFile', "Interface\\Tooltips\\UI-Tooltip-Background", + 'edgeFile', "Interface\\Tooltips\\UI-Tooltip-Border", + 'tile', true, + 'insets', tmp2( + 'left', 5, + 'right', 5, + 'top', 5, + 'bottom', 5 + ), + 'tileSize', 16, + 'edgeSize', 16 + )) + backdrop:SetBackdropBorderColor(TOOLTIP_DEFAULT_COLOR.r, TOOLTIP_DEFAULT_COLOR.g, TOOLTIP_DEFAULT_COLOR.b) + backdrop:SetBackdropColor(TOOLTIP_DEFAULT_BACKGROUND_COLOR.r, TOOLTIP_DEFAULT_BACKGROUND_COLOR.g, TOOLTIP_DEFAULT_BACKGROUND_COLOR.b) + frame:SetScript("OnClick", function() + self:Close(i) + end) + frame:SetScript("OnEnter", function() + StopCounting(self, i) + end) + frame:SetScript("OnLeave", function() + StartCounting(self, i) + end) + frame:SetScript("OnMouseWheel", function() + Scroll(self, frame, arg1 < 0) + end) + if i == 1 then + frame:SetScript("OnUpdate", function() + OnUpdate(self, arg1) + end) + levels[1].lastDirection = "RIGHT" + levels[1].lastVDirection = "DOWN" + else + levels[i].lastDirection = levels[i - 1].lastDirection + levels[i].lastVDirection = levels[i - 1].lastVDirection + end + end + end + local fullscreenFrame = GetFullScreenFrame() + local l = levels[level] + local strata, framelevel = l:GetFrameStrata(), l:GetFrameLevel() + if fullscreenFrame then + l:SetParent(fullscreenFrame) + else + l:SetParent(UIParent) + end + l:SetFrameStrata(strata) + l:SetFrameLevel(framelevel) + l:SetAlpha(1) + return l +end + +local function checkValidate(validateFunc, func, arg1, arg2, arg3) + local text + if arg3 ~= nil then + text = arg3 + elseif arg2 ~= nil then + text = arg2 + else + text = arg1 + end + if not validateFunc(text) then + DEFAULT_CHAT_FRAME:AddMessage("|cffffff7fValidation error: [|r" .. tostring(text) .. "|cffffff7f]|r") + else + func(arg1, arg2, arg3) + end +end + +local function validateOptions(options, position, baseOptions, fromPass) + if not baseOptions then + baseOptions = options + end + if type(options) ~= "table" then + return "Options must be a table.", position + end + local kind = options.type + if type(kind) ~= "string" then + return '"type" must be a string.', position + elseif kind ~= "group" and kind ~= "range" and kind ~= "text" and kind ~= "execute" and kind ~= "toggle" and kind ~= "color" and kind ~= "header" then + return '"type" must either be "range", "text", "group", "toggle", "execute", "color", or "header".', position + end + if options.aliases then + if type(options.aliases) ~= "table" and type(options.aliases) ~= "string" then + return '"alias" must be a table or string', position + end + end + if not fromPass then + if kind == "execute" then + if type(options.func) ~= "string" and type(options.func) ~= "function" then + return '"func" must be a string or function', position + end + elseif kind == "range" or kind == "text" or kind == "toggle" then + if type(options.set) ~= "string" and type(options.set) ~= "function" then + return '"set" must be a string or function', position + end + if kind == "text" and options.get == false then + elseif type(options.get) ~= "string" and type(options.get) ~= "function" then + return '"get" must be a string or function', position + end + elseif kind == "group" and options.pass then + if options.pass ~= true then + return '"pass" must be either nil, true, or false', position + end + if not options.func then + if type(options.set) ~= "string" and type(options.set) ~= "function" then + return '"set" must be a string or function', position + end + if type(options.get) ~= "string" and type(options.get) ~= "function" then + return '"get" must be a string or function', position + end + elseif type(options.func) ~= "string" and type(options.func) ~= "function" then + return '"func" must be a string or function', position + end + end + else + if kind == "group" then + return 'cannot have "type" = "group" as a subgroup of a passing group', position + end + end + if options ~= baseOptions then + if kind == "header" then + elseif type(options.desc) ~= "string" then + return '"desc" must be a string', position + elseif string.len(options.desc) == 0 then + return '"desc" cannot be a 0-length string', position + end + end + if options ~= baseOptions or kind == "range" or kind == "text" or kind == "toggle" or kind == "color" then + if options.type == "header" and not options.cmdName and not options.name then + elseif options.cmdName then + if type(options.cmdName) ~= "string" then + return '"cmdName" must be a string or nil', position + elseif string.len(options.cmdName) == 0 then + return '"cmdName" cannot be a 0-length string', position + end + if type(options.guiName) ~= "string" then + if not options.guiNameIsMap then + return '"guiName" must be a string or nil', position + end + elseif string.len(options.guiName) == 0 then + return '"guiName" cannot be a 0-length string', position + end + else + if type(options.name) ~= "string" then + return '"name" must be a string', position + elseif string.len(options.name) == 0 then + return '"name" cannot be a 0-length string', position + end + end + end + if options.guiNameIsMap then + if type(options.guiNameIsMap) ~= "boolean" then + return '"guiNameIsMap" must be a boolean or nil', position + elseif options.type ~= "toggle" then + return 'if "guiNameIsMap" is true, then "type" must be set to \'toggle\'', position + elseif type(options.map) ~= "table" then + return '"map" must be a table', position + end + end + if options.message and type(options.message) ~= "string" then + return '"message" must be a string or nil', position + end + if options.error and type(options.error) ~= "string" then + return '"error" must be a string or nil', position + end + if options.current and type(options.current) ~= "string" then + return '"current" must be a string or nil', position + end + if options.order then + if type(options.order) ~= "number" or (-1 < options.order and options.order < 0.999) then + return '"order" must be a non-zero number or nil', position + end + end + if options.disabled then + if type(options.disabled) ~= "function" and type(options.disabled) ~= "string" and options.disabled ~= true then + return '"disabled" must be a function, string, or boolean', position + end + end + if options.cmdHidden then + if type(options.cmdHidden) ~= "function" and type(options.cmdHidden) ~= "string" and options.cmdHidden ~= true then + return '"cmdHidden" must be a function, string, or boolean', position + end + end + if options.guiHidden then + if type(options.guiHidden) ~= "function" and type(options.guiHidden) ~= "string" and options.guiHidden ~= true then + return '"guiHidden" must be a function, string, or boolean', position + end + end + if options.hidden then + if type(options.hidden) ~= "function" and type(options.hidden) ~= "string" and options.hidden ~= true then + return '"hidden" must be a function, string, or boolean', position + end + end + if kind == "text" then + if type(options.validate) == "table" then + local t = options.validate + local iTable = nil + for k,v in pairs(t) do + if type(k) == "number" then + if iTable == nil then + iTable = true + elseif not iTable then + return '"validate" must either have all keys be indexed numbers or strings', position + elseif k < 1 or k > table.getn(t) then + return '"validate" numeric keys must be indexed properly. >= 1 and <= table.getn', position + end + else + if iTable == nil then + iTable = false + elseif iTable then + return '"validate" must either have all keys be indexed numbers or strings', position + end + end + if type(v) ~= "string" then + return '"validate" values must all be strings', position + end + end + else + if type(options.usage) ~= "string" then + return '"usage" must be a string', position + elseif options.validate and type(options.validate) ~= "string" and type(options.validate) ~= "function" then + return '"validate" must be a string, function, or table', position + end + end + elseif kind == "range" then + if options.min or options.max then + if type(options.min) ~= "number" then + return '"min" must be a number', position + elseif type(options.max) ~= "number" then + return '"max" must be a number', position + elseif options.min >= options.max then + return '"min" must be less than "max"', position + end + end + if options.step then + if type(options.step) ~= "number" then + return '"step" must be a number', position + elseif options.step < 0 then + return '"step" must be nonnegative', position + end + end + if options.isPercent and options.isPercent ~= true then + return '"isPercent" must either be nil, true, or false', position + end + elseif kind == "toggle" then + if options.map then + if type(options.map) ~= "table" then + return '"map" must be a table', position + elseif type(options.map[true]) ~= "string" then + return '"map[true]" must be a string', position + elseif type(options.map[false]) ~= "string" then + return '"map[false]" must be a string', position + end + end + elseif kind == "color" then + if options.hasAlpha and options.hasAlpha ~= true then + return '"hasAlpha" must be nil, true, or false', position + end + elseif kind == "group" then + if options.pass and options.pass ~= true then + return '"pass" must be nil, true, or false', position + end + if type(options.args) ~= "table" then + return '"args" must be a table', position + end + for k,v in pairs(options.args) do + if type(k) ~= "string" then + return '"args" keys must be strings', position + elseif string.find(k, "%s") then + return string.format('"args" keys must not include spaces. %q is not appropriate.', k), position + elseif string.len(k) == 0 then + return '"args" keys must not be 0-length strings.', position + end + if type(v) ~= "table" then + return '"args" values must be tables', position and position .. "." .. k or k + end + local newposition + if position then + newposition = position .. ".args." .. k + else + newposition = "args." .. k + end + local err, pos = validateOptions(v, newposition, baseOptions, options.pass) + if err then + return err, pos + end + end + end + if options.icon and type(options.icon) ~= "string" then + return'"icon" must be a string', position + end + if options.iconWidth or options.iconHeight then + if type(options.iconWidth) ~= "number" or type(options.iconHeight) ~= "number" then + return '"iconHeight" and "iconWidth" must be numbers', position + end + end + if options.iconCoordLeft or options.iconCoordRight or options.iconCoordTop or options.iconCoordBottom then + if type(options.iconCoordLeft) ~= "number" or type(options.iconCoordRight) ~= "number" or type(options.iconCoordTop) ~= "number" or type(options.iconCoordBottom) ~= "number" then + return '"iconCoordLeft", "iconCoordRight", "iconCoordTop", and "iconCoordBottom" must be numbers', position + end + end +end + +local validatedOptions + +local values +local mysort_args +local mysort +local othersort +local othersort_validate + +local baseFunc, currentLevel + +function Dewdrop:FeedAceOptionsTable(options, difference) + self:argCheck(options, 2, "table") + self:argCheck(difference, 3, "nil", "number") + self:assert(currentLevel, "Cannot call `FeedAceOptionsTable' outside of a Dewdrop declaration") + if not difference then + difference = 0 + end + if not validatedOptions then + validatedOptions = {} + end + if not validatedOptions[options] then + local err, position = validateOptions(options) + + if err then + if position then + Dewdrop:error(position .. ": " .. err) + else + Dewdrop:error(err) + end + end + + validatedOptions[options] = true + end + local level = levels[currentLevel] + self:assert(level, "Improper level given") + if not values then + values = {} + else + for k,v in pairs(values) do + values[k] = nil + end + table_setn(values, 0) + end + + local current = level + while current do + if current.num == difference + 1 then + break + end + table.insert(values, current.value) + current = levels[current.num - 1] + end + + local realOptions = options + local handler = options.handler + local passTable + local passValue + while table.getn(values) > 0 do + passTable = options.pass and current or nil + local value = table.remove(values) + options = options.args and options.args[value] + if not options then + return + end + handler = options.handler or handler + passValue = passTable and value or nil + end + + if options.type == "group" then + for k in pairs(options.args) do + table.insert(values, k) + end + if not mysort then + mysort = function(a, b) + local alpha, bravo = mysort_args[a], mysort_args[b] + local alpha_order = alpha.order or 100 + local bravo_order = bravo.order or 100 + local alpha_name = alpha.guiName or alpha.name + local bravo_name = bravo.guiName or bravo.name + if alpha_order == bravo_order then + if not alpha_name then + return true + elseif not bravo_name then + return false + else + return string.upper(alpha_name) < string.upper(bravo_name) + end + else + if alpha_order < 0 then + if bravo_order > 0 then + return false + end + else + if bravo_order < 0 then + return true + end + end + return alpha_order < bravo_order + end + end + end + mysort_args = options.args + table.sort(values, mysort) + mysort_args = nil + local hasBoth = table.getn(values) >= 1 and (options.args[values[1]].order or 100) > 0 and (options.args[values[table.getn(values)]].order or 100) < 0 + local last_order = 1 + for _,k in ipairs(values) do + local v = options.args[k] + local handler = v.handler or handler + if hasBoth and last_order > 0 and (v.order or 100) < 0 then + hasBoth = false + self:AddLine() + end + local hidden, disabled = v.guiHidden or v.hidden, v.disabled + if type(hidden) == "function" then + hidden = hidden() + elseif type(hidden) == "string" then + hidden = handler[hidden](handler) + end + if not hidden then + if type(disabled) == "function" then + disabled = disabled() + elseif type(disabled) == "string" then + disabled = handler[disabled](handler) + end + local name = (v.guiIconOnly and v.icon) and "" or (v.guiName or v.name) + local desc = v.desc + local iconHeight = v.iconHeight or 16 + local iconWidth = v.iconWidth or 16 + local iconCoordLeft = v.iconCoordLeft or 0 + local iconCoordRight = v.iconCoordRight or 1 + local iconCoordBottom = v.iconCoordBottom or 0 + local iconCoordTop = v.iconCoordTop or 1 + local tooltipTitle, tooltipText + tooltipTitle = name + if name ~= desc then + tooltipText = desc + end + if v.type == "toggle" then + local checked + if type(v.get) == "function" then + checked = v.get(passValue) + else + if not handler[v.get] then + Dewdrop:error("Handler %q not available", v.get) + end + checked = handler[v.get](handler, passValue) + end + local func, arg1, arg2, arg3 + if type(v.set) == "function" then + func = v.set + if passValue ~= nil then + arg1 = passValue + arg2 = not checked + else + arg1 = not checked + end + else + if not handler[v.set] then + Dewdrop:error("Handler %q not available", v.set) + end + func = handler[v.set] + arg1 = handler + if passValue ~= nil then + arg2 = passValue + arg3 = not checked + else + arg2 = not checked + end + end + if v.guiNameIsMap then + checked = checked and true or false + name = string.gsub(tostring(v.map and v.map[checked]), "|c%x%x%x%x%x%x%x%x(.-)|r", "%1") + checked = nil + end + self:AddLine( + 'text', name, + 'checked', checked, + 'isRadio', v.isRadio, + 'func', func, + 'arg1', arg1, + 'arg2', arg2, + 'arg3', arg3, + 'disabled', disabled, + 'tooltipTitle', tooltipTitle, + 'tooltipText', tooltipText + ) + elseif v.type == "execute" then + local func, arg1, arg2 + if type(v.func) == "function" then + func = v.func + arg1 = passValue + else + if not handler[v.func] then + Dewdrop:error("Handler %q not available", v.func) + end + func = handler[v.func] + arg1 = handler + arg2 = passValue + end + self:AddLine( + 'text', name, + 'checked', checked, + 'func', func, + 'arg1', arg1, + 'arg2', arg2, + 'disabled', disabled, + 'tooltipTitle', tooltipTitle, + 'tooltipText', tooltipText, + 'icon', v.icon, + 'iconHeight', iconHeight, + 'iconWidth', iconWidth, + 'iconCoordLeft', iconCoordLeft, + 'iconCoordRight', iconCoordRight, + 'iconCoordTop', iconCoordTop, + 'iconCoordBottom', iconCoordBottom + ) + elseif v.type == "range" then + local sliderValue + if type(v.get) == "function" then + sliderValue = v.get(passValue) + else + if not handler[v.get] then + Dewdrop:error("Handler %q not available", v.get) + end + sliderValue = handler[v.get](handler, passValue) + end + local sliderFunc, sliderArg1, sliderArg2 + if type(v.set) == "function" then + sliderFunc = v.set + sliderArg1 = passValue + else + if not handler[v.set] then + Dewdrop:error("Handler %q not available", v.set) + end + sliderFunc = handler[v.set] + sliderArg1 = handler + sliderArg2 = passValue + end + self:AddLine( + 'text', name, + 'hasArrow', true, + 'hasSlider', true, + 'sliderMin', v.min or 0, + 'sliderMax', v.max or 1, + 'sliderStep', v.step or 0, + 'sliderIsPercent', v.isPercent or false, + 'sliderValue', sliderValue, + 'sliderFunc', sliderFunc, + 'sliderArg1', sliderArg1, + 'sliderArg2', sliderArg2, + 'disabled', disabled, + 'tooltipTitle', tooltipTitle, + 'tooltipText', tooltipText, + 'icon', v.icon, + 'iconHeight', iconHeight, + 'iconWidth', iconWidth, + 'iconCoordLeft', iconCoordLeft, + 'iconCoordRight', iconCoordRight, + 'iconCoordTop', iconCoordTop, + 'iconCoordBottom', iconCoordBottom + ) + elseif v.type == "color" then + local r,g,b,a + if type(v.get) == "function" then + r,g,b,a = v.get(passValue) + else + if not handler[v.get] then + Dewdrop:error("Handler %q not available", v.get) + end + r,g,b,a = handler[v.get](handler, passValue) + end + local colorFunc, colorArg1, colorArg2 + if type(v.set) == "function" then + colorFunc = v.set + colorArg1 = passValue + else + if not handler[v.set] then + Dewdrop:error("Handler %q not available", v.set) + end + colorFunc = handler[v.set] + colorArg1 = handler + colorArg2 = passValue + end + self:AddLine( + 'text', name, + 'hasArrow', true, + 'hasColorSwatch', true, + 'r', r, + 'g', g, + 'b', b, + 'opacity', v.hasAlpha and a or nil, + 'hasOpacity', v.hasAlpha, + 'colorFunc', colorFunc, + 'colorArg1', colorArg1, + 'colorArg2', colorArg2, + 'disabled', disabled, + 'tooltipTitle', tooltipTitle, + 'tooltipText', tooltipText + ) + elseif v.type == "text" then + if type(v.validate) == "table" then + self:AddLine( + 'text', name, + 'hasArrow', true, + 'value', k, + 'disabled', disabled, + 'tooltipTitle', tooltipTitle, + 'tooltipText', tooltipText, + 'icon', v.icon, + 'iconHeight', iconHeight, + 'iconWidth', iconWidth, + 'iconCoordLeft', iconCoordLeft, + 'iconCoordRight', iconCoordRight, + 'iconCoordTop', iconCoordTop, + 'iconCoordBottom', iconCoordBottom + ) + else + local editBoxText + if type(v.get) == "function" then + editBoxText = v.get(passValue) + elseif v.get == false then + editBoxText = nil + else + if not handler[v.get] then + Dewdrop:error("Handler %q not available", v.get) + end + editBoxText = handler[v.get](handler, passValue) + end + local editBoxFunc, editBoxArg1, editBoxArg2 + if type(v.set) == "function" then + editBoxFunc = v.set + editBoxArg1 = passValue + else + if not handler[v.set] then + Dewdrop:error("Handler %q not available", v.set) + end + editBoxFunc = handler[v.set] + editBoxArg1 = handler + editBoxArg2 = passValue + end + + local editBoxValidateFunc, editBoxValidateArg1 + + if v.validate then + if type(v.validate) == "function" then + editBoxValidateFunc = v.validate + else + if not handler[v.validate] then + Dewdrop:error("Handler %q not available", v.validate) + end + editBoxValidateFunc = handler[v.validate] + editBoxValidateArg1 = handler + end + end + + self:AddLine( + 'text', name, + 'hasArrow', true, + 'icon', v.icon, + 'iconHeight', iconHeight, + 'iconWidth', iconWidth, + 'iconCoordLeft', iconCoordLeft, + 'iconCoordRight', iconCoordRight, + 'iconCoordTop', iconCoordTop, + 'iconCoordBottom', iconCoordBottom, + 'hasEditBox', true, + 'editBoxText', editBoxText, + 'editBoxFunc', editBoxFunc, + 'editBoxArg1', editBoxArg1, + 'editBoxArg2', editBoxArg2, + 'editBoxValidateFunc', editBoxValidateFunc, + 'editBoxValidateArg1', editBoxValidateArg1, + 'disabled', disabled, + 'tooltipTitle', tooltipTitle, + 'tooltipText', tooltipText + ) + end + elseif v.type == "group" then + self:AddLine( + 'text', name, + 'hasArrow', true, + 'value', k, + 'disabled', disabled, + 'tooltipTitle', tooltipTitle, + 'tooltipText', tooltipText, + 'icon', v.icon, + 'iconHeight', iconHeight, + 'iconWidth', iconWidth, + 'iconCoordLeft', iconCoordLeft, + 'iconCoordRight', iconCoordRight, + 'iconCoordTop', iconCoordTop, + 'iconCoordBottom', iconCoordBottom + ) + elseif v.type == "header" then + if name == "" or not name then + self:AddLine( + 'isTitle', true, + 'icon', v.icon, + 'iconHeight', iconHeight, + 'iconWidth', iconWidth, + 'iconCoordLeft', iconCoordLeft, + 'iconCoordRight', iconCoordRight, + 'iconCoordTop', iconCoordTop, + 'iconCoordBottom', iconCoordBottom + ) + else + self:AddLine( + 'text', name, + 'isTitle', true, + 'icon', v.icon, + 'iconHeight', iconHeight, + 'iconWidth', iconWidth, + 'iconCoordLeft', iconCoordLeft, + 'iconCoordRight', iconCoordRight, + 'iconCoordTop', iconCoordTop, + 'iconCoordBottom', iconCoordBottom + ) + end + end + end + last_order = v.order or 100 + end + elseif options.type == "text" and type(options.validate) == "table" then + local current + if type(options.get) == "function" then + current = options.get(passValue) + elseif options.get ~= false then + if not handler[options.get] then + Dewdrop:error("Handler %q not available", options.get) + end + current = handler[options.get](handler, passValue) + end + local indexed = true + for k,v in pairs(options.validate) do + if type(k) ~= "number" then + indexed = false + end + table.insert(values, k) + end + if not indexed then + if not othersort then + othersort = function(alpha, bravo) + return othersort_validate[alpha] < othersort_validate[bravo] + end + end + othersort_validate = options.validate + table.sort(values, othersort) + othersort_validate = nil + end + for _,k in ipairs(values) do + local v = options.validate[k] + if type(k) == "number" then + k = v + end + local func, arg1, arg2 + if type(options.set) == "function" then + func = options.set + if passValue ~= nil then + arg1 = passValue + arg2 = k + else + arg1 = k + end + else + if not handler[options.set] then + Dewdrop:error("Handler %q not available", options.set) + end + func = handler[options.set] + arg1 = handler + if passValue ~= nil then + arg2 = passValue + arg3 = k + else + arg2 = k + end + end + local checked = (k == current or (type(k) == "string" and type(current) == "string" and string.lower(k) == string.lower(current))) + self:AddLine( + 'text', v, + 'func', not checked and func or nil, + 'arg1', not checked and arg1 or nil, + 'arg2', not checked and arg2 or nil, + 'arg3', not checked and arg3 or nil, + 'isRadio', true, + 'checked', checked, + 'tooltipTitle', options.guiName or options.name, + 'tooltipText', v + ) + end + for k in pairs(values) do + values[k] = nil + end + table_setn(values, 0) + else + return false + end + return true +end + +function Refresh(self, level) + if type(level) == "number" then + level = levels[level] + end + if not level then + return + end + if baseFunc then + Clear(self, level) + currentLevel = level.num + if type(baseFunc) == "table" then + if currentLevel == 1 then + local handler = baseFunc.handler + if handler then + local name = tostring(handler) + if not string.find(name, '^table:') then + name = string.gsub(name, "|c%x%x%x%x%x%x%x%x(.-)|r", "%1") + self:AddLine( + 'text', name, + 'isTitle', true + ) + end + end +-- elseif level.parentText then +-- self:AddLine( +-- 'text', level.parentText, +-- 'tooltipTitle', level.parentTooltipTitle, +-- 'tooltipText', level.parentTooltipText, +-- 'tooltipFunc', level.parentTooltipFunc, +-- 'isTitle', true +-- ) + end + self:FeedAceOptionsTable(baseFunc) + if currentLevel == 1 then + self:AddLine( + 'text', CLOSE, + 'closeWhenClicked', true + ) + end + else +-- if level.parentText then +-- self:AddLine( +-- 'text', level.parentText, +-- 'tooltipTitle', level.parentTooltipTitle, +-- 'tooltipText', level.parentTooltipText, +-- 'tooltipFunc', level.parentTooltipFunc, +-- 'isTitle', true +-- ) +-- end + baseFunc(currentLevel, level.value, levels[level.num - 1] and levels[level.num - 1].value, levels[level.num - 2] and levels[level.num - 2].value, levels[level.num - 3] and levels[level.num - 3].value, levels[level.num - 4] and levels[level.num - 4].value) + end + currentLevel = nil + CheckSize(self, level) + end +end + +function Dewdrop:Refresh(level) + self:argCheck(level, 2, "number") + Refresh(self, levels[level]) +end + +function OpenSlider(self, parent) + if not sliderFrame then + sliderFrame = CreateFrame("Frame", nil, nil) + sliderFrame:SetWidth(80) + sliderFrame:SetHeight(170) + sliderFrame:SetScale(UIParent:GetScale()) + sliderFrame:SetBackdrop(tmp( + 'bgFile', "Interface\\Tooltips\\UI-Tooltip-Background", + 'edgeFile', "Interface\\Tooltips\\UI-Tooltip-Border", + 'tile', true, + 'insets', tmp2( + 'left', 5, + 'right', 5, + 'top', 5, + 'bottom', 5 + ), + 'tileSize', 16, + 'edgeSize', 16 + )) + sliderFrame:SetFrameStrata("FULLSCREEN_DIALOG") + if sliderFrame.SetTopLevel then + sliderFrame:SetTopLevel(true) + end + sliderFrame:SetBackdropBorderColor(TOOLTIP_DEFAULT_COLOR.r, TOOLTIP_DEFAULT_COLOR.g, TOOLTIP_DEFAULT_COLOR.b) + sliderFrame:SetBackdropColor(TOOLTIP_DEFAULT_BACKGROUND_COLOR.r, TOOLTIP_DEFAULT_BACKGROUND_COLOR.g, TOOLTIP_DEFAULT_BACKGROUND_COLOR.b) + sliderFrame:EnableMouse(true) + sliderFrame:Hide() + sliderFrame:SetPoint("CENTER", UIParent, "CENTER") + local slider = CreateFrame("Slider", nil, sliderFrame) + sliderFrame.slider = slider + slider:SetOrientation("VERTICAL") + slider:SetMinMaxValues(0, 1) + slider:SetValueStep(0.01) + slider:SetValue(0.5) + slider:SetWidth(16) + slider:SetHeight(128) + slider:SetPoint("LEFT", sliderFrame, "LEFT", 15, 0) + slider:SetBackdrop(tmp( + 'bgFile', "Interface\\Buttons\\UI-SliderBar-Background", + 'edgeFile', "Interface\\Buttons\\UI-SliderBar-Border", + 'tile', true, + 'edgeSize', 8, + 'tileSize', 8, + 'insets', tmp2( + 'left', 3, + 'right', 3, + 'top', 3, + 'bottom', 3 + ) + )) + local texture = slider:CreateTexture() + slider:SetThumbTexture("Interface\\Buttons\\UI-SliderBar-Button-Vertical") + local text = slider:CreateFontString(nil, "ARTWORK") + sliderFrame.topText = text + text:SetFontObject(GameFontGreenSmall) + text:SetText("100%") + text:SetPoint("BOTTOM", slider, "TOP") + local text = slider:CreateFontString(nil, "ARTWORK") + sliderFrame.bottomText = text + text:SetFontObject(GameFontGreenSmall) + text:SetText("0%") + text:SetPoint("TOP", slider, "BOTTOM") + local text = slider:CreateFontString(nil, "ARTWORK") + sliderFrame.currentText = text + text:SetFontObject(GameFontHighlightSmall) + text:SetText("50%") + text:SetPoint("LEFT", slider, "RIGHT") + text:SetPoint("RIGHT", sliderFrame, "RIGHT", -6, 0) + text:SetJustifyH("CENTER") + local changed = false + local inside = false + slider:SetScript("OnValueChanged", function() + if sliderFrame.changing then + return + end + changed = true + local done = false + if sliderFrame.parent then + if sliderFrame.parent.sliderFunc then + local min = sliderFrame.parent.sliderMin or 0 + local max = sliderFrame.parent.sliderMax or 1 + local step = sliderFrame.parent.sliderStep or (max - min) / 100 + local a1,a2,a3,a4 = sliderFrame.parent.sliderArg1, sliderFrame.parent.sliderArg2, sliderFrame.parent.sliderArg3, sliderFrame.parent.sliderArg4 + local value = (1 - slider:GetValue()) * (max - min) + min + if step > 0 then + value = math.floor((value - min) / step + 0.5) * step + min + if value > max then + value = max + elseif value < min then + value = min + end + end + local text + if a1 == nil then + text = sliderFrame.parent.sliderFunc(value) + elseif a2 == nil then + text = sliderFrame.parent.sliderFunc(a1, value) + elseif a3 == nil then + text = sliderFrame.parent.sliderFunc(a1, a2, value) + elseif a4 == nil then + text = sliderFrame.parent.sliderFunc(a1, a2, a3, value) + else + text = sliderFrame.parent.sliderFunc(a1, a2, a3, a4, value) + end + if text then + sliderFrame.currentText:SetText(text) + done = true + end + end + end + if not done then + local min = sliderFrame.parent.sliderMin or 0 + local max = sliderFrame.parent.sliderMax or 1 + local step = sliderFrame.parent.sliderStep or (max - min) / 100 + local value = (1 - slider:GetValue()) * (max - min) + min + if step > 0 then + value = math.floor((value - min) / step + 0.5) * step + min + if value > max then + value = max + elseif value < min then + value = min + end + end + if sliderFrame.parent.sliderIsPercent then + sliderFrame.currentText:SetText(string.format("%.0f%%", value * 100)) + else + if step < 0.1 then + sliderFrame.currentText:SetText(string.format("%.2f", value)) + elseif step < 1 then + sliderFrame.currentText:SetText(string.format("%.1f", value)) + else + sliderFrame.currentText:SetText(string.format("%.0f", value)) + end + end + end + end) + sliderFrame:SetScript("OnEnter", function() + StopCounting(self, sliderFrame.level) + end) + sliderFrame:SetScript("OnLeave", function() + StartCounting(self, sliderFrame.level) + end) + slider:SetScript("OnMouseDown", function() + sliderFrame.mouseDown = true + end) + slider:SetScript("OnMouseUp", function() + sliderFrame.mouseDown = false + if changed and not inside then + local parent = sliderFrame.parent + for i = 1, sliderFrame.level - 1 do + Refresh(self, levels[i]) + end + OpenSlider(self, parent) + end + end) + slider:SetScript("OnEnter", function() + inside = true + StopCounting(self, sliderFrame.level) + end) + slider:SetScript("OnLeave", function() + inside = false + StartCounting(self, sliderFrame.level) + if changed and not sliderFrame.mouseDown then + local parent = sliderFrame.parent + for i = 1, sliderFrame.level - 1 do + Refresh(self, levels[i]) + end + OpenSlider(self, parent) + end + end) + end + sliderFrame.parent = parent + sliderFrame.level = parent.level.num + 1 + sliderFrame.parentValue = parent.level.value + sliderFrame:SetFrameLevel(parent.level:GetFrameLevel() + 3) + sliderFrame.slider:SetFrameLevel(sliderFrame:GetFrameLevel() + 1) + sliderFrame.changing = true + if not parent.sliderMin or not parent.sliderMax then + return + end + + if parent.arrow then +-- parent.arrow:SetVertexColor(0.2, 0.6, 0) + parent.arrow:SetHeight(24) + parent.arrow:SetWidth(24) + end + + if not parent.sliderValue then + parent.sliderValue = (parent.sliderMin + parent.sliderMax) / 2 + end + sliderFrame.slider:SetValue(1 - (parent.sliderValue - parent.sliderMin) / (parent.sliderMax - parent.sliderMin)) + sliderFrame.changing = false + sliderFrame.bottomText:SetText(parent.sliderMinText or "0") + sliderFrame.topText:SetText(parent.sliderMaxText or "1") + local text + if parent.sliderFunc then + local a1,a2,a3,a4 = parent.sliderArg1, parent.sliderArg2, parent.sliderArg3, parent.sliderArg4 + if a1 == nil then + text = parent.sliderFunc(parent.sliderValue) + elseif a2 == nil then + text = parent.sliderFunc(a1, parent.sliderValue) + elseif a3 == nil then + text = parent.sliderFunc(a1, a2, parent.sliderValue) + elseif a4 == nil then + text = parent.sliderFunc(a1, a2, a3, parent.sliderValue) + else + text = parent.sliderFunc(a1, a2, a3, a4, parent.sliderValue) + end + end + if text then + sliderFrame.currentText:SetText(text) + elseif parent.sliderIsPercent then + sliderFrame.currentText:SetText(string.format("%.0f%%", parent.sliderValue * 100)) + else + sliderFrame.currentText:SetText(parent.sliderValue) + end + + local level = parent.level + sliderFrame:Show() + sliderFrame:ClearAllPoints() + if level.lastDirection == "RIGHT" then + if level.lastVDirection == "DOWN" then + sliderFrame:SetPoint("TOPLEFT", parent, "TOPRIGHT", 5, 10) + else + sliderFrame:SetPoint("BOTTOMLEFT", parent, "BOTTOMRIGHT", 5, -10) + end + else + if level.lastVDirection == "DOWN" then + sliderFrame:SetPoint("TOPRIGHT", parent, "TOPLEFT", -5, 10) + else + sliderFrame:SetPoint("BOTTOMRIGHT", parent, "BOTTOMLEFT", -5, -10) + end + end + local dirty + if level.lastDirection == "RIGHT" then + if sliderFrame:GetRight() > GetScreenWidth() then + level.lastDirection = "LEFT" + dirty = true + end + elseif sliderFrame:GetLeft() < 0 then + level.lastDirection = "RIGHT" + dirty = true + end + if level.lastVDirection == "DOWN" then + if sliderFrame:GetBottom() < 0 then + level.lastVDirection = "UP" + dirty = true + end + elseif sliderFrame:GetTop() > GetScreenWidth() then + level.lastVDirection = "DOWN" + dirty = true + end + if dirty then + sliderFrame:ClearAllPoints() + if level.lastDirection == "RIGHT" then + if level.lastVDirection == "DOWN" then + sliderFrame:SetPoint("TOPLEFT", parent, "TOPRIGHT", 5, 10) + else + sliderFrame:SetPoint("BOTTOMLEFT", parent, "BOTTOMRIGHT", 5, -10) + end + else + if level.lastVDirection == "DOWN" then + sliderFrame:SetPoint("TOPRIGHT", parent, "TOPLEFT", -5, 10) + else + sliderFrame:SetPoint("BOTTOMRIGHT", parent, "BOTTOMLEFT", -5, -10) + end + end + end + local left, bottom = sliderFrame:GetLeft(), sliderFrame:GetBottom() + sliderFrame:ClearAllPoints() + sliderFrame:SetPoint("BOTTOMLEFT", UIParent, "BOTTOMLEFT", left, bottom) + if mod(level.num, 5) == 0 then + local left, bottom = level:GetLeft(), level:GetBottom() + level:ClearAllPoints() + level:SetPoint("BOTTOMLEFT", UIParent, "BOTTOMLEFT", left, bottom) + end +end + +function OpenEditBox(self, parent) + if not editBoxFrame then + editBoxFrame = CreateFrame("Frame", nil, nil) + editBoxFrame:SetWidth(200) + editBoxFrame:SetHeight(40) + editBoxFrame:SetScale(UIParent:GetScale()) + editBoxFrame:SetBackdrop(tmp( + 'bgFile', "Interface\\Tooltips\\UI-Tooltip-Background", + 'edgeFile', "Interface\\Tooltips\\UI-Tooltip-Border", + 'tile', true, + 'insets', tmp2( + 'left', 5, + 'right', 5, + 'top', 5, + 'bottom', 5 + ), + 'tileSize', 16, + 'edgeSize', 16 + )) + editBoxFrame:SetFrameStrata("FULLSCREEN_DIALOG") + if editBoxFrame.SetTopLevel then + editBoxFrame:SetTopLevel(true) + end + editBoxFrame:SetBackdropBorderColor(TOOLTIP_DEFAULT_COLOR.r, TOOLTIP_DEFAULT_COLOR.g, TOOLTIP_DEFAULT_COLOR.b) + editBoxFrame:SetBackdropColor(TOOLTIP_DEFAULT_BACKGROUND_COLOR.r, TOOLTIP_DEFAULT_BACKGROUND_COLOR.g, TOOLTIP_DEFAULT_BACKGROUND_COLOR.b) + editBoxFrame:EnableMouse(true) + editBoxFrame:Hide() + editBoxFrame:SetPoint("CENTER", UIParent, "CENTER") + + local editBox = CreateFrame("EditBox", nil, editBoxFrame) + editBoxFrame.editBox = editBox + editBox:SetFontObject(ChatFontNormal) + editBox:SetWidth(160) + editBox:SetHeight(13) + editBox:SetPoint("CENTER", editBoxFrame, "CENTER", 0, 0) + + local left = editBox:CreateTexture(nil, "BACKGROUND") + left:SetTexture("Interface\\ChatFrame\\UI-ChatInputBorder-Left") + left:SetTexCoord(0, 100 / 256, 0, 1) + left:SetWidth(100) + left:SetHeight(32) + left:SetPoint("LEFT", editBox, "LEFT", -10, 0) + local right = editBox:CreateTexture(nil, "BACKGROUND") + right:SetTexture("Interface\\ChatFrame\\UI-ChatInputBorder-Right") + right:SetTexCoord(156/256, 1, 0, 1) + right:SetWidth(100) + right:SetHeight(32) + right:SetPoint("RIGHT", editBox, "RIGHT", 10, 0) + + editBox:SetScript("OnEnterPressed", function() + if editBoxFrame.parent and editBoxFrame.parent.editBoxValidateFunc then + local a1,a2,a3,a4 = editBoxFrame.parent.editBoxValidateArg1, editBoxFrame.parent.editBoxValidateArg2, editBoxFrame.parent.editBoxValidateArg3, editBoxFrame.parent.editBoxValidateArg4 + + local result + if a1 == nil then + result = editBoxFrame.parent.editBoxValidateFunc(editBox:GetText() or "") + elseif a2 == nil then + result = editBoxFrame.parent.editBoxValidateFunc(a1, editBox:GetText() or "") + elseif a3 == nil then + result = editBoxFrame.parent.editBoxValidateFunc(a1, a2, editBox:GetText() or "") + elseif a4 == nil then + result = editBoxFrame.parent.editBoxValidateFunc(a1, a2, a3, editBox:GetText() or "") + else + result = editBoxFrame.parent.editBoxValidateFunc(a1, a2, a3, a4, editBox:GetText() or "") + end + if not result then + message("Validation error: [" .. tostring(text) .. "]") + return + end + end + if editBoxFrame.parent and editBoxFrame.parent.editBoxFunc then + local a1,a2,a3,a4 = editBoxFrame.parent.editBoxArg1, editBoxFrame.parent.editBoxArg2, editBoxFrame.parent.editBoxArg3, editBoxFrame.parent.editBoxArg4 + if a1 == nil then + editBoxFrame.parent.editBoxFunc(editBox:GetText() or "") + elseif a2 == nil then + editBoxFrame.parent.editBoxFunc(a1, editBox:GetText() or "") + elseif a3 == nil then + editBoxFrame.parent.editBoxFunc(a1, a2, editBox:GetText() or "") + elseif a4 == nil then + editBoxFrame.parent.editBoxFunc(a1, a2, a3, editBox:GetText() or "") + else + editBoxFrame.parent.editBoxFunc(a1, a2, a3, a4, editBox:GetText() or "") + end + end + self:Close(editBoxFrame.level) + for i = 1, editBoxFrame.level - 1 do + Refresh(self, levels[i]) + end + end) + editBox:SetScript("OnEscapePressed", function() + self:Close(editBoxFrame.level) + end) + local changing = false + local skipNext = false + + function editBox:SpecialSetText(text) + local oldText = editBox:GetText() or "" + if not text then + text = "" + end + if text ~= oldText then + changing = true + self:SetText(text) + changing = false + skipNext = true + end + end + + editBox:SetScript("OnTextChanged", function() + if skipNext then + skipNext = false + elseif not changing and editBoxFrame.parent and editBoxFrame.parent.editBoxChangeFunc then + local a1,a2,a3,a4 = editBoxFrame.parent.editBoxChangeArg1, editBoxFrame.parent.editBoxChangeArg2, editBoxFrame.parent.editBoxChangeArg3, editBoxFrame.parent.editBoxChangeArg4 + local text + if a1 == nil then + text = editBoxFrame.parent.editBoxChangeFunc(editBox:GetText() or "") + elseif a2 == nil then + text = editBoxFrame.parent.editBoxChangeFunc(a1, editBox:GetText() or "") + elseif a3 == nil then + text = editBoxFrame.parent.editBoxChangeFunc(a1, a2, editBox:GetText() or "") + elseif a4 == nil then + text = editBoxFrame.parent.editBoxChangeFunc(a1, a2, a3, editBox:GetText() or "") + else + text = editBoxFrame.parent.editBoxChangeFunc(a1, a2, a3, a4, editBox:GetText() or "") + end + if text then + editBox:SpecialSetText(text) + end + end + end) + editBoxFrame:SetScript("OnEnter", function() + StopCounting(self, editBoxFrame.level) + end) + editBoxFrame:SetScript("OnLeave", function() + StartCounting(self, editBoxFrame.level) + end) + editBox:SetScript("OnEnter", function() + StopCounting(self, editBoxFrame.level) + end) + editBox:SetScript("OnLeave", function() + StartCounting(self, editBoxFrame.level) + end) + end + editBoxFrame.parent = parent + editBoxFrame.level = parent.level.num + 1 + editBoxFrame.parentValue = parent.level.value + editBoxFrame:SetFrameLevel(parent.level:GetFrameLevel() + 3) + editBoxFrame.editBox:SetFrameLevel(editBoxFrame:GetFrameLevel() + 1) + editBoxFrame.editBox:SpecialSetText(parent.editBoxText) + + if parent.arrow then +-- parent.arrow:SetVertexColor(0.2, 0.6, 0) + parent.arrow:SetHeight(24) + parent.arrow:SetWidth(24) + end + + local level = parent.level + editBoxFrame:Show() + editBoxFrame:ClearAllPoints() + if level.lastDirection == "RIGHT" then + if level.lastVDirection == "DOWN" then + editBoxFrame:SetPoint("TOPLEFT", parent, "TOPRIGHT", 5, 10) + else + editBoxFrame:SetPoint("BOTTOMLEFT", parent, "BOTTOMRIGHT", 5, -10) + end + else + if level.lastVDirection == "DOWN" then + editBoxFrame:SetPoint("TOPRIGHT", parent, "TOPLEFT", -5, 10) + else + editBoxFrame:SetPoint("BOTTOMRIGHT", parent, "BOTTOMLEFT", -5, -10) + end + end + local dirty + if level.lastDirection == "RIGHT" then + if editBoxFrame:GetRight() > GetScreenWidth() then + level.lastDirection = "LEFT" + dirty = true + end + elseif editBoxFrame:GetLeft() < 0 then + level.lastDirection = "RIGHT" + dirty = true + end + if level.lastVDirection == "DOWN" then + if editBoxFrame:GetBottom() < 0 then + level.lastVDirection = "UP" + dirty = true + end + elseif editBoxFrame:GetTop() > GetScreenWidth() then + level.lastVDirection = "DOWN" + dirty = true + end + if dirty then + editBoxFrame:ClearAllPoints() + if level.lastDirection == "RIGHT" then + if level.lastVDirection == "DOWN" then + editBoxFrame:SetPoint("TOPLEFT", parent, "TOPRIGHT", 5, 10) + else + editBoxFrame:SetPoint("BOTTOMLEFT", parent, "BOTTOMRIGHT", 5, -10) + end + else + if level.lastVDirection == "DOWN" then + editBoxFrame:SetPoint("TOPRIGHT", parent, "TOPLEFT", -5, 10) + else + editBoxFrame:SetPoint("BOTTOMRIGHT", parent, "BOTTOMLEFT", -5, -10) + end + end + end + local left, bottom = editBoxFrame:GetLeft(), editBoxFrame:GetBottom() + editBoxFrame:ClearAllPoints() + editBoxFrame:SetPoint("BOTTOMLEFT", UIParent, "BOTTOMLEFT", left, bottom) + if mod(level.num, 5) == 0 then + local left, bottom = level:GetLeft(), level:GetBottom() + level:ClearAllPoints() + level:SetPoint("BOTTOMLEFT", UIParent, "BOTTOMLEFT", left, bottom) + end +end + +function Dewdrop:IsOpen(parent) + self:argCheck(parent, 2, "table", "nil") + return levels[1] and levels[1]:IsShown() and (not parent or parent == levels[1].parent or parent == levels[1]:GetParent()) +end + +function Dewdrop:GetOpenedParent() + return (levels[1] and levels[1]:IsShown()) and (levels[1].parent or levels[1]:GetParent()) +end + +function Open(self, parent, func, level, value, point, relativePoint, cursorX, cursorY) + self:Close(level) + if DewdropLib then + local d = DewdropLib:GetInstance('1.0') + local ret, val = pcall(d, IsOpen, d) + if ret and val then + DewdropLib:GetInstance('1.0'):Close() + end + end + parent:GetCenter() + local frame = AcquireLevel(self, level) + if level == 1 then + frame.lastDirection = "RIGHT" + frame.lastVDirection = "DOWN" + else + frame.lastDirection = levels[level - 1].lastDirection + frame.lastVDirection = levels[level - 1].lastVDirection + end + frame:SetFrameStrata("FULLSCREEN_DIALOG") + frame:ClearAllPoints() + frame.parent = parent + frame:SetPoint("LEFT", UIParent, "RIGHT", 10000, 0) + frame:Show() + if level == 1 then + baseFunc = func + end + levels[level].value = value +-- levels[level].parentText = parent.text and parent.text:GetText() or nil +-- levels[level].parentTooltipTitle = parent.tooltipTitle +-- levels[level].parentTooltipText = parent.tooltipText +-- levels[level].parentTooltipFunc = parent.tooltipFunc + if parent.arrow then +-- parent.arrow:SetVertexColor(0.2, 0.6, 0) + parent.arrow:SetHeight(24) + parent.arrow:SetWidth(24) + end + relativePoint = relativePoint or point + Refresh(self, levels[level]) + if point or (cursorX and cursorY) then + frame:ClearAllPoints() + if cursorX and cursorY then + local curX, curY = GetScaledCursorPosition() + if curY < GetScreenHeight() / 2 then + point, relativePoint = "BOTTOM", "BOTTOM" + else + point, relativePoint = "TOP", "TOP" + end + if curX < GetScreenWidth() / 2 then + point, relativePoint = point .. "LEFT", relativePoint .. "RIGHT" + else + point, relativePoint = point .. "RIGHT", relativePoint .. "LEFT" + end + end + frame:SetPoint(point, parent, relativePoint) + if cursorX and cursorY then + local left = frame:GetLeft() + local width = frame:GetWidth() + local bottom = frame:GetBottom() + local height = frame:GetHeight() + local curX, curY = GetScaledCursorPosition() + frame:ClearAllPoints() + relativePoint = relativePoint or point + if point == "BOTTOM" or point == "TOP" then + if curX < GetScreenWidth() / 2 then + point = point .. "LEFT" + else + point = point .. "RIGHT" + end + elseif point == "CENTER" then + if curX < GetScreenWidth() / 2 then + point = "LEFT" + else + point = "RIGHT" + end + end + local xOffset, yOffset = 0, 0 + if curY > GetScreenHeight() / 2 then + yOffset = -height + end + if curX > GetScreenWidth() / 2 then + xOffset = -width + end + frame:SetPoint(point, parent, relativePoint, curX - left + xOffset, curY - bottom + yOffset) + if level == 1 then + frame.lastDirection = "RIGHT" + end + elseif cursorX then + local left = frame:GetLeft() + local width = frame:GetWidth() + local curX, curY = GetScaledCursorPosition() + frame:ClearAllPoints() + relativePoint = relativePoint or point + if point == "BOTTOM" or point == "TOP" then + if curX < GetScreenWidth() / 2 then + point = point .. "LEFT" + else + point = point .. "RIGHT" + end + elseif point == "CENTER" then + if curX < GetScreenWidth() / 2 then + point = "LEFT" + else + point = "RIGHT" + end + end + frame:SetPoint(point, parent, relativePoint, curX - left - width / 2, 0) + if level == 1 then + frame.lastDirection = "RIGHT" + end + elseif cursorY then + local bottom = frame:GetBottom() + local height = frame:GetHeight() + local curX, curY = GetScaledCursorPosition() + frame:ClearAllPoints() + relativePoint = relativePoint or point + if point == "LEFT" or point == "RIGHT" then + if curX < GetScreenHeight() / 2 then + point = point .. "BOTTOM" + else + point = point .. "TOP" + end + elseif point == "CENTER" then + if curX < GetScreenHeight() / 2 then + point = "BOTTOM" + else + point = "TOP" + end + end + frame:SetPoint(point, parent, relativePoint, 0, curY - bottom - height / 2) + if level == 1 then + frame.lastDirection = "DOWN" + end + end + if (strsub(point, 1, 3) ~= strsub(relativePoint, 1, 3)) then + if frame:GetBottom() < 0 then + local point, parent, relativePoint, x, y = frame:GetPoint(1) + local change = GetScreenHeight() - frame:GetTop() + local otherChange = -frame:GetBottom() + if otherChange < change then + change = otherChange + end + frame:SetPoint(point, parent, relativePoint, x, y + change) + elseif frame:GetTop() > GetScreenHeight() then + local point, parent, relativePoint, x, y = frame:GetPoint(1) + local change = GetScreenHeight() - frame:GetTop() + local otherChange = -frame:GetBottom() + if otherChange < change then + change = otherChange + end + frame:SetPoint(point, parent, relativePoint, x, y + change) + end + end + end + CheckDualMonitor(self, frame) + StartCounting(self, level) +end + +function Dewdrop:IsRegistered(parent) + self:argCheck(parent, 2, "table") + return not not self.registry[parent] +end + +function Dewdrop:Register(parent, k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20) + self:argCheck(parent, 2, "table") + if self.registry[parent] then + self:Unregister(parent) + end + local info = new(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20) + if type(info.children) == "table" then + local err, position = validateOptions(info.children) + + if err then + if position then + Dewdrop:error(position .. ": " .. err) + else + Dewdrop:error(err) + end + end + end + self.registry[parent] = info + if not info.dontHook and not self.onceRegistered[parent] then + if parent:HasScript("OnMouseUp") then + local script = parent:GetScript("OnMouseUp") + parent:SetScript("OnMouseUp", function() + if script then + script() + end + if arg1 == "RightButton" and self.registry[parent] then + if self:IsOpen(parent) then + self:Close() + else + self:Open(parent) + end + end + end) + end + if parent:HasScript("OnMouseDown") then + local script = parent:GetScript("OnMouseDown") + parent:SetScript("OnMouseDown", function() + if script then + script() + end + if self.registry[parent] then + self:Close() + end + end) + end + end + self.onceRegistered[parent] = true +end + +function Dewdrop:Unregister(parent) + self:argCheck(parent, 2, "table") + self.registry[parent] = nil +end + +function Dewdrop:Open(parent, k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20) + self:argCheck(parent, 2, "table") + local info + if type(k1) == "table" and k1[0] and k1.IsFrameType and self.registry[k1] then + info = tmp() + for k,v in pairs(self.registry[k1]) do + info[k] = v + end + else + info = tmp(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20) + if self.registry[parent] then + for k,v in pairs(self.registry[parent]) do + if info[k] == nil then + info[k] = v + end + end + end + end + local point = info.point + local relativePoint = info.relativePoint + local cursorX = info.cursorX + local cursorY = info.cursorY + if type(point) == "function" then + local b + point, b = point(parent) + if b then + relativePoint = b + end + end + if type(relativePoint) == "function" then + relativePoint = relativePoint(parent) + end + Open(self, parent, info.children, 1, nil, point, relativePoint, cursorX, cursorY) +end + +function Clear(self, level) + if level then + if level.buttons then + for i = table.getn(level.buttons), 1, -1 do + ReleaseButton(self, level, i) + end + end + end +end + +function Dewdrop:Close(level) + if DropDownList1:IsShown() then + DropDownList1:Hide() + end + if DewdropLib then + local d = DewdropLib:GetInstance('1.0') + local ret, val = pcall(d, IsOpen, d) + if ret and val then + DewdropLib:GetInstance('1.0'):Close() + end + end + self:argCheck(level, 2, "number", "nil") + if not level then + level = 1 + end + if level == 1 and levels[level] then + levels[level].parented = false + end + if level > 1 and levels[level-1].buttons then + local buttons = levels[level-1].buttons + for _,button in ipairs(buttons) do + button.arrow:SetWidth(16) + button.arrow:SetHeight(16) +-- button.arrow:SetVertexColor(1, 1, 1) + end + end + if sliderFrame and sliderFrame.level >= level then + sliderFrame:Hide() + end + if editBoxFrame and editBoxFrame.level >= level then + editBoxFrame:Hide() + end + for i = level, table.getn(levels) do + Clear(self, levels[level]) + levels[level]:Hide() + levels[i]:ClearAllPoints() + levels[i]:SetPoint("CENTER", UIParent, "CENTER") + end +end + +function Dewdrop:AddLine(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20) + local info = tmp(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20) + local level = info.level or currentLevel + info.level = nil + local button = AcquireButton(self, level) + if not next(info) then + info.disabled = true + end + button.disabled = info.isTitle or info.notClickable or info.disabled + button.isTitle = info.isTitle + button.notClickable = info.notClickable + if button.isTitle then + button.text:SetFontObject(GameFontNormalSmall) + elseif button.notClickable then + button.text:SetFontObject(GameFontHighlightSmall) + elseif button.disabled then + button.text:SetFontObject(GameFontDisableSmall) + else + button.text:SetFontObject(GameFontHighlightSmall) + end + if info.disabled then + button.arrow:SetDesaturated(true) + button.check:SetDesaturated(true) + else + button.arrow:SetDesaturated(false) + button.check:SetDesaturated(false) + end + if info.textR and info.textG and info.textB then + button.textR = info.textR + button.textG = info.textG + button.textB = info.textB + button.text:SetTextColor(button.textR, button.textG, button.textB) + else + button.text:SetTextColor(button.text:GetFontObject():GetTextColor()) + end + button.notCheckable = info.notCheckable + button.text:SetPoint("LEFT", button, "LEFT", button.notCheckable and 0 or 24, 0) + button.checked = not info.notCheckable and info.checked + button.isRadio = not info.notCheckable and info.isRadio + if info.isRadio then + button.check:Show() + button.check:SetTexture(info.checkIcon or "Interface\\Buttons\\UI-RadioButton") + if button.checked then + button.check:SetTexCoord(0.25, 0.5, 0, 1) + button.check:SetVertexColor(1, 1, 1, 1) + else + button.check:SetTexCoord(0, 0.25, 0, 1) + button.check:SetVertexColor(1, 1, 1, 0.5) + end + button.radioHighlight:SetTexture(info.checkIcon or "Interface\\Buttons\\UI-RadioButton") + button.check:SetWidth(16) + button.check:SetHeight(16) + elseif info.icon then + button.check:Show() + button.check:SetTexture(info.icon) + if info.iconWidth and info.iconHeight then + button.check:SetWidth(info.iconWidth) + button.check:SetHeight(info.iconHeight) + else + button.check:SetWidth(16) + button.check:SetHeight(16) + end + if info.iconCoordLeft and info.iconCoordRight and info.iconCoordTop and info.iconCoordBottom then + button.check:SetTexCoord(info.iconCoordLeft, info.iconCoordRight, info.iconCoordTop, info.iconCoordBottom) + elseif string.find(info.checkIcon, "^Interface\\Icons\\") then + button.check:SetTexCoord(0.05, 0.95, 0.05, 0.95) + else + button.check:SetTexCoord(0, 1, 0, 1) + end + button.check:SetVertexColor(1, 1, 1, 1) + else + if button.checked then + if info.checkIcon then + button.check:SetWidth(16) + button.check:SetHeight(16) + button.check:SetTexture(info.checkIcon) + if string.find(info.checkIcon, "^Interface\\Icons\\") then + button.check:SetTexCoord(0.05, 0.95, 0.05, 0.95) + else + button.check:SetTexCoord(0, 1, 0, 1) + end + else + button.check:SetWidth(24) + button.check:SetHeight(24) + button.check:SetTexture("Interface\\Buttons\\UI-CheckBox-Check") + button.check:SetTexCoord(0, 1, 0, 1) + end + button.check:SetVertexColor(1, 1, 1, 1) + else + button.check:SetVertexColor(1, 1, 1, 0) + end + end + if not button.disabled then + button.func = info.func + end + button.hasColorSwatch = info.hasColorSwatch + if button.hasColorSwatch then + button.colorSwatch:Show() + button.colorSwatch.texture:Show() + button.r = info.r or 1 + button.g = info.g or 1 + button.b = info.b or 1 + button.colorSwatch.texture:SetTexture(button.r, button.g, button.b) + button.checked = false + button.func = nil + button.colorFunc = info.colorFunc + button.colorArg1 = info.colorArg1 + button.colorArg2 = info.colorArg2 + button.colorArg3 = info.colorArg3 + button.colorArg4 = info.colorArg4 + button.hasOpacity = info.hasOpacity + button.opacity = info.opacity or 1 + else + button.colorSwatch:Hide() + button.colorSwatch.texture:Hide() + end + button.hasArrow = not button.hasColorSwatch and (info.value or info.hasSlider or info.hasEditBox) and info.hasArrow + if button.hasArrow then + button.arrow:SetAlpha(1) + if info.hasSlider then + button.hasSlider = true + button.sliderMin = info.sliderMin or 0 + button.sliderMax = info.sliderMax or 1 + button.sliderStep = info.sliderStep or 0 + button.sliderIsPercent = info.sliderIsPercent and true or false + button.sliderMinText = info.sliderMinText or button.sliderIsPercent and string.format("%.0f%%", button.sliderMin * 100) or button.sliderMin + button.sliderMaxText = info.sliderMaxText or button.sliderIsPercent and string.format("%.0f%%", button.sliderMax * 100) or button.sliderMax + button.sliderFunc = info.sliderFunc + button.sliderValue = info.sliderValue + button.sliderArg1 = info.sliderArg1 + button.sliderArg2 = info.sliderArg2 + button.sliderArg3 = info.sliderArg3 + button.sliderArg4 = info.sliderArg4 + elseif info.hasEditBox then + button.hasEditBox = true + button.editBoxText = info.editBoxText or "" + button.editBoxFunc = info.editBoxFunc + button.editBoxArg1 = info.editBoxArg1 + button.editBoxArg2 = info.editBoxArg2 + button.editBoxArg3 = info.editBoxArg3 + button.editBoxArg4 = info.editBoxArg4 + button.editBoxChangeFunc = info.editBoxChangeFunc + button.editBoxChangeArg1 = info.editBoxChangeArg1 + button.editBoxChangeArg2 = info.editBoxChangeArg2 + button.editBoxChangeArg3 = info.editBoxChangeArg3 + button.editBoxChangeArg4 = info.editBoxChangeArg4 + button.editBoxValidateFunc = info.editBoxValidateFunc + button.editBoxValidateArg1 = info.editBoxValidateArg1 + button.editBoxValidateArg2 = info.editBoxValidateArg2 + button.editBoxValidateArg3 = info.editBoxValidateArg3 + button.editBoxValidateArg4 = info.editBoxValidateArg4 + else + button.value = info.value + end + else + button.arrow:SetAlpha(0) + end + button.arg1 = info.arg1 + button.arg2 = info.arg2 + button.arg3 = info.arg3 + button.arg4 = info.arg4 + button.closeWhenClicked = info.closeWhenClicked + button.textHeight = info.textHeight or UIDROPDOWNMENU_DEFAULT_TEXT_HEIGHT or 10 + local font,_ = button.text:GetFont() + button.text:SetFont(STANDARD_TEXT_FONT or "Fonts\\FRIZQT__.TTF", button.textHeight) + button:SetHeight(button.textHeight + 6) + button.text:SetPoint("RIGHT", button.arrow, (button.hasColorSwatch or button.hasArrow) and "LEFT" or "RIGHT") + button.text:SetJustifyH(info.justifyH or "LEFT") + button.text:SetText(info.text) + button.tooltipTitle = info.tooltipTitle + button.tooltipText = info.tooltipText + button.tooltipFunc = info.tooltipFunc + button.tooltipArg1 = info.tooltipArg1 + button.tooltipArg2 = info.tooltipArg2 + button.tooltipArg3 = info.tooltipArg3 + button.tooltipArg4 = info.tooltipArg4 + if not button.tooltipTitle and not button.tooltipText and not button.tooltipFunc and not info.isTitle then + button.tooltipTitle = info.text + end + if type(button.func) == "string" then + self:assert(type(button.arg1) == "table", "Cannot call method " .. button.func .. " on a non-table") + self:assert(type(button.arg1[button.func]) == "function", "Method " .. button.func .. " nonexistant.") + end +end + +function Dewdrop:InjectAceOptionsTable(handler, options) + self:argCheck(handler, 2, "table") + self:argCheck(options, 3, "table") + if string.lower(tostring(options.type)) ~= "group" then + self:error('Cannot inject into options table argument #3 if its type is not "group"') + end + if options.handler ~= nil and options.handler ~= handler then + self:error("Cannot inject into options table argument #3 if it has a different handler than argument #2") + end + options.handler = handler + local class = handler.class + if not AceLibrary:HasInstance("AceOO-2.0") or not class then + self:error("Cannot retrieve AceOptions tables from a non-object argument #2") + end + while class and class ~= AceLibrary("AceOO-2.0").Class do + if type(class.GetAceOptionsDataTable) == "function" then + local t = class:GetAceOptionsDataTable(handler) + for k,v in pairs(t) do + if type(options.args) ~= "table" then + options.args = {} + end + if options.args[k] == nil then + options.args[k] = v + end + end + end + local mixins = class.mixins + if mixins then + for mixin in pairs(mixins) do + if type(mixin.GetAceOptionsDataTable) == "function" then + local t = mixin:GetAceOptionsDataTable(handler) + for k,v in pairs(t) do + if type(options.args) ~= "table" then + options.args = {} + end + if options.args[k] == nil then + options.args[k] = v + end + end + end + end + end + class = class.super + end + return options +end + +local function activate(self, oldLib, oldDeactivate) + Dewdrop = self + if oldLib and oldLib.registry then + self.registry = oldLib.registry + self.onceRegistered = oldLib.onceRegistered + else + self.registry = {} + self.onceRegistered = {} + + local WorldFrame_OnMouseDown = WorldFrame:GetScript("OnMouseDown") + local WorldFrame_OnMouseUp = WorldFrame:GetScript("OnMouseUp") + local oldX, oldY, clickTime + WorldFrame:SetScript("OnMouseDown", function() + oldX,oldY = GetCursorPosition() + clickTime = GetTime() + if WorldFrame_OnMouseDown then + WorldFrame_OnMouseDown() + end + end) + + WorldFrame:SetScript("OnMouseUp", function() + local x,y = GetCursorPosition() + if not oldX or not oldY or not x or not y or not clickTime then + self:Close() + if WorldFrame_OnMouseUp then + WorldFrame_OnMouseUp() + end + return + end + local d = math.abs(x - oldX) + math.abs(y - oldY) + if d <= 5 and GetTime() - clickTime < 0.5 then + self:Close() + end + if WorldFrame_OnMouseUp then + WorldFrame_OnMouseUp() + end + end) + + if hooksecurefunc then + hooksecurefunc(DropDownList1, "Show", function() + if levels[1] and levels[1]:IsVisible() then + self:Close() + end + end) + else + local DropDownList1_Show = DropDownList1.Show + function DropDownList1.Show(DropDownList1) + if levels[1] and levels[1]:IsVisible() then + self:Close() + end + DropDownList1_Show(DropDownList1) + end + end + + if hooksecurefunc then + hooksecurefunc("HideDropDownMenu", function() + if levels[1] and levels[1]:IsVisible() then + self:Close() + end + end) + else + local old_HideDropDownMenu = HideDropDownMenu + function HideDropDownMenu(num) + if levels[1] and levels[1]:IsVisible() then + self:Close() + end + old_HideDropDownMenu(num) + end + end + + if hooksecurefunc then + hooksecurefunc("CloseDropDownMenus", function() + if levels[1] and levels[1]:IsVisible() then + self:Close() + end + end) + else + local old_CloseDropDownMenus = CloseDropDownMenus + function CloseDropDownMenus(num) + if levels[1] and levels[1]:IsVisible() then + self:Close() + end + old_CloseDropDownMenus(num) + end + end + end + levels = {} + buttons = {} + + if oldDeactivate then + oldDeactivate(oldLib) + end +end + +AceLibrary:Register(Dewdrop, MAJOR_VERSION, MINOR_VERSION, activate) diff --git a/Payload/Interface/Addons/SuperAPI/libs/FuBarPlugin/FuBarPlugin-2.0.lua b/Payload/Interface/Addons/SuperAPI/libs/FuBarPlugin/FuBarPlugin-2.0.lua new file mode 100644 index 0000000..292c8fc --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/FuBarPlugin/FuBarPlugin-2.0.lua @@ -0,0 +1,1480 @@ +--[[ +Name: FuBarPlugin-2.0 +Revision: $Rev: 15811 $ +Author: Cameron Kenneth Knight (ckknight@gmail.com) +Website: http://wiki.wowace.com/index.php/FuBarPlugin-2.0 +Documentation: http://wiki.wowace.com/index.php/FuBarPlugin-2.0 +SVN: svn://svn.wowace.com/root/branches/FuBar/FuBarPlugin-2.0/FuBarPlugin-2.0/ +Description: Plugin for FuBar. +Dependencies: AceLibrary, AceOO-2.0, AceEvent-2.0, Tablet-2.0, Dewdrop-2.0 +]] + +local MAJOR_VERSION = "FuBarPlugin-2.0" +local MINIMAPCONTAINER_MAJOR_VERSION = "FuBarPlugin-MinimapContainer-2.0" +local MINOR_VERSION = "$Revision: 15811 $" + +-- This ensures the code is only executed if the libary doesn't already exist, or is a newer version +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary.") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +if not AceLibrary:HasInstance("AceOO-2.0") then error(MAJOR_VERSION .. " requires AceOO-2.0.") end + +local AceEvent = AceLibrary:HasInstance("AceEvent-2.0") and AceLibrary("AceEvent-2.0") +local Tablet = AceLibrary:HasInstance("Tablet-2.0") and AceLibrary("Tablet-2.0") +local Dewdrop = AceLibrary:HasInstance("Dewdrop-2.0") and AceLibrary("Dewdrop-2.0") + +local epsilon = 1e-5 +local _G = getfenv(0) + +local SHOW_ICON = "Show icon" +local SHOW_ICON_DESC = "Show the plugins icon on the panel." +local SHOW_TEXT = "Show text" +local SHOW_TEXT_DESC = "Show the plugins text on the panel." +local SHOW_COLORED_TEXT = "Show colored text" +local SHOW_COLORED_TEXT_DESC = "Allow the plugin to color its text." +local DETACH_TOOLTIP = "Detach tooltip" +local DETACH_TOOLTIP_DESC = "Detach the tooltip from the panel." +local LOCK_TOOLTIP = "Lock tooltip" +local LOCK_TOOLTIP_DESC = "Lock the tooltips position. When the tooltip is locked, you must use Alt to access it with your mouse." +local POSITION = "Position" +local POSITION_DESC = "Position the plugin on the panel." +local POSITION_LEFT = "Left" +local POSITION_RIGHT = "Right" +local POSITION_CENTER = "Center" +local ATTACH_TO_MINIMAP = "Attach to minimap" +local ATTACH_TO_MINIMAP_DESC = "Attach the plugin to the minimap instead of the panel." +local HIDE_FUBAR_PLUGIN = "Hide FuBar plugin" +local HIDE_FUBAR_PLUGIN_CMD = "Hidden" +local HIDE_FUBAR_PLUGIN_DESC = "Hide the plugin from the panel." + +if GetLocale() == "koKR" then + SHOW_ICON = "아이콘 표시" + SHOW_ICON_DESC = "패널에 플러그인 아이콘을 표시합니다." + SHOW_TEXT = "텍스트 표시" + SHOW_TEXT_DESC = "페널에 플러그인 텍스트를 표시합니다." + SHOW_COLORED_TEXT = "색상화된 텍스트 표시" + SHOW_COLORED_TEXT_DESC = "플러그인의 텍스트 색상을 허용합니다." + DETACH_TOOLTIP = "툴팁 분리" + DETACH_TOOLTIP_DESC = "패널에서 툴팁을 분리 합니다." + LOCK_TOOLTIP = "툴팁 고정" + LOCK_TOOLTIP_DESC = "툴팁 위치를 고정합니다." + POSITION = "위치" + POSITION_DESC = "패널에서 플러그인의 위치를 설정합니다." + POSITION_LEFT = "왼쪽" + POSITION_RIGHT = "오른쪽" + POSITION_CENTER = "가운데" + ATTACH_TO_MINIMAP = "미니맵에 표시" + ATTACH_TO_MINIMAP_DESC = "플러그인을 패널 대신 미니맵에 표시합니다." + HIDE_FUBAR_PLUGIN = "FuBar 플러그인 숨기기" + HIDE_FUBAR_PLUGIN_CMD = "숨겨짐" + HIDE_FUBAR_PLUGIN_DESC = "패널에서 플러그인을 숨깁니다." +elseif GetLocale() == "deDE" then + SHOW_ICON = "Zeige Icon" + SHOW_ICON_DESC = "Zeige das Plugin-Icon auf der Leiste." + SHOW_TEXT = "Zeige Text" + SHOW_TEXT_DESC = "Zeige den Plugin-Text auf der Leiste." + SHOW_COLORED_TEXT = "Zeige gef\195\164rbten Text" + SHOW_COLORED_TEXT_DESC = "Dem Plugin erlauben sein Text zu f\195\164rben." + DETACH_TOOLTIP = "Tooltip l\195\182sen" + DETACH_TOOLTIP_DESC = "Tooltip von der Leiste l\195\182sen." + LOCK_TOOLTIP = "Tooltip sperren" + LOCK_TOOLTIP_DESC = "Tooltip an der Position sperren." + POSITION = "Position" + POSITION_DESC = "Positioniert das Plugin auf der Leiste." + POSITION_LEFT = "Links" + POSITION_RIGHT = "Rechts" + POSITION_CENTER = "Mitte" + ATTACH_TO_MINIMAP = "An der Minimap anbringen" + ATTACH_TO_MINIMAP_DESC = "Bringt das Plugin an der Minimap anstelle der Leiste an." + HIDE_FUBAR_PLUGIN = "Versteckt das FuBar Plugin" + HIDE_FUBAR_PLUGIN_CMD = "Verstecken" + HIDE_FUBAR_PLUGIN_DESC = "Versteckt das Plugin von der Leiste." +elseif GetLocale() == "frFR" then + SHOW_ICON = "Afficher l'ic\195\180ne" + SHOW_ICON_DESC = "Afficher l'ic\195\180ne du plugin sur le panneau." + SHOW_TEXT = "Afficher le texte" + SHOW_TEXT_DESC = "Afficher le texte du plugin sur le panneau." + SHOW_COLORED_TEXT = "Afficher la couleur du texte" + SHOW_COLORED_TEXT_DESC = "Permet au plugin de colorer le texte." + DETACH_TOOLTIP = "D\195\169tacher le tooltip" + DETACH_TOOLTIP_DESC = "Permet de d\195\169tacher le tooltip du panneau." + LOCK_TOOLTIP = "Bloquer le tooltip" + LOCK_TOOLTIP_DESC = "Permet de bloquer le tooltip \195\160 sa position actuelle." + POSITION = "Position" + POSITION_DESC = "Permet de changer la position du plugin dans le panneau." + POSITION_LEFT = "Gauche" + POSITION_RIGHT = "Droite" + POSITION_CENTER = "Centre" + ATTACH_TO_MINIMAP = "Attacher \195\160 la minicarte" + ATTACH_TO_MINIMAP_DESC = "Atteche l'ic\195\180ne du plugin \195\160 la minicarte." + HIDE_FUBAR_PLUGIN = "Masquer le plugin" + HIDE_FUBAR_PLUGIN_CMD = "Masqu\195\169" + HIDE_FUBAR_PLUGIN_DESC = "Permet de masquer compl\195\168tement le plugin du panneau." +elseif GetLocale() == "zhCN" then + SHOW_ICON = "显示图标" + SHOW_ICON_DESC = "在面板上显示插件图标." + SHOW_TEXT = "显示文字" + SHOW_TEXT_DESC = "在面板上显示文字标题." + SHOW_COLORED_TEXT = "显示彩色文字" + SHOW_COLORED_TEXT_DESC = "允许插件显示彩色文字." + DETACH_TOOLTIP = "独立提示信息" + DETACH_TOOLTIP_DESC = "从面板上独立提示信息." + LOCK_TOOLTIP = "锁定提示信息" + LOCK_TOOLTIP_DESC = "锁定提示信息位置." + POSITION = "位置" + POSITION_DESC = "插件在面板上的位置." + POSITION_LEFT = "居左" + POSITION_RIGHT = "居右" + POSITION_CENTER = "居中" + ATTACH_TO_MINIMAP = "依附在小地图" + ATTACH_TO_MINIMAP_DESC = "插件图标依附在小地图而不显示在面板上." + HIDE_FUBAR_PLUGIN = "隐藏FuBar插件" + HIDE_FUBAR_PLUGIN_CMD = "Hidden" + HIDE_FUBAR_PLUGIN_DESC = "在面板上隐藏该插件." +elseif GetLocale() == "zhTW" then + SHOW_ICON = "顯示圖示" + SHOW_ICON_DESC = "在面板上顯示插件圖示。" + SHOW_TEXT = "顯示文字" + SHOW_TEXT_DESC = "在面板上顯示文字標題。" + SHOW_COLORED_TEXT = "顯示彩色文字" + SHOW_COLORED_TEXT_DESC = "允許插件顯示彩色文字。" + DETACH_TOOLTIP = "獨立提示訊息" + DETACH_TOOLTIP_DESC = "從面板上獨立提示訊息。" + LOCK_TOOLTIP = "鎖定提示訊息" + LOCK_TOOLTIP_DESC = "鎖定提示訊息位置。" + POSITION = "位置" + POSITION_DESC = "插件在面板上的位置。" + POSITION_LEFT = "靠左" + POSITION_RIGHT = "靠右" + POSITION_CENTER = "置中" + ATTACH_TO_MINIMAP = "依附在小地圖" + ATTACH_TO_MINIMAP_DESC = "插件圖標依附在小地圖而不顯示在面板上。" + HIDE_FUBAR_PLUGIN = "隱藏FuBar插件" + HIDE_FUBAR_PLUGIN_CMD = "Hidden" + HIDE_FUBAR_PLUGIN_DESC = "在面板上隱藏該插件." +end + +local FuBarPlugin = AceLibrary("AceOO-2.0").Mixin { + "GetTitle", + "GetName", + "GetCategory", + "SetFontSize", + "GetFrame", + "Show", + "Hide", + "GetPanel", + "IsTextColored", + "ToggleTextColored", + "IsMinimapAttached", + "ToggleMinimapAttached", + "Update", + "UpdateDisplay", + "UpdateData", + "UpdateText", + "UpdateTooltip", + "SetIcon", + "GetIcon", + "CheckWidth", + "SetText", + "GetText", + "IsIconShown", + "ToggleIconShown", + "ShowIcon", + "HideIcon", + "IsTextShown", + "ToggleTextShown", + "ShowText", + "HideText", + "IsTooltipDetached", + "ToggleTooltipDetached", + "DetachTooltip", + "ReattachTooltip", + "GetDefaultPosition", + "SetPanel", + "IsLoadOnDemand", + "IsDisabled", + "CreateBasicPluginFrame", + "CreatePluginChildFrame", + "OpenMenu", + "AddImpliedMenuOptions", + } + +local good = nil +local function CheckFuBar() + if not good then + good = FuBar and tonumber(string.sub(FuBar.version, 1, 3)) and tonumber(string.sub(FuBar.version, 1, 3)) >= 2 and true + end + return good +end + +function FuBarPlugin:GetTitle() + local name = self.title or self.name + FuBarPlugin:assert(name, "You must provide self.title or self.name") + local _,_,title = string.find(name, "FuBar %- (.-)%s*$") + if not title then + title = name + end + return (string.gsub(string.gsub(title, "|c%x%x%x%x%x%x%x%x", ""), "|r", "")) +end + +function FuBarPlugin:GetName() + return self.name +end + +function FuBarPlugin:GetCategory() + return self.category or "Other" +end + +function FuBarPlugin:GetFrame() + return self.frame +end + +function FuBarPlugin:GetPanel() + return self.panel +end + +function FuBarPlugin:IsTextColored() + return not self.db or not self.db.profile or not self.db.profile.uncolored +end + +function FuBarPlugin:ToggleTextColored() + FuBarPlugin:assert(self.db, "Cannot change text color if self.db is not available. (" .. self:GetTitle() .. ")") + self.db.profile.uncolored = not self.db.profile.uncolored or nil + self:UpdateText() +end + +function FuBarPlugin:ToggleMinimapAttached() + if CheckFuBar() and not self.cannotAttachToMinimap then + local value = self:IsMinimapAttached() + if value then + if self.panel then + self.panel:RemovePlugin(self) + end + FuBar:GetPanel(1):AddPlugin(self, nil, self.defaultPosition) + else + if self.panel then + self.panel:RemovePlugin(self) + end + AceLibrary(MINIMAPCONTAINER_MAJOR_VERSION):AddPlugin(self) + end + end + Dewdrop:Close() +end + +function FuBarPlugin:IsMinimapAttached() + if not CheckFuBar() then + return true + end + return self.panel == AceLibrary(MINIMAPCONTAINER_MAJOR_VERSION) +end + +function FuBarPlugin:Update() + self:UpdateData() + self:UpdateText() + self:UpdateTooltip() +end + +function FuBarPlugin:UpdateDisplay() + self:UpdateText() + self:UpdateTooltip() +end + +function FuBarPlugin:UpdateData() + if type(self.OnDataUpdate) == "function" then + if not self:IsDisabled() then + self:OnDataUpdate() + end + end +end + +function FuBarPlugin:UpdateText() + if type(self.OnTextUpdate) == "function" then + if not self:IsDisabled() then + self:OnTextUpdate() + end + elseif self:IsTextShown() then + self:SetText(self:GetTitle()) + end +end + +function FuBarPlugin:RegisterTablet() + if not Tablet:IsRegistered(self.frame) then + if self.db and self.db.profile and not self.db.profile.detachedTooltip then + self.db.profile.detachedTooltip = {} + end + Tablet:Register(self.frame, + 'children', function() + Tablet:SetTitle(self:GetTitle()) + if type(self.OnTooltipUpdate) == "function" then + if not self:IsDisabled() then + self:OnTooltipUpdate() + end + end + end, + 'clickable', self.clickableTooltip, + 'data', CheckFuBar() and FuBar.db.profile.tooltip or self.db and self.db.profile.detachedTooltip or {}, + 'detachedData', self.db and self.db.profile.detachedTooltip or {}, + 'point', function(frame) + if frame:GetTop() > GetScreenHeight() / 2 then + local x = frame:GetCenter() + if x < GetScreenWidth() / 3 then + return "TOPLEFT", "BOTTOMLEFT" + elseif x < GetScreenWidth() * 2 / 3 then + return "TOP", "BOTTOM" + else + return "TOPRIGHT", "BOTTOMRIGHT" + end + else + local x = frame:GetCenter() + if x < GetScreenWidth() / 3 then + return "BOTTOMLEFT", "TOPLEFT" + elseif x < GetScreenWidth() * 2 / 3 then + return "BOTTOM", "TOP" + else + return "BOTTOMRIGHT", "TOPRIGHT" + end + end + end, + 'menu', self.OnMenuRequest and function(level, value, valueN_1, valueN_2, valueN_3, valueN_4) + if level == 1 then + local name = tostring(self) + if not string.find(name, '^table:') then + name = string.gsub(name, "|c%x%x%x%x%x%x%x%x(.-)|r", "%1") + Dewdrop:AddLine( + 'text', name, + 'isTitle', true + ) + end + end + if type(self.OnMenuRequest) == "function" then + self:OnMenuRequest(level, value, true, valueN_1, valueN_2, valueN_3, valueN_4) + elseif type(self.OnMenuRequest) == "table" then + Dewdrop:FeedAceOptionsTable(self.OnMenuRequest) + end + end, + 'hideWhenEmpty', self.tooltipHiddenWhenEmpty + ) + end +end + +function FuBarPlugin:UpdateTooltip() + FuBarPlugin.RegisterTablet(self) + if self:IsMinimapAttached() and not self:IsTooltipDetached() and self.minimapFrame then + Tablet:Refresh(self.minimapFrame) + else + Tablet:Refresh(self.frame) + end +end + +function FuBarPlugin:OnProfileEnable() + self:Update() +end + +function FuBarPlugin:Show(panelId) + if self.frame:IsShown() or (self.minimapFrame and self.minimapFrame:IsShown()) then + return + end + if panelId ~= false then + if self.db then + self.db.profile.hidden = nil + end + end + if self.IsActive and not self:IsActive() then + self.panelIdTmp = panelId + self:ToggleActive() + self.panelIdTmp = nil + if self.db then + self.db.profile.disabled = nil + end + elseif not self.db or not self.db.profile.hidden then + if panelId == 0 or not CheckFuBar() then + AceLibrary(MINIMAPCONTAINER_MAJOR_VERSION):AddPlugin(self) + else + FuBar:ShowPlugin(self, panelId or self.panelIdTmp) + end + if not self.userDefinedFrame then + if not self:IsTextShown() then + self.textFrame:SetText("") + self.textFrame:SetWidth(epsilon) + self.textFrame:Hide() + end + if not self:IsIconShown() then + self.iconFrame:SetWidth(epsilon) + self.iconFrame:Hide() + end + end + self:Update() + end +end + +function FuBarPlugin:Hide(check) + if not self.frame:IsShown() and (not self.minimapFrame or not self.minimapFrame:IsShown()) then + return + end + if self.hideWithoutStandby and self.db and check ~= false then + self.db.profile.hidden = true + end + if not self.hideWithoutStandby then + if self.db and not self.overrideTooltip and not self.cannotDetachTooltip and self:IsTooltipDetached() and self.db.profile.detachedTooltip and self.db.profile.detachedTooltip.detached then + self:ReattachTooltip() + self.db.profile.detachedTooltip.detached = true + end + if self.IsActive and self:IsActive() and self.ToggleActive and (not CheckFuBar() or not FuBar:IsChangingProfile()) then + self:ToggleActive() + end + end + if self.panel then + self.panel:RemovePlugin(self) + end + self.frame:Hide() + if self.minimapFrame then + self.minimapFrame:Hide() + end + + if Dewdrop:IsOpen(self.frame) or (self.minimapFrame and Dewdrop:IsOpen(self.minimapFrame)) then + Dewdrop:Close() + end +end + +function FuBarPlugin:SetIcon(path) + if not path then + return + end + FuBarPlugin:argCheck(path, 2, "string", "boolean") + FuBarPlugin:assert(self.hasIcon, "Cannot set icon unless self.hasIcon is set. (" .. self:GetTitle() .. ")") + if not self.iconFrame then + return + end + if type(path) ~= "string" then + path = format("Interface\\AddOns\\%s\\icon", self.folderName) + elseif not string.find(path, '^Interface[\\/]') then + path = format("Interface\\AddOns\\%s\\%s", self.folderName, path) + end + if string.sub(path, 1, 16) == "Interface\\Icons\\" then + self.iconFrame:SetTexCoord(0.05, 0.95, 0.05, 0.95) + else + self.iconFrame:SetTexCoord(0, 1, 0, 1) + end + self.iconFrame:SetTexture(path) + if self.minimapIcon then + if string.sub(path, 1, 16) == "Interface\\Icons\\" then + self.minimapIcon:SetTexCoord(0.05, 0.95, 0.05, 0.95) + else + self.minimapIcon:SetTexCoord(0, 1, 0, 1) + end + self.minimapIcon:SetTexture(path) + end +end + +function FuBarPlugin:GetIcon() + if self.hasIcon then + return self.iconFrame:GetTexture() + end +end + +function FuBarPlugin:CheckWidth(force) + FuBarPlugin:argCheck(force, 2, "boolean", "nil") + if (self.iconFrame and self.iconFrame:IsShown()) or (self.textFrame and self.textFrame:IsShown()) then + if (self.db and self.db.profile and not self:IsIconShown()) or not self.hasIcon then + self.iconFrame:SetWidth(epsilon) + end + local width + if not self.hasNoText then + self.textFrame:SetHeight(0) + self.textFrame:SetWidth(500) + width = self.textFrame:GetStringWidth() + 1 + self.textFrame:SetWidth(width) + self.textFrame:SetHeight(self.textFrame:GetHeight()) + end + if self.hasNoText or not self.textFrame:IsShown() then + self.frame:SetWidth(self.iconFrame:GetWidth()) + if self.panel and self.panel:GetPluginSide(self) == "CENTER" then + self.panel:UpdateCenteredPosition() + end + elseif force or not self.textWidth or self.textWidth < width or self.textWidth - 8 > width then + self.textWidth = width + self.textFrame:SetWidth(width) + if self.iconFrame and self.iconFrame:IsShown() then + self.frame:SetWidth(width + self.iconFrame:GetWidth()) + else + self.frame:SetWidth(width) + end + if self.panel and self.panel:GetPluginSide(self) == "CENTER" then + self.panel:UpdateCenteredPosition() + end + end + end +end + +function FuBarPlugin:SetText(text) + if not self.textFrame then + return + end + FuBarPlugin:assert(not self.hasNoText, "Cannot set text if self.hasNoText has been set. (" .. self:GetTitle() .. ")") + FuBarPlugin:argCheck(text, 2, "string", "number") + if text == "" then + if self.hasIcon then + self:ShowIcon() + else + text = self:GetTitle() + end + end + if not self:IsTextColored() then + text = string.gsub(string.gsub(text, "|c%x%x%x%x%x%x%x%x", ""), "|r", "") + end + self.textFrame:SetText(text) + self:CheckWidth() +end + +function FuBarPlugin:GetText() + FuBarPlugin:assert(self.textFrame, "Cannot get text without a self.textFrame (" .. self:GetTitle() .. ")") + if not self.hasNoText then + return self.textFrame:GetText() or "" + end +end + +function FuBarPlugin:IsIconShown() + if not self.hasIcon then + return false + elseif self.hasNoText then + return true + elseif not self.db then + return true + elseif self.db.profile.showIcon == nil then + return true + else + return (self.db.profile.showIcon == 1 or self.db.profile.showIcon == true) and true or false + end +end + +function FuBarPlugin:ToggleIconShown() + FuBarPlugin:assert(self.iconFrame, "Cannot toggle icon without a self.iconFrame (" .. self:GetTitle() .. ")") + FuBarPlugin:assert(self.hasIcon, "Cannot show icon unless self.hasIcon is set. (" .. self:GetTitle() .. ")") + FuBarPlugin:assert(not self.hasNoText, "Cannot hide icon if self.hasNoText is set. (" .. self:GetTitle() .. ")") + FuBarPlugin:assert(self.textFrame, "Cannot hide icon if self.textFrame is not set. (" .. self:GetTitle() .. ")") + FuBarPlugin:assert(self.iconFrame, "Cannot hide icon if self.iconFrame is not set. (" .. self:GetTitle() .. ")") + FuBarPlugin:assert(self.db, "Cannot hide icon if self.db is not available. (" .. self:GetTitle() .. ")") + local value = not self:IsIconShown() + self.db.profile.showIcon = value + if value then + if not self:IsTextShown() and self.textFrame:IsShown() and self.textFrame:GetText() == self:GetTitle() then + self.textFrame:Hide() + self.textFrame:SetText("") + end + self.iconFrame:Show() + self.iconFrame:SetWidth(self.iconFrame:GetHeight()) + else + if not self.textFrame:IsShown() or not self.textFrame:GetText() then + self.textFrame:Show() + self.textFrame:SetText(self:GetTitle()) + end + self.iconFrame:Hide() + self.iconFrame:SetWidth(epsilon) + end + self:CheckWidth(true) + return value +end + +function FuBarPlugin:ShowIcon() + if not self:IsIconShown() then + self:ToggleIconShown() + end +end + +function FuBarPlugin:HideIcon() + if self:IsIconShown() then + self:ToggleIconShown() + end +end + +function FuBarPlugin:IsTextShown() + if self.hasNoText then + return false + elseif not self.hasIcon then + return true + elseif not self.db then + return true + elseif self.db.profile.showText == nil then + return true + else + return (self.db.profile.showText == 1 or self.db.profile.showText == true) and true or false + end +end + +function FuBarPlugin:ToggleTextShown() + FuBarPlugin:assert(not self.cannotHideText, "Cannot hide text unless self.cannotHideText is unset. (" .. self:GetTitle() .. ")") + FuBarPlugin:assert(self.hasIcon, "Cannot show text unless self.hasIcon is set. (" .. self:GetTitle() .. ")") + FuBarPlugin:assert(not self.hasNoText, "Cannot hide text if self.hasNoText is set. (" .. self:GetTitle() .. ")") + FuBarPlugin:assert(self.textFrame, "Cannot hide text if self.textFrame is not set. (" .. self:GetTitle() .. ")") + FuBarPlugin:assert(self.iconFrame, "Cannot hide text if self.iconFrame is not set. (" .. self:GetTitle() .. ")") + FuBarPlugin:assert(self.db, "Cannot hide text if self.db is not available. (" .. self:GetTitle() .. ")") + local value = not self:IsTextShown() + self.db.profile.showText = value + if value then + self.textFrame:Show() + self:UpdateText() + else + self.textFrame:SetText("") + self.textFrame:SetWidth(epsilon) + self.textFrame:Hide() + if not self:IsIconShown() then + DropDownList1:Hide() + end + self:ShowIcon() + end + self:CheckWidth(true) + return value +end + +function FuBarPlugin:ShowText() + if not self:IsTextShown() then + self:ToggleTextShown() + end +end + +function FuBarPlugin:HideText() + if self:IsTextShown() then + self:ToggleTextShown() + end +end + +function FuBarPlugin:IsTooltipDetached() + FuBarPlugin.RegisterTablet(self) + return not Tablet:IsAttached(self.frame) +end + +function FuBarPlugin:ToggleTooltipDetached() + FuBarPlugin.RegisterTablet(self) + if self:IsTooltipDetached() then + Tablet:Attach(self.frame) + else + Tablet:Detach(self.frame) + end +end + +function FuBarPlugin:DetachTooltip() + FuBarPlugin.RegisterTablet(self) + Tablet:Detach(self.frame) +end + +function FuBarPlugin:ReattachTooltip() + FuBarPlugin.RegisterTablet(self) + Tablet:Attach(self.frame) +end + +function FuBarPlugin:GetDefaultPosition() + return self.defaultPosition or "LEFT" +end + +local function IsCorrectPanel(panel) + if type(panel) ~= "table" then + return false + elseif type(panel.AddPlugin) ~= "function" then + return false + elseif type(panel.RemovePlugin) ~= "function" then + return false + elseif type(panel.GetNumPlugins) ~= "function" then + return false + elseif type(panel:GetNumPlugins()) ~= "number" then + return false + elseif type(panel.GetPlugin) ~= "function" then + return false + elseif type(panel.HasPlugin) ~= "function" then + return false + elseif type(panel.GetPluginSide) ~= "function" then + return false + end + return true +end + +function FuBarPlugin:SetPanel(panel) + if panel then + FuBarPlugin:assert(IsCorrectPanel(panel), "Bad argument #2 to `SetPanel'. Panel does not have the correct API.") + end + self.panel = panel +end + +function FuBarPlugin:SetFontSize(size) + FuBarPlugin:assert(not self.userDefinedFrame, "You must provide a SetFontSize(size) method if you provide your own frame.") + if self.hasIcon then + FuBarPlugin:assert(self.iconFrame, (self.name and self.name .. ": " or "") .. "No iconFrame found") + self.iconFrame:SetWidth(size + 3) + self.iconFrame:SetHeight(size + 3) + end + if not self.hasNoText then + FuBarPlugin:assert(self.textFrame, (self.name and self.name .. ": " or "") .. "No textFrame found") + local font, _, flags = self.textFrame:GetFont() + self.textFrame:SetFont(font, size, flags) + end + self:CheckWidth() +end + +function FuBarPlugin:IsLoadOnDemand() + return IsAddOnLoadOnDemand(self.folderName) +end + +function FuBarPlugin:IsDisabled() + return self.IsActive and not self:IsActive() or false +end + +function FuBarPlugin:OnInstanceInit(target) + if not AceEvent then + self:error(MAJOR_VERSION .. " requires AceEvent-2.0.") + elseif not Tablet then + self:error(MAJOR_VERSION .. " requires Tablet-2.0.") + elseif not Dewdrop then + self:error(MAJOR_VERSION .. " requires Dewdrop-2.0.") + end + self.registry[target] = true + + local _,_,folderName = string.find(debugstack(6, 1, 0), "\\AddOns\\(.*)\\") + target.folderName = folderName + self.folderNames[target] = folderName +end + +function FuBarPlugin:CreateBasicPluginFrame(name) + local frame = CreateFrame("Button", name, UIParent) + frame:SetFrameStrata("HIGH") + frame:SetFrameLevel(7) + frame:EnableMouse(true) + frame:EnableMouseWheel(true) + frame:SetMovable(true) + frame:SetWidth(150) + frame:SetHeight(24) + frame:SetPoint("CENTER", UIParent, "CENTER") + + frame:SetScript("OnClick", function() + if type(self.OnClick) == "function" then + self:OnClick(arg1) + end + end) + frame:SetScript("OnDoubleClick", function() + if type(self.OnDoubleClick) == "function" then + self:OnDoubleClick(arg1) + end + end) + frame:SetScript("OnMouseDown", function() + if arg1 == "RightButton" and not IsShiftKeyDown() and not IsControlKeyDown() and not IsAltKeyDown() then + self:OpenMenu() + return + else + HideDropDownMenu(1) + if type(self.OnMouseDown) == "function" then + self:OnMouseDown(arg1) + end + end + end) + frame:SetScript("OnMouseUp", function() + if type(self.OnMouseUp) == "function" then + self:OnMouseUp(arg1) + end + end) + frame:SetScript("OnReceiveDrag", function() + if type(self.OnReceiveDrag) == "function" then + self:OnReceiveDrag() + end + end) + return frame +end + +function FuBarPlugin:CreatePluginChildFrame(frameType, name, parent) + FuBarPlugin:assert(self.frame, "You must have self.frame declared in order to add child frames") + FuBarPlugin:argCheck(frameType, 1, "string") + local child = CreateFrame(frameType, name, parent) + if parent then + child:SetFrameLevel(parent:GetFrameLevel() + 2) + end + child:SetScript("OnEnter", function() + if self.frame:GetScript("OnEnter") then + self.frame:GetScript("OnEnter")() + end + end) + child:SetScript("OnLeave", function() + if self.frame:GetScript("OnLeave") then + self.frame:GetScript("OnLeave")() + end + end) + if child:HasScript("OnClick") then + child:SetScript("OnClick", function() + if self.frame:HasScript("OnClick") and self.frame:GetScript("OnClick") then + self.frame:GetScript("OnClick")() + end + end) + end + if child:HasScript("OnDoubleClick") then + child:SetScript("OnDoubleClick", function() + if self.frame:HasScript("OnDoubleClick") and self.frame:GetScript("OnDoubleClick") then + self.frame:GetScript("OnDoubleClick")() + end + end) + end + child:SetScript("OnMouseDown", function() + if self.frame:GetScript("OnMouseDown") then + self.frame:GetScript("OnMouseDown")() + end + end) + child:SetScript("OnMouseUp", function() + if self.frame:GetScript("OnMouseUp") then + self.frame:GetScript("OnMouseUp")() + end + end) + child:SetScript("OnReceiveDrag", function() + if self.frame:GetScript("OnReceiveDrag") then + self.frame:GetScript("OnReceiveDrag")() + end + end) + return child +end + +function FuBarPlugin:OpenMenu(frame) + if not frame then + frame = self:GetFrame() + end + if not frame or not self:GetFrame() or Dewdrop:IsOpen(frame) then + Dewdrop:Close() + return + end + Tablet:Close() + + if not Dewdrop:IsRegistered(self:GetFrame()) then + if type(self.OnMenuRequest) == "table" and (not self.OnMenuRequest.handler or self.OnMenuRequest.handler == self) and self.OnMenuRequest.type == "group" then + Dewdrop:InjectAceOptionsTable(self, self.OnMenuRequest) + if self.OnMenuRequest.args and CheckFuBar() and not self.independentProfile then + self.OnMenuRequest.args.profile = nil + end + end + Dewdrop:Register(self:GetFrame(), + 'children', type(self.OnMenuRequest) == "table" and self.OnMenuRequest or function(level, value, valueN_1, valueN_2, valueN_3, valueN_4) + if level == 1 then + Dewdrop:AddLine( + 'text', self:GetTitle(), + 'isTitle', true + ) + end + + if level == 1 then + if self.OnMenuRequest then + self:OnMenuRequest(level, value, false, valueN_1, valueN_2, valueN_3, valueN_4) + end + + if not self.overrideMenu then + if self.MenuSettings then + Dewdrop:AddLine() + end + self:AddImpliedMenuOptions() + end + else + if not self.overrideMenu and self:AddImpliedMenuOptions() then + else + if self.OnMenuRequest then + self:OnMenuRequest(level, value, false, valueN_1, valueN_2, valueN_3, valueN_4) + end + end + end + if level == 1 then + Dewdrop:AddLine( + 'text', CLOSE, + 'func', Dewdrop.Close, + 'arg1', Dewdrop + ) + end + end, + 'point', function(frame) + local x, y = frame:GetCenter() + local leftRight + if x < GetScreenWidth() / 2 then + leftRight = "LEFT" + else + leftRight = "RIGHT" + end + if y < GetScreenHeight() / 2 then + return "BOTTOM" .. leftRight, "TOP" .. leftRight + else + return "TOP" .. leftRight, "BOTTOM" .. leftRight + end + end, + 'dontHook', true + ) + end + if frame == self:GetFrame() then + Dewdrop:Open(self:GetFrame()) + else + Dewdrop:Open(frame, self:GetFrame()) + end +end + +local impliedMenuOptions +function FuBarPlugin:AddImpliedMenuOptions(level) + FuBarPlugin:argCheck(level, 2, "number", "nil") + if not impliedMenuOptions then + impliedMenuOptions = {} + end + if not impliedMenuOptions[self] then + impliedMenuOptions[self] = { type = 'group', args = {} } + Dewdrop:InjectAceOptionsTable(self, impliedMenuOptions[self]) + if impliedMenuOptions[self].args and CheckFuBar() and not self.independentProfile then + impliedMenuOptions[self].args.profile = nil + end + end + return Dewdrop:FeedAceOptionsTable(impliedMenuOptions[self], level and level - 1) +end + +function FuBarPlugin.OnEmbedInitialize(FuBarPlugin, self) + if not self.frame then + local name = "FuBarPlugin" .. self:GetTitle() .. "Frame" + local frame = _G[name] + if not frame or not _G[name .. "Text"] or not _G[name .. "Icon"] then + frame = self:CreateBasicPluginFrame(name) + + local icon = frame:CreateTexture(name .. "Icon", "ARTWORK") + icon:SetWidth(16) + icon:SetHeight(16) + icon:SetPoint("LEFT", frame, "LEFT") + + local text = frame:CreateFontString(name .. "Text", "ARTWORK") + text:SetWidth(134) + text:SetHeight(24) + text:SetPoint("LEFT", icon, "RIGHT", 0, 1) + text:SetFontObject(GameFontNormal) + end + self.frame = frame + self.textFrame = _G[name .. "Text"] + self.iconFrame = _G[name .. "Icon"] + else + self.userDefinedFrame = true + end + + self.frame.plugin = self + self.frame:SetParent(UIParent) + self.frame:SetPoint("RIGHT", UIParent, "LEFT", -5, 0) + self.frame:Hide() + + if self.hasIcon then + self:SetIcon(self.hasIcon) + end + + if CheckFuBar() then + FuBar:RegisterPlugin(self) + end +end + +local CheckShow = function(self, panelId) + if not self.frame:IsShown() and (not self.minimapFrame or not self.minimapFrame:IsShown()) then + self:Show(panelId) + Dewdrop:Refresh(2) + end +end + +local recheckPlugins +function FuBarPlugin.OnEmbedEnable(FuBarPlugin, self) + if not self.userDefinedFrame then + if self:IsIconShown() then + self.iconFrame:Show() + else + self.iconFrame:Hide() + end + end + self:CheckWidth(true) + + if not self.hideWithoutStandby or not self.db.profile.hidden then + if FuBarPlugin.enabledPlugins[self] then + CheckShow(self, self.panelIdTmp) + else + FuBarPlugin:ScheduleEvent(CheckShow, 0, self, self.panelIdTmp) + end + end + FuBarPlugin.enabledPlugins[self] = true + + if not self.overrideTooltip and not self.cannotDetachTooltip and self.db and self.db.profile.detachedTooltip and self.db.profile.detachedTooltip.detached then + FuBarPlugin:ScheduleEvent(self.DetachTooltip, 0, self) + end + + if self:IsLoadOnDemand() and CheckFuBar() then + if not FuBar.db.profile.loadOnDemand then + FuBar.db.profile.loadOnDemand = {} + end + if not FuBar.db.profile.loadOnDemand[self.folderName] then + FuBar.db.profile.loadOnDemand[self.folderName] = {} + end + FuBar.db.profile.loadOnDemand[self.folderName].disabled = nil + end + + if CheckFuBar() and AceLibrary:HasInstance("AceConsole-2.0") then + if not recheckPlugins then + local AceConsole = AceLibrary("AceConsole-2.0") + local AceOO = AceLibrary("AceOO-2.0") + function recheckPlugins() + for k,v in pairs(AceConsole.registry) do + if type(v) == "table" and v.args and AceOO.inherits(v.handler, FuBarPlugin) and not v.independentProfile then + v.args.profile = nil + end + end + end + end + FuBarPlugin:ScheduleEvent(recheckPlugins, 0) + end +end + +function FuBarPlugin.OnEmbedDisable(FuBarPlugin, self) + self:Hide(false) + + if self:IsLoadOnDemand() and CheckFuBar() then + if not FuBar.db.profile.loadOnDemand then + FuBar.db.profile.loadOnDemand = {} + end + if not FuBar.db.profile.loadOnDemand[self.folderName] then + FuBar.db.profile.loadOnDemand[self.folderName] = {} + end + FuBar.db.profile.loadOnDemand[self.folderName].disabled = true + end +end + +function FuBarPlugin.OnEmbedProfileEnable(FuBarPlugin, self) + self:Update() + if self.db and self.db.profile then + if not self.db.profile.detachedTooltip then + self.db.profile.detachedTooltip = {} + end + if Tablet.registry[self.frame] then + Tablet:UpdateDetachedData(self.frame, self.db.profile.detachedTooltip) + else + FuBarPlugin.RegisterTablet(self) + end + end +end + +function FuBarPlugin.GetAceOptionsDataTable(FuBarPlugin, self) + return { + icon = { + type = "toggle", + name = SHOW_ICON, + desc = SHOW_ICON_DESC, + set = "ToggleIconShown", + get = "IsIconShown", + hidden = function() + return not self.hasIcon or self.hasNoText or self:IsDisabled() or self:IsMinimapAttached() or not self.db + end, + order = -13.7, + handler = self, + }, + text = { + type = "toggle", + name = SHOW_TEXT, + desc = SHOW_TEXT_DESC, + set = "ToggleTextShown", + get = "IsTextShown", + hidden = function() + return self.cannotHideText or not self.hasIcon or self.hasNoText or self:IsDisabled() or self:IsMinimapAttached() or not self.db + end, + order = -13.6, + handler = self, + }, + colorText = { + type = "toggle", + name = SHOW_COLORED_TEXT, + desc = SHOW_COLORED_TEXT_DESC, + set = "ToggleTextColored", + get = "IsTextColored", + hidden = function() + return self.userDefinedFrame or self.hasNoText or self.hasNoColor or self:IsDisabled() or self:IsMinimapAttached() or not self.db + end, + order = -13.5, + handler = self, + }, + detachTooltip = { + type = "toggle", + name = DETACH_TOOLTIP, + desc = DETACH_TOOLTIP_DESC, + get = "IsTooltipDetached", + set = "ToggleTooltipDetached", + hidden = function() + return self.overrideTooltip or self.cannotDetachTooltip or self:IsDisabled() + end, + order = -13.4, + handler = self, + }, + lockTooltip = { + type = "toggle", + name = LOCK_TOOLTIP, + desc = LOCK_TOOLTIP_DESC, + get = function() + return Tablet:IsLocked(self.frame) + end, + set = function() + return Tablet:ToggleLocked(self.frame) + end, + disabled = function() + return not self:IsTooltipDetached() + end, + hidden = function() + return self.overrideTooltip or self.cannotDetachTooltip or self:IsDisabled() + end, + order = -13.3, + handler = self, + }, + position = { + type = "text", + name = POSITION, + desc = POSITION_DESC, + validate = { + LEFT = POSITION_LEFT, + CENTER = POSITION_CENTER, + RIGHT = POSITION_RIGHT + }, + get = function() + return self.panel and self.panel:GetPluginSide(self) + end, + set = function(value) + if self.panel then + self.panel:SetPluginSide(self, value) + end + end, + hidden = function() + return self:IsMinimapAttached() or self:IsDisabled() or not self.panel + end, + order = -13.2, + handler = self, + }, + minimapAttach = { + type = "toggle", + name = ATTACH_TO_MINIMAP, + desc = ATTACH_TO_MINIMAP_DESC, + get = "IsMinimapAttached", + set = "ToggleMinimapAttached", + hidden = function() + return (self.cannotAttachToMinimap and not self:IsMinimapAttached()) or not CheckFuBar() or self:IsDisabled() + end, + order = -13.1, + handler = self, + }, + hide = { + type = "toggle", + cmdName = HIDE_FUBAR_PLUGIN_CMD, + guiName = HIDE_FUBAR_PLUGIN, + desc = HIDE_FUBAR_PLUGIN_DESC, + get = function() + return not self.frame:IsShown() and (not self.minimapFrame or not self.minimapFrame:IsShown()) + end, + set = function() + if not self.frame:IsShown() and (not self.minimapFrame or not self.minimapFrame:IsShown()) then + self:Show() + else + self:Hide() + end + end, + hidden = function() + return not self.hideWithoutStandby or self:IsDisabled() + end, + order = -13, + handler = self, + }, + } +end + +local function activate(self, oldLib, oldDeactivate) + FuBarPlugin = self + + if oldLib then + self.registry = oldLib.registry + self.folderNames = oldLib.folderNames + self.enabledPlugins = oldLib.enabledPlugins + end + + if not self.registry then + self.registry = {} + end + if not self.folderNames then + self.folderNames = {} + end + if not self.enabledPlugins then + self.enabledPlugins = {} + end + + FuBarPlugin.activate(self, oldLib, oldDeactivate) + + if oldDeactivate then + oldDeactivate(oldLib) + end +end + +local function external(self, major, instance) + if major == "AceEvent-2.0" then + AceEvent = instance + + AceEvent:embed(self) + elseif major == "Tablet-2.0" then + Tablet = instance + elseif major == "Dewdrop-2.0" then + Dewdrop = instance + end +end + +AceLibrary:Register(FuBarPlugin, MAJOR_VERSION, MINOR_VERSION, activate, nil, external) + +local MinimapContainer = {} + +local IsMinimapSquare +do + local value + function IsMinimapSquare() + if value == nil then + if not AceEvent or not AceEvent:IsFullyInitialized() then + return IsAddOnLoaded("CornerMinimap") or IsAddOnLoaded("SquareMinimap") or IsAddOnLoaded("Squeenix") + else + value = IsAddOnLoaded("CornerMinimap") or IsAddOnLoaded("SquareMinimap") or IsAddOnLoaded("Squeenix") and true or false + end + end + return value + end +end + +function MinimapContainer:AddPlugin(plugin) + if CheckFuBar() and FuBar:IsChangingProfile() then + return + end + if plugin.panel ~= nil then + plugin.panel:RemovePlugin(plugin) + end + plugin.panel = self + if not plugin.minimapFrame then + local frame = CreateFrame("Button", plugin.frame:GetName() .. "MinimapButton", Minimap) + plugin.minimapFrame = frame + AceLibrary(MAJOR_VERSION).RegisterTablet(plugin) + Tablet:Register(frame, plugin.frame) + frame.plugin = plugin + frame:SetWidth(31) + frame:SetHeight(31) + frame:SetFrameStrata("BACKGROUND") + frame:SetFrameLevel(4) + frame:SetHighlightTexture("Interface\\Minimap\\UI-Minimap-ZoomButton-Highlight") + local icon = frame:CreateTexture(frame:GetName() .. "Icon", "BACKGROUND") + plugin.minimapIcon = icon + local path = plugin:GetIcon() or (plugin.iconFrame and plugin.iconFrame:GetTexture()) or "Interface\\Icons\\INV_Misc_QuestionMark" + icon:SetTexture(path) + if string.sub(path, 1, 16) == "Interface\\Icons\\" then + icon:SetTexCoord(0.05, 0.95, 0.05, 0.95) + else + icon:SetTexCoord(0, 1, 0, 1) + end + icon:SetWidth(20) + icon:SetHeight(20) + icon:SetPoint("TOPLEFT", frame, "TOPLEFT", 7, -5) + local overlay = frame:CreateTexture(frame:GetName() .. "Overlay","OVERLAY") +overlay:SetTexture("Interface\\Minimap\\MiniMap-TrackingBorder") + overlay:SetWidth(53) + overlay:SetHeight(53) + overlay:SetPoint("TOPLEFT",frame,"TOPLEFT") + frame:EnableMouse(true) + frame:RegisterForClicks("LeftButtonUp") + frame.plugin = plugin + frame:SetScript("OnClick", function() + if type(plugin.OnClick) == "function" then + if not this.dragged then + plugin:OnClick(arg1) + end + end + end) + frame:SetScript("OnDoubleClick", function() + if type(plugin.OnDoubleClick) == "function" then + plugin:OnDoubleClick(arg1) + end + end) + frame:SetScript("OnReceiveDrag", function() + if type(plugin.OnReceiveDrag) == "function" then + if not this.dragged then + plugin:OnReceiveDrag() + end + end + end) + frame:SetScript("OnMouseDown", function() + this.dragged = false + if arg1 == "LeftButton" and not IsShiftKeyDown() and not IsControlKeyDown() and not IsAltKeyDown() then + HideDropDownMenu(1) + if type(plugin.OnMouseDown) == "function" then + plugin:OnMouseDown(arg1) + end + elseif arg1 == "RightButton" and not IsShiftKeyDown() and not IsControlKeyDown() and not IsAltKeyDown() then + plugin:OpenMenu(frame) + else + HideDropDownMenu(1) + if type(plugin.OnMouseDown) == "function" then + plugin:OnMouseDown(arg1) + end + end + if plugin.OnClick or plugin.OnMouseDown or plugin.OnMouseUp or plugin.OnDoubleClick then + if string.sub(this.plugin.minimapIcon:GetTexture(), 1, 16) == "Interface\\Icons\\" then + plugin.minimapIcon:SetTexCoord(0.14, 0.86, 0.14, 0.86) + else + plugin.minimapIcon:SetTexCoord(0.1, 0.9, 0.1, 0.9) + end + end + end) + frame:SetScript("OnMouseUp", function() + if not this.dragged and type(plugin.OnMouseUp) == "function" then + plugin:OnMouseUp(arg1) + end + if string.sub(this.plugin.minimapIcon:GetTexture(), 1, 16) == "Interface\\Icons\\" then + plugin.minimapIcon:SetTexCoord(0.05, 0.95, 0.05, 0.95) + else + plugin.minimapIcon:SetTexCoord(0, 1, 0, 1) + end + end) + frame:RegisterForDrag("LeftButton") + frame:SetScript("OnDragStart", self.OnDragStart) + frame:SetScript("OnDragStop", self.OnDragStop) + end + plugin.frame:Hide() + plugin.minimapFrame:Show() + self:ReadjustLocation(plugin) + table.insert(self.plugins, plugin) + local exists = false + return true +end + +function MinimapContainer:RemovePlugin(index) + if CheckFuBar() and FuBar:IsChangingProfile() then + return + end + if type(index) == "table" then + index = self:IndexOfPlugin(index) + if not index then + return + end + end + local t = self.plugins + local plugin = t[index] + assert(plugin.panel == self, "Plugin has improper panel field") + plugin:SetPanel(nil) + table.remove(t, index) + return true +end + +function MinimapContainer:ReadjustLocation(plugin) + local frame = plugin.minimapFrame + if plugin.db and plugin.db.profile.minimapPositionWild then + frame:SetPoint("CENTER", UIParent, "BOTTOMLEFT", plugin.db.profile.minimapPositionX, plugin.db.profile.minimapPositionY) + elseif not plugin.db and plugin.minimapPositionWild then + frame:SetPoint("CENTER", UIParent, "BOTTOMLEFT", plugin.minimapPositionX, plugin.minimapPositionY) + else + local position + if plugin.db then + position = plugin.db.profile.minimapPosition or plugin.defaultMinimapPosition or math.random(1, 360) + else + position = plugin.minimapPosition or plugin.defaultMinimapPosition or math.random(1, 360) + end + local angle = math.rad(position or 0) + local x,y + if not IsMinimapSquare() then + x = math.cos(angle) * 80 + y = math.sin(angle) * 80 + else + x = 110 * math.cos(angle) + y = 110 * math.sin(angle) + x = math.max(-82, math.min(x, 84)) + y = math.max(-86, math.min(y, 82)) + end + frame:SetPoint("CENTER", Minimap, "CENTER", x, y) + end +end + +function MinimapContainer:GetPlugin(index) + return self.plugins[index] +end + +function MinimapContainer:GetNumPlugins() + return table.getn(self.plugins) +end + +function MinimapContainer:IndexOfPlugin(plugin) + for i,p in ipairs(self.plugins) do + if p == plugin then + return i, "MINIMAP" + end + end +end + +function MinimapContainer:HasPlugin(plugin) + return self:IndexOfPlugin(plugin) ~= nil +end + +function MinimapContainer:GetPluginSide(plugin) + local index = self:IndexOfPlugin(plugin) + assert(index, "Plugin not in panel") + return "MINIMAP" +end + +function MinimapContainer.OnDragStart() + this.dragged = true + this:LockHighlight() + this:SetScript("OnUpdate", MinimapContainer.OnUpdate) + if string.sub(this.plugin.minimapIcon:GetTexture(), 1, 16) == "Interface\\Icons\\" then + this.plugin.minimapIcon:SetTexCoord(0.05, 0.95, 0.05, 0.95) + else + this.plugin.minimapIcon:SetTexCoord(0, 1, 0, 1) + end +end + +function MinimapContainer.OnDragStop() + this:SetScript("OnUpdate", nil) + this:UnlockHighlight() +end + +function MinimapContainer.OnUpdate() + if not IsAltKeyDown() then + local mx, my = Minimap:GetCenter() + local px, py = GetCursorPosition() + local scale = UIParent:GetEffectiveScale() + px, py = px / scale, py / scale + local position = math.deg(math.atan2(py - my, px - mx)) + if position <= 0 then + position = position + 360 + elseif position > 360 then + position = position - 360 + end + if this.plugin.db then + this.plugin.db.profile.minimapPosition = position + this.plugin.db.profile.minimapPositionX = nil + this.plugin.db.profile.minimapPositionY = nil + this.plugin.db.profile.minimapPositionWild = nil + else + this.plugin.minimapPosition = position + this.plugin.minimapPositionX = nil + this.plugin.minimapPositionY = nil + this.plugin.minimapPositionWild = nil + end + else + local px, py = GetCursorPosition() + local scale = UIParent:GetEffectiveScale() + px, py = px / scale, py / scale + if this.plugin.db then + this.plugin.db.profile.minimapPositionX = px + this.plugin.db.profile.minimapPositionY = py + this.plugin.db.profile.minimapPosition = nil + this.plugin.db.profile.minimapPositionWild = true + else + this.plugin.minimapPositionX = px + this.plugin.minimapPositionY = py + this.plugin.minimapPosition = nil + this.plugin.minimapPositionWild = true + end + end + MinimapContainer:ReadjustLocation(this.plugin) +end + +local function activate(self, oldLib, oldDeactivate) + MinimapContainer = self + + if oldLib then + self.plugins = oldLib.plugins + end + + if not self.plugins then + self.plugins = {} + end + + if oldDeactivate then + oldDeactivate(oldLib) + end +end + +AceLibrary:Register(MinimapContainer, MINIMAPCONTAINER_MAJOR_VERSION, MINOR_VERSION, activate) diff --git a/Payload/Interface/Addons/SuperAPI/libs/Tablet/Tablet-2.0.lua b/Payload/Interface/Addons/SuperAPI/libs/Tablet/Tablet-2.0.lua new file mode 100644 index 0000000..70f340d --- /dev/null +++ b/Payload/Interface/Addons/SuperAPI/libs/Tablet/Tablet-2.0.lua @@ -0,0 +1,2784 @@ +--[[ +Name: Tablet-2.0 +Revision: $Rev: 14636 $ +Author(s): ckknight (ckknight@gmail.com) +Website: http://ckknight.wowinterface.com/ +Documentation: http://wiki.wowace.com/index.php/Tablet-2.0 +SVN: http://svn.wowace.com/root/trunk/TabletLib/Tablet-2.0 +Description: A library to provide an efficient, featureful tooltip-style display. +Dependencies: AceLibrary, (optional) Dewdrop-2.0 +]] + +local MAJOR_VERSION = "Tablet-2.0" +local MINOR_VERSION = "$Revision: 14636 $" + +if not AceLibrary then error(MAJOR_VERSION .. " requires AceLibrary") end +if not AceLibrary:IsNewVersion(MAJOR_VERSION, MINOR_VERSION) then return end + +local DEBUG = false + + +local SCROLL_UP = "Scroll up" +local SCROLL_DOWN = "Scroll down" +local HINT = "Hint" +local DETACH = "Detach" +local DETACH_DESC = "Detach the tablet from its source." +local SIZE = "Size" +local SIZE_DESC = "Scale the tablet." +local CLOSE_MENU = "Close menu" +local CLOSE_MENU_DESC = "Close the menu." +local COLOR = "Background color" +local COLOR_DESC = "Set the background color." +local LOCK = "Lock" +local LOCK_DESC = "Lock the tablet in its current position. Alt+Right-click for menu or Alt+drag to drag it when locked." + +if GetLocale() == "deDE" then + SCROLL_UP = "Hochscrollen" + SCROLL_DOWN = "Runterscrollen" + HINT = "Hinweis" + DETACH = "L\195\182sen" + DETACH_DESC = "L\195\182st den Tooltip aus seiner Verankerung." + SIZE = "Gr\195\182\195\159e" + SIZE_DESC = "Gr\195\182\195\159e des Tooltips \195\164ndern." + CLOSE_MENU = "Menu schlie\195\159en" + CLOSE_MENU_DESC = "Schlie\195\159t das Menu." + COLOR = "Hintergrundfarbe" + COLOR_DESC = "Hintergrundfarbe setzen." + LOCK = "Sperren" + LOCK_DESC = "Sperrt die aktuelle Position vom Tooltip. Alt+Rechts-klick f\195\188rs Men\195\188 oder Alt+Verschieben f\195\188rs verschieben wenn es gesperrt ist." +elseif GetLocale() == "koKR" then + SCROLL_UP = "위로 스크롤" + SCROLL_DOWN = "아래로 스크롤" + HINT = "힌트" + DETACH = "분리" + DETACH_DESC = "테이블을 분리합니다." + SIZE = "크기" + SIZE_DESC = "테이블의 크기입니다." + CLOSE_MENU = "메뉴 닫기" + CLOSE_MENU_DESC = "메뉴를 닫습니다." + COLOR = "배경 색상" + COLOR_DESC = "배경 색상을 설정합니다." + LOCK = "고정" + LOCK_DESC = "현재 위치에 테이블을 고정합니다. 알트+우클릭 : 메뉴열기, 알트+드래그 : 고정된것을 드래그합니다." +elseif GetLocale() == "zhCN" then + SCROLL_UP = "向上翻转" + SCROLL_DOWN = "向上翻转" + HINT = "提示" + DETACH = "分离" + DETACH_DESC = "分离菜单为独立提示." + SIZE = "尺寸" + SIZE_DESC = "缩放菜单显示尺寸." + CLOSE_MENU = "关闭菜单" + CLOSE_MENU_DESC = "关闭菜单" + COLOR = "背景颜色" + COLOR_DESC = "设置菜单背景颜色." + LOCK = "锁定" + LOCK_DESC = "锁定菜单当前位置. alt+右键 将显示选项, alt+拖动 可以移动已锁定的菜单." +elseif GetLocale() == "zhTW" then + SCROLL_UP = "向上翻轉" + SCROLL_DOWN = "向上翻轉" + HINT = "提示" + DETACH = "分離" + DETACH_DESC = "分離選單為獨立提示。" + SIZE = "尺寸" + SIZE_DESC = "縮放選單顯示尺寸。" + CLOSE_MENU = "關閉選單" + CLOSE_MENU_DESC = "關閉選單" + COLOR = "背景顏色" + COLOR_DESC = "設置選單背景顏色。" + LOCK = "鎖定" + LOCK_DESC = "鎖定選單目前位置. Alt+右鍵 將顯示選項,Alt+拖動 可以移動已鎖定的選單。" +elseif GetLocale() == "frFR" then + SCROLL_UP = "Parcourir vers le haut" + SCROLL_DOWN = "Parcourir vers le bas" + HINT = "Astuce" + DETACH = "D\195\169tacher" + DETACH_DESC = "Permet de d\195\169tacher le tableau de sa source." + SIZE = "Taille" + SIZE_DESC = "Permet de changer l'\195\169chelle du tableau." + CLOSE_MENU = "Fermer le menu" + CLOSE_MENU_DESC = "Ferme ce menu." + COLOR = "Couleur du fond" + COLOR_DESC = "Permet de d\195\169finir la couleur du fond." + LOCK = "Bloquer" + LOCK_DESC = "Bloque le tableau \195\160 sa position actuelle. Alt+clic-droit pour le menu ou Alt+glisser pour le d\195\169placer quand il est bloqu\195\169." +end + +local start = GetTime() +local wrap +local GetProfileInfo +if DEBUG then + local tree = {} + local treeMemories = {} + local treeTimes = {} + local memories = {} + local times = {} + function wrap(value, name) + if type(value) == "function" then + local oldFunction = value + memories[name] = 0 + times[name] = 0 + return function(self, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20, a21, a22, a23, a24, a25, a26, a27, a28, a29, a30, a31, a32, a33, a34, a35, a36, a37, a38, a39, a40, a41, a42, a43, a44, a45, a46, a47, a48, a49, a50, a51, a52, a53, a54, a55, a56, a57, a58, a59, a60) + local pos = table.getn(tree) + table.insert(tree, name) + table.insert(treeMemories, 0) + table.insert(treeTimes, 0) + local t, mem = GetTime(), gcinfo() + local r1, r2, r3, r4, r5, r6, r7, r8 = oldFunction(self, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20, a21, a22, a23, a24, a25, a26, a27, a28, a29, a30, a31, a32, a33, a34, a35, a36, a37, a38, a39, a40, a41, a42, a43, a44, a45, a46, a47, a48, a49, a50, a51, a52, a53, a54, a55, a56, a57, a58, a59, a60) + mem, t = gcinfo() - mem, GetTime() - t + if pos > 0 then + treeMemories[pos] = treeMemories[pos] + mem + treeTimes[pos] = treeTimes[pos] + t + end + local otherMem = table.remove(treeMemories) + if mem - otherMem > 0 then + memories[name] = memories[name] + mem - otherMem + end + times[name] = times[name] + t - table.remove(treeTimes) + table.remove(tree) + return r1, r2, r3, r4, r5, r6, r7, r8 + end + end + end + + function GetProfileInfo() + return GetTime() - start, times, memories + end +else + function wrap(value) + return value + end +end + +local MIN_TOOLTIP_SIZE = 200 +local Tablet = {} +local function getsecond(_, value) + return value +end +local Dewdrop +local sekeys +local CleanCategoryPool +local pool = {} + +local table_setn +do + local version = GetBuildInfo() + if string.find(version, "^2%.") then + -- 2.0.0 + table_setn = function() end + else + table_setn = table.setn + end +end + +local function del(t) + if t then + for k in pairs(t) do + t[k] = nil + end + setmetatable(t, nil) + table_setn(t, 0) + table.insert(pool, t) + end +end + +local new + +local function copy(parent) + local t + if table.getn(pool) > 0 then + t = table.remove(pool) + else + t = {} + end + if parent then + for k,v in pairs(parent) do + t[k] = v + end + table_setn(t, table.getn(parent)) + setmetatable(t, getmetatable(parent)) + end + return t +end + +function new(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20, k21, v21, k22, v22, k23, v23, k24, v24, k25, v25, k26, v26, k27, v27, k28, v28, k29, v29, k30, v30) + local t + if table.getn(pool) > 0 then + t = table.remove(pool) + else + t = {} + end + if k1 then t[k1] = v1 + if k2 then t[k2] = v2 + if k3 then t[k3] = v3 + if k4 then t[k4] = v4 + if k5 then t[k5] = v5 + if k6 then t[k6] = v6 + if k7 then t[k7] = v7 + if k8 then t[k8] = v8 + if k9 then t[k9] = v9 + if k10 then t[k10] = v10 + if k11 then t[k11] = v11 + if k12 then t[k12] = v12 + if k13 then t[k13] = v13 + if k14 then t[k14] = v14 + if k15 then t[k15] = v15 + if k16 then t[k16] = v16 + if k17 then t[k17] = v17 + if k18 then t[k18] = v18 + if k19 then t[k19] = v19 + if k20 then t[k20] = v20 + if k21 then t[k21] = v21 + if k22 then t[k22] = v22 + if k23 then t[k23] = v23 + if k24 then t[k24] = v24 + if k25 then t[k25] = v25 + if k26 then t[k26] = v26 + if k27 then t[k27] = v27 + if k28 then t[k28] = v28 + if k29 then t[k29] = v29 + if k30 then t[k30] = v30 + end end end end end end end end end end end end end end end end end end end end end end end end end end end end end end + return t +end +local tmp +tmp = setmetatable({}, {__index = function(self, key) + local t = {} + tmp[key] = function(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20, k21, v21, k22, v22, k23, v23, k24, v24, k25, v25, k26, v26, k27, v27, k28, v28, k29, v29, k30, v30) + for k in pairs(t) do + t[k] = nil + end + if k1 then t[k1] = v1 + if k2 then t[k2] = v2 + if k3 then t[k3] = v3 + if k4 then t[k4] = v4 + if k5 then t[k5] = v5 + if k6 then t[k6] = v6 + if k7 then t[k7] = v7 + if k8 then t[k8] = v8 + if k9 then t[k9] = v9 + if k10 then t[k10] = v10 + if k11 then t[k11] = v11 + if k12 then t[k12] = v12 + if k13 then t[k13] = v13 + if k14 then t[k14] = v14 + if k15 then t[k15] = v15 + if k16 then t[k16] = v16 + if k17 then t[k17] = v17 + if k18 then t[k18] = v18 + if k19 then t[k19] = v19 + if k20 then t[k20] = v20 + if k21 then t[k21] = v21 + if k22 then t[k22] = v22 + if k23 then t[k23] = v23 + if k24 then t[k24] = v24 + if k25 then t[k25] = v25 + if k26 then t[k26] = v26 + if k27 then t[k27] = v27 + if k28 then t[k28] = v28 + if k29 then t[k29] = v29 + if k30 then t[k30] = v30 + end end end end end end end end end end end end end end end end end end end end end end end end end end end end end end + return t + end + return tmp[key] +end}) + +local headerSize, normalSize +if GameTooltipHeaderText then + _,headerSize = GameTooltipHeaderText:GetFont() +else + headerSize = 14 +end +if GameTooltipText then + _,normalSize = GameTooltipText:GetFont() +else + normalSize = 12 +end +local tooltip +local testString +local TabletData = {} +local Category = {} +local Line = {} +do + local TabletData_mt = { __index = TabletData } + function TabletData:new(tablet) + if not testString then + testString = UIParent:CreateFontString() + testString:Hide() + end + local self = new() + self.categories = new() + self.id = 0 + self.width = 0--(MIN_TOOLTIP_SIZE - 20)*tablet.fontSizePercent + self.tablet = tablet + self.title = "Title" + setmetatable(self, TabletData_mt) + return self + end + + function TabletData:del() + for k, v in ipairs(self.categories) do + v:del() + end + del(self.categories) + del(self) + end + + function TabletData:Display() + if self.tablet == tooltip or self.tablet.registration.showTitleWhenDetached then + local info = new( + 'hideBlankLine', true, + 'text', self.title, + 'justify', "CENTER", + 'font', GameTooltipHeaderText, + 'isTitle', true + ) + self:AddCategory(info, 1) + del(info) + end + if self.tablet == tooltip or self.tablet.registration.showHintWhenDetached then + if self.hint then + self:AddCategory(nil):AddLine( + 'text', HINT .. ": " .. self.hint, + 'textR', 0, + 'textG', 1, + 'textB', 0, + 'wrap', true + ) + end + end + + local tabletData = self.tabletData + local width + for k, v in ipairs(self.categories) do + if v.columns <= 2 then + width = v.x1 + else + width = v.x1 + v.x2 + v.x3 + v.x4 + v.x5 + v.x6 + (v.columns - 1) * 20 + end + if self.width < width then + self.width = width + end + end + + local good = false + local lastTitle = true + for k, v in ipairs(self.categories) do + if lastTitle then + v.hideBlankLine = true + lastTitle = false + end + if v:Display(self.tablet) then + good = true + end + if v.isTitle then + lastTitle = true + end + end + if not good then + if self.tablet == tooltip or not self.tablet.registration.hideWhenEmpty then + local width + local info = new( + 'hideBlankLine', true, + 'text', self.title, + 'justify', "CENTER", + 'font', GameTooltipHeaderText, + 'isTitle', true + ) + local cat = self:AddCategory(info) + del(info) + self.width = self.categories[table.getn(self.categories)].x1 + cat:Display(self.tablet) + else + self.tablet:__Hide() + self.tablet.tmpHidden = true + end + else + self.tablet:__Show() + self.tablet.tmpHidden = nil + end + end + + function TabletData:AddCategory(info, index) + local made = false + if not info then + made = true + info = new() + end + local cat = Category:new(self, info) + if index then + table.insert(self.categories, index, cat) + else + table.insert(self.categories, cat) + end + if made then + del(info) + end + return cat + end + + function TabletData:SetHint(hint) + self.hint = hint + end + + function TabletData:SetTitle(title) + self.title = title or "Title" + end +end +do + local Category_mt = { __index = Category } + function Category:new(tabletData, info, superCategory) + local self = copy(info) + if superCategory and not self.noInherit then + self.superCategory = superCategory.superCategory + for k, v in pairs(superCategory) do + if string.find(k, "^child_") then + local k = strsub(k, 7) + if self[k] == nil then + self[k] = v + end + end + end + self.columns = superCategory.columns + else + self.superCategory = self + end + self.tabletData = tabletData + self.lines = new() + if not self.columns then + self.columns = 1 + end + self.x1 = 0 + self.x2 = 0 + self.x3 = 0 + self.x4 = 0 + self.x5 = 0 + self.x6 = 0 + setmetatable(self, Category_mt) + self.lastWasTitle = nil + if self.text or self.text2 or self.text3 or self.text4 or self.text5 or self.text6 then + local x = new( + 'category', category, + 'text', self.text, + 'textR', self.textR or 1, + 'textG', self.textG or 1, + 'textB', self.textB or 1, + 'fakeChild', true, + 'func', self.func, + 'arg1', info.arg1, + 'arg2', self.arg2, + 'arg3', self.arg3, + 'hasCheck', self.hasCheck, + 'checked', self.checked, + 'checkIcon', self.checkIcon, + 'isRadio', self.isRadio, + 'font', self.font, + 'size', self.size, + 'wrap', self.wrap, + 'catStart', true, + 'indentation', self.indentation, + 'noInherit', true, + 'justify', self.justify, + 'justify2', self.justify2, + 'justify3', self.justify3, + 'justify4', self.justify4, + 'justify5', self.justify5, + 'justify6', self.justify6 + ) + if self.isTitle then + x.textR = self.textR or 1 + x.textG = self.textG or 0.823529 + x.textB = self.textB or 0 + else + x.textR = self.textR or 1 + x.textG = self.textG or 1 + x.textB = self.textB or 1 + end + x.text2 = self.text2 + x.text3 = self.text3 + x.text4 = self.text4 + x.text5 = self.text5 + x.text6 = self.text6 + x.text2R = self.text2R or self.textR2 or 1 + x.text2G = self.text2G or self.textG2 or 1 + x.text2B = self.text2B or self.textB2 or 1 + x.text3R = self.text3R or self.textR3 or 1 + x.text3G = self.text3G or self.textG3 or 1 + x.text3B = self.text3B or self.textB3 or 1 + x.text4R = self.text4R or self.textR4 or 1 + x.text4G = self.text4G or self.textG4 or 1 + x.text4B = self.text4B or self.textB4 or 1 + x.text5R = self.text5R or self.textR5 or 1 + x.text5G = self.text5G or self.textG5 or 1 + x.text5B = self.text5B or self.textB5 or 1 + x.text6R = self.text6R or self.textR6 or 1 + x.text6G = self.text6G or self.textG6 or 1 + x.text6B = self.text6B or self.textB6 or 1 + x.font2 = self.font2 + x.font3 = self.font3 + x.font4 = self.font4 + x.font5 = self.font5 + x.font6 = self.font6 + x.size2 = self.size2 + x.size3 = self.size3 + x.size4 = self.size4 + x.size5 = self.size5 + x.size6 = self.size6 + self:AddLine(x) + del(x) + self.lastWasTitle = true + end + return self + end + + function Category:del() + local prev = garbageLine + for k, v in pairs(self.lines) do + v:del() + end + del(self.lines) + del(self) + end + + function Category:AddLine(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20, k21, v21, k22, v22, k23, v23, k24, v24, k25, v25, k26, v26, k27, v27, k28, v28, k29, v29, k30, v30) + self.lastWasTitle = nil + local line + if type(k1) == "table" then + Line:new(self, k1, v1) + else + local info = new(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20, k21, v21, k22, v22, k23, v23, k24, v24, k25, v25, k26, v26, k27, v27, k28, v28, k29, v29, k30, v30) + Line:new(self, info) + del(info) + end + end + + function Category:AddCategory(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20, k21, v21, k22, v22, k23, v23, k24, v24, k25, v25, k26, v26, k27, v27, k28, v28, k29, v29, k30, v30) + local lastWasTitle = self.lastWasTitle + self.lastWasTitle = nil + local info + if type(k1) == "table" then + info = k1 + else + info = new(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20, k21, v21, k22, v22, k23, v23, k24, v24, k25, v25, k26, v26, k27, v27, k28, v28, k29, v29, k30, v30) + end + if lastWasTitle or table.getn(self.lines) == 0 then + info.hideBlankLine = true + end + local cat = Category:new(self.tabletData, info, self) + table.insert(self.lines, cat) + return cat + end + + function Category:HasChildren() + local hasChildren = false + for k, v in ipairs(self.lines) do + if v.HasChildren then + if v:HasChildren() then + return true + end + end + if not v.fakeChild then + return true + end + end + return false + end + + local lastWasTitle = false + function Category:Display(tablet) + if not self.isTitle and not self.showWithoutChildren and not self:HasChildren() then + return false + end + if not self.hideBlankLine and not lastWasTitle then + local info = new( + 'blank', true, + 'fakeChild', true + ) + self:AddLine(info, 1) + del(info) + end + local good = false + if table.getn(self.lines) > 0 then + self.tabletData.id = self.tabletData.id + 1 + self.id = self.tabletData.id + for k, v in ipairs(self.lines) do + if v:Display(tablet) then + good = true + end + end + end + lastWasTitle = self.isTitle + return good + end +end +do + local Line_mt = { __index = Line } + function Line:new(category, info, position) + local self = copy(info) + if not info.noInherit then + for k, v in pairs(category) do + if string.find(k, "^child_") then + local k = strsub(k, 7) + if self[k] == nil then + self[k] = v + end + end + end + end + self.category = category + if position then + table.insert(category.lines, position, self) + else + table.insert(category.lines, self) + end + setmetatable(self, Line_mt) + local columns = category.columns + if columns == 1 then + if not self.justify then + self.justify = "LEFT" + end + elseif columns == 2 then + self.justify = "LEFT" + self.justify2 = "RIGHT" + if self.wrap then + self.wrap2 = false + end + elseif columns == 3 then + if not self.justify then + self.justify = "LEFT" + end + if not self.justify2 then + self.justify2 = "CENTER" + end + if not self.justify3 then + self.justify3 = "RIGHT" + end + if self.wrap then + self.wrap2 = false + self.wrap3 = false + elseif self.wrap2 then + self.wrap3 = false + end + elseif columns == 4 then + if not self.justify then + self.justify = "LEFT" + end + if not self.justify2 then + self.justify2 = "CENTER" + end + if not self.justify3 then + self.justify3 = "CENTER" + end + if not self.justify4 then + self.justify4 = "RIGHT" + end + if self.wrap then + self.wrap2 = false + self.wrap3 = false + self.wrap4 = false + elseif self.wrap2 then + self.wrap3 = false + self.wrap4 = false + elseif self.wrap3 then + self.wrap4 = false + end + elseif columns == 5 then + if not self.justify then + self.justify = "LEFT" + end + if not self.justify2 then + self.justify2 = "CENTER" + end + if not self.justify3 then + self.justify3 = "CENTER" + end + if not self.justify4 then + self.justify4 = "CENTER" + end + if not self.justify5 then + self.justify5 = "RIGHT" + end + if self.wrap then + self.wrap2 = false + self.wrap3 = false + self.wrap4 = false + self.wrap5 = false + elseif self.wrap2 then + self.wrap3 = false + self.wrap4 = false + self.wrap5 = false + elseif self.wrap3 then + self.wrap4 = false + self.wrap5 = false + elseif self.wrap4 then + self.wrap5 = false + end + elseif columns == 6 then + if not self.justify then + self.justify = "LEFT" + end + if not self.justify2 then + self.justify2 = "CENTER" + end + if not self.justify3 then + self.justify3 = "CENTER" + end + if not self.justify4 then + self.justify4 = "CENTER" + end + if not self.justify5 then + self.justify5 = "CENTER" + end + if not self.justify6 then + self.justify6 = "RIGHT" + end + if self.wrap then + self.wrap2 = false + self.wrap3 = false + self.wrap4 = false + self.wrap5 = false + self.wrap6 = false + elseif self.wrap2 then + self.wrap3 = false + self.wrap4 = false + self.wrap5 = false + self.wrap6 = false + elseif self.wrap3 then + self.wrap4 = false + self.wrap5 = false + self.wrap6 = false + elseif self.wrap4 then + self.wrap5 = false + self.wrap6 = false + elseif self.wrap5 then + self.wrap6 = false + end + end + if self.textR2 then + self.text2R, self.textR2 = self.text2R or self.textR2 + self.text2G, self.textG2 = self.text2G or self.textG2 + self.text2B, self.textB2 = self.text2B or self.textB2 + if self.textR3 then + self.text3R, self.textR3 = self.text3R or self.textR3 + self.text3G, self.textG3 = self.text3G or self.textG3 + self.text3B, self.textB3 = self.text3B or self.textB3 + if self.textR4 then + self.text4R, self.textR4 = self.text4R or self.textR4 + self.text4G, self.textG4 = self.text4G or self.textG4 + self.text4B, self.textB4 = self.text4B or self.textB4 + if self.textR5 then + self.text5R, self.textR5 = self.text5R or self.textR5 + self.text5G, self.textG5 = self.text5G or self.textG5 + self.text5B, self.textB5 = self.text5B or self.textB5 + if self.textR5 then + self.text6R, self.textR6 = self.text6R or self.textR6 + self.text6G, self.textG6 = self.text6G or self.textG6 + self.text6B, self.textB6 = self.text6B or self.textB6 + end + end + end + end + end + if not self.indentation or self.indentation < 0 then + self.indentation = 0 + end + if not self.font then + self.font = GameTooltipText + end + if not self.font2 then + self.font2 = self.font + end + if not self.font3 then + self.font3 = self.font + end + if not self.font4 then + self.font4 = self.font + end + if not self.font5 then + self.font5 = self.font + end + if not self.font6 then + self.font6 = self.font + end + if not self.size then + _,self.size = self.font:GetFont() + end + if not self.size2 then + _,self.size2 = self.font2:GetFont() + end + if not self.size3 then + _,self.size3 = self.font3:GetFont() + end + if not self.size4 then + _,self.size4 = self.font4:GetFont() + end + if not self.size5 then + _,self.size5 = self.font5:GetFont() + end + if not self.size6 then + _,self.size6 = self.font6:GetFont() + end + + local fontSizePercent = category.tabletData.tablet.fontSizePercent + local w = 0 + self.checkWidth = 0 + if self.text then + if not self.wrap then + testString:SetWidth(0) + testString:SetFontObject(self.font) + local font,_,flags = testString:GetFont() + testString:SetFont(font, self.size * fontSizePercent, flags) + testString:SetText(self.text) + local checkWidth = self.hasCheck and self.size * fontSizePercent or 0 + self.checkWidth = checkWidth + w = testString:GetWidth() + self.indentation * fontSizePercent + checkWidth + if category.superCategory.x1 < w then + category.superCategory.x1 = w + end + else + if columns == 1 then + testString:SetWidth(0) + testString:SetFontObject(self.font) + local font,_,flags = testString:GetFont() + testString:SetFont(font, self.size * fontSizePercent, flags) + testString:SetText(self.text) + local checkWidth = self.hasCheck and self.size * fontSizePercent or 0 + self.checkWidth = checkWidth + w = testString:GetWidth() + self.indentation * fontSizePercent + checkWidth + if w > (MIN_TOOLTIP_SIZE - 20) * fontSizePercent then + w = (MIN_TOOLTIP_SIZE - 20) * fontSizePercent + end + else + w = MIN_TOOLTIP_SIZE * fontSizePercent / 2 + end + if category.superCategory.x1 < w then + category.superCategory.x1 = w + end + end + end + if columns == 2 and self.text2 then + if not self.wrap2 then + testString:SetWidth(0) + testString:SetFontObject(self.font2) + local font,_,flags = testString:GetFont() + testString:SetFont(font, self.size2 * fontSizePercent, flags) + testString:SetText(self.text2) + w = w + 40 * fontSizePercent + testString:GetWidth() + if category.superCategory.x1 < w then + category.superCategory.x1 = w + end + else + w = w + 40 * fontSizePercent + MIN_TOOLTIP_SIZE * fontSizePercent / 2 + if category.superCategory.x1 < w then + category.superCategory.x1 = w + end + end + elseif columns >= 3 then + if self.text2 then + if not self.wrap2 then + testString:SetWidth(0) + testString:SetFontObject(self.font2) + local font,_,flags = testString:GetFont() + testString:SetFont(font, self.size2 * fontSizePercent, flags) + testString:SetText(self.text2) + local w = testString:GetWidth() + if category.superCategory.x2 < w then + category.superCategory.x2 = w + end + else + local w = MIN_TOOLTIP_SIZE / 2 + if category.superCategory.x2 < w then + category.superCategory.x2 = w + end + end + end + if self.text3 then + if not self.wrap3 then + testString:SetWidth(0) + testString:SetFontObject(self.font3) + local font,_,flags = testString:GetFont() + testString:SetFont(font, self.size3 * fontSizePercent, flags) + testString:SetText(self.text3) + local w = testString:GetWidth() + if category.superCategory.x3 < w then + category.superCategory.x3 = w + end + else + local w = MIN_TOOLTIP_SIZE / 2 + if category.superCategory.x3 < w then + category.superCategory.x3 = w + end + end + end + if columns >= 4 then + if self.text4 then + if not self.wrap4 then + testString:SetWidth(0) + testString:SetFontObject(self.font4) + local font,_,flags = testString:GetFont() + testString:SetFont(font, self.size4 * fontSizePercent, flags) + testString:SetText(self.text4) + w = testString:GetWidth() + if category.superCategory.x4 < w then + category.superCategory.x4 = w + end + else + local w = MIN_TOOLTIP_SIZE / 2 + if category.superCategory.x4 < w then + category.superCategory.x4 = w + end + end + end + if columns >= 5 then + if self.text5 then + if not self.wrap5 then + testString:SetWidth(0) + testString:SetFontObject(self.font5) + local font,_,flags = testString:GetFont() + testString:SetFont(font, self.size5 * fontSizePercent, flags) + testString:SetText(self.text5) + w = testString:GetWidth() + if category.superCategory.x5 < w then + category.superCategory.x5 = w + end + else + local w = MIN_TOOLTIP_SIZE / 2 + if category.superCategory.x5 < w then + category.superCategory.x5 = w + end + end + end + if columns >= 6 then + if self.text6 then + if not self.wrap6 then + testString:SetWidth(0) + testString:SetFontObject(self.font6) + local font,_,flags = testString:GetFont() + testString:SetFont(font, self.size6 * fontSizePercent, flags) + testString:SetText(self.text6) + w = testString:GetWidth() + if category.superCategory.x6 < w then + category.superCategory.x6 = w + end + else + local w = MIN_TOOLTIP_SIZE / 2 + if category.superCategory.x6 < w then + category.superCategory.x6 = w + end + end + end + end + end + end + end + return self + end + + function Line:del() + del(self) + end + + function Line:Display(tablet) + tablet:AddLine(self) + return true + end +end + +local function button_OnEnter() + if type(this.self:GetScript("OnEnter")) == "function" then + this.self:GetScript("OnEnter")() + end + this.highlight:Show() +end + +local function button_OnLeave() + if type(this.self:GetScript("OnLeave")) == "function" then + this.self:GetScript("OnLeave")() + end + this.highlight:Hide() +end + +local function NewLine(self) + if self.maxLines <= self.numLines then + self.maxLines = self.maxLines + 1 + local button = CreateFrame("Button", nil, self) + button.indentation = 0 + local check = button:CreateTexture(nil, "ARTWORK") + local left = button:CreateFontString(nil, "ARTWORK") + local right = button:CreateFontString(nil, "ARTWORK") + local third = button:CreateFontString(nil, "ARTWORK") + local fourth = button:CreateFontString(nil, "ARTWORK") + local fifth = button:CreateFontString(nil, "ARTWORK") + local sixth = button:CreateFontString(nil, "ARTWORK") + local highlight = button:CreateTexture(nil, "BACKGROUND") + highlight:SetTexture("Interface\\QuestFrame\\UI-QuestTitleHighlight") + button.highlight = highlight + highlight:SetBlendMode("ADD") + highlight:SetAllPoints(button) + highlight:Hide() + table.insert(self.buttons, button) + table.insert(self.checks, check) + table.insert(self.lefts, left) + table.insert(self.rights, right) + table.insert(self.thirds, third) + table.insert(self.fourths, fourth) + table.insert(self.fifths, fifth) + table.insert(self.sixths, sixth) + left:SetWidth(0) + if self.maxLines == 1 then + left:SetFontObject(GameTooltipHeaderText) + right:SetFontObject(GameTooltipHeaderText) + third:SetFontObject(GameTooltipHeaderText) + fourth:SetFontObject(GameTooltipHeaderText) + fifth:SetFontObject(GameTooltipHeaderText) + sixth:SetFontObject(GameTooltipHeaderText) + left:SetJustifyH("CENTER") + button:SetPoint("TOPLEFT", self, "TOPLEFT", 8, -10) + else + left:SetFontObject(GameTooltipText) + right:SetFontObject(GameTooltipText) + third:SetFontObject(GameTooltipText) + fourth:SetFontObject(GameTooltipText) + fifth:SetFontObject(GameTooltipText) + sixth:SetFontObject(GameTooltipText) + button:SetPoint("TOPLEFT", self.buttons[self.maxLines - 1], "BOTTOMLEFT", 0, -2) + end + button:SetScript("OnEnter", button_OnEnter) + button:SetScript("OnLeave", button_OnLeave) + button.check = check + button.self = self + button:SetPoint("RIGHT", self, "RIGHT", -12, 0) + check.shown = false + check:SetPoint("TOPLEFT", button, "TOPLEFT") + left:SetPoint("TOPLEFT", check, "TOPLEFT") + right:SetPoint("TOPLEFT", left, "TOPRIGHT", 40 * self.fontSizePercent, 0) + third:SetPoint("TOPLEFT", right, "TOPRIGHT", 20 * self.fontSizePercent, 0) + fourth:SetPoint("TOPLEFT", third, "TOPRIGHT", 20 * self.fontSizePercent, 0) + fifth:SetPoint("TOPLEFT", fourth, "TOPRIGHT", 20 * self.fontSizePercent, 0) + sixth:SetPoint("TOPLEFT", fifth, "TOPRIGHT", 20 * self.fontSizePercent, 0) + right:SetJustifyH("RIGHT") + local _,size = GameTooltipText:GetFont() + check:SetHeight(size * 1.5) + check:SetWidth(size * 1.5) + check:SetTexture("Interface\\Buttons\\UI-CheckBox-Check") + check:SetAlpha(0) + if not button.clicked then + button:SetScript("OnMouseWheel", self:GetScript("OnMouseWheel")) + button:EnableMouseWheel(true) + button:Hide() + end + check:Show() + left:Hide() + right:Hide() + third:Hide() + fourth:Hide() + fifth:Hide() + sixth:Hide() + end +end +NewLine = wrap(NewLine, "NewLine") + +local function GetMaxLinesPerScreen(self) + if self == tooltip then + return floor(50 / self.fontSizePercent) + else + return floor(30 / self.fontSizePercent) + end +end +GetMaxLinesPerScreen = wrap(GetMaxLinesPerScreen, "GetMaxLinesPerScreen") + +local detachedTooltips = {} +local AcquireDetachedFrame, ReleaseDetachedFrame +local function AcquireFrame(self, registration, data, detachedData) + if not detachedData then + detachedData = data + end + if tooltip then + tooltip.data = data + tooltip.detachedData = detachedData + local fontSizePercent = tooltip.data and tooltip.data.fontSizePercent or 1 + local transparency = tooltip.data and tooltip.data.transparency or 0.75 + local r = tooltip.data and tooltip.data.r or 0 + local g = tooltip.data and tooltip.data.g or 0 + local b = tooltip.data and tooltip.data.b or 0 + tooltip:SetFontSizePercent(fontSizePercent) + tooltip:SetTransparency(transparency) + tooltip:SetColor(r, g, b) + else + tooltip = CreateFrame("Frame", "Tablet20Frame", UIParent) + self.tooltip = tooltip + tooltip.data = data + tooltip.detachedData = detachedData + tooltip:EnableMouse(true) + tooltip:EnableMouseWheel(true) + tooltip:SetFrameStrata("TOOLTIP") + tooltip:SetFrameLevel(10) + local backdrop = new( + 'bgFile', "Interface\\Buttons\\WHITE8X8", + 'edgeFile', "Interface\\Tooltips\\UI-Tooltip-Border", + 'tile', true, + 'tileSize', 16, + 'edgeSize', 16, + 'insets', new( + 'left', 5, + 'right', 5, + 'top', 5, + 'bottom', 5 + ) + ) + tooltip:SetBackdrop(backdrop) + del(backdrop.insets) + del(backdrop) + tooltip:SetBackdropColor(0, 0, 0, 1) + + tooltip.numLines = 0 + tooltip.owner = nil + tooltip.fontSizePercent = tooltip.data and tooltip.data.fontSizePercent or 1 + tooltip.maxLines = 0 + tooltip.buttons = {} + tooltip.checks = {} + tooltip.lefts = {} + tooltip.rights = {} + tooltip.thirds = {} + tooltip.fourths = {} + tooltip.fifths = {} + tooltip.sixths = {} + tooltip.transparency = tooltip.data and tooltip.data.transparency or 0.75 + tooltip:SetBackdropColor(0, 0, 0, tooltip.transparency) + tooltip:SetBackdropBorderColor(1, 1, 1, tooltip.transparency) + tooltip.scroll = 0 + + tooltip:SetScript("OnUpdate", function() + if not tooltip.updating and not tooltip.enteredFrame then + tooltip.scroll = 0 + tooltip:Hide() + tooltip.registration.tooltip = nil + tooltip.registration = nil + end + end) + + tooltip:SetScript("OnEnter", function() + if tooltip.clickable then + tooltip.enteredFrame = true + end + end) + + tooltip:SetScript("OnLeave", function() + if not tooltip.updating then + tooltip.enteredFrame = false + end + end) + + tooltip:SetScript("OnMouseWheel", function() + tooltip.updating = true + tooltip:Scroll(arg1 < 0) + tooltip.updating = false + end) + + NewLine(tooltip) + + tooltip.scrollUp = tooltip:CreateFontString(nil, "ARTWORK") + tooltip.scrollUp:SetPoint("TOPLEFT", tooltip.buttons[1], "BOTTOMLEFT", 0, -2) + tooltip.scrollUp:SetPoint("RIGHT", tooltip, "RIGHT", 0, -10) + tooltip.scrollUp:SetFontObject(GameTooltipText) + tooltip.scrollUp:Hide() + local font,_,flags = tooltip.scrollUp:GetFont() + tooltip.scrollUp:SetFont(font, normalSize * tooltip.fontSizePercent, flags) + tooltip.scrollUp:SetJustifyH("CENTER") + tooltip.scrollUp:SetTextColor(1, 0.823529, 0) + tooltip.scrollUp:SetText(" ") + + tooltip.scrollDown = tooltip:CreateFontString(nil, "ARTWORK") + tooltip.scrollDown:SetPoint("TOPLEFT", tooltip.buttons[1], "BOTTOMLEFT", 0, -2) + tooltip.scrollDown:SetPoint("RIGHT", tooltip, "RIGHT", 0, -10) + tooltip.scrollDown:SetFontObject(GameTooltipText) + tooltip.scrollDown:Hide() + local font,_,flags = tooltip.scrollUp:GetFont() + tooltip.scrollDown:SetFont(font, normalSize * tooltip.fontSizePercent, flags) + tooltip.scrollDown:SetJustifyH("CENTER") + tooltip.scrollDown:SetTextColor(1, 0.823529, 0) + tooltip.scrollDown:SetText(" ") + + function tooltip:SetOwner(o) + self:Hide(o) + self.owner = o + end + tooltip.SetOwner = wrap(tooltip.SetOwner, "tooltip:SetOwner") + + function tooltip:IsOwned(o) + return self.owner == o + end + tooltip.IsOwned = wrap(tooltip.IsOwned, "tooltip:IsOwned") + + function tooltip:ClearLines(hide) + CleanCategoryPool(self) + for i = 1, self.numLines do + local button = self.buttons[i] + local check = self.checks[i] + if not button.clicked or hide then + button:Hide() + end + check.shown = false + check:SetAlpha(0) + end + self.numLines = 0 + end + tooltip.ClearLines = wrap(tooltip.ClearLines, "tooltip:ClearLines") + + function tooltip:NumLines() + return self.numLines + end + + local lastWidth + local old_tooltip_Hide = tooltip.Hide + tooltip.__Hide = old_tooltip_Hide + function tooltip:Hide(newOwner) + if self == tooltip or newOwner == nil then + old_tooltip_Hide(self) + end + self:ClearLines(true) + self.owner = nil + self.lastWidth = nil + self.tmpHidden = nil + end + tooltip.Hide = wrap(tooltip.Hide, "tooltip:Hide") + + local old_tooltip_Show = tooltip.Show + tooltip.__Show = old_tooltip_Show + function tooltip:Show(tabletData) + if self.owner == nil or self.notInUse then + return + end + if not self.tmpHidden then + old_tooltip_Show(self) + end + + local maxWidth = tabletData and tabletData.width or self:GetWidth() - 20 + local hasWrap = false + local screenWidth = GetScreenWidth() + local scrollMax = self.numLines + if scrollMax > GetMaxLinesPerScreen(self) + self.scroll then + scrollMax = GetMaxLinesPerScreen(self) + self.scroll + end + local numColumns + + local height = 20 + if scrollMax ~= self.numLines then + self.scrollDown:SetWidth(maxWidth) + height = height + self.scrollDown:GetHeight() + 2 + end + if self.scroll ~= 0 then + self.scrollUp:SetWidth(maxWidth) + height = height + self.scrollUp:GetHeight() + 2 + end + self:SetWidth(maxWidth + 20) + + local tmp = self.scroll + 1 + if tmp ~= 1 then + tmp = tmp + 1 + end + for i = 1, self.numLines do + if i < tmp or i > scrollMax or (i == scrollMax and i ~= self.numLines) then + self.buttons[i]:ClearAllPoints() + self.buttons[i]:Hide() + else + local button = self.buttons[i] + local left = self.lefts[i] + local right = self.rights[i] + local check = self.checks[i] + button:SetWidth(maxWidth) + button:SetHeight(math.max(left:GetHeight(), right:GetHeight())) + height = height + button:GetHeight() + 2 + if i == self.scroll + 1 then + button:SetPoint("TOPLEFT", self, "TOPLEFT", 10, -10) + else + button:SetPoint("TOPLEFT", self.buttons[i - 1], "BOTTOMLEFT", 0, -2) + end + if button.clicked then + check:SetPoint("TOPLEFT", button, "TOPLEFT", button.indentation * self.fontSizePercent + (check.width - check:GetWidth()) / 2 + 1, -1) + else + check:SetPoint("TOPLEFT", button, "TOPLEFT", button.indentation * self.fontSizePercent + (check.width - check:GetWidth()) / 2, 0) + end + button:Show() + end + end + if self.scroll ~= 0 then + self.scrollUp:SetPoint("TOPLEFT", self, "TOPLEFT", 10, -10) + self.buttons[self.scroll + 2]:SetPoint("TOPLEFT", self.scrollUp, "BOTTOMLEFT", 0, -2) + self.scrollUp:SetText(SCROLL_UP .. " (" .. self.scroll + 2 .. " / " .. self.numLines .. ")") + self.scrollUp:Show() + else + self.scrollUp:Hide() + end + if scrollMax ~= self.numLines and self.buttons[scrollMax - 1] then + self.scrollDown:SetPoint("TOPLEFT", self.buttons[scrollMax - 1], "BOTTOMLEFT", 0, -2) + self.scrollDown:SetText(SCROLL_DOWN .. " (" .. scrollMax - 1 .. " / " .. self.numLines .. ")") + self.scrollDown:Show() + else + self.scrollDown:Hide() + end + self:SetHeight(height) + end + tooltip.Show = wrap(tooltip.Show, "tooltip:Show") + + local lastMouseDown + local function button_OnClick() + if this.self:HasScript("OnClick") and type(this.self:GetScript("OnClick")) == "function" then + this.self:GetScript("OnClick")() + end + if arg1 == "RightButton" then + if this.self:HasScript("OnClick") and type(this.self:GetScript("OnClick")) == "function" then + this.self:GetScript("OnClick")() + end + elseif arg1 == "LeftButton" then + if this.self.preventClick == nil or GetTime() > this.self.preventClick and GetTime() < lastMouseDown + 0.5 then + this.self.preventClick = nil + this.self.updating = true + this.self.preventRefresh = true + this.func(this.a1, this.a2, this.a3) + if this.self then + this.self.preventRefresh = false + this.self:children() + this.self.updating = false + end + end + end + end + local function button_OnMouseUp() + if this.self:HasScript("OnMouseUp") and type(this.self:GetScript("OnMouseUp")) == "function" then + this.self:GetScript("OnMouseUp")() + end + if arg1 ~= "RightButton" then + if this.clicked then + local a,b,c,d,e = this.check:GetPoint(1) + this.check:SetPoint(a,b,c,d-1,e+1) + this.clicked = false + end + end + end + local function button_OnMouseDown() + if this.self:HasScript("OnMouseDown") and type(this.self:GetScript("OnMouseDown")) == "function" then + this.self:GetScript("OnMouseDown")() + end + lastMouseDown = GetTime() + if arg1 ~= "RightButton" then + local a,b,c,d,e = this.check:GetPoint(1) + this.check:SetPoint(a,b,c,d+1,e-1) + this.clicked = true + end + end + function tooltip:AddLine(info) + local category = info.category.superCategory + local maxWidth = category.tabletData.width + local text = info.blank and "\n" or info.text + local id = info.id + local func = info.func + local checked = info.checked + local isRadio = info.isRadio + local checkTexture = info.checkTexture + local fontSizePercent = self.fontSizePercent + if not info.font then + info.font = GameTooltipText + end + if not info.size then + _,info.size = info.font:GetFont() + end + local catStart = false + local columns = category and category.columns or 1 + local x1, x2, x3, x4, x5, x6 + if category then + x1, x2, x3, x4, x5, x6 = category.x1, category.x2, category.x3, category.x4, category.x5, category.x6 + else + x1, x2, x3, x4, x5, x6 = 0, 0, 0, 0, 0, 0 + end + if info.isTitle then + justAddedTitle = true + end + + self.numLines = self.numLines + 1 + NewLine(self) + self.lefts[self.numLines]:Show() + self.buttons[self.numLines]:Show() + num = self.numLines + + local button = self.buttons[num] + button.indentation = info.indentation + local left = self.lefts[num] + local right = self.rights[num] + local third = self.thirds[num] + local fourth = self.fourths[num] + local fifth = self.fifths[num] + local sixth = self.sixths[num] + local check = self.checks[num] + do -- if columns >= 1 then + left:SetFontObject(info.font) + left:SetText(text) + left:Show() + if info.textR and info.textG and info.textB then + left:SetTextColor(info.textR, info.textG, info.textB) + else + left:SetTextColor(1, 0.823529, 0) + end + local a,_,b = left:GetFont() + left:SetFont(a, info.size * fontSizePercent, b) + left:SetJustifyH(info.justify) + if columns < 2 then + right:SetText(nil) + right:Hide() + right:SetPoint("TOPLEFT", left, "TOPRIGHT", 40 * fontSizePercent, 0) + right:SetPoint("TOPRIGHT", button, "TOPRIGHT", -5, 0) + third:SetText(nil) + third:Hide() + fourth:SetText(nil) + fourth:Hide() + fifth:SetText(nil) + fifth:Hide() + sixth:SetText(nil) + sixth:Hide() + else + right:SetFontObject(info.font2) + right:SetText(info.text2) + right:Show() + if info.text2R and info.text2G and info.text2B then + right:SetTextColor(info.text2R, info.text2G, info.text2B) + else + right:SetTextColor(1, 0.823529, 0) + end + local a,_,b = right:GetFont() + right:SetFont(a, info.size2 * fontSizePercent, b) + right:SetJustifyH(info.justify2) + if columns < 3 then + right:SetPoint("TOPLEFT", left, "TOPRIGHT", 40 * fontSizePercent, 0) + right:SetPoint("TOPRIGHT", button, "TOPRIGHT", -5, 0) + third:SetText(nil) + third:Hide() + fourth:SetText(nil) + fourth:Hide() + fifth:SetText(nil) + fifth:Hide() + sixth:SetText(nil) + sixth:Hide() + else + third:SetFontObject(info.font3) + third:SetText(info.text3) + third:Show() + if info.text3R and info.text3G and info.text3B then + third:SetTextColor(info.text3R, info.text3G, info.text3B) + else + third:SetTextColor(1, 0.823529, 0) + end + local a,_,b = third:GetFont() + third:SetFont(a, info.size3 * fontSizePercent, b) + right:ClearAllPoints() + right:SetPoint("TOPLEFT", left, "TOPRIGHT", 20 * fontSizePercent, 0) + third:SetJustifyH(info.justify3) + if columns < 4 then + fourth:SetText(nil) + fourth:Hide() + fifth:SetText(nil) + fifth:Hide() + sixth:SetText(nil) + sixth:Hide() + else + fourth:SetFontObject(info.font4) + fourth:SetText(info.text4) + fourth:Show() + if info.text4R and info.text4G and info.text4B then + fourth:SetTextColor(info.text4R, info.text4G, info.text4B) + else + fourth:SetTextColor(1, 0.823529, 0) + end + local a,_,b = fourth:GetFont() + fourth:SetFont(a, info.size4 * fontSizePercent, b) + fourth:SetJustifyH(info.justify4) + if columns < 5 then + fifth:SetText(nil) + fifth:Hide() + sixth:SetText(nil) + sixth:Hide() + else + fifth:SetFontObject(info.font5) + fifth:SetText(info.text5) + fifth:Show() + if info.text5R and info.text5G and info.text5B then + fifth:SetTextColor(info.text5R, info.text5G, info.text5B) + else + fifth:SetTextColor(1, 0.823529, 0) + end + local a,_,b = fourth:GetFont() + fifth:SetFont(a, info.size5 * fontSizePercent, b) + fifth:SetJustifyH(info.justify5) + if columns < 6 then + sixth:SetText(nil) + sixth:Hide() + else + sixth:SetFontObject(info.font6) + sixth:SetText(info.text6) + sixth:Show() + if info.text5R and info.text6G and info.text6B then + sixth:SetTextColor(info.text6R, info.text6G, info.text6B) + else + sixth:SetTextColor(1, 0.823529, 0) + end + local a,_,b = fourth:GetFont() + sixth:SetFont(a, info.size6 * fontSizePercent, b) + sixth:SetJustifyH(info.justify6) + end + end + end + end + end + end + + check:SetWidth(info.size) + check:SetHeight(info.size) + check.width = info.size + if info.hasCheck then + check.shown = true + check:Show() + if isRadio then + check:SetTexture(info.checkIcon or "Interface\\Buttons\\UI-RadioButton") + if info.checked then + check:SetAlpha(1) + check:SetTexCoord(0.25, 0.5, 0, 1) + else + check:SetAlpha(self.transparency) + check:SetTexCoord(0, 0.25, 0, 1) + end + else + if info.checkIcon then + check:SetTexture(info.checkIcon) + if string.sub(info.checkIcon, 1, 16) == "Interface\\Icons\\" then + check:SetTexCoord(0.05, 0.95, 0.05, 0.95) + else + check:SetTexCoord(0, 1, 0, 1) + end + else + check:SetTexture("Interface\\Buttons\\UI-CheckBox-Check") + check:SetWidth(info.size * 1.5) + check:SetHeight(info.size * 1.5) + check.width = info.size * 1.2 + check:SetTexCoord(0, 1, 0, 1) + end + check:SetAlpha(info.checked and 1 or 0) + end + left:SetPoint("TOPLEFT", check, "TOPLEFT", check.width, 0) + else + left:SetPoint("TOPLEFT", check, "TOPLEFT") + end + if columns == 1 then + left:SetWidth(maxWidth) + elseif columns == 2 then + left:SetWidth(0) + right:SetWidth(0) + if info.wrap then + left:SetWidth(maxWidth - right:GetWidth() - 40 * fontSizePercent) + elseif info.wrap2 then + right:SetWidth(maxWidth - left:GetWidth() - 40 * fontSizePercent) + end + right:ClearAllPoints() + right:SetPoint("TOPRIGHT", button, "TOPRIGHT", 0, 0) + if not info.text2 then + left:SetJustifyH(info.justify or "LEFT") + end + elseif columns == 3 then + left:SetWidth(x1 - info.checkWidth) + right:SetWidth(x2) + third:SetWidth(x3) + right:ClearAllPoints() + local num = (category.tabletData.width - x1 - x2 - x3) / 2 + right:SetPoint("TOPLEFT", left, "TOPRIGHT", num, 0) + third:SetPoint("TOPLEFT", right, "TOPRIGHT", num, 0) + elseif columns == 4 then + left:SetWidth(x1 - info.checkWidth) + right:SetWidth(x2) + third:SetWidth(x3) + fourth:SetWidth(x4) + local num = (category.tabletData.width - x1 - x2 - x3 - x4) / 3 + right:SetPoint("TOPLEFT", left, "TOPRIGHT", num, 0) + third:SetPoint("TOPLEFT", right, "TOPRIGHT", num, 0) + fourth:SetPoint("TOPLEFT", third, "TOPRIGHT", num, 0) + elseif columns == 5 then + left:SetWidth(x1 - info.checkWidth) + right:SetWidth(x2) + third:SetWidth(x3) + fourth:SetWidth(x4) + fifth:SetWidth(x5) + local num = (category.tabletData.width - x1 - x2 - x3 - x4 - x5) / 4 + right:SetPoint("TOPLEFT", left, "TOPRIGHT", num, 0) + third:SetPoint("TOPLEFT", right, "TOPRIGHT", num, 0) + fourth:SetPoint("TOPLEFT", third, "TOPRIGHT", num, 0) + fifth:SetPoint("TOPLEFT", fourth, "TOPRIGHT", num, 0) + elseif columns == 6 then + left:SetWidth(x1 - info.checkWidth) + right:SetWidth(x2) + third:SetWidth(x3) + fourth:SetWidth(x4) + fifth:SetWidth(x5) + sixth:SetWidth(x6) + local num = (category.tabletData.width - x1 - x2 - x3 - x4 - x5 - x6) / 5 + right:SetPoint("TOPLEFT", left, "TOPRIGHT", num, 0) + third:SetPoint("TOPLEFT", right, "TOPRIGHT", num, 0) + fourth:SetPoint("TOPLEFT", third, "TOPRIGHT", num, 0) + fifth:SetPoint("TOPLEFT", fourth, "TOPRIGHT", num, 0) + sixth:SetPoint("TOPLEFT", fifth, "TOPRIGHT", num, 0) + end + if not self.locked or IsAltKeyDown() then + local func = info.func + if func then + if type(func) == "string" then + Tablet:assert(type(info.arg1) == "table", "Cannot call method " .. info.func .. " on a non-table") + func = info.arg1[func] + Tablet:assert(type(func) == "function", "Method " .. info.func .. " nonexistant") + end + Tablet:assert(type(func) == "function", "func must be a function or method") + button.func = func + button.a1 = info.arg1 + button.a2 = info.arg2 + button.a3 = info.arg3 + button.self = self + button:SetScript("OnMouseUp", button_OnMouseUp) + button:SetScript("OnMouseDown", button_OnMouseDown) + button:SetScript("OnClick", button_OnClick) + if button.clicked then + button:SetButtonState("PUSHED") + end + button:EnableMouse(true) + else + button:SetScript("OnMouseDown", nil) + button:SetScript("OnMouseUp", nil) + button:SetScript("OnClick", nil) + button:EnableMouse(false) + end + else + button:SetScript("OnMouseDown", nil) + button:SetScript("OnMouseUp", nil) + button:SetScript("OnClick", nil) + button:EnableMouse(false) + end + end + tooltip.AddLine = wrap(tooltip.AddLine, "tooltip:AddLine") + + function tooltip:SetFontSizePercent(percent) + local data, detachedData = self.data, self.detachedData + if detachedData and detachedData.detached then + data = detachedData + end + local lastSize = self.fontSizePercent + percent = tonumber(percent) or 1 + if percent < 0.25 then + percent = 0.25 + elseif percent > 4 then + percent = 4 + end + self.fontSizePercent = percent + if data then + data.fontSizePercent = percent ~= 1 and percent or nil + end + self.scrollUp:SetFont(font, normalSize * self.fontSizePercent, flags) + self.scrollDown:SetFont(font, normalSize * self.fontSizePercent, flags) + local ratio = self.fontSizePercent / lastSize + for i = 1, self.numLines do + local left = self.lefts[i] + local right = self.rights[i] + local third = self.thirds[i] + local fourth = self.fourths[i] + local fifth = self.fifths[i] + local sixth = self.sixths[i] + local check = self.checks[i] + local font, size, flags = left:GetFont() + left:SetFont(font, size * ratio, flags) + font, size, flags = right:GetFont() + right:SetFont(font, size * ratio, flags) + font, size, flags = third:GetFont() + third:SetFont(font, size * ratio, flags) + font, size, flags = fourth:GetFont() + fourth:SetFont(font, size * ratio, flags) + font, size, flags = fifth:GetFont() + fifth:SetFont(font, size * ratio, flags) + font, size, flags = sixth:GetFont() + sixth:SetFont(font, size * ratio, flags) + check.width = check.width * ratio + check:SetWidth(check:GetWidth() * ratio) + check:SetHeight(check:GetHeight() * ratio) + end + self:SetWidth((self:GetWidth() - 51) * ratio + 51) + self:SetHeight((self:GetHeight() - 51) * ratio + 51) + if self:IsShown() and self.children then + self:Show() + end + end + tooltip.SetFontSizePercent = wrap(tooltip.SetFontSizePercent, "tooltip:SetFontSizePercent") + + function tooltip:GetFontSizePercent() + return self.fontSizePercent + end + + function tooltip:SetTransparency(alpha) + local data, detachedData = self.data, self.detachedData + if detachedData and detachedData.detached then + data = detachedData + end + self.transparency = alpha + if data then + data.transparency = alpha ~= 0.75 and alpha or nil + end + self:SetBackdropColor(self.r or 0, self.g or 0, self.b or 0, alpha) + self:SetBackdropBorderColor(1, 1, 1, alpha) + end + tooltip.SetTransparency = wrap(tooltip.SetTransparency, "tooltip:SetTransparency") + + function tooltip:GetTransparency() + return self.transparency + end + + function tooltip:SetColor(r, g, b) + local data, detachedData = self.data, self.detachedData + if detachedData and detachedData.detached then + data = detachedData + end + self.r = r + self.g = g + self.b = b + if data then + data.r = r ~= 0 and r or nil + data.g = g ~= 0 and g or nil + data.b = b ~= 0 and b or nil + end + self:SetBackdropColor(r or 0, g or 0, b or 0, self.transparency) + self:SetBackdropBorderColor(1, 1, 1, self.transparency) + end + tooltip.SetColor = wrap(tooltip.SetColor, "tooltip:SetColor") + + function tooltip:GetColor() + return self.r, self.g, self.b + end + + function tooltip:Scroll(down) + if down then + if IsShiftKeyDown() then + self.scroll = self.numLines - GetMaxLinesPerScreen(self) + else + self.scroll = self.scroll + 3 + end + else + if IsShiftKeyDown() then + self.scroll = 0 + else + self.scroll = self.scroll - 3 + end + end + if self.scroll > self.numLines - GetMaxLinesPerScreen(self) then + self.scroll = self.numLines - GetMaxLinesPerScreen(self) + end + if self.scroll < 0 then + self.scroll = 0 + end + if self:IsShown() then + self:Show() + end + end + tooltip.Scroll = wrap(tooltip.Scroll, "tooltip:Scroll") + + function tooltip.Detach(tooltip) + local owner = tooltip.owner + tooltip:Hide() + self:assert(tooltip.detachedData, "You cannot detach if detachedData is not present") + tooltip.detachedData.detached = true + local detached = AcquireDetachedFrame(self, tooltip.registration, tooltip.data, tooltip.detachedData) + + detached.menu, tooltip.menu = tooltip.menu, nil + detached.children = tooltip.children + tooltip.children = nil + detached:SetOwner(owner) + detached:children() + detached:Show() + end + tooltip.Detach = wrap(tooltip.Detach, "tooltip:Detach") + + end + + tooltip.registration = registration + registration.tooltip = tooltip + return tooltip +end +AcquireFrame = wrap(AcquireFrame, "AcquireFrame") + +function ReleaseDetachedFrame(self, data, detachedData) + if not detachedData then + detachedData = data + end + for _, detached in ipairs(detachedTooltips) do + if detached.detachedData == detachedData then + detached.notInUse = true + detached:Hide() + detached.registration.tooltip = nil + detached.registration = nil + end + end +end +ReleaseDetachedFrame = wrap(ReleaseDetachedFrame, "ReleaseDetachedFrame") + +local StartCheckingAlt, StopCheckingAlt +do + local frame + function StartCheckingAlt(func) + if not frame then + frame = CreateFrame("Frame") + end + local last = IsAltKeyDown() + frame:SetScript("OnUpdate", function() + local now = IsAltKeyDown() + if last ~= now then + last = now + func() + end + end) + end + function StopCheckingAlt() + if frame then + frame:SetScript("OnUpdate", nil) + end + end +end + +function AcquireDetachedFrame(self, registration, data, detachedData) + if not detachedData then + detachedData = data + end + for _, detached in ipairs(detachedTooltips) do + if detached.notInUse then + detached.data = data + detached.detachedData = detachedData + detached.notInUse = nil + local fontSizePercent = detachedData.fontSizePercent or 1 + local transparency = detachedData.transparency or 0.75 + local r = detachedData.r or 0 + local g = detachedData.g or 0 + local b = detachedData.b or 0 + detached:SetFontSizePercent(fontSizePercent) + detached:SetTransparency(transparency) + detached:SetColor(r, g, b) + detached:ClearAllPoints() + detached:SetPoint(detachedData.anchor or "CENTER", UIParent, detachedData.anchor or "CENTER", detachedData.offsetx or 0, detachedData.offsety or 0) + detached.registration = registration + registration.tooltip = detached + return detached + end + end + + if not Dewdrop and AceLibrary:HasInstance("Dewdrop-2.0") then + Dewdrop = AceLibrary("Dewdrop-2.0") + end + StartCheckingAlt(function() + for _, detached in ipairs(detachedTooltips) do + if detached:IsShown() and detached.locked then + detached:EnableMouse(IsAltKeyDown()) + detached:children() + if detached.moving then + local a1 = arg1 + arg1 = "LeftButton" + if type(detached:GetScript("OnMouseUp")) == "function" then + detached:GetScript("OnMouseUp")() + end + arg1 = a1 + end + end + end + end) + if not tooltip then + AcquireFrame(self, {}) + end + local detached = CreateFrame("Frame", "Tablet20DetachedFrame" .. (table.getn(detachedTooltips) + 1), UIParent) + table.insert(detachedTooltips, detached) + detached.notInUse = true + detached:EnableMouse(not data.locked) + detached:EnableMouseWheel(true) + detached:SetMovable(true) + detached:SetPoint(data.anchor or "CENTER", UIParent, data.anchor or "CENTER", data.offsetx or 0, data.offsety or 0) + + detached.numLines = 0 + detached.owner = nil + detached.fontSizePercent = 1 + detached.maxLines = 0 + detached.buttons = {} + detached.checks = {} + detached.lefts = {} + detached.rights = {} + detached.thirds = {} + detached.fourths = {} + detached.fifths = {} + detached.sixths = {} + detached.transparency = 0.75 + detached.r = 0 + detached.g = 0 + detached.b = 0 + detached:SetFrameStrata("BACKGROUND") + detached:SetBackdrop(tmp.a( + 'bgFile', "Interface\\Buttons\\WHITE8X8", + 'edgeFile', "Interface\\Tooltips\\UI-Tooltip-Border", + 'tile', true, + 'tileSize', 16, + 'edgeSize', 16, + 'insets', tmp.b( + 'left', 5, + 'right', 5, + 'top', 5, + 'bottom', 5 + ) + )) + detached.locked = detachedData.locked + detached.scroll = 0 + detached:EnableMouse(not detached.locked) + + local width = GetScreenWidth() + local height = GetScreenHeight() + detached:SetScript("OnMouseDown", function() + if arg1 == "LeftButton" then + detached:StartMoving() + detached.moving = true + end + end) + + detached:SetScript("OnMouseUp", function() + if arg1 == "LeftButton" then + detached:StopMovingOrSizing() + detached.moving = nil + local anchor + local offsetx + local offsety + if detached:GetTop() + detached:GetBottom() < height then + anchor = "BOTTOM" + offsety = detached:GetBottom() + if offsety < 0 then + offsety = 0 + end + if offsety < MainMenuBar:GetTop() and MainMenuBar:IsVisible() then + offsety = MainMenuBar:GetTop() + end + local top = 0 + if FuBar then + for i = 1, FuBar:GetNumPanels() do + local panel = FuBar:GetPanel(i) + if panel:GetAttachPoint() == "BOTTOM" then + if panel.frame:GetTop() > top then + top = panel.frame:GetTop() + break + end + end + end + end + if offsety < top then + offsety = top + end + else + anchor = "TOP" + offsety = detached:GetTop() - height + if offsety > 0 then + offsety = 0 + end + local bottom = GetScreenHeight() + if FuBar then + for i = 1, FuBar:GetNumPanels() do + local panel = FuBar:GetPanel(i) + if panel:GetAttachPoint() == "TOP" then + if panel.frame:GetBottom() < bottom then + bottom = panel.frame:GetBottom() + break + end + end + end + end + bottom = bottom - GetScreenHeight() + if offsety > bottom then + offsety = bottom + end + end + if detached:GetLeft() + detached:GetRight() < width * 2 / 3 then + anchor = anchor .. "LEFT" + offsetx = detached:GetLeft() + if offsetx < 0 then + offsetx = 0 + end + elseif detached:GetLeft() + detached:GetRight() < width * 4 / 3 then + if anchor == "" then + anchor = "CENTER" + end + offsetx = (detached:GetLeft() + detached:GetRight() - GetScreenWidth()) / 2 + else + anchor = anchor .. "RIGHT" + offsetx = detached:GetRight() - width + if offsetx > 0 then + offsetx = 0 + end + end + detached:ClearAllPoints() + detached:SetPoint(anchor, UIParent, anchor, offsetx, offsety) + local t = detached.detachedData + if t.anchor ~= anchor or math.abs(t.offsetx - offsetx) > 8 or math.abs(t.offsety - offsety) > 8 then + detached.preventClick = GetTime() + 0.05 + end + t.anchor = anchor + t.offsetx = offsetx + t.offsety = offsety + detached:Show() + end + end) + + Dewdrop:Register(detached, + 'children', function(level, value) + if not detached.registration then + return + end + if detached.menu then + detached.menu(level, value) + if level == 1 then + Dewdrop:AddLine() + end + end + if level == 1 then + if not detached.registration.cantAttach then + Dewdrop:AddLine( + 'text', DETACH, + 'tooltipTitle', DETACH, + 'tooltipText', DETACH_DESC, + 'checked', true, + 'arg1', detached, + 'func', "Attach", + 'closeWhenClicked', true + ) + end + Dewdrop:AddLine( + 'text', LOCK, + 'tooltipTitle', LOCK, + 'tooltipText', LOCK_DESC, + 'checked', detached:IsLocked(), + 'arg1', detached, + 'func', "Lock", + 'closeWhenClicked', not detached:IsLocked() + ) + Dewdrop:AddLine( + 'text', COLOR, + 'tooltipTitle', COLOR, + 'tooltipText', COLOR_DESC, + 'hasColorSwatch', true, + 'r', detached.r, + 'g', detached.g, + 'b', detached.b, + 'hasOpacity', true, + 'opacity', detached.transparency, + 'colorFunc', function(r, g, b, a) + detached:SetColor(r, g, b) + detached:SetTransparency(a) + end + ) + Dewdrop:AddLine( + 'text', SIZE, + 'tooltipTitle', SIZE, + 'tooltipText', SIZE_DESC, + 'hasArrow', true, + 'hasSlider', true, + 'sliderFunc', function(value) + detached:SetFontSizePercent(value) + end, + 'sliderMax', 2, + 'sliderMin', 0.5, + 'sliderStep', 0.05, + 'sliderIsPercent', true, + 'sliderValue', detached:GetFontSizePercent() + ) + Dewdrop:AddLine( + 'text', CLOSE_MENU, + 'tooltipTitle', CLOSE_MENU, + 'tooltipText', CLOSE_MENU_DESC, + 'func', function() + Dewdrop:Close() + end + ) + end + end, + 'point', function() + local x, y = detached:GetCenter() + if x < GetScreenWidth() / 2 then + if y < GetScreenHeight() / 2 then + return "BOTTOMLEFT", "BOTTOMRIGHT" + else + return "TOPLEFT", "TOPRIGHT" + end + else + if y < GetScreenHeight() / 2 then + return "BOTTOMRIGHT", "BOTTOMLEFT" + else + return "TOPRIGHT", "TOPLEFT" + end + end + end + ) + + NewLine(detached) + + detached.scrollUp = detached:CreateFontString(nil, "ARTWORK") + detached.scrollUp:SetPoint("TOPLEFT", detached.buttons[1], "BOTTOMLEFT", 0, -2) + detached.scrollUp:SetPoint("RIGHT", detached, "RIGHT", 0, -10) + detached.scrollUp:SetFontObject(GameTooltipText) + detached.scrollUp:Hide() + local font,_,flags = detached.scrollUp:GetFont() + detached.scrollUp:SetFont(font, normalSize * detached.fontSizePercent, flags) + detached.scrollUp:SetJustifyH("CENTER") + detached.scrollUp:SetTextColor(1, 0.823529, 0) + detached.scrollUp:SetText(" ") + + detached.scrollDown = detached:CreateFontString(nil, "ARTWORK") + detached.scrollDown:SetPoint("TOPLEFT", detached.buttons[1], "BOTTOMLEFT", 0, -2) + detached.scrollDown:SetPoint("RIGHT", detached, "RIGHT", 0, -10) + detached.scrollDown:SetFontObject(GameTooltipText) + detached.scrollDown:Hide() + local font,_,flags = detached.scrollUp:GetFont() + detached.scrollDown:SetFont(font, normalSize * detached.fontSizePercent, flags) + detached.scrollDown:SetJustifyH("CENTER") + detached.scrollDown:SetTextColor(1, 0.823529, 0) + detached.scrollDown:SetText(" ") + + detached:SetScript("OnMouseWheel", function() + detached:Scroll(arg1 < 0) + end) + + detached.SetTransparency = tooltip.SetTransparency + detached.GetTransparency = tooltip.GetTransparency + detached.SetColor = tooltip.SetColor + detached.GetColor = tooltip.GetColor + detached.SetFontSizePercent = tooltip.SetFontSizePercent + detached.GetFontSizePercent = tooltip.GetFontSizePercent + detached.SetOwner = tooltip.SetOwner + detached.IsOwned = tooltip.IsOwned + detached.ClearLines = tooltip.ClearLines + detached.NumLines = tooltip.NumLines + detached.__Hide = detached.Hide + detached.__Show = detached.Show + detached.Hide = tooltip.Hide + detached.Show = tooltip.Show + local old_IsShown = detached.IsShown + function detached:IsShown() + if self.tmpHidden then + return true + else + return old_IsShown(self) + end + end + detached.AddLine = tooltip.AddLine + detached.Scroll = tooltip.Scroll + function detached:IsLocked() + return self.locked + end + function detached:Lock() + self:EnableMouse(self.locked) + self.locked = not self.locked + self.detachedData.locked = self.locked or nil + self:children() + end + + function detached.Attach(detached) + self:assert(detached, "Detached tooltip not given.") + self:assert(detached.AddLine, "detached argument not a Tooltip.") + self:assert(detached.owner, "Detached tooltip has no owner.") + self:assert(not detached.notInUse, "Detached tooltip not in use.") + detached.menu = nil + detached.detachedData.detached = nil + detached:SetOwner(nil) + detached.notInUse = TRUE + end + + return AcquireDetachedFrame(self, registration, data, detachedData) +end +AcquireDetachedFrame = wrap(AcquireDetachedFrame, "AcquireDetachedFrame") + +function Tablet:Close(parent) + if not parent then + if tooltip and tooltip:IsShown() then + tooltip:Hide() + tooltip.registration.tooltip = nil + tooltip.registration = nil + end + return + else + self:argCheck(parent, 2, "table", "string") + end + local info = self.registry[parent] + self:assert(info, "You cannot close a tablet with an unregistered parent frame.") + local data = info.data + local detachedData = info.detachedData + if detachedData and detachedData.detached then + ReleaseDetachedFrame(self, data, detachedData) + elseif tooltip.data == data then + tooltip:Hide() + tooltip.registration.tooltip = nil + tooltip.registration = nil + end +end +Tablet.Close = wrap(Tablet.Close, "Tablet:Close") + +local currentFrame +local currentTabletData + +function Tablet:Open(parent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + self:assert(info, "You cannot open a tablet with an unregistered parent frame.") + self:Close() + local data = info.data + local detachedData = info.detachedData + local children = info.children + if not children then + return + end + local frame = AcquireFrame(self, info, data, detachedData) + frame.clickable = info.clickable + frame.menu = info.menu + local children = info.children + function frame:children() + if not self.preventRefresh then + currentFrame = self + currentTabletData = TabletData:new(self) + self:ClearLines() + if children then + children() + end + currentTabletData:Display(currentFrame) + self:Show(currentTabletData) + currentTabletData:del() + currentTabletData = nil + currentFrame = nil + end + end + frame:SetOwner(parent) + frame:children() + local point = info.point + local relativePoint = info.point + if type(point) == "function" then + local b + point, b = point(parent) + if b then + relativePoint = b + end + end + if type(relativePoint) == "function" then + relativePoint = relativePoint(parent) + end + if not point then + point = "CENTER" + end + if not relativePoint then + relativePoint = point + end + frame:ClearAllPoints() + if type(parent) ~= "string" then + frame:SetPoint(point, parent, relativePoint) + end + local offsetx = 0 + local offsety = 0 + if frame:GetBottom() and frame:GetLeft() then + if frame:GetRight() > GetScreenWidth() then + offsetx = frame:GetRight() - GetScreenWidth() + elseif frame:GetLeft() < 0 then + offsetx = -frame:GetLeft() + end + local ratio = GetScreenWidth() / GetScreenHeight() + if ratio >= 2.4 and frame:GetRight() > GetScreenWidth() / 2 and frame:GetLeft() < GetScreenWidth() / 2 then + if frame:GetCenter() < GetScreenWidth() / 2 then + offsetx = frame:GetRight() - GetScreenWidth() / 2 + else + offsetx = frame:GetLeft() - GetScreenWidth() / 2 + end + end + if frame:GetBottom() < 0 then + offsety = frame:GetBottom() + elseif frame:GetTop() and frame:GetTop() > GetScreenHeight() then + offsety = frame:GetTop() - GetScreenHeight() + end + if MainMenuBar:IsVisible() and frame:GetBottom() < MainMenuBar:GetTop() and offsety < frame:GetBottom() - MainMenuBar:GetTop() then + offsety = frame:GetBottom() - MainMenuBar:GetTop() + end + + if FuBar then + local top = 0 + if FuBar then + for i = 1, FuBar:GetNumPanels() do + local panel = FuBar:GetPanel(i) + if panel:GetAttachPoint() == "BOTTOM" then + if panel.frame:GetTop() and panel.frame:GetTop() > top then + top = panel.frame:GetTop() + break + end + end + end + end + if frame:GetBottom() < top and offsety < frame:GetBottom() - top then + offsety = frame:GetBottom() - top + end + local bottom = GetScreenHeight() + if FuBar then + for i = 1, FuBar:GetNumPanels() do + local panel = FuBar:GetPanel(i) + if panel:GetAttachPoint() == "TOP" then + if panel.frame:GetBottom() and panel.frame:GetBottom() < bottom then + bottom = panel.frame:GetBottom() + break + end + end + end + end + if frame:GetTop() > bottom and offsety < frame:GetTop() - bottom then + offsety = frame:GetTop() - bottom + end + end + end + if type(parent) ~= "string" then + frame:SetPoint(point, parent, relativePoint, -offsetx, -offsety) + end + + if detachedData and (info.cantAttach or detachedData.detached) and frame == tooltip then + detachedData.detached = false + frame:Detach() + end +end +Tablet.Open = wrap(Tablet.Open, "Tablet:Open") + +function Tablet:Register(parent, k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20, k21, v21, k22, v22, k23, v23, k24, v24, k25, v25, k26, v26, k27, v27, k28, v28, k29, v29, k30, v30) + self:argCheck(parent, 2, "table", "string") + if self.registry[parent] then + self:Unregister(parent) + end + local info + if type(k1) == "table" and k1[0] then + self:assert(type(self.registry[k1]) == "table", "Other parent not registered") + info = copy(self.registry[k1]) + if type(v1) == "function" then + info.point = v1 + info.relativePoint = nil + end + else + info = new(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20, k21, v21, k22, v22, k23, v23, k24, v24, k25, v25, k26, v26, k27, v27, k28, v28, k29, v29, k30, v30) + end + self.registry[parent] = info + info.data = info.data or info.detachedData or {} + info.detachedData = info.detachedData or info.data + local data = info.data + local detachedData = info.detachedData + if not self.onceRegistered[parent] and type(parent) == "table" and type(parent.SetScript) == "function" and not info.dontHook then + if not Dewdrop then + Dewdrop = AceLibrary("Dewdrop-2.0") + end + local script = parent:GetScript("OnEnter") + parent:SetScript("OnEnter", function() + if script then + script() + end + if self.registry[parent] then + if (not data or not detachedData.detached) and not Dewdrop:IsOpen(parent) then + self:Open(parent) + self.tooltip.enteredFrame = true + end + end + end) + local script = parent:GetScript("OnLeave") + parent:SetScript("OnLeave", function() + if script then + script() + end + if self.registry[parent] then + if self.tooltip and (not data or not detachedData or not detachedData.detached) then + self.tooltip.enteredFrame = false + end + end + end) + if parent:HasScript("OnMouseDown") then + local script = parent:GetScript("OnMouseDown") + parent:SetScript("OnMouseDown", function() + if script then + script() + end + if self.registry[parent] and self.registry[parent].tooltip and self.registry[parent].tooltip == self.tooltip then + self.tooltip:Hide() + end + end) + end + if parent:HasScript("OnMouseWheel") then + local script = parent:GetScript("OnMouseWheel") + parent:SetScript("OnMouseWheel", function() + if script then + script() + end + if self.registry[parent] and self.registry[parent].tooltip then + self.registry[parent].tooltip:Scroll(arg1 < 0) + end + end) + end + end + self.onceRegistered[parent] = true + if GetMouseFocus() == parent then + self:Open(parent) + end +end +Tablet.Register = wrap(Tablet.Register, "Tablet:Register") + +function Tablet:Unregister(parent) + self:argCheck(parent, 2, "table", "string") + self:assert(self.registry[parent], "You cannot unregister a parent frame if it has not been registered already.") + self.registry[parent] = nil +end +Tablet.Unregister = wrap(Tablet.Unregister, "Tablet:Unregister") + +function Tablet:IsRegistered(parent) + self:argCheck(parent, 2, "table", "string") + return self.registry[parent] and true +end +Tablet.IsRegistered = wrap(Tablet.IsRegistered, "Tablet:IsRegistered") + +local _id = 0 +local addedCategory +local currentCategoryInfo +local depth = 0 +local categoryPool = {} +function CleanCategoryPool(self) + for k,v in pairs(categoryPool) do + del(v) + categoryPool[k] = nil + end + _id = 0 +end + +function Tablet:AddCategory(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20, k21, v21, k22, v22, k23, v23, k24, v24, k25, v25, k26, v26, k27, v27, k28, v28, k29, v29, k30, v30) + self:assert(currentFrame, "You must add categories in within a registration.") + local info = new(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10, k11, v11, k12, v12, k13, v13, k14, v14, k15, v15, k16, v16, k17, v17, k18, v18, k19, v19, k20, v20, k21, v21, k22, v22, k23, v23, k24, v24, k25, v25, k26, v26, k27, v27, k28, v28, k29, v29, k30, v30) + local cat = currentTabletData:AddCategory(info) + del(info) + return cat +end +Tablet.AddCategory = wrap(Tablet.AddCategory, "Tablet:AddCategory") + +function Tablet:SetHint(text) + self:assert(currentFrame, "You must set hint within a registration.") + self:assert(not currentCategoryInfo, "You cannot set hint in a category.") + currentTabletData:SetHint(text) +end +Tablet.SetHint = wrap(Tablet.SetHint, "Tablet:SetHint") + +function Tablet:SetTitle(text) + self:assert(currentFrame, "You must set title within a registration") + self:assert(not currentCategoryInfo, "You cannot set title in a category.") + currentTabletData:SetTitle(text) +end +Tablet.SetTitle = wrap(Tablet.SetTitle, "Tablet:SetTitle") + +function Tablet:GetNormalFontSize() + return normalSize +end + +function Tablet:GetHeaderFontSize() + return headerSize +end + +function Tablet:GetNormalFontObject() + return GameTooltipText +end + +function Tablet:GetHeaderFontObject() + return GameTooltipHeaderText +end + +function Tablet:SetFontSizePercent(parent, percent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + if info then + if info.tooltip then + info.tooltip:SetFontSizePercent(percent) + else + local data = info.data + local detachedData = info.detachedData + if detachedData.detached then + detachedData.fontSizePercent = percent + else + data.fontSizePercent = percent + end + end + elseif type(parent) == "table" then + parent.fontSizePercent = percent + else + self:assert(false, "You cannot change font size with an unregistered parent frame.") + end +end +Tablet.SetFontSizePercent = wrap(Tablet.SetFontSizePercent, "Tablet:SetFontSizePercent") + +function Tablet:GetFontSizePercent(parent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + if info then + local data = info.data + local detachedData = info.detachedData + if detachedData.detached then + return detachedData.fontSizePercent or 1 + else + return data.fontSizePercent or 1 + end + elseif type(parent) == "table" then + return parent.fontSizePercent or 1 + else + self:assert(false, "You cannot check font size with an unregistered parent frame.") + end +end +Tablet.GetFontSizePercent = wrap(Tablet.GetFontSizePercent, "Tablet:GetFontSizePercent") + +function Tablet:SetTransparency(parent, percent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + if info then + local data = info.data + local detachedData = info.detachedData + if info.tooltip then + info.tooltip:SetTransparency(percent) + else + if detachedData.detached then + detachedData.transparency = percent + elseif data then + data.transparency = percent + end + end + elseif type(parent) == "table" then + parent.transparency = percent + else + self:assert(false, "You cannot change transparency with an unregistered parent frame.") + end +end +Tablet.SetTransparency = wrap(Tablet.SetTransparency, "Tablet:SetTransparency") + +function Tablet:GetTransparency(parent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + if info then + local data = info.data + local detachedData = info.detachedData + if detachedData.detached then + return detachedData.transparency or 0.75 + else + return data.transparency or 0.75 + end + elseif type(parent) == "table" then + return parent.transparency or 0.75 + else + self:assert(parent, "You must provide a parent frame to check transparency") + end +end +Tablet.GetTransparency = wrap(Tablet.GetTransparency, "Tablet:GetTransparency") + +function Tablet:SetColor(parent, r, g, b) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + if info then + if info.tooltip then + info.tooltip:SetColor(r, g, b) + else + local data = info.data + local detachedData = info.detachedData + if detachedData.detached then + detachedData.r = r + detachedData.g = g + detachedData.b = b + else + data.r = r + data.g = g + data.b = b + end + end + elseif type(parent) == "table" then + parent.r = r + parent.g = g + parent.b = b + else + self:assert(false, "You cannot change color with an unregistered parent frame.") + end +end +Tablet.SetColor = wrap(Tablet.SetColor, "Tablet:SetColor") + +function Tablet:GetColor(parent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + if info then + local data = info.data + local detachedData = info.detachedData + if detachedData.detached then + return detachedData.r or 0, detachedData.g or 0, detachedData.b or 0 + else + return data.r or 0, data.g or 0, data.b or 0 + end + elseif type(parent) == "table" then + return parent.r or 0, parent.g or 0, parent.b or 0 + else + self:assert(parent, "You must provide a parent frame to check color") + end +end +Tablet.GetColor = wrap(Tablet.GetColor, "Tablet:GetColor") + +function Tablet:Detach(parent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + self:assert(info, "You cannot detach tablet with an unregistered parent frame.") + self:assert(info.detachedData, "You cannot detach tablet without a data field.") + if info.tooltip and info.tooltip == tooltip then + tooltip:Detach() + else + info.detachedData.detached = true + local detached = AcquireDetachedFrame(self, info, info.data, info.detachedData) + + detached.menu = info.menu + local children = info.children + function detached:children() + if not self.preventRefresh then + currentFrame = self + currentTabletData = TabletData:new(self) + self:ClearLines() + if children then + children() + end + currentTabletData:Display(currentFrame) + self:Show(currentTabletData) + currentTabletData:del() + currentTabletData = nil + currentFrame = nil + end + end + detached:SetOwner(parent) + detached:children() + end +end +Tablet.Detach = wrap(Tablet.Detach, "Tablet:Detach") + +function Tablet:Attach(parent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + self:assert(info, "You cannot detach tablet with an unregistered parent frame.") + self:assert(info.detachedData, "You cannot attach tablet without a data field.") + if info.tooltip and info.tooltip ~= tooltip then + info.tooltip:Attach() + else + info.detachedData.detached = false + end +end +Tablet.Attach = wrap(Tablet.Attach, "Tablet:Attach") + +function Tablet:IsAttached(parent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + self:assert(info, "You cannot check tablet with an unregistered parent frame.") + return not info.detachedData or not info.detachedData.detached +end +Tablet.IsAttached = wrap(Tablet.IsAttached, "Tablet:IsAttached") + +function Tablet:Refresh(parent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + self:assert(info, "You cannot refresh tablet with an unregistered parent frame.") + local tt = info.tooltip + if tt and not tt.preventRefresh and tt:IsShown() then + tt.updating = true + tt:children() + tt.updating = false + end +end +Tablet.Refresh = wrap(Tablet.Refresh, "Tablet:Refresh") + +function Tablet:IsLocked(parent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + self:assert(info, "You cannot detach tablet with an unregistered parent frame.") + return info.detachedData and info.detachedData.locked +end +Tablet.IsLocked = wrap(Tablet.IsLocked, "Tablet:IsLocked") + +function Tablet:ToggleLocked(parent) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + self:assert(info, "You cannot detach tablet with an unregistered parent frame.") + if info.tooltip and info.tooltip ~= tooltip then + info.tooltip:Lock() + elseif info.detachedData then + info.detachedData.locked = info.detachedData.locked + end +end +Tablet.ToggleLocked = wrap(Tablet.ToggleLocked, "Tablet:ToggleLocked") + +function Tablet:UpdateDetachedData(parent, detachedData) + self:argCheck(parent, 2, "table", "string") + local info = self.registry[parent] + self:assert(info, "You cannot detach tablet with an unregistered parent frame.") + self:argCheck(detachedData, 3, "table") + if info.data == info.detachedData then + info.data = detachedData + end + info.detachedData = detachedData + if info.detachedData.detached then + self:Detach(parent) + elseif info.tooltip and info.tooltip.owner then + self:Attach(parent) + end +end +Tablet.UpdateDetachedData = wrap(Tablet.UpdateDetachedData, "Tablet:UpdateDetachedData") + +if DEBUG then + function Tablet:ListProfileInfo() + local duration, times, memories = GetProfileInfo() + self:assert(duration and times and memories) + local t = new() + for method in pairs(memories) do + table.insert(t, method) + end + table.sort(t, function(alpha, bravo) + if memories[alpha] ~= memories[bravo] then + return memories[alpha] < memories[bravo] + elseif times[alpha] ~= times[bravo] then + return times[alpha] < times[bravo] + else + return alpha < bravo + end + end) + local memory = 0 + local time = 0 + for _,method in ipairs(t) do + DEFAULT_CHAT_FRAME:AddMessage(format("%s || %.3f s || %.3f%% || %d KiB", method, times[method], times[method] / duration * 100, memories[method])) + memory = memory + memories[method] + time = time + times[method] + end + DEFAULT_CHAT_FRAME:AddMessage(format("%s || %.3f s || %.3f%% || %d KiB", "Total", time, time / duration * 100, memory)) + table_setn(t, 0) + del(t) + end + SLASH_TABLET1 = "/tablet" + SLASH_TABLET2 = "/tabletlib" + SlashCmdList["TABLET"] = function(msg) + TabletLib:GetInstance(MAJOR_VERSION):ListProfileInfo() + end +end + +local function activate(self, oldLib, oldDeactivate) + Tablet = self + if oldLib then + self.registry = oldLib.registry + self.onceRegistered = oldLib.onceRegistered + self.tooltip = oldLib.tooltip + else + self.registry = {} + self.onceRegistered = {} + end + + tooltip = self.tooltip + + if oldDeactivate then + oldDeactivate(oldLib) + end +end + +local function deactivate(self) + StopCheckingAlt() +end + +AceLibrary:Register(Tablet, MAJOR_VERSION, MINOR_VERSION, activate, deactivate) diff --git a/Payload/SuperWoWhook.dll b/Payload/SuperWoWhook.dll new file mode 100644 index 0000000000000000000000000000000000000000..4c89378a9d49430968a7c5a053bc721dfafc448f GIT binary patch literal 1000448 zcmdSCe|(cwmOuWqP1{gXo>W?_TBQs{t7W86)MARJ(3Gl;q?EQOzls9J;*VMqekg_1 zG)lO}>C8Gi?vAsmzicJxOf{awbnW~IFo%Ev>SZuLFKJRny^CW2t z&g^IQ`^OhvP43Tg&pr3tbI(2Z+#BnIEmDFcNjm(6!;<93H~lm7&+q=ojgzD?<9Cmd zc8q#&f7Aim?;&%Ua~_apYtz8r_|u?b&%^)S9i^@P59l7D~t)k^+-{g>jq zo5$xp`mmjFxKfX87D+0POO`f&w4hEa(=EkM7#%m}M(NrVNh(a_$ zh2teDiDLMteM?(qL3E_WOJ-0K1*vT0TSWU#jgd-_I{ow*sfe;|veZxC!~fOF(hGM> zl5%j2R6jf~CZ3CYb4;A@tVQcr`gf~i#X1KvH)Ntegdg>lm?h?4wj|Zw+OT|?V;PF< zKqmElC%$jsG>DWmgRO2A#iWv3klZ&0@bG;C-!cEpk`%ag`3lFA&W48rX~@V1t**lN zmm|sn9xu1tK=sWi2U<%KzGMEG30}kMhKG^HX$Knea`7X|nQv`a@z|3nNVJqdQ%)@1 zh;p-H!2ka`XwS|~F)F#~dg+0-!}wRldfmO5+su7qj0Nv_ErXTSHEiH5BI;gZzm>t{ z{B`Yfu99S9qHgaPBg*mX^wLC&o*kK3Wl$!irbzBD zb-smhTS^j@%_ZZ*?n{H4jx+1v(j^7&EmUqX>LvEa#ciT}J+=B#LD;*vpMC8)=u8P( z28l;Qc`g1&R<2w*=bJBEFUGU8tzV8$IP2{7HV%3YuGhCGeE*vd5%#SOdoHXiX5Y%= z%@QyFO%E0Ss5LY`;iD~Wf$n%;dS?9bTi$iG=5IFK<^D2`9a{eZYaC>j{&romv~0HkTr#_uZ=xcX|Sjv2MQ~6DJ7-c2R)-`H9fz{(ikg z@Hs!2qx`@u7##MY*Al2<7d@xs<~9`fgyrV9=sO@c|AwmHw&%ZgNS+IF^S@B+xvgs6 zPw;(CHo7t~sn5v|B$nLbmg@5B5Kglkpo}bJ_$-GhuMBxM%IHw+d3vg5=|GnIfPo#c zxqJ2gmb5aeSdycoJXBB9<%Bz#^#rRr?H$dmU0#`41Ku=Gz?m~6!Kt5-?9_RVJH{dqW?Zi->&VS1SDIv-+W6oz+ogtu@Bf$9Q{FkR2Fq@N;|KiyI|4BIY!qRs+IpR#Dee@>w$1G%Iq9s-z|2Nu>)HO%t={=L2BaG0X5#S*Vt`;t&U{Il=PS=ClW#7`DQhpu zc~GKIE@c%;5)$r|6m}64w;f|PI_UUb9YiOeq&3yr936vTc}}kKFv`)$I*q=PoXqO5 zBge4Mc6Yr5SlN~Hi|5&pJeeTp&X*``v)SjPYxV_@-Qkn&16d)e%d7Zp9*BX?86`Oe z=e0BD=NO&o1TWKGOBE`J#Zke?%5xrrbUv*3QdHp#5?z))#RgWPuVzmXInr5i7QT!% zY<(sqz>A{+&UD)gCj*lF1L&6$pk@-qs>`=IpZK`-#p7XWefpm*$1W^5o*m`IL;I%fd{q=0qP(Z9ff5xDzC2?Ms&c{? zJ);B-iKqnuPS)Giq$o2Z#H{_S>b$(uA{WIwj73QfLs5-GU$nrXD_Yc$-@ z!md53&q-~&UZ+oA>Y2C481dy7Ux&rlR{GMAWQ~1npAloqj?9Aqw<^6OTEs&R2u#Ni}0z#Bj6vp68xd1A+L5O#*M|os`baU zE<0{h8Y|0%29e?(2s;u_nR7!4r_9;t6+0U3ms+DP-f#R-E&3_M>tXi8bWAX;D-W?I zA`5tE0n^v8r}f|@);fB>!%`>BQ)hJrXH(XR;!~=XUw;FB?ql!PNh(NNjonT&Py(E4 zf8W0?=UkKyvA4911(&w@%Wm2n({ymerFE@=63s|FCogWrBAU3v>yoy|(GoW;5VO#! z1RL3&B$drZd(hI0d3!U5wpVt!_H2>%9tdoYqgG#j#3fy>&C9j7b=Lp1z48(5ZT|4U zmD(fxYu_MxebaSqAZM&D{huE#ds?Ll@QLPo0=oysZb;fS5a&qR9w(Q)yPF8-O?_?U z)6%ZcwTt&7$(#B*Vi7{B^~HEZ#-Sz<8H#)rRevq25oKJ-vT;{7m_FPohDBptZTz9H zL#>Dt$_3O5YoD*GuTJt>``quw)y4U&gF#C#cBPWH>U_|`H$Xv)V!XIX^1FVq0ALxZ zC2=-imEucvVY2&MepZ5HU+Umhve8R`V}WzX9PDMP*Tz=w=hb~y#h?FA#ncXzYV?1| z{$iURvyoL9s+m*I%(?FVIQhj7fh%z(k;2`tYb0h(oXqKxmgL{Qv6kpknob|N^idQn zC7~k)OR1Om;;L-0ly9elrI{izOMGREFYqgsoGiZb#n*K4g|%5AkUq;L$qxq3((WeQ zdHQh$-L~`vEqzqLR`KEDUSMYF_1Av<4CGut-38l-d^|ZlR@DH@Xx=NI6~p5Fm7L(opUV4kd(J-mJ0g68z-8su9NJ?z$JEr;W^3Pf};NJhiIy!M(XaC^UEaG5kAiPLh%I` z*c>bX%*f0-uca5`Zu8q-U5ZHrR-j?;_gNGWK#$Fc!7mM><`Il}Ne*$V1-I!urzKzD;*3`QJYkq{m`>Jbf*l;ZW zIc2g|ug44|vuaNPnHDZ$O%@rKJVw+eNycr@N5uxRIxKi}Vhj-i&k|=xO#xq<4$-mwCD$={{e}C8XC2IIr{cJxB*d z6{OdSbU#lIARQB&$_E6T4xWAh=_>v6MfonC-huRmld~VA@*-W~>4%a2Beh|LaqdJ#%$NKt~GK7=M` zJDE(7!dLV2m@mzEuGSUP0*7`Y4`X5FAE_ug$6y@kx)(~lp6_6j)d|fq3MxOVI)+9 zP)I5`81$GCYCcGve5o-~#mqhGk5qm|%wu;zm z7fPp_gO=Cp;@Q!l%WFI57?c>K z^n!2;+c9(9Ak7vVN>tRD>vYw&a7K21iV+iHt!j~5c=`#cPUq!C)e83cNCSNAgY(Bp#_xZ!VPuhyktT|?T#X{How{cP zl&we;MFLdh?l9oDA)o>gP``g3=YiA$3R-MOv;$k;MC#jo`L8q=_N{Dst~-ij;~Xels{0v#|U!Y+V*% z>y{q_%HHhC5e@A|8XAIH)CskyAk6q$0rA<-)gwK6NyZMS9|)!EJkrV*b@`x$C%ofr zDp##7KeA^HtsO7%RCNKlJ|71_d>w$))Y-(kAQps&rv6O}!at%dh|Z(u{qX=9MC1R93&H`cCFs?_S>CI^Wel{jzsN^Bgu60e;E^d1!GG3)u|UQ%GB2VfVs_Tl(# z8gj@iq$Ey_oCo2&(%qXCJ%7o>Y4ASdZBI(OK}CsuJ?&KZWHS!+>AF)A%(2cSwvYn)XhLb3?+Kf5En)Z zvd_?YSy6Pn3aewN{xzts!G<9m=Va*x$LV~?#?QI5bDPxNfg4~qg6#!{CfP4ta}RY} zoKio07UsV~?Ayr7O@|EZ2rP1BT%$uU^{5T@Jc5Pp|Xl{{|TmQh%fcU7i@S3o~ z5EIa`Od%-wUtbAI?(VyT;KKA%o>L?&BFKG7%@tkcpS-^Tckgt6gd@3&1P!S38hf+s zk!pssB=|dqBCw4`D8l+ckRpw;M?sfD_E9*)0h2F7*wp8oJ7ZB!k@Ftc%%+X|rO{3^ zoq1Jiw1YhcTr!!th=KWe#Y*`Ja|tKXIr(!kToRdhk7;fIk;v&c!qlO^(4SZSSNc=` zH}z-H|F}Pp9|m|Sd|g8>2sdH8wg1h);?^&8|1i3L z^hfT2t2P|pQhHU%7;saqL=WiECr}6VAI_8#7io3tbz>H8`iaHeM|`Cr6Gh zDvGwG$po$*;A~WREU%o-D`#A(vWl0UJzxN8@2i|t^f-W6op-o4 z#w~MBb#07qaOSx-CaiK!+ES`3%HMc{Yh&V!#!Pu{C)53|JMB%0rT^{>zSQb|@|RoL z;ws9Q92sVJfBJ^=n130MfmPHJTgvmlbqzd8(rT{rGuMXv!L`oQ`1!9Nc&IkJ$oe8Qh@PWs$6=?Dodl_z1{i9?8FuQj>N9fYPh6VqH>l1G>ique@LzO!{4FE!FNorwtKwh! zQ51iHwCDgwx!^bnyYFi zT)3OUZ}#fAbRyplTIJqU5FfVAm3Bqexqa$7cQTaAl5u`v#=!$P?T#A_js%jw6!~)NbVA0Niy#XVq9_&1*0`Yfh zBf=NR33lVYVLF>y;byHucC5no@z2hK{8<0FO;mXm`m?VrY)UQfep_1Iwk`07w^bOola2BmT=#2JDmj{L`UQ9Ts6o~?S9d@P?`Y~q55iM@KC++MjVGEVJ2|md?Ba*) z$J__feLtqG2=OqZxE8?Aq!b?SB|M{q4@E!u9{vGskniD1YHP0kLb2ZH z7-#x}R5T5oQ0n$9Lfv4~8UEM5svv?*S>S~UE zxN~pImRdTY91V5%gHR%mLP&fdJPfZv!{JV`mw}FEe}`z7{m4B?#HJvczRo#9t_@kZ zR1wP8FGI}a^}!qGYnwlC*L{+&>O9E?=LGxmM~4AZXXW3W5u9HMug3FDVVX0IPCC_v z!(!3fFZb<~Ldgj9NpE5tHZC;H>e?@3OV& zqmN)2tI1~j+1i}Z?T&ll0j9b3L_K?^D_wv()Ul`X3XVOIW*HQ76$6;(sqIKSx)xH1 z_ivbgBKb~0eTDyFW({qA%&gSN#+TOq!kmyY{wY**pVCJ>0_K?7XVhb>)+48e^;^}x&|z| zA7Qwd#(KmR6+q4|z{o~LPa(YG3Xa1BR6^v{91JIaDr68mRyn`wqss=ykgpt9+e@%= z4BcAMex_Q?R!kD^b@1`xeoRwKzvB2m0NKZvD0R7_b@-bu-~HjeEjN`**9CmGxbO!{ zFrf%cgvg?OqG%0t79d&#M6p+|V)t|T;w)!-`EF~IS=waw8w0aQgzwu*?L**iO{hg2 zTfvFn1d*h3jB?LBgV`ZDuX4?lp!UHZ;wAV)aR2JhtoFvCU$cg*@X|^rACG)X1^NIEMoWH=l3;Ve*Ya+E5HU3 znO?|cdZAJpBALE!^-(t6<9c+D^i4bZYIZ!*^f{EjeSWh%m#<}SagFIHdS~$2a)ibl<>oB}%-x@}K@k#5?8MEGb^#J~AqzX|xv+kW zN}Jt3zuzN;#yHBg`0Mw0ROt!SIY!u|KG9B9aRK72yg>Kg(!m(($Wd+E&&8u?jAI^t zA9H~JfxeV^nFWLMf6RKpiR*3b_x)r!=9uTW-24lCyY8GKd$v;G={Se%`FkFUe^U0m zz(WZLJ#x}F|$r|cPvP{FCa#G_ku!)*k3l(411ExzGzGRL4p?EgneRVlDrNQUz;wl&4sq#w# zFMKRkmm*;P?*cXSW-AX7YJbl|hR4x=9!dp5&mshb=*H5O5Td;AL zpTE0`%oCRLyS9EBAhAP^q}LY&+ z5+^^V*xwT+p>U7~4*uXlwe?oAeYzX_q>WYX#`Ds~xm=sL2NKqz3Dc_c>}UdcFyen) zcqhTg>+~BxpC`@3!n~7O2zN##1n*Vol(vAx*5Y;8QA*OPg$xWhAFT{$Or`}0m0>id z3rN3+K#0m33ZefMWJ+Qmc^3~d!*98CXhrADaxS35Tr}V&15w8wP=%tTp9Uf z>7)RkEF@Z7Pt#=C!$UM#{)>lbvb@eiG+F+MhiJ0A#6vV$NRqgorpe;sp;3=IpT<0K zI32F1N3U=`f%);c)9!jY^-kwQ-^qN}*X&cd@2Zj0VJWi=vO}y&j}?$sF&L-)ofxskEP&ndBR$mL5NtDhzr24BZx>A@hB0mLW~n}6a_dD z=@4BI@xOV9h#2A_BH|}JL`0;Wf$M1^;(I(qL~P?BBH}I{8im|n@lXnC{0k4!to|tv z(X9R<57De9<9}tfN?N*KcKNye-Q?vwdgW=oWFZ!q2?YleOVC~Sx?ap{_qr|##-l>X zc}+3y`M3uXH+;@-Ea3>{t1dC4`Hqe_`aR{enuHBTMvlto?DH}9VsoV?Btt&|29$6BelohQkWtTdBAa}J5)O7>yF!RnfV3*JRJ z`RpR}?=0+ar+aZhrEs*|JPt+V@sdw>4e4ZCbk~q&nl`kq4cEl2lRYO8R9*~1Gl$^- z@}JwKv-i;y#6C6$id#16_FHs!T**Fti0spIT0en(x&!v3->lR;P~tm$4K9N(2I>%mgG|Ct7oaRw6pNj?OmXq9~wgiN-3T5YeEOn#Z`2TBzwMw0S2(A zx1$8iI&XJBlCBN*}@+oWrn#Fd~&t`9ymF$M5!+&}^Nwx8>Bs#B8r1M!qljpJ?BDE%LYW zd}O^AlZ9>84lUgulWxzaDjjOp&kZ2MuER0;vGq=0A-(qs>AFA^wOBZrJbek@G@*Y6 zt$)dO<8?qLAKB6VO^*Uew&zFl(Z7<|ta{3_@v6w0&$G}3;OjN`iFRW)3JE%B^jjVU zk{Cg9cRf;fy>hv%g5y6Y^ZTyXc_!oj@_Re~vsn5$Inu+F7$5$CamRTPUefaqN3_FE zG2fvM;I6_)+`8bH>b?{Y$$UxYyy*(tF4`?@Nu^6i`px;*<7N-mOlV~~^a|{yUen~f zLLXQ!tI5LuH5OOCuu3QgOGQa1ccaG1wbFwiJiZN459-O><2#+!qrdF$&8tS*gWwBi z4C0u9{K=2 zBRjejlC~dc{Vny+qdo?)0yh(Nu(6h*i+{#gLR^hT@SoA!C9wEJdihslN3}EphBJE6 z3QgbL(;)-=^{!IMZU&petK!~c;m)XKLDUFmC@3$=nx8F2JzhFeR*b)%M&%3&vKKk& z4m!rw>~keP1oz@!(-wnFV4e%kvrDyWz8X5hexf>0(EWWfgt5iAyjp1^nB9O$gTVUX zPFbnHFiW59a4^;dm_ExHo8Nrl6?lNVVOM6LY@S#jrOX{S8p z-L(mF?z_0DojM)%Q5KYQaeM56WL$Pg7Qs1mL1#|78o@=K2j&)03PNdfi=e0o#XG-K zsP0kwGyM5~7WLJxN#{$ljNtyqYdaJ>Ni% z!>T8He6-@izZ%}N_ydkflz>-7v4Uo3=6Ja&n;+z9286 z2+c1_d=_Dlqu7BDuO8bGeE-nEztb$((i@A{p^sKSKC1TMgI`X!c2M-N*LtGe(ivyk z@4%A)7QdW^mlP}=a+=xb4rBv|&^Vvfk2?p}Gs;sFux3{EGK<2j-OSq!<14TtY?{|# z(}8wU=~5IG{nv3QigJx-@`A1XiC#+=q|Q=bY0mD>jcd@g)4n-6*4X8>bmIcE@BSS4 zIas>!T^GmAtw!`fy-05!^w)1#LvdYBT~gS28e6bV6y|_9irwz7;+%doi%oY0nT;9B*1obz7Z#y)Bu zDMh~e9PBL!QFa7KY$pPTw-dRU<#b(=JCI{T@<|Oh=HdjhbiW?w2&kxC#^I>-J+YQ6 zFX5UyW)0t;#JqRGEJl*=2KFIc{3g3Y%ZS9te5?u>Z4(;Iv zQTH=C=;<&uc3xM{4<2wk$QE9$7g|dIi;ew3uC;*ip}2^>_H=VZY#c* z4w293e^aBLnyTKr2MEfgPCeG#PGG=g3&MvH-kV)qFYOMjmyEk617i4t-L=mkTqwfk z4G5QsaDF4g^VRf?2-k|RYZJotBAo3)*d@aC6mAjW0EJ%>;o2sIw~Mg!EW!a1-cI4e zB5ZRbd|FNSAbehg^Pfjpzn|l|mBQ&FY}|}+wg|f@JXuZmB3!73w;)_D!dod^tA>3D zJ4D$0BEm0-aQzPueocgpFCgq!%Tu^RggYsGT7)HnbDoE3AVA*^qHitetCCiws!C9m zmMR%l3aZ3Y>86rQrIt!4l}0LgRLZDCQR$(QLZyOA0JZOGx78l2omKm(c2Vt}+Oe2E zMHV9j!Wjq9J%498*hk+6r7RmC;qFKg;=f)aq-^wvsxrp%{UNtKPq5dbR%PrdzWRK} z*@I#_!(1LcU*sk!+UQ_Ax64KCbynLqEp(>@?;8YB)LP%?&$YCs&* zQ=hamX>PFU?}%VS+*+5Rwv^$4>LWi__y_Lf_*KiL3{ zU77v>#I-pe(RCD^MA7`Ih>~xgGLE9sG(^cYPD!R{Cq>DDN$FpJX!dQ0+9}#Y(Qb;8 z=Zx|ZMO$u1lssjWLloUg(M1&9!|N6zO5PaCe^4}k2BPyR`cD)!-iauk;VVC&XtxQ` za*Dbr+F67s9Y88iQFQxEMCq_jd5EGdcOhz~XeC9BcOyzCWJ(For6`?HDYx;uW<;k` z^hREI7NTT~R<5RKb_t?ng;n%CYC)8&h{`|>a%)QwCEJzqCyGjCh?3bxImM&*AWDW9 zv$gw3ec@30Gd_h0778J*(0}(XAAvEvC}M>sk?|y_wQL z(H4r*7EF1VqSF0{(r!taPtjV6(k?}@P;@IrY15(HPSI|P_EGdEikjylN}B~GlcMz$ zrM-YMilQwPC5>OXSdC~WMM+s#LKJPWAxg@va+;!2C8DI3DDUxHijvNt?B%)h5v2uO z`4vU8DN1X&vX!E)Dnx0?QGQ6#+G<2eL@UqoT#5!Lx|*V$HHhw^=yF7ryBE>KaHM0? zLYIu}fi~Ldi;G5l0@AKDMi?PTrt|yL>2}jiEU8%446hpIBR-z(udpf84{*IOa&JGK z4s+mWzobq10=L2iT&}O>#w-@xHecg)cKaF!@af097l-G5^I7Yk61ME8m%a?f_=C56 z=xWQ~Jf3~zIpzF4^f+&0x6d*lrzLr-jo#{XQ@?XOLabeN?%#|zqSW=}M{Posu*C#F z@7pFQ-r-I1^9O*MTG}0!*QVE0R(m%ZmAi0?(5|~f>Y?od-l^%3XHxk!xB3xx1uds3 z<_=7>DeC~3J9&%kgs*HO6lZTS_G_m@ckUX8;-*%4Rx7FQWpOImM)`^-np)S`LILb* z$5trQ3AqkZ>Mf@ME0kDp5F3P=$_nooAmc4fSN`)Ol(2NS>tIkLz0<(jh32_?zv!1T zxD$8nYUsm_%jl{;OwO}sX)E+$4W3~0-5<9liOhKe(1`QCW^>ZnTw`9Vsc-F5?oF_^ z>ZW?<7}+1z#Ix}}-8fU*n(KYK(WcI|<4hl|9Tl|b(H9BlE^T@Hy%v2a!Hb6pit*Zn zuAtJUqyj-Qb2tYpl{iAyinpus;6! z-o?lGrPjz8{}GA4braoRbbIFvhGw(iF(t3VG_WRlFF_9-N(h?z0O=9oc*@2v#-==NXDU>?6nTotg*5JYC)7WCtm5u|tDz-}JeJn@Eda=d-IJ(8JbobgKGrBkS z!ala4*4J5T&b8R&XXN73^se0eQyrFF=T^2quN8Y;n=%RmyNxn^))RS&R2FR^hc;~3 zdjc>@hYNx1xov@-8L%TjZ3yvT$zT_*kfB>r`PCevC$4%UZV`) zWZ4>acCp42J}cfg>aJ-azhtS*a6#^{*E@3rh4&3v4}n&2m%KM&2=NCB-y|$ z9jp;}Qu=~Vkyc)aQj7kCKUkR-bWy27K;!k!BIP5bq!%K)6ZlqjsIdizp`d{^Zl|(x z?f^>kqc|0S4Q0v!`T4z|nmpxC^7Fstfp6vK-{66-<>%>$iledUcbtfefZZZI*|F#k zc=_lA{tm&YwdPvD(iO^6ba$;umTNMMaI8Rka?QaI<&+e{3~*eYQgRo}Dch+;DwO~_ z86_YK7y*wNJ&;OaId?x$)7?oUb0;@~3F;I48E6%`X%sM`#v+)`(&EIpge`lxnWe+s zs)H!x{0ttMVc8=;`y{mFZN%Vsev!t@asaPzS^Vz(x;$&Z?6vsIS_cwMt<1Uu_PA${ z(M4apfN0&3_jN(I^-?08(w`zKSWbX#AP(0HU@IuGQoglgZPHn}A`nVc41rM+U|6@xHK*`hb@;6OV3$1Q!!`o>1dsUzhl$C| zsz7$U>;7a=m9@jKtS!WqwSRky3qe+OLR2~Z-Bof?#i3RiddsaB=dtC;fuk4uY+;*{ zb#aJ%cOzqD97DXb*17QS}N8Jb8;GpeFY8x@O@wN7eky>Yct+mW)i9xc0He82cNY}8pVOKG1gw3^5BnhkGo% zw93zi9C8*n0P_KfF#(s50?138p5B^jt^QW zjb?m^vV2WnguX1moHLfh>$MCtzPJ-fS@Cl2XUIkoS}0M(5L0Bu4kRs)2ggum+6uoG zPrn?g>MDv8&TSeY`XZ|EA1 zVx3g%85<+f@qqO;a1P0ts@KEly4C$}xRO z!^4Z$9wg!gtfq_VgDGW$?)?+QrTxH?Ty%;qG59zc2yNL(j0PGk{)9r%6Mg4_~Ao z2jqAS@)-e{EAA??0!u9R!>}93rHOh@xFR)l7Tnd@ts?d;! z{a&jQZ)ROBEFRCYdy`qb7bk@H(9?&(9W=T_aaea2ld;x-G%Q&i^oIX*r5Aesf8K?G*`pY5=t1q{q+`YE8^^161DZ%EgVZ3k7L{o4L>;cOFkDEmt z_xb84x&j zC55h!c+;CUo6gG3 zE#OGs#%%c1rJF9w%}t2~K~XdS8}HgUMKL;7zIY2xV25o`>hOX0T1F}wk{ zu?#)!PE2TD*#f1Y+pT2JMGr~w%ORgac9Jwu+#$@dRj?zJT%=4V#Rx#D4M6dPH@!n` zxd-Cq7wFW?H>;aE0eG;;fv(vF$EjjAL83rDe`gC;xl%;Uu%w|uEL#;eP_m22k9PAe z0TcHZ-Drbgxx?nh?fiyJ8=5k>1Kscr%t~lCZ5TI5Z6lVxn#iBU)#f_1fbCpUk91WdoE7#xS|ImSxmE)+pJCXD(_ zsfB#nTR%xmI08BVJ(v&3u z*p#Pvp-h&HRc8gOJukqWBC2;4AMPG|6Ft8eHO?t6$3RwLu(z z{VHZ|ITm>(6W482f^&MO)2#xyTEOk%B6hy)eHc^oPGZe#y_n>i-QD_WB5nknv?;G* zokK&ud$Ua!SC13>fmws5Sy>IE)+W3Egw%$wOovvdv4*S}Pl?3VY}28Jv#{P?#4m$j zJR$mK(i`IqS*H4|hDmF0F?BdN{}@Nf#tLvtgm!Y8UQV+a-K~5R7Hq)Nf?Oouicq`MrgrbEsN z7xu?Fv%r7g6hJ|-Y27G4l>&VzKh+2qIG-(i?BWc|U}GVBCW|c|RNu#?W@l`enzi}{ zv@(?%OG9Hu)Ir63Bin!Pv5Tgz4JQEs3n}uKiUPAmzPMhcNe{KZc>lc-S1Gw^)!m;f zzxXKxL8Wg&T5QL5TFq#p$H#& zRx&2bgu<&!fG2VdV^EadhSed!i@_)?rvXA5AZTFWWEOW>XtT1|*}QY6(yZ0r$+4_t zY!>F%>Y1E-$k}fGSZWgiVxSU=a1LU#vIrP{%?8gY4(EIJP2M^7hdf-MDa|s?=1nHZ zM&MnI>XOIjCzd!>=h;gDwVi4^5m$|siN6G?@G))FoQ0J;^hDUmrGe&5W064?_Lxk>Kio}=^6pUuloQPb#6G6B@6i_Qfd`L34&gE0#onMAXfM* z&qfu_F98S4hH^vZqL^12$8mj!-Xqd3A7H7a%cIfzj&PyD?e*NV@?=L&F85Im(#rt& zhwnoA9(m~=>thbQ>8~OcvpgpsKJeau#ae+GO+V=|fI8Ywdi)=R#dYuL+sVF6%b2+N zDc({z#9sP)e&ze5dLNV$_-*f#?8Ot97Pvr~V@mC#3#3`wdg%gb`et?rTfk&CPlsnJ zlGSUF>^6F13pW&I(u-UC5(Bh<@p{haOAb7j<%}=Di${~^=i~zC9J+{HBtHDE>2&K1 ziZD8k(-{DGP%0XF}OAb_}|iVLu4M0+)ZE(zGxd~IN& z>stj(y3yCmxI@#`_A^jhhdfI{H-XzKW8IkWcmfQizHq9_+5un{*uJsN^(iR z`)pPP3BfN#gzpG< zMtp4!=!V|KUm8w4#R$?9bH((k z(K6??vG2B}@^{_K7B8Yrzs&D;4exK{ku-8|B9ikSMqiQ;UQs|t z%il+@yyNOcH@)(AG6tM*wNl?)JFaFy9 zLIL&{xgviAS4;+1JOi#+JA^A9g;2<+d-}%lOErm*e?^I)$_kBNt{^7JEE5$I%eH;D zm?&2BH8H{U-!t`_UhM@qPxL{P6@fPN3`M z=vw444eeGq_#DsQ(HsP;6=rnmVS3Z?h-1R=sUQd$L#7dg)CL#d zvClXR@R3coZ^g)JPKemfU;^S9i&)poD2kVx{A_zI?(TxOZ*gxFPUpM1(>a{w!)x?= z`CC@}=K$f_DSqn?KOH1qF2LPgA@tPIh|05~72-xVE)8#l!v1Q_8f%v^EOkW(t%+D#q=OQY$fO26tLc)RtWQ+fnT?R14y}7M@vm(?YKHk`FE=M_U@P| z#$L#22Calh;5Sdls>Md~|8y?qG|tkPiUw>5Q+*!^Z^g3A`$Jg<51>rmfJ?9MvkcAz zf>|gPGY6K^%_o77X{KO@LkK?_N!23L3?aFySpzF(T@cJ#?6~)modUs0ax$ ze3)oHsVZMY4~~otX-T>7j8NfXpGnc?w|KObuhv5ZpLmjW8gpfW^52-vl9VkC5qv|H z>8O;8=ws0&8uh=rJ-S2T_7CDyS`#a1|37Ije|KQA_^BkQy?;Y%(f$>3wO^>xmm%nU zK~N}l_hMXKFQJzj`;=(x!+-e+_GtHO%uxtc$L5<6W?rN9^Dv?Z`1>^V%2t_EHzt@O3ciIl-JR;s) zBDB!h1N=oB{#uf-S5?!d1n&g}9NEl_8}A#hxq_Y-**KSqx0WuYZDt} zmeKOnPEdF{+YeXZ+g?IsbUO^=b-u;#v2^lxhVIw< zDqR>QAc!9bJsPVKiZKv7K}|CmzS9yi5BLnfA5;Sl#{+ot5wG-!2YTMj#%u(My2uI24QSyvbCKeQH?!p9myW``$ZjmKRIW11Cw}1P z2UO7(eseOF-u@r+)QaIZb9h0G$VbBOgSO98Vc%>Q(HGR#gkmT5=|pCg5C>lxwjkjM zLC8J+e%`;U*(7i9-c61F##5UlhOHax_ji4?3D}_}?QK51ZFh)^6?IF2tad&dKMxGe zD7b*LrYXKT@vvj~j|0rgmTG|PL@DBvaAzq`HGQ)|VHVs6<_rNoAiPzfTP-l5jR*A& zO^K%gquiuwirW5yqf318*Oe!JhlL=bo<;Xx%_CU~>%%ZU5*x6_evT#GgTkTM zhWCpe1ae$Q53i1kd3ZHO*hFN0Oj>lQ=bOTxD}Z7PKc(ky!y@0VYsbA7IxCL84V#I#VUZPi8&(@E-hron zsCIyhF-SmdUeT+R^VQ6lG3D~?FVia*XbdqVsna-KYi@`%!!x-+P@~i^N>uPZgC4lu zkDnXYDDl5ZgvVOGg9vlg%!oYa@8uN1YfjrDHRlu}MpDOyn@!Nu^Cfzb@*+a?yJKO# zxtlJ9@snqrSbywh8fED1-o5nm>Na$Z_pF9@6#c_dIC|HGcXu*L@|rN3K1L&5feYEb z=A1Gl*vqwn)^38b`{0|OUVvp_-JPb?&JP1pWkDky~S* z&p{xlfq-v6o@;}Vx!|D9<_V)a$5+Bo3!{h)DK<223!jWyIiWL5<_|OG#wZLB z98;Lfj(vW?K{nPM$em$yj4pNu4DNyS4d+5*c{7E8Xv5O92zZ1~qTOs8XI*p_64YP+ zq)qa@lv4&zAo5yjxKwO3B07O5by$|@Kc1=uWH&w9l zTu>Ru_DyYX;KohjX?$SBvT8k8|IkTtYB0j%Abt1Nx+;mJU`n{aW_JN}=qWb454y{g z$Y|mn(hA$I`JV+OXg8xP(EU;2eESPj))HRbXMcr4CfVx++}KK!z#f}WGm~o0M+bS` zlyJRXG^D4>Z=fkqm@Z~Jj20@S_FNTi5% zCpld3UA?*fI|uPQ`eP()(G}_i{ffP(ih6KwI#i+;>18WZ>imzfwfB+wvdxAd%i2s+ zD-&^cZ)Veg@ij@>kn9InNukQ70sTB4O{Qo`(?IS-9wkS(&}~fvemG8}a3V!-#B@vM zzZo97u4$m`d^n68GGBxY1%al476qdGX92U#?iYhtHf#`$uqBxNeWrSPv7N3L+xR>U zJKW`9^D@i>`w7$>R*Qyy+~tNIcab4<@MFj{Rm)L3G`Ys!O-%zB&>9AZ*b2YpAW9<} zL6}`=;$ZNO1fL^cSC9xlw4B0|UdSndq!W4<-{4PULUKk{2)wy*TQkntYy5%N#P8BN zv)#cY9D49yq{iyPI+ZsshQq4ap6(QcCv8TJsC?};xMyz1LA~U-!98;a58xgi-x`LJ zRflNkTcLTuL@GuI(gTh5<U~@|&~Lnf0`9eq5%v3OCTsP%%7!YdPZ%#ChS~YekWYq#0FbWH)Iw z_Q?e)##NRxxe1mNHf7FN+@S`Cb?aAI&*b6~ihDzfL2`_t63mKNoKbSdhiX?D{(YPj`&akuD`gSCL+?4DsYQU^V;-udzXlX zB)A(#`n)IfOpgsz8`4$sDvpxHA6lRm56vZK-849fT6Q!w?!dGTIKgk7pah-=S3T>Q zrL&E#P=)~9J_O))&YPU(*1qWPMA1HAfAqa2!9Ribhx5;Y@8log6bG*EuFHaiwC<=- zGH_Z8H#3Y#)s6&Cv$`ywWrq!Psla2Fpok~1HnHa;VA#}nfE=})nXIa#>C-S$+!x~< zDe&l?L~|RIeG7!3uAs8l3eW8`@|*E9i65QdfitY4$W#?r%g26Qk$E*uMe1d!nKG-+ zBvcf6tGd9KO@*8n4QhVRGGbfn8N3*zreLH)R;~6-dKxI6>Alv@rp8W<=%+QJ^DB?I z7feLg02%>M3)7Fr(hHJTrgTJ}V7_*bpm)cW>8*NryBi^Z&}$>PffI4`70M;3seCSX zNzUYgK+j8%u)v7t!{Pn1oIAlDJ2y$9Mwzg)XC5GcvBAFyvmho86Ju9(CsY``RUQ0_ z+-XcTlNDDeNIqd^daKTmd%e}bY@gl=hK(V3TP{Un~4 zaA!%1F&ZcAQuMe~?s*mE)LtYGX?9gdVzd{|XVfxD!^$MZl&Mk6Bo8Z-98;!%Gs5?Q z5q!;+OlCED<04|G>Wq6oBqT1ps?zpAj|=GW5jv9q=04q1gvo+cQI+Wd#XrAnjcP$RBKzHJ-&4b)}B;^q{+O z5bF=dtpYCJ_^oE-1mNqaEv2Arf5;GeuWqC03FaPu`CY*Cp}4&eOMvnU=A~9AgTs`u z<^yK`JnsJ-N*My7jn{|k8+d;Z1)FB9gO=q?VYs{>Z?YKHTotn-V#3icE@Cx8Baj5W z;;T=5(J>A3&T~S+zjQq=q+LgFW?{?**$*86Y_j2=FUk;A>Ako*Gi6oisK0m&zCw9? zJbyZ+neNB?s(R<40Ojb>0RT$3DdlQ`BY+UC>kec=^a7G`o^tUYxM+^nbMIdy;HOt8 zAFG*FgYKt+pPk;2c0NQ;ORK0DMA6I&<S`%LW49)Vdsf5U6C@lphLMc+3k) zeWD(X9`zVM!jQvth<=TMctDix6=frx5@ki+8Ih+GaEvM(489m{ZePP_P3lAc9ZBt$ za9l`-Pic!ayxIC^Oy{OgwX91#>yos^a%r<=P~K_%GmI7!xBe_=kR6pwF*24hT^W( zsX!DHsecoAOH~~E>D__YO5i_HzJJpiD*yeV<@K0zBg(6@ht#1#t`5=U(XYM*OGJWo za7#s@>(gX;=YFs+Eud;z;7lTqlcd_LuXGU!Mg9I{`*_|x44^uju5vg*Z)3}6ydhSWF4*nn{uG$rZ~ zTswwXtOt~X*cuFVa$Te9^gQJkuW*JY1>-caVMM`z2DiAWv6mWh-r3ZsP@rLIo!Kts z(@q01v@;LCw*yYpWCE8XH=|LG9}P?fmON@UPO4D8MC$_E9xFH^N~VZTuJuoEQ@)NA z=3O($ZfxSH$t!fNb!69$;CvEl)MdN&;Qv$CZba8qZEY}g71r(qOi!gWf+|-_WBNto zPxFa>RvXlS!eQ0tSqHs%N5rC!jB2F&{5%bYgz>4+A8+DKvrcaFu#qbG(6}usb>;Cdv3tTaFBEj#W_h;5NRMevIJ49N_UKUKEua| zb}{mjb0Tk-tF*jJ?tw{K&Fxh47x);4n)~97j^)D;arfWqunlX$J#f3DXhhw+9JwRv zE_bAlsJp^Bbr@<*103UPdGfJO)iEH1lQ~2@s1pzi0H5!4|Hr0G7~pcRVTd(dq@i@0Ii%KZ8cLQP2N1q;BV8BbGg*&YDWns=5`hxpik{cKf~Y z(2!Zxd2bqLE#gmrngpu`^uocqvO0oaq0Ik#G1*B}k%HyD*Nk>h(mQL2*yH_yzS>U{ zi%TYzp&j>eq0tL-4|)Yf0cHlgqybnuZ;D-VkueJpvHZ*@MJSP`C%Vav7+AHjB7!Xa zFd|e9hJF>D1!xaQVChDGt@`%3!(c4;{y2z;&=<(i%s>%=toF|xNCaNIMo**$R^dFJ z=#ArPx>&({<@we^qmjZ#qlc^!Blu&bbHWJzP%B|KDfMhZrD0?2z9>8MV+NS!s{7)2 zXBJPR{TiRX^il`6UiO#(gXhuKP|PiNzw9jG$h3YEO&jmb=V`}2i4-$CuUB!#eveNr zn4MC%k+kPC-DPpBxeRWzhvMeGSfX}eRR{Kse7eKJB%0z|MlC6Yn`V2~p{dKzZq+c_ z;cYjk*ayZ;tntngm4bMZg_9=Qd}}vYoTq_Y*Q-QIjAE4Hhn6n&3_!w@CK!ga->B;mLW)pk)`eLFtV&VhTSeuHQ*g_i~#0})UynDseRL= zHn>ClX3=FvVbjo2Xu8-;cs;6iJ7yrNd1r?V#B8rZoqIbv>UD6F+-K& zA4L@ZYUJwW?ngIb3?9+>q;`*YJ7!LycP|5$N)2sZ4eeg*r|~MGn+C)vslBD&Z5sn!m-=Xw?vVjrCEAc~bZPj;iVJiv zpryxj56QILj_4k`O=nH&U~An&x1Ei{`lgQPN)?ls{#B|_WBO-S0mk(2`y=~ztqKd) z2#r?BboL{KvQ>~#ZHTKZ!xv-7c&rbwKW2|OFZd4oBke}~(BbszMoU%iSk)e3V3gm~ zHx2OPg0bzEFEnG)7RwhsZNN=4CKlo8MQlHsW^kh{N`4+K`FYPj5K&2QU9}%pcAO-1 zC(MsqH>1kXa66xRt2$s!JWW=~l9YA)*FRSsqk;(~X&Yu>al}($e~bfSWNg}E`D3VD z4Tp*&W~>uUjVG{(a9es8ScIFgh$ld_E;3``k)$X}XF{4?8JpSRR^6B*8Lkh&+^=sc zBo*92hdWP#R$l9QC>>4EGhryN>O%ppYWJ(eBUKwu1wz#xY{KPDh``m;S5*x{+wOO7 zFq$Pt&MGTn&>%`u%-F9q7>C6B8mOJ*&~DBVQEfr^|MeQgE4olAG!2Ef2g4Gy3vL9v zg?37WItv2$MoH(6lVzRW>uWbh~_? zG9HNtH4i{0w_r*^_h6rG^$}E5tm1VxhUYO5lh{>Dm`6)ieb|y!I0y(14+X_Z#jwHVNhr=Qf28Y*k-cb4*Xbvd zH&rvqV$VJ*S1Ww-{IOxXL=Jxwg@))dMurWV$%$cJ87+7Ai4jpuada}@;XL6zYei=V zrzpQjBd>**U6v9;3z2MrQ(aNbfvG17<0&K6OpNyzHAI5x|!dCF(J-PY&5je1j$mnHp)L znoSoAV{iW89VO7%ZTko;Pl)h0#N&sQ)@f{7vJCDIOec)<2D$2m&NyJY4z}0ZHr>c@kT+;FZD#u<~#XoS>9^Fx2 zN$N@atn@weDjs5i#)W=H z8V=tof|fLxruH;mL@#!<9PeqmigJL25Cft;g%+EC`yB=CUFgOgCAH7bsy%)yiY$f2 zgDMPF!$}v$T(l<0lOlV0_4*nfwfpB?L_l68^r5DYDvE1f`?ex`>g{3bz((=GTlrT+ zLZcGQ1OrMpj~ENmTdHyhz!ZxBpd%VwDdDebPh_IV8-hnCWEwRg*Fr!)(Ce91EJr8x zdCUzy4d_iwfD^{#!^{sIlsciGC%1}>?Dps5O4#C|@DC%D$icWF|-hB(-@6J%KU#De1IQcRAu$$T~C6 z&B7OiklDhxDJq28<7=P{$D7P!tF7W%INN48yEijI@=I|UMfT)wJo#1n(YZnriBhO& zV)l9qIL5#)<#l=Q3GLtEdh=huFxteir3+<{(#_|A`45FQDr&ky>{V+V3g1TbE!&R| zLqA6SM}^uFga{4nWGO~xt@tRVJ|ASsQ)Q%f7CVmM25ZC_O*DiSqAU1F zfeKC(I1Wx93Y=6DLGk!{JJ~%ZRYaP6>pSuwAZChtR!UxPxZZ|Dw>*{1^U(lRwix=V zI9ypVO}*AjSCv;+=~DMdtAV^~YrPvjzFwGxZ;vf3GS9pI8zZI3OdKg?mMZ1!x-ozc zjEn^na{cdB_4!=BPpo^;1j7dZk{_E@?GDn!vFJ5|PO@zv)$QT)NN4?{STqi&y!1@? z*b#Km?ytXUq>b=DDXE1-!r5Ah6pDU1KMc&$%ST|a*nBc8U2w5tzZtxwbA^%-3paNS16nPx3T0!5h%K(NQH=( zKTwpSK+yn5ERp*Te^q(bjd2~y^Owov7-q)tc>h3A)}bD=YCXy^ac`F#j{7esC03MdrApss#w1&_5{mg zi7>OAJ$>Av-68Tj+^DPN_>O{}+8lP_+>Zb0BkoU6%NY#kXUOD|g>;xNXOhQ!@tf?_ z^PD}kABrtLd8~+IcoXw6x97IM+)H`lST}5G#6BI}8f)#Ys3v`4Y-Fnb$C0J~}FcXL-0Veod`Npn2JI zM0&+Ik?`&CPU-O$jLL^BkzQZQ{~HJ4i1!H1?w~A8SC+6q7&z$OaPZ}I89IK{q#U%|aawu<4iuF^O zP4JHu8eq%|XB_Y#h$g_IAp6Zx8Jm)P+UTQ#9W!A2UcrM=n0kA>mfO~WV=mZlpx5Fp zX(7Uwo7T%28rWTUH_UiSAHo@@@Xc0r9|e$%r<5VBaenl(%-8?IczcTf8{?fkPOnbp zLCSb2W6H~w$@j{{Z}fv=;&v%_lMpwMKh@(rd1Gb(Z}b@R+_+f(5qwZk6HeUkNMMHg zAUTV91`7D>l7|CQvdDtab$b@UeJkv+kaeVFgEg4_l()|17 z8=>px!aX4c?hE>f+%aX&sIBaS|E_tjhc{)TmM3L}98S&T>5qZowjG>?SBSNu< z&l(bIP1^omFE|hnfwVmWhY@TSohgKDSdr#zqsok_a)cay47nezKrIFS=|p{?K&YHW z@e7*PI4RM*4SF;}>>1xr*}l$CXy5Js)%K};2ab;DM^($+g+1;`Ogtz!bJd&N?OHtA zH=7#GTr6GrHz@f?R}{#t{)`9r4!^Uf1vJX9>k8!f-B~ni_1zW%n#WEdLhN8TtkL$y z(HGfCzHcX4$i|NB8oSYaRVCXDi97Mp^cP8b!i9rQJ_JCTa}fi?{UcV*2(`gi`&3-kpt3$(Lu+#~rn~p4yY0TTXi7m+(6=Ucv7qi3M(VYv%KUzFFSBLv}}?AIB2jUSs`$S(W!&v<=y3-j$0MVHwBgutOuktI+x zDjCa}NIpi{abmEnb&!u$JD`QzA%kvSdIp47gMu zhtX9XZ3fa-{L5~N~rE@dN#SgY^g~pg8OiPxTJiH1xtkS1q=W%qh z9cv;txorebh8CKN-#}Z##x0>uqRf?ac#B%;*o{Xz4p?alTUvK?o&t#xz1+zBQ95-% z3ddZAF+w1n@UEGh_m0k5UJ*APfU|)lj^Q#HdCM|DGshA!3*aN=tEu3Xk+E4WVRfaT zh@fq1mvUq-f zka0?NvfzP-0d>zd5y3>c-_hXdX^^=?AS8YZ;*0oo#aE8ZhD{3XKQOO@PGsB9ViaMr zEvD;4zR@CZ%9;RkC+s!TD!<~bwhLN^dX{OW{MNjUtJm4DZ{W3bQb~rYe|E5d^#+jj^G5pARO$_ui&duC*g(nBe|+G&BoY6TM6OqYvbHCZ6=j6N`=-* zcQs+JoSI~KQn7Q{smkf;Rp_AzhfuzkQg%g2N_d>ww46;E4+q-J>YIqd?VGTYc2Yed zQmnC!% z=tjb6d74`n=gQc!8*DN!Zs+ataFDSfD9e$=dZLxo%KQuxvP9g4^o1Th=2g)F<9;6yu6XHwsAk}AYWfkBcHJw*~6Ngi|zJva0MJCd&xh#X8@M3XO6hcnWC ze}|DCI^6ww`wH#4^fIZJBYYm$ewub_KRV+(V5VR7xt?6yJgvX6$-H1Ghd&wvLxCUoaYV(r zh9;vs>lROZs&O4hA0$q8tXQT7xV?}4kyUO4iV0}ikxm)LSsRz)dF{&7EhV2ETvo^zy>2Oq{4Jb) zFn6HgvWt7VK$K7J5rgXot z(3hI$WDj8S5O3t9(8uMP*6!?+6tR^fHAO#K(--nJ34xWZ#?!32R$Fx$15#V(>7v9o zscJ|{48_k`_Fxe=D~xn|-}c8vr?5-Hmv97`;vm{sqsntKC|3Na=9K$<&MrGo6oxh# zzto5=Io0QjPcRy5I6<#5D!|q5+buBx^qPkqb;+D_eWqiXs^UQboROB6C=AKtW5`&z z9Qa*eRCys9XeFawHGq+rZ^qtBXq!wJa*Q7z0Y2EGb?v0o4^j2Fcct_-&4c8ji7<&xOxQ^1bD~g!Q_*&Dgpe!uG{kF&}m& zS>|gvQKe4KP4PCh0fhVzZ+J}_TYiv5t7cz^OtW@qT>-xA>9Yt*9$#)M?=3&r+_owb ztK2Z%h}ERLjjN2<^i@vhJney4Wn};6*SOA3Ev#JSj7^tUT>W6GGgemK+qz1R&0eKD z^{SxxdBK;36_B%zWq@n45i27~zbmcBmI~IX%P3K!ZEjpMN=PK)oqK5vdO zKgdguymZ;`qUh7@gq-wSWhJcX{5C3|3$+L4PdDZjr`!Yjyam=nsd{J}-{B^fxi(HJ z30!%k%_x$2XsV-LVK3Y|j3Y};_g^z{-qeLT`cC>19j7lZ@FCqk>6-{JVXE3 zEPSVnRK^P|(18P4*9(!yS*8P8^|Q&oqU0;Xk>|9!=bBsAc$j=)vkhv=I#I@ot=Fk4 zD#$EZ$rL1+Qza`Kn=B|TnM|_IZS?O3J24%c!70q&qz#TnyL369-7ekY2goQ6I4Sq* zDw!*ts(3-&rQB06=B-3lsDpd(%Bdiw{j|cVcer;zcH7Jb>C{+Q7-R$%m4G1x82m!px`02ndaSjuKjSL!a^7F8K^(o{K!LpyEot@`0SVLUDD6 z?cRi%7q2N$UH|fEAN0Bqa>R7K!;^J)9f?nDGsO{xvY7!q++hpt$e ziy2{T^>T96w&s@9Y9}&}(m7C@Kl%GJjk#MZTH4lxa#xxCEp&51xRe1AekO4VE9A_` zn_FiXdrC4Kbs-4*ej^7vZo%?N!Vu8X+bc+Uk$y9>47`QH>J_fOWgxVXX0cPK4NYFg zeTPk5?fGlOWJ5DI0tqg2gi_q!YFyoBvih>9dD;{O^|p8PS@fL=s>dqz*b*}( zBBYv}ADNn&m|D}%;y4I5$npVz1F#x|zG;Lzu_d=yFcS+1UY-3ul!*mD?tO747W%mN z6`5G^N8e{+74ovYHxnzBn@o&lR4!uc<)Tza9ICFz!g>r#Va(6r46#aX!d&Z(ScQ<9 zW#gy6;&&OTD!*P8)~m=?<=3WGk*kVaRrN+y1#-ZcJi;48N)@s7hM^a7gccGXCdBl; z<-1GdRH?p{I}Gnr^%pXCKsNR&b#pK4u6cZ=46fJM-+gN9d8vgtrAs_?)Of@)vMfnLTcU8OwtK%LH#!)H00uS ztwtFWF2So|eXpO5g9mv_DT7{uRqCVbQKkP)Gf<%b#w@ zDEk0~XI8xjFHVbtL|_`h#L@KSdy$rKhuX|~nPZ`ntTPpB(R#PB&fQF)E8%sJy$Ds? z&t!j%NP}sDV#`{euh=d(c|0sVDQy**D@lUnmZdNyw{d4AmWW_*v)tbCH)N%nvQt=P z;-6>284H&h(HjBfq^1$>)kuq!*bQ!o4Xy&K5ji0rd*k%f5J#%Mb zjdGWXEwC<2V&ogL^wP@+87;u2Cew_!o!z3OX^~vW3`lsWZgT4LcJTz$Q~pVztrD zH%D?41g}k;ciZ4&nnBZOF2TUnTRb2Q6PKv&?@;OXt@Uf;iEnA$Tb!(Iv9%(Q|0N74 z!9WVM2OJ39a1mPfdcJn|4*r~r6#J7?eIc#;Z>h>C8gi({Tl-(5q4K>T%;eQ8VNY#} zHn2J_ysG)RzYrV0%)d#=Z9!+k{qN3f!IgW*i6K)|dD0a*+xps5wH}YwRS8#{eAw-x zI<2dOhgHdkWv{10>;8=T^fMaFgG7EwKCI$uYTYg#lszR9fq zgoOhrMpZp<84HxeL;w=1Yi*9Nqwa$E6{q?%mr7;W>xpp4hIK1Vv(u!17E;6ijKSBa1w5q2d z@xP2%sj)C*w1#;TP9BASEak44gMt|G(&RBo8DKTm7lwFImYRPpFDiL2X%|Ya5X*zn zmp0x1qxfy^@?&8z|)OD+Z4u*dV#=62=21OSsQiSWIsgM)gXe z=Mg9&VKg{z*V)YchUFJCfjzKa7&wcX9dm5c$hMg z_t(EEXhN<6Fs#;>YF%q=5v-}C!eYDx%8!)qT^0FCfuth)@^GaykcxVon?9&o6`5bK z{w?`{4!Nb#ER$l98aY!&6lIFW>r0Dy7H6ni5UCSujfM5wPb+->i|wb^ee+vijo)BA zo<5CLK}$>lc!G05C`aL(NtPRd|?PEY5H(GtjcPNJ>)iYMA-Ql6vB-PvLH)gutCe;wUC+uEg zqVZOCf+)P7NcM+Pw}p~_=uN)b8;^*TXsie_2ajz1qR|jarakDnEcA?=Ky~A^?}y_T zbaHy5BXKTM&=)zh`LJ~TeANTG8v<(zbdkaH8?o*6ShR%nuZ@c02)^xZ<7SU>tJmni zmy;Ryl-*E_>!?h;S9^vgciZqf=r1kzdA>fF5fboqQG=xO88 z*5=$sxB2teayf21Lx(wO(flz_#??cIdE@1HRr9apYpY&lrnpHy7UD=>B!mtWqh4Df zt8RgD@_0bH6O!({3qciV7Ym#7s?giQW?JVnidxh~Zbk9*Nu7fFG>Wp=%#K(rKy20js@ewLjwQU+anR^SyVH+?Yi+=N^iLWgkULn5#8 zE^F^dJ{HLH-*VFGaWA+^T-tzOgI}=WH-hOF$J3RT`zp7Pm=@z3oOO5&um~|2ixqgB zoQ&PrCa+i@!%BW;p|3Dbv^1OTAeF58t`pQAsw?guLtxM z^e@QS!fCF7)C~ev5mv%H`V99kQ_DOz0gy$gFRYzJer`hI`jg=`Ym@MKavQu6H`7{l?YbK5gFwp(!hp2OQc@2YgK9 z&^VEZvc}n0l=0;780(5OJawD0upm(yuh|Knb_~5>yu`=Q(2?%Fszqt-x|i-X-Xp=p zp~J~%978V+9U(!O<=`ULL)-SUId6M8GHQDf6J$uBUuv$s28G62`ZomO{pnlIwgYdt z(k;_|yO{V}e6sB@M@H;0|9@-$Pv;gn+UQ9!4L-{KM;dIeQ~8Um4~!*B?SzMueHEEC zu3w4h=}A=;T8~v;Om}`1xM1Ak+`3ZcNvO&EAF}Xo79Ek;?{ZrA`5?B=f>*s#uxd@I zvD#x0q%i8%*+}nhAy-i8UuDpQAASrhUsKxFXjU!;<{&jC>57Tr!Dl#N>5v8zm1JJC zvL&BYSepr{P0?&{&2n6XP!pNMO-c!+EQyq@U#<%aFpW}Bd`DTSJxVZeqh61>hoY7Q zQ7pyQP^>X5qD(Gcxu!;rp8ppLlZGhqvOJfCp<{Pc^%5P53Nq;%#Bw!PFB3KR3I(4> zqjaRzJa{$m09jk};EVzTko$}j3{qjn{#r^JmA+qNbk>d&n!ZZ)5XDsBxcsj^L|J@&}vYrL3)?0zz? zo1%ll{fd$?!ymWk+QO}RiFp_Km6?TR$dVYKDeclE{rX}fT1gkCVEIGWXn&i>x1b(C z7n$6%7WTE)ovCw6dCFjTuD;2wZ*hYpoK!AGgB$wvEsnF^jHu&e!6N>7{0~NTF%_Xn zi&^95$y66hnb7HGW!B=TTB|gWSgD4^Iy~}cK3FY4@LOa?{6&5@oIJkPIn1D#~5Vn1)a2FDDs?6tZNy<$9$z+a)=2h%5ZszW7DmSjj$DKmk; zIo!+Y=QW(#eftHplCH{K@(ju3iQ(lMyf15=SkHbnU*kWcPt#O01Nx2y!9yBKd|a`g1s9 zUBX4rX#_?F@u6jwpla|kCn5M=j)%uGgs^^powF|4@1Y&W6G;i5^#ou@nohJ20*{yn ztKywKhP9AZ{(d!$zOj*?rSfy5YQAOM^9>fMTvR5BEvT-wvszE<$gvA#G+C2@&E^YHCSY<3V4*qTS!-tfRK%%dV0% zQxQ&{UFrPeCYlzPF4bG@QwC?j-YtM} z0ciyn1N_wpSf!nVvIoH$#RVUivBn<9?^KGlam;8(t-e$CXDxIJGdF!zBrnz;a8X5= z_^mtNMOQA4L24q=E_HhCM}eN*l`s12wrBtD*T3F=ya%YY7(We*3JyAWPO8?wV*6wA zw$JDa3!wr62v1#MQTW|^;Iu;81$1|(`btk1=+;MBwPa-}fCjag|IV*Ps%~V4Bm%3F zTSV>jduFgjUGufnx|!t6E2h1g^GjDnY8_hgS0p5AFzBE9inIK6{d-n*-%~9`kpu0l zr$s2({PkD|_ks#5aROOxyv=V7e^CmRfl%`ss8vEq%CLNORa3I?%ZuY%zNURBdwO!*HcO*c|MtIUrkA? zNjZmIkVT65Z6eKJFqgu@d=o#ztv0-}Wx%}06bXn_#A1;%cCWDw%_ zi?a;y7v-=#%Pg#*IFViFd}5_>R#!ETNLl%bDL0j@4R4~`5^BG2=mohWPpPqc){^jY zZ9z?VIhFdr!oQ~xeEDRVZ8P22ObbN-UGNF@c7;1BF7hjN**1wBO8`WO{b7>#H%+3Y zoMS%2UPa+aq}N^HACcovG@vUi)X4aib@?>SkoiV4F^ogT}j!ns*(p-B7Y6I(Jf#EA6a#*A1RG{9MhPSmd3= zv#4s`p`(JS#pEj`zu=xMb3zwoWt>CZ%MmuL)~{sVH2jTfLv`dut@|-C)crIpdOgay zv5HJLY7f*pgfPwL8)OO1j6K8i%q~}o!yaTgaL^CbNm^GYg@~41NmS5~06MtW%TMWR z+<2m__vqjD!s_W4;+7e88)dBUsQHW+lf52kvGHakz2Qm&6_K$|Yj`~JTjN=6;ctz% zadM43Ew6qPdBzyj7Cu9I)R~$L9z?UW0%Kw@v*_SUL1@ zj(D9EGE-O0y1hWVLk>rPD9mYWHa`#T281;%R&=f=VrpFnWO6Z+5eDlcPiS3fp0|HU zFLT;5O)&*j#sefRI=^%?8_FS)nXRmM&3l6?$>&(=|C52tY`?R^^%E*dC7 zGS(jM=P($ElKpZ&3qZqJX@d+mPHsdMb>y z?>Y{BNV9#$^0(Z^z@hgeztz6`G+&MWlHE~Za(3$SBq?}<>aPBP8BKW)$S|b*iY2?- zxNVqT3pEKG%JJK1-1@+H$HEC#jUDtJoLWtc*zqa zx03kL{YmMh48hVQe!$3yjzjQ09Qp0GVuhVTlHL0c4NJ>pj=J_3OAd&X+<54{l0&d` zuJ=e6l;zzu%w3}lDuXPpJ)B}v0AE(>WC(o%Ag%jZR%6Z~n+(z^YbZj-oW4!!k@0t^ zN50`hCLhM&w%k&@*gLNfEreJXKi7&y5oP2>qLXe;1^e*37z@ ziAu#Thz^RQ+vTE(-rHJ!YE@)?!G;UzGRjwYfV-WQqKsabS4LY-Y-8GhJSi}d!~w$r zG&nBUScG$!*7XdH#}AnGsj&@l1m-yTm~ZGX9!5u7z?1G7vfhg3PL?~ws5X6($Mjyn zkRi^}Q0-Aud_LX;2({Zkd{YC1zI&R7@*~}^Z(V1vr(_K^wwYf>Q)_3Vz_8?dfTZ@< z2atK}uixjh@;Lea=;!Z`e%2nvFb&7bM;cx>i?ZUES4Uph{MQJ7YIM*=dHd*0FtW(4 z-BH10+=cUmBmX+UxX!^lRj*~%{TNpe?ao@OuwvJ48oHML(KqRTK;G9nxa~QQ+j#9< z3e&bumYT$eL={QAIRT+~9Lk2m6Eq(YMM^lOyqm4XF_bu$Tq*-}3>O>zLX=&81QbK4 z)9!kk0>vN8hR8nxuT{GHMG68iIGAYNx5%{pmM7KWG3xxuJq2J@xV5!KnF0kN z|ImVc`a-<~bQT68l)XqkMZV>}_0>lN4)P@Lr9@GO+4bFX-pB|TYE+fC&8-8JR&B`AMsFQwv8BqW5+>s2<5$xM5Q$_C@11q;eC~(QQ`8vvl<**1GK6%)$G38C`c{# zpvH86w<^-$*nEQCR5C=B*@=&c3@SO0fv51=j}O1?RjPb>)MyGWC|OmoP9CH+>We)G zIRi6)Oqr--SrBA7iHeq?vDLWVPdgTfvNM>v9iLz*djMiYw8;4M#zr*t2Y`gUu%~6# z9l3hrR6))k336VmZ}3Eh)(3<#$>7TA!DXBd9K1wyCKY`~wK(gZyG9N<3O7+4jH=HV z&dyXWktJs^U)Bv9E?0k>h$F>~<|DI}vL)rdI+^q7)gDC)xYfQ>L47-z%X2!l@MqJPRb+&Ig70P+D=ij$qZ1m)t7Qlgm2c2 z`}FLZiV%-iXtlq|KYy0zE5|%v%yape=S#Rx_Pdj3e4Fpbvs=u3`297T|KW!^K*^{+ zK;@TAWBeY)?ZqeEL-hPICvBCcDrVtkUPn^Z^hAh{?2*Bx66CkB@9#nu_9;6i@1mgR zGO+Rv`~8^JN$f{{+rzQcxKnYD8&L@sJ1~T5T^9>*zvYEh2+@BBG^PG` zsvTAtjlQ*?$8J=#mpio9WQS=6kP7w$!*9Sf~ z(%KDW(o)=f#NVszAl6>G!A z+uxT*+|N@AkiQUFJ$pHBBd^CVF}mf6166z3HrnW!^%c$ow49>eVhaX#UE{<sN3no=d;E*VC+_WvCL$AoEyCPC)OOn^IK5)jW=gMm(I>~J;$mP z&VEIEw60!zbWyBiAo~lWZH}=hTGCcgvZylqll&L$(Y6JAz1LXb7R9>S5`zYFlD^Pw zJUck3z^8Q|`X;RNCVFQNCS4K&6%#7lP5C%)GCY0E*H?ax*l`%Wj8fctXkS(&#emT+ zKD_~+;%)m!S90H>93~X@v6ui3&%qy=_L<*_X1`=20FrXl&Jm(5K*xD5H*>0g3aoBX?n8q6J zbf{FT?(QjY`X1-+8UB9H-@E*c#aLmi#kyg6Q*^LXa4Dlxr1q)sgc4a;?Ux}|N%pmC zI}fWn4|h+<-K+^(Y7aL?v=}m&iFz4RTmod92OY*-LTT|SO}ULrmG%=7AXRw&$*Fa3 zBilcrXx^yGA>Je(l>-MUn!LshA~xWeap;eDX1qiEIZQ}aq66a-SxAXaAg$at_Ts+L zkNd`67^zfaDAgVk2cuVd;}zsCGrkpM{=dHUbH<|a?i>3PD9~;9jl=PCW8$~*?&g=I znQ*s`j=u8Oq3AvT!hK|8P)q%TbX_{#fkWML>9@tPcnnkZJN*ZDvd`<y}&x(deIxp-EqEIcuFet`Rpa^5pur^E)v+^m)ri9J_6#74DP0tYEF**swJH zsv8pPx;+F=<-u5pM@s%aR&c5skbY5npc;^F^q5-)04chC>)C65ljqiENQ2pTr2;8> zp1$!DNgP~a-b@V7CgCWG1g7l7sPlB-n)VTY=N4(27tDZT6T<~V3XVU7EBgLyocWu~c%0eEvxPG+Ut!~nD)>|2j6xZexZU2wi0{lL zw0Z0y22coAri2U6WF!4cAv{Abv(OzjUQ71nT9Z%b9$|Vra71cLrl%e_edrJHEiKK) z8S{V5EOOunao~-}P$FyXE)cX5d}HcNHtJ;o5l0nw?${W7ll>&f9R9WpM3j=*qsS)g zm^*$uh!Hey4kDV}`PaOM4TJ}6G2agZWSk9PMD;=l-SxOb-|Ar-ARLY;zLlRx};PIGpUoiA6`?&_3t!yU^TZUJRtgReWw?T{= zK^XAN`U{OIu6-nTJxQYS-jsKC2MZK)?1nx|m{+$7qop$*=>uEG3XO$9+JL39irC$> z&8|NaqYvV79FoiU4Flq8;H3<2t9cAPkHyt$jEc`_CA^a!3*oOnCX1>Mw&xN&E^&X8 z`s~e+n0Se1HwnbHw~8xWjLdI5ap#31^THbncX*=uywHv@o0?R46cjR^NzHRbV&M(Q zJ4J-tNFVidX!phvjBxCNDD92?w^?4U9d_rQ)F({IRliTJwT&Y85wTJXrWa9aIm*~ zn9o1oNda_J%CNF`sQl8HRk9T^zs7>k$|1rd60;pC0G6w8MXLI<%lh(LGf@RMu&dCR zkvv+|+9rP64H$se6eIDwdcIVBk1b1uqch*mJ`iv)X z;qDMOti%PVEiWaIkJ_U`4)!5x-8Cd8BNa_^suLoNI-*3~wp^7ZH{wThKF=!3vTFcG3-y z1-N(o2;!gB9+dGD5VDbkUwvZ;ZPqkL`-=D#$!)ALpD~JzMQ5!sB=lQ*TrzbbvO6+$ zYPlhz07KcSIepLa_bPwy^XK(BeOK_;%HK`={Y1WVbxfQ%(dnExv7o@^a=Rx?C@d^0 z@_4`(g`cuff2$`|#{%Kru)@O6;2Jmj1NPBcssn&CGAjcke0EK z{D0b>0)Y>{DWdiau5pcrk1H{IJbccx;R9H#CfQ(d{TX1f;DKQf9!4#X?hQ@(`U_P3 zZ2cEDNn9STmP8P1#;4G=JI>&M;8CZ&2xb~{e4z)sAJc5+i-FsW1dZi>NkK#5wE}RPm4K8ZR&k#a(zdhlODhGT z8CNQJFUe$!F`I2|o=D)u9!;9yPD+#!kN9K$iH(}y{~WaZgdk3%`8@Z+vYOT02m|tI zH)`7RSNKtMY({}G-%VeKfnCASOX=a6##_mwXAl?ASMbITr2;8rlV;*P*p!JF&C*AG z?B^6=gR$v@sq&@jokk{o%-5k$Qtu*XkPZ3|n63;sp5fZBJv`9-&`gNQFaMc;CC?g< zAA0RUg8b(qyJsAnSF+Fbtg;C`&IXXcp;r(6VN3}=tAwm)=-ESW9(v=D`H;v*C5Ky# zY>Iu}90`Ik_YF3mq)&U&ANtbo`CM~ z>U_fN2G~R3;u>`Icc7y|pc9mWKZT!FtbY3UVg>sONicxK7dIOhv>La#+i=jwR?&I@ zc1KM2%3;6NjPcBbM+?t)*!ZjD`w5=swB*W~&Cl_ee5}kRZ~QpHVz7{q88Qag$7N!v zF%Vi5P^K`yag9vl(&kn(!eQ6R#~=b)w79N%Nvc@l`J-@m)tH zF&t~6mN#Xj4a=3kKntJmqX1Dmoq$oE1dYLX3q!A@6KT8QuwuHdkQoL%ynSOTa;%Qu zylO+fqD!gBFr}*36N|}P3fz464xLuD?rv=2TFQ7xoBkOyz9hwg4a`#FaehlYna?9* z8AQQnI0^qKZv6qB4SIVBhof4+erCQFW76InuEdgxFOYFAvr8NsRd5SsbWgHzP^srD z%8w{788CX5c+K3^C1{MR2NsIpE~8e6>ABdEmHT+!Vx65BS>e|1Op;X0(u3&w>3F@q z!qeD-UAfU5BBC8*(+I4D-f7+aB-swjn{#ZelG!6+oE#%WxjE38vW{Q$cp zYBqOD2U67qz$2I(F5K`1Wkt4BCerXnCQ|X3N8x-%AIneS&wzpcJG^bg3xj=!D(F?- zx_ktss5GgZCYATD(l_9zk#TiGa~|c5Ls^lOUYgr4pl+z&S~UTuh_}JB=GeFi)2Tur>Evi zPPy@MQ(*KNFQiT7kkL~!(?#~v6XKgvu|lhiC#kF7eRZdi?y0$2Bn?nONKFXr^Jm;w z^BIpBaq9^fFGb$c?)*Dmq}*2u03=}2cX?clCA+c3JpV1}oA~D54jR?dvas<|l!Rfb zs?m0S8|I&K{7MqW2`LpTi0t0jv?}8+?{vX+Q#sF7OsWO6#v57P#kOmnDpi*vP9u$^ z&qvv$HyG%ti4^oKh`7uXm#gV+8SdCw`x12&D}7#b6RLML_eV$4S`nIPoJVwY4k7ts z@hFx>dgvMLx?!+6tfdwRY*~_+Q2;|+2;94*D^Sa&t*wog&w%)XNH>)~2>Z9mgWj8= zE^cfFj%DVLI7SFql*yD*4j-=rE?IZvy8T0$Pq)q>HsVC3YKv66Z+$>HTv+YBLE
FKG&*IU|}&98CLi5)^Oej#pCLgRdGV;nF9sO-l0(0!}6{n|xKmMlsXsd!bmdF+)I zb?^P<-3-#Mo&0DuyNO)_v6YrCE4FEHz9*DqxpgU7N9el;^8C$aoULXh!dtJ!;kekC z^D`vB`Wr=;EqEf~(c+Wf1qJ&=B~#^5w$fS@N1lvZjLD8zBoW@+*FkR5q8DY&8)<)g zrj}+PD%L7d(O!!L17!St(gl*_f$;d*L?NEs#<<85Zg!e%B$h;cg^HKKuIXwF zMl#8RRv@=)u)-3^Z4!ap(jfg?*)OONZr4i)xA~&GrLd6@ZvX67qZJynPeuw){9~$a zE$KD`j7^4Y1o@iyCm9VF8R4HihR_Q4tgG zO)kn_=_9O7Z{i=QG9z$t*kL`4y0Xk@=r+ZByV<|pCi4||Ql=5DkQ%K|#>UmCUuhif zO@t&N22A@H1?>>;9ds5Q?TBj5xU*Agt6MFV64I(S&RG~E?NuM;3$Nfj0KKP!O*7U^ zwSJYjBSYmq8y+%t9}kcG@|%apSdFnQf3y{|27Jv}6uvIy-4WTh{;K?b2E)01lUtdB zi1M_~lRV=}6cGSp(xmL9RScTCcgM?K3>tR7I9XNcL?iY5JR`@xT#RC0R8Z#PZZ=7tt|IuyMSp|1Pjwuzg0x51Shz{T0( zUw!bDgd5SiO~D)?;$p>3OjI^u;p$GMC0Jg)pI~|Q3Qj@v2SR&)AsN#5g21vZC@gRc zwIYwT7!?n(W4-$nfh-TJK$eSzJ+0s`XwIKdS32cyGrtc*Mgt{K z6)$bU*+wvAXA8ZUDAn%Ne@Z3x7DA(brNXt_yzDB5l;~%eWPJ~ zQV%Im6lSVbkE!Aer>$BKA8F2-h0AwXWM%dAFp z&Z3p7JA|~(lP%+nrH-`tj!{*=f}qm3{8z#cwM(-x?W!(}+Gmo-aa^D+6|nuM(1O+0 zryAC>($8T4{BtGVOXAzuW(e>goxH)9x&@EY38~<{_&wJO{#~jg#{F)oY0lC~IJ!JiT(QOM+ci$iicw zS13%rY<(AreNOV|wJC2Qm?`e%{^YT1Qx#fjj*BLgrZ{X>Hdu`qBVB{RB^)u0#_|tC`x?rH#zA+=U=xAylv2U-XGS@)z^tBsY z3$qidB^8y5cf9QP4<|D-({C2KK=V|UDsq41J)DhX1x|Am<@f>?Wu5bkKA}U#b0z&H zFQw`=s4nq!2PJHUh`*&YC^~@$VxPEOYR>Y;#}ezvUNMqDRDUFRg)snqC4pqg`lL4^ zPskhT6%8$;DHRL>v1+cB_DZ``*If(fMVk*`UHj8#RHuz}I#*~sCtWG&7nZCT8Yixp(NsOn{U8grEhEri%W8_8qbF|cX=(o@$|L-%TbAp!jrxiOdczX-T1c?^ zOSglz60LsQjO{t~W*Tq8@&>%p{!gz$EpCbJAxL)j>|&=+{+55v=^N(n0`6bq`hU6R z|L*1fNBqeI96$fAR+Qrk?C+l{{1@O6s;KmicvPsVsGe=&$b}^A%2n#r)sHbIjcfpZ zOQ2lTD8F?cez|x%qfTF@&bN+>?YRz?m-jvtjMgX!XB_f{Q1a$86?3MH-G&y<5cBODvrxJc#lTN5GZDSI4Sk4B_{;>?&r-g^FO2MP|Q^4bb zX`cWOsgIC$TzuR6e-1E{!!BZlO^Kk>kNLEPT$Y4A?21~HzPw=Mbpw{i0c}D0asn(b zbVnA#O!`UdwbF5(+sMlXdD*U#dX-taW%L^v#uh$4k6n7cA^94e6rO)a<5Y#tdEOBM zZ|xr;<|i~hB*+_V%hb{>kVyT~(XxJ9o@+H1;yozyn1L4~q{zB+uUL0mJbn&SCRJ6S zR7#5Iwwk-~M6}at5A>?xCyPNAtTgmLnE?~DE)OsMs0v@Gs#GLC+|rWd<2hjgdOSS% ztx^M0NHO27__}uG|A-qs5R5c$=KIS{yc#yC82#M@6o5qw` zizBTS8qEG!As<;IWJ=Izy+FQ;#zI;;H&k<7b)rssP@SxGOivcP*6$Dlav1geQb4En z7J0>3q1`b7*<2Yc2G1Y{saI=9UVV+bxmPsaumtY{yR<;Ez+{B1(l-5v+DAyao7|DZ z@gG59eRZOqLbnjmcD_i7RJZFc8m7jI2h5nz?fje)6yV&1tyfc?r@2jpM%ni=OuzEf z11;g<_&MwsGT+qHOd)ANmyiQQNWN_f-N(fjd!sB2D!zhkB3Ho~Rs2qW`4QoWPi?It zt1n;2VO586<3L+pI~+fsuOiB7NPE=RZ006f^9raS&$Y%PQ4Nh} zvM+(WKN+7s65hN;eEJ1{$xvi5(Jx>OF?M(KsUNu+t)6%QqRh%~Vd@J1R0gyw+{;CR z1pJC?tMPMnZDW7)0MAUJ5SR}e$FM5>7H>pzD{kVY?4RHeQ z3PG@AtvdqRpbDZ}wC>{(Pfzc9X=P?=2wc=&pq#M1`XAyH`e zFAtwP_;Z02g6|qw$l8&h7@pM9=->$ph-GZ4Tqh@zaFoJIJkG)VCbzznvocVq*@tI{ zx&i;;hV#of^foW>p8!NzR)uyv*E#H@o@roVi>C3sc&=} zv6X@oglZyA(`wnyUP-h}U8Ap-_ECmhYQhjssHWydGv$HKC=IGtx3*7_e?*H=Nyagu znqY+p)wFbMsHO(VkF8r;A?PHbnvSSYO%;X}s>#-@9wtIwK2*~cQmhKqBug@b_$3L| z)NDE^O#eUMr)^SPYzaewHg@ZhEJwa12!Xf6e!M_Q8Es}6XO&CiNA&t?^2UYm$5zr- z#`WUCugPOnjtuY{TW^%mNWmvVqm6)RHlT?Ga z4G6m?mN?`S#G^IgHa+1mFCAYR?QPR*i)kE@H!E4`e4?qQw{9tgud@VNsfBBerr!@-Ic4{FY`!tD3ic4M2DZD*$8N`$P{O@RU$~IFg80|VbF;Pvx2`OI9p7Eo zZwPFQIpDBlnKJa8_P}nAKTx}q0vIoNIe~~C1odn3b|2*aIlalds{6<$z7Rt7;BAv3 z=rV0cLd3tiBk-w zv!A{Cf1%yqTe;kQO=9VeuCUlT=WN^90CM5wiO0AV zsK@s5?g|SdIr8vV`G;hBTk=?ETXL`yA6JQM^5%}Op+2I+SB0ME)rABSYLTQj&YRdT$2X1S#Dh*ihUn_yFHJ^@uh-+xHll_pF#2$6{1S&8T{U6=WAo?QNuT)u*W zazcg)+2H(?_tsrsU$qKH#sUdbTwuJHesd;KKB|4j^&Y}i>9+?D43`YB^}Aoc-p`AU z1H-bVYgwPID|=}AvS*JN85Q2>x{L%{**)|MI;Ql{E3UU$!5vXTV5W03jsE1TXRyH_ zCesXru6+A8aFmD z^sFA?I05S&qmO@{7pk=nDmL_NYh?GnYHn#0f~It=9%1#KOa+S$y`L&QpLHw%XnjfW zQ(~>mP>U!p5p^e(>~S4Jwd~J&Tzg6mm2g+($|X;qzc~%B5aMhxeQNiqO;d;^mppoc zRRPyOZ=VW%P}0vESxKySmOqzZ^crWAUbVn9F)59aE=IrWRZ)_$fuV+rPp_)aR4t(4 zj3u1q%whkET>P`5QZxHfm zLlH={Fjet@;B4YK@cdfue-@x*qxpWMu?Q}jCYq?0VCEFb50h@}vBB-G_&nn4*b&)s_; zj`GnspmE&l9w{zW$W3>fMfE1cqq%fZk%Ro(4l&?@3Co)=Vl|os>CkKV-uL; zeK_T?Hew#;&IcIo?@hlvq2xe18*uH%Jacpcak~5R<33uR;oISyU6A;a`n`y?_S_v+ z&e`*viF4%yuH6M-(eJSM_DZe9#gJ3Dlk-p_K zUrVp#yd1_EkDw}x89q!xk-h`H$RRN8)K>~+(}WcevysmaH0QU+&VB$Tjn^wUc{@Q zpbPQ2xSK0OP-mieP=(@QRp}@B(!LU6@Q`T=i(4^?id3KZ>ZZLdDb5#rQZt7u`~SlyzM^H zj=EN2F~BMP?s?&q1R-T!i91|KIy5+y!Lm_Y5l4KJ3XOL0%N=8XvCJ=-{HaF)N+B|9 zeh-`|D5VIo--{Z{&#*wlo5Y29iy%e_Ep#BaF5G6`JE+Dde-NqGEulVWPe{LcrM~q> zWIgVkeniIn-#Ym~ z5Q!BP#-8qjTO)L{Y!v_gO1{qeN=0JE_Bl_k|LV=(5M+ANt(bF=vm6+@EVT zohqaVOitW0=d!rlIGjC~L=`wI8xmTGp0Q(|73l_1b&*>LtmXZrG%s>)k}%b_&m>K4mDIS&|elS^47%|a#x1rIx^B?6IyJ<<92s_qxV)x~UJX4;qGTBGQYTesONQpio zkRf!LcbR-=;xSB0De^VmhUs!EyRdChDK1vR2Ab#}Q5$%&b4gdh94U1?D6W~iHVciZ z5pE^e2+iKB)vIk8W!3~-N~KBE%7?QP9uoT2A>z)(mIN0T3C?o07)J`H>o>CjSwRjv z%+2mw-&8i3v&|#mcZgamGPIA99T|66E(+yKVPjW_e!r`eS8~=!!e5?CmEI9~cf&QD zO;Lmr?(Q9*l7E)-7;8j*`|kS3vf}L$h7X$(dM^uiCc&LwgCoS_yrx~6~ zvS{P{i9>yS4)K*pF}Sl>8)$6~XF_USG%Ke#&e3o2>9+*+Tf+J*Q3>4Q(QgUqxA^rN zyzDbQQSB68XYs)E!+hf(dO#3WowFxxNWz*G$dIcLGYc3vT$RmxnDgM0=*cCKO>DT( zP0ugg9Ik8;9wWUYF#AFjlpJZdW2tlYS8N3(%kzt@(3aLuYRWo99^eRrBh_-VWBzCsGUk0fSTguE%fy1Y*PDKb~|9Sf|9m`PP zt_lkIGtSo}Xb%{(V_~R$S&!sz--YVL0m(coei$AM4=QK~4UHPRg;gbf81z)UxoT8< zFBk>S4Ws(o@!-+A+aanb9F~ZlXw4)wt6R;l#L(c?{Hj#uA4AkxS*msakc0?bUH_YF zU22^(nJe1-#7K@}l_Okl=h)%laH)x%r$bt|9DFGGzREQvO0PoW<^Z9ZIq{HFZjE+f zfPMIy`=A^g$s*obLDbt=A+I0@^rz=?xnd5JXj{0)^;{s=gIbSRYDIrLQLdQKoN|R_ zmi;rR{e9YZg?YvY{JX*ua0cdgU*fv`y_2NVzAFdoZqHfwLJzmUZ`}(G+kVEnzmI#R zU=Ww{MA&$jhoIhCtQ>?06 z;D93i*KydTUW;94q?!*8Sv@zVNP-TWBhO0kd_Dm?Gt@+s)&rQw?DwPO345lBry&+i zZyOz7@E9wVP)wOWbicb2uw&B*Yu$p*YOQNEFOyU-m86q2e!k%JP`+2WJ&-Ma`6szN zhze6krP^RD8yHQs7G-~Dm%e%raVpuzG1`d#WQbSE%A*$ML5a|*b=}L$yX`FZ^qtl0 z?R-q0E=bI_6U0d%1rDnjn-F`LkM6FpURy8a^nqf%(i&`b5|8wVPR3{bi5_X)5;&Jo zp4!gU+$bJZz5ckya&f=q-tMUJm_Ac;IR(HaGk{QAP z1J8g{9c8N1I@+-_)hMY=oT!uABuIdP+_2@=Els&qF`40_BqTfuWb*JRyS3eRx7}X0 zed})f-*#Vp1+79tAPFc6*dksRTU#fNT116_NZ#-7Jd*(GTKE6@k<9a)=Ujj1ch32p z-?d)_KFSn2p(8IVF-3Jgl4rOE_;EO870) zj|oN!87!CSFB->!@0ii-Sap5MS%84X5_9yG-IASE zn%36s2QEq@#L?Tw*Y~>0v&w05DEQXwtvL0skY{6m&tT3wzcBXeuh`!Cx$#bytyJ|B zORwO|=H24_-^%v{S7Md(36)boPESTpVEv7}k;^F%7tj|e)?dU}F(2mvWlKdDy_&r{ zkgN!#uHB}vL~vSs_tAgv->ILgptsa1EtpRObaP|9!6T8MmE=J$&`zyIWGUFN(78@v{wT3?%* z9apV#D?m>$d(9#taLEAQzrw%N1{G8XQ)B!_=`-w+_^nWoQ?lYgvU$YMWBl412xPsm zbGDFlu)UHq=F8?OoqqIbtJBP>oMRsPJSDrene(ONZm_qj%72lRo7Vl2lC7DNWYN+u za(1kkPo4spYE=7;%*S&ZjNmW&_Z*Yh+SCc#2t*x=3nng($*4E=>u+$$$%aJ!R~{g0 zFVvQXUnUh;zJk?MAvh{C7S6Ae*=j|xn7L+|ceQ1ev#f253b>hG0a&V2 zC%7DtQ&fNmjFV|0?yE>2Q=Y{zY#PRXKd%A3ll;@1OG{TY^ zx1#FOf{<-MY@etvc0!ktW+!UM{w8BzA{T0I zf(&`^8a47mK^e2FLLbKQ_#XCdVX}CuQ+I!v>98h49T(@;jywszaa+g77QrSrb|Wa{ zLclfEdOsukO7`exC;7=MWs+SAJBz)^jTUw~M4AhGt;A^*V+Bu`LU*zRKHvF;DKFA8 zF%5L3Zn&0y9TOD6q1$Nclkj3>=K3-kmY=jfkN)S#`kc&Cnrki07p5vOEc)=ml)>`f zU=T5}^{D<{IQ}dY6aL2d8T+(DnakGg_D^1=c>+#ZrQ#h}R_SyPGy`k&6l+wutIfR1 z8r_$ppURGZhHr58_ThSj1{#CSG_$8S|#tDW{{<~(D|$ZROt@k`6o$Mg?a9De|9M>mE6UI>j>UBJe$ z|J=p^7mzy}-`E^NY!0#wY~ht{U~OP@8^HhRm{Qs(FxI@v3FtRwpD`}sKGvX*L)PyK z?~6}1ru#_XMbg6i5`WeEL&EyspDq&n4OQ-oMun7{MLCBfS?Lb%ieHl1Pa<%LmespoeK|~b!G56tB&;*LXa{hf7 zZ?vt9R_^bg=Ju7Sllz0#v7V{>Y31VaF2xnU+_<Yw0-sykpSo%{4xD8JQ<6M`Y!j*{hUFr(L&=t!MgRh^mp z;inwmtyaxqAzlj!2+zQ)cn0p|-F|om`S1+#;2A&|Cchd=-WC`E^YT3wm;wF;xA?i4 z^mF{APkA3c|1#d5fBt2hIBG)VXAt%6-B!caWt?xLU!Ki;Q5RrxN2C;}y)%<;9Ws1y zJo@vI73jng{?l^IZWF53YkWntXfQOtlG=$p92ZVAa;DE&SX!5w`ne2}Cd8D5s9wGeuBi^m*$CrX|>5m}(lb?W|D?cIYE$_4Ae?((xFHEU%0w70uP1c|mt> zc(oleVIBqN@$2W;J13?xAyp#qYk~S3QGYAdU+e3y+|xMF zcIw(kQ#p-d7J!QV_6T2O;lbk>?0GXs-($B8h6fuRZ68Rs)ngu)AA(Pq4@&dlzC@J4 zxx@zp(v=V=dr|6LF}Xx+D?}DiD)uHm^GLh2Hw4duA>e*_aJF0lRD)>8sMb)%cFm2| z&dJpATdAXFw2ngwhZOTjF>dKNaZ`HtFpy4S`^~9ch^yRj)aVPBdg39?m1C3yw8`0; ztHh;EE_QK?E%E8Ehj0j5%-RU(gCW4Q`KTy8(6Dr67{}07nwM@>4TgzjMbIlJ(TZHzl0ET^Tv5$ZpMJD^ zLHK=b%WG7pcjqC3oB3aZuks=h=(pw5cS!006mj|@z`}9+R<}3A~Jk1og z&2~XOF?fP);>$wOX<(r;0&;LIy|MYq?Kko{*pC*~!694!$L2Ho+lITzrJ0AMs;B9Z z7^j{Z-^ibfn+Q%tY?qI#|I`;7KdYa*QF7e)u{mr#ADgUqA7GfX-^YmzfE};DA6Y-y zEOn);Pk?xi_!T5Hmnppc_~P&9HD6|yMh*^r>}Rv|;OsC;WzFa%M5$y zWvpGH!vzW94%Zv=@%jr34^c&X2tskiN=JbR4VW?&h}3UO!}ZiJ;#0%c8-(AbWarZk z!2=WLur*jK6g%x&$CCof+ug=p66F#%Gk$Tzg#0xw0=Il&@BX{wIGDahblLw!o)@}r z=$6dbo~Y`q0$O{Ud^~Kt-NkkG9*5JOyc^#<{=Ci-Y`fxN@u!^la@Rs9YBj>P%t!Np z@UQk@i3)!qLc6L|4i`;^SYYedcf*x(v_4_)T*yu|(tp)3Vkzk-G5fp;>81Dlp6fjl zy4VjkZxo|8!Cq7XyJp!>^e|d6fG`#kdLofqp*)g`N{(3)Da>6zrm)n}Ollul^n0*= z!C`1m43C~z!AH*oOV8`&d}7bpN*#2ub(US^_U>fvps3WE(V_5>rZ4@s1+S!_Q7r{+ z2c&57;`AJb8X2i(cV}3_2i>9u2T8Vq=HcKUpqTkfF z^MR*`slRAF1x)=Rp3=9Qx@;YM3z;)Qrv9$HRH+82PdrbVy4Yx{+VrDVRx13ym6m7f z_gha?Eq*h|N7Zty8`I_B6lZV}d`&O|ogrIy(8ineAMJt6_aePJREPt9K%#YY(FA4W z&0UyDTP=J1YY@gyN8@I^9(n7a`3soNMAJV0{9c94*I zvWxrJdu`Xm9HU@ua$fTtQTV&&J8wvTx!RE{zjd5l*&f?lE1h=nQ$K}|vVv8V+5Kjd zJ@|xTvrUK3Mks|b5jw_Qxs^_4bYzK`;&~Fvrw)J z;k8yuC7zZBguyKh{2RaKJ-kb%k@?Wp9=4o_4C4iXqtGU zM5XNth5yj_4(S(@xQO3LxYUv6N*u|G{Paw|s+6eR#vPxOu(mB%+cv%-Jdi+Gu95WC2!CB$3m={E3`?(TNl29mQ0OCK^TLg78y#;>xR<&e}dksqP_ ztY6EYTps)4vg5KzqGl>aO2&CP-HKCu(UI0Ox{7d;--T46&&u6h;?T)8+K5SMg=M z;CO-TPKD+X@@bpi7I4@2BW-(Rfk1rAA|k2WLokl^-}0#Km@zRtt4zDU=U~d8eba!} z{yjq}bmCLls+Qm8<2Vy5+7^KW5Rwf@g`NIX>RlmZ{ChpuC#?Bl=0$M;YZ- zqnRU2wq+(NAdW&2C|1cD{5>7$Djhby?dCv>6_ii3R-m?%(8N0@pm$10T#jHI?J!B< zzUEc36E!b4s^yTDKq)i0Yhe)u=HdDW_+G7TYs}HMt;^ANKCSJ1**J)%^>Yp3lQL!6 ztmnfoH($jdF~f3EQ$b=Mq`?jh{?3;dqTKMkZxlaZ%rqG ziQ|{Ri8p7QO_olA>P=RnHz;O!_K=F+3>w4sml3*5sAX%1=#i}XF2 zNqi|T4`J1P>7m>#v*|3WKDox9ToV8)ofQ)s3|m8TETt*)>1Iea)4XJbYv#{392plUC&XDc6=(P(b82gAvs@F@;is@t=b(=D#3(GkmR_sr_ z2YC^Gs_~DKOEgOKT}}YzHSYFssJf zYC;Y<&60Nuqs|f2Q=(@I2Cz5eacyyk0Meim1SzpBqeN6ntMD>Yf{S*^BCm7~uzvMj zY)*`{w(YK*U`pFo&%E~;1KQ5h(BMN2#Hpoo+N@KorYdb`cCeSZlyK0~_plxV;UU29 zV-*7{tl`q*5Jj+xsa&-iABQZ0<0uEdBoy5Si5ch%-|f*ld=_El!DA*ddd7y+>ur5G z+4|kCtoTIzZf90}Y=4Q`Vf9@h0S{v(tlh@L0(BW}VegS;umzkayaM9+z4u~t+VlAgm#30y5OF-K;x%KL^gkHxY`STh6@N@!4Wa~$5 zEO)r}@dUY({_P*jdGqfPBTK!+*DLtCKds7)ODjmyKt-bI#Ik znoVu`I^bZ9S(}JA{H&(WfLy0#pLut7t+r!qxYyExG#hiwifrLa3YSsaF>9EQwgIg} zjtkDsY;EVY!PMGyJhE68<`PnD3}tr`iGJ3R@Ih_nzTk7R)vm8MX5+|AyfNa`a&P!R z^W~;}zr3MSc>oG{(G|^3GkP|8=hWn)E0Pt&>ALJ=^DVrbd=M_@oHhYTT{|V;wt^6p|Cth zyY~d$D!f87-{KdqX;2GMcD92J)OFwgCXG_Of>-T7mmCXm&2dm}L+X6ocCfIC8ilOW zw$)M&PpyDjmFIk4AJ?|k<~(Tu*e)ID}knvJ+BJc^E9i*yv=P)2J@~oi{B_L zamS}xl^Z4AaPN8t-7PHU?qZak*sI$sHK^A0z=tX$BEZvPxglz8~(T5-iZ*}U{YFU){TI6i>WUrZp ze?dM;3{r0_qYrU?>hxmS`b8h&T1y||@0Pvai zCSAKITdCssgc9kp$%dVznId0ee8bkR((KYAUwo)&eZnDGQLuRtm?*WPg4o>Z)P%We zw$Zj0WyL(PnS~NtvkfS4<&OUb!=}1a?sAsVtQw9)*(Eer@k*J52t23z$QQv|RZ0Q? ztZpL|H*s#DFgVgDoD~tBy3`Xc+<2axRa@CSv~5MVvwwSFXxu9TJks&?INffX(qGG# zs4x``9pW0p!ydX7_y}Ggsu)w~zNTf2;l9Q=776#a{3X3m_(vChZ$AI~E#^#nrY6(b z6Q8Q!Nk#U;$t`wcGSv{$o0{H8yRFpb3sR-KrEFCN+Lj7y7byZ2Lg36rLM!;dDqIyL zYkpl*EG)Ngwccra!>6?$_B5a()}SBF<_Z>{XxcAP zd^S~75Frz*5VR+%2``*NvKh%54k)tT3rm`LW4U;(<$B#%(B!-l1)}otLGZ z^hp{0z`kcy!+1X|(Y%-}5wj<%*rdwGL>hAD`!eV#g^WlNjmuowxLrBJQ zf(MO#C!a$*8fNZUS5t0Mi|YNv@e74}8=qh~O3-i5_A5Hlb51T%4#GVghjZ&=sTlxT zPO@@??Xs;`2&iPm86eu$FZVYglcfJjFn_DH&boK5OlMBd zsR_yuH))(T-PQzf-tDs0iZ>pZ~i`P7a<|?lCYO;0cx` z4bkI?_366>`%}*${{gul0z38H2n0n)dD#Pk;ey-eNLO|Ku!fxa8y*JhtF0IM9dD3E z%$df)t;2}9mJO;wa{@8w5dWMuPWZydQ*<-oEc~vVPg?so`CH8$LM10vVzN1utj#O@ zkzF!uD&=pT`G4H}7}0k@gAff0|0(|y`4ZAC58;?x$>>lrdPaGw`E(^!{4go0H#pD2 zND?Kw=(|C2b@S;e@Cif^7U)BZ*Q_z3LqvdtX!AZPPZXw-{36*m30o|X>69^ zCw!_w`2o3KKjmx2F+R>-dwlvU-5tZk7(BWbQ->6#+V&^+$$p1;9Z#*n*<6UXtB3vv~nZAIKt?##Lm}*SW@P9cs%#gsrtd z04hRn;Y#9~+f@tXXG@4*N#jkI0|VEi(p%G6++bukT)C?OWf*0qh#w9i!eW%%3EzyI zKA|HHKwK0zYz^1j*W47IVQ=!X2f7*z`>cj5IV&3Eat!h^y$wlBnx%rdwW*d1D@gPh zYaDt%8faR_H)QRK*_s-LL*(vS`!DGO@kpn~TWvxhNi@8@@v`t5`ZpWyXbiNyVpRg#Bpeg1 zI>Zi0)zJsY6q;CdBpy50?**BDm*BEQCdqIri9K`Gu^1eYt!;{EW#H&H^meAOZLL%K6u)KKp~7nW>aVDI--dRpHQ<}&BW8fF zWOd7cNmr#fpPda8dH{QUNx0hHxPMVHAv&_c?ez4DT@KVtd;#o9@hvcKiJ5S5_mqH0 z*BYCZvO&ZSO6{&z=OOUURk14V!#7r^?yxleEK^F{5MtofHawrMHts-4DrS9UhdUQR zRNcWPgbAXL3Y?yncaob>txHlR~y>|Z;PQyQU@ZP%b2da_OpIC|0F2M72ReK8n4!l#$y)8XxdKQpckJ~M6a$=C5i zZXEA<>k8X({j6id7ctMDVmz}|+nE#YZ*~;JjtM`t{_Pb9L)uRJW#Rrr&?vjiF{mQ5 z+9w?xT5%v`dq&%NS@?aZ@?+^SE$bu{6NfdWUZ#}o83yAuN?tV^U*sBcg|@Q z2b`#KXTvxw5df;bC&1NOfw$wIS+y2hNp^Pq4L3BNS1vi8%%tDNq^}Dw=j`MGczb5( zFgG``5B8e&%`(A8Un2i^GP~hDO%3KMkDA5Ij9N3v31+SiB%?=+=F7O&h|F!9&xwSM0`RAoQ^2+sA4fDY2i}_S?L|DT9)LBTY%ojCm zrhr{ZW+ME7w(*4Qzsw8}y)BrU$vlR#5`MGNWyxgztol{#FsGwkqld}F%Mz{Fy)y5UVHWDFbZJoI$|8b%J4E&I|`=g32(;rEZlEux5OGL`| zYjqGJNZJ@$`Ss5>%QCzJKPUs+kL?Ws-i5z#|W{LGjgFgJGtq=gHpRkH5O zWUUBDdBQ=On~(CnzrrW){S|)s$>jZ)k-U~*qawpX@~E8f9K}b`1>_Cu0Xd4;8q~(0g;kdtDnk+2Br5{x^6>LGVI6@1LcwwU*0`tb<;-#Ey|&mK z{ZD7A=PtL`DtJ?fV-Qrr)<^4jg2s}I;P5WYG3s&ro}<6NSlU8(PFoh(+>2FP-jTL4 z@U+@ea2siBoU}DWTY=itLqHZwlk?hIq}qaS7|lsmu#M*?EBtl+6=i}W{hK@aDjR+( z*eEki(9i6|M81N;!%6j(J{K5^yp}*BU%WQ~O5_s!gp@NT4|gG~tF`vG*?LTSE4Hj= zNF1bljLnLx%uRv$5@JNW|7qJIW#oe6*OL;yveKf4Y9ow>woL?J`Fu5V=kk|Wo*rXWckEoc{Xo2v9r_Q zNb$-~EM7%{DvGP?3frzocW4y$vG|y=Ehd+QLHzE&~(P=wNC#i8d)i_bhW1Mu}H#%0+K2wk}e5`pK zQK2?aMWPSvn#Yo#XFSngYOUx}3;SQd7+`0G)BK9Dfit?^iN@B>=p@_oJWmQ9pjegd zbz=`r8ND=g0XWA2PE;)gA)i(E^58)sJTShnZsWxsd^J_bd0%B5IQe`ywf@rZ>pP@t z%HfPw^|DsA$9PYxI-d4~Utd4LIQBcno@MMo0QKJQWbK@MSxukm-a~p;@W6ICmTiZ^ z#}Q|A-i`>xhd^gy=j}NoFNt?L7v-qFKs3xVp82>Qm3pT!XpY=@T1PgG0J|E?J!lQ4 zw3XUM;U!YMfYZk>YiE(n2$~l*G%qrT;;81uJmUy^!Uy2Sya!x~b*(MK_C!I&~5s zuqE#4Dz$Z0=iIa_@y#N8;@d{4N833A{Hk_JPxE_?Qb;2DjsPhN%EkC`26ypOF)4^> zvBEhgcwla7>Gu_d4t0K=@sx!IPhZf(3h80gn|5kD(8|+x>c}M2o%H{+Q0BSu{Y33%R{92i|ehmxyqaoCMPf-DT{+2#XURgD5gR z9zHfi`q`e&@p^Ya?{k!d`x~F(9w0haB8_rdf=1=Jv#$O`hbUIs6W62Gk{$N~KA*A< znu0dg@4f=8wqqxfg(I7^hL4w1+1mZRrguS@G`j6G8tq)%iL~oPN34X45^ms#u9u1& zW>^FIZntT_g(dF#!OjRJg1hk5h37ZnyPg%&2+wiHY=?KqH*`u#upK1K1~EQ@L&4(! zwHay8y6_VlrodgkD|~u`-S}&IneqC`m(t%r?XbxO2={}n&yVzX`ZDtA$?8b z!>3wq2_IZDE?w}5YFAW2o)7lJ$vYN2b@FB7^>Dv7`{c=&!p{)mE)<+JSp8sR3pS>!3RyQg$FMMqwN;3l|`QUv~TmYD5L(k?zr5?SJ^zbgNWS8Xnm<*DPU;^C5e|v7n@CN)Xt-Bc(WT8=x zum5=vYEGKMf8fcqPanFx>2r^Y9RgS&E+q*seEwaX7+ge04nC##2p{t!ozc4w7*C5P z@)O2$0z$uNB9Ad=xbU1qHx$r5QV77h9dVyzecqg*>Lu?-vgt}mc}7GkI(X_MpDhjL z<{jpYi;aHz2FYnkVw zqv~$eIm?;W9&p4b_)l66>N+ciRD3MWtbarHZet(2^=gr5qIs{pmoGD(GS|GpP2F$A z99_jul%d%|l5<2MI@DP#3emSJh3G;QqJwidN0d%<-iS_gv3)LKfVnO&Ne!c$!p@S< ztpsgo*l8$419;J%D1%bbmEoj}O6%}jRDgI1bF3A=-`|)%7^$X-J6?Q zB>k&EqU33vnPpFwpBZUg-xHE{%<^}!_V|0KD&aQQ7(GFPd}|#hw`Oy@XdRCcePi0H z(T79Y#vih6Ddpppl3|7j-(!P+FMC-nCnI$$e?G#g{Ue=HeG;yMayGm~0qm*MLYat~ z8IgG-k7Chcg|gFT?|alIWo9EXp;|vv!qQyaJog|04~NVapZ;2R@TBdqj2XwPZwHTo z?xIjBM?gjnX6p~GhdJ?-bVLq0b)pZ!;c7l(+BNnAu62$y#!nex2k;QE00gzS3JA4_ z%d>#snPB-4;Izw+^jr0Piq&^p`5CGi{NF;67CVA?{dB^gIygifl`2SB!RWvlNR{PJ zd5OSK)$-)25eO8WsBqfR9GmS34kTxu8GMfM%aE6WK?UbPV>bEpzjOmF6}AyTQLClP zs?8oS4)PWX9=1KhF7-UHC!ZQ+ zQaTjjA1=_uirpGzi2i|}^Nkd)M0R@)o(e*Mn|J$y`)p_+m|vBN(ErpO{J_kIdM*?P zxP7AzaKk+^9a`1<$+dv|Isv&*?7%An=+@b&!LyN|0kvrrsAVJ$;4)+88BCF;#K(r8 z!VD=rh95EC(b{K8j&k8;x0lLe%)tQm$svOQi%W1>yZ2f_(8QU+tK}CUD+`Ml=!!O=5XBQtPY7l6 z2ZaZ4&4WtWoF270J$5q5z{ogW)XkNMUpS_4Yn1N^VZqC;AuM_{&$r_Go$XS%{19Pg z%K>&fzj2#AIB8TrRUe8qPc&|G1aGt3CMk#bs)08X6XB%YamG5>(yPtr0Yt|W1u4-j z|7$4xKDy=6K)46p@`y@9w%mhm`TLDUX5E?a>83C9?fUSp)zJKQqh3tK$AHY~5b}R! zsltIn-drvxsUK7WW$_P-)_8i7F)26`MJSj4%2C@){31N6E|3Sz=o!|0EIGb)mct(I zT^%-Bj({5DGnnzTg&9vP%n<+L0-;L;Bc7%$PCdbhmR!&;Mo1U{Xm!2fL^R)y%j%Xq z>Z-G6Dtne%K(lA5lUlB{D)Sn3M=%SewwT1Snl1r--1=!(i!IrLTn2NEGomWDg>`RT zi;C2>h!*kR?60mjwztD_!dKyh6`jI!3)!BQGZJi<4b5xl%6S4OfA|!N{mfTw-3}jk zqexHW1K$Xc&3(gOn5dmq%F@S2-9Fah-y&~0d-V@|oF7shTj*Q*?;LE<5NG0fzD-2j+C}=y! zD)F)h<@6)0A0@l~o4r#a{KWL7EVG^QUVb*Lyp&wXKC;G=Ck z#$2j7Kvp*)IosWSC~jwmLV_BC7XkZ71da8)g@OoYH)GA)PE~`jYu07*tw6upUCB+x8+Jwk&ba& z3~BdW%u8442M|}FeXy(8}J8R5w)9*YH zTlEA1vf6rK00o-Ip=MZCP%<$-DJp`plTDwM{OLa^9rrUy{DP0_xQmXd)C{}2Ko0K$ zZ3o;g9s;mQO3%jTq#oHlas-RLP{&*$VAlH!l&<@i{#A6{MIB~D*Zl*f>t1?RDZ7`R zrGuXimg;h9F_+~4Og1T1LA2e?(lbEGrETmH5<;$cphY;<^tJR@x!>{9+MI1C*3Lan z;ztd~Zvxm6ZRdg;d`Ji|mb#M51CV*)m3~*_ zztc>_h*?VY^H8dPo~=nNOnfNSKZ9Mi!Z9n-7dC)?;sSN^nG$I$v}3 zbxsM^{j|KJ&w3}Sg=L~*A0IcOUN7njCECt)IWoiA&PG)11IEk2mqaT{Za=|Oq7ijk z&@=d!kU(h#+z+5a0?oqUhcoU((Yx5G>i&=#{nvzb5ea`4HG1()M|Quc(RZUpzvq+H z=-o0fb{1{ptJb7?turFj+xEt+xc zJda4*OfkB;vQ_Vd9vhY!H%i6pupmPf|K@d7+O!=9ja`64SPoenI*4T3_wsIuy0{TZ zIu~9(khkgC?*y|e4vhdnxaef&0c)0p=PQaAaW-^}eY5MKgX30-J&A6K(mmSj15iSFnCIAlVJkySjF;YM9j7>z zMR9hT>{#W2!l+;C_yW&ek(`@KbF_{_4k4?`fxp@#U1m6e z@eEa^V$_S{CurzCYK}MOas$Xt+grbxb(Z?w(+-KdY1sz1byI~Sh<;7^coG&PILf86 zf?>zB6N9g_;gA>$vW3f4g91Fd&s{hMT4vB{KK(4?;#Y&Lpz3XU%2beI4f}1Wdzraj$n^^vU9oy##7M)HtwU` zdM@a`@m6L4s?RcAG6;GuXkEpxU~`OLG}EFoh56dHw|S*Md#$nY-AjT;dV?*O?D!T+ z&f{6eU%(N0p3|6i}ah^ASGP4Vgjxa(##w>R3>!~2$S{(ZrA)ET=v$T$vWPMn0 zl0J$;Vm>W;$t=(jxXClPrwop*b|R!utE5CEWsBN-c@vNeK!qC3<5%d-GJb^&5Lsj; zzg7Iol*IUrNhMaFt(sSn$e5&N852L!3mLo2(R>*{&+}!2$(E2KQ)Ee3vuW)!dOB2oUYWza?ZtI>z1G)*m>?a(^j z0Xk-dx4*(Zg(qQPydoGe+b(yS-}9L9_%TIsEJw-@iaM7VGvw&qcE#Mt=L$IXX65x` z+;;h)=lN#67;~>T>K$Qz60_0iu9<^rp>qE5kUE=E?;0GaRsNMa+#jeRIw*XiHyMbz z#`{R0v@--W@^J?u1EU7ji3)oelbWo!^G7~e+< zP{V>8c#@=5l-ybRa5l1*+u-O3s@^?Ou6-!n7;(3I^W zr*~P;s!PuM&L>iR;dDl}Y#Hr(boxcP3!<4B?AV-+Ri((aeQ&_uhgs90GBZ4P?@Oak&(UMrdF1TMdZy*uwc?E>}!O0KI&MfpW+fKQ@kd@UkR?$>x zZ^z!2i?!eE-TwBatH+4IH`jn1yu!9m7!h4#A+-fy{vVt?YvyN%*Gz4m*mVhZx5+hA zlNA@G?Oc^3;ik))Cy4oA(`CuhDP5OvU(r|k3t;MBDHQQac0&-J<2Izj+#Xa`S}bEB zdb!@4Gu?}nF`PSN4Cfp%hC9#tt*`M#r910W{FAmfL}BNgeON^H?sk6_KSDIiFK~^c zB4sll6c&mxBf#z|WN!Sd&$t>tuF{ z1=+L{UD*(!Fz)!52j~O*t`d8(T=H1<8#lbrNlZIz$DG!CaciNNt}x@4*I~A#cIuv! zdS)tjqus=ifLZ5}qdblUWiC>*3VXJY{({~fyrWM$A-+#G(9%ja`}V7Zl0;R6L54&h znNwhjIH_xYpRrlu}Y|!qtI!iRD6F82b+WDq? zS7MsJOYZyl$(v;4gnQOI!l@0PF;Z#q5w*&A*%;4BGE<##Tt^+@lP!Npe~}{OpCb7; zIH5^btrr4w70M*zjhDlN+N{A$-sfl~B3+S5;5_$ZCq-|_EC;t=6m=tCdyC?+TDVqPO%c8}jy#EtYF<18?jJ3wQ$&Yc z)8`xU1B7!6_N>E=FcHm$#px=lh{hp2={P*v#p#qS;(rEnzzsx$+U^gZcNKm zBmXUY^gyTtpQR_y1`lT%IneS&8IB=bqM|N)Kn6s}ZfGc)T8a61g$) zF+w};6XkZ7*8Xcjjxx??m>kB^fMpc)XBl_T>$c?m3cn2dG1aM}vnV5+4B{ePn|?NY znj%G-*=AMXr%Mbm$fOV+D||q^Z>fBU`@Q%COa5A|15E8@Bd#%eGyDXo7GPaTzu0*M zmkjr=@ZrQ#jB#J>Vr5Z$C9SyWt`J(HgeGUYFDeTJt)h)-wmA~we8?kn>}IgDRcjZ0 zvzuihY3={Pqi`wj=Qr7YzbrOEn7qO7k`V5Ve;-@>lT_!`epu$OP_d+^;2YgXbBp!; z!^TNjbJ>!i%RbgZmcIhQ8oApw+bZb#dZtXe-eb%^ZV&b{Ij~^3oXN^>nPAm8Xv(rF zLk;KvjvbB&AL9As4;2xqzdxoWs4B=mZrD$g;c)O+$05`H&)W3k3X24Y8yr?e=?dvs zrYnhY9b!&aqgDQu)cHpKF~dC+K5p#Ne%KrA6Ll11U^mV8S0u)Tt(~Izvr-wS$rM;0 z1<3t7T(WaBk%Ny*4{Oxgn2+tP;w{WSV83vjRYS4}GGi396g9m0G#)YB2Ms&!xL}cE ztYX?9hDk2H7xc7hT`XPwXwPY&AbyebKm8q^!H3xjsIvCF_{|j19xch}evuO3H)g6=5wP}ihQM{#2wVXwu#g?UWvtpx5lPetL@!ed$JJ%O zNj+pfYOE5wLIJH~xrmuYFjBBluo8@vO+0={c%bErU2w1!MHlJ>dk5!G0M*2cK9qbD z$s}Dgcs&ov_J`UbKLn#=j2q1C%I1*i_^D8G^VvLi;ekNx^rHt6k$`;{%gd$ldB6b@>3zRueBgP5$ zeAslBErp%v4o`9+CbT|PLgvuP3%f#=3OB*5=D>9vKyvTn*)Gox>)9dCSjzYis_Xq? zZsyKd*Y;SEqt~l({fFv4ESbI3NpO)jD6;b z=kpmxc|SQ$M0~k;!pMW=w9090xnD}1C{}5Oq^)y?&tl8muF{iRR1r}}>LG$g_r8wb_Z2KpohaE0}WN#^D| z#3WOwyYux2w};TRN!_^SeEZ`7NkZ)9^J}*IV;t>@Pa5IOLbEZfM5-xQ1*O z*dL3RZu#$H?2m;EwdlA1&i>fVy%_Qh;_c(@kHzP|vOk^xYZwYlsII$68?`@P!pl+z zeTs4Z1uXmH8fAZ68A~1RqT}b=AJ;%ZhM;4;8bh}1kC#vuJj+-1$3@&9t7I_z#?-Hs zR~}OX_`%e7BLUSq-r^mLW1!YfakHs_gUcoK58H`b=t;iJ6F?1Pe~flSYNZOiC0E3b z|4+&)`(tT3mbwcCLKbC6s8|UR9-q15Qp*mx%y`SPLk@@?@|D;jV_&oiJ7l=-hl2<8 zVOP_n;8Sws?W;)6%+mK{43YP-f68S+EQ&oN#>iDdJaea-TNg|1m<$9V49eSpncM+| zRUJLk)~Cc}G876cQ{;R(#1L5gzndZ}G!aweBJkx?nIfMdBXAUiOX9H(SoP_4ezH=t z_S35^{sItHtlyL=@_j1=?*+{T@7Wfe*gP>vv2m+sV{{m+P)`*L7EM|-!~+DmUudk25BYJ9oZE%>j;?_g z-nRzt{kf0k^RAWd0)ITV9xRCw@+ps$ET}wgkKf_*9O4I=a*cUh`YyManE`s>;jR=w z&h;hpy8+UTk~86f4Y}O2Nj7p$9y#}>@ABj6D)AD)^aT3^%XyN{f3k$!M=qZMaP{sD zH=m^=%D;ecBbA4btYlLtc~2hBWck0@mCj8joXKV!Sr*=tzq-`Kml4LW>ol=vPrA9Tw+DuZ(+ z1^=7#DCcKDbZO5sIRA7d)xe~r-r)X_!TG1Fz{?DH%?f33ev8qsl$z1?#7g{7nk#GG zqY;3#-NzrT>VPq8h!7DyJ|b_6@py9986-Es0ezM`J4q-_1&4A(`r*H78_&ReV3*9J zq^MskG9MJIH|}s6d-S7YipC_qGVKuQ*PFUa(kngUkMSbWOrK;p!jm>Qj7n#C*1OH) zOZ0Ak_}RvnFk1if*(Bwuls2r^BFtYNI_tl*1bgn0GfjU(s952ONVrEVeSa(Tk5P=4 z>00M@bl9_cUUP}Q?2xvtxUA=>E4GwPiH#_a|r?kiWd;aKx)yv`#YE&P(cD>!$mzE2t)D-#~HOZQ-@w=%bysvqD zeb1j<)q_fRoGw~@3P3K0q{l&qR6kexpSt8?c7>xrD>4NvdJj91?rS~KJFuApFQS_J4M{=c+Fwk;wt23JB z)f@NJ^q>e=7tmkP6z^lR(04NN;_3|?ixE6mBopNhek$W*py=XL39pTm$*D~)afo!u z3z1R+I{67xKqZUKgxzv$w}e%-lKR+^1(}u#PYX8E0w|d{pH|5ye%H!xQUa`hA;X_1 zu1ReVV8he`slV1y>Y$F?B&AA~Cx1!1PSS3Kp?kmoCsLj(f4I)xIO!2sX6kJ)SJqL~ zp>1==aM*S$sc_v5`*)Q|{rvAqmrymcXH4sP^S~GCI6!eCPgX90%J9i7i37~Q@GAS9 z)b)4KCq>^l4RPJr@hc?L1`NpM z6UV(oq6wsaWz`xWr7b=bc2-g#$w;NI z!@$L`$$0aXD}m$!(EwskaMGcPW|e<2k#XpiBRy4f!9UO@mr9r}ritk-75ZasvJ_iH z(V&;eaASQ*gCWrmzLNqRPI1ol zTiCYfYLU^_O7^Zu0eTykXi1SuQ|0$bYhCNk(mF1dgyI?_VP~RnSu~HjB1R-YkZ@3_ zjC_Kq9-e7k04J}0ZJXtg0LHrPp2h&**AwX~tLGIFy5ynE&??#akH>cFiNJ@<;V%Sx z6ud@UF9^Ndt{f^OW);6fA%PfxDPw5jXHGWqvIOvKSsmWAit_P0M1d$$o4N$mU;49{ zj20HiC`5Qy!xYW?#4S-cCuK=hofK^_vNB#4c$+^as}-q4%JqHAl$GV+maqbL5*1X+%4k!p17Qupa?<-&4*yp25C2w_Q|nScy@9Cbx9cqbWvWioO7Bw3L5kccVubpQ)!m5 zxsBkUK=}T{{b=58>9Px^=TGlrGFP=|q zlBi^8`u;#Z%!(L^{1rnX+bOJ-FuXJNp+XJ<2iF`iDqcjpTZmn_mmYK75ZK|;W}ec| zddy1UV-(=t-{^-Ji&-vzSVvyQZ{Fo&xBE+XGLawNwSJOj^vSk81#>CF{O(8T*o(1rH27N>}*k zbe=e>`&O0eM8h$P^MD?cXRQcpwECewDNspGr(_v%<|) zv=mK8P^o~&c{PGc5+8-la`MR|h_cBOOD!e~Yfd4YO1SQPp^P}@U9b1t%8Ay=0QJ|p zX(=W~Ll5~|C1Dpfgx$!ZWSa-_I|AN=DjRxI8Vjqg^&VdqL{+K7 zY_V{AYzAs>p!Ug^Kk0|Jf0N9#{MWxp=1=}ZSlSZEqC!ILG0EkjskSI?J=b}JnjA;!6Hi`fzZ?ck`6-F_vX za6=P~(-#i*#MSKPE@sck?(@)gHYd(YoW>Gpi0{ehXrLji_K2FZOGWIHPt*2_iw5N5 z6t6b|UAc$@@irwbXLUuhqvB6edw3|?HY`bv#cjh!`E9Zy;+Z9vr@d{%$E*~N!7Q_6 zVtV|etoN+#vO!%rL`?Q5=5IZ(nEpJ(o>wTB0yZKqnvOWmiA@_Rwu zr#_+Xfswjj$(=ATT6f~#*pe<`cM`kn?nMk1h$k_ufpgbeU#pmuskxKX_N^SoNCw}c zksKnoANddLLH|8qj2A21_CGN`@raaPSHF|}PdGs^q%aBBHa*FwYU3s2BzLiCMlV;d z%6FTuhC~q}H1e*f@>iaLR)J4wVf4|5**GOu0|$- z3HBa3TtSCL!IdiEv>>u8m4Z@%Xc*9qfY=+T3XY3Y;8$ggrySbG7kCgL>aUE2^=CZW zpfw$_W7#Wes(}ICp2OzBgXdPcztq18i1KVibRt=+f0g7k|9EeCxlJa_%LU+vDo>bo}cPE$rL<${9uKhK?u@^7Qzn%Pl zN=hy=yohYzdu&%e68}tJ{90hQ^qAJp9@Sjx*)GrY=%^YkiNAvhkv!aEuCy!ay9g^ZcC8}$S62(UddE`9 zB1V^f$#zD_2DKq07tJP?F+Vw3asSQVOf<&hpS^j>->vvX{NkJAO)Gy9mv&|U8ELm| zmII1TfDPwh-FS9Y6=d4eJJO(76skt0MQQC`X>FD`vtO<4$ktQE`p{)fGqfGWBhR<; zoRdkP#^X9@_;j?Y6Tmj+OrV=uo*#zQj_?iy51Qky^WS?YEaKt&;^UwGz{947* zh`RLdG5XOnForske4z6ZE^96tb28nb)E?aTfg8z9UOKACuEY}1&r1N|LlBe5J~QW! z=?uaX@vU(gDr?fay~21de7f;9S=LJ<4LPpm_WI$6rJB^y$8rS@5x|n%bFDJV+H4{F3YK-4wL&-OA8$Eg#OCM{~zRYBs<9 ztyK*pvx$bC9GXxeqTwR{rRCn1S0AfQs-)CqT%hGnzlP5P%i$5<<9-dZxMxLCKHaSN; zbYyms%qBGIKkKmcZSw*0RU31ayQ#P~^<9-k zrmugqq^K;_{hPZpyVY;Kl`AVBXgd8zN;JTjyGn@6S~wf`~!V1EDRS2G2nP%iMG z1tjhLt@%Ke#)tb`3o=iAkyQiEjhwB^LiUY4KQGSKS z6jIyqiQED?ZjhZRfMys$Phx1ZD9w#ftel9oh>Dfn|)AqtEhv-6l`;UTH z;pa776eDYm-w6IS6yA4;xA<4Jhs%D19eMmm**!-c6OPGiPS0O5Pd1*+l|Rawa7^EW zp_>%MvfsWnoLcjB?ctecu;ulC$9>iAy04&tisj*yvMM=pL=) zS%Ugb{#q|k@gN=Sms%}2jo_T}B;aDtSN~Fv<3*6|`5eR)zUn&^`X@9jwNtmzE>pnC z7_T?f2YrJ*D{;~CYza?Rm%7`kg74J=Y`5`5_zJB;Yu)jREFnlKPy8}2NPFX-7x^$p zykXy(w12MztDfWON$Lv<$OZ#>=U2F}nGk&5Ec%}D#I){reg%DSp6gCE1mbZh&pnaOjOvL8s_R1 z2Zd5(1YgP=jA)Z*4#r{k2)U6JuQ1BH&b zJ?VHbTkp2(+^&T9_MvAt(|)oCEZq?Qa?c=MYo{BtF)9E1ccmiJ{rB|a?WXDIPmCWa zZs1{imz_$&Z#NF6uQg^nP4`?AohZq91v-!Fe(|CFo=koaz^$)!WW_a%UMH|?>jT3O zf6m^I4DgBhvSvJR_k`J!C^Sp~QtLWTR$^Rj%7p*JijwN;peuz|s7+P=Qo@(k4S%IJ z)x2N63tz=0HvQg|^J~D1nE>>1ZI&iSP%kroE6)iVmXZ?|zo1RLmO3JJMk$sH1nT*f zbb^#3u0`{?b5TG4Vo>g)r$4WOKVlVBfJkB~R8JXZN*!MqqmJEJ%+T$Wu3y^t_03!_b4=&AJ)L%Kn2=ho0?6&Qv|6a`HNXw^1N#n7=EXNr{ zn{B|*rDEGY8=v`?NAxAt6Dxgql`Qqj)X(P8mkbYA4rQs8AU{ZfPy=MX&0>yA=U!QH*S^8eTLiRK`HPel)yz3 zFOLfI_!TyduvlaT3LPb+wD5c6*eFozr_^N>N=vL*dMhzaB4rgiWYW^=WYi63V3w{$(zjpLphj&5PpzF|x_>TJnX&ea89@TZy+ zVVW@|7vZc&0>CU}0xTpGQ3;MT)Gk$%%FW=J$C}Gzr8@p)g7f8kqrrs@Oxc&M&#h}& z+}G5nV(=HMjbo_?zAFk)se?rqEP>PDlqyMI6!b@!97e048=*5X@)Mr^#7^UYqff z+TZF^H<8K~1XF&sUF&mvKwjb zzY%QzozS(+gHLqwk@_hzZ24qsui>gV9#DBuHR7)Dkz6^WxxOX2sOY0LSpq*1P?XXg zaggLm>hF?Ouxz2&p}_gC>9iZ}&i=AahwMP0GEj4yXe+#DWSi4H$sBX8T^7UJ)v4FG z1S*VTCx_9VzTWtDmRYpg*x&P74!bAk&rI2Q^go_q^T8YTbnQ1!_54v3%=3F*$&syw z!=aM9*I%S1wc8-ia?g>iWt9^!SEYUq4_kH@;ghTB{hefG(IbOEKwxbnY#gS$08N(` z$Lgu3SD^@+f22-#R;V@qOt{6-_?GNNHkco_I`|nfu5XR%H;TVMSKF!h(r>LvIQp}e z!174n(spWTe2IErDeu>|ow~be)t&M^F7KC<|BjVS^4==%liE(L{Ca#@BDX)QlXrdB z7`@wLdE*rmJK3is7W`T{z}WDwjanPNI=?8t!@nnGc=eLhw`rZM{hK5~{=4ut_T-bx zWn(=@A1`=ZP2M>g=0o)J%^&^_eJWQCQ3eK!_-E&zYFwhrG|pIW;`(r4uwN9OQjpFFY~T{}Uq_U)sy-lBJ1UR`F3j^EioJcq`=pz&;pn)9$bAk*5t^%r%$YFaKYD07kN%CE|PZNy| z3mb_1WgjQ+AQ`mFI)tCVg`XeX}Q0Q()n${F%OfmX=n zC8Ob6-xJP2E*}lQI}`3SE;T{tyMS;iiv-Ew1tY5=1^d&YOqWM4vimB-q*}L}v`C%1 zhj5IkuS|kM`>QjZ`c{kmF=_iJh$RFUDzvN-^No@hP&*E;n|bmSa$Lp@)|J^RjiX4Q zGntu)O9bwAAt)f=p^UquRe`n@718Gkk$1Zk)aabMD5aZJtXxVuY@eDAnKL#w3tt`fNYrkN|BB8)#^CCxg+!lKyo$K5h zEt7x#wE)fI3EH7LdYvpOv0N%N#(tB4$!n0^aahe;)F9(TwdLD4IE@ZyGNx^u?g+r0 z+)Z)VHVIlFsSbT`H1vl~=qY1D?!rQf`#MJoO?I5-fD)&vse+~lg>~u187UFO(qz}`NXD2*JBdUtg;RWH z*TcA5Hez021Ol)jqraj-(3bi3cTtR3uSbZR!#WbcqpLBu^iMh%eW&%;iFZfhXQ~QA zaBRw0C%Xd#5?mKo>&aI1SpxH)c{Lhr6E(QPWZ>V=XZMht+6gdX8&*if1GpvGh?cHv zJD>Cd%__|mEAfTVNzPs5Qpp9^&xhR+8rUi$BlCfL<^6nSSRNhW`vmM=S|SJO31Q!g zq@~bPVymZO5jRN+zk~HyEy9SKCKi?;4#ChOj&Kh;+CX7bR>1WYD+~yGJc|Dsh)|K> zU&HvM^Eze`6rE@$Y9z`G*aTKGe;tsEq9tbH67j4s1eOTSVZW7Q%_ZTbw5@0*hv|XP z&^0V-!OWu8Xy4CnNIFU`Ee>Ph1vc383=@)Qbl+x3m(nlA_N`7#0pi5lAj7Hmw&41! zPgW^kh0(D)iHKe$sz2s~&z2nWH3T|##}>6jQ*FiA_t`QLt`~e%ENOG*#easEI>X_H zT6I77K$}zqqX%1`rWP=0zI@fFy&n>Yjr|rFxN@!hmK@H_B!!OI`qI!9l1~BtsFY?S z%@}cGxo{6Sa8HRmi+;Tv@@4@X)abcDnojyv=q82)M4*@DPzBbB;i%GevKyY^Z~MI1 z*Aj%%1dCdF5*ZmmU3;-H`*f^GofPd~Ri;*9#~cd?J8t)5uDX9tJ$B^8#^CVm=0^L; z944y`Zjy|+z6?@*hCjN$_4`Pu;DaG?St4j@=5vvSHCYPIxGX>$V(pF2>J+Y*eQ>`0 z-x#`=6JgDYqHl|_!7g@>Wu00YwPO>x0BRN&Z3DC6jLxT}?oHDjb)SBq3KKp~!3LB(^1}*?FuS+;U^|BqtPvqP>D+z5Los z%%+uPVg)SdapC7f=f>Eu%8xHrg)v_s*v!{4hfnO79N~bV+N{UlO*aae@iG$}t< zCaKFB?a#_NTAM#rp)1sAU#Y)CDG{TVv$ZMuJCLdfIp3e)8yi%KM+-7`1DOpXqm?N0 z#HzFnIk8ctAOa6^Ys=e}ZgjsweEXozL@q@A9dSmA8|~kYh9h9?))4T02K&GNLViNs zmamr47X?lBkBK|79J4Y7Qj{ipGvBEiEqXK3mfvXi2rM=Zx@_7TEjSvd98jOvpb9mp z{3iPb4Jyw~-DEdtP$IwM8ENAJm5cMCR{uJENGPTt%0$SPjMjU#6>tp3+r)|=jH)Q5cq0?%ZmvK z@6pMHJk**8D8XV6$Lhyt^n{y{W}i6x5C^}VX02LrXolY#JGFU^U3uonNR$219l}ru zh^d_cwO;2`%~p7hnjX__#JJ^B;1!HMjM8eXsn1s(o|D`{cxbvm2gdvwopf$EIHzH@ zDqo5mk*qvO;=%UOsT)QvwZ9tDs2rGc)v#b;bsB3Zm^V|d({?Pw0Sttp%GAsvxgaw-J%4pZf@F1g{`CX!pmI4b znsNU11JW}2(SHlJo~G6^Y#eD7cx>}ElkNHexq2Zl@zOhoXK1k^v+@bf2ZtV3{~bk= z?FY^6YbApDAg|rpW0f0 z%dG6T*3Kms5#&mMOaznfLcX{5z3Fu#%_CB3?Lz+V`yX#Gwf06_3;*s7M&F80C9;${ zewq^@NE#=?ULp*gO|TR^9&&;gW`hqBtahc=ipr$?xO(Ey0`p2lT&H>H%G)QV)=CXL z<;T)XGKTzzxI*dLi;)GKc!hw}_+MNr8|uN2wbzCl_<9pobVX;|sk8z65ctXrCcHSv5Wq>R1q ze9L=DpDQ&(u7=s$4t?y9iQHczqc7NG&!D_)64)aWp-Uq0C1_pr{)`V6I&tJe^iW0& zkK~N(79i=thWjMdH7r@^Fwj}gQNEhZ-fc2?xR;(|ajQqtss8x`ccWRiuSBMhzuw%Q z60S6{?QO1?Jua=Mh68LY&F5Sr?+rkfzXJno|ESxB~3!jjYX~=9*li>{nqrWlN z3dn|Jk05~N(fzNg=BA4r^NzPjlB|7~@>nymuDWs^2xC=|!(CPR>(pcB7Jcn*f7(Eq zGhu% zXI|D#H>G`>?t@ry`?k!8+~$l(d}{R=o!FAtCS%zXpQMmEd+Lzk4aQEM)64>jJgp#Q zM@W)R&U30abXxm1jpv+CS?4vjtBSsAc1?m7q0$Sk#dym6>pwftj$pM!SVImAQq_7B za4iwsV7Whu(bKGQ+$}ja5&UXKC^Ca9XIR_8s)5vuz*p3@V?OEY-0i z@A%$|?9uyY<1?JI_Ydb_7DHs{|Asw!-445BhlMT{u`KQ34saUNpPVtmm|NZ`V_kLZ zdz9t^|4vLz53HvotV9~)M}M|&kdRfA@K0#}`2&`t1K6QM9QD9U`mCQUC7yNXBL4N3 z!bp_|IvhyIyNk_6R*=$WW?!^RBr$I=`eyly6fT1g$EdV*NIOo50{99 zAwz&`p?1NK9vY{0Q5fyA_NqZRX2F(dby3@9mPshgajHoS<}{U|{qEaGG+B;)X(G-= zlw}EL=eNr3wRxneHxn`kNpza3o-25W6*kvdVAJ0wL{(p>HXp!2SakC%IJhBWG|tc} zS&J!v93l$GTKZ2$#B5=gHM>MeCrmV^O;` z-|aoewg_`pPi`$d79P-S`egoJ0pf|Bs%EZGm1pR7G|qrhNpHqmbsdoZo_7ADx&`9q zF|mejqbLR3bV7TwXQC~|GTe!8pDuFRQYY*Z$f`2WX~z$jzEIkbr#Rb=YUWCPcPJW| z@ZhL~kXyPI*#?x5{p^y?lZfFWqXG!`YF@KQQ3a+&GFWnU*wraHL0? z+HG*N=ZJ6>7?tVuw0dSWa`*ws7zB(d;d3GJCJaXQ|QLf-qzvhu*}R1OuO& zL*4==!SyZCH&`X~hgSU!Yk8mN@MwvCnSF|!U%(_mYNY=!Vr`;~8Bw4DIVwL_t;{td za=!*QS>zazBhvnyOfa-XuuC7Xs3)0Uq*WF31T}K~1Vc%cdR3j*Kqx0q$q6)Rabo%# z2_2QfK09p9`X=I+<5OyX7ptI)%W3kt+Sb8b`%dj42gwVOK;hiZUY&`uL`SK#Z^DD- ztMl!;C-G=8w=$+mGB=!ldGHi22I>*KLxGDTAa4!5sNODd$&XM*7Wi43~wql3wLBj$|f1rbO8Zg#&S zu>~2g6NXF6#`Rd;>&U;DCJ4nR!q-{$db*zg#%4%8$+y|Pj?eXTk%Ao7>ua~9>j;gH zo!vA$Sv^vZeLCUfl-ApKqTWHok0&0Lq$;gs&=vslF)|F%i}|qWr_^(?x|ie51~=8U zq#_&)5K=FKGfu8=td$@%RO~AV6MrTX0>m<<1oai|i4+aSJ{mpJHnC-+x9IH}lpKer zM;}{03I4pdXb;Y1!^9Nzw=!uEJ)AY_c*dvDqOwx6z z;Ppn%HzGCQO`j~KnH7riA)g&^V)7vvT0~k-Y=%beK?$b618|)Lh`b9vRMJp(ae&b+ z1^Un_HOmo{kT-NTRDskqL`{pSDFng{BQl-3wJ3E*{Y`wSJIdq z-G6%!yO}$p`&XgAr=I6NwiniGiXQDqqyhM2XQ(dGYayCHI(+*iQs!b8i(4m$&E9M1qEebJ zPnUe2RKcNbvfP6VIS?66R@XK+j4o7(NArhHb{BiKGfS*FxdvO%k;PVp5MC|TW}#qW z82r0loA;ym?k35(|1{__Y3pGf6f@WS$*W-LEoZd7K|0ml!GAepH6ceGEvnlYjWvwF zeRwo9cJ7V~wP&jCCA82St&D^Wkm{D!RnK5^^fB&WzH(1=gEai@(!%?tgLf4kxG_Gdb++T zSyKx**(mCM3l0U3XM;KXG)9!u@m9ApsCxCF%5AZFr3vLqUcWxEfF9CEmSu2<%C-{3 z?rC&a0F}C|B|6-CR+dZ^4a6*&suxA@?NmX!+DNzi*JKyGCLGt0*j^P$8TFWOoy7jw z>8eXs1?0bL-))I>A>QX{DTgG=WEvkYr18*cnP`|*7>(6Oca}r8z1o6FWQ~-$8bGaD zss6xmdtp4cWeOrmv0H&9L(`M&k<}O-&heQAdK_EixJWewy~cB@%b_!Zel>q3ewC!t zyK~MPvMElNO*J$3xGlYir-Zzf&lp)C!oI7ln$g0&U2DGtv41_xAE91Gi3aAcvsUCa zlasR((K{1ND6MOWHpRy5O8!E5 zvfV925Tiz##^vnI$?!a`MAc?W*=A{^SfFgP&@^V}4@mr8&IhPjnqBP?=7-rK!Y0&Q z_gC!Fp~9^DlMd_9VXDLthF*!@I;4dcjv>@<28wXCNaOTdbhO_XvJNTs-o8Tz6IkAr zgKp=kJpc)gU`+FNioM}A)_AAIWh*Tk=v0-5w(>ajAMH;)aRSXPkSC$_n`Qd5&d1uW z6Ws>A4Q@kbl_hSTUM^OuOVk{2_EQlmP)FVvB724){3KEzO=>UjW{h`$8Z zaeZXo`b|>Avid-LeESO2ozRO8amC2%454;vCv4(h5+T~t$N$O+c&~N5_f5BSi0WBH zNdL=*Z_}eVtcj{;Devhi4$_E;tut#zKs2R_o9qLx%lr@Q>S~uD=io$_FR|@Le0=dQ zsjiJUrgW|2KXxrr8C+sHvZaHsku7)dk4Vijzg_q-wsMfV2?W=40!wZ;i$_$C#I$-O zCUW|-N45wY?8$rzy=xtj+${|}dupTeM?Q{ti z$0h;jF(CNPkQN%SWUAJ=^+Q@`&Dg}maOCTo?2f-sZryH_TxvwZAklFOK`a70CqBc_ zCmjgI>s&|wsE?$FkG3u#ox+gl+`Zx?-{4k;kO%8NTzY^p_>$dNuHlHOkCpKl5IU{E zxWh?Lb+K4J(KiT*$8}^*+A+zb{iM7yE&}S#Ve;h4xHUTOHAkfc)|>oCc5ub-p%p=2 z%D3zMe%}sGw)TpAePov}CErq%RR&iA?-+YHLbbB+o7GPQxVmdB?1we%T|{DZtjP22 z;2;Vk93u-Ndy>Y*6q5^=5i5xF%caK>fQZzy(80NfUtAyo3tX!?AJl%_2@}jV;el)u z_5~9M4jkKx6y=|^Kj{my=|{UjD^4GmUi$7m?SE=AS0Df0RI zh9Sem?L+26JFGR*7iw4HKru-UI7uGom0BbHCcmKzm5u~qqTddjlbw&GQJ$TwmQJE{ z?a8P%aF;9w&sH=BIOE?!q@+>!1ec!_$?i=f7rjk(nD_kK+DEi6!u1*Yk6+w z@%a9CKkxr8xi9B`ncmCZdM)+n;n~FVe|Ubu<1vo?d5`@xa*q4yC1+thl=pMwOKdeo_Lh$_PqxTf znX17<~OcTkTl0!&3k; zvzO?vo`mPl{sSjpKWRsXR+5&N^#aK=J48RpVnnaW%H)@~c55-J#c=txgpqI(vbKnI zdd8ouAMKBXr8#2fk|?Cs<}-rCr9rd{%WJWBj+6LdEuq}o*VHm)y$saYxh-nF+?R#6 z5RgJzG~uVx?g)v9|Ij%^_#GgQiSQyGL=b;ej?C@*B75P7?25c$_KIcrUb#jcaC!5A zH)e&L?d(26&1!sdb32LEHeoO(e=Hj^hc&$yA@Ra49)9(#0gL)qQ}#%%|USn3PpC&m_&8IpEson0^2j zOUBdAc-mt;-^_TvImYv7#`CDOC(Bfi)JAQPnP6@Bo&0wn;D6mWHGu16Lou?e{$u-=whj5He zn(AIE{`^wii*WgH5u-MxITK#m(FK$0o=UL9O?8*LE+WpeYLKaMK-FkL;8b^JvJ%Q zJ1{O__=UO+>NE34b^Q!TR*xQ<$E6)6!cnX1mpVcp|IW>N4k^n0c$7?^vED5s8Dr(@A&s;>!r7Jk zErZB|F*(8|eOzXSZo-fu-0$-G*?1P(w+(27kGqJW(ka~EC<0uC?m_jtS>I}u1BRmJwp?q5e?6Di4-Q>uZZReC+2$5WqK&@j zR5K}RwQKTa0zO2?lp?KDNK0K6*e=767Q^r%Vh@z}OmmATv1?QhL9${ar;ZH8q!OnB zf3z503@Yw2hAOC3)A0dh>q4<{`XL>>24{ zEjnp+-K*UlK(M;*({7oPR@VdCEx5+&`jK|a+_Adu*Y3Nt`yp}9SZQ@>TpXNHXHM3V zVPYka73HsG3-w^pOFuAk{_WC5|d z1V5;?_er$%Qg^HCaeSGc6VsEhku6^(4w@AA{5XoIz;Mkb=mxr zYd~I;HS*vq-}%!0y0%C@n)|G-U+et140>{PX{x%CFH%;ARdppkwKz+8&$FsQuR0Q_ zRD00_(rK_sgY}SiW^cE^XK~>xv>4qEv0txM!1Dx62=)-+6gS?;mb;zU4OrQ*{}b6^ zA?U*Mm2n&yfm4c83 zVY)=rn%AVsM)kX-HPMp^@)E@^>Apradj(eX#VOdc36(8zH>*`f;%&r>3`1itv-2OU zVTVPngj?o1U)LX6;@s?fi4Qehux^o>4v$>OD?!1@j<94{pRBGEBWh}TT|=XsW{5s~ zK69w^eyM5i9pQUV^t4yr#@UE3D>(&u$xfw{dSd=lRJ zi}U&pT_^ojC}Cm*Nq-f|S19wvu|!Asw9HrOp@AT1%#ChU-l=v-4(BirBW<`6^XRY(FYJmI5#Fl6SuQE_B}o@-{of!XM+RPSBt7wE6PjTIC)DgEqf~WRawf6%{=mdK z3#*!zqkyUEqT>>u_@vTJOw$S?9?kMYr7C5bIQ_b-dcHSReWPTZs$L|o^fU$=N@+-} znh((C%V>ZytCg$!Vy+4=8$w;<9}?=gG2aLe$J3q3gkW1rIz7L3bX1lZuw z9vJW8EhbsyIQK(zPyg_EZ}pAD&nNzgn@9JXj=xB(N~0K1T?XBD@tF2KafX>LO{~HS zC8_1EjJ(eV_OaK;KZHP(0Xv%TiB#;&vHz z=}v-(3^jowJ{=@(7Oaj#cqO*4psD#t^RK#HL?J2*?Z3oF$Wu1sX6GIWCQ~^CcQ6YE z@I};2^Z~J~1ZylYkr-n7Nj4s!7q72o! zA0V_QE(%^N(nINRMe7K zk(1Ykz1x-2M0gfs&|&F~NvEaY1=yP&k+KD`>wiZ$k2pfsVJXKL8HY-!EG7fx)yW#hQt>Zp|o-T;qd8 zpBcu_C2$9EjuXE^9HaDdO|JMA;pflN&|1%TlVrWXnpv!MS;Uq&tEzAX>I3QlDNVE5 zDp9cVz#@21iEO9b{!xm;%oOx*LuT()Wxid$!RS@~W%=01m}B?;Om~&c9+_KTWd<_t zgD7L0z)4=mcd`acSWB_t)jd-}=Ts*1Te(XZgNGE`Or)rw=seeq==~3tR&t`d%%1az zi_ES%h?wtwm~`q7$)yI_U~(gNsboP}E~iYVVG>PD|M~i(GmK^VnC_TkpEtHpF)i)S z6dg!WNNUHH%cpZiPkPHNH&;&T04{sHf@JBG=v&J^LdR}Bjo6%eVuG5nd#F5^V|FsB zU|`(KKk>tftuhon$-8BAVpv^-_hM&{l+3Z;ov4R3(mA3wFG##FMU|XIAmmB4>x6vA ziWrjl^|R6V`Zv;8J{etZbBc*|++l%Wt&&L7AS?8TDrW79Va~~HxPMZHI2{}z++;c~As$ce{B3=&%2BH+}hO_N&p5d@}o{B!! z`jas^u}Drh76(a;fsRh$^!^FW05rclftdsi0c6fmLE{zHsOg-0_PkNGST7 z8NjPx*?OYK! zCKLE2S_P;`5ZlydbxnY6Y#EJPrl#j5jf2u$Eo%B{$yr8AWLFEHAKfZQrsaGQ;*;@_ ztO>@>kOjA(-oEH*%{)miFz_YG5EjbKUaj)M@QGicX8BcffXP19_iXgZw)4od3{jEO zqI=trGDl2SpQ=Yn_eSdW8tEGtMlykA}bb5vOI*D-QoXcnO!cFa{UxPKHZgA?GpzJbRS=p-TY;%U`kWY^C%3>cS+Z>kkDq#@AvpYXNKC!DH@#j8H1v$K<4KXJaGiOU5a-GZf z_v+Pvme=;}3&xBVvDcrGe^K)T>Lzx9*6Xz_2xU7*UGbPSXK(stN0;!=Qm-j6^t|J;GK{n}m}<5EcW6 zS-adIAqLf^J|`%TpnSDi<8xSfiC;MQ{1+OZ>q~MV(?>32e2&w{JFZFeLMfEy^(5;iI0u9;Y5YMzhI&p&3x@r$+E{4w@> z!uHt|Kn$wpS%~;cF7eie*^Tz5KkBA(GLA1GNKPKY@>qB46$67mT!xgaUQus0-m&x>5(#CjK&@jnZenx%RxvA%*6={<*P&nz)iCHU)I@O23W&w?;?iv0 z?c}b{LwaSI8|f7kVgETGYi2%4yef`O567ez?;xR`WYLReXNe5qn$bxMew0ZYRJm@^ z&CUdI-Qve@jlN|jM)1&At;iNowsd7DoZ3Rk6>^PtwIGE|k`v!GR78>@Os>Kh#rWOV z(n-k?;a15VK`75gC037gtPhtx>?}5w6aqsmqX|!3h++y+oV-@ds7u;RX*wuKzREq+ zZbJa&#A3QbZc;Us0M64!iktJf#BlEN zFR(#g_*uEzqMpdbldvQ($8j$W;I4Mu2gQB4>!u7t7dh^S#Q!|UT`ca?9QQ(jGtqJP z;ciKFtpq$c@W(OoZrP|dE#Dl#y18ZlIxTo_Zc|z;qh}?7h-I7$`H6(J znXD`n8ocuKv9cLDQqq_x5jLDpg!TUsyk%k#6WQjLfqvVFu=~xwrNWh!Y{_m%tsr?*0XwPS)H~w^2$*Vf zRxm39+)v(bRe1;`RmOs+6eQScZE}Eb{`0{#Dss|PCqfkrMO|Ql&}B5Ng`F+|7lOTEJ}L?$W)^( zpFym(`>jnf4*8O!*%oV4A+HC(NR_;s@D@p1yo-6+S20i0i3=#1lLLqDNo^ybxgNqy zj1cAhM&@Zy0TPQ__%hXsyp zIww7WV5nWoZCnhK@oGu`bmA24#^a*RdV_v4fwt} zT}MvyB&X}_DkrDwj>}2fiJYz*o0BwJlN}Q1*8n}!YTI?@mJiWujRPu-^u@;n3oIQh z05JERK6x}4b$6+hrQ6Tm`U_ycaefwdLz7*V(x@{1;;3(n^3fJ@l9C=g-dE)P(?31l zH!QyQim%Ttb;9<<%1~>JjS7^nB%JXm-0AdE-0mTebD%WlC}=2;5KX6z9*70I9+hFs zxfq8;PWi5rJPSV{Pyd)akDmA5JULYBx(~?j%~L|$JmtjA$x~$M(?0{wiRyV5;hB1_ z`zLv3j>F!Yr-Zn9x(8)WwhJZOX&;d7*<-Su{7I ziS&cxlGbrty1;jwJEonumn=Y|bV%p75im`bP)A^CR==ec%G1|M0%z8y^nwCB7E4)0 zWaUUlj}Ir<4VP6Teb#6=#HCiWO6QLHX{(z}c6h%Gcmv~|9j_KpV8>cR!k!oNGhXAy ztRZg=+9c1WA172rAyx9!s~Kc65QKTRfk@^m?F zw+vD>!M5q5WBqEyFK>*WK7W_BKvUWos{O<~fiO5JY<1NMtjEuh{u6w%16Qhwa^Sl~ zd?yJJ?z65o(*IXJoj${AfaObX(y21-)we1b?Oz>0{>)fU;4K8Y>tE{OroQ<6c-v3>ItngQL5fo!wvylB}#VtM#k!cAN~WTG>+A~D@y+- zq@i0~8T{BZXdT6Q>j=!?f|a;4`X_2oHBB||8u0B)=KuaM?Ye#-{I`sv38F1f8fN8S z!NhdUD0J0es2~4~o~eQloA@a=S*vaL^NCu!KWY4XGSH0@`);KrI-+)b+?3gY*hT6o zVM28hIcc8{3xbehkr z31V(t(_>x;S+i>%a5H1RPV#Vv)+uVU)Vw14jG5SqMb=Es&5j@N<<#D-`F^M7VKhH8 zH9lGNgO9K8S4rs9_lpAXpVoJG{`*%mqn9$nIKHAYSiz~GTi0}l0CDP(QBRQuy;mA^ zk%VP>5xYwFQb}EG>B~MfiF+|mb?x^}nI-*|3ZXFfW^|Y%C8wjc&`z6K?nv@D)@qjt zd|@A?{n-jwxyZ^|&FJz9qAK47L&2&sqCL{A%f?%q|I@m4vt*=pw__QZk`7(>F;Vxb;d$ z`=|dU!`JgDWf-~AFNpCLzh~9y&hSywF==G55g{~v8Ohx7^ui;$nbYCXY|P%MC_|5# zfVl*cr6xN5aVE5?H&!lcwoi@328|K8x*45X8It=Qz23#XhNfw<$A|~)O;74fA_GH{ zExYg+;37Miq(n3)Ng_nJ!BY1(U3_{D9fHlp7$1mS-^1SUtuGu67$&9B5s(BAQ87Zmr7p|EUjm-EsPGrj&KVbzpU; zIjA?aAFcDuGqNoRmHOaLsi!|(hHoO8<2LP>em;kQOh2E3oA%Lm9CdT)gY~I2m;IA$ zbG@F&@b2vrN~Hy6CwigtV?$xCGl-w9^-|e_afX!96BTvRa_$14^SNiagym$wO#BcK zEwpl|Xm*?6pu&dRv(O)+JzNqt$k z%)~4_D7w}ejhAE1{2kGu4`6_1FBZ7wy1a1~Ml9Tlp%k(2C-!No*+~UeU|7L9XMxS~ z(0gQ3Bv;ik&2DT4Xp7PX6Yi(p#Cst&WpcGxKbHN5*%6^e zd`K4Qb4F{Yo=}@gC0niCI;AOS-f=&J*9GU)bEAxAY)YCv-@>KW!!c83DvGMB>RU&r zO4Z+)DxZO!B6*G0McWn_Yu+z|Ob{~wL)0Flpg%H+m2>qyNloj@EcXCQX1vVsg&YMZ zXBN0~Qw_vKK~j*GN*@!ijCgKmJ0vpg?~=g6EJ^2$hSSM3Dg8{hzD2C4)@d{oT6{$_ zdZq~*2wP!Vj}g;lLlb6eg9hm9GX{jN_rzzo3cu(G;f3ToPytNgVtADGc>2FV3EiJ4qcdX76(~zCAFOFpo!itMY3{vH7#?cXT@- zy>$4^V{?`~9c@?1dHq~6-m+sIJW{ClV=|vYs^s(>XD#GpeSXWReY%8RAajz}8V)CH ztBfz-CV_pox#g;N#q8&U5SBAWT6}|vCEmtG@FMi@<$B_4=pTVhgQI)Zd&B=g#XR00D)&cY} zb^cFD=mNP%r(DXURM#5Qgryok7yH-)vg&A+U?c%`ly$)1hUfGmz8VDCQTp_?66EGH z$(gQW@>#%AnaSs34Mdo=&KwT9b66KQM4&s7Dg5}cK*jh0^nRwpj@^U(j(gP(F%rDk zi@=s}hCXtQl}YpZ(p!ncDwGX$?UOly{~>`+`JELemd(lRSVdr__^l2U_0C9a7$R&q zON8k)03%$pkD1u{V55aJn8)lab5mw;%nBFBq|Z4fZw_N!%-8dV?EO};3+%uJ_4g^+ z|2^gI|K4{oaw@ckL$(YiG&=$mA+t7S$TjYpPeL74U-w>%I`dSOV^OEdbDT*XQ8H3p z2dI$Voy&S*to6wYyezK3qz%`c>|j1Hx77 z3{=YT5aL&Y>z$4C-1oP#<22+NiSCYUee5tzPAcNCn!5x`0dN5^G<5h1={aMfyM)pC z@j~{SGT@I-dBNC}d6H7ABLHU7D41PZq~Dt!J}Fxe$IFxc)2J8Yvs)0r)8geT*^R`2 zd2hcpDcwKDW3zZXG{)oG;_>Y<9^Vp=o-rPGiO20@Jiaa-OT@!%6rbu5HrJXXvWmxN zsZApLhkE&Wi5)@Tjz=hz2Zd_$n!P2v+h1PY{&u;kVSWM-5w80nR^sIYhkpw}GwZl0 zq^gEBg=0&x^jZD zo6)mkCnxM_j#<@{5`Xg!jjtIRpBVANPw99emP()Ez{T3xUjcBN0jc;6Tw7^U8ES8G zBto`vQ-b0XH2>)UewpxJ<1Xprq8wenU3_JFY0Lne;11oP@y@7Kr--nd%*}j6ee%SN ztXM!v_Q+;S)0a?s+J5YtL>ps2_PTY35_(hEQx8hhIQ&TURR4#tADcgFKlU$U?8lCb z+K+wi|KEP>W3K(!1}Lqul&lsIbSm~??8hS5pI$QwQf!R*SoZ`>h+jf)Ak=MQhu>XK z%cZXo-|TV1@OaJC(EQ^PLf8w4+1&KUC02#u^`*~tT%YizPjOr>NH%w}$am7V=_3=N z889nYV)uN@k!$g#|AZf2Z3ezu@6Gr=g|G4fd`apelIVNrlW~M*7TzNhh&jp^){+z-ZXu}6nlh;s zvg#oL)@=IGPy#M}O}MiQwbzPF$G%QQIxkDu9OfBRvLid?HMdc)+MdiRjO*);)I6Kn>cQ+pY z(c|y*<;TRIexbzw!r1t^+4wTn(i4dyt0iY=z&PPXHvFJ$To)W4 zE~L0q^@HqE(^rg!kMc^+&RAgzWh`h-YIlrctN!>h<*?cMr>qLzeqLrHxX^9>V{90w zU!tKqM^;r}a$2;PdIM`)qCIz0f-yXR>1=d|AhaLAyS)@O~k{3#`?CFVL+$ZDYn_!Oah@^+3`sJ`a}W2=iZlvjO8BaALCGaxoXSo zE)v+fI3jb<9`ItQ@401vO^5!~JpV{v{gXT^GI?G;n&(!DdQLkf8=H05`>vDqJp^ZQ zHpdvSqlp=Z6)tKN-t;Ym!>iPH8hu|-LhNLB9c3$>>&80l^MEg7!S-!u69b#$qy7vU z@t2kL7=On37)Z<96doW!FTV$p_!m%*j#q)_LNhyl&xezfC%q4MX43SsZLDB7fj)Sm z_$BFvYOL~p43|2hY&CN(nI;CkelFLz{NXi45M_L;=?SNQP6 z#22WC`U@oHimV?k3tX*e|Hbxgw`l+Qhx*HP0-BdQSI9up+?q|(P8ynE&2Gf*Jl_|v zX5}80Uh{+pH@!kXnw4p%+thC)?W$~A0~)!> zv3==lNK4I<6d^qww`%aSJ(dGmztv!{>=%hA*Yx?!o^x?RPn?-0O_r9;qAeDn95=pHdUU*ny{g=S}qguiW=U+-Jj zB_{RKf+?~nGqF_zxbc=8x3?Ch1K}ZvX@w@ zoaL7LU>=fcW(1<--gi*&zf+HC?NZUsYH6z;J#Th%5l433gw}A}@pN>LnfNvFTR!r2W9rfepTm%{yV6r% zt<4e}$e5Zu)~8+Pmx+_uCg?J+)hBpeS%ggrK}@y_C$;8%FQ z#nZ`i3(x0xzR&Y>o(Y%y^XJR>%kw?=d7gJgNlx%PJbgTW;CYAVl+v8wCwQ*lY2?|> zGwstk!JqMb;Zkg2@oeFFmgiNT3ogqE{)A^I&+|MNl;s59XwC_Kig%RfDxPb3?&Nuv z=Ox1GrsM>F!1JG%Q zX+G}x8sB4|C;6T}(|MYCXP)j^Il*3@zwlg9PuX~+En9j2JCBq}o}c3W((Ihz?|CF# zo_TX}f&~rE^E~fI=H>(+YNXG2p5saL_?t%K-;2ASN92~F+}-Z`wQ7?_54Wt|4#cK(Ebl; z|DW-nwQT7~QLlMTb~W6{D+{YgQcqNKFb?(0u!jAmMd~Ml+BsfXYW6P3QB|UG(f;sD zGK)p0gPC3|2G3D-D8)-m6qL&w?TT95E5yzFI`_TMeV57G?06nZLM~6=$D57w3$X}x zBBTnUC}9kWE^_4)`h!b6oG%0G?5zht9|h5-N;9#Zl&ZQ`#Ws>)BPydEEAXjrj2yIc zdbKhRShRB)eoc+`!XIfL%B+oRER?jj7esDHb0?0j5sOG8VGHd=`U7UaKl-fME%&o> z;xSM4Um)tN#F*EAK(tf4|H^L1_Z*C*BB-c#sHi&C7*;#fHJ(VnLQEJX#K;>EHNIqM z3Mbtwtj2h|yG~UVM0VgP()P>`5DDhsXLh4yc<%@JLtdg@WenGo{O=y~h^l_k5A z#%4b2==x7F2KAU*f@&JFNz(nCtkL~^=q{me;cRSdytOgb1nrB9p0ro>SASbZ{_aTIY?m8CCiC-H)}8bY8n4st<2~ft!Yt% zamyVV%2&^>d0DzY+C0@v{8=_orm877AKaHTHUhj5z~zj9IU4K*q>VZ9TaEUa?+08* zJ)5X28|}A#cuWbRm$eS*{3$XVeNJ-19QA~Yc@{R?4=^GTCn4KPp%JbTg8CW{!-(O> z^&lN#*^`P%%_$73Hn}Oe2qoFZ0?JrG8O6fERBHWI4&#Bb$Y~zY9-Im}f;2R)70h_a zU}|R{s=}3jXZD=Tp>>l?kTN@0&acs2WiNwzIFj0Mv^(P91d(F<3U443O3^-tTWq{^ zK1qq>o>1Yj$v|L&%njE?o{T&Tz$NN+fP}5PG>1j3Y^mEl$L10{QSU%5L6DF zd}TcE>(GeZGM-0G?!%_PE0f-_W+H|5RzA-xWI|B9>O{)mHk`GMG=)@(K`94NWjx`L zpXoc@?YAzYg4l84SMWp6UZ{^JTyJk*Ce8_rCqj{E{ zg;Ye$Fcvo1F+6cy*JLlorLNIqw^8=FKhx8NnA>bjLVX%4J=JOz~?w2p!dbwVq=4kdyE>fuCn)|(~@-lqeiDL)vMy|o} zl$iL<(4Nx`tSS6Jw;)w;i%&C1ZY=!w@ru`oHN}k5TTQKn5~udCU8Og-G@|=f`Me#e zeBQOOh@!+5KCIi0w`!(J1G#mM&vBAFI%1Auo1^5Zp^niJ%K+}~lhRZ^e-zlRRmM@+ z+At!0kWUuZfhTp>Pejb6hr3xoXLNLFgT022rUv^~UU4iCk z;bqHMKPLI(K$VHc-Qx=G2m9p-kz)*ICtfSd81E9D@Van0M4+hg)@@@;Cxl;tEcjZp z^;2qrAEGbBJ#ElunBH9Km#{UrX`3&x(^*%roKvx+-tO8!sj!YfUkpuQf*Hv}K7E>crzRTL6M?wumGEX2h)3$2R$_Fsi* zEl=#Kmc*~F64$bFM^%#WV${zs{}Op`=p%sK&F!|UM+xU28Fzzjydlz0v{Q&C5qb{} z&B;K=`{*J_hV7h!`jN)t0BcI8>|A3Qj_#B#r@8&-kMI)X(VZ`n1>e8p6*;JOMfyb? z-QM>OO(b|SMB4T0RjdlkS$*R~Hl>ru9TBZVnlF__YwP3#5$!+n@^c~RdObv+UpLX+#&$pS~Z%hAo zyvqNy;-zh0Tz+9}^0e5Zr8mUSl}e6#k^nJZ&Y{4XOF`1L7|+dBYszqPZS=sj8`?g% zh~oeaB%l9rPi?s4?!>Tv`O9cxzP1DnzcFc%a9y>>NsLW|W5B}tTlHWj2(tmlr1Gu0 zD-#qrF32!@;<94v5+(Y$z4e%sF~OnZg2$UZmyHR|J1#ia?8zGwoPS)fpZoa0 z!kN6W#BogC6U?69jtLHnr5$6OOtgV%H?`idX!-Qmr!V~6k{cGq!U@|KJN3dGNM5t^ zdy+?dBVAieoGXU$f)C_@CCcVrkp*e~ZnW)^^M1+m>Gf@HWN?z;EW;?DS`V%OR)( zQs_p<)$V`UIx_I7Z`mlBbPY{Y2c?oBc zsc=@B?a$sv&wzZOhYOqSt6gCN5SXwE?j#EKAa){npzLNaZmIpS7DA9MWN6Jhg2rM2 zdFLm0&Y7JaTxE-X~q0|LuUSrIL z_6pxD1dm*y%CZ&@W4}xG4f)9`qdr-c2NfAE_U$6x<82a8ww}Red-Z=vH4Nt#rGkNE z+X#1X6oSUZ7R^ZPpwVpKyPX`XWT{V89yFv`60du2IY693u~<$P_ANw_@G1$VEkAKA z)C{I~-ig%|6k3m=KE_@{qx}X= zs`k@2MfHpBUokP*Nc)xA*M3_{BXRZm{x#y#l7%v^%+7YcR82rG_%3RR2C)Z+I&Q4;iI$~A?xVDWxpD# zf&U>u*a-p#He50=odo|Xpof9iXw_8OwYsW?7;(A?WF2Bg>G8#Agk*U2yT>%de#V5` z!t|7GLJaDB`fkd@;9=ZkTI|0w5wp!!Ozg!TnRW2w62EdA&f$E;S4byb#6*OBw7j;-UiM2}=TuFtOo3EQrMv(U9FxAr zO}|z4JJ$lVOz5GnfVcHXZ~@@C(VNm-$iP(AYfG^_%xu~ra3lgS4EL`(VXc` zO+yoQRTOAvt?Ck_tObi?_!kJey^OvA-R`0_@Dk2cVSTfm3x+m(1%Fb;u*5rwc#CtI z?XP?%(|KVvC;^XBST5C!O#(?Ir~5JU6%?yUVW6D5Sp#KE33;l)q=@Z?`Un*ioele8 zCTy`_raZg#5y^^cBdKqpCpONyt#rs|-B#$pim&FK4}!~UhUHMbID_4EvEmnF9sPWu zVB9R!EXXbF+ex&)-IPIYPPBz$4SitF?Aa&2ja;fw~vvkij4H?9x zo9E-wKh1U-^T+LtBHHm5T8f4cMyj-g**W5N#sQ7WWP%8@uhYgm@h(f@A8^Rf)4jPk zzsdgi!y1BBC46XsAo663!QPvXh44MRb)sh5knXvrjQ-&!EH_p6Xz-uFt%QLqbQnbl znVnxGyxG20W(O(z4SZ#rnI|`}31*tzV1H|o^neUMUF1(^AgU^GpxKMqp=WWR$=*WW z>)i9K>3MGM6NoG83H(>xAlZ5gvxoGg7Q0Z*_K~mYvSsqv=LGYaua=78$`~=>8gKtq-Yu-#_8)PzC>v1&!A~sYj|N(-o5mwvB)V(q*y+sB{OEL} z?F@CLKN)H_dv`{SJKH8Db_Jpg-_{=vu_A^GWiqn?3^v=B+$F^lf&gp3S5RP8pT`CZ z4QySS(zVfN+djH+gLd>%B2B)ng@n$*JG?`wzjd zRWqVPt-_2AQkF0?p-`Az*75?i(e3{cEzSdGAF8L96cT zo*Ag`9T@s)^!erI=p(8hncK!s=V+qZs+7RTTK_h5k7PIWwMIrqfj!ANcEY%-ZldES zDD#s_UiORG6}GpnCx)CFM*@Za(DEzQZmSujO|%fBKW z61#x*Cqb3DrPhlf%$EL_{VkKkN@l3V_jZdl^{dtN&5N2HA*@?5!1?#q9&5TxQm#p` z@?_^Nql(5pOEW>A+h}g_&uH--DQ~e>#y!>ajW(79_* z-|e1H8|%%19+v8F!a9k5#;myr3!h7{o%h$+$D|L?YWutTO-4RM87C#LG_2`I6R&#X z|3i3C{U-Wc+oZ_but2zv`D=gwp<0!Xx#Nx=nnztBt`2F~Ik7y^?~m?k{hy&rlchUJq0cz$ijPM2DWf>@{2bM6 zL@F;C7JB$*FwrcT{i^QbVc#H4RbcsLTvsJhe&kv6TQ}-b;zDAgWJE0ubp91ldI3r- z=ynzO1;&)P7BfXm5pkntXZn|Mv5tCC4~xvObtt$qnvSF zA24gK@leZtS~DbLn`p&gs(4}`pkDt3@sL-R|G-76;b?RZS4R7ygDZ2l3fdYfiR_5% z!79aRje6`1oqzi|(W{47ODJNar*dYtCsHv?gtz885zrz>@iQ@ym)L1=5>)Jse-G$o z8oy8gb{?GXnkfTjsmD{JKU?2WSLN$caTxXkaHTo}QU!Fikths3lCfHLtmRAQOYbCS ztPC!@Q59`UhBnDC8PylWoJ4Y}GeknCM_*l;Th4WzuMQO>Ql{#1hZ!)Hxke;Chj@|7 z(~m;me)B7gn5&%;V;;?p7@CR>4{=a9BQYS>azoL5t^bd-_W_KnsuKTaGShV0PWz_q z00Rs#>Y&jCh;5X#6Kc|=lK`O)TcnhIeRTE_wMbM2f-1|36T&iV?0BY5c-T^`sHw^@*IF?>l4zjNB7Wu8fzKc> z(E9=HrW}(PTy1f?F4NnjPs%-)T#f+uq8Ii9R|<;NQia%G*YAKzKga6$)8gl~zj^O0 z&XhPisseo&8YqqADyC3PA!Uh0Bc|QD!22g{*mH zs@g9;wwDn%hqGA2TqIwseNEa9EeBJ*1y9^bRiEybU#e;)1#GSDIvPgFb zrG{yc@*WouLb4++p$YFTNERt;X&<%lJS`VI{l{hQci+I=U%7163UfaKJ`Z^!zzE!e z&F*2p_$S)z_3VRM41&8{U9KgI2pV$F=Tq3*k0-YtJ4y@lTXfrFg1R*-GCuJ)B2R4& zP?$1t*c77ER;!C4jnsa*(0yZfms~uip_jO@&WAhfjD%m0V`^h%Fgb%>EEP24S*eKz zj{8QH_F=6&?*R(0JDv7v>c-3|0T%*-=Z@jCnWyCmBn%fM^em}S z$7x(dE?zW=r5*6UMP*)qjIyf;*)^S0SC*Pelk{oU(97I5S)B3CNvJL#VD|M0;fl3P z;#s+=(iPwXn>8YXs>^Q&AlsUWGrIm07;{S){q9zCOT?AJsfXUlIKDlyaU>e-G~;w7 znXL?|!Ul3Gp$7IA)X@_nT&@8@FL_#z+)7iIKw*yyrY+{RezDR%_?WR#)L_#00hY); zOCKb}$i`B<=ZIcJ1;2##xgEJ&bAwf=8L2WPO$)^1h~9l;ldMbv6?jS_3oZ9ZYd1NR zRD{Dvk_ClXbJL8=L=n7Rl*{<<`ga`sE!eB;v+v)qSrd{aFKV`Zlmj>v=)tWw#>})}* zGse~mwsdGa`wsG$kY42*zKBsmEGkYiBbFa+7*JGWQR>M=da2LOGhxlJv!wf$H=)aa zCUvdjsVSf83egk#bjfaN>WixTUb{h&k?x@2Hx_t-yCpUCjRm&rpw31Ta&2M>8R%^o9^< zIk_vbIz}M#YFQ%39}iieA)7`ZmpFMY9|u{PuYpxE0-4v(ngyh)UW#5bjk!Yp)XmQE zx2P4;UeUggHKQW4)GyXfYJjBLnZ<5(<;l!4n72bRt?Jd4M|l->io{?|LC(#~5;97h zszoVz{gdRt6)yUPOf|SRyKU?isriVx2w4Xf)>mS7+t@ASM^=VJ-j;*}we{^v+x+&s zfjq(x0gogp651A*NNiZO=WvrkSM8==R|8)tvA&uVH7a!!Y2H-I9%QK$US0N(jDBlZo!97$ z%eO0|l|z^DLUKeP|Be=BljUW3g)+R8-hW>@Bwhozr54tuJEOAJ%ZPSHe;{x66zYuH z7%G4HvY&@u24l$iV@$;K0t ze9HHp*mfny6O(+(zo&Vc0FBJEe9FJ8%)RtBy&jNWN4S28D|xQX4Z~J$UaTt1lrOi= zixUmuEPQlkz}ZU3Mv$YAvfIU<(@|27YzdK94rwN)T+#AnAjuz%@NyIZq1>&@3+XrD0SMV{lo=(I?aw@oLWnaG>A_eKjm%cQC zxf&W+sOszv3+e&kQ|dx)>bFh*)FnQypN>$A?wsijySBjUsD6hD{X3Cvw4jx!OpP4 zx_jpY*R1Dey*}#*Tj=v<@9j-S&!7Ex@ABvcHWR{`Y~~KBiTMH*()<;tB3Se6x|7)c z-+SqrGPIU2izGK(ll;hKpZmyXIqXioKtAGxHzGSJ&PzmZ zku*m=maHGv8fq=$&B_k`1wB6jtjHsxl2Q@;%`sBmT+N-FG~HS5Nq(W)%t~#Fq*u*1 zFEDO}pBBMWiL7djXO|w&Z66~RfyMN`WOPQ~^5{%3qx_+@j0YkTpLyePSE?ZA>U=#l z(VSzy9+7CDem5y+hS?vYf3}`jvT<@?^Aof74j1fnLri4Nafrzub_g*MY#bpbASqQ5 zeZOo+IYTHrt#R6O`nwOE7uL_HaoYvJXm3kwNj2pWenlMmRCp}9q|$SouB)M`Fb#h} zKjbObmT3r7UPVb?)CYl3%m3n1Wp5C<4iUL{A`(HMN(e_|ze>&E6sAjr z$a(rXjO+@1{Q-odhd;px$Y9xr<20d+a>K9%!lX2_91X0 z+u^d}0kY3Cz3=T?qKIsZNF~yyU>b)*KEbhXGt4!VK?AkJH)+3#8=&oPFo3rB?(P1D zT0~a2mH|!ZF58qp|5O{pZ8A?sjzBpPOrDno5oxtF+}!WHty-xa8MTPs(o#rR5dzX@ zE&Gy9TEkmioJXd00tlVdTn3G9C}r3%nQ(XPwe~Zc zt)Uz9cR}!@Vxpn=+WHrpt@cfHI@drz`;JHT{VSuhRI(Uz{2m6=*D_!=y8aA{^Nh$- z7NS`onE9w~m(h740l{;u#t0p07WJuX?BjWuHD}!4lRBMRI64KXRLKtpltB`Jv(EZ!QEaFv= z4P1ytsY1D$s1LG2>WSimu_3voRRkmnf(hl3dsMbg41G{$ee2((o%R_fzJo-J*wx13 zt)Zd3y98_4w0kx5My*pe20ChVeH>`6`h))Z5)?hPM0$#f)Oh;YRxXv-N~0SKer!qq zmlkslToXOV`W3GumzWZ=!Z??hE><(qCV4IyW=^oL{XTH{OH4ICbj8)o*q_#0@=eI% z@Of%b-(QPWbAjn4!Md612~j7iuFRD5(xOu53ezH;=?7$@aX!&(ed^uvE!BYM16bK? zmAwrrHhcYxe9br1< z8tWLm(HiVML$IBZ0O7n+a#zSye}I*6Lc!)s9`N5z8nb;Dn>M`NG46!OBl)R zmN7!Ye1IGlh+zoCC4voyz@&uST>2g3AqN;Q@HF4dr9Q)<-ghOD(fu2us9IG0wfIft zy+F;TjDeYM@qUmU%sc3#2BPa*XLb*YAOhZ64|-ZK9wh#%{P6xg#TT_9Y0QxF9o66hqfW zqqCoz^A+j64aH;ZUt(jQsEmJy;`n@mi}(3*o5hU{bKch#O-XqiuNyfyM^wi#jgQY}K{DgZMDrfH!K5BFUSxUA6#w^y${^{Z&6b z8auq9Q0cRM3{b0|{`AGl^jBm@5j$j8drGPPq8eH zJucZhd{hMW22y>F_{szs{W#vvY5~7aq2>GX<_PnVh_EMF$wpymk8DcNU>W~UYKVW{ zdB`wUs%eix{2OpHd|A4IGD9v`ZQZ_YPB02 zrt2mkWr+Jw?@1S~vTy0=@NxRIA`u#g_Ww#G)qak}I^VXcdf7A^jL|yR{GDu|3H2@}d*eYL>I( zm1VM1oVhkM&3-*Uip}hoD*fttVK|N56?L&UjNATK+Rd3^>yD0!Y54h$$KKfTm!W5f zWxWfirwQM(AurD^?WibqCC`@Cq%;%HH7&x`1V@(7VH8`I=%?fAmue6c3X{np>Jx|^ zPJT>7CmJ%2;ZTCQ`x)(HVDvU=^DxEDkffh$qVVV1)O759&66L*sI zv#9F`jxYBni(}8;jQRggYRd#({&SbR=I7q|v1d2GRuy~ZmZ@$MyYh5gI^~ zaQjq^rjpYqgmCoeRG90N`@kX!X^r)WdT#rb`TkQqA;PwMu7d!PMk2D@0JlS733;7Q zI^cY2jeS+JTK{7wUoV07b5xIy=NNZifXSEjzc&IC?qjpo)ND-ef%4+$Xu=-Cgd}r9 z2knq_8ll5>$RhN0i}!TTabB%@rZp2$TDXEasdme?20Wr_&(Z$^gzgFu3FW2>$w*Wf zxH)ipzxjpAqTc%G%v2?RXXx0Z@x}p{YogF9mOJCchD(Dq?R z2BTXJU+lrq9s+c`J_rWSa3wEbQk8LP`9`JB6@mO4ecI5`UaR2sLs9o|0iCA}89CFV zw_7ZLzERDgcf^%`P%p0CcaVMByoW(deMsj$;u=8aZqVE#8m}%^&Dvzz{28x!zSB=$ zMJQipy9igM*b9uE%I%RABHivc_j^49!=6laAT68RVA>wc}cO6+HZt`YLne6f} zYaX&+v>-ty)>wM0*AEqs7Gu7>sT^6bXP+Dv#7jMT5ws5oiuE$+91Ij@<8?aUctSt4 zOxJ#U#3@K=H@`)xOVoDh2~->|?0Cqw9Tx6*$Ts#hQ|;rD;Iqf=!wCEMfhCO*)(WA1 zt>75o)S*B`q-b5d+**8~6&VSK&j>N!lA^?JUhzI6CadZoCL!W})J5bOz^AV~xsB-a zWaX5h+P@0**GLAP(s&r@Y`zoBV=Y=DvaV@l^J)HAR!3BFTlBnu#1##8=^b&?*!r2 z?AffHgjdC$UjN&UA0L&nQy(;MsdJ?wjn@57Nnzg0L|ZVa$%JSNWGR~nmw5}eZRLDi z)HidpoegA#_3`bnaJA@g38Lv*UQ8-!j$74|OG>0_MdQ*nT5g?)v$ByyCosN|S?V4V zxe;_(-$;fYwG7NUf|k_l$q%b9M?0v7Hb1i5USGX|7>)vOA(o<-SDE{~v}*{@*_og) zo^-3%^E|8a((k~C-IA1>_tDri!!#*NUCagZI^%l>w0V!^>J?QR%y@TZ%5=)&LAhq< zDn^J>JVfs=SI6-OS&&)mjiI?_>^fpB__f&DItIQh8NTRY>B!-7Y7ve34D$n$f03QT zkU1A43kW6iNnWNqHp%dHBIG#1$gmA0oeIRBXn!9)mhtvF{4ab-YH}557<*#E1C*NQO;ykWv(d)~RYa-;9Dp^-@8e70$Crp6GC}!>|>sTjVlCr6b{K7$@OL9f5FH zHdt413(}qr=q08G)n_Bc#SPZ}R=t%0zq#*rUIS%lgtd+VP1lCN>3sbftV=(m1v{eQ zQ*M2P092ryJkh&X`?S%aJ_@ca;0hzq0SV9I#fx7 zI$1Z?TCRI5$#04`SQ0Jrx8pUF-}vm zBfVA&j4J6-k?cI4jF7Ib!7|@1&oT}5KA=SY(_nq-ZGhOO5y?)O6b%N|@T(X8xuw}M z_6g#OWCztNqw|MMcce_*^}kXiJFEhHu_ZfV6v;m~edSomP6^}rUx&2p03}`=`Hy{9&ZE!;te(Gl*{jtX~}t3y5H%>{#(lAk3v zb`jB~JCN?&I7Yftq@_C#Q(#`Y^WFuDbVrzmanc>pXf3bB*uz0!9YZoA-B~UhYAxLnedgszcS?C~l3TlwsC3}dh zc7h<^nzP*}<;g!Q%=g)Qv)Wp>L}2k;wig*~5e#pSi#3f{yIalukWxPuzSx-i5tQM^1Ldjl4LX~o499h)11EMAeml5m8HXDQF zHc`Ztss@dM8V2Sm!Y`0WFYsl%_L6Ue4zY$!fe)p-_7kJiBn=@~A?u&?7vJoc(%%(C z04H$^osr!p4!lWcQ@RPtky?SAI~s4kIXrZs}Js;)E1AdeDAB3M-xwPxct z(3kPm6v1vj8*kAsNQ~O#r8yg4D^F_{eJK^!xZ>!YecE1~B%jOk{drKVJPYz7Vz7a~mj{+{c7T6F^JtiCwWZsIqtA8+ z2+2Qg+U?DD%QyL#?Uv4zf3|96wp;e=@(-{?R&Vqqljxja0KvD9I;ByPzL0t=-!V!fi~-evff6$wxSDIl?P_bfp>TM5gLU7q7B@k2wble^ ztk2PIr=j>tlHMBK{O+MqqnqD@cF2}QbRV`uwj`q4BIIm-kMqi$VY{n3?&Uq*b&ye_ zGLy6VEpiFgMJ`s43Ys@@-L~gCDs)(+0!NH48S!+_Bl5Raq#8PSlE1w@NGe?H`lG!) zvO9*%_57LmN=nG~)Dt7G>7EyON%tJpe}Bi{)^v|hi?o)!WP2ok;UZPnPLin15BQtD zP3%CVdk)FpyMLzt9@c+f(0`Bech1)YenV6GwzU%1lhj|<@i*Jk#$Wy?PibiLWzxXZ zMC;{SMtzTY)7r5dGP(~Ui0ZmuNQ_U3jTd%6{(+|1N1AO2>pJ@zU(|s8&3gWX9=AVV*-?L(p>f)o{JgPyK@DeG9!xtWth+9d+2VELsta^v zT1T>Pr7m8lHTC~*b%B6;a0iLy{py1C=Sz0+<*n(3OR{lxN*Gu`8nHNGg(z_NebR8g zs_Fs+5FBJx7bF&2Z=FvC4$%9I(ckIJ;^2=s~WF6SG)rq>G=Q&}wb zNWNKZpWjs}Zy%8e{U(N1?6>8-x%rPYt9iBkm*Yh}LZBIKO-Jl&ix~4_Ut7dDy~ifD zTEqyX5L>)nN-jM@ZLKo<;)M_tXvWC!+5Dx77a?b02V2N|ZPPQJkb4LEPt@_#{l)D^i8mQ)kPOPa=_P7rS4%_CT%_({569 zPz}#Bs%Kqd2kq;iH)O6gW>|ohwK3b5- z-O!@MF(hBPqQpXZmF#5vT>N#beVEA7Ct_QV`4RNwj|@AbK0?@<_(3$x%Nlpv9=bEP zVRcr_oicQ-myw9C)-96Z zC~aZ&OQ9dAaG6FT0!DCLp_ZYZV94U>DkBRkDY)# zuKUpoBvJ?2ANQR-_ng!@IPjX$ceQ)&r`)M&W`BXXuYiJoH~aD73Fkg;KJKRSr4Rj% zB&|F80&}MW{~YiM_uNGSzqf!S=+*sB7L9ZFngQw>PNHSb%+c=3w=81<&Ln=OOYX{rhOwH>egsL#%Dn5B@eZV_NUOcfgMRIauq+t@6-IoN+`5^LTsXo zok7(t1C5cL7K%9^wWaSSbq}*)B3}NniE`eWtXG2)7BVCMa=SYD+icxL5__LNDo$v& zuGO(ZXvWGSuF|nWl12p%&DIdvvsXlz)~V`v`Vq zv$aE~>(u}PCjYPpqhoK?vGUE1ZPBqibgX={V;Ab!4jn7s?AUT*&Ha^#0GufLmbYf> z0u8=agG-DJK8e_@CchFEY|x%>8N$g7;b+Sw&gbZZICS4p1_2Qq`4l&fHP67byU<>$ zK5k7vTMs_@%t+`}+CH6QtxZ=&S2>y(OlLNMcTzBL6SI|3sY8DALjH^34>^8|X6Hx$ zEcKpWr2Algi4e!^{L+~^vP@2Mvh&OBP{n!NBF)aPl&rGz!_v^f`4PD_=$l<9O8dUq z2UUN+HF>uEC+&@<=hrANwC=`9c;cI1GkfpV1F4DG`88)ewQQmUMo`|dR}`_0&K9Z9 zhM8gFGl!$}S11X_Vt#Hzw9$I-1_pXV{+e-P*1lkD-AQy4p|Q(`)kCDYKa}l}9ONH$ zEJ>^>X|%q!&gOmmRK7&^D(iv3t6+mwU9Wo=s-WXPMZ6Kv8&qRDqtWvM5pp2eqZwUJ zBzulY42O%VQi%G>TzgarAqeK$Bf0jl!v_TrL6^YoRA+i*K0@F`y)gouY{NvgDZJC~ z2|z?qyvOV-A4??@sh=I`&|tFZ_-jGx3Ou?MZm2=1-m%H;ZI7XYKf%~li5)-R6m&T` zhd?>M(lh40V9LSRmEP3!riNzg(Q5it_%EkcYuLbgVQ&vfYafeawV9PRJ~>@m&V~7r z#k95pJ+RSGrHTh*@z9oYC%8KF3f!8mjjMQQOt8+}g2^nud6lm+t%q^;>kZZeSJL-1 zPng5klNEYY|4XLtJ4bbp=y#0j14NR(hLN>5O`^O-gtt-Mr%~ml)P&4}!W9E>HFIu` zY*+)T%a({+IvfY4!k*XW6sE3F3%zro);CXtWlI+ff1HNSfu>`sH69@R!D4P^#{c#LC-iz} zR0u!k;&(>H?VGT(vPPqDC^(cnhowT|<)mUZ5m=ge^R@pND&iGQDX<|l%4O^l`VK3h zISkEPfN17^Fwp2a0fM2X!$n2mD_{iHYGy%5D1mi4AcT`ZQU`=c64;~z4o~rl4#=u9 z`*pb|6QW`;5TAAfD2);0GIE^joToCg#_|`cQ#0zGLE$ut64qs($TJ$3A{UE{HHZAc zcQP88iU(n%YOD{%WiEPQB!E&3oxa zH9t6PWc90TR`+PZgDLwZcD&VVU+?$mvB%48wz_U@GIf2gc@G~M=CZziQDx~hzb@JI z(^=+GLloG`>H7NI4+T+jKNLo^VKI)nCytDp$H1GoYcn`0dUUGOW6Eb8>?~Im`9~p!-Jj#y6+l)}o$1)MBmG1gy-p!5FpmT-DuWH9b? z5B*yDFBxs)9+UNzFBv76Ygv>{D zZ@Ac2J)&FWvMmc`I&})$8vEfg2w1IDm#(xgP<~l|eor}(7BnIfwoM1-lS$EkPcpf5 zV2i|G*GiIXJ*wAYU;S3<;@(JIuxAyGxUULJ54w|6P^Xwl-Or-6ymAg(&q=197Bc)w z&j@vc77r$+t-|Yb1|WJW#_sD1IAd+M^;Zgk&kMpL?^#pbq;w(HUB)DNZ_%j;EQ&H4 ze4oUiP}fVh{Ifm>M`}*2d||@@M*1|L=Do{w(u5gOAy)Q~URcVIc1G)oU|6AC z@`*F{TQ%uQPvrVUXH+Piji9yObh9sgl|SjvZA4dZ;s%X*RJlBDN>B1ukv3&JFxIY( zO`*%jZUwU%95~d{1YG`+xO7-<%-J(k&q}7G%2FGtpe)wVjmv^ln5UEYhS(;opjy*?L}^n8DIen3V?8-rt3 z$tmybBNck!sE}@29j-`**NqHwR&i+PW$)Eha`1dvSs6t-0y!VsZ+~+(to7% zFSM__erUa<@A!w)Pm&BQ&YCmc?FC~j+=ga{V zH-50X!TRl71|B@k+=4|+3^8Hw?s9*+#&{+6m-YX}2cc&HZ2$%Sc$t_5Ud^;y*CdK- zXpz-NTl8EIo4(7O$S0p1no{F(jqJwWeqTfIPSp6L_QZe@JHyU{+ydk?Q|A*LKtj9D zn?bnQ+_WgSQz(k{pwt!uLrY?V>abD!Yi-fduYQsdmHxNXPha~MR$RDUo~gK<1TJ;Z z^VS|$hs%Y9MV1DU2QQPley>p)kiV#59$P*-f0s%dDWr|LA);Qt`l6n{bT(VA8JYQV zOJON_d{*bNd;ni!vcYb{f?6&2wwcY66d{h$`FpC+(Ab<=vs5kcnm@@+c@q{Rkg3qB zi<-@Qx_uJag;mfPK1Zd{K3t&LKULFxvba!ue;iVS&;C^of>5r^C9l)#k)!(<3l=65 zn*(I6e#xzX%@(x|;OeBGS|iHZgrBV&C#eNKRkP>ha2dHH6bmSCxANbG{#y!%776U= z6?^aEjOwBDgnIjt@dEEH9G)OgeG(3a(Yj>1#xF}tgxZGW+I|RhJ?slRBVxfZR%?9$>t=E^Q^ zwtjZ0Uir8noAqPhPe|+^NGr~`#NkO`B2xbXhH9PefgZ#QZ>qgtN zR`vp5q`u0sxvBXvSW6+KMRRNh#E9EZrfM!3*5jQkd(di|ctflD*GZynNretX2qc1vkYY6Ss#7CH3$m zod>5KvOq=6L5SA<6$^lfNV^0%EgLz(%nEHDqSQ*VafE*mydXb^g}8T--BV+Rj9j>H zi>P5w1lVV!9x+a(|5AEJ%oOqa+>H9ll3 zp|6Z#B?gR6%3HQW+9dyQRFFEF`=JCIte>s4E2o9n@-^F)=dZx6rcBBw!`!+f_i^+| z99UQ>at8Ui82<-pKqj?3w*gsJ4*5oZS>e46z8|ngX?(q^$3&x&K|tYVjQHquLMZFnrU+P z6~;MP76+7(;y=Y@*(r7M5%clfue1tVgz)-xM=}-;;_1QjI=Q{Y!J8EQ7oMs%iqZae zj9lc=Jn$h0_@Dsy2d^mQSd@{_hYp^Kq%HKP-%0qRsLtzn%=}ZiBqd=~OrS^AG zFY+#tL|%7hom)0SOPz8PJQJ!%B&@kIU!(QGYjpbtYc9^Y-m8%zCw)MQ={ZIT@2I!= zm_)#@{Q2@7rXC=Zjt?f3}wEH{u6NN&u{5u0c!e=qEt^< zTDKNk=6jQ8%6_pyFCsF6pO<7sSl0cXBsI*H622|Sy9~V+cj}9kOyY?0-Y5N&Gdjzi zLPf%s$d!Gk+46td>6v+_?-@3uI>%E8>ZH1_^K4Z;A`KJA4X43@e2OQX6#MNI_VMs( zQ&4GL#=kl#{+VZAZOJ=O8>3cYEha3N(cIq(-s zMm@5gpT0SH__uh`_|H@I-0?TzpK{<2Xn3K>r_Vp%_^&zexAW|)z36m}zbN1M8zfIb zrhMa9JBgR_l*ZS;OXKr}l{)Z6Jo{=dK3!oK=L_=!Gp?}Lkm*WK4D*!2R{xE{1|0Z@ zMHXCp$>|EaBwyH9ff-j=x084aPbqBk-zcoffnUh8ujd}R{WRt2_Jp)Af!tU^X%*S`n!}W@%d7}3*@+le$C0^cAiq|qkp^9HBJ&Su-Mo0 z&C`{ti^z}qTnB!ZhX2NC;i0uSAT-Qrz>KTkTjZkgpC|RJ{oT9Q4}{V4`3WbV%!%rXSynoA6z<s#INtosi^*#>M|a;$al*b&7i(v0tyBpsot0 zeQ%@nl>M9M3IfJY3j%lWd*9Cr0*mWqg22D=dx~F< zU&$|k=Xa9dhYuG7uH*L=e$Vss{IVdhmiQ<6RrB7??;(Ce{8s&{AaDu4+xR`h?xX6QAa{huf69?4Zp4Y4)A+{-)sCPQ|~d`&nFS% zde?2992lyG{pSOH!+A7w~ZLGnOY_|WnSKqDXGY-iE{r?@9lE7(m^4v__D@OIJIPZ-8)Tqv?LndD-A?KV+u=k`UDwYh{C z*3OmX#NqH(chuPvSK5m~aD-KI->qHUj z;j1)HL+yfzOs(5CQ8Y-T?O(B&y2`!P4>#vN-e|4ljDd=lP=l&L?d7+=n zYk|%GEWmsZty;D+UFFZW>62A z|G68df?WaW{h^1*ph>nl-{!^qYrweeE?(3`l*F%+Q@s+JDTfnbV780?ecql%#=9YN ztG0TX@o(i|Vj@zeG#8>7VSCIs>l(=6Z~(!6SCeG^K5+33*Cx;#*|PCEAXqWA8=P+**bRCd-4Wx~e!B)Ts6c?S4yc4Y*d) zW2Ft&pHMKOC?=K_3M+z9ggR;>n{z~-pt>Z;a zOMpZeb@$Pqyp>x!i}Hi451!5!pvRoK9A++ujO}mHz6`x+W|zxEV?Mi?$)FfE9%RO@ z5$e*WYdEHM#`a&3&O9D8ZWBW=<|jDGJz(b)5H(7K&S1|+>9F)fbH7NHbp^gAAiVRP zF4Z2!8muV-l{b|DSn3Oa2WKDYtv!ilpG!ILTFsfE(3b_?I#IcfN4Z^~42V_Q`!6Wi z6TnB)=P=9RC!$&$oNj&!YzZS-20z=e(2>Sv`eU!UAS)ZZM}q%_7yYqLC@a&kTqIcuCNa*Lum~nBf*G# zP7+}O0I_zD2sJSPMqhzHbY+-%9@sKJ!!ekamnshWvOlOr@#sK-!ShKrL zvfyO_&aVQSpCNCtfD|SfrP+fpbOEDd_cM{;v;3F9-ZQyTW4bB5RgO^+bjf$Kw}pXn zYq8h(^9)(6qk0&iAtjg!_OL>hWgZr(*qTDy)UJ8F(709BKdFU!6<1pYZ~R)$NVCLk zJtayT$Pf-(J8B4rgnO4p#39j0&R8N zA!xQXeMf4+DP2mA6{yIHY{xpvVFbmzQg9$sYv=^i+Lr4CweONZSTQHT44q(l+ghFA z%y&s3)zt|`sHt6dwK6a$>R?nk6^1KeosKXDwteSxA;F*oF}i6}n}a`+ApIc30}s7d zi8Cnt3We>7%X06XQ)rmyQJ%CAeSE-Kgyu69e}vK-k)^qvokV8!C#uDn!9Dhu^31{( zP&(To-{qgGDj{v5Rtywjy&MJx(_52#X2OP@=~~c`j<2?!lsxL?%q^7ODy0I8ILYYR zPVa*G;c>+FuCdTkTpoHg(2&{8=Uc?HR!G4rz)=Vrs57hLvtGi3Th3=i#&25D8lSfG z-2h-UwU7OJ^NV~bp--?;4fi3d+4=N~U}Ef-hWUF+V^7f$Yf*0+U0kh}SFhQ2K=5k06>9&hmIWHrgvFkkF^ zqf>hlr90HTOl?7|zy11-Ph64`yP?8Zm)yLXJZqcM^PG;8^~x}xAWyr9y}St`6#qs; ze+W}}iRMha1>L|(7C|A3apst9^;yL?Ar&0-dW0D)S-^Od4BI+dDRD3(!z8FXW`MSR zS|pgVF6p^RdtB*x_8AghCy7VB<#eB9W`P|peJ_`(e3R&vpEeV!m(Oo>4bA%xluZru zMw1^sw^jx+kCspisVRggKy3@@?pWN{KC7dAS?VHt1e}KO$tRyCb(Aw?_feq{YQ_8y z4KR-zrNI_iIIMB+JwTyEtft|SZ*egSn4Xxm<#O{;;r(6860p=bGj){ox**M?BD%)w7JUWnZRTWk#P68S z;7`)>X_^iJhbKN7XPA!=yT;Sj0nJ-vy&r8$O;wGqdj(n}q(iSD-xgVyHL2bXX-rj_ zS}4X_N^{SuX(YlGsQIrXGIqHg3T`T$hvuyoM$~bzR{GnQsdLMUgmAg{Iv|RF8GF;n ztm3WGlNG#77aCpVI_bF9UZ|rqj!~Z1Zb177sC=ic{I%cAF9}Az;&#_y=GX4pyo`wu!|jJ!E3PE-EXv^+Y8DcUTfT zgQHz=(eG_923YGFR9%3!qUmDiRD8VIGl0P*;ny28-xU;u#0gcD1$&7#EZK>Pmi^J; zv!#?sMw>YpGYxe)saa}Tj_K-*-L@L0SAN(hlL6Nn1qW<5(4m1nvQ({D#T=3QsG$LU z`zrO@730xZ0e!BmJQ0IlhkKiNE=tNTpFE2vt>gDZWk$AgO*V2-3 z=7vJ)hbC5yQ8d;Z|M`-g6wX|N6Xwiu1kLq#tz#`YsN>|;xW>yZySITHVbRB6*6f$C z^R8xtOHw^?G5ljbwC>2nsb>3nSuBzj6;qSt6_b-?6_b*s75-!id{R-xC78}HN=7O^ zoD5e~BtsSRlEI2)$w0-5q`%^(q_5)Uq_^V2RB2yfMN8_;jxFwMQ_+qs1+A&`**eZ9%aih0evWK#mdnd%K zn{SdOpTX!ZrEKP1AR*kbn3XEA7DE!Xt~lVje$%CX47Q$k;Hxw5u(Bwb7r)Ykr9j3C zwP87M%RDH!EJRx-StYnzW?e5?O5x1CuoRLp1&Ft@cXr1&Ah-*_oVVf4wkI%vBxi{? z^PScDESED|{zEX@=oBssvv;agJ*|7}?^IAUIzJ`^zBa@SY%@Y0O_>J;r}Y+y;iUe$ z6J)Ja=25=blNImmjl&4e^D&(=nCWEGJtC8Ku}C0Dtxr%iiC#one)-LYjk z;}uX_>KNp((Rn=$ZMI$uNop@qk!*aaWT^M|^plKJP$CjygM|g!I_rGqWqmXPzhLaP z#KcDGV|&~k(C3(yoV=&NeoLJziMc{~I6MN*%2Fd{(gW%MC5e}^BBHu#sDfI!^v8C} z1E~*Yyk|Ewr{hblk_$+SO0~}c?ffjFf;?L(>y%f9NpRchms*Vh?fN5irV2%P92Hw? zQR@>Z`cZG_31-KaNWnj`K?3Q8ONAawZU0JJ?X6G|!&%pgz#|A*jW1!{4S3>98-RKK zEW0Rwz5yorxK}PEi$Fe~?~lzVxhLQILx*)+>(!Qo=R|s18oTb#w9oIDb8YH^Ox2`V zwmsBwBWu!(jvEU$rTiT?dag|scHHQ_1_{8}El3JJYJ}a2J+uDNhoH8Cb=sIS9DKaq z6HjQdj4*1l!5>!hieGMAGZ}kAEa^7RN7#6t*|=sZ{z`P5+^vgj^v-&GxZnYI?9KM? z^i5=;4Y0uaQJ(g);Cd@2r-HS}2mbf%B{tQo7mHu^d_K{!WrZs#SHz1FnFY=X!2U}| zx}N)ZO}g_JGL*w-48~WwiO7n{7xv4xmD^0MC;j=Qu>r#rzR%cYWU3A!cvug6bvFW> z_5MuNVXb4iK=89L$tYNsn^){DcNwv zmkhch^0(4$KML%JC!!WEQSqf%VqNIf0?Hx=Z*)BK6oL{0+JJ75N(r$*zzid0uRAD* z6s?)oc1&a>=`D3mUyk&wp4Hj-66t5Gnk`5E5nt)D=HT<#+%MY&gn!8oR$xw6PBPa_ zZab-kEobZR`iKa}=uq@t`3lKMpg<}!lZ5gi)vjj{f1*s02dC$!k^QmBCJ=&O$+H(V zTQlF5_~UAoci1QV|6qK%+q@;{N?opMeV&Oz2kO%+6NB*;ZtJ}9sgj@K!1Fx8x71m= z4fT!IWgi30plVdhX|~V`F{;Y>K%+HJK0_j8ppZS*Q|WyTRHiT}Eg5NI>N}LDz~_aD zRh}o(P2TjG2r4BbF^`W0hu3Wm-0QeYIz4!2)u`yzG-sI$LhXm!{ z2uM&2?i8Avu%}E0zt=8iMl+aU?hz!@-=28eH^bb7brcdk@U{<8JYmRzPx4%I?^1Nr zlas5=y?$*s7--XmHuZssD|s1eYzzeme;L!E_-u+C_L*mO@XfBDj)19#W~L7sHaopzu@ z2c)yI_L-z~0+0RCsQK3ji?G1(jKYL5;4URE>b-*w`7^kdJARu!dNax z40*To>6V4+dr~8`#MKkrV*2}Za2@`h0;i|Zkg@e;4+KezQxO_-Q>|(Y%BMT`xGW2|4U9kkO$iq z@NH_wR+D$cy`52^15Uh*+eo}cz=@YJ7>TbNg_jaW;-%6Kyr7#M-^6`h=~e4X#VkKR zi1zZ{WSz-%L^N#t}cg55eb5fp`j1ULQ7x>Q&G;bQhxb_ANE7M zH*+hiCOSn}H8~hCP@aT8Y_{gnA~Cha(RwP%G2__#??HY4-9PqrrP$nJ*%+&T&3$!b zAfxAloYTqp*YOZO{0C7nC@zGV$mRBHNUh{bC3HkUO<6;XfVqc<%q*3_c3cP5Vv=y< zu?&9;==K745CEl~6tM23WVC$~f4PD-3%R~*p@TVYCE4N^S+pAjo;*6X#9hf^jG(Le zzTBlvLp!9&rltP%HMJPK;@60q z&O@H(GuwKAk&id(k5_CkcFj+26)7@6&Z5G?k*JKJ9OEyB(F`^vp8};P-scVSnM#~3j zBvLdzvekN{ovkjC4DEfUe}JdS)HQfPl$py~i)YvM)0I0` zkP4XnUVJ?e(f+b|>SS_OpL=crZck3VmHZH<=jP6Lr_M1?ol2h5S5+`~enD!gc?t(| zeN~>h^F2x1jY6~aj4s2A8P%1mC`)jbe()+E_&udg-$NPEW_w~oq0l7Pz`5h@n+Rh2 zrOtlU+hlIzKxtpX}siTmm0h zL}Tm?UU=3Ky;6leLn69CngE6~z0gNZ8|mwP*;>CuL9i}m-Nmws`ERf#9rLbDwPfOj zu>;8k?aTV&6aJ5K^3a+IZM|#*o2+l7^%fTt?wq9yx<(3`oG)n7|GA(^Z98;9b4Ck# zoVnI9FP^$76Q8CFTHhC+`hP6wk~LG??$iYx>UCO_I#>0yfZX@Fu}pWcAgu%D#Hm9c zr~JNYBYF?*7?z7P!@>sbQ@vZ{c;rH09&`^)k*c0pY;=j>Q4fH92F^J`jiD`!h_92M zQHszX{Ih6(fvWTjnA8j6*>$%hS{n@yiEeeriHo?`D~Ms33nje8y?N*w*xim3oLf{7 zBj*-;lye7)h)X+*(wB~DX-vKt>e*uP1sBQ8&xuBuUM6Bs8K#e~Ki-LItv2bWR(NCk zQp;&;L_M!wGcE6We6Cfx)a2MSh!>P=&`Tu5>-foJUEgH5zz>XKvhsOL*1_=68f8#XL~N7XC}Rk(!ykO@>kRn@8Q1T??W{ z=UZ?H;;!mrdtT_mR~Y)$Q$`E{T`r(kslMU^nL1#Sw|R687yaNZoBp*EGg=P$Plg`z`H4S2K1JV2rU-2oi9Rv z(H(@AqLC91t1ZHf=tJ;qdwc{L+GEb4FRaPo{IM-mBUG7oa}oHw;^VR3+Q?GG@<9*Gt`tP*qWZ0_OOBlg*^^h5ntZ@ z3BxLiVr37xJ4ERFYI5>Jw&?cN)On-uM+NdSctLtfYx+_Y?8X!+<@p+$^6Zd$ zP(%pm&cT3JkW(Phb}u8^Xnpzp}085oAo;RyMW8{j|QgitDMg&O-C}az#pn zz+&mv=sGGBQyRmH3m=2Cr(2@vB5EtE=6=yyq>@J0Z^wbP?I+l1HEPJiypMt0Jq}VB zql-0IgsP1J6An9L3O8oECb0SDbobA6{2|>A*~po>g7vY?_B$lHIhXhUS#>gVxfko- z>8g{es$zmvCtX#kwn}~|mZ!H0-kUFqJNJ3R-dGm9vB7M}h3oZZrfEtiAiSkQ~|u7W$+jbGANFn56~RiyUW zdIF&xeZER;Xq+g9eTogFjE2U=){Uk^R+9m&RZB*jAEvz1-+-01TMn}y(&PRM%D~>> zoC2ff5M_tVoBdN#XD}nsKnh^0;t3{SSpl@jeV^!#k~NxykwQZi(on4Fx+!5~|k%0}(JJh)7nU`N%A zjiQs}OY4q%rg{P${O;p-ke|ix6u(#aIjpCC;JZ`CbJlZ>y|O`cZq#Es8N+%eE++*U z8iW`R7_|eMACFK;-<(gnjP5LLZEF6J2r1~SC3F@m)K(&6udMey`&Wq>mIMD1^|Y$k zsad(79+j*4UChDM)IE~0m|G1xDz~L(D;VT<-F&fBNEp`lwB{5BA}mD!T|@=ruddwnT$Y;Mr^x`B~0j8=X1+AT(5hZJ5J5d zUPi54?URh%-UX{~pB&&u`6vN0j}>Wgdf9B7+p1Ix8MQD(PDUV87oi1#_G zl18UVPIFdmvh~y2))B%0d+6c`vZyDZPTB5*B+ydb?k9Nz0L!ZNJg6pCMwjrWrMlfR zkwvPTesnEy>7F{Fdo|IzwD#1{*BHSD^CZkruyLpwp778=0d4H=k*h|X&ta3dXD4sC zI!mEVnh;mS5xy_zZ;}lMcKmLy6A}a&aCCvW4pEzAMpd$%`WFwR6a^XKAG+jDQf}j> zM(efXFxYl%YEv#HTC_+IA_?nPWYwq+Ti-zL3`Su%;OdSKo>JXQskVr~Fc_-ehyA#( z&~Fd4{d%s_9WhoMHqtXn_sqCY`L0qu3A#ZR-E_|qyF-H69uXqQzg(%c;yk@8%KL>V z8qofr{jCVlS^hzpudD=P`DzC;p0D|L=WMUXA^6{S0*~22QX4bsvhP zE4c@7^+53(>6-%S_8_6&>JSlq{gOSCV_BcKz&4r+mV28z=DL!fL*9Z*HGirFau%4g z-k(~A>4^rgJ*XB3`hQ;_d%GFv2?etpdT$XGAdnxdf1g-N-txzEs+kDNu;Xe04Ll`WiCK^Gz|-X#_p}9>@8xi zBm;WYfFhxz6dvFc%_)n0v52qjzf)UFc&ds+8Sf#oh}MEKrO<*f=IKMtn5bVPmKVyb zvpN37y@tIamcj>oFMU%GE855o<^XMUi*0zU&KNk6%z8Cd8G3=*(UIJ_LjPyaNnV4h zqnzS0!CnbKIErGuWkeX}Qf3xO;TU}BvOPmzCn?^G?Tom_Qf_n$l4G8cHEM^Ntd_XF zo`b69hdAd>eiDSaTzwcz*{jrzzF79=CF;shY~RfW>tLYx=ZlLEaIN~G;Th_g;wOra zQ_3RESmes~SpWTVCJe6G6lPp$oImZ~L(MStv{%lNLP#{qvC>aHhm~ZOZyfF73kfS~ zr3b_Zg|Y1vJSB-s!G^N*l^FU@)<|d4k%6XMyWi=^L+9B1l&~tL=_@rGw3?K8$A|QG z|@B=EkiCo};T)(sI`06JVZLW6D5!L+R> zSUX(pmjL1eB;&1f_#b0;q99XQP=$RczYVnhnA*2;fFn}=j@tRiS3vSZ#Z!GzDro-b zUN70EChqwr4_s$&^9#mSBDyC|sPxJKPJY^UF82g->w`^rJdo{9C~rK3Ozr#%a~n{8 zX|aB-l_W-uLF;yofkqxNrhin26vrgff5K;4h@N)8Pn zAUx5lTj0`Wru8|B9t>1gcKY~e{p+Jbr$q{-?+eMzhRc~?;$Fh&`~+{fn81vjx!=ni z1X0xkS`2!1i|lJ9)h-GE`(VB0s(6ESHp&hllOydjx}0l0(L`puh^!Y`MHoP9*7(Zs zAq&<*XR+@EhNeENc3Jc^D7}cU!A!|+Jd93|C;-AcGKdKmLD+wX`LV`#%i{y244W^> zhEWoUA)YKVNOpkf^6Y{VSz8%*aSRo3C9AkUGkc^|l&N+%SQqLx__AK%*|jAfD|cyw zHO+|@R6sS z>S)s@wNX+9C)$K0Lqr~dkVK0Dy_cJ&l-nZA1gty~C$GtIsJ*p5{%x&oz5Ux>d$qL! zzJL(OfR8KcZKc=SR(tz6>G(j~^6Wwbot>!V?z& zTokk)5Zp3$9`oF%#uxqG0=sd!eXjv*O(~02kv*MO{ZotmkjBWh5FYn9uRWFWxT->AqVkh=tw=kT&)V|8k_d|l1!tfMAkI?RP59Wa4;9|q>cWT_mvl|_sj>tRU zCJBk*I-?z6PdQZMFN}rlt`ZuLQN-ZFR?JqfQeozF`+K^Wjv9z^L(|zXlA{Vl?}}b{ z%b=3!fSpwTvKQG88@xL=-xsU<=OohE>uDu6SD%MmyrTm`IbqpPOhL@WrY8G`22k@# zHOo2z_EbA{H;4t;bWO4{dogtX<8J?hDz<~HsU8KSeA|R(D3N|CU|(IwfQ2D+yU!s( z6O_(pU>q|b6}Ho~fU=!W@y+xe@u_Z*u`zo|GFt8&d6i`2-9F{#(l*nld5^j@5A7WS zFsl4fA%^MGPk3Xf+&+oa>i&-6rqCzpW7v1Tw^w$qSEZx9dUUi`v9?s=Z}td>uJq>m zXHM+R=lG^K882#gs!)=ca5GyI&k7m=)CfrI4!YAOAQMvmm%ZGuvN;(X&sCbsRsR0D zte$Ube*y!@ZG3JW_jpeget6)*us~}Lp7*};x8Ql~;Zb=0A_q@hD0JZ|ig*;B1{p=| z8hAF10VmR$j-WkNh>{0rN%mqusv9U{0Q%*z04+us-AQR^8;_z&C^F;%w)j5`V9WDp z;^+IlfGx>^2$%GC=PA9opM8rQK z{dA}CFf}34lNulPxvZWNazTWk$0W*ck^VOsR;6LAyaf2Wj2`*?MT_RgtffmHrc^Fo z4nm$(NCSQj5_oYU?SzjQs%c;TxqoUmCuVIWQUPAnPjB5i{A0?`OhP-Z)ui;>(qT94 zx!FIqtc#=3S}6z9VvMFLMf_C27AhD{yhL>cX{OET0V}2CHWx(Eux`BvVyl?Q*uf;DYvQ_JKxXN}Y!-z>2Dw_Sl2U z^K(`<`W8w)Xck!HK}}M#zP7d5`Bj)A=zt6fnlAp3v=EtdxP6XBU?AzuPjEDBb#j-) zy;p0Q)`DbjfVbpkktNpFU3hk55y0(Y*Y=lKZ^ZzLtI^%_DfDoyUsM|oukff7KmxPy zPRM_%mL{gDS}xAs2&OIvU=O${)y}T!TO~?=-iQUtay$Zu!(GNzW`1q0e zP>kKHRaxVt1zxw!QvKQkQ$?Focd1)Iquid+xvAO{`)m#xu{pT^AqtsPhh=}cF7a+b z#{^jGGo8#hT_r%RzoHq4zLb79+nk!!(A4Oh!s)x&?Q?c*ozuHdjSHt*D>4`8PuL20 zd0JBo@nEG^Z8klb)sUQ@t1CIH4$Hp=#?Iki3C0dEUg7U~6&U|&n}M({F^0R|6;~p5 zU9;-he!nEEb-Y(NKQ-?af^9Rf{XU;y59TG-Rs!2w`Q)_ouw&<;Cy4|~t7vuB7+WIF6{cEf2&5se*HE8@!9StO} zs+KDwf^?bJ+IqAtd80f?wI#pUfCDMxNb3E(NbQjqsisjcQty&&HU({T3zB=Jo7~rh z`0(P5F*pzR$hGC7*R-ym!h|n3W-`OhkEa+~I$0Y`+!#c7^lxATaG4_qt1ZrskMjj3 z=1(@kxU{PjYdWWYcGKJe-_)v__0gKD&u*%5-!Ieqr``7p z_5N}9{an4D<-VV)_o;3nWpRIJ)zljM=!PG$A$`>Qmi}fP=8qsWh z^c2I*RdZt-vs>EfVT;pNMnju|rhiuV%`{WZ?dCb)M^AX;z$Y$yIzD;kKtqAJ!*68% zx$|f!_68!T*ejjy%Kh29#{Jp|~RKJk8_T}Vc<0a}g`<&Ev~o5rdcc4oK{_7MPGk@{k>91m<@<&xHn$EqW6Vl7q_ zXY{TkAiG6=H{c|;fTiWm2C5PwyUSjQ{jOGluaYn4VeJDlX3R`5=U@AaVQf0C!(89SkJ(q1+EcBqU-2ih-uMI*Jth@oylo8Rh1IAl zME0zI+4!k5dqwR0F$JDZ3xf8b%V=Wf;>)DWAgEz9r*rz44%yLO(Kji;PC6&&XRJYf z#+=iCr{kXu z7l7g`bCEh}gQvJ-XNMv`axDrafL^(5tEP($nJju_R^;6^r%-rC$3Qb8bi)jw(9|%j4L;hp z3CTLYQd}6Xx1;VUL%ugZbKkpJF#MiMtuCt#214264@n3rLqntg4gN8_+l2N@h7ym6 zzH$bvPzB-33Vofc=3Z7_8LTJ?nU3FXFQ15y0!gS@raTZ0S%Gqgus3g!ZatwJz7olp1x!9hTvQ2|~(UlY8xinZ73Y+%|Z$7i=L zGhbiU7iYVzq5@i-W#-eL-72!D)mdOZi?Um_gSI*|&1WF78@+DrtTy02`tIE1kw64ZD*6|uVJugzDsC}v7IV) z5GO@QG;Cg;v`^C%wT@x&Dd4VkKe(HJTQejL{$^lhODg<+9G?_T$n2A^zLg*T5Z<$ z@ogyZw0Ut>Iw50;2Ab4~EO=b!(Uam6qLDY_Lz!{Yb`p8rlB8+9TBwe<*{8K7r!GZA z@A3~0Mg4wv2E?io+qI&3U~!I_ng4pPnFbG-nR$Q_WkI9)mYJCo-Q9qTfo#PS?Y=s? z&4;l8?audT(dF8MzAa6|0cf#?aA!QQpv5UX#|%r-grO{jpq(`5 zuur;aPRVZh9c8sRzYOIPDuRSa>2OBDAQjo09a1DGjS&<8VUat2mmM=)pq0z&+NM^i zO)>9q0nX8n&oGm|UlWTp_fuUD=M%=qn+c{vwm(u6T=NFi;w70nlUg~ftwlA-NfhMf zKQ3?a|4n%dD2=QoF9*nTeBPTs{2}>E-zVObY-BplPN?-M^3K2;wQU;RGuc7G}OVM-}@PqbOT-SU;ju6b|&nLYmYb^VZx zKb@>u%c2w48JwLfc7fTzVrQGV*ys%2Gs;(jlOi)6$d!QCSagNo-B zgBHyCH&QikQ*+q%^(d6rVte?`!|;wSH`z|lR;G3mkr;fZB{|tS`#Ykd{r163NErGrMN$}W4s-jz8+^lxY8BijVRvUFru%6HnPapvpJ!*sr~T$+!^ir4=Lva#f0 zfq{ONOG49>^zvGntd+vtbaCh8=8FsC(npCl@TlV|WXdPya!=V_P#{|8l>JmN@}cr@ z*5akm5liUX93)nyulX3F#v#?B!UZYxd~i!BUXUkU%POS@Yi5CGF=j^^%(r_B_quen z4${YyFYLuvbA{pMZQFMhK@G#X!2D8Wo;m$Rdt<;}5=zYqfMBZ^wzfDw3&HMmjy+Ff z)4pWwB7(kaf-?D_s|ng{f({VG87(!-2T$Zi6SPOEc2^{8ml;1pXylt_ES6Uq_8*Q- zZhd~$S4m0T?(Ttt%0$u%OBN3$YuCADem)<$?thjhYhwUy@sKI+MBPMn$lZULJNCv< zswSx7=dwAS@0K8QeV3qTzWyR>D_o+lK0rONRLi1)!6Su;UD}dHW2Y@SFN~3Oi8CO1 zE>IVSmYPQCY2caPao*FPB2{=v4t|21(Ie#h9>C)If^)lcE8oa0T&HmFfzj9j0*N^P ztqL(YD(uZtJz`(Gpz~pAIEiY!o5zx&>?)|Bnow?EZ6}pz@m!0?7WY(>Ht!;PX-IUK z(Y5@hDU`35D5~?(ausZUUFuEEsejW~OY8>SXsGu`x>R!fi!+*w;%#Ce-KeDY9MYsJ zzrnl5ZVvqID-VswuRPR`z49=9?3IVI+?9v(+$LlnROx8zF3dil%A1`R|66xgC0;lK z0~CxIw>4&+ZF(M=RopSj?eulfVvPuhucJ{=lEd`{1xpm>j^Y@F*5mMnyb;>vfcck? z=76c?;qn3+v9@px`cnGTm*6YF%08BE&OGNHd`bo03cFYG7kg>2Y-zx5_b1@k^i~sM z-9I?^b|DLzSxF;99Vh8r_g#uaqEbAR@+Ixf*OHEPwj6~m-n_hFoTgVaJ~oe3>TOcF zB8Avy9Q$F1Erb`p2!_jo6$Q=CVmQ+}K2jhyvi@C(8LFNvz{?f6C+QYM(FMJ#PGzut zRbULF9Glc-PGo*?&AE6=I=kA#sdd-tNhm@E*Z919FbNJ{Xnt_DLltHnEHKS1L#vZg zDpN&XR`M|a%XO0LqS93Pw`sd>Lf{UD@^E;0R~?ml_cXR*KG?ac!~hyXeY-$ZKu;>H zUM=d6liQ?6u53@HOk9KAGEi9c(fG*{pJvzk7dk&aOSuD?#;R=m9Mrzp_m8~jDf<8}xc)#tORTLg z8mxr7hDs|2@EE8lY|!f7L4y*GuB12&!H;Ny@w^lHb%*Zj2Uw@Rdcdu0t9ud8>UoAl zi4C4Y6Azq9d&-k4XZL_xQ2Lj+!d9K!Pkp-lsh0m1jdPFZ}&vL0YN(vft zOXP{Q7co{fZON)t(OKx|zQ%qVgo9h*!95FkTQI8t6NRow?JY3UKp1OQc;squ6|TyE zrhL~Cou#?A7`eLC4Gq*}iV;61^yidT=brs6Gjsh=GHprU^->1Tv^t-9M*Z_;Zcfhi zB}S<5PJv{kAlAsAoZ&;@ns~d_>XVM2>Gp!A1p@E)|7^gE#L|qzT))*Lg^iT&%*OTy zZk0j3m){XlQ#A4^O)84%diw_?SS!st-F3_j)8hA*6aQyZ#!IQx=IZq~Z^GW4obUAqX6ykmwZbi}i4A^0`j0e|sa=(LtHA30sf($l z?H*p3bhSl|&SeGTJmx!PB{xMKo>>K22+VPR$E62m5 zJ7a2f0qBGgBkiMRKVZQ!g*H1EjV*L1$%<9zx_qt8PT<4@EV)Y1N`mT0t-r%d9jWq) z$Y0l7$r7QJyF4*CK2>xT16^G9YgZl@IlSh~ly91=Vm`Gk`4d47Ro^z-w+cTHQA9tu z`}`%DLu4xjY9;nxtJP-hf!0lPK)$XUji?<+R(7lvea^(ldqA zEzUD4S%;?GzC+$ltNU8bNMV1A^B1NbQTYJ_&jcG?x|#N>wqo596TEZD_q;c`4BPh< z9WU>95b*i(wjNaE>x`Jd(Uy$W;)M;~&bffO+`iJ^Hshk$BqT=o{Mhr0$bzfyV zL%U^2I<&eM{I++o{b1{8SHkhc0tP#7rPS@qZl4s$jN2|{e^9;j;Z6cm*A>}s|M_33 zu@ab-C!2k_nUq~6eUi#nrv|Q+@VCf?b9{l;KWpnW+IA>b6j>WsJAo@)Vh2OqoWzQl z&{!wu`ZFg@+nN7tOL`MSg|5cyYHg6YHa?=&;P~h0j%jrBIKMM#Q$JEJg=_jz&X?^Wo?h@!-KdW^ouFzL%YE6xDm`I_;%4>ya;WVZO}25ZLN?O__Sv&y;EMn__z%!qdH`6k@r6MzN8^#yU@GUR}Px zf?RoFtR7jM z-J;lLXCkE&p6=DBe(By@+!x-2Px_^M?{Ht}yf3@uUh1T=tEx}jrYnxH`aTGK{n zL9fnz#HV^oS)bFrN~K?OW4iZSx%YJM-MKgCbI6)gz2dv0?04%0`uGdt6Bbn2$|=H% zna}w)OO|Qt5n}Wk?tMjX>E4660Q^HzS+g_EG)%1Cbgx46Yj(~up$#Tfac<}Y6Dny& zx>s>-=o=YzZIKC8oE!Qgp~xC3F|oUp3oW?_hVq>3mJq?%fiTZz=K+#3ozlGu)-St7 zEc#~Wb`t@_^{F2dBS%CgUYX;beA;#LS#H#%xF=;Vm38t}&X3>nY5dt9kQTrN{R!ZaQ zc6!nMV(gO6jm22Ml02ew;~C?un>u)7gna-LSWIpLUaZtKouv_$!q5}&ywmtxRu zfKn)~)|65Vol@bJhY7F?c&qYReX^5^^@1~WXmKWr^r1CUtTL@R3P#YHw$xpkzy{sD z^t2YGmXLE5szJ%#SBT(>DAZ{0L0+A4xiVyh$CR;$P?oiIsp!fT1+9&aZxR`(M4E3V zfsk?Jmw-rTpHwtVnwL=DJ0Z;~QwtW~3p(I@RIRb50|4vRL6+u`WyG1RrjZMP$%%~> zQUzQ_I0dy4!*10d=LtMlQRsTETvb5$Zu6l2z@4i`b4@trPF-}let4eSHeIwcpq`=9 zd!M5I)Lr^(M*SlY!zYaTN8B3L(NV2!0HqO1?}SbsWWPDCH4&dW9UDFI$w{N4HsY|^ zX14_BkGtM9Q^H-WA}5sa?;;3#JtQ)X*!=W+8nKypp^d;?O#x587ta5z0$@ZMg2yrr zF;U)G>9)bOqSbzLt`O&Jw8uH(K!LC17-X)I;*|)7Q*r7xEw=VAZ%G!W7W&31MZ*D;QOca%a^~mA z@VnUo%}*6a_~QP}T62@V9#$_jVJbV1df}Wge4fl_a(VvBS^!J%c%}=`CK#8h@n+6S zT~m-MxyD`FlXqzyZ)|FHx_6niQeB{k>5Yz|%URB#&9s{QRqdq@E(RqcQ0`BfE~xP< zBwS6Ir5iPHrhKClB>04p{~4);FILZ2lrJjr;F{ye6q`IuWPv7le4Jk0)#EPhQ`s%M z!CLUC$$9!9G!osCD-duy{<-5N#Lv%e*()43yC-v^Bgka9`Ohb2s9@-pwKzX#z;ml< zvR4~X=Cp?m0E^75jZHMF!KwtHtEm@(M3o+URY`0L_*Mx`^e=!I_)=a)i&Ou55V_8* z&g>;ng>z)I#b_4K8Oxq{ib~~w+V1KU6dEgG>wk=lfmBf#ThxGGO!s1*e!DQc8UYL1 z-qgasA-n4-q3Je5X~a*a;z0HRO;u-t+Z2=Nf0tio7pip92UVghc8I%!Jh~{H-(+P#}8sJilR>;uF; zo!A(HoaLTOj_AI~ttQ(6nfLqOnkvm+JRUkWkdB5_{E5bPDG%H-;_O5^Y)_!n8)3F< zsVdTn3Js_BI@m%5b;T0|wd0La=nt4d5R0qDxx-Y3GB`Mosl$_Hj6TrfT*Rgi)(rcm zc@mpKp2cyCJpM*>`ub2LW>|2!yi`cUZD{k%J&q%fX`g(*sEM$5m|uZuhj8-~jD zzFO`HDxkB9ll~d=OX8=sI+ttfV!q1}3i@?c&&Pygvx@B2V()&=Neq|OZ4t(#3{>Z> zD01J5E`Zgg3HWo4@=a7e)a>90eT-%Y1PR&e4>^y#WRhaCQw*eXR|S42uti8P?YW*8 zsky`+WJeAP;1pUe6WH2#y}Mwq%~)Er`iofGuq*GF7kP7y&wevAA+omEnzdH@PNgTV zLvM+9I9c~?Pv$b-gWh53nt$7a3dbkxIp2P#Y*1Y9kat((0_W*J`9PU(3(l%(n8lAT z*s#G``xlX=MIGNTAksO$lF=;$L0PTAa`@9R>8ykZF`$Z7(p@g4#-_A1IX`gwsM9q2 z+Zmw!sm!@^+I*N0uNd2N}FiX=Z+6Yyo zA@|N9jhSRu=X8=r?^+5GM)j#ctycTXCFv;Z40M0gaFxHwt1*4UZOHEd<(COPc|zv1JMKGiTTQ{w!3NZaB8;c6~U zJUO%SV_;QF+P9U~l;m7*CbhVu(v;R|mvw=?cI}ncmc6N_f_`jRM}1x#W!(R4atU|3 z%bs0`t=OP*WVe|Px#_jg6xZUMtHqm&#Sp}}Y=qrwlCVl0&wTPq`cUFY&MS@uQqfQ& zHeug<#H=ZqNxc7HY>6>U&6YGf&;8nro@;8>fJTFO!e(RUTR`k^+0Zsngttq(e0F0A zENa7OU;?dUND~`MxJ0?31m;)3>RCcaleOi#K()Qsy8p=*CP9!X7S7MGh0YMwGrMrO z2D8;;A9f9`!|d_a`!usC*Oek$C=jWZXqM&q6#ju8pim$EQmSvcf9 z0y$=NCkf{z_7D2=X^g@p#Ada&_;I0UZD}l!skvvZEe(Y-9j6yBFBo>4{A{x29k@3? z&s>K^>ucUWLt>{lpYGQg3SV=P2)Cw3N^;@y(|nE41PtXtgp>f}5X|0aD2I1_c@ z3FdqX_bLn`ixuc!oV}FDkW>CE6Db95SJ!n3QgYT_X+N1~?xDG%Uz1rISru_kZA^Ki zl6a}}2krsp)CA+D)|O2H7A92YO?&4A12bJC0WYk7gXtQSRmkM&7%~I7u)f2pJO(R_ zd>3^_M%kE_;cV+1$oM=1eUAy&yNmk4=Pd^i=bxLJSCqPaC!x>}R~C-*bTR=J`nZhK zmaI7@YWa@?eUB5}ADuXwqcnB<5jO`^waIa1;fXn<(a;~Ah?Rvw6D!n2WJ(K2nMeY^nHWq{^$lbQz*6h|CmfqnM}CvRfkSU zFRopGbfeuThGNo4VC_CX?|5UucHN0Hm_hX00V5?mg?Dqa6E_G89a#bq9w8_UeTbmY zD1n(w7t%B^(UldBH?qQ^%Z;ee7}x6@lG!{L5p#c4CpIelsm6lD(USOiAXrgqCJshA z{P-nH+(d!amO_M+1u}|w$K*kjZI7N6|CF1~M>=2Ri8V`dY4QTh_lPu?40RnnOi63} zsjfH-X>Q8bQO)XtuA^@&__WADirKa1G>TzPj$1h~oApu?!G6TKC}b`fB7EDeZy`NG zQaY)ONVfxH;3rAlaro65P@pG~2jOgFtuxJ($FSo}ujc;V#7O7h2&NtfkAqN>7C@MX z67md+l|3-gHJGvCWXS*GRw^;;DLw!{A(t4nMjyFSW1{UHpT20nk=5o-o&wqYtQYHb=jizH9-oDb$n18j*zj25-H98xIlrS` z#r}KZSW#?T;@IRk8saCmUtUhEEoVHRIo|&Naohj)q%|K0R6%2SW#be?oGQVrh1D(k(d#7M9cO)2YgZTfQ5P$fSAvUf$nRH`Wxulb z)|x^?%*u~asyWmJhk9Pz*shyip2z`f&XB#o?B{TDTCDr4zF`!po}S|-E2-jr`am@8_<#g<(T^XK`d0eR!$;jI z{qbz&kEOrX>MUPpI+GZBhwG>x&3ENEfFLSr@=4x)|0HE2iMIjM9YXlG-?nc49^Kxi zZuY!*!|C?HRFP;UPuUx){|ax$K4Kyh?@o%JYPz19d&c20z0XWe75!K_xT#ZNCk?zt zTfV7*20gIWwAtR9Yc61S>C)g(*`N)X^$e6K!)1LH9pEfBLf>!Xr|mPLGoad!_xAXb z24YFi!(15m+f%g>{(sP*uw8}1$!MsJXNdg+y(*?ZFBd@Og%I1yw3}~Xa*Fdk*=OPC zqGczPoTtO^_~gdo@~el=YelZQ!akh@OVpk)w#Jz8n2rr5xmUWupNtn_DK~K+ z2oFs*C2{o3)f*B=&yKAF9KbWS%5Fv(qO4v@Uy*v8_{B+?yf{%G^d*jdG=6?mxtj?a zm@+UJK3H`S_k?_PzKlw^#VMZm%!^vx{fXhik+b>K63&NjL^=UoM-Nd8W^#Csju`o3 zeGt@d4uIN`X6hS9OtKcqIVsR~%Z#ghv6B)* zC2)}9e;&D)IQvGwcS8s{>yh!XDTyN!V2~jSzDf2O8suW5?@PR4UF}vGNr?xVosYj| zR$x3b>FdQK?$?wRUh{qCsoLU-AX~T87D;{KH2s;Ba0-*wNF_y~89!3av)>vqUgNGR z_RbAOnq=Y4n$;xBKB4}ptW4$z0vn=RFt!io@9&@L?!{s~BN|`myv^Z=eVBbDbCIjG z^MM;lrpV;_SGU!|M!@Vfjn$Z|tyA@9f@yGO0{ML48UIN>Eymz& z2&^nkL?&{=oEu2a4dw^=rY|9((S(rEIDkIH)2OAJkEKiOLG$wK&w2x|@c%9T>s|jZ zTI>zH#(#4A>|4ax;?3_~&(YPK%XQ?8d(kbv+&yrn`pw;!0dwGV?3+dpoCCVr!#4Dv zTp4riq8^`J@|XMy%XMBQxjQU{e7igRjvlv$|H8vqw>iR#tfPw|+iG8DIu0PGgUun^ zHrj8Gs*wOH41*$IUs>98{* z-hM+xa`rpV0Ls2Otg5xlq0#!6T|TV5sKG;A%vr-Glxi$64ou8Q2nAFigx>?UsHm=C|FlRorx^O5QfH$bT1UT2QZdRi323uGgp+OD2s ztRR%=$hUx`){dX)z9i4b!t;10>sMM^yTh}29einglI4mo6=vJFZ@Gt?sBW{ z1rD;s$>w%DAz*;`sApK?|BUW3I^6Pw#wGf&&lC#l)kt_10n3>O9aTJ0bEe zbc<1$rkDk8IV~#+OfifS^hk1U)wG=>*jdOzbF&1^NW>^9c80aX_}H{|*pKjCwihE| zbE`)F$gCpf*VIMKfAh%4ATH4iu7up2et6JRO@f}EDQxh3t|Jy)&L2YLQ#SGFI^f{3 zy2tV1HqlJx=VHa&i!CZxt?RK<3f4^87ADz9Ooepn2-sp~KB@p#&l7x7+jM4s5S!HG z4>84fl(X02TZwPriVxYQM!QeIb74n#xgsk^L-U|$L}Y7ig&0fDot~_(0$W8q%Sc)1 z19cL$O0XT~@+ya$tNa6Vg-8`*_<{U4Fn^oaVFdG5_k$Ys+a=m&(w0iPW^Pmu^hv71 z!FOYo*Xr4zz7Lo6y+c@}Pm-23{((Lp&&=oSK1ofWa*Y{3fpzeII5f}9PCjr8ievT0 zejj#1ia8d!w*7RLfE_)_{v|g2f~)^4bIt(KWltu*qwD~d~#pLDE+TE-J z_IK21Ym4qrQqRE9vAvP!VLw@0l!OUv&E$PBRn%v9NnT|Isw?cqI+m_tYbx#!zyUYH zZfIa?0`ZW>FY;fpixxIzAG(KLI(POl_-rTcYC))m(n$~s@#3x=THOo-T*wEK)~~b& zpLGuHXZTmf;$J?$fE|fO8;){+&)wu77(BE;T+rY1UEb}%_Pek2YKv_5%=QKnFIi^M z07d3BQ}Gn)ey2Go0luE&H5ni@vRV9I% zLcE3)0r-r`E6HYxtL}+kL_{fRR+478=WZHexLal)Q2Ht%S3xe5ILpN*1A~YJ;n45Z zk|GxFV&>~v8t6nPCCIZ*?25EuHmbz5@lma}%p5DwcQXk`hqdn>z9=`u+;iW`N2KX! ze^rVqY=~#reG(Nlczr)fni6SMY0{KPud5ofw}x+_*NkLnzrCO4exO0nuxUlGlfZ zYy1Tx_d!>&PQwSFc^isjb)&0uK&!JXPgW{!K?`psdUKcS+@jC!p4c6ve8crt8B zf8lg9D*!3UAch%+aBj#ya7hl35U>X1L*RHeRsHv5lh33O`*k@sV0{o+!4{f=jJKV( z6fC7JMFne>rt;8GL2R;Ns9W8qu!8U!^w=&j6kkQnA=?l{yahOOJQnVxdrZVG{oQ)q zmk<)g^Ys4s(T0B5E@gJ58)=nWNzt&T*R=PIr76QV3y1l?~fByYqE|Jy_Ol$T&b*>cJUG5(fhF zi(-pt?VV-2o;^}_Fu6833e_OqRmXH9_<=wO0fZ1J&!c!G^A`-}4+UaHcpYtZHoGc) zCgxdUo_b0LWK6T7};#`i~4lA-i?Gk~w$pL5;6Z z@A?^8swsdTTT}a15uWZdr4XCls&xlsL-5&7zU;HoQizFU32G4+Cuy{8>NwygCn3mcuH*Vz$}naiVk&p(o+{V_5iL3iUC&7MkYMjknqN}(_RsPbS;lcd>IRVJlvcT&32*Hq-cLu3As(r;+ zP)2Juvax9O%UD~4ej`p1u5>uD(dTBrq9bGs{vGi(Iggv{QnO9hx!S_BB3G<_3Dwmm z=ezmr&=)##FBYF5@k$6>sz}3zP^g+$t_iqCTzqL9bZ=%Q1YN4Qd(-6n>IbF?%*^RJ zA$^6o6@^XCc)&%S`C#cz0gt=Ulw=x$HdSQ(hksQX(R|a{YN|=nhGJvvB&wdyhiBxI z{3Y#l(%$xcQyz%urat+2)S0Fj`8_sqsM%CoJ#R7sCM%Aw#eZyZ!ltuYgk_ahHU0-_ zxcl^K?EG9M7f}g)mjF5G`$;aAJ09$4MwR!=k+pOf|HS*9Ra*!j{za!T3e%jbk69s3_*mQ@>~fLORLuh$dZks-w&7#L#!=ABNJNyxGA^9 z{*((2?})S0g}SvP5B6`8IR~tJ@^Mm%QNf#z$MxsqB-&TpKN5#=K@{gU`6I_Rp^3Dy zP`9`xmw8-hCVtvXlt*%wvjJjdvfh{SrA#DaqFY&m==w)>=|akGC6WEsO^sswafFli zfe?-e%dMMU6~zw@sF|*S8CVDhq?i_V&N4a-0MwUj+Fo`1ReVZUTfIM1OQOD1mBU~M zF-*ne4>RIN-2UW8TsL7?Fn`W*M>8M1k>DI~`o1T%ik(6v7w&jwf)33q3z(LC-DqnR zLpqq2#Ajy5WAEnD4z2S-`C3y3{Bm5p`;tWuxT#8_kxN(qO7PLGi)#12ie?OzoAVa) zHQ3|~KMp2xk|Q^3=Ts>yO?SSAOOaflyZVHf@C4-Lsi*OdJdm^jBOJZxcV_(>YJrX0 zDv74#fm9tZqQFs^ATK@>B5_hD&9DdWoVKfMSH$`Xf`*3Pr0sF_m_^8b30j6RkHP5GfSEN=H3{0A7oTmIdRdhz=$&Qk;UzEMz z-S2&#^pSMzlLND}vm0!v^-j#l{HgQk(%A1ikCw$= z5@^RTTyyu;u{XP|+RTF3sHNGie=w^719WmDWBmS>W?g-_XsNCoTxE}Mb*&dy&~R?P%%JG()6o(5?)~s8zDYnr)?IY~~9!zIQ0n+f_mCMoj#ms%a8ofF&NV z=j(imtED9OUeSFTEA2tw&k(Q%=Pq@=BdYtLsyq~*XIo8fv+gvFx^fu@X=g5tQaomz zq`79x^42-B&rL&FUSg-%vr1c9vTK9cwE--!*BEV4G(cd)yB*GLwcAB%L9WqYkGx+l zGiG;Xz-n>6hPZ!e&RQ140m-<(Y*L@D)c47FAE`g-rcU-M&Ye5XKIkjcMyp4HAaM(u zu@LZ6cv`ljh*zzi5t6fl_rJ{3+WHJFpCAu0w9@V^C5#o{j`~lMg<3;^5`r7@sK0aj zV`_NJ%c1oosbLdl-}V4O$(CR`S}Y@rO$^Ov?9Cz}DR<^T0cY>3fio@}k_E^bV@~po zOc`F=-mLm$?6uCfW&iPQWB>8@-7m&ZM(2tnzPYson7t@)P2=hijmOi<_HF!)74bRG4_CFu9SM zOQ;Q)g!I7jD3cKwV0pAx+}UJwI_hlb_VaFxkIM3B6f=VRPY9@H2WBs+!;Bb3Pc~+9 z*{u1twqhG70qS%Lfce<|&7u$O@ zulL1h%{27qAV(JH~Q8UI?XsYfM*!@!l<1!j%v|0I+oRdtXR0w9O875LxW$~2kf zb0;!RTAQ6;5R%~D=`2IEMcuO4DF(9-Dtoi@kV)WAo6@M#vn2cAJ*wLICNbFu@8vz6 zP>6obPLBx{3Z;!#SvT~{CREs#PAE>lX6G6cDlAAR6sKRaQ%h(%p-}y@4{B{_c0Os+ z-b_e3p%DF=(-ZV?rkc1rcugmiLceC`?JeqBbvmI4{jv{!i@(jzZ;41J^sZm_!8(dd z*9P^`oUSd_)7eg%?1Q=jolYoTzh>uNQ)F>Ep$Pr(9+O|PyI!dnKUO|g&X?UCuGZt` zaFrgnhNtr|Vlwl6przG_j*v|+LK0?{7HF|hWL{wPBqP-tnaa4ZL_O(62;~Z{T;_7m zK7>(L9ecLRS2nEVLqp#7#vX3~2XQ&hm3Zg5@zxzA;`ifh5mukLV&O6YzuCNm8O+OA*E+KdN4 zmaM~&|6*stWQ#>v^c(GmG=NS=%COw8)pV^7IiKfK)rQqx!-Mpjm{K&oi;^2l@B%y> zg}b?p<&{#dhO_BR8&kxrfD`6ZaDfCH%cFExg0kMd)T$!kyVY0Ga;|I}&V5^A-IU@r z6T0TE_kbI)0ZV9t&iIBWSepM3Pf-1Id4g)@ah{-ZxIDqTH)@`mHc*3V0e2Mr_ppC* zJi&Z6RsHv5lWie!v`UQj6MC0wN=u`&h_)20r7hBuOe{zKtSg5h##oQ?+)c((S-unHQzxghEY*vyI2ym7GUH~ z{6MW70xM|cOST$*;OT~K_kuZf_%oBGsqfxk!O3rKJ;}+s{agU-+N~n;OOe?yIFILr z^%@W6m^qRIbf10IvPi!+4J&abf1AHB@(y^|y29(dS4%6i8}q8Ql`Fu@9?ihxc`Enu4BUV*y@&chuQC3)I^^V#QQ@mu<@JgKR$oUn*G0qH&(ZLSs|}p8cNKb|D=k!kW-M4v~BqFXTP1 z@IfBZhNMq$PcE^$6`Q{##XyRHfhC`Y)<(NJY%f`!&K-^+W8oG0M5*0EQQOY$$t*bh zPrkuFjf=cx&3`Mg-RxoUwFcHk*Qs4&(BwSy6ScWG*{cNf83p%+)1FIi*Kk3lN2l$} z^V3ZV)GNCNl`~zvN}FN2TJmrnJ{C()x>MVzaZ^{lQalJLPeJ1qTU2+vomzJt4IGyGHA4?J(t*xrjAudb;+q?I>5;K zR(@|%VB~pJ$bs1cX`2;s3VBFc4c>=BYWU+K4D4a+e$aretjOCVMJaEOlry=2=zLv+ zOEX}nP+wEZcL||0lS~&~rO@`dL+$8MVK`94xYj|ioFzGi@8W_QCLa!YpX7K;-S5!9#Njyc~YX*;d~p zWb-~@-M`l!!hqpktM7-VF*D3+V)Z8V_38=hiFc3Pu&V2*mhnv-i*J~aTUYFc*omPr z>h;*S9ON%EZen8F5#GdU=+_HvU0ZG6@fTj1cY(-(wHJ4xY?%Gb+D};bKT$Rm*}L|f zSzUXyxB=yZ%tY=abQvS!ueK!lGyIhnfFe>{J%e)RhIg0CZ4Z zm=C(C%Z@NonCJrIN}at%T4i)lz{ddo!EIYbdMTzAG3nJmHKIUDtu(FSAVov+H;RC>;BMG`fxzi;sGb&!;Mp`a&6;00fjUKF47}M}dH4|<)YiViOF{?Yw_n0Pq`aMmu zdb}in97$+N@eXUMR5)KYI!IbTO_?tV4AM3@k#e+ z%=An5EX%!lzphEZ48fJnP1?n*sXfb;=_a!_4Ty3|rZfnM1$ttNnF#|T*&{tu>&m?h zS_w?hlNj)T_KuMzw=oq6-rC>y1^!w#KSmn*TUAs11o0TB8ZLRnT;3UqVi)vBnq31@jl=9nv> zpoVllH|~h6YHb4l&Mp}4yqm_s)h}`rk_!2bnWEoQI0fsL<86BPCf3OS*8uO_A##4p zi76X5bYyq;Mn_oINJ8Toh+__$5M}2MOUbb+bvdfM9jP_ClQeEZh&!vfPE0 z$`nmN1+v8M4oiVnrU>gpe5eNVQObwvF(2gsL9)ZJ^Jm0P^bPuAU{3h7rAzwzze_`y zr5aJDvfpUT?z&wwRl}WIKk?@Pfm5PAyu|yOQSaAH^wf2)vE7s;zwA%X;`~nuvr1Z% zmjdbuELD*`sfO3BnZJzudCi5LSDYUYubA52{e9V7|Kx;mEbhP$zAnU3Vw;v*Plq=< zYng1sJ!fAU`Ky(XLqKeL;%dzP6vZ+AfyjuJSW0kWQxUVLnYYd>K4tZMikDQB>r+-j zyJocPHK_xq>a&R>L91^nL66>n#Tdhgwa%_%pV<>{va!Vb3;VCGCDKU|e>{-b<>Qtk z0c&1Q9D64=dtegm`i~{>&-mpbJU^nAKW^>m zsN@&fUQ8ty<0C310yy*0#NhPI>GrH;5ktwYY5KxW%~7u*osCR5VK{+R<<4EKoJi1g z=L64vK&dHtU4v746R3M+#o0}4v~|uIOq9fKU>%#Z12p%Hl+e%>XSd%0f@Rl)oF}*_ z35qq5;AE4)*=BP1M*d84=il59`9DH&SdhX-5C?Zbfjulm1N4Z4{o0zBTN-(4%ZnQ2#*@!N}e>>jOVAema95-#YT{+-R(WM8b}nPnP%n*k#skXeDybtT{LY3k0MNBf zd+r=HAz6>+10q+uKGd9yFJieyL)n*{iz&lpRG0<(>v6!yUjt?(8x5Mv5*4uH=4L>u z<}I2KiX621E~a$DFRC|-uShY0^2}7t;mE2)z{KVl5EhSu@Td70tDD>3 ztc7DL)l$TPR)=_M*03?BEpr=}#V4Fe@>lkBOHm)0-b_bmF3eBz5K&q-$OMj;cg-km z_@{O8aOVxakHT0e(ea3Ot&zX3YXp4$lM@nLc#GtN}V z8n0RB>Wn~*{rYQK<26lL;}frxiy>6WUCUQF5!xcRL~4lwwhgHzDuzp{3!1YJ8rm3I zta*jM5nxp^XX~6v-_?ASW<(%q2#FcU^sJss=_~ALQqM>zpVfQ5LS&<&w6zW6hTWQK z9@{YXy}HE_wzumXfuA7KR7yV~$ef~g*c~t6;_Kz9wZ6n3-if?n^?pK=jS3r^TNW5+ z+7(X1NX@WLVMsDsR$=u>+kt|m;~2Jkbqw(udPt-}iSxN`b8t|@MH;@Mp7-k5lA2$D zC1y9#eWRBcO`^0Cfi2Tsv>QVPAGaunF)4VmzPT(r(>-UK^EnmEG(~OXHyu9*%*9Pk z*;n4pK1?ZKsV{PL^+)Ww)H{*76sD=Pz12Vyy{i4`TG*(u$311Hy_x{^#FoX~UbDE* zGPZN&mb1d?zssNwR6%jFM(O|}FwY{r0g)JPVJGOO2{AY9D{-!vOQl=F%)+r?nVmQR zEI%iOcK>4O1XWO0$hj8;q?|n99wY_VnImtlKBMgx=|2?RV%NM=R`-o}ymjC3%uE(U zUg*%MRC?B5VT=XKk_Nh1o#X?U4{;WM$Yba|*p0qyD=(mc!w&s=wR z2+a(3ceIJxX&Zx|2Bqz~gG}JqnUbFU=vzSBglhT|;mXn6pls|Q;tI<$aH z4Xb}l4Hd3j%|P?BB&MX}qP3+`;xBP#st}eU;@FxKyUPtlCVQ{+qQtNqOW7!!Qbt+M z`MNd*m#K6g-D_>{ya!RPvvR!|D(w3F@0KM=TdxLLD#;X8TW{vSk4nTX26!HCO&7p z#Q5 zsW=2BD6z8$y^6ShW@2Xm%hZ2P-L;<3$O~~x2EBUMD9Ovm$Y|dtzR;mvKAiN;^C$NC z6gHUH7fS369O_jZ?$!1x@Js|F(<}5t*tYCsVij!<6vqb_t9qlH?MEnGhfmbw3@%zGymJX z9La~gBhKa%$t5Lpmwvn8^ToOMW*B0bE5H$Ob`(eK+cbLk+%iMP5&w+TI-fluwJ88A zZ0;apRgU?uyM-C?eRNKnJ;B;KS917y+wSCdcw~jgfPv+u#K3_?BrKezSlsj1Lwg^Ge1~Vv-(CqCB6@sJ<^0=WRCUm6veCC|b8pUfOdidIbgy#e@@Nw1m+tM%r;MAFH=C47uU`{3 zSVvQSE1&WzQrf-u@|oB@9pks7Df)A7ti!=pTPkiLlClcfY3QTZmZnW66^yyo(OhN< z5ti+Ma(ewXlOd=5u~y(&F1jp&om2$a?&V=I39sowEG{ z(Q(%OU-BbH4;y(rGb`3?-QVIz5F0`j@(j$3VABS(KAdf(VfQS818n*nGnRd_d}J^i zqgbqT1SUTldBN)b9+j*K9HPiVSzTmh9jf&nhf>BN;Od;4%r{dw^FhBR>sda?HiykT*a}rRAVaTWsHjK zo4nWB5gqRxWFSkE1#F@L=kZlw6Z9Iy7G~!R*iW>gMp_>?7hKVi4HwItv>SOoK=;#K zI|T)P$*#xv>&&guz#u)zu}5Juk>Oi93^M`GyAi9bkwKz7F zqS>l2u%&%vB{H*SbJAsh)1_va9q-=7vJ)8)Zlk};yXcCBLqike7f8qB)G+#*I~y0k zz3x9xlTq|Z>S1p#C&7%(6{@FN?58<0hHO4f6g=La%>}V;6kAf!rU~vo9vg=v>kNNN z?IXz>v4DvGr>b;qxm$jP9`cQis9ZP7sUEc-b`4!BX9K}|V5Giq&5g&;M`QIP{+`QA z@6nI=VEqPjM+p50u1n3bw$>L$j;!AdD@*H+7DjdJ19ctTyH9kLULMc$!FA^H$f|!S zLXQ`(HZyd(7IJfzrcyvwi~$Y^iL(94TBEg)yegDz3NKyEF6p9Kal%D2J}Zopl#w(P z=0ZpJP@;Y2_G>HmFt-WWlQ#tHPGM!TCK!3Eqr7Fi&}{TPI%oXBNYVH;C(TR@i>7;> z<$5V*CPketmG)_V;^%4rOulq=kXWSc247E1p!!|sKi3EB;b)yzwuCDC3qkO=*qk5t zdiUAupT-nkLFDb&$F15YtlES2v-Xo^&v*wT!)s)w2}6)v33I%=BEMMu40M8VE^4fy z4n4I1aG{NFxU>QL3`W6U+k#aI-6xh8(P9quN0HXdv*%)C#QU5bd^YlY?3^{@@YInh zyAmtlbnx@!|^Bx z#ZGp!i`)P@$4E254e|1cAtZ7o=Lbnl`D6`y@;SVd_qutq`5c8xieZ8&9DQh2)U=8M z25Hq`6#c+NI?MqB^YP-eYSUtGR)-7bUMrG+h!a5Zkh{E?A>%PSAE$_Q2-#Wtn zfd%jmdlb&b5gz^C2Omh1D`bV7lA0%QP>7#vEyg$z}mui zKsei+>V8Yx0%vY0~4VF=~rd}SwsrmuZ zK>&wg6x_nA&K&~IeCz(Bpp*9)ah4}G-C(0ym49(9=_O|eQ0l>`rLoxw6ldiV%u<5P z$s*~2E2+Tk`RM+b&!D^R*+xNn$0{aK}^|)R`^Zp#0;%81aTIDGP&= zXS-WX{+X-HxHr3IC~3Kl&fKjCboHD4*&O`rOQ{86V&5hMlnXIl{A%nA%#aczWL*1s zCP8lL@g9pXAJ;ZB?=MW;$OIdTUBG>x8UEO0Er;uT*yGAbsVoEu$^F&Q3oR$vhta_@ z#)XSB_tIXBidNXWnEXS@OWmdo2^kE8lb5P1W7dDps%ElwZVbVoDv4qIXTfFG)|%uBl2@I&dxmsmlGf&xwo|lT@IOpCxGVhJ{#P zgeyi0o7k4U^0L{HpRb=xA^2Qd*OslBzVy1`C>E-hfC*#TqH#~WQlb$rXT%xFQpVfQ z&RAb!Y_EqXzcRHB$_8|2!(~-QgjdJtp&+u z@m?yEbBhk`s*b6@DlcKOO-XIU66!2>L(WX5rnUdf(wN#WqEpSy&T=7qIVYIYSBQS|>trg%kfvu9r{>j5M}xmhF!IJ!QH3~p z-{-57YptpOqhN@srq%`aXG`p_1R57Yy&+%0x>B=!(D5uYgdur)q+pmE+-giml}YYf zZgtNiI90xB@b_NM_yKdCsDTl>_|$Byl(nZcz(lCi{{@brKbTfxhL?&5>(3QQ*Ms); zU_gmuq#aJ_sC13oF=0mN~e#h8G7ovQX1G#s(#6%{m?UHg?0<9vf; zB_^3J-9r8f!@UO4glvmGRJlLu2dE)jCL4Pn#ca5y2o(dKeBd!OjDAjPvGRwLwQ7^q zbEC*DdMcpN!)nF~+uM*jpaA7o3tkLAH-4XB_?IG2kj1^w5Grh(S@gC*0>Db=OnRfi zShK{X(sQx-JumS}!*Tvg9W_ZD+nDsBW?wDaDOWeMgoG&reFo|cLJ_yLrf$GKt=0EC zNCj)lR0br(vRK@WTbgGH!jP?2Qlvx(47gp6@RP(_P2vf&aN0^*h_FG&XVQV$nFjkA z`|zP%g|V|pjrdX-dQFB;*>BiKO*(QN+EoxkVs4^8@0O>@q`5(?H27$I!0Vv-6>&PG zyjH$2d%ZsupOE;&k(S1sr1f+Jgrqa;>i^^HUErgvul)ZcGbBS8cm{|x)l{Z+)M(N+ zHEB&q&|D``5P~5I%FS(QHX@4{W`eDXp_2%c$7$W&?)LI?U3a&;>)KjvwFGaF5G9~i z!EURRZMD|gCk7R5%f;LL-=FU@lLVyu@9)Qp%=0|o`{jJk_k7Pe-*alDZC@}9P5)OIdA#{GBH(wNWzN5xhCyz84rP$*_*&=>iXR7%()g6uFp zj+feBQZ4@?#fi2q9n>aAv)LgSWw56G6eG7#QXdX4{55M_KVxeDSfjn0Bw$hI0h7WQ z+O)R*C)11?&x#*ooa=Sn=E@%}Wy>+*-qCLmiNL?miXDblq@@AWx$L|Ln4mo*6$2$? zzs_$nartILp>j$eJ;q8UXNeX2v2u!}`lF}B-RGXfORO(QXLT^%qF8vD^*+DR_= z+82_HmKCJIMkUt_y(zs06oSmO?IlCd`dUIcfRhxs#NM4^Z9O7nA)Lv^uE_?XZU&<4 zE5!&4^xViv7Hk@w;Sz{Up3$8|a0VTC`J8IFIknzRT$|9mj(q~S&%Dz4hx3HJB(m47 zhCaD!rRV~?wu(IScrAYoRCAqM|73PbMAG7c z6zr+Sdg?&!92JqOHo$it-{t1p*L~L7OjSRJ>di@vmK#@~|Kj#BfZv4C3x%pvJ;Txv zkYB)^S{-vu55B@pTY9!=4txsw7M|$a8T8H5<~)4vq`pPDM7wC7&7IxuYR}sVI;GXj zr8L8XD%UhaX2xqZKlSli(Egi{s$)hyg%{;^q1ay^rTkf|7al#2v&I;ES7c@%C~+3u+tY&#mo_{iHDU?<~>>#ulV{c9gEr zc5C}u^~^+-Bx*%@m`1)}qAyeo?hXP%FQ$94#i$CV!VAmS(L7-trkOY-`L zJMK6HtbNE|{)50He-H4tgTEK~`vZSfjBPD{?fgafOT!@gDB>~|s;_O%4439*C{UN- z76U-Yp6liA&Of*bd`OAu(BnW2 z4tZM>#b+jJr!(RCl}}n*pK;+_mP|O!AZ$##H{jecbON3mFnT#0#FRM`UZ$86Njln3 zNH$4w(z$&nMFUi|IR3aiHyu6AM3)Yx^8+bY`(wMO+fNI|V!zRL5{y_!hkfY3RCDV) z>H$S^SL8P`cU}<5AuJfltVV7?>u1nA4BnKY*)@Io(i`t3365!iAMgwzeAw#GE z6NoDGJZt+E8HrXp*5LA*6vv0lZ%Q{V1dzGBoPCjVRqq)rE1-Ow2r#9?X3MR0%MKnL zu8y3YqRI+do1HFWEKF3H_&RH~-V(J_Dxchh?HEMapb24u`07H&hy|PSD8Y+sJqC6e z7LgVgM_9kv(8@$wc?YhP+@^#yv|IP|#KA^0|)=dtLsw_IbJ&?WV?{{kC=gu`N&cP*d!u$@rO` zBhYf8?%XZEy_JnGe&$%Cy%*Wbd{@3sH)ey8W=6Q(QCpoYY}c!xt>iW%$o((R!Bp|HBS6~%Q~Uwr znQv^0AyPdDD_=()3(ZlqEjMJ^Kb<5TLeIh#4yi7*^1e^!%0VC_bj+;e!jxY&=!{{A zZalA|8$dmEnMT3IKr?z?z@gTCxj|LM)^_h~0RCtups{c^hUK-c>SqhMR!`eYx)Nb7 zpUN~-0>6p+3&nFP)JeN=2_EtUGx6+%F|*Qwp%b@BabttT`Rdi_wOyzc|6h>rI=Pp_ zH+*h!I?5bj5;_Rf1>?p^Fsc@kr4%HpiV}4eu9CK1VhDfM0RyM?k4~1gy@g)Zc{ES^ z<87?)>*z<_lp(WGtXJo=$5%jIj`FZ{>UgqMvqC2E84hE|hsViar5C<0%#6QfvbMzMsj8RH{c zYiVT5#y*({FV%@ZKhgMp^Oa87=t)DMa|7!wQ1n)0>S(#kTaf-i0Ynt*vPy*1*`%?y zUl?ECnebk(Eq^)zjA%*9f|!(b3!Ot;5M_BWm^^1SAt9BQ{l`Gh~#WxbxmaY-(_x z=T&Xdg-LUwDYx%Zv_}qVFn2i9+Wy(ZV!B)7!k_jp0;Jv?%&-r{iy|M>g}x>3h(6`g zr+^yLxy`aA5Xy+(50DwdhGM8hI}W4Dy^>EZ{2mWlZfeCM!eXhYVs>TF zdvqu(CA#f%q$g?x)0SY?^>-I&Rr=#~BBsleKT%;A zxnz|5Olq_9B=L4a>P4*fAlpa5l2*pK%qdvvb|+8$-p&ru-s;?V*`zLFG9ttNsa+E! zxvr3e)KBwMueWOb6zT^9;vD#SDM{YIwdQl);dse_hE(tp6|xTg(33@bA~%a4Qq2#3 zL>PWfrVLBj0q5GivXzRi?)@WRpWANZgAxNf1#!+pvy5BHJye&9+Q@WvL)sj4oIM5mcQKuj{n>P6(}2 zt#$uy>62m!ZyYoYTS_Zw!9x2+j3ZdR_bYK-GtDeuSM0r8pBtCiElUyVa_lT)EohRf zD6rV>*-yO(oO?2(vl2B)%J&>O_RDmt*c%yE@6Q1-1cBVUBBfsX7P+m-Ls$9Dojq#z z!4ZIlbVd%PCvKRkxJjdgYy{MpZ?G00d0;y3pP-sOlUa=_$=jrW-xA51_Ui+0 zf{yYtqi1bf30puAtaA;|GS52N&2ual_0(x5y1`Um`ut_|`>x$&tjeUM!sy>^`B3e0 zWf+=qr9SGkH+~ej@<7+@riQF6JxV`{mD4_`Wx(vy3*C1~wL>O%F<(&+vOg3#hlb}> zzOZpFCkTe(NGzu<5kbw+?vS@_{0(-XHR- zY^YR`!*stP!?`+qYUhb8Jydj@o)!-M-c$NKg5s)&O%aW}*(0%+a|9<4=c_5Mzyz>} zs*Gz}jyL($$_f>qHSK`s(1B5agZ6@LBp^|aZF7u4kh0R}$EL!u%-uGp^!c!EzAE>^H@(d7J9?wV9neWVW#Tn#4|> zkX`GCDdTHp>sULBuEB3SF~%4oeOM}!ih4#k)Ooc>?!9IjKJ292G=lP_P`;cEb_f~geWc}E%JhPlUQ zXBZR4<=X0RJEHb$MsNG0`z8dpkg{gR7KRFR5EjZ3z9~n+hK&KqK=>LJv*~<>l;Og2 z9QJ|9Z0965EORzYBiLdTtw2qgd+9?W{4lxzHJBs}bJe4!iDwhf%Xz{oty#!(A<`}UzFx^fUgfVaSAZh9DbtNOwmw?p&*G}e-mG}of3(IIjCi@z5Ck37 zvs4a{*S;l4qXXPX79x0@W@@FuI>+KU1EYHqTyEdwcM5&u-HFV$whzzO831DuEq|{Eeip^$)h@2DQHnF|oUuz3&`_&@bp$ke$BJd@ zP1WYrnP8=B^o^ZiE;%dsbCJJV=VsR}=|~;}&M{XOcb#~SR!_iwk*zZYu^o5p9q|PI zjlY-p+sG#FmY?5-PuEE45NwTS1OX*Z#RY9XOiDxk}Je5sK6p4p2|XN=W)I~~E-&Mh z^5*})mPgNMV2@f58^rs>3p3Rf7@(0^L^#U~0DJL2pwXJ#JNZWjVEygrp`-t^Yz=mM zD5T=XrBT#>mc|VZ7&}|b7-#C$K^mAEvs?x+5dZq!6v)LY{q_jqVxsId_X}h z&W&G6hcH+pCLQ6Z+25^S?3$Y~ddb&9z7_&pH7jU) z!wS1*4eGgeO=p}#;FccBjQ8o+-Xe?=@6)fnWt(}|uf0Xs!}VH}QZ`GYF7sqsy{_G~ ziHS=7=x*{j|Kj~1d0PE#pS!w7}ijM;wbK(_2@onwirAOOw z0DFaKDtm`;P=A!IY+eaQDt?-}AKX84UI1&r&tnaEN#?xfOxGIlU{>$*SOXp$n{w7* zY;PujZiQnb-pW7RJP4AOemwQ$t<42edITw4Dt1=wHcEmz|4drn;C^rOzoSp>S)bCU zE|}2g$k$Oj1oV52u1_1=Fa`k15|8en%(dC(V!vw<@fi&*ySDu{*0Qo(lZaxMq)Z~N zHk!E3+$`6sp^gbbXJ+cFn6F~TllrRStK9ihrkk>fuO{dBe8rw9qB&rA!&G8j3k3vE#Yc*Z!G0dQL2N&FCcRW>!AA@w~Nx&L-KScHSE_ z(*{V*8Zk<6Li+9@7HJWjStXv)xxyrV_SD4QlM>G|iD!1MGl~D@)Wqs*y5!XmI{(VI zIW6P=cynM6v!rICzEUUszyNa~k9WnH@$4}aP(tW8~ZDoqp>v;9@OG3ALxD`H#`>ruS^*)_1MBiUF| zr(Dex*#q${y8X#cm!EPIkkuX!FEjEkl2pfFIc`y{q|Fyo_hQ-tWaq=2WKYXS5aVrk zE>Vr?)T%C>daB!U6sK3{ZdRV1v1G!smMQP|q{jCMT)E8`uxbK{^(%}%T0`Ml@WV~` zP-eL_(vQmbZhoBvI>_V!9Bm9`P`v_5E}=j0eq-{*o?8Dsm#(p2;)Z#nhqu9}KBYdxo1y|QFlm5VoPJ^fa%G#b%2?e*~N&l$_@Nz z^~!t*qGJ~TyXL|WD9(uDGbQNGVQjOE49T_i=-sr;L`Ssa71%G?qhlo0WHYt4!{iFM zeW`^CIn6DJ z@Cxi$RTpYEuXryenOi08JhX$tk~ZX){hi4g&Q`Oq=p)qt~YLuY8tR;ci+An z*V<6=H(q8B13jOOdK$;P zRhLAlWYWY(G0<<4XDc}?tLtaxlt8Cl!Aq!r4UhwVwP7ZBM`Y)|6rBIVPO8D=Rn)zRmrOYHbk^r!l2(sP$SL zT3A3@?3;{gN?v&Bm!+KIsT|%|$Ld%gozLo66TR479qUM^)v-oTR>ulGSshFDWOXd$ z**iGq>ACb0tM^hq+>vmn<7q4Af&1Y?s60~ke{35}r=E8|8=2bkZlTrp9$hFM)ay5q z31q?AAGTuqfxgC~=Lk()m9!cTf-IZc6XtX>0oMZR9|%lu`<@0zFzw0cx%4y9+Ej@D zo*lv&9e4Bx=FLp)|IL~6mT3P+C3@)8{XaUDT_+D{3TC>q$6&ES3JRlB$0rw1vd>PB zBs`gb6+4GExa-co&7mbNiMs}Qv>KPYh@q{%Y_+m3k0v%~-Btcjvw6$MG!ZEuX)4q{?7M+@!I3_i$QpyOX#}vu&5#&zWBRg?+*@iAt!;#}UPC`Akl`3trr}F~~v9 z`)gCjix#lKaF-B`Fbb0QU&mQ@b8DKA;Jjqd1|Bv}(l&Q_9!@gx-DCh<%p zc@MQ@{Lra%RZ&;SMj-2Y;3+lbe^SvKyo%?y!6a~rBqew>odAzCB=Av!aTA%!e`h+{ zZ=(I=$1K=*@wX72UVoEl5ZNy>wos~c`vK+ya8Tf$AAtr8NaD=jU~y9d=1Q&nXd_m_sMGcFbp z{`cRbeXW)}e87Y%_`^R3%n zaEB=$RY9Yir$+YfCh#cHGCy1$$zw+Idv4B2V!bLlO~i0Myk57)-ft;CgIY8Xom~c) zenJ;nz02Kl3#Gw2Te6Y}KUQx6!NyU&9oGcK-t$|x%d@k!{aVZcB0)rI@AWwBOofDI z*nb*&%^Ta}ul&%uy_^6u&P&>^OpUOSci}WICc0|!gv&oB16W-7YwPy=RL-8#B<(Kj zdt>uz`)^InyU(1kFN7=_VeI9u=n(A~BSIv=s2IqSL761U0~Az*$7AaoDiST9Ms91y zc5@%5@`IZn(@-%eg(&fAV=ZLBGp8Qp_$}HQT3YS3ERMhs(=&WHk=oe`OC5RP+!tE}ZBgW_SRrg&ETJ6gKFOoOF=BQX`Ef82?Z z-!Js`*`3#Bw8b9^-AOQ3Jhf-(AFp?t7wDMY&^>x}{N;26Zg+@^0`k-&p~2djZO)fI z?MCQ$WFq7S%w7~s+&KLa-+$$Dd83Db3_G(jD>@SuBblUp3wxCPne(zDk{ky#t!>Vj z%3-f#=wYR|x3)Rox%i}#qnFy7y%pg+7qi%0tH^F|i}!|l$sT_!w2cR?)i##t+;wtR ztM~f^bGA6I=P{E$BU-?i-^^do`SB7{alWPqtJ@@$WWMi{G)qQn`DC=qQm;tUz9`Jc zNSMyP$DsB+`V)RHjC3YCvqoR%mGrJj-H;P?3zuzG7K_vm`o03i(T+~vJg!Hp9ARBk z)(Rr%h-w6wZnk^PD@cUJB3U#Al#l)uiHH$ljjs(uoW*0`qf!HpR=vaInNTHobORBY zBtODeJa#)@e0X`pV?S^|eCFc;_hZl`yTkqXZ+);a#AEjmK(UI|KVB85e^%eS{L1D! z*CAkK(L|Zy$gk)%FlBvxH_`SO_Xnx>Zr&3G34URauxS-0s-}Y9LUx|V?$Z&D^%(4k zm*v=f=7>glBVLclB?KDFIfFf}er{f3|C1VImm=le^B1yFtX`RoW2FWgW5eD`Q_#(i zGs;p%mr_BVT;=6g-tIR0_C*?H`p$9_Ng0nBErebJWbp@YG(i!S*c*afA;_AZxZS{B z>hRiYOmL^dHTvV>hbPhxP7W8zno6%F?WP|GSKa&*xYj!!SGOw-s5;qU} zHs>WD)Vep|{j)`eXL>qJuzD39n3ivOLYQUPodSj=)Df@BOicl2@OW9KOWgV9&46It z2g9l6gWEN+3s|y=>oH$g&!W5} ztaWAeX=6!*KQ0pJUwK_Sz4K1EByG-3_ow(TR-Y^z+YO>VQ&bZL`s`=1@_TJh#dWg9 zIfY|L-r6ah1t2u|#p$dOR8(A|)$7{t{ZB?RRfeTTJ>9i4elblNy-5)!ZGv6C*={U1 z^ryUh7I>mr_Qh^80h_V^Tg8j+TGHyzxmm;Q3|p~G5mT^RTZLjQd$j1yv|(T=N^p%O zc8uqvH^Tnowi(c|qM|6;nl=qQ$Bd7CI{U!k3H!j6lkEe4X0m2U)0N#n3EOB*&*~j=HIcO zzKl)Tp)JT3+k6Tl^6QjVJdcE3(G0sPr?E5@vo<|R6NVqOI(UwcW1 z0@wa8c-(MJ!3|zJ%kEKgxY^oiZkShJTQpQ1uSMi<{CAMXSJWJ+Y|cAtFmZY2IYX29 ztw6rH!0f{wOSRn=;1G6X?O19MiVMRZBE_-EnojgV^BFp8VmHma?3b>ve@3E^Fguk3u#}!rmY=MZ_X8n zlmTK^8Kh%Wg1c?6u{x@<&@3dZx$_4U)9Sn?jUE6>nq9^5Z>jU5s2?RM9V#5jQ9GAF z#nyPQjDJm&<7}j5<0V^t*OFAFZ`1QofUkxwU*I|d(;B2)6S9aJBTIBi4 zQk$hKSDX=F9klvhp`i?pn)^r-KU|hs(-B8saA48W4$q=%I^xrKy&StFag+uJ!i%_0 zekF!E7$9zlh8OZFGaUmMh9aoIxeu8D`Z&~rJ`S31WWI*Xl|!4)0HOo&1^%^7OPsAr zCG9HF?s;pGKVz(Mqu06K&COU8(v}Pr!9EuU_@ChBV9(|iS5QeXI?KQYsS4KrP1j#Z zN*grt@PcM+>^b-52AtPM-=_j0OPv7vw6XUuy0$;uId8A^wb#_o?SohgD?)cWE54YM zd&FMl6Vi}gVbP0h3dKvrsAzQ#H@Qu{P2`*zHy1U!!Ya?ANDJm?HeCt*=%$cO4G*>q zmE3;HJ>}%}XV%C`Xc6aaGZ|MB-mLQR_w4+V8gxe?KmK)-$+S7T5Q8JQVzUp#UdbG3 zG=3P-x{I8-v+4WV*B|~Lkg?V9EVf3{9BMZEOGvqmeLo!}paK*!%+mNfR4mNWIMGOj z&_oRC$;%_1ZSszSQX#f@pn7wf?FR&n&b>(enEGabS!!5~f`e`09uV@kYTl=bYJEE$5ph|@Y4u3?M;M@%2>4@pd31$UAaFB z>E7bJHuwLk50fNBOBgw0dd1J+2B<2-#-V96J5h7a>Z|a+{T=m!?bi5Y)P+mZ=U3Li zTiVVCdy1!NOxm|=t$`LVN}G>oXsuTMoJ}|HaS86NZw|HD?atFo7)poQCHK}>dH!%`K-LoXT_wOYYl9?Cb2j_zG>l}##O-M8o~%{X^yvd zjx-u2I}FM&=|it&$1~$-Yr0>rWVbEhwnYle;_V@)z&)%TtCzlIbw-Mac<^q@vm3ph zKiR9BW5YSJmQ%fk<(nU0y%hA=Ww$T1chkLqb^oyE$;ukvrq!$@E%+z!0SQZ4dc zvsC~qo2lg291VC~Zj@ko0e(r~efWG*8t4tUYl0h8d%S=6cM0@?3U5A3baa>#4C!0# z!?9P7Z#n!BS<-^U-p~Vlwb&~$jls&QTf>QyzQU^Wvm1>VyDKEX9~@S0#U9T$`lc*6 zA+!Gk=;?c2bLTdwsy64lA%me5bvsczuDBXpE_mQr;P0p)C0t7)tbzK_9L`T)y};eO zWUUuf1*>nlTVSxc^G;LXWfYjwW3c)zA+m!`2OnP4Fu7c~5PcF4SOW_~pE5;z_AY62 zK5=T{AF`<_O-N}zRirf6!VysU;|=&FY1*9K2Coc4rD@*VV#fpBMOtG*V9pd4EHO|L zeo3j9+qauBL_!(-Jh=CFD~Fx0nf$0Dcsrm6DpTiY{09+EAbZTiz8)&-s5}v=O?ayl z-aaj{%y7_YoSZfKOq=tMG|?E1Rh=i-_duCjAB_w;cYTtsYz`J}4k2xB^Bi|ps&BwH zz0=m%d&LwMJ)F4)o?LgkZm63Jt6Z7jGj@wVgWdJ^Le5O6ae^VL31w#eE|mdLmpQk< zs-@E$vi)%b7n-npNk=6C(}}H2>3^Po%81S(#ae%x^I^d$5g*WHvgWq|Sx&RTg8Q)* zV2b|PD{b+BQ~A-rJHE#_#lk_Kv-uMeLmN!({Ht2QG>V_-AHAA_A8u|Cssb{a`AWlE z?x~F%Ba&_|ZSH)?z}rC$qKK(9K_w z(O%v4Qv(R6K*7Bixlq6)-Pq=wf8Hs>>{A!rvwU->4~nGC`2#R^QZHYnSxm)^*1+wd zd+81URcH;kd?QApz_Zutg_J;uN-7K}9OniBbN%SKr_^;PX&BD>=FUP>QU9qG-K2`R z&y4PFTsF5=>6YIBb+@vKG$ryfJwwfH)L7-LKDF#>mF+Tz()}npwfF+ks1M(D`v5tB ze^=hsesP9P`^(1L|6U5ajIaLxAr0-XO1J+h0Pv)NN>SD5FI({sw5?5UfAvKBtDS#7 zwd@|Z?3>e#Uw>-Zt4W~7>nJM}tj2FkHNKL%OykSP8-K~E70h)jSeS17^iwPNkV4q( zswuMvY|0lzWWCSo6APD~G;?YzWLjT6=agxElB5j1&Ku30-2lrZrd<`*LjO-Bg>AxJ{3UpEF3O za~8^gVDIF15##O7GgUG_i{c|+`sX}K00RqWGBB}IpHkuNsS3?D%z!^eMw5j7YC|e6 zMP$ovq&jC#diH8HtKlQf+SKXvf~&@x)#7|!&B9>zc(XzTs7YHjnfjN~oD(BR7PyeH zCrc9>(dqcATaxGnDfhN@HUnJkPD_CbK;~@qZ6(+mn6X2oDFiAY&J5>uRQ@zFrK56h zbY2H6sysuNK4K`=`rQ>_Z`U~_h+;GayultLggUURZ3Of#aulUHNf zY`By55o`PLp*MZjz~vACwb?~)TLWjpn<#p(^2o-s2+b;bx~B33zUylJ*8R_Vu%@~k zyWLILe3H@_C1OvIA_I~sE>n@_5-3(JDzObcu+a<1UYCuV_wDCkms$-c31vtqogT8`z`DKF>YymnvXytuh72C zpYSgk->42OP?GlBWPr+BJ{7-+2sxEv1Jl{yCq}%`NC8xcspJ#d-b|DM@~T%`xAxO>W-^G#)4rBT|t$$!?#C z+K`G0`xI9fd(vNNO1t?H2{cwEO;N4RWvOIaO|7I{o*WqD(dvAbnB=Csk*)gFzgDNf z1m%x3=DFW~^Bv@1?0&zGJSI6H`a5+fX>~?TkO=e%3)`*E&j^h@Q8HnEJ7JdA%8JI$ z=&WX^cQ$Ci81RNfj5l_s?EuUEq?7}VhqRE^U9hdS-T5-jF{>-Gf%{-gXyTu=P}^Ia z?>~{Hn5vveHK)T6A=f^w5Fa6UyNJvpWYY`jkOCGYPo< zw8yL&_cZSx7MJNenxnHiKrSRY!3ZdkW+a`+eq8+*r5Yxw{Syrk8GFn5LOgwK#8-8h z)pw!38Z)al^4Vhbon=0=s;=jAF~t{DLOUzk3!V#ke?-*4f|&1J|hHm=-ea9a~4l9L$n40H94UZtKfo_bL#^`6tE zp2blmPgfXt=Icts*bMg`0^Jh&M4^ryI#0_?T&f)$5uNH643{cB2WE{LRPASZ1ni63 zoJ%aA?6zkp0)TM2Ew0D;V=tPo0&CZ8hl%~O?3QPQ|NVyD;z|SZ>=u~YKAgU-mw$l& zjoIQ!@menW2(QI$Qt3XA@%a3xI4+g@t%j!~d1;sJbviWMIrLkv=Psc#rXXPLs>`-^ zE%13T(Yw&v<*|0PWEJf<%*2j(CL_3Jca7U;u-nd2$09Wwv zni(r3*t`T4<4&S!*McmUnU-reE;PXf?zDRhED*wt^yh2L?m59p$)=(9riIr1o0hh< zJ73aC95Ja+vePjJCArbukZW{o`g>f+HY!T`Q#qrG|= z*rOUdliNLs<(W{0FSj0e-7^?_rFGhV?n=K>Y79Y^4!x2!?J0W*N3mSd%N^QQm(&$B z-7A$YQGp#-c``;`I&_aW(l#{eIXE4zFp%T53P6RX>9u8)LKRDqDOnKK6xQ}U^ zm3r!3e{=axZ;(>s@gt$pbw0ndnb9#6O5}{vedSGFm~A!j8Q5uyhjC`G%C!VOA&j69 z_G2-%eRjW4DAaX5#q|rhx}M8-_<0?tW}Y$pq9fuL{r#neUv!djZN#j*zR*iLLICOH?j_R~}fxV1*J7JVDoz4+xPb9~k7f-Pt)? z<0k`)`64W}VaRSz0cy_wmIt`K$l%g;b~UT-19G(5V_SZQ8ha9768uK|TRs4lW>|eM z5!r@4l}Ju!Ay|2AO6MPcAgcAB%*__*2n1DzgvwZ?w1!NsIjdKS}%v6ehMGYHn$F9`ULVsVbsZCBh+ve($8vy2PR~x2e$!mJoZ}NwMc9 z!u86t!3~AIxQc!cTLJ2rnaLx>-IMxsa2gWR<6W3$8$#bPRwWEL!ZOscH1rx;|B|)7 zlZU-=mKk=9h-kL8zINx2xdvO1+^b-T^#QAP=P|#+z4nXt7+mXMd+c|NvC~HA*c9iV zQ;|p7onGz|lFpqMt506wc65Tbm9%|*7yL`?#x;q5Hir=)kVcq`{K4k6!Q_Bh2Pr~zJN=HC zbzoE@uX4EtxGQw-q_O6Xx!XpoZ$5Fy_891&K90Z0I~;pW9$P{!EP)q+eU`vuJX)Ra zvbDPKY04Id#2T1w4b)|IuqkhK_)-mL8avEg5FyV*!Rlv>gle<2tQ%^?)w2YKJHqGj&e2N0Ix~6x)$jtAaix`1V zRM$MaJCNQfGtN&qf?{cyjez4(Hsx9a`-+YiJ=Iu)g>!=OA9N`LvVc30KsVAUNnuTw zM0V<&qjIbP1d`7e?N|Re$RR6Y;3#ph=zwRxZ0dTO*{9GL#~ep>rmXVgfj}13j0tzF z4QO-@Ff!2`V|i$7R;{^4ZVl|N+$spR>JHf75d0D18MFf4Ap=|HRs`!b6BV#5&|R7H zDJfpTZkD_u5WmTsoO>8&GgPe8j>@|1P0Or-(vHfFS)1xp^f26?P(~|Y|Myc3ls>~l ztZ6lj^~Ib-z4p+U4wi#BPy;zLjT^JNN2sNwnh`POcHh(Lypu!yObxk!6E04l)@=YO zeBkW=5T3(*1_ngUz*2bLWjjE4ed|D8rBATH_U3 zJD6w+we3__JBs#n#2McD&=m7pgVmGzP`3MyD5*Y_HSBg|8qS$3_?m1Z3XXk267 zSjiCF9NF@k`fdgwavt}u2#i+W<8^aIa-9pIv0=@Reag8z^_D*#o8zpTZl>u^JS3z| zxqq0xYITaTVC8Yb!uaO*@4fflV{34a_qqqQjGuxp+^;OwhOvju;lKB3I^m+ty;kF1 zq`;u?P~7;RPu%63~LwWsc?sN?4W$~!5}9*o*fToH^y*mV~XthvB?xE zNIs~lDY?LT1~QUvkC?`&TmULW?}0b}utq^=ck_|nuZ;coLPH%CBiqs=}Q7d)-PK_BQ7()?9BVVwOv}s%GyodDzj{YW(cIPNajRDhG zX!jMGt&=V>dsx?gsLdd|S%E!Vv?t*mq^lnr2W66D)ddqup2&GSARiF&5`PS6q%Ur9 zk?9O#poO^6FHx>L3}$D2fIXj$u)=KJKBM-bwi?keyQ#J~>O+tCV7DnlQ#q=uP-4Gm zC^9Qwv>IPDCA!)Wzebkh_Ct0?RM-*nw9usQWv63I4-XOyq~uE(V)8(?I%9=On9lwq zr9)4X!`&89w&FSbgBun~+~_MBqK{>X8@%KEFgyG{Be?Bu(x9)g)d(7>$55d{Wd+WK zW^(-T#^a`m(IqM$pB~=N^<2Vz7H{N&zQG&6B>P~H6q7T)ZCd7!=eYSkK9&{FX<(K_ zAH%-u>eVH1WVQc6c&9 zXIMpL+(~Y0@7xAm+e#k8sIq2K)JTI_$*$R!xo=1$Mzh~KbZ zE{k}pu8m$m4hE46fo|N?UD5`rx;{E(*Bz9uO?Ic^(V6G9^V_P?`7WhXwwO;nc&Uh- z&GCkkYbo)IXdXYC^{8}B;@omrVYKb}?fjm}dChpvPnnzrc9X9^le?v}s}@Bpfpyh- zt3j@ugVe}x=R+o6;Yac{`}(uS^RdM!-%~7KS#seQeg37`4Br=-jbW~|GL7Oxd^2Q) z^hsJ&vl9z4`#p6=*XCd??Je~DjObz$og{j3W`9nji9S)wXcT*1AiBgvAC1Um)g9;u znE1DAX?BU{7i@aLhyR-aAYq=Kr)hx!aJfu!c1k{UgcSlLFk~EhqKh%EQ-3EH7w!x( z#ATJy{D^l?b}%ee=1Y+UkeHTFiM{8Eo&jq(8L@h*N`g`E9&gE~t6}%P?KxH#d(YeT z$R6XWN7|ib+V7!F&zF6OgyjyZe?XV4B*qTubj23t7F zRxpIO7)!;pW|&jK7v426kxu*^iS2*XK8!b(=Oc6N+Xi_z`_Gngp-iiHlz^0yG&@r4L!pJiFDdkZs<2KsXQrd6QP_^&+1f_ z6t&^x3N9cT_4e4_Sv@;PXbv~ceKJVm<=N)MV9-D+rE7Sf4WRQ0z!81K+=Q9S3 z3$-aP;X+cY^K0f)T?nU1iYLi7Hsis}(Tmu3Qr0DG<2xA3Gr&Qp8AUtnzG#&>gGSQg zhe*_39N!$Y`ufOke|8?0qZUp*mJ%`lS1I(wnh4RbWGGXv&Vi#;x_S zQRByU+?Vf13LiTYP|o{y!r!1S?PzOlZ9O)c(#SI6E$CGHxz3kWe@EOq(^)WH`DZ{R zZeMnLr(|rNI@0Jhy_wUw=*-NF&J14;##C?5J45z+B-fpZPnFn^K-M#$$!l@K=#4C0#0D ztJmC+xWXGd5wO12OEBC&yoODQ9iQ4geTTM62(MZUCVI_wj@~k~7jv>hLUpjJd(tvT zYSq6~1*1fl1SOr<))_PnxjpH^6U$0z{##vc@fsTU-L7A%_lWd+2Gt$lI#HWsFmB*R z#DUT`ik>SyiVe|7vmib;Sm4UDnvPWZy3eozO|L#qeOTzI{-ZUsiNESs?dHR_PsY`y z`cU*#Mbi;$tGqf;VHlR^V4&!^%PQaQdJJMLw~?ysrz($k{R7067#E?$)$;X8YqkxN z2gsnp>I{2{uksh0^5x;NqQ<|;YK#qW!?z0;9RA8Z-It8eFOg}?f5@eo4b5|&t9FE% z5R|%#)4%lWDvzN(0af7eh6Td;Y9=0C9CkCH^1@mEeg6Vu_TjAU-cam*8L9Q9? zjP#jQoo7ES0z&PrsEFhvm<&|z?)oEJQ%D8{m%D1(G8z%^4AP@S*)SeiD))Dvp(Hy+ ztIEKbn`}8c-YkZ5JSo76vR_ipBHwDmJuR>oc~@caH^mq={MB67YKdK4CX4-B?w~wZ z+uY@s$`&RTR5t|d&OG_pge-5793-#3QlbZ0HeInI_XN#UrdEeZPOHS{{Xu=C!&z2rV|1)o+{1)WX zh@V4D{XCkf^wmEyxlFYQ1_mQm%(Z4q5$0l?e?-NP~ZO)wvl}J_*`q$>fO;B1S z+va@5e5XaS=mVO9RB=iq+vcX>O(yzH2~cZ z&!|yA`xQHPfRqf~%>Dt6cJ(8z!YS2{7|X^1u^Eb+TiQfympku#oSs8v%UHU<=fnfi zV7v3{ljNyl3Km0m-RBqGRWht1E6|SwUYnq}0&z2XeS@3NXSBg96!1@}0$f>Zx`1`5 z0%D7Ov)sD^?2YQCjz9PCjBReph+N(?f7^~+jM~;DyH|AT)%m(H-=b~p(>6jsuP5A$ zJCqx}nYeDNh65Fu1Lb}NXM(>$BwGgs|D`Bb0DN9nz*1A@qMrF8dNLvnDpRk{yzw$W zH(n;2rb-Kfhy6>qyY~y`L$GCbYMi22eKquGEGH#qZ+Ct^(;Yl93C&P{l6X5@Qk}Y7 z5N{N9A&+JJiZwU+?pL?!&_fxd>#>0hn zxY$jQ3u)k{nSDx{Vq#!>6n1!qI^rJF?Q47Hi$cnXT%&I5)u}`NU^cSI!trj`+D-n% z77^GA# zUt)kwP-D9dH74a2LyIl&10QvUR->yInXVT1%olx@5jjW2>(zM_HoectvbKU8lW9Is1>)VE+6gC5)8VkyKf{b+OBH~h|>(yELzm(4DEE04}pXHW5EnT`Z zHuZ5s>t&U`!L2OlyH5fBA$uwpSUT9w4T&cb?(qX@5^sU*@8?08i_CjNWZsjIdD_{& zLmETovGW(Q3gjU*zQC94F0ogYL*a1F_{AKvBnqK%;s(WPP5g?p0w>>Ze3QwkXe;Ud zJXbL9u)iS;j3YJg0o$bPh%epmwLO*LP;^@C-6U6~zNHMcvEfi|^GtmM;=GlK$=De#@cEomPAx(X?bRTxa_Qm#PQc>?Osqm2vKq?!x%oFK)_(tma3$cv&U}b3=Dq98);)9 zX5boEtXypyiw3L2%vhEx@)Y`Hl0J-XAc;zF3JJVRQypLm~bHqFyUfz-$>dofA+@Fv$}B<8T$*{Jn62Hh636G`Ax_W zIwkFxj6qY{{+60<4P1RqWn-WVD@17{?V({9PCk395WrYwlN@T-mLtO2W(5{*3y93| zcUT)=nPVU4*E2SoUoW;D#F*g~$wGLAwTsfNT}$yaGQiD~_@XuOwocs;TNIQ^ zOSo_(Y*b^0UdfKPg%WL;Ow$b_E=?|4Xp$A!-*EeRSvKEGu5@1JltUYItBli1Xm}cp zn91LT{CzC-)VuyZ!Cz|pylpPrunXN}&|8#26nXPEc-@S2f)SgY&%43}0+)^NLW}Gs zug-%P>Bl%XtpfZ599wi20++>WPy#Wh9Kt}>9|>bLCc?}loun&b+BdE*B6N|~7ZH|o zk36g+@5?O1(T!ZaAcN~q8RUpjsGGr%@a0M3Cq0+@mZCRx+% z5iJEa&f%8qGF_J{@VwpT41V0OANP3A&Y+mg#$_58d^k@w>L`AI*oj8*O7a_nJQy>3 z6^upBRL;AuW`TBqZ_x_7eCYRH&t|S1d$ne2^&^jcR^Lw;HmVLe`4D?z#WjjeT3{yA zKWt*|BFRT%Hu+nedTGLeTbO?sKo=f> zdBu2R`+lItu3FQoUIf901x`siGWr#J(K^N$Lpt4^x~sWFbnEBTgw%NE#TRulo~`yO zH=XWl2epeHbnZ_kh~wAj#ncn0KvQObIVXOJG+e^C2jsVTCMTwMs5x5#9_2%&+64J z1@m&Z`x3RNtI%mn%@eLI)?v{(r?dJe5_7G--T)Mx`B;BrPE|1SX_)#KROLp_t(qSB zWYyHjCt87=WcNaR!#`+5Vp0z=eU_`rZrp|hNVMz4W8OL!slC+#+%(n1iRqV`(7m-7L*1eZX8$UZH( znVi(PNrW=0TUl$Tb?!Bd*}6X6uM7Gcr=6xTT-i5`DV%5wJ^62w`SQt`PuG)l=Hf}2 zbIf_K-I+d~nPJd~o^BWz?>shV7H1ywqT^_u84u2a8zS?nnj>G}JUEwg;aOE*V(jXo z#`fn*4Ez-YN$(CGxq>DrFdjs_kB^l^rB|u;Bd=E8KN8XJ>xDqNoi{Y@OOyQvdro{h z>g!*YnUYjzT05V%8jct}i`Z{+N(X=Tinaaep;1ro-}*plktXb$%zyfsXZ*KR;4C_9 zZU5VC4{|d1_awZR6F?S|Rk>!2=ZgMR$BaI7)T{=s{TlxfCxx7>L6>gto#XA5r3FMJ zrEl~fY)?1Xu=a3FZW?^t)Qa748h|oq>CvCP(tC$#aP6Z{15X{5f4HR-XQw7vqqTjT zX|;E|XRw1iPup{>fw%ER>Sj)7jXpItWv5OQ)~-Dek^_UQVO;mU0sCg(O4E;Yt6lrc zY*lOe&xSf(MT`FI_|<9rzWtr=e0<~QNH%Hw`p-5ah}d{y1SiHl`ZV`1R>k%v#T@#G zePwMcept?%`sY&r4Ge=j96MDS!_oG$S4xkj#$#dYp?i>OyDU6cqJqCL;pmbKbzNzcyAl!E6QN^z+FMUHP!p$nIVtrZn=TiDT zy4Uh;k|a0gk7zNX1R3XZq|R`r63askVEfATWnI6pSJjukQL(6)8wh{ z`bDz4yxpl#((d{Z*SvJQa{=Fp@P?6ay{WI+*#;}sUe&24=2xs=*L|ic@Tf%7qQvq5 zjqp{jU)S{-`&+x?ph;wU)2RZ`?U+QR#121k<>+z|UJb99~kRl(+({+w;~q1i~kXCnQcUUeBqJS>7;Yd;yi z4Dij95e#nh82R|rs_S=13Lc%Z;|^6KFAC4vPf}TdePrw+`$PNZcy8vv!(WiAut&zu zOw=_c7ObE%LEJuzL_VT^$RLg>9HMby&-`zz50Sd$=ZqNL`D13f-DNHTS=Wq_0&(U- z=F}Vc#JEg-wv2M@GD3B=jUN<*{41;MUeNUjq1y z$Q2YGq;P#X^TrEL@tSCPv1$2vb~6{mBXj$6F<NMD>1(x>mAq)cy!*`>BXIfa_9gor6|W+KX>?w~FG)e?~aH%MU5r6vUS z#R%-HfWq?18zu?tzdpky1pZfnJ!R&lg!bF_7@@tKVJ?(dg>&wPqaLtNby{w)#Nb={ z=T-j@BI+u5H@m>wIOy3k#q;)-6Hp>^qf>WO6Tb>01W1&8x)PS0+s&53gD&AA>*BU0 zD9hnJqaPfI4vS0n)1Rl~o4m@$u?fOn@*Hy~a6|_diJjJS9fXelHEX)Gbf2tdUcx7P zOOF!R-XHb{Ft?8NBlEp2uOd;M*&nFseLngJyEM^|i3`d)-^N_VFn^o3qQ)-8YDAau z9la&l%YKf!gSP^EjqzNK0L?J>>U8$ezu4jO3H(x~mQ@?|g=W`$XLI~IU&VD^3`TiI zGE^GRYH#|*mwxf5UjlkTF?E^CjzZ(d>V1u!LlO=-HtxBU0NI)Yi=h^Qv3=k{KX^Mg z{c|x3i>a)!swiraKAOwyNbM_Q3?Gbx7*!0h4SM!lJ3&FX?y+{}THhbqmW$(v-3-FA z(xhjP{jBhYXj}B5W9O;9xjNs`fC?HQn~-M3o_mM2b8l+b986OT6zmQ4?T3;IXG$66 ze{^4G0g}?_mrCEL)(xV{q3&k;#DTYBBU3ylQUH?kcs0e3l~W$ z7kF&+JJ*3=A%Zzb<;Oj`>LFDLoZjj6FB2(CF^{q$(KVV z=VwGdn;Ne_-~LDd;14TL^p|6(ykvwck9GT*k!X&g4`ClB-EpEyT%W%JOxx6XAmOd3 ztn+rwspc&AD_#C|v?08KA1B3vL@a>7dxzRcqZG)ePRtqhlL9f}6Bb&|AGFZQbv~~j zzw1W$Tkp8xY4~$*$4UX!*Sxm6oypEqSx%NK(nj!%gpA`s7YUH`zfg-8N&M0K zV_sulDey(mysq)09vj3saZCr>Z!1w-F!t55j7_<*uU2PRxAhU!VhyYcv|0n}{qUKs zT~8N5Q`UMb_eQdde$^4b+KZ86O!8pL8tC0z}JlktlyQ$kA#Ct#%5J!hs(e)vy0j*O85UqrObi%k zXyUBRu~&(cQLgs5Cs$WbwZOUSn)E^M3XWTe#iu)Qm1=5k1R{FR;B*vwBZnmoPZQpL zP3+0ztxMGTHlw*A)u*!2w_t-F%??_9zo9y8;ca_ZN9D3~P424eZ=Ay6E)TpD;Ee0% zjO)Wrci+E|rL{c~F6_L6T+Pn2MlZ_{F@m6PQZ$TExqx~C1u8KoyzvDkuJ&<96`pU0 zUiVf$)$NP7l-N(j+q?)ekja!(Q|uP5;%3au=$g(*l!=BO{TST=a?9ZSCO4KKmR9%m1yy1i z@QCvNBl$Z6jott?Z!Al0EO$QB&dvS$P&KP2cHW008P~k;35?!FYpLc=Q_bO3>1sHd zpKiKlZ8`5!6udagQboq-Uy=D}b~Og_HWwtL)6HCZnaj&m=+w^dnL@vnF4XEfOs4+E zsi&Kq14Oxfa4#_HO2;DKKEh&Nkb^9riTa`?vA>zkR=!U7&J**IP}AMTNwZoVmi4Y;cKF zh)NwBXMyHlvMMv8S{0*B^vX;rgIHGGyrjjs9jo1<4z!?5JI*CZY({l@GI7rEfEk0o zUzr+Mt8cTmt481H#y}d!45wS=PgLar`ZXD3&ocUc;~@JRpe_ZnKQfwL;LC!<=7QMq zMN#^G1h_IQfAkcC;ZPR{M!<>nQ{sl&W~qe zXAIu%*!6CEQZN!(VlSwwSWrD)MSY^iJ6=Uzx{CT#75nIDtggyy*Hw!TUsq2RZsB#+ z6rQZB9<$OA^VjdHeLg$;+*^~$OH*Joy@%n9XOG^`OxkmLpTE&e>voOt->7WC@3isK z$EMnKWu~I?MDey`yE9nKR&O5D1KNHaZJNrxU1uPh-F6MdZIPL~p7@;67L~p7cp~pC z>;8k7qD6uU;ZovR`A3rW>h>cX#?<+LVYzM?KmyhCB3%H(4$x`75N3{qpONx@5Bp&L z;LF~uEn3qgC=OhPZLlgwr z9E6HW;CB-QRK_ib)7fTNSGa|tzmN`Hw4ZTgh$wDG6bh`tp)Ieu6c~y&sexr3y=Dft z*%|o}M9Tm~i@&3?;nhfPYLwxeGWA-UE|%E?5DU$Y!fX`h< zW08!|%=ew5Kd}Kc{E@c1J3#b&+6=OQmF|OhW;V=*E}G7$SCnZZQ8{MU1Y@;0J17El zmBLe#d-x3Y*2Nb}AL(3UO15hW3p(rv#wvR0A*8yGh3+OHW`$qWkO;FlL3Vqy7+qgG z{f*O42b5yZ+gyry%#;N^SyZvADRN%DeDR2BC6s1vTBH{Z+gCu&)*!hn ze-cP4> zCB)}X=}PF;ao+l~HP49GVEb4#&-h5q2Vk6~YF06-dGq9&lj?YVC=mN{##sqCYZ{jo^*5d&XGlLKTF#DSOG<8D#O9XU7uj8x8<_iejtg)8bv%2m zOG%vrH98k+^em{+k0Eg>!j}6zj1k_Mx8+wikNy?8%U9>{8SxO1iftafjPU-s_A&a& zvd${~~ia0})Ve|EkPz|1f$Mht(O*h2~5?Ou@0i4KP^meKR$BDF?e5vEwaW z7CS^BHh75d3?mNO}b&)w@kurEOw1ESm8>0=Auyk1EKv zv+Z(04%Y>Mk5KHmh^|$>u`|tHV$T?-xxy~Z#o7QQ@|qL)APF`*17Kk45z*V+u6g>! zE7}zb##RFAsvXxiM>ftf`XY-m!#yX0kz+krWqzmUl20YtGOdPRRPNt+hS4tuM>I)~ zB^ddWQXJ_i|5VgNU}`k4G{tW+#p7|*zCHA9HD6l0VkVvQswZR16IyX;e$tl1L56=~ z{pltGjVj?`)}LPNU$xl}nIJ90dP10|e8_ln@Z~8H5au`$%tdlsJDhnbFv0$JOB%|q z><^!g;I6bAQ|F^)s%x=1;9kLNBAlbs6719L1mk(#@mA!Y#lO+W`Rya4gAk%ebC464 zDckCDsBtffnr#x#I#bfMT75G0*B?GDMSg^4Gfx3mrxF91e7B4=26<#S7l98r0~$>u zx{FMqPu8C8#pUtFV7zG!(AU!JJSN=|bj^M6PyE8`tdrvo4{X|WkqCKyl(uWvja*!-?dATWsws9PxedG|S6C~r@ zoWSc72<^2|w>)GCR_{fWC5Qublb>sGo_YhQWttdEv%0XtUmprpH@CGomnur&pfghn zo=<3hM5z~v$(zWj?Aba=yvke8JPss>6jZlHJTsWC;*b_{`JyqDxFJ&zURRL5-S;dZ z?qzK&_8(+wyOQ>nH9P)e9&_WnO3K?MoxSXQ;A1s^VW?bCTflAXDhRNU75%(jQ*7;I zTX{To{L`Dxx3>2ztoH`cUaI0TQfGwUsKC_~2;WIr)rh<4U7?5u?0P@PdIS|{Rey?Z z#jLE+GkG$3B?ca^Uo;MnI%)NXPdj-hDE(+o7V!8Z-bPW|hq47EQ+aQ$u*sUc~qBpuw`2{u%P6e#f*a>fUKGXNGkGf&(T@$l( z6*DkuF2^?pV<)n@^B!gen8>NRwHX-wJS~Ww$m~AjVS0N~uCs_S_7Wx+m8}L-1&@;w zzsYxs;nn8UVbI#F-RN2UVKKW-)nq`IYHW(RfFi^tX&cyyL3@z5(SPGdt0_ghHJ(hn zm8EF6ZwPYl3@xM~Ku1+eiiFz~bUuH`9ps>k)}w81VTK$tg-wuS>B4F$OvY-en~fp| zrqi9bewiu-7}GA0AA2_GQesH=NiO4>#TpDQ!I=Fy_CMO6wIdHBtKV1S4Lr}^A^u+B zFT<1mm+A3jrQau>C&#Dx)i^L>l4K5RUC3v57to_Z0?K3*i@n=tP;dhiN88084e12Y z+^JtSuM+3X*9FvmbB|tpZ9#Mkg#;1)93_1~(}+3;K~-it_B3b*b)98*=_5 zI(Nb@5Q%URBT-zmr#a#MjBa38JNG;XTEIt?NG@}07;6LnA9rs9A7yps{m*13WPpKt zkda1BCF-cri5gAX1}D`7@}{B&frM5Bw(GLgQfpxbQF$4dyiIOK*a~z_g3}kcH;q{*iOp>DSq3O zhl)*ufK7N%PE$A(6ih>(U`dUN#EjY=c^Uzfj=;! zYUd92hzV3L^Wt@*4}_j1AANSMH~}w$yZ%#p5A1W&fP~U_rxaP#GJomft0~Qg&?K?D zU{1RJQV7FtvCni+^Jw27s$`CkUHda{i>?BG@qfrFF((zGhZL*e8DzO;{b4#L>tyQ3 zKUilRmnJKc&ECOU5k6N=D*=6%(aMdKui`nc@Mb@m{tac*z`;gQLtKxTHXg12p!3OQ zqcP}z;yx1DUw{pu4`tU6UsSOZ7pKg@2xtX&-m%X)>TR`GdhwcBuy%ZF`qdeb)*ar~ zoRyCBLf(zs9=R=!M*WFlkCoa4ElCU)tbI~vL+eG<#)bQ^Mh7B)nYWf@!%xVc&Kqzp zbcOKhvqU@h6^~T4;h3u4tUglJ6sM}SU~a+Mr#W>mGF2Fr{@u}eFy>P)7N98nUU>6= zuyR(-HY;a<#|=6}*8vI|;{Y=^J^V=}1#~xJD53$VJ<5clY^(hX1fD>!j|21)`Wj0K zxBQ+%y;x|l!ARs=2OCQH>Pml(=){h|U_(f+_TXScnF69dvNr-ks!uP3drEM8Zh)u& zhzgAsK&(6h#9ci^cQ?3(UI*uIkfj%sP-|JsT(ZqwByg%L9*X1> zmjPK>u7~d)mH1&LUIUMkU3U%s4OV)u&g0hRPpSSRxaD%*nI>oEhMTLl1#9=nY|DK# zIp3!*J@52sM|S-~qfoW(nBu-q2jx*Uk3SFR@#jAb{(v|8O)l_e3PufvgRuuIvqOIm z16R49t2EGJ`{t3k@UrRgBk;D2QNiEjD_D@P;8s=8`>MgsPu*MxZmw}~a~Y40{jm$$ z(rp(3=`dZvnf#fl1@25IbMs?u>DMnf5IMjKl zJbusRw9ng?Tvw8w{ok5}Xc5ceL9q*8!qC-`6zTK$oNO#61^6m$nbVSs0?@M8xBcg@ zWKBqh5v@SstBA(oz31>4dczcC9)siCh%%%D%eG>7HN->QQN8KV|Vk=B5f z(uFi^wQz3XoZfnN3e-~8msa-foIo--?*SHoGA?9 zXJQW9Kk5U>S}G~&*uUCqU*b7zk27M8tGu3Fkh|U7GE4e5>tv>UGbauB0`hvs%}1B; z+c*}0s=053F_li-XL8mak6u9N1}`fa@_LwiYI9bNBRy``m$nV-Ob^-XN@CU7Pqw93 zy$qPEf{yNDTl(+KYjMt=1o+E4U7QoJ=9UV17jf=4vomc;S901mMtw%NhcWZX-0Mmo zDi+~ZIk_xJ7mxu&M*iW8JZ&Z3r-ysoHP>40|4m3v(D&Q_4vQiKD<{RPYhpf(RS(Ikey+6NAuJookcrk@5)0Hto?hv# zc1M>!Au5+yf&*^1;{G16N~3d-I$nwN@iJtF4K@B~9n#28*IW>tQBxNEM9n$T3u|hk z=i#jToSJK+XVzSYdiib9kJqe?o>X&Y^hAnT@o3~}tgmcY{DDLZl>1yl|sAneAkM@o7!xN1BbmcWY?&QR_ znlh{XC!_+T&jC(de8vUls-0pUO44=LODDl8tl zgjD&C%RLjXmTDyv+LsN=I9FB$aEItSG@G1Il~Rw@@vq{?$AJ(!4-eEKhZPs4oEm_N zHtdhW)&}gu$;l~iBKM7@7kTV1d@_@JzT@w_MYq1I08R^eg`Vk?)D}9}3=gG8c3O!E z~ zmYFw{)so{@QKULk{M)9WGZ_MS&b$jNl+RQ1Yrd)Sl^1UP7 z9f%43GRWBknrfING!^0KljD&5l+&?DR;S{!qOq2Iz#^>uW9P57|v)}4Fc^~KK~${BSroHS($$LQ{B(YYxdnH|#CTap(p*M}C8 zXgNEhT0^8)YtW-Q%BdngI;VwD1v`*x$j`j=chsfxLQ8}_NQ7hyRc2V>zJO*PEz-tW zg6IGPU!!T2I9L?B1SrdD?HTr$eMvW0(BSatpM~%lb5$M{I5>5^Ct01m$%pzc1sYjL z>Xw5UF2s6b7u)XvKsowt?S~n_+ACCtk@Kq}ID}Im0nVDgkhOi!Pek^YNNo(eQxu2! zG3|wmQ{K(wtTk8gD&~4tORgJiN&km4M2Yt?75&eYpAG%+XKh}YX~I;LC-U6N#`uhA ztS)|wdqpe~zoj4+`$YWWzl&AqYPo4K2}xXGZMm$Ni)L2)Zo0t)bWo8%z*;o)BY+L-|m9aA3kY{|x8CHib(6ktK zfIL#0eKY;c>7#O49T$>!sJn}XCh?#f%h;JVOY0;MenZ*iZSPNX064KA zamX9{~Ux0-G8yN6G?I$!PF}K>t?W}a8^9^K> z&Xut!@DydsI3m)`eZOUI41)0$t6DBVyM>RYpO#=@l5$GuoPWdxNn%GZG3>QA?d3ap z7pBkSq?f?;SXDaR2`)$Aou1}|qsb;;dII4D;{PW9&{=8^O_h!)e#vNW$}2&ZF=XSN zL$j;XnSIUX#Huz7|AWGm9==%vxiovrC6X}Xd$!l~d9XIywB?OnkM>z>=FH7{wWJEa-)aqLIH|Xx8rehu6n=~DX z#LFMqG)K#Gkt!L=VRlKThEu75Vi{>;%`BJvyyJWp$N?vdt~xec#s*5*lId+1@_?Do(O9=a9raOfw5kj>SLxqjTdS%GnE zzl^+Fz=Gab5o$Eoamyjps9ahu5d$|5(BbrK&|WL&NWCbtqn~+d#An0 zv^>|JcfrAI*rEP8vS7#;3%foHQMIMxAhf;M96Z>c%8{N>y60445$OmQ1CfE)ILG%2 zo`cVfSDz6pt(9ldp#6q=1H8XBmt0E+$)nE#PG4>_!62EH$e)d2RAGv$n-BK*@U$0s z&Pwd0$G9g_;)+g=UtAOQsMWcA|YeAl9AFf!k_ za(w*aOE|5BuHrs7c_r@6MsA6l{e|HrPDgc$Nf0zIpP-lM(nZ+U4VV!qF(dH){d9?? z9=VyV0TVBvt-t`F_qYe@Llfa#V?_#Fml@AiV48w!VK9xZ7QJmHq_1N7xZHk8=b?;B zF`I>dQNd>YU~{o@6#|&4aQ0s`^bPA*a3y7Hm)Mz%H$}4@s{!P?-W1#0cg^;8W{{x& zaqVF_*oXYiJ zBg;PgabubDDAxmcD*$sbyYv>qwFdUaB}Y0UNAQ5(ixEL2gaJ%hSzOziQn#E?vTlvj zK72c~eUF}{hT1owRn>Sg%2(4o+wtCYm3P%-Jao3E&$?A>q<@hv93G(!szT+@jjyhE z*$aZvOJz13TXA6QZE_J5OjYgj98BN;?`9D$0Y{SK(qH2Z4Ccl3hXf9H_P*cSU9@=7 z((J5)BU?Gs0<)F#+pPdLa~ckxF0RGC)=cls-pbc9Q;~YOuSq9wp@*S*IKGHA#@7K# zYjAGrvjx#gjE&nfz4i*9u6GxwYIb?vOrPQagE!d#Ou?iPU|?S#XZ{2YZr~! z1ylQ4?VEy}&J>yTXHmae8!K9x9jDIVid7q+p=*D6wE@isXjwqR(D*g!KduHe1X)~q zi{Y+n+)_wQV5!|&VDDl{S$a9fUz*>iB+Uw^Uqx+wiS@M}Ow08y?&rRLaImRX8y6rz z@4|y6t@!$S*W6ek`7&49ZR(k$tKXmbm{a|iRQ*0xkK&U=GRFY{$s1l;{oG0Tpng70 zrRDm$RxkitYEeP-LKY$QwBr@Z^CtbA{^7rwA2WR@?Ys#|j*o0IQWzWQ+_P*<^NBULmSv{T`->%V()<`jKbDGs978(VK9F=gWM-Xr(4iD&whTI#M5CuuZV+TT*^mMN4KwOS&E5-$H|t)Z=Z7udZ|1tAo)C>?XSB>H@IRmkRDu zzx54Iz~TqM5CFnr4Eg2evv)G{xvAi&(Pe!XK_7EI@6XTYM`I&c8~bE@9aXmm+fug{ zM9*M6tw${T8VnMua@FZ@xe7FLPi=yGX|_n(RU=fy%%}MJS`JEIpf}>{>(GCzn>#=C zrQkqQt-IBZxl&jA&2;AK=mJ|fb?j`K=FFzk@^DcAv*nEAOeRWC-CT!t(KjfZw4XKQ z9!JB*1~*+wh|5%$|n>@(0bVs#9n zxRPuPrJ5>|t;NYjCCM90lZ|CuQ=MvUX{zsTJda01cjNgzO^q3tx2D?e#&RBY&X<|y z%dGCk3%akW_|{j!S9{XE!r)|MRr0E8N#61##V}9)Wt-vJZ{RNXBmoP125{gZDhyUT zT&Al9Ys9CEJ?s1(x>AC?tAreOXFadUu7xJtY{EKpvO8y+uq<@goxLVJ+k_uC;dT?A zXTs$syugHOOn9LQUvI)oOn8|I>qbektJ{QsX~LUKxW$B*5N45}$J^33O9s@q+`y?_ zI^n`nn4CP+F4l`=SFuwPzsar&6Mof%b$n)b{?3G}O?aOPJCLSL*n#wA6RzSn)v0zT zyGr@(>72uFcUOpCyK~sY&o*JNsdt_U`%HKN;r!BOhJ?-DKyYL;#uJK@CcM!cvi;TfsB?*&0pw=8hv zm1Cv1>y{@wcaX}iyD8bZ%LJmy&YuuKeQb5ocv&NKYqIla#P!sz>F(U8kEVu?r|$kG zFR4f4{N~_E;u6cNw!P6)x3;@el*>t6nz~#19jQmf$BTb=;2E8MU3aHcLb->S?35;r zy+MMgWM_*BBgQ8@Pho8WJC{2l*}S*oaX#A3HHm}SXoChS*=?{9l45Vxx5TYAE_Bo` zud)03UY=CBi${8jdAwX$*_WIt`vRkqu6Z7A+@JW73US5GLC`2!jlZ&w5Wn`WzM%<~ z&QGlH(e{-<)}yo|lNXFJ=OH$H5VQ5bzEgTpLOFvA0SNaZ`&L$m`y+3(;p+h#!tX@S zG5xW{JKcV^?-gGq*0?|4`%f35EAhkv&^0){NtY~lN8Vqtf7JQ_qT#P)jMn6U$on^O zyziB=p$f5p+?4E+05sJVBm+B?I8iS$iI_eu(c1 zT$XzcNVD)&Y1R0xjz5#{M?odK%N%@UZpY;;*Lwq&<9TSyL~F||H@YaQ`!&J}j#_ymG>ZzUAYySUdMMaA)6d z0{KoDdS5aAyB=Z_kB6j9w^8PS7ZTgwPc2Wm5{IT)T^2FcmW>ZDH=TR09x<Li7N|Wv?R(Le8QxYobW z(~sXnB~dQBz5?>+OHN>8H!JxSgMi!`p6Sb+rg|O3#9;H;_GjNtyyDbAa+A>Dq(MQ` z=^H=KArcaxt@i3yn(~~jsLtiP{3aWf9v^kNvTQy+yx%`Y@Gh(9-{&# z`u~SNg_}e4O*4PfZtw=G`1>t?>MvKJyYT3L1%;kMuUStWetOxf;DpxB^PXkx=f&zDp}E-P+8KjUBs0pJH>PnDrXTURN2cOrp3rZI(PAYWG|o& zGxDT1^b)X=A(;qr+|e=-yE9D|Cg5q=En)?;dz@!mI?=0c^bZ;iQAp~rHOJ_esrcE0 z5PhZSSyaL0ndymb#ZXySY}z8n*%Aa!nowu|m!#UY{dQ*wpXb}>V;xfJky6ygMn>&D zULElix@-TmH7PkN0(?VG-j2 z!yt-j8#D$c1!1bmJ7|3H=w;9dqMXoudhl$^^X5b`(kFZn&iCC$5IP`qLj`q-w> zmu-c_G41K`Vo;ltR#)Av^IWvm~$ynrf7{0hHSoVnC8c;1V8xtZJO?TL#Q?rs`i z+1tH1Z^4kN{1`J79W+OQJ!?$$AM05dno8dBw@hMwOmW5VVZt>Fzg-tfc0EpFyRIzR z)oTLf$*vtHP?79%7{{t)*H27Lb+T)Z3DhLJ#5US>wMoMl7;#H&y<=_{7(UyvcikoU z61~{iLcaMFm}At1U3-es>ld4KY6gv8?~SC_Re&s8)irqqsqb((SvaWp(5QGj7tavr zn5l$kGfy35RJF*&MhS^s=}XDOPA|2X%^o@hR>wACySrZHH)U+k_jGAhWLTy+zP1Ou z?&DqmbQxpM=iha-3y|aSAB9)6$QxWOM;TQO6zxgu2tl{LP)z~R*)vS$weooy^Qg?wigxL?VKsz`Cw|-w`E*N)nK^C4!F^s%SBkcNf$}mZY&f{Q z-Q_x^_slP}V;J5Q7cu#r@{1Sl(uR@{Geg@+LQD;9CdE+n=jk_sg{|th#1m;PX{oP> zZ^ACt9inonu2*qGC;4-WUFXa0v9@qL<%`^*q$_-j&A@Q7B1!R`cf3lZv5UoBL}-rI zGP}MTs|L+>&vI%=-o8%&ZERP#Gp#T?@2!7T>pDd|aOBV<@}0cBS%vf%6uN!3V(!+4 z-C0j)FFMcS)L8_aF{u?p&YM|NM(>TZo`Gq;4F|>VuUt7In_*FV#M|70YFu`YeWQ*Z zIGo;xcHB(v8yNk$3wwMQPmG1_r#_;!>L`v(2E38?R&Z1&Ws81EtQn8I*+YS1{sBKK zf30>|vHmrM=qorPsBw`ft;B+I&Qg6gGL_H zd*Gwa-|+8Zy06v?DII5+&VDWuE?eR*3}nBrKD{RUp~%WW0(JsZUL zkaApA6JL3`jDqBQu4eqr7jJkUB=E02bHict{J6CZk4>NqPnS z1df0ZsH8>Di#)UP4D`@qry3o!Ac^>f4%!t*B|~{c+Psbmi7Gk9Ul4oSYAz^A8pqY0 z+l+jT+JiT^&CQTfh6(=yFdNj$eHN=jblZ%{J689-qA9U5V_wU?+84GC{048ok)K-| zH}VAu;+ZN6WqJ9G4WKWT{V&h6#le7 zL&L#8bP%MHKVrYRuVa9`vaB}J7cERSlyL^ux2)Ie3EY4;kXR^PGEsM)SUa`sQj@$< zeEd7&oGbc`1d6yCeIvdw7ymc3{qZ&4Kns8O5(c0nmn=PQkDKe4AK_ntgHKg?k=lH@&yNV+yBL<)jPTcmi` zz*G<-!Dw0?r6goD0^HTlq6fpZ9cR5o4b0p#YX^YQ$n-XRqEM+fHpM|Du6}_=dtiHt z?8)I>m+3A91-Eafcewf-)Evm)va!0fmEoq%p7loL*~>$KG$ne?^~cECQY)1ti5)BP zya8CnYW@v{LMYxOGjMKR=_p8G*W{k{dZxGXW4fs@W-fu6Gg;JGq=-|l(?52Npa+i{ z*r1^RO-?nrBMqfdPqLxZSy34F3WofIZwVEuMo^(PhYE-8bK*C50s46UzOv36_&1)Q z!f0d|6Ai{d4}%NB2kP}A;|I3l`S$0%iQ&R^XwPy-(%+9ESvvG~ot0?2R+<>}wr)H=EXBos}5$A#g6UHsL{?ds-Y@n{HmZIT7~;^w-DVe*Qj1Ctb^*#>ep2t?B0t zis{OQdktGk^lm24ZL`<;QlH7Pu$5p2j`aMnr4Wgp5I=Ns z?B`s>5nik2Mg9Ep&S<$tUWCk}ZD)_FfBs1Q1-bgiIrT5d!ZClW$5(4@c{VvNacEMs zIB{q~bZY$I$+6#?ou)9qA7zmKttx-yO@;GM{Bq(}S~YHKgwGswt?=0e+`?(Fw)kq3 z1qpb|*AsA*uOwhF&rHBza_2u1n}}AMfVcbD$x>G-?`oXh392gdX?J$i2kJBYzu}9u z4`V;({b38X5PDn}7sbv_ynp%H(`~;K<0j^mxovaOmrcqIcl5+YQmpxv`Gxb}dIhzx zSYri#owN3uSj-d0+j<*wyOcWP}`Izo}Owit<{E*FHVw)xnS_GXEVp?0i@niFN z@NpiDb$}1LL&sTdh}Tl=E>H*}mCF+Eap8CpFB`V?k^pgM)=Is{bHlbBBk!-7_g&`w zCXaRdOXmG2Bkw;YWaEypI-BjvQhtc0mMaVnltUvz2VSwC>^nF;H=2Eky%I(C{Wf3( z1jPQh-F|m3FUk5l>PI5f zJw#xL$eZ#e?S);l`IoUC>A$-3FuCRtPoCbkzup0_qiOIrv?1NKKh zw|NBE;bWnHHxIo5#Ey0~hofEft3w0zT}M~yRKY1a4dO?fLcYG|R(v!2DX`b=NTx1_jqF&9}&6ueH(Rj0=`T)`jLeU3Ooi>9QG3{&iDw zQ7I=%r!7S|_Kx(eEuYh}>}&U+v)$x#r=R9P57iGiT$iq&*Qex6Crg(wf5O4y;2`1*2J>`X_Sp)I{6Y8uLLpI~2AoWOFu zv02U*+kIWXqd06-5)-{1qg1_W3fmRWHRm6t;ca7442T6m8S3@joH5!HLoI9JnF`sk`3s_QEYlSJH4F~Vw&D!)wCPd|K zeSN{1*Y&u?v3)kT+n4#NiL@nX?DGh60gXqg-7KrVA-h?-$66@9bM3Z_w=(LlJ}%uh z8$D)JjrHSQ3`Lps<9<(HV)* zH>+aoH`>yJBunfFdfpiNClv`{vj-_OvTIFq1Q^zS8Kf@`zfS78ZRxL#E|Ud$o~A@u z_|L6#(!ah|W&WNr=ciZZ%goGl3Iwd6OatleT2*@9=u&c!-D5Us;him+hv)YF4;!Bg zl!)D)cC_`$3R+U(*^Q-wk13vme|?!3!X>!uoov4+y#3i>PaikI6GtrWfGcD!6Pi}c z$G^CcrUr%z&aln;-XHCQ;X{2{Pgqx8D+=uFQF=@rvSRcuRt zVsy2vX*H@SbB^sDvS$x@6GN(M$Q=tZs_>KO08S706`GocMOwwK1kq?0Tcf{uq2r^b z`n0;yvnGUlCUSZsHwCSYf1?#c%cj#_b#fow97Z3&qrL5_kMp(6e#0!tg1Jl^j5C}K zM&`t1%|%$_8${7cu;==p{3?erQH@R9nJjT@gshGzn_4Yk2)y2BOe**Z7 z?Ghp_giX+-Tuv05jQKo5mA!3{2}Zl;^6~Avg)H5(Ll#aR620Ti^+s*^L#>A-a}l*tYzF6J_bq0s08Mxva8wPY;yFB)34%}wQLk+%_wQs~Qjvdzq z&wfa!?a=V_!q4-Dh}j|4eq8;?z=69*OPk3P-)h92R!5r~wJU4O5bZ9HykaFT;+>kS zaGAsetH|BAK8mUs3TP(H6pe~MKPsZ`mGAWZ-jg|pAG`isuU&QSsG0LWnmGfSId5zj zFf-@<$!<}PCxNckq3p$Q`4ub1LgrpZarU_&)VaRn6IRa~156aQKe8)V%b$e1rSy|T zx@OlgqbU$OkBcJzY*;vy@5Z;P{ z#LfcKU&|qh8(%iKl0)_yJX{XA+|ak;eqFR%WJ1t4b5_aOnRfT8SHKvJ2m2cuL%XwE zagI?pI=jJ((0)(@&TT!rTLGeqc|mieUII*x`yqn((BKoy0-Ckuxlr~IC2xT>R=NP4q^qg0 z%3eL%vOiFT=92-%Hg_-pK3L|9ddVfO73p|)Dge9BLy7G^m!B8y@}VoD_`&7j@|30&1ZXeg)7}x4Ob=29p?+&P_b)Wv%~cL3*Y#{GG4si4-2znn#stTng(9M@R2E%hNlfQ=rnCD_rXfdE6+|Iwt@^>UI^H?0lKuIo1}_F{!)LdIKpc zu4$q0C-L-?*bz$LnQT&Go4&bXQZp<-mfmS3{GD$Q*V;1B`Kmsqhd3jmtqyY#JVs#x z7=5W`sY!(0BJ937ShKR@3v#&UKPEZzP0VXRCLhVtm-L62Q|dKTpU4-dLc6&N)z~Sv zI~5F}r$Ium(AdZS{XdaZ&c}u4vs<$_FSkF{n*PFF9N^v@9c)@IU|ZAI^3HS^Y+~~% z%YVlJFbCo*ms{ozx^uO?)S6OcW2nzmo>*PwinZEbH?#Gz?|LaCTFow<=gk#%Lh4;} zY^IexH^^qJa<}!!8|aEovlB{+JbUSkis;n3L~j8`#NOI^0@>7WpXu+|z4}cE7!J1? z)E2vA9vw6%i`u{DE?dGEfU7upH6E56Wia^mt5Ib4IR};UzURCTNH1QubArOo52FnO$u@to&1(p#&s>c0#kXxj9_)%P%5K?5V4yR_uRFWtXFOWd zpBZm9x$$kkG>J|}+`grkV5;+BezRL1=NCIHK8!rQkKP;vdZ6`|sOnhyd?Fw%XPbD(3J(o`V z+4{aig|xK{EDQIAuTUnAw<)LZpeYJ2R+~=k0ZNX$Jq^(70aAuYS$y1-!7$2~T-{LL zY6tLPB?noBW!*xOvg4N=2y+0})|wtyg%BD_#FQ~TL)e(dpn%|UK`XXB$bBRqY({Wy zdQs(2xlrZ!l?UxBybMc_eyH}mkX+aVv?iJWW-dy2xI8(r9` zCJDo7&-L2B&KLGfc(4gn zo&qmCOB4;@m5K30LwElM?8=CH5V z-&_dW*Oj6^w9Nj6y~-PY9wQn|vDu+zi5=B_hnNX_@b(Pv-**rS&g(AH2Hk87!cV%< zbwxG>Fy+`Js`9W0v$v^o`)*b487675XP;+YC;$bljc?Nuq^-XkJD2fS%IuXOwORx* zTG@tKl5eu+123C7ZKur=;VfOOSX#N<$p^K#CBLENE+fXLjN}!$l`yr=7d?e7qU?2* zwa_?MA;n3|wZn)w(e@@A5mm{~x1A7IjE0?1b+YqaC&VRM*ZHLD{3`FxO6eZ#e3=(9 zFUh-qM=1H=tNQ)M8~nys7vgLP8%|s9<*g;ViEt~mmOMiWWS%9guhTBX;5vpCx zrDB3cICL!kC;ynVshH!^#A*`JIfgtiQ;&b12XnDTZdn8ZAaaX4RXixz}G6P=b z8PI%7@1NpSs-@0j*Vc|I?D$I^J`oIEu5BKb<@hTcFt-CU_#qLTAShCu^`io&VZfhcIpgJUz5Xk1xC19-48ZbI#^f?2AJWU6yGKm495Nk?o7c&`)y|| z5gZBb$j(?`hQWPK3D6Uj$|*`gp*iNKEjKA)$1cDrm=GYbqa-(1n99r)XU04$!6Sdg zo}ZfD7(6m(bY4(O6GPF987g#f(ou)mDc4ki3E|S52A>qkPE8I%Ij%21b<9>Oke@17 z`Jy3X1-^{QqJ3^z3v%ygoI)#7T&Dxym^UMHrZm|plvfQ$%?Z}h{G902Y~Y^M8Tq-8 z-J&TpdP2-eZ{m7}%6(9iA!#~I3mDCChQO!^_}kKNvt^?)Z3^P+gIp*P@5|*XeihBl zDf6y*G|*+Z+vs$=OZ92MVpCH$`ySOYvtck~xm<7ki!rs3eMD1~PuWKdWRIAs`iQ1# zYx++pYyz2+!Q?f$M$ujc6R(yXk>7?iRV(m~3ol96x#G7WjY<53;%s{lzl@k)Qrp;x z*&hhr><`q6x#^Fw!f4=Nn&^J9qcv@P?4}<+Ov906FyIJhw7-D53Srdh$F{1} zA3V(O;-slU^mkFx)F~CqZ{H%BW7!Bg1MgA#k>aB2fAlu_wQkgJ{T-plG_W+m2y4Vn zwIsHQ+!YX4Osnuquzf%p_o-mT)_3_}HSDv!m7ZTku#E?(ktT0cZa#6xRUcZ=(l!_L z{1-OGJ#58_yHUZxUHK&7)B$jDa$*vOveWd@?dqc*$-BWp+mKk{c_Lj9jq+o4JV)i( zEkY|wmi_fwk>KnW0o*ble8oOqcFVByy*|4|?Nae~hM zZ7qTxdUbVThrBCPXBJX{QG`r&3TL=$SzzzXRgVg-Q|%n4@d6dYBAD0_ldtts zLS<|ZP3a{novkSGOd=npmnBVOF(LsdJ*fI~&(F(TxsAVZsRvbG_GVdAD9e6Ikp9`B z6f9lAh{au9v=ngcUhw(Ccj)s-YQ8#H;{v`;eAO{etp9FN`C5n?p?2`%9 zY9fL|i*9ywGY#f5X1bx-L&-w+fZcDXW1!8NGH$TZpiJbmffZb#IreOU`%$-|9X9N_ zwK&!4v%e(sgp0l5{!g=X<0%!E8mSF^Dx#CR+BXR4DY8!3F|f{xx>K8Bus z!%NANEB6z)vp-exbzwjzNZRqFGcQGt`G`xNYY*6&WO3s66QVlYDjm@wDd7GJ9Seto z4y$&QCD@Ha3W&-)uI{3xoH0&D3W~8Ae`0dLaMMlxQE&9DBRXPNd)(zzTf(3+s*D`n zki0vm`&9W3#&ZUpYhN>N4qBbx(>meZV$bfvHfWbU#7G7czeghICRRK;Dl}zQ{m=V` zyzous@JrY){YSgLtBjPz@ARP#KTON5N1n1CN!!mJc+r08!2Sa-oU%K$QKG&xb{%*r zl~CxE*Um^|rYG`KYxWR^7q5O%)V-OFN}|u9_}mZrN28nI**T;Bjv6Z^_onDQI~!G| zE+4Vj&_AOtxK3l_v-=P1i=@|n)`6#@FYUeG9h)7_0B0$Xhcw&`{uvFU#Lx575B4J6uSz^mC1-b)F-)Q&*!}&-T*N!k zN~ilmdenDupd39dyo;APDL>tMM_G7wS8z_cIfNw7zlE8Ic2Y6rTtGSHQc;@M6-bqI z*|S2C?a`CM+glVz_l9R-NcaSDDa)+l#>NQ4wQ-Kb-w13L$ZcUe+9ez!;tmQ4PUOp) z0d-@{fH};7J)Swm_PMEsf|NJTI5T$TIYY7Rlz-}(>D3H2y|2Dsa|T$X)?+v^XRX$= z^PT#x5ev!rI4gik|!LD-y#?a6T>j!i@a{qKz&glTWeH@R=kz+TJJnpy1-IBF=_4;$BpCoA45lM?dzNig#$AunH$wn zh~bqD-hQgp{*Syd6e|LZ#&-#~$dl7l4MY zQ6UI&k?5|*`YN6J{do86&{XODU&J?~4*?AAxN0@dUS|dDXQ)rAOdQBZ)&^EgwXc+j zdBO}gn#}Hvl#U0B7?b`@57IZ-=x4*N-VKM$k~hijGv;PlPiiw~E0R@j0$#rMnwXCn zuWt%=?7gKBBk>sz+=TtC$MM!nXOyr4$U3`Ju$q~C^+?L6a6HO2XO^zr(k-gZoG$hlPF~0S~{HrBuoc$&Jl3hJ}+}IJY7C~KIzLSO5)(E<1X8h znMw$;WCV?1!*@_SOwV-iM6*q3Vh`f$yrw8Ne&+Y%LKYBss7d$|dEeUjGmP#q`xub1T`?ioe?wBl{bEQ|bU<$0{QsbIpM8B*4E>1T^S6VC4Fhn{je*a*V|lg z{8m45SW$nZ>4vOW9i6<9Yb8L08+=AS>}l||pzD`zR<0`ownR!W-Hs|9r(L;Z44nv> zxQ63P3uNWI*dFARtihl1&Jgq{mS!xjcV3hJZ|Yas4V>lB6{PTQiPYOcYtzGm^NL{P z&6Q`0&zP6U*{X_8oPn{{J9PA%v1ZIC*rTAg2mDRV;if1^QjD=?wh?{dr;Wv^m0y5Z z%n%APVrD`7IyeoChtEu&`T7jk@R*Zu-3f(h9(yaP}pw;27`r4ns z>Mw^fm?A6B&I%eE5m5}^6cJq^tBiHEL@&B_@pYhYo)gWl_dcOQz`i<&WV`+MR2^SG ziP6|kNIiHN#z2c{D}2@uQF?KC2H;sDfi=#czq#UVx<}tQgvx(g>r14Ai9fnyZzpf& z(iE4*t`0?>U0Vwz;b$2gA01(MW6Jj(cPe61vP{yTMT;2m#kgcE{70k1f6UAm-Ebj!HmyCBCdzIP4f8+-{6NTisl%JSO9YKv&bMNs z2rjTYAENjaXGd36@g8c+9nxR2EKWQsBh7Z)sM4U~>2PS3y)7hMmV%+7xR&GthUFV% zg(ZU&G*%}!8UB!{g^C)$w}^f&bqzX9kn6k)-RWqjN9+ty*HeuCEyItai(+e;&9Fu7 zp(T9a>YFvCJ+xYoKOTCUWad-1-tP?!^G*rx@(4IVHZ$fQv0R|b2Yp9^Vwd!f()Q_b zZ|IjiNd7X9pcDKZ5B($79M?O+S52IW6;Gpo6!N$p_lA0TkX)-mu8>^>^^e$}I3Wf1 z90~p`7c`u15U@<3Bp;AMJ_XDAW4ft>>o4tw$F|A}AL3HpvJxZ$jEIap(r25d^Y*ZD zqzX*;(~)F-fQLHoA)Zv-%R~R@()2s+roaby?fJ%5ektm^ltEE;ka zPX)k5ArCl($bLp*M~xawIn>@j1ceJ-?8Y)eYPQ{2K}aoUW z%KJ%(Lp=m!ArSqNbPVFlJic}kH2K!?u7UQ@6TEV4-yTxmGTL|5ht43{e}RD7VDzTq zvO$9;OLCm@Aj#MuRSWy8LByGv!pAB|NtfKqLyT0*4LEY12 zjV}G@ARCHJW^zN-**m_?xAtDu^&<`&5GOtfUl+1}O&@RK9XN}ju~x^^m(ma>IuE$d zJIxe^hYTd|4Be-E0e#gd(SMs2f!@jEp&-dAFPN#ZIiljW@;Vm#U6Em{c z5aBsem61Z=}2a{%&KQha=;>3>KkD){1+B#X~*Y5+is?2#@4@Kj%=LNmR z4^E6?cVcpED%t8Q_gY)_SI-%5HRy1<%9I3Z_0;-$t`Ak}l7M)G_TR-m6+i5bUKBs< ziJm9Vx@GdQdq({5#OSHmDF#N zLXT@G+hxr}yP6eu2}zeBdM!~gA0w5uW$#Fu1}Duj(kxHl2)siMm=eoFQ4ChZ85C>F zbBROKt*&Qq?wAeTwe_%9w|MH~w}E0S<=J#NUVOh0LKJJrM+*Av~i{F9j3`za987!ZFEVWlSm^E%O4WAErEIYDP)C>FlE^Z zY2u}BTbNzBCcAPq8-ljHI^Wr&Q{+DfoX;$I%~A_A7u=jiO|!4k)@~yAY_zv?8kGr| zMob&45gA_|Xk@|HTV2%vB}3FNJd@21%(~94DaS|--NRO)oqPY)&dO$WOlQA~SuG=_ zv};Qd9cwdtb_>%;s|?%d>s#bHX+e4$+id1dZDI#v1T~blzg|YG0Uyi_QT}q|nnj6- zi<>VV?foGf(2si!{h%yJuoI&X`o~8RR{cwV=}R03KWqpy(V}mR}VN|>&2vWsF8y~lhv*|iiBqp7NY1eHer2Ia(keAmdN*wn5TaF`m~Y0{sEm2i<9qPt&l_i zER51lk-j&w7Sr|SlTZ;PXD4s8=rKXE>SEaKGhDGsT{Rv*O6iw-Hvt<1%G1NUxYbz- zQ9d{s`V^-IPalL}A)egW&cZ33;f_D%3|_}9mEVewO<(L7oHF>fJ9BPg`!H-JVn17# zIr29;#;VLC)#ehGAuUgd$A0FfW~*b*S*SgONmab!Mf2X@sX^%e8C(>75@ngJL#G@4 zmHWdt`ug7U=&EN!CAqmzE)7xLlh!SZ$Ue+@ndy6!J~T;MabF`H{1>@-^5Q5s$GUmq zhQy|3xkYKi+=2DL(THY8`p||xiZ+NMSMJWBIP@ZyykBIOaoqMZge9Inaj&H;2qhGG zq}gZw7Lw9mK(iw+SsTxm$Pv0qcWFkd2Yixx-RO7PA3r>f!v>5{(+^(-h*228o$j%r zbS@zHM_-^AYmhkanF^pm^bz?5PBlGqq60foB}8fblt%Ki_*-t#0dXWP>BYavW}DQ8 z_pFWb2X{;xYISJT=&yV&+{i6H52clZ5w(e7+zc)iRlKfXGpnIJI5M8;F~^f6jHlD_ zZ`1K_e0ayx9x0?zY8{wP@J8A{D6P+w5$M<^0zBNWj0mC4;Nb-9{Z_Ofyo|K&DeWQX9ejw14A)e+bs zU`!kgSa*C4sZ(9V;kZ{6vryd!w4<0fhxih|nRv;4>y4p=;vCC&4ElYGM6fU)i8}(G zdic&VV`JkCyJs1s2}bKAtQ=kPIj#s`GMIe=pdfF_c(4u@Km2h-38K{26pwSXVfR## z%d;!eqw5@+t1Dd5h#kLP74}9gD#b2) z0K4oJz%H$1=@=L$+Kw+ViL7QKpw+XaQeT!Uu)e_iBcIBDD(Rhq0t9=3Or_mZO%6dM z-yAE73`Chz?TtE&x4qpYQYp@>43f@57hNpp6gFxaqB?DDhT3(T;Go;ubg0nfy3Bq- zkw-?!+4vw=nh4VlS6Z+UFe>+3-@DfglZVUoY&&oSOeyLwZg#PYLGWZYEC`-Fqej>W zo_5QWVefGF?9jD|;g4J9$`ppBTHZB=rK)*g=donlgh1vx0%ZhJxz&iLriSp*JX_PH z+UPwHsvs7;%x%TAM$rZ)lNA5Be&Zjy?@!q*g;lB4A}pKN9=Fsd2gWEhU))d&Wid4M z@zvvDcK+~jw$2C7vJ$@{z@`gaTB74-c1$P74^D}mC{Wm%AnXS&!4f3DwPknW;AvLZ zzmo}@PB+nLP2;ceI%?(TQo%7uZ#qAl35gS&F^a&9#q^9SC^1}c^H?SA&zy6&p2FJRhz%SFG_38IMeU}j z2ETpfhjL$|iz-+dbXd7k2}@7OUBR7-Ef6Dp*S0)o_Ee3@EfI-f&j&)#RAOKKp=;Xc zqP%$sP89?v8GCO*lDJ7t#)mZ zjHKjs0?r-e%DqE{RG1hX#@-UfPVg>y1O>)g`E&}Pw#k0s{XC5)=Ak}r3jQAkI)@RL zYCJA>fX!U=SHan_1fCZ-I~HieymzSN|0Iy3WJMY|!r^ph0D=pbn&^HhnWIyFJ_ry<49C0^wFWot~;E3`;w?)8kC! zzV!Pn?1>#Z&z%he5P)#HtoDB@L*69KhM{vXOQ{M1RM47!mc)Qi-pcVxvd)_pA3?A+ z=}vDU*lG`_A5;_;BoaHE72m$R)a};KEu6Vs0D*iC+yLb((O9OHLC-GF>#Q(AByUD+ zCL-8Lp|Cb7QCAGvDmax`80hH(liqCaI+Ib)Jn2dNhM5kMNG+GnP&p%Sdl zYTccgTCv6*CUOMFrO7#pS8{OtzzZlzzv9$5w0G#QM{jG>$Jr&BV!o3r z#-^D63y1WV>D-V$M__0hKPbeQK^3(eg}Wov^8X=?CV>drHwd?;Th7%O?nyWEMD}9u zW8fIR@DMy~En+A{HC=BZmkDQJ%Ud+lVcl?GF7_>PsKn|jgmuR8Q}ug>SsjLNOC0uC z9Z!%aPvjuWiLH((to`4JPi)->ohh<9zQzl8L`qcma@nU#Pf-vF9mG@h3Gkse|Gj9b}tvkCI#Mf0SV7QDwl+YSQGyjVZQGt*%Ov-r$~-_IA@Y z$7x3|sZ&kwC9eJhu?v>bOo)KN>;qmhiJi!V)&ZK74~scSu%94A%5~_c)B!(3!v2 z!ty-z$}$bB7l@$6WysG5UdrqrtLyB$Ht}ml@>YZxT=#EZ!4rLcnk>)5Ub~2n+jt$3 z;XSAlZ=6fWzN?#D>`MRLzC&HXzWSSeFBi1TNqN84l70nAylTkFPKLgQ1UhjT?fzm@ z^5HWbLjD#{&minWkE&WO#d#e$6>BP*LH}Gn-^&=aZB6&*@;$~gtbEseK)!SH`R+IQ zY~^G0=A}0fVh9P>O!>)~)9J z`YQt2ev*@uF+5Nj@2S=!+iU5s6;8Q-(eIZ#<#zAp#*prr_VHvHu=^k7Fxq8ZEkXMd z*^b{>#M+yBynVI^;l7-`m)7*HXPEXUaWHD!kG_`gyrDM`w=>bqiuEdC6b@Tl>&9o9 zdqewp*OqB6wPhc^Q)OP>%BkzJ^pmDM-_RE2hK18+f-_QQc3SPf+8d~i8`<(A+B;n5alWNY!E@+7mh(7pn|cEv7$ z_M2@*ZsH5;w7vMmuXET|PQVd@44p(U@=_klt*d^KoWhWf=7bOYiV@Hh-E5|)p$2Ax zT8|u*d)TI<+{A7)GuYYcwECrMvBzq^6oE+c;$zDFrpk3X@)#S?-(splNo#qyG8d0@ zg9b&0>}+>bF5hZ1)1~R6z%+aOv4^cJ-?cf!AG`D_Q~IZl*^>rU$v84sWlChWMgcVR zjx}LdMTb;r={@cmu_mW;lIw?&?Z>}J%FnEC-w(AL`U-Cpw+2t^M|b>2eQ-MHyfHQ) zdymy<5gRphj>;ZEoDVya?%2KVkvZwYbH$^2?LC+yY22E&k?La8 zd^mmjsT_#6rcdF)I>j;^9Lnm*>w~G=?&F+q>>eS$K1y(SGEKmTC=y#W6C%4-$aR`0 z+}F%n_OB%f&bf~WEU-C4_VMf8dz^arj?{}#^#kehM}!>QFJ~5-d7{|}uFAQIwds`? zO~>R|&0VX`5V^^bn7w>63)*f1ITG_Dg4|-5$d$D1_Z&EQ;KfX#39vv`Yt{Uk^87SQ zeX~ofx+n;vhj z&U|6HvaOEWSfTQ?a_CntI0Cu#g+_8*$%Kv)Y)yaS6rfJG!lZ`~pq1*#@N`8<;e14G zT~eLLji7BXu8o~(j&lr=qF^Wj#~2tmYo9E9_}~RcOZZ2g@8Tf2;Fjd3ZYW3Nk2B-{ zD((Q0`GB-p+`jm25-zR+Y_s_j-)FUd)=LL8`aB1PDdz0QX}si#U*AUyjS`pII|*Od z?Z2}+3VDvwRe7V2M6*33Eq4j+lQ;cD=pXYEUzwm-iX3OFn3DR`6 z^asD75qXLr{h`T7ddNty0H-0kDHbyy8&M8Cgh+*%8WMmTRm?3Y&Fvz@#AD)Wx zk<$m<4bl>z{?<91ik;h%Zhlr(8XX_?JV2Ze5Jt_HMAgWir6as|0sAsoS?6dqgb28n zFGfjOy2(8owo+Pmd+17HsZJA;er(~5Le@+-Z}raGSCRPgtyyn)QfS9tfXUNK9zgsh z4|7aNtSMi|>~mX8P&xd-bzA%2|kHb#oAiw!=5;zXcfXU-+%2h69QUozv~UZ z;heLdYwx}G+H0@9_F6(LPnV-lWtoe73U1}}lo_NvlPfws#h-=FuqjC>bO}C=>9c(t z-PIx3{xNlz`$$5GZCq#Q>k6a=;5%rL#DV%>6NL8KsH43F5uRt9NY~f@fzGrRrAvDg z`g{Lf?JX0f6Z#HxneA2DPGc%4mB$=?pEEXX!uB|tR7cqf9{tEeR20BaVMEZMF4@UU zVku!d6f;fG|9T8eP+Dw8EL9ZQE@W{M4~WgI)C4*DdRFa88Q+8g(%%LM)vlu-soI6~ z5K*JFdDv+)i|I$T6veKiAF0^I)iMUg{ZevhklL00w}+?MgMc&v=|@5Nca4V>m?}Ur z+#gjSs$56MpWT1ZX)7Ix+SM5LP^48WYGQwTl+fln`cWs}mX8Qk^?@*`aLv>2-FAY6%qymstQrR)%Zl|m74$m^!Y#}i z56WnAoA*TC5thBu(2e`TIdWXjCJU(#bVOrJDi@;GJ%~Lkk|GTAf*}|WdoI@q_ z#NUAOpFsdLoG>WMZdcAN)wj1lB75GrIK<93z5Qn{9+u`fA0s-u9&4wTqkG0J@$e%c z0ylDvm|S|T7c;e0Idz&bAp3&(pcq+{D#YoiCc`F!7CNHeyZ>}-yZ4#Dg<86CH%ZS# zuVTt7+U(%hf{$_JD=NV&imnCDV!^GCv240ZhW-@Q`)^~_nd4vlA>+^Wp3}y^m=QlU z{_^$y@rPCk!V0Zc2>U;QVqgpwa~kG~q5IqfiowQC{+U9tdI!bk{R1dgBts`C_R8rf zHti`&Jf-A4&D@EaxAE$UJe!(lhHTxK!=A;e*7(e~np{@3>@~~yD#m;VkD|@vkU>m+ zy~etXYU>A+Zz#hslwtUzC#m){2S-B^y3(5;T>g0IRpLi3^H468IF%{j0L#=(J|KP0l5;M7~{_W z=`nUcA%k35&Bz91pkdhzll3bidWXH;nh(76QaTW_`VV-wzY3+)i2E>XkKi zhE8LB<2&CGxr40Z0#@YpB>N<94 z#VqTW5s_=1F0}9IW49ukDg|HilBB-wAVneJQ=!D_J-;U)A?bUHSL7erI3d6kQrEGg zE3O8JP=Ci+(y&^A*V?*l0>-0`#y2b5J>&1a7xpD1hnE9S*Rhi;<~!NN1t;0J-H(|R z%E&vKH!?g+Ko;{q#8Gmbcah%8k+w()mvHH7;|ZiXoS1KXk7w82mm(s3P^zgA z!ntZ`s@e4|`7CZ>-gWV2U%da=XhQqtJweE|^S6qtuDk^~GaFkm@=0g5MQejw1=#3i zv04vLoGDT@5~*lyj{W>3Za#9nkCj_IAKJV4OxRSBV}9%dsfhfTYNBd#MNzbSos?2u zxBRv{J|C-?C&9z*R6pA8wSNvo5S4kHY}U(GtjPZNf1|&|Hoe}{ATWwrP*>2-tU-B?CNEf?+ovW3wj$>ld1EA~QeE}!)Vb#R{j|(^tusR@} z{o5CCcx{h zS!YCMO}~l_jrta*YgvnZ=XV4gEcxg?2M53jMCPELgDMank*bQ~*Zan*$^JTWrQ{&B z*mr$feaWGGJ+3&Ws$z?z*l#9_{UF3l4tn&D7pG&215( zr~88&=WP-DI+Ty0t5AanKLn?h`EOu&Vc&pNF%qTf8OO~ODRzPwLplpBfHO-?m^o7A zsdYD5-o(nc3Jz7JjJKEs?Wg@Se5^fYyH}JO4sx`ujGbO6 z1qU2Hh(=anp9u4eV~P|NUJot(;Qs4OSc{w{MNA!6gfFVSW0vEk?jRdcOoR_8_uI(p z$CORWl&a|pvBG(ltPXSS>-VAfyicg~%aJR)*5Kf?+23N_of^IfIQ1=h!m}p~cha?| z^0`@~?b0%FwV7e!a$(F~sn8OSxE)(S zqx0%cQYsBOTS|6H7Z+v8((&}Z2;VKIywHfQq!&`>QApZSk9mM5tOP*hIs>*|;CLL$ zW^jDbN!;MN99K8Fp=ZN6W{n>%sL={+3=MRgZTiq&^q7;lTlz#4GY(p4pgn#=^mfNx z%y@iA_#2nnu&Fiyvw<^nJfUZFL%a@cay5!2r<`Ev4Olo_7*8*~Cvxs1tFZwlf#x7- zy`f#YA-59+@ch=zfbMIqx8H-RgDTl9X`yF2?kGMlycBJ-d{IgDhchvYn7jIO=I`Q~ z1;a+K6p+nNwpUiLps=N(d!lX}iuuFAO$%~zYK@&@TsSxM4CJN#S#(E~1v8iS9lVY zKa6YKYAo_#j<@jTQ||{{X}*K}P%Zw4|C}uHe=@W4o|5P@r+tMl3xd$XS+tNb%oYsU z$f%n`J)@D8daujqd)XM7zv5=@S}t%)1AD4?RK^>`vg=GURt~tcQUIKh&Ss={FbNoG zSSOD;63CxkC3^@gW%C*+*cPesm8%oyW@>JXVR>gFs>jYW0LypJoK*YV}k z9UY&SO8%}2KKTI^P{1cQP3}5c(4N+Hw4{@_a(S!i%&;oHTbj0FqV)K;%ekf?kaQir zCj8f^uKGL)81uy=2BEu;jxrJ}?xf{@^UDil`j=z<4J34Noq z^ZSfJ*=zc05Tl0PYv0D8bEW!*fkh@hcWxL+%*U2ZO(|VRBM#B;TJ5^sintl#& z5}97O+iG%KcWL^xD%p!qwJP@*Bbn`4R^>KKOLX7?D$^M8b!7GL*XFnfD|$xP{sttU zvME(=di;V`mR_o_`@cLXs3BeNy~e6d6j1xV0%o`eYkHnr`y1nE>e|dr>5Tb`(o4g) z0UZ{gen&IgHf<-sv#HWmiCvd>L%-{6)*s(qE#joY(Z`FZ#qwV>bX4!vn%ehe`t)9J zQwPufS3Oz%Y0FiJ$JoCXx5NJMMOKANpY@JDD`t*_POjQjxVtNKX(YXSH>GsZPiFrO z1EF}wC-lcxr&#r_YOIc~zQo)vUai4jQkmUDtP)8)x(ts{eWpt@(!DOUw+{`(Qc}{_$)Q#$O(X!e`iLcIN4F?ukM=X`z(_$}tQgkKxKW&D;$KPUQ^b@tEyiKUe-yDY82=t^bYQML%5cNVe$ ziNtl%I>B<;mIg+-*3Xp+uBc#CWsuM=gc|y~$9XF})Y_W#H*W<5V{n6rue3+9d};If z@9)L&t80vtneD%V^7@+Wi)8xlVFn%E4tKIPT!Ub2S{bhEd!+o(R|+UNd?ChBGTYw6`W91Qk#W)$@sVmlEaQI2FX9Nw;f{q0TpY`I=v3edCvZtDU9ek7nc1z`Wz30@Y<*bRtd!F5jX@>s@yoho@1I&iAOa4h4z@nzRL!7F1K z4~#E+o)f$(mN9jF+4Et(!KW^g#xl+yi=nAOEH&qia4O8)pC%)oYX?6CjvyUn(4+TY zZY@%?^*_iMzjkPt^Wq$Zh4mr_DqZT~|6+R)89=FMr627>KS@*C9>_}bfu{BLBWqAs z0?iGiME8iXCy{_8j6MDEoH2v9Byk)g`S9}Y$2M^PtL_%Kj6gyE2nvI{LVxX;W%@$T zhfBJ-H!!+3^gOq|N8+jNspdYb&ZAd8gB#?h^PUh+f1pEy*~sM9`mSW=_5r*RkHAEF zxLd8(PyQ?H8)KiJY7hbsIw&tP=M^4kG4J+Onz6z|LpHf)m@~wci_i4;Ti*WA-te6X zDE3C?nzsN5-j|+$!H=n$;o0(b4cYj#m4)$e`|h3tkt+n%s3SYn?(3*9EBuR0??H3k zL9LsM16+!QEj71CCqde;AL#grwcLe*FPLiXTok=P1*)%dE%_M}R8JvVMLzXZ_o^H% zm9X>sE}|#(ZCdsGXES|iHa02M$}0W)*$pIUce6Q@_{Brx;~6+@gsC;$2=5IYll0A| zj|(1EIo}K3Ja6TbI1|5GevD)PVrd3-M z+aQEZ{>&9#_@bFyl(uSfd8^=UbVW|H{m>^d_g_0dR+}Tqn(Je=0eOkl2IXN-RXJvo z!>4l8HQOu5flgVhwoX#SYRjAl%bk3|C(1(!3zN(E7=;!a$)4txrSov5ZB=3{qu#p5 zYjsp^jz6Mapit_kfqDpB5Te6AsdPF z%@=SpyFWusw5OdHzxkx|l5JkY>^h$fXN7nS(0l!^tzD9jDYkc{XHTR#^cK;a**twl zv|mME75cps{p1`(MS%tncLsbG;!~D=S?dR89b6ngzo_i|Q22#mQ&~)=f1w7V=jlX2L@v`zP znTq$0cv3@`wx5e#q!zTy&r4>E%oShP>E`oenf|OYJ-v6N@BmpZXg?3TY?9@*iGaak z?S$tZBIJtVU&2IF%e>QNAvH z3>A%H%T)|hS9>h)+-Q@WLT~`F@!jZxjU&-{8;_f_ycX8LcSnR@$`OaZ`So@_J)_1d zB1o7M&obwGV0?{%gYK6KM?;0}Q>iA`y4_XZ)M$SfnjuV*mo@Q|_+Wg&d`5<9e}=o! zqq_q(5yTB21$#{nYWVuI8+ zHrt!2E`djJY2&0Ok>=#nf@vfPN|M_IB4=Rrp6!x|m77M~IMxW7S=7>K|0yex5QY$! zDbB_~kXXTu<^B-O=zr7gMsIrW2wl$lFFo&9@xltR+$~{D{d(`hl*4;AopaH?O#_*P ze-alldhej#JMdT+0O(bNv?Vw+vXPM=)T{6aDy3PoTsVeMP9cc)4UL$4B^v1=DNgtoB#>!N&fbG@S ztxA_qxt`O`TVr#B*oT~1Z-4h(a_uwVIMBzCyNf5&2tdE7sf9DQv&=_@k2N2<9~7pW zir}ToO4fgiukbzQ`UfOb`bB>8KEelqT*eJp9YN!@zVNl7SHhvj=B8a$In!Kr`~^AM z@|uI8zpg%O>;Aj_KR*0c|544{&OJBxcK3*g;v0mCT5c~#eV(~UbN5L55_0EApd3+EZDYzm9zv`XNKNcm1&lk{qa{q@2tr(>U?FKg@yVf@2SAu)Hky_^m_aK zg$FoUuj^QR>(lu-bgIWT<@Z>hv3~!jMEaiH7RQ*sg!fLdN@Hei5WFZb3(Pjp zR%Ravza6Y&^5z6?>3@oV(Vu4v9xV;p-+c`EsA$vSoO{Fz()k}%In*82Ao~b?{k^2b z!s|UkoSH{NPeKCo_1Y(mopN!_-@3VEq1Qa7SFHAij&xo{Sp~Pgo!`{RES+!PbP;vQ zHHVmxvOJ-Z&5gF1Lp#{yadO1MBWqOtY)Zq?317zRE-6+jiF_YgQXnwNekPA*k-UC% zxu?bUBnp;d8!>oWe5y!E54hq#rXEkwt(%RNUh&!CIn?h%PKVDDq^LfXH z8kFO{@)Slw?(t{xq^IkRe)1nG*SwL;L**W(?Mw8!e>kSvg>jR8xn*3*SN}pzIKS)hY?md#&S+7i|z5%oS_~Ctd?}b!-d5QW~ zomt=NGwOT&RDIVO{i3Bp@98}mvZJJXq-&^Z@hwja-k9rLf;U2Aq?>*%LEKO_Vm?@7 z@nIvA+{}0=g>4%9mD!%*?-KA(3Nty3Qkd6Gh$TsI(;&AiIXPT=8O6)?BKV=V9E&N8 z*;gEIz(#VYe^oIqH6-8PlNYPpQZw00<5L<&J6WPV&w=)0`orrUjAG_X4;nGS3B9L~ zh9{`bS0Qe^)GXHd&lHe;&f<>n}m|$Xg@ByzlYU3Vpzx6Zbk1~3J zH|d&w%fAzRNpbJtIHCaA+E<|knttDxWKP0j340eZ=WFJZrug)geS0>^nYVWZvArQ& zUSHwM#*w(CRg=XLLTR7Yt9P2VnF+gBA-vxCCAnvEd7jYQ`n{XTK`lPGJ>{QCs>sI| zd1r++LpZ*mu^*0axj2N$Zx~&!E%h=2xpwy1$Q|ZEz2Ny)A)TU*(a5JL2xlt7^5sgI zW|^>kmbQ@|@ELvYatV3}HeHypQN8EirDk>-($}ad%-5oI9&?7*st|tgd<*We0hz=! zAp{Bju7e30i0k9nL1u42v4rOVl^>Q6j?iK*CUcYvM>xh+za~tf`HXOc3R>m|z?4ll z`lNZK%rC}tjdET>O+~{!av;D6L{};~1n8x>MujiN8vL8J8Ed?*#uoFM$UG3oY8Dn_ z9NsJdZ|DY5@|X`$if`l^`Rp>Qc^vYLOC=t$oKzD8g|@;e;e@nCI}M%iH!Qv6NTl$P#eSl( z0solxrEy_~G?a1bN3XJj@KmLxkCg^)iS6xD5Hy{?WB8Ezi{t4Uohue9c3}QX9i#f|n}mJKZ?t{M@G#C~v_%W0XHS(s2jf=M z(5Q+JS=za(_^X=COO-5AsVx>X*iWiXP=%}T7LmmjG}@0O!&Tu6lT-i{Qb(sO!x{ay zoB8XJ0f4TvzYX`z*4qx6hdbkR2_Xsp#V z+HAfjd)@xmv_=shw3tUj&+EoaNl+)`A!urotm_ZbdpYh`%+C%mR-1;x_sv0&`76d9yH$yy{8*WVgYdqk=OO zAj4A@%OFQmB4-xny+=&=leoX4W~-Ltbez*7V6m5HyKxf28x>SLH4 z&*8cK``s^nT%f7G4Wv4sxC({A0hn&DwHt$(X;V|S38=Fj~6 zFJsFA(bWK>e4u_P6Bb}a4g}XsnC;|R`-BuI)28s{=+Ck#&Dn1a7QiyP%A6}IR$b6DXoVonnRRzfvv^s;)ns?2bgGOJ_c(pIe%UiIT zX9PV*^lD?63{Fl;Ma(=`Sy7V8LILnVmW3+E&Vw$kmCP^rL|c8K9ER-#l}vtJ&6sHZ6n%7nm8e7lUl! z0;>rJNbDXv+4ThTQcEhdHE!X^GSO4Q#`X*^oSJO8nCCA66e@@0X@Sx>c~bK#g5+6! zS{@G$)yC(sR%ptCEsR@%r6hztnaNat{ipBpnzwk^SA?s~yYe|(*@>4y$Qa~z=w#kV z=%D4lRG;;tZ6U&n2s*4$ThUn;%_gSxK*XSNjul5tpY zi(OJ~O7wD4huzijvbJ4u$IZD1c z-X$SP1=6be(Slf+S{!3tvYnT|SeNYOoj2KYJ8$1hOTIm*)&Y)mws_RaEDW&mMnH9N zuJA1NZGCL&@dr=5l6q2`7Xr^F2|xwo>GcB3lC5(zlG37Ysa$D&wM)KSMnCriI##h1 zP1d)u2zjIB?^<(H1v%f+dn;F2vpi+iSN~PgD)|F>?@s1gEen_<5BQ+GtF7z2Vta%Q zXS7UvcD}^cTi2Bmmn8`@NkB0R?5jv5 z8H^ppg@?9DpV6h4)3$8WZZ)eqQd{%14t>jDYv@^hOUxY7XYVm~rD9hNy@&VOe@DV1 z;dm%wLg68O%P93A3`;`)|h;!LH6JB1jRX6p=#_W9R$- zU}0Iw!g3PuU;m+2D>{`JlQYP*S-}pINyq+VevZ3so+U_WV@6grhx5Pz1NI z=!RI&Ablu*u^y4M$X~2S#JtYiHxh4PHwY!1K>*d)oPryppH}au*n_7UZs9Cg${?i& zWzGdI%_?%865WV=M=8g!(8~QswHh+pvOjd~7nv^jh(OGH!!MOA=(fOQofT2RwkFWo2`^w4*tYa?2yID8>% zM^t@Ai|sxVw^&M`j`-q#VLg%E-5FtM-2YVWMyW} zXHyWp)u(T%N#$*6eiJlczWuhw$xw!|Lquw98ugwa^oP{`dQ?+6$R#Cg{F9^-Jre0q zf3#7Z(j5k&q%d@nE{nQJ&E5pAivujM^bVLGeM{;5+FSec&BI76a`N7ewrg%XdI@CV zpKp!jquc`PX2gCSZSc5byyrkTSQgKj-MTqCJ>SCFDaNG-i4|&dAc|rDHYzKbN&#cL zw5rT}HZ)&r|C+VZqeK>BakP}})qIf@vCJ2kQ$VGlSXz>!dQPOr=ASv|-L1p_ZeE)A zq_cD%9yaHUs1R7xyeG|f3SaJjbDH~|@hmH43BQ6w-g8LHbw#pb88QKsgLZ0W^YMBf zYRfZU*YeQ+R!T=X--Iv)5cWe!3ZKY(LfHnV9BvzxVHz~lzgnjqIsGT68Lu5Tc6s9G zTH17pAj#@1q5>+)RReAb*XE0^@Srpy7nt+7RGa4?W-lUOZD$qAPL?jy(WgEDOC;?1 ziR!kmzL2PF6w!}NGxi@h`sGfK4|nnK1s5Anrbeg5%PeiK13}XqddN-@6(7Rim{JWMrT? zL?TfgijE!dY}sa~#_36}(I1GFt1YB8JwH}1YY}sjkwh7NpILJ}TK-!YjL6H*=Bwm7 zO<(`dbbs=^qY{5l#;QRLrqxHV=^r%Tp-=LY@ts=e9ev%~6l%^6=FPzMK~7#p4x=M` zZ6rMrS$j2F*1&dGmvLD|68FmJRkREscp@&9{%f zOHs0wVbY0O_OA+M4@%b6;$gAQnC{i&2x&0#o_eJY%B`cx;`&6+S_0@xZd9EOU2=3o z>9l*Fb4H_z`Bv0|$h6+73GnmPTa|%&d!9Pi6-)dgKRS;DGl?wYS44uUdb`j`;IMbO zV>HlsW63Fb*J8S$4N#ZeGAQH^zrWe$=X{7r@5VzW(B&rRzT-vy*3^8U73lqzznBL2 z=yc;#uqB*m`Q-GoY8Qt9=E2Yt?FU4jpGlN)(zhZVfmnY0;sjx9hE8dX_C+be17&ku z2}MQB_B%laLE(WWj`5fm4nK0J*5?ZsaGE&K8BqT1?>uhS1VgoKB%_xb{l`O3u6TnM z$oA7;ZS-l;63GinhmN+(8kfEGKg>&iDfDal;r&J|Xui|`W?GG~*iQN8oP!+g=sm?! zeeD|$riTB?YT5!Yp30@BMmqk1eYPdGwgB$qK+BfjDzy|79f^+AZUZbQT zxE2lao$Y^xG$&L$jN?{Bm=m8>^oaSiv%gI*sSmD#P-=29ACSXvo07K;=L|6zQ8QY&3mSSH2%C7 z^2&2j-I(>LLRL}0C$)PpUThYc8F@7_PyW8TbDg?#Ar$`T9FH;QpgR3{(4k zsjwNcTQ26B3agc%UMZ7Qc>@27AZ&BXt@E{fZo(E6j+)Q7UkUwHH-16{2pJ4#R+#;W z2ddGQ1ua8QwhyDFs~e9HZyXhm_MCJ&Q#FSkuli8NBiFnmH*Xm&F9{8-x-xG- za`G*h{NeptK&k>aaKtZ3r2lXRu!vMebYE>QV1`a|HPzX^6`LnR2lbv;z`o&!`7g=t zCGIofrs#6BUgM?`EX_?upU9%TDUmB$H^<7HrK~JJR^}{ab2&H}iPr7o3Rkr5x5Cl9 zeB;0vKk~upNlAKgCDV`9FZj)fD_jQ8-Gd^lEpATW_|GK#P_<8FqT=ryPjp{^spFza zV+)_EPwB%Crv|xDw_LMYbL{;61KEV#gvdjxd*n6{U0dI^a#@PLZW~`+D{qG?5Ag=V zd?}{=VThf1L{3BLO4-{iD>S(2`mPe>mUVk^cC3DEvMB=^`u)ijotkT zB@-50ecksclREL}E;||EE>NPTqP#o3jOCYlB)Z%Kauk#xIKTiRlNG@LgeSL-)RaL; zQDjg2Mg>Tdg9$X@wv@;eV-}sd+Or6dZ;%a7!9dr_J80Tvq>=^!P0H{kd=$^iIV<87 zI1)$dKC|4X_N3AR>cLDFF#hZTcxZE1|Ep=;{p)yj4}wY6r@(hWM}LDmhfOJ=J*)nS zajxSMVxF^4Tb5HrD~feX9VdwpW>^W1o`rbPl{AV=G>9(rb+5__BQHbAmwsN%)qW9m zeig7;5<%Y<>D3f+X!BefqA@cEkd6UKCN9Q(%0txkrIKpS~>Re3xzFuDpS~ zXY}d)#z^k!N#-lYv4YhZ%ENfv(|xQD09Jp>95DXaXS{kXdi5QedtZDicD_5(jDgHJ zqOL1D4j2Ph#?wVg`Nux1JxJr+f3@xwwI|~*eR+SS1L~+{`!}JtF<{Fc+dG&dmkS^@ z2Z8iCFW@ni=7>cFp>-bl-`tb8m;Qnh<)@&NG|OuoDO;WKXc=HpW509)g5L0qvH$AK zw}(zz+Bxtd;i)1Cp5DvN5PdD}15LI6bNLM*R=UED8)AF?Iz&dnQ~U z@=L{qNAJ+gwcgO{ou4uTU$-hSa@ujuX0vF6IVqI2${P)D(4v72b(lVlSA?E#=f0fi zkc+U=D{b(OuE=h-XTj%>uJFcc)hT~-tkw@m9L2B#B4fEs#d>0nu5`0KO>K~}$LuXY zib2p1IrL{AOD?G290;hkZlz>r>|3- z6Vhhy)-Hk`mv-pY2lZ;&)YBjSjMNdnk<3A}Xya)>W&mLOYw?OP;Nn;GJQFTd89s9= z!)ZXNJb#3JQ4JDcG62U|%d&lm$|!tT5PaB(hV)yjCL&3|ABnx@atW6D{!Et(T@4bD zTgQ$7)KWShB03Rm1UayV4<3+o6dm6yi#EC?l3qqFSLTH9vNCv8h*zxqE1P8V(qgy% z_1GxJZHyhl zZC0=&e^=O;KMAbR(^Anr4@xDMvsytjbHUi0=yiB3$E1pcSKuAnoKko|E%tK4SS;(H zP**TDAPBh=1fXxTVFXxIPype0Hg}t#McG*LRU8h!g|ez7z18D>J(SgPhgmHoV2O}` zYMO%Fsi%f-#m4R!H|pGPNgiC3c^T}K zSec@1u`-28v9er&I#yQXJj$HMOnErx6-xagd-O`XVG!EdDatK??6oWSbl!bT1aH04 zyHGkTcCAsIM)JViwsrSLV^fkfG|xOGXO zd%-Ud+BU~jTT$(aR{cC!6FR)=FI4hV;zi4g>8fq|bk&#OR#QP@B#mGy@`-r5`LvLF z<8Cd*3WKFbBJ-5yTFE-4WT)3S&!lS6y}*j_YRzS+h+IKWk6y|Bp=TAhg|3(%xsPB) zV2-g1g|W520V_D1qj9eLIpWe4AoS1PBqrlxmKx^ zpH1xb*Hq=5kQ8Q3Ro>3fNQWdzb&^ayBZ)D}U0kWfm8@kUiXPP&{eSdi?Nix&hX!0> zmE@JIGg-oD3=IOn+Wh#*S|4dkUmfm~4H_PU2 zqN>6i$cjCfD1VJp2D#=By%jpLB4BCPV(s?qp}70^p_d{P)o7Vd?|n5i;s7)&k%3#N ztQhm9a;tihz~(N-?u zwq^}(9YwpPH8kjy{?@Ui-ydtrzBT8BO5^`AvS{HLCiK94mJyM4QPM)}%DHDEH@15ha*3y3&>Xvl)9Bkt1TlzvZ_3c?pea-gFL|!z)e@&h$#-T2L zvETuQ&prSKRpGf#CgMfoP&uTZFB6yUEs}v`B;;IeCL>Xx-&^7=N7>FgQ-<{uxxs1d zC=+_j{YQ^TbJX=l@@VLKdbnXxf2hol^%?uO&#>i!$+5q>+j$wc7Rak&mCX#*w{ov> zk;6eBsv-B}r7j$f{Hs%fIe6oufly6$WNNb=+au(Ganl%3^g6QfP1#ShN`DCzDSfFM z&3^2w0FtbU+-!|iXu?o)>s;g3d7A1^EDvOk$)*LK38D=qN^$uvwbJQwYlhnTeCZ}%aRzqw`U>` zIw|WQy~9}cOyZk*RS=)Ld?HBAds>BT{lUWzKYVyU>|Hij*+TEgjBm8R<`j)Y3*KMY zUJDYc_G5Z4Y6HF1F1@!&Qw3n$knhw)@hpB)H6dwPd-y+H**@eYL%neSj@3pq(15J$ z1Rb0Mwav02i#})dIjL5jQ5Bkm#^XT4KGL7ksfP})P%yruHlrTno;sKQrRP#;6%>NY zN|p7D`^bv)Ja#+n`chw`JxEF!OZvI?@Gf*SM#GCmSoCel^n$+S&HmSYYRks)pt{bt zcZB4@byb<(h^lIXQQUM2oG7^DOE>FV z92N2RS0zhYqa7Gm%w8sfV<Xz=Y_9U~=_)SIXurLFC5k-pCY^`6$AQdLL#Z@TICy z<6#FiHYwB)%Ncs_CP51|1$Y;nQ16|0%lKLg8RA(k8OgVWpd??^*uIUTjNW^f%en=G zogmZr2x(3V10gS?>ZJs9YDe*c8s;%Ek_0OG!0Q~(`;FdPdm_<8wa&su$fyblz0@&D?=4yc z+q%e^K4O*UhVctH0|OT!2;AVKdwkYXKdqJ(4$3%VVq&Vzn3R0clao(j8}rP;Hs+bU z2x^%Vj3c8R*OZ$tuy3y%N-TR9ak9#?NB^9@-enm_M>{5~#qLj%n^_i}jP;@ zM*qRYLMV&iUT4Gf6{oJk1MDdvkj`FWJ5QNhR)d#Ciw#N%7{h9Ky(VN~M8Q$6NX7^e z&Q_3@G^xJaL2zC&AO_sf_9Wn99xyE`lGs$?U=u{d7dqy!;AsvlXhKYeNe{{j*lZts z)0qykVYtAosmIvJv%)0g^>dWsbNKJ4oHSwxJ;+U4zkcsEYQyWW$esb^uF5MqFkX8z zrh0@Ic1FVaKf(VB$vnmVcCE=y3Fns71R@tT+rQyjqOn6$VH43w5tU|#-7Va$SX{;R z7CB`rE_rkeP&_5`jB9Z2BH97u94#Ax9-T&YcRShY!B zwOZjybrM&q)eJ*nrwTvOoDP3Du6)6%t8f%tQF0>LcRr>XvoJ-inAI+;K~v)m-av0) znH;1PPW_hSFg%Ix@)L>$I;mJ7a0N;#q&e~VH&G>s=`4j6zj;G78*XEAh`o}7Dm$G( zwS|+dQ*dm9_5&xTmc3L!<{jwe)9;tySd4Yj?lb5a+mMPR!eDSDv5YxOXQIgH zY?k7&BDg;%%S{l1kFH0Hbx-CPExTM@cY|(S$6l)vEVv_qpCX2-)DnePCieu;G8>Wr z$$_3Zj19|<;%dOr0oe;XIGQQ+?2yvyIlN!!+4BxP>wn#89kc;%K1CRxdIXAk?=)); z1gUmBg68lIRCgVRs-411A!&-!lb0l33fZGqK9GcgX#rpkB7;K13yK8Qy4nE)+)T)| zKJ5gESrR}K#$1eukyU(GDj^P+F_16aSkm=MkEyZIcG%x1JE@)uz*u9aA~3 zWBTpXknK#3ZR8{uRP=^Z`@xWP1N5QtgreW745vkvqi#_t$^L9g%H$LW^tDcYrikC^ z(%YQ?pvf*1{#@>A{D@g3Y8$9a>+4>TmLP<2kBqftktQusU2&O{UGKe206?I~aOOSv zK`q((G`Pq%ZJBJ-QaSTe`QNgW?TMV$9%xD+(RozR@gOcFV~&{lF>XRGa?Q z2@p~tHfdA+iDG(wiZIDxB@8ZI3fZ6|JTW>!ZbPg2 zB;RG)Bm!b=#KeTON+)UMkMtU9OXfVu8WLF*kCPKbg=;d z2P}g>2%7{FrY2{kW3!KtG}(++qze}%FI*|(h3S5=rRnJP+{T%ml-w53c9=-Qm5s^95X@w>n zW7ov`ReC23Xgp@LgT>_rZI zhxeV|cX;2T8|ws2Wf;jm;;ztP1Rq5@%%z@eYjw~>g`p{6?8>yRbFn8=!q;eZ zjT{B_|9=E=(3(Os6M%2+L3MD8Zk(F#wrx!@WnMtJdh|XgmdQSjFd68>8q|oWp zkTZs;0UCT~h9ap93t_3wyP#INruGJEFT00NN3da)XE8w_$x4%x5 z@)NB=zNyZNxE~{%30YgHqS(CAr*N zXqj}|I3`Giw!mrS+BSV8lLiw(z3B662{FZ-)Z~j>z0mUoVBLLEBM?q$YPNrTdac+4 zbq@gPUsR_nRsTMgKGXp9-W7@|WO)aS+jyVjkOoC8Yty-Bu0~I&wk(#4lGuD@C%)1Z zYG4v!`vlns$XSl?>zm!r@R}PM?!1l}>??fE@?KF9^%`ZN7d!FKsKhxz(P8#usiI&- z8$r3i;&R|nd;}sFTFTUy7dMCy|M$?F9a=QsC?hpDfXbn@qPv()5jiVX>AjZ-H57P; zc~Lk!OiG`zJxxFxz6I<77&*$#4!x*v_#y3)(s(x>;9WLac}ab7z4siell5cv@dTR8 zc7zyFzfmTlt=~sW4KXk-2*@Rwc`S81OJHbMT+c+zMMH*GTi#2nRh!>B)#lI>9arTI z0Z)P6dzH0TI{XA2kD4RW(37gg03o1WuRecN?YHwbl>QmzPY1!E)j|@D-s=}nJ%+S($j|;cOXVzO%g|* z?~nJsFCOj0Z&8K5B`Rlz++TMO;*928`q8_&q#%-E)??R84EJI_wEfMk_mN0U>5E=& zI5j#M0~esI-)`8VR_{}?6#)Z%$mC%y43Ln*QrQlda(g|{$iRJE7wHYOHn@kTbT^u#*8POo z*AD?%kMtNrkc4frlqgJGpBLb3dR12>A$ym!`W7nbe^n#)8$UQL_61@K4;3D0MH-r~ z8{g*>1843Zu{w=3GW&Au!#_MWDtZF>_JPD(k^M*BP=_#f$WgNhQ*)8BVb~z=iM;Jt zo5}4ww|jJD__nsNM?E_umBy>bC0XI_!oF4vMNgFxG{54E{GfYxN$C^eX=SaLB|j)J zaxp!iZ$Sf6b1U?y(I=-=x3cHvh-x8Ia1qV*;l1Xk(oOdLv`GRWZ><>PPgAaJD5sd2 z#ToR&{h|V1FrfG+wP%4vxlry8_9a${NJbK|ke$2hIY9EpGtHVdT8AwZIp@Zub$Fst zk`hUexUsch z>)SSiK?-ZlpC}|sVy%L$#mQR6^!UJvY$zSePeY@%bw1EV7iG77;kKJ@9}gv|l;+cy z0K3utHR#vUR`4kEkcgmN86{HG;20JIR{uF(M z;TSF^d8=_P>ctbNy`j-gdn7qURGrzxGn0#$JU>vA-ou$}wAP1QzDVymN*+O3>OccS zDxh^(S5#Nz#NSYn)s=Bv&o=cT*`f?ZMOPdr;!uV_&t16aszH>`Tb* zm}%P0ZHuMh_8gg`a5N5ODMInbjsDJH6r)oB(VoT4JB;Ph*v>TOTr@rAnC38cdAZj5 zOUPhuWAqNcJ)g?y9KX?*4k(%bsjx|UQZ*T5UZJ5o=2s2*?Ni4_3lB(B4#Gg@a*9p| zh(QFDgDmg#{{5-+-c|qiwATDaqH8ruRC_ofVu0Yt=dGG|>)WbSYq}ZIL`y)woAoWt z$6Mjnua{<}(@Y;No1_|6V`-D6St~v(gBF2y){H!w(j}S<{p}Z+gI0G+7Y@y8eH{U_ zmSLIRYW&y6loU+LhqGceawwcqE!RPp;fP)Dxl7h_+M-(9+$61a+IsLwA$zr6F!T=1 zzJf*p#Y|&Ipq17@FQeV_WSrPCp{3PGVhk9~RXL#T+!L{qq7%8XD@zKj#{HN^O##p z+RK~Ug1?k3C1Y7GC3R|hZgX3KiU^KHoJ~YpyWZS3Q$=Jr5kfYAT|=RevG!R%{VjmB zg*)z8K7JkoN=0+q0y2`wZ$FtNK9PKLQa703P6-EjA_@s-%QsJ-JY6Zjl-uAp>ebs5 zwr`|k6umo*Ue23YiK6)_dRfZct8d$wtnUV=z9hYbS(o1Qn_HI1SS(t?E}+ufuz(Ls z>$39Khu-U$I@-x(`On?QMq@Qym}Zr~DzmQV_{|Y=aahf349Ciq>sdOn@MZY~0ze z34elaFO(g_+%1TIo0&O&vq!Ba%R6rRVw36}0=Z7B_Y70iQmxtE{vXLnr-Gj&7;7@W z{r<7h=GJJB7-_ek=9U+~6$o+ZNoD z2|5+t4h#pWo3PA9R!x@JSgjg}I!V)`8)Ueay4tp`&-9J1SZwcANa2lc5Kh_Hmc#$J zU25B0B!zX}c5D>>IzY+w_CqSAKe|EE7~67BOF7d?nXgi=O{SDI#-v_bd;0E5 zgZFVw4}JMdK)osxw2M9k8Ab7M!)8K8i#9ge&nY6JOh@b|&a7G7*dmB3+6k(XCndCY z37^7aSJj)UiyGV7Z|ZFAKj9MzN->3r%2}yASt=JN=z!i+AuU8Lngf@soVEy)zGiIM zEK`CBy+^F^Q@TXD6s3@rTE$T>*PUdoUYgoyFL9tv!uCgk6WN}4NTH>^2u@`(9kKxBz204iADeja{v zCwn}(pqHcfsMUrf9~j-r@vh!;Ips+yADl!aH2Mdop!}^Tucgnatd-kP8*B!^++{vb zL1hG%!hy)T8QK%hS5UridJW_^cS&Z_i4qU?xq4(HaavlXjhgf5=o;#grh$)6ef{jZ zw+u>J{U?qsKQX9OAUu}p0`8tli$nuofT5BuOY4RMs9I4exy+}HFWU^fy3H{@XQBov zh`oIr_3;>83tXz96eUXLIfZ?PHYBrW>+9~Jhx9G4t0A|Fek7@zAv6`?2j3vlVB)E(OjrKqN`>|0J1%qr(g!iQY)Fi_H43#OemX821{=lTEb*-DZ zs*Hu$^^yT&nM_ZN^bz9|N%$YhumJq5LqJ6GR)V%$MLp6UShrG#{}R9p*zWnMk)n&Kk+S9Pf{#1H?UPMcC^h24T#o31 zzo~V+Wt==7F5l$3IyLf7#>o@mD>s$9uC8!JrWz+thCjWjJoV~|)W}5Rs)KlTXv2c;-UL;%0#nf5C9mF+f z_3U0baUn8b!CXbf#i|NBPan*msT?YB0xSBFa}bCia*z)n8C2Tj%HuqZHx`_dH_WFi zmni{p+ZD>=)$$gITK=x8obyx6^|GeW&jp2j1e}%9^W2&`{L*v*gVp9roc#fM^@h4af{yjvR?JOve5Qb&(LrA=6Wecxtd+7Z+TpH z$mV^r(>901?A+1NiyhZF91cC(9tW~1De*LUxE!W-X-ZRD<;;po7GCo{wGt9AuZjR#Ts1o6 z1e#dqR_UsnlR*;j`8$@~Ea{dd1C1SJd=^vwMHtm;YFl~B%^l7Z^Symo zO6T_A6cIz^Ds!d#~f;N$oS)7v+#sWh`H7=#qT#rOF<RGJpw5og#O-uK~LFb(Dj(U|zc)m+jXVBJE*? zPz>8;iQ>PUEM5xN*QHCVR0aCFqf89hK&mPPcGqcO0{b*Te}CwNUF&mbtt;*+rTU*! z3OB-??(jS&dly{ERESyIMqr}j&!+#mtT>5BaY{Ht8Q2PEBnmKVS4wsT zN$n~p&}VM=In5yaRH`Z`MVa#`mIp(TZ>@pouJ=&0u>%X8zQnaVbZGc%Em1IqTeh+; zr?mF0|2dEFbO1OXf0Qkvi2VpCGH&$rp6B7AjB8W$o`0i&7P0ZR`OG9@f_V5|6@7NI zedn3cUnROEBT@lwo}Z{?)|qMUaB7Ks!m9Ce<)zuqJ2S;BQdl+F^-IrbwkMq#Ss+!Q zR9)-bv!xUgPHwjUETer27cr?V^`Mp_6_F&B{l%F{{scq7;^)WgY4&L668omdA2d}k%ku=o@!Q&VnA7mlB%I3w*5 zPh+VmaksJCW$cziGJH@?>3&?crD~rk*{H|t=Z2Hcd+Ym!8|?(%^~B7 zGUM?w>fv+9e1c3w9a^uJe7))k?v%~OGrKEN>D-1WSugk){%6obhTX9bKG`wU@`SNF z^}!&S;&~6c9#u6|Q{-6a*<^Z(ip0T+%e@=(9s>M?*UU zbhxzs?&^qq`9ED7sWNUdzJBw^ z`J`qc!;p-=?hAARON@|3ean5Fe3>=EQ)iZiWji54ct131zbGbflra}#OV40dfJ%n zNsZo)QA^K*ZWi7_7xsi7axvoix|`@decSpS^kKB7h__wpt(dn#^;XK;6Y8xjv39ja zYpOs}83^TYHQ)>lULnpqr0~5f3<7>l(7iRy!uuYV*Sx`2_Y>@pRE2xU_6G%C&CJBK4^JS|6{L(~eQZ0a zW`m-yNlx>=Kk?AF#jtJJ8eKDYXoSKzfTL~oh+r6;`5YJA^N<`DEEsqU`YEE_Hs^?r zn41zYNv==H8)RSgHL$PAynRWF`M5B441c9rJCBtpodri2|Jr5aJ~nhwFyFfH02|iv zp;CFw4O^XvM6RyK7k~jNjn;SSc!n=FLU@O0loN-GzNNOQW7l&9QtT&-!e5HDzKGP& zxC}KUt(Nh>yIY_h)PsaKoZmSkK12Ed@ zZ?bBUYLw1G68Pk(I>u}*sY#FA%{h=Kr4y5y z>8$oETJheyU{#vW9FE^W47T?*dx23vP%}S zn~lO#-HU~zZ1?heo?9vWByKG}Wg5~0mN#k@ZA{iyBDEDsZAJ0VkoK%(qW`t+Acx?j zjGy0gVCA{VU?nARKTY_y#ldupRO{=6?27W;k9itvd~!)Bh#>&J%>TVyDiqRBeVi7u zTEjfsUFy(Dm{C|Ae@f&tc>id$@BW62tw_;i)jCgdFtZUF?*EEJB$hL=!H!qYr`6#N zHrSP%TX^;w4?SFfm^4Ps)LoV1VcY5-fDe9=VwDL(iN?EiGK#KZQz}^iQ|*ZTa<8ty zDM7`kBEEEYnr|~ddH#r>&_v|dG)&#m@;jpWKz*ay3OajnYfF%UYe`t9-;l$H{KYm1 zi|D)wcOicX*Sv|JdpM6@C>>?@1xvgudP2K8Ct9;d#;z!&MZYdB zf;(daDPzka4gbquY{Rm|oAmFb=+`A8x z-XrOfV1lp^wA`($%Qd?cg_6aa>c3ZXxzjUop@_9MX9c4a*bDEnP!NH6%4B zzu1i;g4S}Y9+Lh93kzXTOX3qPi8UM<;yM{M$dgwV@sQ@S-XF1rj3Nm^j%w294rr3W zz7O_AC&ys8K=f0ASa8Zov?`144=!hFM_IvoB(8E4e~zF0y}YX<+^YXCYeH}me}R(P zlKwY6kV)MdAD(KBr&s9;NJ^5bk?nOsJxcYCdeYf((j zN)R}KiMJk}cYzLKa|7MYA)QRSn=j=DyMv7rI}WcKbMk3E*$4Ye?SmXeu3_Jt-i`Nl zci(7A^$&a_^oNo@wx>BPleb?g%FUQ>wp^r_h%%HNReuV*pW_|l)mU>H<*f^?`n`?EGwgVOH)SuFmn z!QDISTyi94q*nh_=pV~$3T}M*_@l+WFcu5#-95=^VRUYHN+)T#9APf!?^gXaCqE2( z9)C3VSWFAar6LbYi_ZR%79pdnw|$#5n^wn%$uhWIE5QEzipJzS>=;9vmmC^%rm_EC z(-z-ZZ+}TdL5w3++{$m*HdKqJ0^5)*o(j>`;HOM5l*|A|GN%Q+&vOdQ#Zu2pK9Yk@ z^(WY=EJMbIhsHv_iZhYgW67fQnl}z#5F_8mzw3QM`rS6Pko~#X+ID-M)*Q`IK}Kv%`xmE-jom3oO6Me}A^Gxr4-6pB#2{@<9^>d^ zr~}#uIVMA6GDZ$@YkORpUEB*QUqv(Fu1aBNm^eT#`%T1)!8Hq$AO9ETtyUo@?e>47 zkMTO6XBezPwA6p;*k-62z|4zb!0Wr@H=!91-2vER7%1Qj+l*l{1k zuW`kV_46th7(R^>u%}jMF7m0y({f}pki5VxaS_5(os*ZF&Uj%DIa zZSzCCwusZzICze~bD6dIUwL4_47$d(o#i2r+Qe!myPH_`*~l(y%X-x&6{-ESj0Sd! z$-2SSxTpDCqt9$sK%Li&Y=V@Ui}Ux(rYVzfNt<h;ee5lphVgUqqE1yJSpn2wU_T5XqQ8h0+K7q59K&hL>~ z(JpKAPuvP}61BOB<{Za=uX^P8J}boZ?sj|?v{JFR9}^CflybD^-JNo==lClU^91>6 z^!@yFmvhn&Y#Pir>Z!%nmK$h^p6l2{cX4`#LSG0uLT#Sf>Z>i#56UTpiQ3{sZAqfG zG*MfYsI58?cLm38K*_jxbK1Kog+dg+OIW9@@ zyEUQo!=>hd`PgD;OH@+UXj%NB7ilLWHkF_@Tz_iGWox-fazuD{Njbyb-3@k4vH6yk zaY}ntF4#Cr-&M#_m+@YDqw+hor7Bb4?V(JeDI={&mT;`t0EBOeS{F7{t$R?wl&G!a zr+8_iw!UcRlEg!j;k&c}#4fRaB3P*A1$Ir@;6c-`no^fO^ijE}i=hCG$xp*3NtdTM zc@b(zREjQ7U@1}8L}=2qNxut>bF+Z`9kslzx988o7uurRp|a!AcfaltpLcAZzvSv4%;mV->hQ9GI_K-ElyFhmBO-=p7& z1->GVYIkP3F6?mP5iQYusC^(`V&cbf&+ime;KhTPtscVoaO7ay7-yZQ-?utwzsY3a zOr`Z#(D3PUsN?VLma*y_Uw31soYqou%m}*0>EgFygbuT5g{PWDlz?;1bbQ^K(nxvz znxA^-`{{TnL1@HEU&Pz?{m6WO>v!z(I&XPBZGX+F$Yg7m`VG21~n7o2}bSI zWhQ3x2?K(ZX${j*Kq$D(NOi!9H?zZS!Z8L13Cr5v`3;-%SViU#VWndcWHN`ja1lHSv2lnv zdyXG{ySaGJz_MY^7-P&3K`{Vmt`#(4?x+Kw>sT`gn7!n}mNezwg@?2)X|-!h8a-lH z)??0j$U8get;A7NTOZH}iQsaG;tn}6eo0pa!+I}%EE>MgUr2|SoBMq2ka?g>r$HBn zp)1puz!Q6INJ1Z@@_I)dURmqv@l%Wnuv2p;GGJ}(Ay51D9=ISBdURKb(*jSt4+{~D z?OX%q3UB(swQt^W#SLExpL{-lKX?ZJk%?#VjgJ5Kltn`)|FQfYyt8~(>q{v>{FB|E z&va^m8^NJG-IlY~+jV<5zk3BJfTgQ!;CKhwuy&Po)jk89P zF9{)k86yvti9$qrTfgJN93)(bM10;?Br9Jex0VIytc0D~!N~D7zw6Gb5l)w8t~un? z5dvrbW!C}n^M!yK|IB1s{YDMYH;flPY zDhhs}fAxZ)&ag=#Zyf5)7*k35So6VAX2Mhw--D%qQ7EULbHnuvntEiOA*bXYd_Ys= zsHuurg#wqv-cIdVt9hql^evPs);+93AjT$Re4YtrX}ioC*De#Hy0BrDPvIsC8j~xp z5zomX$Ld%>(V>w_r)nYK7q=ezA3K#pIj>}=?&v79=zmofeop8>c}=<6zU6;co)zNd ztT5cZP8fe{-+`r+#<+E(8(?Ob1y{viz3!u>{#3$W15Oc(kq_%ne*Vk&tFt@X$#J4A z2T2?DA!j?ab7b3&NiEOGBs6q+z>{T{2R$_e+RT;_*JD6a0li8XW%07aELn?`60eP) zszfG2(M8lJ-H)o%Oa;*7uyx}aB1EO zyaBC&vd+oC7LLtBObW!n*qcKiT!z>xFhjowuT%>H>)+ z84r2}iKVkq3b@AIiHNZ1KlWqDfbFlSe^Sm?AJ3|1U#Jsdd{d852@X##y{z%!U%AJM zA92S~bhKot-}+jwllv`cV?|bltx2rEFVe#8igCLijJ zS-JqUYZomjI@*Xw9{YiI-s3%?o>N&=9WW}7?yAObH#gr}n+_o z|33HPEm6Z)yo9=+C#F6(-H6QXqU!`$j3-hbkK1lpUUQ}+DWSUGr;@Zv;;$B%4Y^7n ztZI<$B;J*{)ums9A1TuSnFau&Wy|o3Q89C+5~WrMiB}*i*A~Y+~a=quXOWa0)Tg zEm+vTfGnOV5D~mD{MB|xv^ToTQ~vC8E&GcK2;FY z6x-YqbGa@FL|;u^TXf~8s6?z^nd>Srwz_=>5QfjZs{0$DA%GL%*kWkLlhfS$}S4@5R83S<`Gk%Yw5X>MT_6J=%n{AIXJRp$@`XsO?kgY zFNSdot6S!)+aCtgRpYTYG&lrI2CkK0cR2C~Yx7^kxUf7xlMtiJ^ENIl_tq>F?6q73 z^9V5C{3Y_GFC+`J|45#tvm8-=MG*>RRbUunyJk5hwT5yUTpiWM74_u}(olum@F}46 zvWQKTHgn>oJIn%+j4^9D3EJHz-CIYDwIqqZX;`Q}Z|uJ|{Q5q(UQA1U9gC zZ0eBMl8~pHT9lDwsBWCLz#NWndnJ&%8~XMwD)0EJwLKtb+4>oJAX&sRe({}u2m+ww z23}ic{MdA1Yb7tv=lzM>#IppwJvzb>$u#s<_NGWUE zdL4wT8a*j5Fjb9dA6`|B9C>fY*`>U~AnVW!le1xrk-SO_qPMJ3Z)4pzq_SbAmh1}~ z7_=D@$71qVBNiT=fLwTV!URf&C+NbqKx^|Wg2O4s&lvI_m%*~Nb%8(xB5*5j>UJ;Y zGmQk{MRO091A*1#YNo8te2ri0al4rvseXx6NF zUnX*Zm%z_ratXn65??n24TZY6dUni;>sB@eLR<_LVvY8@6a78FkLaKC}6h%RC@|g*SOsgX5>Gf>ds~F z*PWl6OEWFgba%XNcU07L<|%u??armM?)_`vN%beOMM^FLGT{&SA+EEe#Ab?ApF2ge zN-Io!Tk`5;Wb{ORT}0mM)F|v9D+AKB&!HC)F*Druf9z^7$t*dSESDI8rEt^QUY$uS zfW2$32PnlhfoO}n9p8?~lWk#ZTeef?>l%+-<()1$&Z#@sHH#^(8|<3p#ZV&hWNXT! zZya$J6iC6(HF4<5Vh54@%xYIKm6!YwIvflu6qkOJx~KodQmdf&8`_rr_J8V|y>2;D zlW9&3{^jmmk-U^zuoZa*jRcCPY`y`ougU%|Gtv{d%h|p;wMzZSJZ?va5WRzc6y$J` zSX#%@sY@+U?xh_6C0Ip|Tef(Ix{HDPR|GuNah&3RbVq&#^Yu3jeX-2r&86&!n_-Q{ zmA8pLixB%67%Xqm(T2tqq1vVe_L}9cl1MW`iE##AY|<_hIU8mAh- zW}~X%L9agXowZD^JLz1CM#DKHFeb#uffhlHITzN|$TjYiiphB|nz69I=P& zFL0%aaFG+bgShFALF2sQgi8>r8XJ;7xhx~&ZEGV=M8s0pIlk2?XtY>Q!uxsqWQur8 zL((RneRue7>SkanVQuHYY;qNF%-dWJ2$jSO=1BbZByk>SZM~B8mV2Gjix0iw`0k=| z^&c5H)s{9Si`{BFOtsmjBP+7qN?TYXn2hgYL0kwX<~VBxn08QM2`Y^zfl+BarqTb(vfu$fmQJF2=meU`1dI_+z<>T1_J9^eX^K&1*_ z8czO53OobuDS|%53ba^5WXf%7XhvW1eBDE)t_q^(ld_lsfWVLp7a5mJS!}I+a_Ht! z5)j!nhLx7YkJCZnVfQ@J>f)oh_5YnSyfA-+=vBR5;y%F z&v||2+{vKJUT)|@UwJVjShz{`kDY)UT96H562 zz0|bPkjy~fGQ-}|!PC!GkG0*m$llvRbgHS;G+*R#L{0XVE;8C3T{xE?qyefQf7Hz&W00t++QXPV+8okNdS`N-a`?9u$eZK}RG`RR0Cz3M-c zSDCuZT_n5FvOVUBeIyNQ{l;IF#LM^q!F_w%B3Gxd{UM{~4A~FHf`e@<79^uFv$C`* zWSC^f>mX>2_74~F(@b1vXHmAI|2G#If;lEmr@t3?Kb-lj$a<8a%6%j z)D9}jH?&I5?2fa6<e0{%x$glguR#M(^A}8 zxLvXJ=H^cfy?LOeu-(3p@j|GUu>23UHS4gSXSX+y$jzN$OuzYxkxqawACLdhil6bW z`N&}STX+8}>b9Jv?6|2Q*~XzKZi?-OWlB!_R=SYF7X{*d;|bVgbzaZi&d31*fr4dy z9*~X+a7!;)%IY;bX92;YU|C{?Z^_cW457jMB-7D!a?8DEelRAWzgy^B8-KzFnjlQ3 z-!3cUl1L&d-{5mQzD}tW*5EHj6euh*CEP6l2F4Qt&H+|@uJzNmHL`WFWZ0Rw%Q3uy zaArGwrhB>Z0biT6yQJ-cqk!Dr1C^&5yWcaqX}T&kqLR3Zz)jc}C7cqnASU!W z#duhoo#_e&k?4b;qLT4bq1EGQHyonc{_#ZSMILu0<%@RyQoy3hoK*ZCXF*ovNo%WC zzVJ?!!t%P;Fb3-?xG9LAn`CWyo`R0=V#XMZ?6IGV7qE!MV= zaocBHX>;j=KR(?C@!&=oi1!UfKkCfqh)F;3faZF(#{*jG!D}9H&~#yZR~8y7NWOmq z{s+|M2@1axF!FXcQWhX6JG5JnfcZg)`!*+a6O28F=`2ii$^t<%l;|vTpYjsFtm0`g zq*@atWo9M= z#RW~Sy{oe(i+JB#C6TtaEhQFC4J#D?aJqUk^HHm7B-gs~gb*&R%{{WDJ0Ww-y&=>1yHCA%@pu1J^g0|&T9v(4 z<*)5y#AnzpdIW&AtaXVc33J%{+6^3?rD%v{65e{434;8(5EQqe(efQc8omgt7}H-# z$8d#bcw{lck|$-R9}JJI4or&g$wDhF_M}?w?*gF1mDF&XW;#S?PV{DTbs}MB;Miwe zI^$}I1dhoN%AM_B{fetFe}=nBQ4(E;l#`t3v=#W#TJ1_}Aa>X6$OE$dL8T76*9z^> zHG=ne(~9hepjCel!P>Pv)ggN$J*zf3TpN`$VXV>m@7rGx;nNWzFq4x`XG{ z7!;-yb%%Av(UCw*Uv!vkIhgc*ZI=`L+F2-I!hdZt@+quQ_OU1H19;)w%2X$OGo-pj zyh!#xhM1$P5tdB|PhWWyw3kX=oEx2LZ&^5>|=2{oA^as zdbhyMZ*RGDt<2Ou)Kq9c^Ktqak*hlXo&}djTlQsM*U>e&)RE zvf22E(N?p<^)E;0wWwuJ#?|3iLQNPCbGr;CHp`H!?N$LbeQX;-V6_M2eDQ&-HO<)B z)ctr&z}fU&Akph=(qibv2jnKLm69*ZBG#(f)w`)j)_*^jZU=1JjLBAY51GZi^5b)V zN&#lkz8Tq|Ki4+B_x}0+jtP8}x`X_k;W?AvJpQiXZ>Tdo2&<*rag(N#0nHaL&GjW~ z+1kEU966IEsaG&^uvMZ4?aZ*#TmOk)?_t|_FyVDy?5cy=XabuLJo}d|c7ZZlt}wp| ztndj;^4S$k7W^3&<~Y*}Pd`oTlRvqK%uRk}lK@DN-lZelEfM3Trmanf>>!tr zcBhQ1yuB?m8nR+@TI8@`bxljW#2dT9+TM_fG(0*6FK@9aKOctxf?Pg~ysjUNaeb>Q zP+TkV#Bf)(HWPOf{P;5Xex1HgLMutOYUS}>0#B^}`eKalH%y3Mm$8BHBGY#+;mr4- zhX|FU|C_I#`_Xo_xBLb`idWph%*`;=BYMS2d50UkD>m*VHr4Hrld1SeuQ3ymFa?%@ zJz!k6#0==FW;G>WVLN4Ea>~eB#-hDRY%#H%2c!9pzun%V;o}CX;T_hcud88jn{2-Z zF_*vbJP?MHHgUFNg<8fc^WhIJbKO*RC1?*M9#-#dygrXaW`@fCV!F2?=f~p%2JgGy zQvV=-v0BF$Zdg%}{%|KB%!MJ~m%o~9Pb?HK4dcs2YnLAR2zUc8#gm_>T@2C{>ggd3 z)jqNv!O;9z9A!HaRg6N}38KO5B$o?r(8P~BcC?bxAs#zyvqy;c;>43uWAV)(MxKIl zWdS4CBm6CHJ`-r+iUsk$tcMIwylt#=muD#E!Y5Lha3S{6VokzO_jJCXKEs7gG<_=z zAP>pT5>e9_lxF%!geN<~3EQs|aH=*^7#3TaF^+JwJjI~78Pz$C`;{Uku z%fKYq$`6V+Cw)V+_2+8sgdOA{^HOmyo0Fe+Pu1eHj2P0W9r!+`Ei6K$IRS=Q7hsx` zm2TdjtHZEhMX$m7hFk8n53sOV$FPscrEfA!{1F2DWUkLS(K|LeRYkKY3S7+XEroje zy^-Hrwf%&;RUNTkIKI~ur^e{;254B$@tc!}nP9fCYTd$&Jnu?7nWjGHo@UJvx5ldj zZJH50$m1ATWi)-Cr2!PKnhf7i>$pthIK`@_QyL%9tG(R&|w5 zaq?1pMNBGpMrw^i{^sPXu6+-_0e>53pq#iagsf?&$2Yaij=&dfY5t}KgLedya~81* z*={iIi{7pwQ@`%)8m&hJfiXzgH=5Hu8s!m6@dwe;wOWyBg>vXp+JYO}<|PBQ<1zu*&H5}O}HcDsToWwxh`DN>jP z*}dHbdNef;&sQq>3X<`Y`8DBF&oS{OXd~~n-{NXbdX)8ZxMMU@aXh9mGyNP6qNxu$ zGrk%B(}4Fa4pJSzSCJAxU+KJ=y8K=gHkx7(7JyqecGL5WD&tVH=lQV{_V!ie@HUv3#Syu$0+so{WAjp*iDU7zEzeM4SG ztjOMgMN@62cTc3;XKigF-P%5u%M32CZ{Q`qAs9ktr0naa;6vo&JPpRePW6L>u~0)Y zv+>N}itjG<1Xg79viDUF;B@g969UN#FOdj2H&K0-Ey=&5j4p68vR_)#i#)wj-+YPc zKlAO9h6bnlES*)BhU9e0+0_zFr?RgqTX9ikc3?1eHubH^ju%Od4`gpJx&Hb4sa(e?HwHnO zTlYh5-SG|2Ww^D?a`VB%Xg#X=`~PJKlHdBf{}Gboe~^OYi(E<^rV2B*Oxf&YS)Dy3 zv~MT?$Pe>`X+?DEidzqj3G`29;~dPP#x86B5Gss4FIhi5dty73CT+HWr* zWU{$Iva6Gh|3Wl=vb}Tt-p3REdn+Q1udYv$PFrV_HfWdvd+1_~EYLre3c-B_rYyP1 zIxgCTTz^ijF!1VZL$Wp3L)wE4$y0OK$%M!Ri!*p{PBf`!mp_Gt^EEWVTS;9bBYE=1 zGlShaKWg_8a{n`_?Wf*}$;Uhylhc}IM?Nw~J2|v5Eaj+PwDYFk_EUqgkEU|pKf1bD z^Nx4OjV5>tVuev<&JC4`zN^gTJLF08y=7EhscKccsX6~~(OWc#7iG9Wx*!MjSB$7m ztZBZkVA@Z$M?Z8@Hv;Ek=ULl&;?LdH^YYjU10DO;1#05w#;o6!x@F=dLOVGL!q)<} zQ5^7SfB)o?sHU`0?&R>}j8pfb*Ti^L$xnVWd{P0sO^825q0S{!UUEFJ1k@@ZQ0u6y zK^5)eG}97+w~Gff@|3<7<0)uZu@?_c&B>jpPR1XVKv~Dd&fjYaYQ+r~>k{vmdL?|d zB>7ZWuzJc&;~#&5epXwZ-{L#IZeE`$hw;&?XUcDF^uyNn6Ekb)-mn0xZ?1l6IHP~f z%<_fRb7FUpV4`Q(f9YS&Gw8(vI(-dhV>~$Jj4ydzQ+h0>NB^b|^o}o83qV3D5bHu; zrRQgD?=6$J{VK#Y%}MWYQTo6XeU|LO%9h9?pS4+MJ>$^`F~}k*5$m{+*ODld@BJJ^ zxI3VV8A}*?0s5LB`IM+~VJ~Nl+>DrfyM^Rb?=?545zVJ^dQ&+$bdpk{kDb;of%@3is`@SMzWDg=w5mAB_g;BDn8_;Ap=63bU>GA=%4y-;Xfd3(6Qn#^fr zNWYOP8vIV#t^AgKm#8rO*4@WHw|4Q*qPttHPwnTS;XxjroGZ%u-6Kh7n6zJZhXwj+nxS8Gie3Pi@wfG z@)Z(h{tYPMEv9BD>v1b!UQE{GWMb;fzqyffZFQiJI7oYM&navIP=~S~TWpQRd?F)XLU84-Bb3?U}T=J^-siyrw&9QzU0ec!|L>9l(8CC zdD4s{14-V_NeG$^>v&gY2KglmFtS@#Dyo~cLrOi{njsOWY9e<+W|7k6GjyYN49>$i zuoD1E=Qwg@r61h$8=jHpaxk1XPV{A-@j{^o<16eMTibc`uEXpPIfRRzmb$;}t{t4$m8HZQ%tqdX zXrG4>B|=oq2E=)OsvCHY0k*QN33_+$$-26RV4Wy84LZT;wOB@(itH)tLS9 zaCCwb{7S9&aC~sg`scfkpd$}Wjt`89U9;)*a}{GUHe99dm3}Pxk?td#PKUmS{BOej z#AtRF4R&47KY4>yT1XYg+N&lAjnJ($8UDyA?xhm#0cR3o;~mBN_rtS)b*iD~{P3Fr2BGm_6xnkf#(AN56^ zjb^(<9tH=21z{!5a(6QrLzdQORChB7cvGF7{FAxS3G`J7`;npcBlb^k9*~=1> zFzAq}Ps-BAU7$uDtTvJHcZO5D3htj{(}2BhG(IKB743ZchpsrbXmAGbU0p933Idr7 zdqEY#93r}vMvgmmgLY+^RdK-fb=m&ze)J6N1M?e6~&@cpb- zp?h0@3A-^Y=tcgis->}%-N@u(=XzWAp=6nE2*Sw&=0Zsvn(n-?`^k3w=LCA2ng`qb z&KKQiEo0%(T^2A%6c*ScoeY?4T;j;~XHmt_XJ@wGJ_Ra#2AJhB=NX6Ip!I-#M<{v? z_*Hms`*j(yp!IMKv4Vcf41)t%-8CMN04bChi$4IK0u^@FWXJpbuoi!@Pc;ZHcF~Gv zLU?fmC&0Ia3k>5CpkDlgnESiIHZY?Rhbf7%$;0MaEYMdu0w(~}y9la$Si&p#DW+M= zZDxu>BlK77;Fe8a@F`A^)$uvD|FTHW`hITy4wEma`6}JA=`NpPQOD}r8#3J`!YEm# zR=tg1`j;2qfChZW{k#pfinj?hCI4%-fttWMiS$)O9{q!x#B_v}d=e<@k}r=FP1P(D zs)AV%aP;*EUt1DOe1mI(P03FWl{DXe!M9b@o09j8PW}POsrvqW!-x}7o)|OL*`Yc+ z_i-(lH{bf&P7ZCpYH_agDA(@g6lqkft9Z>zzVK-rxm0JzA2qx#b3Th(7w!=j1;OZm zwM8EBTJA+pb01xIv4_6J!WdENemPIx9da@nnxdB``)Zlm)M<@8(XgxZ;72HZ?3-+G z$(m8UrIu&C`*cbzLkl0^d}dS&yX2kszEMdJq(*(Nj)vyYXRdO6>s(02zM^##u^R7 zVO9gZ=Bm~8>6+P){DHZMmr{6;=tlvobGA?eN@W(**z3~}GshH!IXZIX6&<$gh(>_6 zW?L1@BeqRXmc1M1oHoA)UKsbP1hpTdJZ`XC@0u$}W zM2$?VU7MBpdA^BY;*(@KkE`(Xb~&i!V!6pNhvY_sbqkVRHCk)Q5o`BqzP3aj(9Nl} z^-{e^=C9N1rgKu5j7i;wgV?hTjm}oxfD$rqGqG>!_8#-@alP#ad&%E`=i5%nomIyE z3#DWwy@!Myn@v0D$?8sz*kT}I4vvKhXtXM`f$1$t<^mU%un^I#$Jm{0vRg~jV}UBf z7Tb%#y4`J8=*(BN51&NNVvo0H?bw;ZoQ*gNX-Q<3$9H9-GZ%Ya;7(4PX`sz%nmA_< z=&m+l?rCxDKf3#L+1LPtlb3%oJwe&;%CkeVq$R0Di>zF4&&g*P9`{S<;6z@xI{u03dS39wcV(M0ft9lcF8ca6FL!PX z^z56wa$n-_C;hPKK+nF3II$>pF8XzDllRS)vtCtl&%VIQeJ{=WNlDS;J^L*0V@|14 z`)~Uvcu%dIbzI3LuH5%k`;Xr%dW@6ZP!igc_9Et zU33U9UAz??c3(1!@QhLCFWT?+VYo4@p&HQJs~g|*Jl=A0igc=%8we`6LdmKiFfvuu zjvHNVwyGUHMy_fa(B-UyyC14ndY!3ivxciprK;L7qpS6)+R>mrMYUeKNoFpB+1`-oL=X=X&4vp2W#qGElT<<=)%& z_jhs}NKPz50qGMflOO-_f9=wHpr|MH@wYv%1d4u}%A*Nbxl@_E2kav~{edFb@sYXR zs>l`^$~MsRMxbcmuVf3m+3e#zuLp{bd!O_^<$WSC+3`(9chvEnzbsLXz4|nKj+Xmj zTkrkF<6{Cp;qO2A`xpMY`P;zXXZWkm z@0zv}7As-tnthqsAK!i7Zq_5=wSD4#q|e9n1SM)h$g`lf>0UH0y6A|t?M<{T#!o*y z{b<)h^yIh~eKim7X zsK52V0iNT>+U+-cUeETrr*c0Rd0iZc>dtl3Viyfdv;~uCb*^TqEnU2fBLdyiu96*T z2)EYYoP-b=@tyAwCGg;yPoVdShyFDm6=O)WTW^Bvrdf2c!Zm=$B_3YKFxU({NC-M# z9~u(;x3qVxD3#5|n%ehq#N_Pn_CRwo?-L@g67%Mg6dYU=(wF3$pUy;+{HXaT zy{4w*^~A=2g!W}Dq+-Z+@*Jw0L!{3-hF{H zp9@Zu0l>3h`RtJ0`0m>r9_A(tSFY>eCy1wzhE>TH&gr%U{7<-*BbtQkAkW0`6Lw-<#AL+JjFAuKT&rW1dCLNb+}^~AE#M|UYTmM~jxFPqY&@pH`Ak~EF$AO9O>c=lh&~coB+wwFq*B?IWI?u{yViPer~rT%=q@<|=O((|da^$Y2WcqRUclQwY}N!36~zym`ur zUw2+C->uA}$`%e+_U8$1`;K3HeuihR-!qrS&yQX2=JzUpcsT!~qw}l7ZkeGr-PUuK z^=0YoJ#uYMzafp0IabFyP%VDuLaXBr^KgOHp)j@aGZ$GMOU(ld;@eaZKl350Lxx=O zGZ$MOcbkVxT*Kh_nGkV&+z!cO>?oAINa?k8bt#na^9sUNh)l%?a=}d2Ab?|(sU-~= z&TCHYdu?b{KTQtC7gz>VAN1@2>4q2AXX@Oc==-}{{+`Nd(Wa5)UJ__~7~wpa#ikbv z7&GiCX=n|B=od$)#m`(4ojio?_A_)or+<#Y#L{;+lK=jVAmwziUMIM1mBUR{n&m2t zx3l5{ABy_p1K7?kDl#{M^dFzT__o0}aV}^;9 zvjDTW7hfI1_YT$eSCKb<-6canQB)apyQm)|#HcD|jiD~$qL>Vfrhx6GT|d&T;|s!_w&d zcZ2^I!1gddd(E~y{oQR{YT6p!%?wR)h4FY(gO@&xk#mJ;hcW={+s75kH zv2G@T{oT14%t-Mi@9nV*2<}s6jgdW)#+1Hqsc`RGSl}eWU(Xts&cRX8%{sw605x&| z&{-4HIVPoZSg9PSyv|SM(hsgrRQ6SJ@K@n_MCD;xI*03dG=AO0#N1G9ePkIl zW#gEUQ+>qR`dJbXV@aTu>O-Zg2q+sdQ;|D2S(=-#C5PtbET!Y*K7i1LvBg7NT15aUq20Im`<_$r6NS82dUbzzc+r>1gTY7X*99zWdpgm+b!0(*hgaStOm z%kx+8B*UQR93vmaBiV0Fb{gZ~gRy^nX$bUjRg|VC?*Tn@B?Wq(Wba*UCPos$67z%! zY8HfH)O0*^{rgSFCBx?vOKqml6q)IfnCW07Z^GRg93GwyG0ZMI{I}yU&}I_egTwA5 zR18l-#fV9$7@mX*CV?j31$q&S`SfoX^x#jK>G1!I^@doicyS2ylDPi=1U>6*6zG>- z=Yrng$o+gY2V{2rI-PYDYc_==aC|MGhjCw|`)^m2Fr1XdIW?x^OzWqI$9izhA|{5+ zX`=Z4DCW`XZvSIyoKXbi;8%;MCJS6)vPX6J$1~jy!$FkFgB+^dze@f?Dlz`*`eA>3 zYmG6`ec|tGR2|`a^>cUl8~XXDu*9ga3Wa>osCf*dV)LW$cik5PHdk`(ejL7Lq0w`% zv$h{36P`vhdj9B(_v%idgaEHUB0n-Et}&$}(#O$^1bGyaYd3j4snR>YW%@;)alT&a zMa8+*4NHlA)P3D1?&}o8)#|8VvdbcSbYIu!-WGFhcLL+L;!T@2`aVfWoahu?HXb1K_p+05H(gW__;+bNTb+M~h_NSy8dkBX zf0ZjLggWLHB*e#?`8fFB;rr+&G_trknR%sa2q}Bq(iT))pe>h(E=niQ*JW{af(S-F zAOd<=Azc;JQ#S5V{NsrioXpY$ME>9^G0Ui*lt7)^ROI$hq}m#PL@aR(Dr);}rH$mQs!qJDF?8oQNnjIfxLuclBA`SZwL(AXeTHw6#=ut((= z>7P8tWR8`OhWgh53g+0zF00szqLh@cmOy_SL4q-BwK~xg&VbyUpAoxQRX6gFI#$-4 zd=aH`&gX*mCNhm|*tDCc)EfO#4FY7r6CzNOl=`T&4o<>zgZBK~pZ)xS2mdo) zUTR_d>>lrv0v&E<0AZl3Vw^iQ72~OJVb`n)YB8~>H1V;12O22&rj&0D`Mf#R2KU2J zyCdAeXPGr+*#B*wo29#~lc>mKN%F&2aCHvUPy*h`hl13HTQOGY2!B_((Acmu5^hE0 zEap#e&TVL3HMV(`AHwnrvL%-?;P|7t1cl+^V}?$UoizvnbOHX={4~ihH~S%ysUU~j z@>38Z?jl{!JGZ)}0>hu58TomI`}s{y-l@_Ljr_dO{cPj|_nDp-?E_vbS_uB>)?ZL2 zQn%2Ue$Qb^XDBXvMPNo9%I{y*dA`CA1RBD8A-1;81tc>3`uOf_k@i%pKlpHZG|Sy4 zm#OUCrb$q!!M?%I|M~mn6s}aC*fwxQRXu=N1<%X92l4$9->suty~3>M^0OX!XX|%P zfUF)=Gzy|0wq4+(6m8e}o$9efH%W3;Vr~5+D3_`cA5Er9(r5QbA;QO8?9f~sHd;@* zNzHS+_zRVS%eDWn>(+NW^`+Wo*%cdQj8xlA(wVy3^drt?Zh5v_;#x`=_nQs87g$@?>3yethB~V- zki#()qq@E44X?KkytvezS&|LLyuw-8G}n~edbxpq_rV#r3&jrVSpC?JcDl+U51|eF z#DKMJ|K)orx@fS?$110~!+Gf`Gu3@_xVp9OWV#3vcI#Zv=Xj+rGaY@^>f8Xf6b*vd zrPGhX87%6$B|HVql6tG7LG1(2={rdeLo27+bBgCT(d_NXTZURSRQL+FRrM#6R?!A@ zZ{hhEyIn*zJM76;1-8^SY^sTjY#^3* zqBj)#c2lwu8YJUYA2&i%^Vf%$cORi&ZYUc1-tX(C_u5SEgLB7P1B>0frsM-dSZzQg zVE_;>rIj&{Yx~Jg&&5){G$oIR1W{k2T4#Y$w4)dfPbJZGl8(v zSXpZHFNBr3=6>JmoI+i|t;8r#<+k+6CM;Igl)P+oXZptsP5)lVl}j*871UK_bw0*- zQ|^_&8#T{AA)QX;uF3|4jAXXyw9wd$@jg?mI9^?bzS9Gvi>^%-g%?{C-#NaS(i2CQ zZX$0}Bkk|K}y@ z_)yPIGxwe)^-jShMMsb6RBcpWF6Dt%ZYg>VEWACu94x$*T?GGa7TtT@g-m*I+sT|- zG7C+|vt8u=4(T1N4L3mcwq6_zfE~92rm$v>g@96qt6h~^(4A%KTaJCit>9L-7oovB z15L?w!;PYB22NG+wS}b-j#l1F^Fcbc`&XmzC!`!Shk1ezABa1>ySY!>Jl?G}Y$t0` z5Yp%(1Fa7?CA%&LnbEr!u9XKOD?`@SKZsGCW|!weRB_~H&kr-^^>%rleM13HcjPO% ziWL}Td*A$@E@Lca9)=G7!qt1ywq;1=zZv}|?m|;2`4u<+q6WHHmtPf*!e^{)Zfvk! zM#kF_ZdWZ7*AXQ7jVa=?3_8i~PB>4&MV|7!!8`LjD|4HYP2o{EdAVDE8G!lGW1|2w zjxSBgzyHvP0p}@-WJb0Xe@z@HUhu)LF!1rpEeFpfj_-cQhb%*wvmP&0CBrMP;l|;W zx9d803gsa+N9UPbWVfo4Qk2yC6WRi2gSzCZ&*;j;eP(o>i@&VNdtAaxb~9R(cGLJ( ze3=;`b2(y7&f>dSlTD+`$zG3Uht}lwTooR|d>@~+Ao~?vtF+-pj*>q;VA%co_@eQ;9y)N*>(j4zW4q0}SK%kIwsrnPOfXzG5$VaES=}>` z-G#B=o>WZ?mg_^@^z1Wm?$Nllisc}$R3CR{vW)4#EltU|JK!`Z8dNir!^8+{ZUJND zS>*Q@jT+fi%C*o0TU*5JdFIp`BX04p2H8rDvID#6?ebz@(hP>RGp6K|+#bf=bI8lQ zbE^G5Kfq-Jno)!#Tg?xhT>*HCj`sVDjT-gMHL0RdGQ=Xc?>6T@ z?P^5H^LXqO4@0B{y9_Ny|04O2Zorp%L7NQz>i}Tkv6Ck$xeyi_fPh!ARRl=O9zfB2Ga!tgj)fF}+Kg$y;o-J-daZ~aZo=|sa?Ldv zBTD%0;bXCry9A^aH;ps$KLD$eh6Mmi+*9(@wFU=_=6Xp+!ktnArt!^wvgia_=*^5f zuVqFwyfAvDUH{Vz=SH91Q)AfwvnlrfofP|zBiq5q$=0X)FDW`9e$>sLX|j(ybgZi) zmEmQ95)if13IOTcZ>HuOYSR^QG%rXfqFuB}llma(j?3LQBxl@^Lbm8+W`OWNmkTnQ zf&L2w2nJcq?{dvt|5&Os_|?a8`HdNf6pk|YXp!F%F0neV)hRuN0WP?e*91P;wIBuH zyN%?A3QI9C=`fWg0?F@F6-ZUMAo-6xapC(_H=%ezGT|m{=7&-vrxXno{EL%VVh%fo zrIf_7e#px>BQeJw4l|r{7{Af>D@lI*0xDY{zJVG0(c! z45D%Vpdq6=NHK53r@o%0PWV0Foi&lS*B>Qg8G5!H)$?CR#xNx#Dt*w@_+z7sMy~@H z3n`IPbb?vPZB7PD&I~p-CnxfQ{3nYa2F$^heIPbw=;R5F!bhj?YBb(!QJ{~US^qVI zhxFV&gPVtX3Y9s<>j>P*gYcK05aavO;hywgB+v{E!s={=AMEG!=F3v8sz5crvwpX_ zsB+%^2JdV1?aQtj6E%m;_}wLjmEm5X7Fu0Oez{%C$v=(Guhm_3zNgF6?K{7#+!OD~ z?5^1$HUCMFSs zqyc#X9Z1c2lefZVDAlj80dTBLy1R=3hTTu{1{Db#Bxk8Rb$0sO}{rXFZDeC$qM zMyp$a@5RIN(L$M4U`*Q_f9O?_Bm0ZX?H?MW4~A}azLi2UiC6HALnPw^+ZDQKr%T04 zO|ttfups$gBfo`4eDf?wetpC@t0N^~Gfs7`l!KhOQ9{mG5lTDN`N z5n~;W>8OX=!=TkMg|7bfQiE;FlP|+0rOH_yf21mVzjG(3H!LJ)=tdvSU>zzOjwXA96Aw?jgI^~8{}P9hx`iRPbp*@XxPWK-nz#-H+s4zIjcSBJHBQA zM5VpQWuiu31Kk!h?e7S+>r@&4Gr&9r59S9+hDe^ep6Ym+>Go3;XOM>f4(l)&jGo70 zaIK6B5t-RnNMuGRU0d^NKh^DVZt!$vG8861HHxCwyeA>1dDfQSY0Q8$-WRx+9^_z# zTsvTO{FvlDS<7ma)HGO_{Mg>X!R}@+eYTIcpAJPYwjSQ^l&8jBo*H*~YTVNpcV_!3 zlk0<^V_Rr>{tfxMt-m1?Olpp=I^LHP(YQ7jLJ1jH5Xk4B#Nhre>mD%?fU~e+#d*J8 zJQi}Y{t$V-YVaOWsP`$B_Cr1mJo6)c6_;Lp_0<{iSDv#cIX9vk?5sW;e~$k8y4!c) zBFe}bM<^l5kB+%kn?-hi!OZE(xQvX`M`!#l84Z6< z?x#Mg+&cM~Iy%+JniWmS&yVcLl#w0j_@bane!=vn-kCc7L`!G3{GVtv`th0b7A~BJ z2ZK+?TBFeq&-~aO>!Q)n%;lfD?FZ2dW=7j?|3P#L1v2q3LTTeEfGS*=r~>Cpf{v-n z>eOw>{1xkWOb9e3Zw;iWkLl*Ke6qhJs9_yDj;fsUY$}p7mE;%#8JOC2WFrw^=0Kzo zJ0QSht4jt8RaZ`8t4`P{;3ia|nFiDV0R0`~M}Rig%Bkl&YHj01P05!gFhyT7Wf2*m$_El8mUgeSewp>#;x3f2Ff!kdDnfM~!RF?>u3q{b2+f8P>c#;|~ss z*B=8tD$K+k-Z%zd+`d25U+8QdE|t?cxI=?{By39cjX$VtWgHRsVTV$;uYD>usr}4g zbYgq`m4n&mdiyU!_&5ot3T0MY5lp&ruPk@p^7IzGvV8hc29n!-nlZ`&Lrw*7ki}vl zpb21m23baYPwIQjMxi78VUXs-=Hi^Lah?2{ z09bT1(nlyDHq)ZR08;Cq+sf??Ix{R0Z_!|pPzClldhfdpX^}K$G z_bshA`vAHVxP!)Ptqh`n!_x~!@J!OK)d-}@0wgkGlQ|cD}YT$EYpk?~V*?yioLh2$9y|;x8kk zU0>G!$@@m<(Tx+`ti6%rcm1}1V){F;>-PZsT<^2mNwosHJ_d+bsw)Q)H=PB4g<_yZ zF6*_}+I+umTRAR|MBy~n%AOTp6}U=iBn%ajy7_^oW{RVtcC#O~lZo;Kj-}VEN$Cg6 zJWwdldnHF^LQh*AAy5MO;2GY7u#=*NxlZt-hhA~~Hxm2mo`6$u4-q9N6Tdj9Kv$;# z5ARdVGY?bK59i4V-kfQCHV@~U2igim9&b}*=b&x8kM~=V1FI*CJUOd8YBcgjtKEMM z!7Wi9n{$Em2YYxhfyec5kx8*1&!?svB0Z{bHP-a~zWhF~5TroFB{#a18pHNSse4RC zSS%W{C)+m}B?2e-Sza@|zm4~v=j47h z<&VPJw%`mZlV`1MU*u%jhT)vN489C>XTRe<3(~XGPJAXzz`PCxOU(ffCJ31xd;<4u zH?A}fSqAQrT^J8n?zMX&eQQ3FYR}%EzxRg7n`=Hqpzr&4Zm_rOC3teQ^G-C3urM-JSW&a>^~FA0RC0Dv2%DxhtnB~x|bPw z+Nyla77209=E&rlSn=ShOGchvlgA5$a~6L8%+hsrnOVBCvP?>JtZgyW*2y*TU49%= zcCj>ZlSruD#IoGPnlKB_yqS2rjA4Y%oGKX(+0aaNMS~N1R$mXOp&nzM;*vwJvl09h z*B|viO|O&spSs?zBG0t>>^=Qh-6AIT?vFgZdXlpd=Z39&X^!);IA+{mfb@=g=PT)=u1)Art@--wM<{paJwj3<@ zEQ7}}iH)r65tV|CzQ1X{%0|J9IlJxI30|;j0rNIQ-e$iCTm*pFbvg!)RcRgFh-r>-04PSB*73#6dZ^O0__>F|FAm8K&xHFa4QVFD!d0dTLZ5- zxz5cVAY*ivz?MSBoeNlkH{t^{Q5{}j!18bAE-NQd9pZct%!rOn^)0a^*KQ0Uy_zwk z4@IDJVu9i*)`YVJm*<{KEs?o{<@g^-WR{^<8b9WV{YCCm4lY~TC-xBEiy;=ruYTnY zD|O^<%ypK8=$$zeQFDBc)*CK)-!X1@&zbSzhIi0BIP*M_{j0Cm29;OlN(wQJ+OpGN9v0>`%riwp?DvUoE5BD(%17a4?JH%B!^5{xZk$4DXlE zvb5>JB6yhaEl};ThmzhI;9HjKbCx}&)OelcicR6d@~n+Egc%io9J?u%EM>(eojUZOKbYMBb>rf2eVpIdKb7u7?>4m&qsWz63iDiTl z_rJ1D+>&8+ETdI9|5-hu201$2FmYSCH^Z63&tc-(b#>zKl1+{#Ote<6KoceQZYF^J zx2)Got#o8aBfi3;6k@-yd`5PVj^)*nm=ihP`q51sa}_orcEu*HkNEu%XRZsJ3Z$bE z7|zv`iuP$Sh(M|cWfz_(3u2c02;fC4_?B?NrcWRPBr6=ACb^|`{__)Z;v*HugAi#8Hj|ETxwTbLPC^9>nC%j_= z0^P*rIf}Yiu5OZ2Y(#YVa_qv)pFGHKm4H1`e_CoB?2IfYb125=f_f>@LJ0$?1IS_T zE3n-4*0zE?LMgl7laY5?V&T0-3+?|zc%jTD0ttkVn^y^?@sf^-&x>OCQz zue4uLP5t6)4uXu-RFGg*y>9=7ati4aFre5xn@K5pZ8m6M5F2a1ee4x9 z>LPDPKTr9E1|xQ568Amc!xrwl6Q|d50zYc){eMG{{wZ#+uwtb_Bp<9}aDTSlmoJL% zEBERYdP_!hJZG>{YwJ>SnPs%fP@<&OQBDe-4ARLm>6RoTs{+>Md{T>EI~L~0ln0bS z$2Wt|(GALJGEFv_I(M$)FnmGh&b2}N)X6^_JHrw*f=A0a&Lf}Px4U29?GXvr@=qOm zlIO%1bMWVV9*r-uA77TZEq7@m+urSxfd$D`TAH^>Tt_BJo)+1&a}xM4OlNU7E71(- zGyVtYVzHtIl{Ilzxig^CW60iY2If3cx11RzL-Cmv;gEf~&1<<5;Iv=GY*}auG?+VoF2fc<4w{N@K=n1yddnux-_XW| zk#}MZNVMcPHJ6sXk0E&rt)3}gVY-(k{=7d6$4yqpf0IC_aAZE~I;-{5@-}8A?kCmp zU&mwD50n9cME_iu?nZB>-d`X!`?cer&CO4)sV~Wn>r{e9(>{)B z7ahJ_a+>;#XeB%8jG5|a+jL-5!jaC}Qp9XAv$}(=qC;}EmRHWmOr#~rnjA!dhykoz__m>!{<@FrcOcvV1NZcQbHwg0{K+;fN|4iDwGbm{cNx^_GN@CX zQwDGY_MALU?QdF@$L$RTc4HwfTeof&43-o#@Ire}evgw|2|);~`P^*Hj_VRj6S_A# z-tkT5jvnqaRueh7`nmqu41+~AT^c6OM&@W#xvlvur-_d5T9(s9`>m7D_J_>s*>Evw z=4pKpkKBylEkYE%jfDLgRrXW6I$VY-KqH+oo9x<;sIPC@Jys>V#<4j7a9JXjvlP}y z3oIM|{7ZP7lYZ-~mUq;_rG3>#Pr}VJ0z!(90rCaStx3qP4A~0;&G>hUEA*w~&yYS( zz}cAX)MR^moB}!1$nd`6_$owy89171PU%{g?)Pw;NwVY%xEkyrr*_mitPD(Y1gif> z+q=L=S)TddNoEKGj64HOb=0YymgzP)sZAxd!HJsVBtn2dPFOi@OH*oTi#Q`u2?r-B z86HO6ciaD#|F-YC@AlnwyWPcYT}A7G5J>`_g8Zw1>tWliofyxy1Q5vk{oT(@K-)!k zKcANmljn3Fulu^M`?{~w&14Uy<`qNxFV&O~3bN^iaORr@Ae3ri5_n;N3?2U=tJJ)b zY*)T)cbv%-&RWDM8wRrlPbhOAd~iTL)+@@TuFk zy#7P7IePlNsoJ&n{0%9Fd5cgAJMdI(AlVtnvny93YEIR@Vs(x2f#`L~T|zy#b^BZ9 zS!)kzZIb712ugICXOV&XE7(S+Y6&avvo{-*WdZASQ~F8kdxT{tBzBETC9@~WyRE4Y z6-o(?FFt4}xmCqj`;=b%YF__fg?}PZHjX-J-=y|b?SGmabVY5Yi6^<3CN`ep4tbCU z(KLL@e&_wzlmn@jf490`1y17~AlkfK)|{C1oYI`C^%7){$UOXYdYrEw6UN&fYr`sx#y*7*O>R0Un;dEl5#?4&iCk*ve=cyip1u@v_ILo8pbnsUV-^Y_|eQy z|Lp{tESbqovgaQoxPGc$O|Wa-MA>4zI0^xxg&F+(wX>hf{4JY^^w;Cd`gk;=Sl*>` z@67tk*4v(_EaL_*^xX18Jd|-Tfo}O5;A*hQ1@Iqc*pcg<>^T@FQz= z?iO(H!K}XqvYwIlj;-}TNK4u>KRvGYia+n(K-T1GqEFw%4PogrQ{UD%ujaD8FXgrE zN_$IE=>}S24_f!%f^T3Yl9NRfvYWR`BSIPCZJ`8Kx`7*Yj!qo1Non}G!K4n){5=g% zo}j)FZqil9dO?5z>-HDTQ@-q~3@*4L?+#?Qv|Iyx%}YJ9ga)Mkt(m`RuP>Eu)J>x& z?S6>H`jTS>>sr(6PtShgz?-qzZ%6_|7;wpWz#{^&xKq3;gk&4Es+veFHuE;UhB<`b z;pr@oR|G5SxBtx)Zh${hV86rm@IO=(NJO(^{<~HqPAjr zfA>;am@lf~?`uNiSdw{X^u!or3+x$EGookNRpmm=Nj^)5W=^wq$sjK?f$W(EV8Qpf5n(>UCn29{Au?OU3<{UuAviI?0K7XiXyu2_3>94$<|E$ zn$eniA_3)3k?d%9xb18acIjSES zS8t6gWik05;>LR5froW@?11%He`JUt(fyHka8iBXX&4;q+CiAQ5jeZQk|_XbWtd|< z_O$ibp2*-W6C=-I0zEPz@-E3u%l3V+aVwTP&70~R&ja+vV5?6cL z@0#OF6ygY$mzd-b&9}1WlI4n7ly--+q0M9qD03)ZrY>o=Qr_erh4+1uq0&jFYoXR0 zl3hcHPfXM5jOSK9dBd5DvFTu$!Q9ORK%U@8hW0^ZJ}dhzBY(>m6O%j^TF0?4n{J-4 z>l)hKA<45AvFKk%#A<1mi*%+m zk}d0jwbuAlG^I|45ONMPmSWVxAlBY@^~0S1*>PWd4E~7z}jj!q&{os zUImLQOYWZ7dkn8JBjh>HgpqNkT&Pd#z(H_Sa;Du}0Z6g6v!5cvIJ~i23b+O_1DNY& zyepEwmi!yn0;pjH%`Bx=ep=tFTh=7{K}V{)zT$ zbt9KWM>;P-09Jm}dAw<#L`kw-Ep@U!;Tj$xumMxw6B*HK%J4m8NZ+>Fz z+27dvj~-M5xEpFm-~5V)RtMV;zDD}cXB0%V)N@HJLT2qrtOtHYtBW`-V#8efu>Bgx z#@T(Nhtl3&^L3oRp4e_bb*4p>eDF2T`7sJtd6F9cyS5{05)dh}9ymhpIJ14@pGSu~ zul^H#YPa{>huRO0Jd_84P_~1wIo;&;Ge}AmjDS6-+=UV$^2s9DOUjF|9_v znCx}&!etDCdWQ=}LX|wacZo$gFg!Ayhk_AhAtF#g_EfDZUuv$Hn-Cp?z6va^3pZ3^ce;J8)qqe7CA36E-i zF|x+sJ(%fYO{Xxse;FaRVF3sqs{WhXgEI?#NBDWdiWgTT>(U1ej(g?zRO+c{F^Xg!d(M=JH&68-zdLR{Jv_^PAK5Ji{GF6=N19Y z+Cwx!J?*b}9pdQ`P3sc+RI(eob~@_C92tFDcwfR~k_1ZX=bnY6OS`W&w6t1zU_3-i zb@Ex-ZD?t+UPF@^M8?kA`4oo>FaxcvGxVW>iTS(&n!e_89d;c_{%)e?3}UL1#9}0J zlEZ}U_w3^ko^?URL}f$pD?o{K4}H)!Plab{jH4?Pf9M|DIMpE%&m4U1Gd|Dx6$-sR zzx$0%51T0GEYH3^N|bpGCE|R(UzCdt!MZD%b|v-+JcHBTQ>N?#OgUTE%9!vn9ALBIS)&i^nd82bwAq*bYBW+mv;Z(68$~G zYkVwUh+nJut`#bzLmj1%i=EnrDo#7BZ81(a6E9&sx|?lBNu%{>uemO6$)qVjmh=In zYZL0C@2}fU)7q^^A+IKOIno2?5q`10kOy>Cut5Ye&wZH0!{pq3I#2z&4o^?b@qq|(oKljSH*)APfpi* zutND~iK@tqq_xFS6&TS*t?OECbZfQsr4v4GCrsknyDIDhBDIBQKTOmE*c?c=c(`!f z6YGFt|6BKO*-fyr#TuHn!Ot z;!^QgnC(?I0$cPQPRnL79ez<%pvtR4U*eg#p#&wR$%vo-RQOPo1;6!7$v{Q}LTyDi zxfpmPCEl>Qe?$q9_pF_NNP90E-b%@8^EwJt@taKX4A45Y*$k4}=|D~GS+4fXH|=q! zmzgHbGkLys5>4l+YzWip)47{5rzzE@^iQkm_j|_*7DnHKZt=u4f#aKGN|=(Kq5h=5 z;)L&wJ{_N2hl1$U;n$FaW2JU`v<7C$?2XW8=-sI8)G>z6n&n3Fgcu4Jfh0mm+S+IpizZm zw&L{W1icCJIeNlM`ju?d83z#{pu07XcQi$6EPv!_-MRYpSHDGSB$A)qN9E9oaAI7R znG+9r`(|CrBG2zdelsG4zJKJmW|r2w0+;&(tCv}}a^&zy35&hrnqbRj+w;BY)(I$} z0_)eZa0i(>ICX&!vHbQ_WdX;q6mWHOGq2zlwZLD0hE+6eWX5~!{bCt?NbUD< z%x33AL!_jtpM+q8iNg*RLn1SePUq&4V>=XmXWg^fvWx2b7u%KYv9%~(DyNU#=oL&$ zZ83nQVqg5*1lywAwrm_eTVC&>RVM7pT5hluWA?=j)oa_G^?2ot5xH>F} zll>#(d~RLKUVe9rJ~1ncQIs{VZsr)*Ca7YuHLWWwGxkjXD~6LL6-;iT4K;a*{0>^% z%<^3xo##$OB}J$p#z6dw4~-$U=gf=soNjn5?S3rn?k=GeHpS-yrv^aQ2_L@98$WPUrQ4muwE zBn7vuZVySd-M!?OQ+%mHNMTnO@3t*CIeTpPaN$*o6@^QM z3Gg)q2din1p|{B!ncTI{aK0GxroY2-*4xrF85<>Kf~ z^2LkgS$sE;%3Slov=@+e%he{vlxL31>Nb01DL>(wjK!ZeH{gw=9jT2vGAodZ`O~qJ zpqqB-!Bnenz;RGW_J?$UlL4P%F_4rKbhkeZIVD?=`OMC+*KXc=(ysEms-(@}S(s|~bCr}@@hMyiNM6nxlCR+a zu-nZH8V8JA>4mauOjrz=bg<826PycO;cdwbWw#809R75GLvg~D(Gr6bA+@O;p}`s} z>7rpcSXr+g5f7JV=ASx&M|7&@ z%O0>3pJ-oVz1%rwkF`f(9Fm4PH+z!oi2gWr*61g$75x3}a)`L;OZ2rv{E1ytAV2yJ zo{4Fw-E?Kt|&`2Af*)KqdHZW|(EtzXiq7Z|T!amcvD{sks zNq0^gS~5jE*iIZbmIEk4)$Dz0G4X6}`fPfwXY7iWjGHu073rJVnKF0lz*;QDe@(mM zXdr*{zL_t%S#1Cn{|vDT_Va;70l!H0F>xGCQ_r1H41=GW3^Ft_C*ovDiJ3f!0_-(` zY#lgw`;*`x2Z6hZoHrx-lC||h7PiQH$kip-<&PyO) z@!SN6hdYL+QC6;n$m)gJKQq&#B{Sm)&BWaou_90}XFuy21XWih|KlXavs?d8GXY{q zEBq*)yZ=(p#2He$r%A)NCAn|woo`EX-_lh&=>idY_cDEP;uT6ry9T&~VU!&&csmaj z@C0C#KQDTC!;IN4NEJ+LeP*LxOjdxp8ikkqT?F;C_xf~ckM#hnrf5(eDIRo4IWeQ& zg#pkE$wqdOlT&%-Ursn=(~ z0~=n$eK0%U%$C#8;|83k+A`NUg#s*v_)!qQjT8$CJ=-2#;J#@lVJHS8$8z@DZVP+G zROLwuj=7^l8{T9TiV$r79cn1TfU`vh`jl1Hj^mh!NyW${vs5V^5U*j%b1JSA{v?E3 z*=H0fp)k7V=1F)`yi#ZnqNC}RNu`@{tKLHiAp-|^*A=P*nS$4}6XM|KhyBzjsm*j& zAjP@I1S2iLCE4yA;aq@LL1p4KUuhkL*n zuw?bnqZ527XL(m!8Zd)w$}HgASnB~$Pr`XP&Or3tn-#o*ur7CDL5-WKD{dX z94BTk@X|j#S>NQRH@r(`Ji;MhH**{;#Re>iyHsvY5FbANeAp6Y41E65cguW>>q!5>t6%GXDADg!~_zNCM(!{F$#F zR6*`6%w_A=Mj>JOaO24B^jr@$MA~33tM<&(|0MDmBEMNYWyeVm*NP^pI6WCuptX`pmY{0MJo_t<#R=(Q*9KG7!GY?)(AWeY z)1x;tnQ&cbaaL!7wA${g!xDwM@xoQ$K z`CAXmhy6`_W>z(+W1t&w(0=WAIvJ+1Pf6lVk{7veG|8J22NY_;*9azOM*d)$YG?S& zIdk{t__-U3IB)Rx&Nqh~(KBLQ{D1^P@bW)3*@VBPnryWiXYPDGY~szGr>B;^0k=K1 znr`KqZYbM%Q{GdXoo{Hw%zUf$^t5Qo1)XVFJK1S%UeB^gJuOpIdktLa4T087r)j;| z9Z4!g+unh15bZ9{<}og;t(oTWgtDnt!ol%`-V{Plj%&I18FhD@qxlDMARJ*%3vXHh z_Jx!Ep1ayI7ace;)|QGL%S>}_PG&sjrZAJ|yl`hmhd{aognQ$-2`q1pu~G-D@5LyO z#V?TTmsA~oZb!8NWc1L6f8_jd^60U`P!gyI^P(hk-U1O2MZ!F4A5QT`p>ZE)v+89u z0zwnNK@-Iz*bKVd1!zNd>Ag0K!hTMDgY4MLCB!XLRPCpDL@3R{Jbn6L&RD3><9+(j zI|ng>we=qE@yXbFx03KiENQh%bA&|_Fa%vg91RuYf%XJlhfE*T8r;sLg;!4 zBA>l5WS>7L_Is=Q7CO|3O7qgj%zN)^Mtg^~S!m1r%4BjwbjDW+AQEN`E^f;ld&e-8 ztd(za2e?BJb|8K+QBMAyH%*zpf0Dm#nP;5OQYbTMOLb--wBuiX%|v13+uhiTg!+9poH?TQ_{#}%K{?=H%#fNG6WhmhYO zjO?QWpx*XxLEtI4LI?(vf08-KP?d3d(|<+MuQh%5L&US>d^n#Xa-bmIE1jeE;onhm z_WWYW6O4o`Y+q~_x&}xrs|jsxUdg|CGG}>a{oW-R3CeA%_vX);)u~BKliHV=E?^xJ zx|yygK5I{PJ(HTBXBW2dy@=B;GYe1TYsvsmZ~oQBCEX{O=47i9GVmGwFU|4UG^hh7 z68uPee^UTo(P)StHXFPA0u`IP5OEyY4BP0QaZsZzrxVI6v7HCj>nVVsJ$bl}L zM^Eq&g*gc2H$jMZ|)b&ynmk3a4fD<$ClTB0$g%Spc5)8`LK!Xl}8{OqD$@K zyS?6RUto3J#=JUO=gCie5(v)V{W5!d_-?LX(dz%m&)f323hR^FZ#GG-2fkBa4zl!` zheC%d<{nBU0%mcW+~|gbmVykjS9!WJI_$82R8wI23KjXfo*>(x-;($jQH+VPeuPRa zU!B;DRp5=%c!98^Gev99do96%ksG8k?k9EfR@KtYon64h*ksQ&4frR$ScgXImO{{T z>B!`IG}9&`+)^|>MB|k(XeG$AiiBG6%_f@7j5aksdz~AK=(h_<6o{VgoE07H{4BGF z!_x1El>;S_U)LmmY zmU7B8ab#q4=LLn7Ug+($7t}}VeesEo8qb{OlI&jtuqT7z_dj4tqcDYBo;r4;d+dv? znODqPu=p&g9F6s2gf(8QHLbuYIdR_NbZkvy#=g%KmCK^`Ndm|mnQ)&5DQ`r?p~B65 z-av&|YA$B-4^;T1bQq`*gr&R7b;e^lq~Q!0hFWkl{94y>ZC=U*)OQ0YugxZ z`E#-_t50uSlm1QvSRnH+Q!L0KWkQ(eVpW5aVtk5G?Fv^$z5~VXz?S5aV5Ns(Sl-BKt=x+$7>~^~IS_V26}ihCz$R`IKDgKFzQM2~Kk5Zv+r; z*Y5atAN^{!1QiD)jmL+*dAzL8nzHs`tV5?tC~TnCK*mX;GR-ui=~5@Ghx3!+(|5T# zr>+BzC171AT8rf4OZ$+EX*zy^?^tANMu)kDjQSTF8O$PDSeDsO(_WlNiN#W+s>4gBhIC1{2)|Qr*(P7xb%%@y? zT!&~rI(u{0qs~yD@~y5GbAyy_ z7B|34u`cnp6Y*%aYu)xjmA7(BuaL^IL|=tEP2UpWI zNDg%TVQ^#`d7&z`9?WM|0Y!*ot8|YZf}r!KHFFq@rt+G`vGt{PopXeHv9`s2JKtV} zoF#GNn6g&7Bb6Au=0_?$S_J}`yZ`Hq1WsHeQ`0XyISHod$5hr6sq{HnzkZIaK6{aZ z2>2GW%e>0WHm|U9Si&-p)#|=l5QFBm5OQ!0Os?6&nG))Uko!bqQsa+RsE!+_a|sF0+V2_so)tt|Qs&K>$7s{L32YQ*dmp2po~a z(5h>;y=_nAG+~zuK|n!jqFv`c^Hk?f4tS!+*S)B&k4WiXrnah~fI$L`4;9IfdQ4hj zqXDsIL$l-eQ#4Rfe^dOMUmfn`dGv+RLrsAH(VsJS2%;0{e=XUIktLO|pYUCm z9_Ts0JzBQzAepe1FYJCJaSu$%9~)4-vGSy8@$!iDMdh zmqz$fe4#CLP=Wzpx^y}it3rK|YWPEvRcGyG?z=bJtPd1C&!@KeDR}hoET^nRv|=lX z8MLJi+59dQd$XjIUfUA|fr*Z%C)l(T+p6T_HCdK(*Y_(>Y_!944f@CJk1EU^ z=UJ6pwVB(Sr={yR;RH53v7TeP-%;M^%U1e5KIP<rU6X?N1?5Wx(uMDD@p*YPr9A_r~*`?+Z%oSaHhz7gc;i z{P`A?6)(DO`OPF>d7Dm%rG+Pq6_KtLPxg$$U}^27|H3JjoKWkW*pm2pnT1pIg(HRC zBjLbvgLL`Xykk$SRC3nH*{1cK`Fc0aH1NdSfw zGM6y(e!_F&_5{AZU0Uf!UU~A#7W?%@EGo&}D_L?gQ;%ybrDH6eQ|paS$UH(&GCnsZ zcbBjJA!^CSO!V)}iilTAveTOvpON|BCdo{b;)>){b&&s zhWk<@Z|?nVfgP~dy6v{I-V+|=DcaM#TEGM=iM9nd_z?mh^F-@{8zyt=wz=!PDB2e2 zoN2cOoNs$NFK|BX>71HcQJPv`<|w{{efD1aK%}k|+w-=v2n9wmj9t*~XWa-ydX1D9 zchw#CAgw8zy+5+wL~&ws*?=2E#ikju%Wh_M2JLf2{?bT_KUI;3E!;d3tsk|YNS9vB z-X=fqUs{Uj0dL+61SZx`fMmY)6N<`r?N*hpXYIODiuUc` zDF7p|1KZHM@)5$(l)#L=`LKKXGUI@1TufzU9HirKq_hh8Sjua$B(qfOF*o#`pj9DR z)D$Hi%7Nj@Cvk-WY0u2<@AG7%0nr6q*X8?R$xoUX-U_YOE%ps^-W6jMu=87alQx^{ zTij&0my~=6YxLRK=G)hr1s>vOS1IO}v3FqnK@gf4(4>Vl7pbXcy<`qWtAZOYVNVQ_ zaF<0K?k3xNop-2>sseLJ*;&>*hKj56i@nD^?6ofKJ>`jJz$ieS`buf4sw~@s>~wkV zSxpypmzZ~+wEtrJJAt&fA{~?X&}Z+75W@YI!pKvR{b(o%QNEd>vF`iR&iek@#gd?hGIx^|l3=_r-nP0f6IEEANxm5vF4t|$XD{%izEhI+7qKw<(&ZPr z28nNV;J`5vC&QpX0S68oa~)@cjU-Y)ElAPE;FWf35N<5hTIxFPYW2GoaE2)94y0nm z*^F4oDx=N~c5?Z9-*@5ah*>wp6({RudBgW3U{QPoM9xN}!9n5284-JV8F3qX-}f-G z^$0iJ4AB%j7Kk2V${*`IpYdsasFc2Of_7PobL}zts?f%=*^ZUkLkuS9fZ2w)3AT}C z1fCk^>ypSIl!eSoBQecHKcDLvIR&u_B|H$xu4|a&(7IU?$b^YU$Rp`jf%^}tzGW%* zRGyb`T5p+CDQ=nxNPoG#0I>#$5!qYav^c-gZ60_T*=y|t&1b*S>e`)O>B(H85~+?7 zqc11+4L_~f6${U6THHEowTNMmOc=pGqQZy{W-<*c(Rikz;T?MJ9eu+-1|cBJD1&DL zm4z;rfu&H}9~YGBcPy5edo1(2BTyk`^vEaJ3b$J`;3)ZAlbuf$T;=!QU@`@BnSSnM zD*xk54nL>t0m-DO1q+uQ+QUvO7ssLGvi6+1uU;(VW&B4@XzXtikTnUQH=7cV5Ed9gU zhLN=>LL*>>is6caTUxH|W~4j8jy1GlU%VZ;Z%N*!6*S}7#C2pVvG*9`DS<}O zo*SsUD07T;l8V_*o-hNOe4c?GeR+JGVP_+I?bfjC84e%9*FenkhHx-{uBUpq7rYV8 zR9jrn)0z_MFHt)>RtXO4meYn{-ljI%urDFIqg)%LBvl)9>P1l|?zDj!zgK|J!22Rk z*&D+X1Ogp;G%V&p%>>!ECKYh-SqV|jFLsPj62<&CcMcQ)Ep zC2i^Q9*%da$3uAmTPfQUeR|V**pqd5orjI@*;Pg9dMwY2qE*E=eKu7xF0(Nb9NWUc zH8pWXsw%v^&#o#q*BkQFRVy1aOW(@RV?W?GGTa9RR=c(#$%c`|Nb}oyAty{iMwDpO^z& zXI~I~ZetTPxJVM*N!@@oUNAajB2jOg41N%awg!eG@*JiJCnm1{2^Gp>Fsr^>X9!9{2^O5~! zdy_ZDP?#onH*3Xc38=Zf?@#I$7tyDPhkZ^fKU74E-}Q9lxm;U2&e_%@8Kv=TFw<-$W;SYMQC7+HX3j zzN(jX!Z8F4AEM3BH`<bm9i?Z6q0 z!(CkRjKV?UN~3T{OkJ^SB@fHDJg!82O;Rj8&z<$aauf?VVGx0V2S>3Wf6A<4;TPOG ziUs2-<0uvmJ6m@Y3$Dbi8g?lK;+v9J=EZMK-pW>}HLGt}>F68Q+LN!PCvm&Vt);5N z@%`9fFZQOsAKpw2FcP?O4str%cJs`zBl>>=DK2|JyjrrYzCP>Oa^_KT-ZNhjf1mlJ zJwxu%fC=Db<=cN!Tn+uJKQlk%3(~->T%vi>jL2G+9KP0c^%^Y{5?qJU-)gX{>tz9F zmSd_DB1%dSF#;?B5PL4~I9qIJ?Um=|)^ds^z z^C>Hx4%|@Cl=*9;os)RFT@`$l3N#(gD&vzzDm|Mr1{`tp2g*T+DJkOg(U(VGYHMX- z#9#7n%odhbHPcyRtw!s9*YC8BVZhRX$O32uIF8fgh#C6~$)7QG!Rp~wQAek#l0M(G z%I?e?eJOI=YRU`rzFOG(yFxS<6I>;(4#{8DfT?YO5rJpKsa!B!Wr}L-3a@eG(N8R67E`OSvDP0$G1@BgpbgkX4lS>+lj*CKh`w=qw8M(ktC~-*5j7 z@9A|3>iRo152C%Brr7h{qlagTcP@#(wBZwWtvkJT3|92LnQup5N=)F{^)?1_+y6m% zmxb(JWbBdtgU96Bhf`h>+P!WXQQ~UD8k&2JM?7jDDzzxnAMM}R=6c>fL`%YvuMlpH z`sHs~9GPa%_eBqbXrWCrqX#y9ipai)S+6#oAL%EJAHHG7DC%h~PwblfZDX*P^oiY# z4ElT{zJxb51uJ}4!mXxoDhSNh#_y$;$pHRxdG&ap6kA^R!9M3uyesS#GyQ!6glLEQ zqi}$$)Rfi5Y)Yl14%^idAs5+Q;Ud0q8|1dwxeak!s#_3{F9bb7M(wu;?0IhcJAg5I zO1z-8aPQ3CIWe!b{g7bRL@Uvw}Yfpz@^_N?ff>3kRH@S@TQPn$CTG*xej8g6x)@UBf|_Po;Q zsm|$(7p*S&ZlSMLlju1N_(n=uJVp3+FM_oL6$RyFGE#_|>Jw#HhH!>!^ z?*h`M7Pym-2RNc(Ege_G)zWIUbfn&1;B&QlIH23LfFn+|heRwj4Fc-y8P&Q2CsM8K zn`gNO5qmjlke*@&W0Lq&t=?q6T$=raew%Ke4_QUHoixPj8&54-JURWC4YtUk|K?_$~<}qyB zM#{(0!oiBsLk>PH5_%{pD8c?*=;6YSDVRx-3wxon&_m!8pvGG~f}z+~5t)Im$$n|Z zLS~2yQ%<_!2hSejB64Pj_-nlyVvT5Sh!y`F<0mahAu;M9CTr~y^la(UL-y6y&J$_x zART~Oh}tMz3_}q)jx<+*2WIy5d^}>aW!e)t9O5P}7zt_O2Bkak z0_yTPib=AO5^A=ePG<6~E*V4+ea7l~mhmN2lj7lDNseuGYDa<9{dpd2^u7H)``aD` zvY%w_e8R>=Xs2*BgwRSs`w(3pP_= z^OLV{3BQ__OcZrh^6{YP*Cz507pjn}5ud35YiFl+o~4u$=|n?p55R9)HP1KV3c1+e zy?6L2q4*`%&SjFhDU->t%+$P3HTPLH^0hBE@_N(Kq_m5;L+97otsa1@TmmjN3C>8m zR56v3EyTXoR1Fq_8dl8-UIqzw6R$&K-Tk;T!HQi23@ST8zPb7i95*A}xJYujvX;zx zVp6iLQ6G)=N9Z;Hf|U%*EVi*No2)UHEYYElLJUyh_Tvz5$~6eG2+REIV6xckQQ8l7 zYu-?@Il-Ie`#%6+(!Pjg7tkH?(-2t^`WH3v_IJm!?MYa<0$9JrJMwsMz9})wVQ@Z` z;Vmi@^mq1A0@B*G751`vu%wLeeC{o}D{fp2P|EGv4K0EnKPk^j`H2H5g12WyrOB8^ zmRfg;{G#M1LO^`|U302^NMc;6f}_=bk6j&z&q~uu_@x<+f6tt{Kqs!f_B9BO-V=0F z(bR=N$3OB}5)vUGe%_pzl00o+0jK38nN1S2RbsiaWvf5HHw~@+x_oCoggFoMrCB`A7GJtgb>O%_TbyotGpW z)(%7{IZ8F|_!rnKzfu_4gG%@sSR&r{9xD`CbRj~X*^6_*0yhgH5gH1t1qVhHm>srr z?#uzAu9nO^kYZo}Nvb8#o}A~es1Rs|zpsj}NtMxk!z&9zG~o90Y1RXFYhSc2xTwfo zr~;yuflY<>5&OW%^wbo6M(v>F1*vKF^Y&!Kaz~UEXbQb%C1V)B%@~8rK_XuBy&#N^ z-EUt(@2^OefO0Q09J1*svY(?c9JAwJvZqql7Yx1m6ZN45F_G5G{Si4}f(y>Fn-m_A`1 zmkv%HDXMoVQGc|`Bw`~^q7}Y$BhBvzRb?9be86M=x-6vC3!Dv-z{rONfdhyk4FLL;7 z*QBv=N~0m8BvdAEja60HRShh}6H>P}*aImx9#x^##P+eOa!R;-_lg`R;Xn*{IR^sx zv{~|LmlU+89vnM(qI<0427AHk=iPHy=yaVJ9w>bjJ#t>b&+T5cr&3tYqGVJL71adrD_iV>!qiw4xy>6}jM7AAm zajHOs=yDB>m(B(?XtJE{K1!DL*(_}|ND-ctI{6zl$T@KR;4wAm`f(s}o)&9+K)`|P z6UXdrOK&WRX5!znTN^ocX0QDWL@;1@(1YNlyyM{PPW4q#Q*;6C0**Av{ zo}!Rox;7tJm89L@i&mNq@v?!+Eb^M2C~4H@aO8=|F`(fC3dK;GS+uXj?nAzR`n`V= zznAQHE7-;{QG*q!wVX*$|FxBEiwrGV3=u8QT(}wQ4CuYrbtH8O>E$P{86}WN_>9Q? zd4txQ+>t%jPOwTXvj=k9>0;D3tQ6MH{gLB3lLkkQBJ3b|S3G;S9%ySZ+fRPi>~oJVn|dIQO0n)a82Fv?uvSej=mx(|pEbd@F7yphkdosD?Gr#N~?5 z#CkoouqMrEy>%fJ{_Ca;)Q!*jfl9}|u&#!q3yL&|ife%=8s;}%sz2WANiNPsq)t+Y zg`maEUfhxwdN!z{_GG=^XEULW%xo(exjg%ZFYa`` ztT$-VqeHf3E!fj)uP;T6GXHG~v7bA5BGu@dv%X|`!Yc!Oc53;_x{y1yqLChtQ=MJz z3hZH8A356|CXZJr5$+57xM7*`Jg8o_Jr?4xy?m8@kR8`(pA-`5uCSLhEIGz37P+!f zNOcdTrWy}17}A5kMnfxYY^v3b&i3-%y(bFUS@*|^@v15)x}-~mE-7@%G5l~KyesceE^O&0O`42%}G&ztjwNYXbzcLcHXHlKSr6L@>Ibbi)PF1!bG2 z+p(H$bN!ds`;Yc|67FOybh0&biDA^)+b24c8|(8Dg?6kV6|2W0vbhe*!8sHgHe=q* zDtj63mF4YxIo1yId=acUVLK|_30G>7dkZJuQultoBwj@Z%RiMCpVXT9Ocw{6@ACex) zhTD*IuZ)5gdh9Q!+DcsSxY~TKg=R`%piq~!Y~TQ;ehd`eu@`#9v0zhFkgCH_>vFq| zgK6AaL*H>N#HuflYAbcM!4n(9h`OwOLmga_vdg&6$?GRCxl(lm-Wgv#9et*=*w~Xr z>jJPA@532<*`B)w)}kbR!7QwQU-DjZaQKSl^?YNtN~e`D3X5N7Zys zWj=b1zRy6$Cm-p#Q1`4g_@}I$RhexiSPeNGn9BGyX+7K)xbnipMLHR9+mie%uggbT zy1Rg2=Up!({!rP*F;}K%DZDHLA$yUmalEN%IRJfZ_)Mokp6iJf zRl|)p<@xUeXS{^k@e=-9kQvV(JCpwdpfT$OIu&;Scn?<(o{-jrwC;flnbmcSVw0U7B#M%V z*_$eiQ9ygD#fN~#hZjcLeNBJu^n!e}Kv+4r6?{P4H*Rc%oy~mVm&Q&Q(T;J=KpeJI zl)>o+im_Q6SLJV9EtUrL*b5PE*;C6mBdZ<@NIj-d5Jo)~Thr8-@pk2Ob3xp7SXaV` z8>Ja5@~DNC+95Y?tE?f=TJyHbS}rZyDq~z)C1q}uOHL(5*MI^pmtn{jfBxvp6xTNT z0#*EDGFJt`<*aV08{hgnZ2unNhg{>m21nMmHPTQq zqj~9#4cuyDl9&1BpVRPIeG;?T<5!F$3GfKZ1xDKui5m z!z*b|b%lKapbYfagfA-~?mzsntJihF*b0EmL2MJk#S+Cai<(VrVG=q*& zkjzQL0^ye!b(PKZDCJ!VrE^(HR4$FvDy|x+ual&taqOm2ySfbEm^p}OaFDSw)5G`) zsJK_fag4V;*sqLh?Gzb6ohS5?J~3W25Q>$ULx$I8euSYqlx>3sAzSbq3YHl0%W8LXxC1XniDaL( z?)VqFO7#KsP#Klj`&&1i49`BwN`I?8qV;-lBMCORPAzinZEZ}iaA*E{8jzCg8$lE8 z6Zr`0M>KjLl(8x0N;SDNzx``reqdz!0H7PpgIB&Q--w_FrLgwLQWKMV5il{{G>G=b zaUTCZlP|<3K3wT~Q7u%9aAM#7ZP6f+XW-8OqK0z%^9?4M0ZXRtd~;XQn0fK@u<>WW@Q3+N#p1wTUE z;iYKZ@%NNzzeZsl2&<3?cDSQYY%H*!*u2rZ$@tZswJ>u=ig#r|;73rKIKr zGwc361n@=y)H6S?7L`;7@pWz%WF&~7a{yDPCCO+qn4ig=d#;BwHR${-V7wHaRT%a(7#YB6H(Skt6)^AmSO1ddNZyltA?si|y+ z*~F(XV_uIJ?ez{Ds2kPiWuhX?;CQwf>eBy1RzmNXy)~`E#|)dWl6xjuMTq19;@6rM z9!-=C)P_JI&Rw7?9UcP8Ep*!xSx*V|j+YPTaHhWHu`Ss1)D-51-M?I{{fhr0{vG_Y zS$yb@*>BhvfO}m{R3SPwPuRN2-DF=l=Tiv@Jrq91AHBrt{-N4X>5ig1?bh}TW5KDU zSm-9kPkg;PPQSlPzx}4)zjv4sdx&Gz{0V4^={MfBC2nnC!k$DYbIG-ajODD|0! z;kK> zGIz=C%E2x2`@yfGTu+aE1b)$s5a}1tuh2kU2qKzi=c#Xks$F2ub+g+|E#%Y^Ty41z za1617fl>)Uv(O6Edr}L-DdNnVDdb5t=1|X|?#SJL5(Brq{(b7ovCOz~@q`HZXW_fK zk&Npet^kG}qgJ!J^6_dCVjhQ`!_$k=ocx$Lrr|eu(LU!k6zjh+cTubB2sd+X^TuDA zbDKMU_^j3PVP!_I_C~^!?hFn8oX4ij;`L^w6kczOmBMdCdTLNs!LeclG&*rDgSY z5;kSN@EwPfJf;N2eAvA43dF*ao8$P+K(Dd79(3pBK@Oa7Y|sPeCiSps8to7+1cVB| zgOjrpC^s~cR@WgtUgu8N;w?!@C3apvUU2k5Dau*v8mU7{P0>m(9`$vQzhio)lflNc zdsFW#E^N5x{j<|X#XJdW9V@fCp9Md%sUA^@BnxMgDabC#;GC`QJH^IOH74$B!Zo&R zUyJDJ9X}CcApP$n_o>dVxnr zKa8@+7()DnZb%;d4LxPzQ~&_vg4Y^C1@T2ZZn}n zHAiI7uMI%6lR#=oLMwfWzOKSV{;ZcHjrKafeXB29`ZKQnY^iB)0aJHL@9{$9Z;>nY ze&FnUw8!fLxvD&of-_l^oLsKM>aM+5N^^Cy`%_wiAuu$l219s=$Q_TVpAUyM>GB7p z=*>&$%yI&yUvO5+0qqLJtZI>C)Br*HE5%^{L@X?y$5;6gvHcTnP(7w_4^VA&u0G zB4MUbkg&nq6H=K<48-K1c7=N@79|dFj1Ci@IYN$7>yBSgkBN{MXur#FEe(Qf4{xzM zFD|(Jh0RZ6>HyCrT~rw%2$SXinr~0s=EwYJPr`fU5$paZtk~eT!y}WgBn;5gR`uYv zcT{mKIS`P6$%d!Z!Yf}Q9c?MK?(ZiF{NCsCdc2YNgrf(z(4q!4R00^qT2OBqI2C8R zu`T7D>mXcPv0=&__|W|_a;bYE=KN%K2Uq`8Ge-wM$v#}~--urUDVwZ~%byF{ML3}) zykl21Wu`l6b3q>iinIPZBIum>$6Ogfk+H95C;jjQ-F#aCZQ&S2`C@uOd@yV-fp{}U z8;q_d=iiAQIN@yXve)8Es;xvRO%P!>)E~xrk$dEY_@Rswas?oJO5_3leM&u`lDaria2Q>qd z#}v;#Q{dXi-TI@Z%ZvEifq-B^nEtUfP$-J-Uy^!cJzq+wwS=66-Ysg$%)Q4fYvtmV zNc96!<+zAL=i(wT+%e;C(i1qxrLCkjty*kdECdDMtU$n@s+Re#-@ZA_D%JgYHr2GC zm=-`t)B;~iX7C?O3(8Cj64R;OaO;EA4yG0xyOGtZ>o_?mvxrF0rfB2XB`Jd6KE^Pu z7Uns#Hh_p|HuS7iRzC4*tyJHVsh}RPAHL_UwwBE0s+9rMd?24;IdH19y1yy1AcS?c zzRm)yedyZM6#kx}a9P)(Ob^>bsGQBRj%`w(aNaJmFJ^BtkNGtlE%dhyB>~rI%qP^C zrpzz?e!MYMRLbQ1+w7Y+5>HW0eN*Nx=f%i`$HYXU?z&qS>8zzG`39b*cxUtKY>7nj z^b5#_ zIsvMvu2*@)N2oVvhiC>i(k~0P7NIecO)nS7U2}NGfnzA7t*#*&#!dXZ(D1s}(Dxkf=4Uecc)q%NCscX1Sl|*EI6o8)k^AmUIbfgug^`e`Q`8UDPY|}F| zdGtjRm!(_L`%_eahp^TMvq{=O^ABaa!zj1k#XO;%tyBkk_ktOavh%vMbF9Yokf1oQ}EC zfzFzAHTs>7iy5&CP)Y42@T56_Hqu+x=tU8UUqQM$pA?@Y#fA1j%(c6$d9N4Woa@h& z&ep$%J@sy5Y|t^CVyB`dn;bpdSr{v8IT=6bd=@19fAl#RzYjF@WV0(Q|?8iIzQQ$-!Y9YoaY*gl{KHDEO~M0JjVN4YAMTB%Rp)O}63rd}VGIv+|2lJHx1 zWN(vo|BW01vUC=I8c%XK0cGlzUqz5d9C(F0%=B4AB3v^|GTm}Q;GZNC%Pm39Qy_tI z!PRgeBuPV@XTr%1YL;-1dIJwlx*`yijPb!S`l{bZp{3zTd8r7wx``+ zHbg(tYuF-;SM#+JV9DBfcut_HgNWrv)P#9ZugiX1@n2gnD0fr|0@yPlGT4PO9LWx1NkL z*CN)D0Lzj~tg$=lgl(*soMLxko?Um+J|D4lKCyl~uQCFy2`B+YI!m?;>%B0T!b%%6 zcc4wP&u838I$ii`52X~>x&&8`6c(*@-dsU*>^h%~{R4~2cp+sJQr?)k_Ctk~XA8kF z#wjG2E97b$GmC||sM82asu(Y+f|6<)Gh=Ap&TdXkwxo(|NwK$cC4I?W@OzvSD5N31 zCEL4t`c>bUdB~{m+|j~L?TZ^sf9jnAk^?>j-kgDFb?Zb=vtj~NhR+8f5b=?he3%9M zYw6M`;3ohI=AAyL*1}F|#hfQVt<9>{bV4Dj8yhnq2)Y_P>^-Uiu@GTF}nh#Wk zXvvZls`S)RlHAf~$vB zWE0|1YmTEA!jSIPP(gf>S?H6GZ|FlR(PV$c-C|$bio}DHnEW`MrrlRS$QtlU|B=~B zMgBlhMGRG*>!^r%+C7WQ2I^Ra(l;^`dEX_WT?w0;%_K^@FXGc`+u@#jUzyC4+#kve$J)D?`Sruv4DEVrIit3R^5 z8iuHbu56~wA6aB0NLBB8i6%5Mz74KX*L?<@y}y}^ZSAX*BY=gTtU;pWXyn#{KZKoh zbBej$(CP_ z!6CR9*>q561FqfSyy<;^GR;|&E+xJ!LaW}>lWERc$*v^RBCg3^q*P~#vT$nKDc$bQ z7hSv0evQP723b2tKlEB@7OAK{-BFf8;vrvKl$jNUDma>5CuYJH_J#R*>pwv+L$$yu z)Xq7+>?&^GshwO+7y?rPWn?QLh7eU%kMmxr<3A_r2n-6!3AR^~Rco&B(UnK%HARiU2H|;SGJWz%S4*K5GqP?@azC69SIA(T$GCM-XTZuRLcH zme62zQfHSeJ!i^h8ruvJkjBlaA9}Xs^?PW$p=CxI)PgWsvbe7By}XB11i6S*tm3}J zP`2Grwx5L`=Cw?OL$3IF&K73N<0`6;t$2OFZVWcD(zbFYE>V&F%(hZoRBReRT();xr${uS88WX0KVF8R>U>fUc9MVSRJ(beKf!~J2mN|?Fo4V z^mEnIWu%=X41h7>Qe7`;DNL7E7*68jARN=4)kP^kx`C4WlCUwmPNmDWYBlFpt+C0p zx>2i^BO#U_8EY5LE>vLjI9hY4j}N#!4E*sT#ya-W*$bGKI&0@!XTLH_mRY=v66oy3 zYfY(Hyd-rri&r4Kc+H^BmC}E#Z0Afm>vlg5T)bM9Te?eAimYaxh))@C^ul$SC|ccg7H@LPQ8%YNSW?v_O8A!vCKH?Z?D zZAkn~rsf-E`|%xZf26ez(69=Y{Temy3u+vK$It1CdUpryK}kiIW>lJxDVuF7YU?& z>gsWB;xmmd%2>i~H;cf%`7A}^Q?MqOL0Ls3?rpvHFsHLWg+1F9lyMIq?E^T)y>B%P zMdc44wiXWZK?EFTzsPDh7VV?IL2KcmZIm)19}4B7?1xP%6Uqs{U?mzUoc-*!UQ`!w z8}QTD(lYUbJ=c_Huj7+C&rM8dcc*eIF!JjDcQxtSJH`c;o zl#B}xMW3-6juSSZVF)kj!|AHt9qIYk7>8WA@<^9KDu$>bU40GMCKNkE5XJYdN!K}Q z^dbC>A_wVs(B9`nWEOMJF{Xvj)S`%ObifwH5wvn!>Nj9;feU(%mxOsd@!WYjdn ze^tPY=`t@GTU!=oF8u=(`@ZlH36hWdh84j4?9b7+Kk#`zpY3nDZ4`nRMo!r`5>%6( zN8Y2?jg0vC3dOdm|3hmN*b`xK>K8>>ByKz3MiFO*gDupnpJ%R0@VE-nQ^Itm z=&&(>USdDD1^wgipU;L6%Y%@8sX}LcyHdY#gmsV z-(q#$PEyPddn5gX=w)M-JQgBUZ5CSF!y^1N!kH0F@K=-^Q@*aS)+W-avB<-Xty4Df z#M$qfN3|yME@?D-jCpJN`(eFANx5)8r4m@*Gs1z48!s5IB3m>0C(3gR!eXd`W`*cU zH6RTp_lmV%D;gmk=<^O!RU%4LmF%x@4TwJF2u<|+hA3Iv?@}_>7WB7#(-PDDV?uCH zV6mdKagh-7zr)hc&|IB$uNM$+hQK_mE+^*PMtqeuF$dczlzw2xe6{V-UP+Gd1w$-p%R1(Cwud3lkkTXAtbo8Uz>T zC%T3=^8I5pLQS}R*8d+(_?|$jK^5$BU<8EdUiKj2smNzcYXnoPTL%0LLfP=rQFDA# zNRBnb^Ro|PU52Z8IKw;X?!)qV4`(Q`YRcL%Ib5Kw^W?L7!Xo2!V;q{svZ}+kUryJZ z=Duk3rF3OJqGCuc&GaS*q;40!gwjnMsN_arjH20VP)zHX4yz5Gk=X}vu{(BdnSHP5 za+)sE5@hyA)&S@Kw#+_PNLFV5gAWz*-;mkoO3KRY=Y6Q8|B=kTkV3Ri{#Y{mFoWy^ z9mGZln4dZh7Q4fVkD~R*vdRKIKhiimL`&j*&z*psI_ZN4hy-{GmXfAb*LlNmT zMkj~@OsZmg+$5y}eZ-mOBRwIyem00!Nph^f+Ik-CVbaK0%g@x8?Ne)JffP)TNiA{m z6v)|6;}(RChhv>zceb5+oi?koonz9gNJ*8_DSIwHtQ$XA*wB<3Cu+GW?H zp~I7ZAZAje)`xN0!y7u)$!zu5uEhU&B^k)*cYqP2Mu{3VHCSVzHJG52Kqf&j1Va)O4cOW=qV)kY z0Tm%}@|c;gUuE0vnxIxph-3g2c~k_g3fjjvj1P1x5FVM|=iKj1 z641K+@1m2rb06oPd+xdC-h1x3=W15mn8F{gNEHT_(y{{ZtyG*6q@TVIxlpV{ZfB9* z{v~9lm?B-yH^|?D161~BRV>KY^vXpe*|>X}v=w{Z+62+LPsavu#Xh$r^AQiW%Kbe{ z4Cf}C+HbcU={JOjybrCR{c?IOj#WyH(uv~y9;ZUi0rI_4xSc%1l&g6+s(L`IcG{u2t#yw3+Fd7@8_GQ^fp4nX*!*rkBg35>km}YPwlWO)vjEQ&TUm zhl;GIHQ!av=#U@5wbF@UUicwpthlW;-+l;AohK%j@*HBvCD0V1s4hf(?u8Y4Px604 zla)l6v9J%<%ED*egL7%S-O((Cjj63(NmX(CEGzCzO z@Ha8Q;2xN)-t*{?9O*%6*8SFLqC&(XuPdT>AAv3fM%oaK93XR|J zILLAR&f5Wid{WPir%k)I3eZ|l~=)&_m8KFQx%K^;A#P?7YNv# zV0PmM*^*)plLy=~TZjm$NJYc~{#v7PVFMeRiM4>umvNA)?n!$ZKgO=Ql-IjQpjj`{~^0xz=a-JBoR)nSkGh zUHEONv0t-b)E~vJQ~fqvgSo%g9?Ddm-Vcj-#8LQ1%4c{Y{D9jQ{F8DT{x(d+wKvV{ z&?c149w;lbTMi!7;tVYQxAlu{41HB5%Q+9%B-2n~RF{Y53{JzKP4#ch==yISwJG1< zOJ$C4#++%x_aPC3P?j=YtstX_qQ)&K7U+M>ka59$7ahxT&)}OkRi`pSt$W8sglaUe zvqrKmG=E=2H&jY5zy>~bcR-GR)Z+Vd6e2P%E5+bLWU-fL(o|`I@cCy{vWb%s&$7-r z>}18{7yA;{&{Dl5DGTAxtyqL}9yR-P0vR=JHR&jZ<8et!Ce`&PLFP#i= zmNe4QQ%PK?ldwF8`crui|SXq>+>}t8^tEo+%b(f@HVdJmNqK7F+y>i*?v4awZjH|O}%9*>? zwU3DGKCOKx-{KC6{~XI~z<5Mp$OSj`iUs9;sbp6JOVxP5O#xf-tah?BL^G4GhOfmd z!3G|g^(OGnhMVbJ?z0yq&kB+uDqhi->sQ=M7*)OKdvP%V8b~xQLU5AcjDz>9nK*`%6@K2W_y@w6J04Iw0M+>9S4L`FEtsp;1ClGW z*3Fj<3&1xXa0%Ke>{Y>32Pk=)Y+;9)!dsxk10E~8RZ3J1X}O!upFAt_`59C2@vo=) zSDjucs10=W8P8t~Nb4#9&h8*8Q>juv2j^IhMfF8_;p4+0*R(ehS2Gr;>eWlRyy};W zKxZ`PJ~-aX3kot9?bRP`1ysiy&oEskwTj)*1$onYS*=${A9nmqs+pCmKnqWNM}FUx zpIe91QKer(@tF}$CPQoSjH_?M(Uhz0Kyqy|+4m=J_GVcjvaXqh?Kc;9$Tj)MCL7fS z8wcMLGp%fTU==^KWJ^%ZY4Jdi%pi)J+&|}?VgLs)n;9_>ODXKMCWUEY(ttLNwY&bZB_kK<#+0;>z?Xa?T z>=LikkZfDDDj(C0Nhtp+j!K_cJ7uc_833;Ed&O$)iLs@uJ*#AJyeVNW)XDLcj3HVp zC!a39YpnOr^sHt-(op3slKvl7I>m-h zgvJ?x*;bbD@NxO2rGK3aPMX%Mt}L+CX~bQ#0@S!chPMi;iA;skqDp-uuhd&!xJuR9 z#bdtgTx4@7j@#?>J9BH99dgVHeu1SlURt#Ws13YLMHBLvATpa5=CKr<5b)Na=EYmZ z-MMCXg__=BN;yW?^a7g=jan!go1 zX}Y-Y|79H>nuAO$CcYP;POVm9nty4KtX_Sy?5<@&#i{j=AyD{RgdwoBf@pMIl*~u9f07^E8${I}Z=Yh+Hi58Zk$%x+VQUxo~<@86v-%ML@_jmWH7_BE35ZQS23(iWF)jN0E=YGvE4>ZnRl*>j*Ph^JIV#MUv%7*t(J& z7ZXJ!%E+!o=}*xb-07Ki*a*uQjD}?}H}KXMFXccOSCbo zs^-Rq2m#)+O#`tmn+}qUBN5l<0!; z5^eUOs4jKmvO_uJgNkatQd7QH?-Y?`{96869ua&cdsp0;Y?+<>iuu=C)e+RP)>z|d zFn5J>MMLZ_;2;5XQZO1$f{nX9?Nbo4c_@pwJ%9C zpqgAfI9BrT>;{XIvl~pg&xt%MCnGhbcrLugXA4b`d(M}uc(=uor%v7g6@emxK)%)I zUXQs*;p9!p7t5EIn$Nx_QiIizh~WmpT(-=u41bLKJ<%`7yjJEm+BQ(Mwl3P%%XhTxck(yK ze02e(_ri;;{l2iwfegrJ3w+&ND^{GMOllI+mre;~w4V4;@X}{xFbjp1!zG3D1i`>s zgjt(iPe0|}X#OQRc{QZ`L97GT|CAq473cWTt|tf^mAA9Q7C_M@^YCpOU9vD&A@4?qtU5DnzucbJKn zIg;H%WYdvuq1Lfd;_YoLoraVwohrJbj!OU-LtijCC^ zZd%tNa8ynhRD;BqNKVO{S|{%j+oE5rHz$x;co3&8T148@c3h^-(D~stQ)w?Rf(44D zvH=b(q%0p_Vha?>wK8fCuOrpa1!X+mF273aT0?m~a7#&G>GBEnrVTz3@V#2(>sA7< zB~*)by)WXkCj+-waF)*tubF4l+GV~UE!@wYSpluTsl$NN5XIFHlK1?-IHHPkM1Cc9;fnSZ%M zxH=~qn8zxvz!q9&cvjUKu0_%68m6Z&ELYQ0bPZ}|6v@iQxhd+aq9(msH1`&DibdHW zbdQTqGTY!>8cCv@qKKofqG-8j)^no|_@m`jBupPXhO#=InHCh%B%;B>%2&^=tg4d1 znD+{+=IfY_hCZV*rw)}ZD=nt~|RmVTFHTE6>Vz-HUbLwX;M9dRS0xLH@OYOxQZ(TBWvq!5SnagsCKkW^*ap$^$NAD8R zQF3TSi~g9%m%@RFPv-SZUwGI2ab8RL5@ z#}Y46wB%59NkL@E)aa6;=#u7mrC$luC7$T_)O7GYH65JW;w?NR{`0V3v1H_Zn6`dX z@uP*1{)yhDL|z}SMU@|tey?BP?8o2TJ$9SDN1z~h?Fu#LTZJF+qH33*uNGD{7P3Yq zuMyrLLrJxf{2V_&CQxDX?^{QZ{V!SS46pd2uruy{wqY9aBvzZg7ZrCI7-&Do|pE=1ErEg zF+DCEqMl|{FX`0q_EB17mdj*#H#Z#Z_2QkaqmX7n8tXU3fT2Xda1=}Lrs;b7rOt$VpUylLF-55h_JaH>aTCG*UH#>`7r(yy-R%EPtqmC);VsG2xJl{f6+7h%Gv%=i)Ej5Z z+<^$v8`b>)gfAx+*85U=W??)vlgMK&Y9XNuZcRybM4FEUnfJ4%mf5EiZyqgP zs1p8HQ_Dr8Q2qqEW2Y8DW9;;D1-RkCRP>`fQV^}a1x6jG2Nv^CmmCjX!~v0SK}~JLGJ9%jedM-OE9I2PXA8R1;}Y%U6wO<~ zDxGsO_H}q|5cO>x23=peV4oj4K37gy^(Nwf8aC4KoE{o zV;M1z1#Vj3m8d<1H-@)wZ6vIaH0>V`6it z66Mu{V@j5>4Ubpk-}?#+^ojyYL*`~DK9$NDeN_ICi>!%Gdvt4%R!V%9 zerOTZpaW37l-@u5baqN6hKdw9Qu~K9u9axP{2aA?C=YpBPu?8Lf*y|M(Otv{JIeef z-cEeRJszV=h!E{kl&^q7K3V)L?Zn;s6n(BwuN|YEs4T6yv39I>!YbD#y$4rWi>Q8m z#oy3QIF0$GmUiND#1AOjSGbMJQmBuDqR#xpCq2MYIdtZX3ZC8*&#pjS+&`f7qIT{a zg$%vI8&&m{sJerZPjT}p`iW`p8;>d;L(u?|vI!_TXZg6+VjF%zhZ1*41nZZtm{qe< zwADKPn_gG?ia(y^L|;)Fy$6?*MyDba&nt8ayy!i?Xs2S@PDQ!`5fq|TY+!d}7EYFy zc#Vyc)j|Njfl$0;Z_DgLjx(f;=r069T7Pl2QeQ}lrM{?FJ9trF;DJWbAyu`keJvHn zyp;Wi1rPnjD7>`(qPOW({l$m&jZ%fZ7}W)j9DT%OrDz^}CRGV+V(G8cg7;40{H3zI ztv6q#e@@eo1*Y2gmsXTnlUe#0N=<1Eb)UIHz4;c!vgsA7_<|i}&(G9n6ewz>^% z@TL4&!!P4DTnHL6Tm<#pdePPUWoO5hS7h3B3FD$>*2F3%Z*N^g_-Llq^&84)-K{yV zWqOnO9X`I~HM9qX0dJl$%l%M;+Bb4;w!r+wVicU-j4IAL*isZTic#=m&7HA`7*U6K z2Lclv>I66+Ei^~E0T)WW^DtLDGQ>nTvG7>O)-~guLkah)pHF)~@r%MCW-s+5GmCh* zM%MD?Z>a?}L->Upk!!M)ULpH;o-<UUd_BKS}gH}ZyRSj27o&r4DnnznVu%5B;0*qIm#O|Lb-tc2es`$HR0P8RJec)RrWvib(IBAlf44Q93;ut%zh>>JEbL5BogD(IA;Qw4b} zuW!(?^B_N3-=RQ8q$U%Odf^Z3p`X!V1!{|Sm)g>aU7-&I!hgJ5B+L=8IhBSeeW zvRwMUN`F%yw8m#_(k!ieTPtRweUW-+pP3oS#FLTfqDVdjaz+C7NVOw8;F4FSb}{*i zd!HOd7~tXi84J^vDO$HXWv`+487+3MH03+{4mcu#q&%*bIE@xi6E(|MPosov%B&V- zgQoboZ|C@p(^HrJ$xc&$4g7P17wLOrX9i+@tp~JT(-m<9}+Juqk&u%Y#*P)+tZBa9|K*W1<338KmSTw;{V@qI98gzRa1ltu^4MqlRg zM#@aBJ5%ef=6sR+Obw{tS$7Z`@>w~;Z;q1F(+kIbQ<+RHweok|6(R75v zr_1+(M1CX(vib$DR866OQEd>rAJ)qBxOBH-9Q=$mpGGdrGcw8mZ~qX}H?)&~>;AMm z)4SvMnckdNGrh0#k+6KK_hfoSj8U-&kxV6(`qjZMy8JA4+Su5SKuH#vi#QHTNfe|B zb`+<{laa%O5qQC~Q~6oljS)S5Z-2dYoP`X@8~ZW;norkql90;~zO1c!mCaTpHV~ps z2-;ea+nsww2;?zi&FK>P$vZ$&uPhE&bZPCfNvPMa77=<2L4c!H|6+j( z0f9ApeeZE|m}+6Feu`?H6p#B{L+GJKiZjfo|S#S%6_kc zNp|@u|5DlC#xSq5o!>R)Omt7lZZ|;c%`$~pFX4En#K^yTvrxqbRjj00v1h5+RuwC0 zR%{YV%d=vs2y=;|d_m*L>uPep<1QXF5_0zPzpKw|F73aF6TB2H2=4+mDcgX50C zRR9W}-`uRK{!^BmmLttrZ<>+aQf*G6Nn%iC^S+{r@wO!^7S5{)RfnsCjzm=o>Q$eH zdS-L0g8CRxK>;W^Jj-}rT>aufRrw9nC($Xu$cF@PZnC|n?^uvAV z@t>nWntR3_?!!y@kBO0U-7}m2z`Ca1{4cA~bd4)%RiM`VQx%*^P{=a!FZ^EqsQq7_ED5Izm8J{bwWsTr}C$2#i?F@5Fnt5ECS zQR-gqLFcBem-CnW#2Gxt7w%)RBukF`){Pe5TzWXL+7V=F)471sYE>prkgzJ-yFb%= zxHFg7tk4P=*rm0f4|0PtBGd7U!y8>>$iP|mqmona%g^HZ;hl_^Rdi5drj^kd`jVB= znYe5uBaf&DpCIFW`a0pWGTKAqtc;Eo21(PG*%?&xxE%`Rxo`271YGRFm{{|$Z2w-l z?A!ADQ-v)b&h_STB+DuJ?n&j-A1we$UQ3g?*k6M+K@BPZE0!8!cCLe8TAHDSuR|Pa z-Muw>XFdh|HQY}VCuLJHOxTDSU-$*FT*OD`MuF$AX-IZUKJ%TM)IRcXXFKJg*9l0~ zx-r5Jzt-^~Ke(Pgl}Di4-<9yZ{3}|A+@aZ}4$d#2tSxayX{OeJ2(dly;twl=d|94! zOITqZ?sIZKJ64vol?~hM&R1lm_0iyWNpIz3s>2`vu<>ygn=qj*;VI1wJt)7Bx}q)2 zXUwxs41NR7^BVU!WWf7r=tFj`yMjf|4avR(ZhTN?vqrD5WpkggLL9dD>?DcBojZF= zq|WAig~z2$x7M>YQo)0d1S1vB$PF&%2O=o`6VS3&6bBl4;WevmOQcJypbnD&B+P?^ z&o&4N-LcNaL}QPf16c|q>en@$Hxs9IZ58y#Un7j%v4wD&T`Tm!>L(n*Yh#ZJyS5Hx zt~j?w>+YkYte#MvWNzCm74R@s(4#nLJhFxUWuCYMn}fvJ1U$=<4C;@5XC+9+B&>G8 z`dx2s5Lxx8oYuieEC+q50fNd`_`E*36L@gpRG1M)Jd@cy3?nw*h4`&E$J2ey>r_xY zfi?e91^+6+7gTVN;JOFj%=CVn&(HY$j?Z>Jf8uk|Th_WQEkIK8HTVT37tVse|G)sH z2kXs$z>p6_5JP`evZoAELD{jZwU=IkCLTDr4a5Rl&9cwpP|;(h#pLxQJFv3~!L- z2Cs5Ta|VNi|7P>nrK{PfcKRdDTa}KNtFn-~AGqUEa6{v*wq}Ei6}pPr)cQM(hE?-1 zqOA zw>+8ZfS)R5%?M>0)A5g}csEC34)C%nETFT}7`D9!|BmsuA}!V1^Z&?~G+4fAa8Ufj zNK@aJKXJLfZNQba7@bG>9ZlkEMc+f!W2*Tf@Dsj>Gr= zTK1=gub4-&GnX_*#-rMFTw|=1EcQHOfxMOZEL@&+9xB`yyMCCLG`|t49*$j~By>xp zIvE>Jpek}E&ubEx9;vp+uIF{l;FR#D4ACI;W`qYa49}#tp?(^%`ga4aV)U|$`>B02 z=o}3?(m{VZps2!m0El{@fg1Ae4XT7W^*md$Fdut1mQUWuIXo}k=_6TI(go|##Jfvg z*Nme=IVQa-@eZXdZCKS*{RQfDyi6TO{(?jCgMIHijp@H4-sb$odAM*O zI8`N*TVUIc{AJFD??X>3qtD9ts&iN2rkJZZV%Ja30=3-44FVkjU{i(X9QlhX#5&BF z{w;w@X8l;io;W|9Pmj+D@7MZ1bj4Z)JV}me$ytod{EX0L;o}*hi%MQ@xsqvBR9~5M z2JBx<$dwNDKEe6)4lzaKI78wj*Wd~I3*O`#mKh}j!7m#XzvJ0FGjI!<+|ULF6Z^ls zWaziVbNUpw9(-m`?>}#r+iU(aqJ})F==dq`K2O>;8o@ zG_Bvk9KFhqu$`d$XQxIH=h7mf2KWBLK1TdWezjedmjk{iEa5GQugHfyXcdDwifJd# zFWf<7cEpqEk9p)p*pCKWnJJq|m`$eqvw-7{mdWj6Pqb_vUtDUd0Uxl#~phCCoT zLxv|OZsDYVr50_OjWcT4bxE|^-`LMSqF z7^JJ!KUxBPxgzklruKhKL)wI|hcS|FbvphRDn5N)B=B%x61*^cv}k!o_~?w5v%^Qr zBy@Aj8R4V1N$7zVr@X5x0LO4hxR zZxVc3V)2u*8UIF)DZlG$L=_ZSKw8O=_ShVi-6Pqrm0(|CTyiQy>Uwz|EOMFT+^Ib# zx@Nu6Iw{Av%4_A`RI*ol%q8J~T!W1aF>*`#w8uW;8*500pZ3U~2xHi`PkZbQiRBv2 zu|k+(nY)H%gxto;RgaQZ(KefT<;BA9GIg|z0fEjfnwRyvy@fAZMHWaInb~sHO;^)4 zntct~NhlU8JRhH2^Iy*rSn5g?;-J{3b=)itI&2l7&J!B;$8u;%M?Zl21k9DNblq^?s^1FO(Lk>Nzn=S1o$i22f|-sld8qhsIvaye0LM_sUWs^Cn~2YuVJ~7?rMCE4_sQIBPUR9~o+&m6Eu6heI+|t{S6~rEl(N zwjYqKt~S}iIU~q8M-$po2_B=8*BB4xrD_h|RVVP=g#k}3zgo_(wH=V?7$Z=xY**f5);y?OiCP`|-Jt1?1XxDqql!dH8E zB`X1_?XToHmjdnK_pLPmJ;?(y+*fWElo^D%=Cu}`^Lb5y8mS<9l@SrTwhalTR!*9> zHR8Fd3?G})$iH$~!P`%pw$P@nwRPc_lhfX4DExqCoRK2FtRYLM8Llg5o`fDNtGRRZ zv37YsU7N9k)|oT^&1$v$IK9<5v^qyx-ORR1(J>E<-o&KkV{Ixuh_9ypS&=Nu25I^C zIha-Wq-Qego4aDxd{Wi$yc-n48-EAtHskSLzR*6D*tGU}1e<>h2KDAirpIKrWT`jp z_o;yv?^GqEYzemqo**q)t-qoML*Wg!Y02IDd4Bg&o*-5J^PI`)8|ux?_u6cgU|Vu> z_4`&`R>|bFdh_R`k!0PUQ%EJdUr;qZMoO}K3*mUD#K=G9XO-U@@00}j7vA`igt(gc zin9B&uz0uQjWrjn(>ocS@>) z`Tjkrb^$ZlEz$MnKH{W3DwjahH$F*%>P~Nl30?Kae@O(4@`^ADo!@r~dl%Eu#nRDh znHNNs>=$lOU0uXad@wX=S8iGE<8Q`Ml9rE$0c4natutn+6LIk94!+5+s-$-6d-3z@ z(>}L84$D*ZWm2Ch4^g6w<-ww0lhkquOtc1CbNP#^sf~TsuUGzd`~LaYpVz)q>pRNL zu4E!x|L}R4IHY3cq#F0yss=+bB%5EqwbwinSlwz{3LodORACrn_92`?hACvIGZZWF zYl6z2Bjy=$N%62!96N%S$G-b}vd12MmA}_)6E|hu`(lso;g=TJd(DelHyXZvEwCez z8T;;Q#6IaYu1{XRY1*#Vp)=8g>eZ{Y%1vztY%ZHCctL5#igTZn{nG$TnT&X+3>W!H z18NeNma;wFtL`*vm3y`BgiHvM5>>-Wj(B}YYGDCk8>|FPrjqq zE`;w9_MXaD*le9C^U#WUmgp2ps5!!P{6rf5*%O8z>iA_uUBSSEI{1yU##6Bpoy7p= z{@ez8tF2XAk8`B9KBW#jpugUi&}Nk!UvU|;ZOwDC?AiT3!5n?_#c}<$-3KfAF;#bU zHbp%(G*e6t@T$!p>k7le;3`IkMKpUJ4;2B)&q}05bveHGU*<>NMg?{l_n6$xWxjpw z;`r`^PfH^!_1PU9zk6z=cEG7XWUVTdm*)QTETQa&j)e2b#J@a!)~eu{m)ICcGv!aPGLiLjxfT(+R+crg z$)2uJ^O##uQlE8RitVvnPH4Vs zd$u=mMH`#2(W!OOxY9l?uu3nF-a z_@q0S6F%t;PHMhg6?kDx0qHTG57WZO?ZNTvlDN@+Jaf&Y=2n&S2V-)Ek2^zIz*;*w zfi}Y-xm_xE2;lCACN=+175T>4A}nDXx2~SlyhA0;J1xluMt@Z)UmBAl$Gu*<^X%|O zIeoElYM6t7sW;ECGQq}E+4bI#I-H?tNByBmsZt@Zau9Vq6WH@qu{}7Mh4QKg(y+bF zcd4{zthB^9o(>AC$IqJ|Q3(^?W1o$tL3O{cL3ilavL5qlVa^^gU1ePZKWQ61Q^JFV z;h}4^t|y5{Pxr!*7=0N}@U_uJRN}&o?ecZ*Mw(*G_){#AW`vzH#F}FchE(6#w9YqvIoLj?1?L$ z@CM!LcX-Q$@OD4R=aTKhRFos(0l=j27FWU<-clv&N}u+yUk1OJIG8#FUJ|x7WC+gGpEwzoVDdFB% z!$;{4Io!kuulcw#!kfp}-`yXZ^zGsO+;Auj_nzQ!wxj2-{3eiIups@Eufv;4LpNvd zN!)OFlQ*>B@FwY!J&Ehu-cfzBC%ny`_!3E+YO9#=Hq|S866Z_S3)7K~#2Er;LU@~W z%r-jar1tO(x}{OFO)fbZ9;;& zrRjCXdmDh7pWMa~qs{1e0c@IEiK#I! zJD5zO0vQ|SBdU1^Sx=2VIY_jia%%LSi4MQuw;rG4=L2_^fLrHD? z;GsEWQ^c+@U;CQc0TDUe4-Vl@rvJ*Mq-*i^6S5U z#=fFgH>AUtG){YYvHA9e+&uqT6~Dz6$lAPmF(R-wrFVT5T8h9Qvn_qWZEf$u8%0>y zj3q3#>S~9Ta zLZEva<2Gr|hMIo#-uKJH6>cLYtH6@&tKY^;H};KWJMFxFfm%SS)u#-tH(3yf_2a92 z>+_e^)pIuSklwWgxEG@q`nk=|V&^WvSxzjm*(!_{yq362?pd_@FUgflYt6q9$t`p#6SsW2 z#Vc=-U*xhXHy%r)VBF*Wxh)SYu1u~BhQDt6u-1Hn;=*5*LPTy689kD@DOx$%D#p28 zP9jtPNH$5Jo_DeR=R&FAwaK3SWUMv60f1!BA60m<0_Kf(Ns|0)`?@XpJmN}W5bu&) z@=pO2^AiP-XLh6F*d^H`i>zAnECo>n75-|{5G6_eg`e-0uXvZF%fH|fpyW(D-1@vC zCv2V5a%Jj%Lsu^ulGC58HTxQ6xzHt90z$q+tKWebR%4Za+MHyMWUe*8M@}J#Doc!N z0~-Q;GTOy?5TK9c*o@@LskP=^WKFItsx`kxK%a~bnG8jYJZUy|qw&hA0w7*lBwvCV z4d2X`H7ESM5;RddFz-`T-Au-jXhXvwB+!cCtrsqyNdN=%rdjRNJM=w`se|%}=?-DqXF-@9Q6k zUf~g9$BqjJz4&0d*%unqTNx4HaE8L^CCSXDhk>D*mZ)Z6tlvTGnhO~lU6O9${3dMA z@W5Z9yF_JJeIVH*$+hMtlHw{WKW+4Uyh|X+KXU7eJz2Y;AGmnn=eAbx`J%24qLDi1 z;^gOH%3HZqQ=d>JY3ety6dg_i@8a!Z|9EM#=a(dLohFh_pA}r67?gOuH67AGqZ0=a_C+=jSK2*#k#* zT-?_fRYHvW;L7dT$dUg4bvy9pu&9WO}@PB`-PyUWntpc!&)Ze;cAreU)B!upu!y1+TV}vExP{8bPhr4m1~zty@?4hHNP20Aen3^>vOF%@*;2_%@) z?0YF2w|Ulqrq7({5|;Hg;>pzQY++yHB+GQN+&GfuLl#9Ui`K2Y>|uA;1{bA3cRoBO z98QPZhOV!xJ4@>lFI+}hw)IRB$G{I45W!^)KggA(ktRFV-P7@W}j1ckVa#d}Y*18k^_Phdj2j*02Oq*P@$mEBkw zyt-{Due|a`D$RS@!u6l5;!^2hgs&rXW%COud|FRSqSRkgNnamLqGBF151f&%@62>S zOI3W=*S>l8$~i%Q+fZ=DS8ogEw+-ES_Z@cy-EBk5gLi*3QPJF-LPacNXo;ZG>`%p= zV3?)j))ALDUy3ciH<-uw-CtV~TUCQkZdUL=9?DLw7sd~vC$frq`Z3eH_w)KkMQ9)tSn+lDQZEUz{FIpZMYqtTXAml zUtdJCMBbbR^I9t-1H_5FMM=+ZX<^IcW*g8_IdW6AHTEx28;et|Gt=w;+~)wz4d(90 zTlqG+r6$^T5*4cxJ$hg`9Y|UMb!$nTM`_*Hl8%j6y$jo2=TY90=eI+J2{_Y%4CfAh zW|FJ|St`JTO}Q&?hLBQbT$+C4(}8RiKmz2-1LiBQk|8^}*@vo8?g-||$1DX?`mZ89 z;Nf8YVdcCleUgk}Dl{L>D=P)*>#G#(-($B5qg|MTPi+QUytk)srm`C0G3#D-{@Y0G0qy?iE@oovgqX4+=J9=S7ZW!A5o`E}+@ z+im=MaHj16&QF7)(l(!dEUO zv!`Fq+sIgDGmD%WUkJR@qNX;*XHUQ4vTJ~RWnOr|otTNA9H>+zq{3=I-%NyGoz7d@9b}@ zQ<04HnNe;&XC$6{&ine7%URXh+P>h`c8*cx@Kp(zuiL|Hq)k*I0CV`ogz;OK{3 z3Lonn>oX6qMv#ep>obv=#v2WwqovUiM6_9-T9JT|tViI5`%<*ILr%l2!%10$^eRLe zQ$%5rBt{jVMHI(pGth-t_ z-j6KAYUz3s^-kH}{hX`bw$LQLT8S6ijwk%M1>@W3jPO?&5L=el_bJ7UXrCq#OD%Gt zor}^4;e0j?rCeSYPx4-4>I|oeQuon6Q4!fAZ}MH&40Hvms>b~1lLAT^@$``<)43mW z0y1b_V&WmjWdF{$Rfy_yIN4b?T1Y32TDdkPWmc{Q542*dR*qJZS7Tn2&d;uq6(P10 zk{9<&XlM%8ThM7WIZ%RaaPIOYds}Ht6k2ci8D*yUhOW~M|dx;M7CH3 zr9|kGrs(4jK*px%#?^c+<`S{kbi_L)viQ817(`5EE>-73-`Xu^exQIiKPVI)a<^nD z^+^KRVPC#7oXlFeyxwqW>O7(Fi1EEDRvO`>ZY}VUl;TFo2d?E4bbE;-2GA%_tWUHSH`Fb`^u0Q1PY%hT;<690`g7Ub>v9Nq2-gB9|5ri=7QH0BPdfw z-aD^fV9u|R2?Q4-X>NPzrNNTl!j}#^kyrOHQlaBhS-WkP!%e(Nvu$$vscK2LiF8 z*q&Vnxn0jq^QMyRp@P_V?j>4fFC_c3Yu9q_e4Hx$7rnLXo$;?n0gs9qs1#i$3f>srebX=0rnyT~%xUA&ZMt^-oKD;kIY4yN+6pY2CC$ znw!STnZn9vVI>W{2>V6w*pry9a%$n?@UmA0TS(;!6wGoU@M=eb-)es?=YRcyk zOma%agK{^1gk=Aou2@L+Bw3zu@h45PJ4O*0eLwwa$pP^+5a_(#@*%KP4 z^;oD}EV1l~umlt@WW~EbfLC*L&u>yx(|SA$^qoz8gX;dCJ5pokl80dZcp4F@{l?R3 z*ScwP75)xhOVu|)>rvww_Zu~KfJKn63e2l%Ffv3$c*N$66Nok-a@kSqcuN`xE4J_r zPJgCtMwLCb0EY^jny`Uq_}QCEI!xku2&}tIejJn^=V{#?%Lqiu$l7t2gzT}7yZKI> zOIfX(OBj-b#F6V5QdI6`l-ap7DGmH#8Z%J0YIUT}OUOFhRI(}b6#~h0-Q27lsrvkp zs)y56DAQw7>-pZ={0&~3x}6j=WNo}Z_&E3;b}s7 z($gU*HI-}$EfJ+kDluRut*OLN#0aoQbBv@otrSHWY={h@4DLMeOVMKpZRA#FVAwh$ z%>=wcwc4Jz70C~Ku%V>p*o(W()PS9=ySm_wDg}eWu@@=Mj?lhaoNRbiDo;pkiqzXl zRc(sE_5r6rsCKAySCzh{N%kN;y^(+;Qtb>6WXi~rxuxUSh(T(8zt;1d>VX=^Mj?*Y zeLYo`C$;t4RjXbJeO2ooPYeua#aI-WM@BBGmUE*y6|I{8<E-0_I8a`(Mp1X2$GOpS}nx}EX|Ap?x5G0y~5U}VU(r<;&IZ~GK3z8Q&X z3l}wL6J`HrTq0h^yFx>V_-GmfAAH#v_rIft~KS4LZ{YLZI+BV9>KQVvp{U;#q&Ei0Hya5q80Vx618x5}>k z>}(VbpBxapD;Cuq^;khuxnFq zd^k7JF~$0pzCm8LKA7nJLgq<9$th?H@9+wOWTALObr?>6P zW7;NN`Wy=!y7U?8O+|)LexJ_}Kdm$AnUP6xCenRHxz@chsqdgyR4?@X*%F_vb>^hDQs|2U>Mv7gYl3$v{iPDFI9ly5}G zJ@QR64rj=;V2=eHrO6NyA;6r)JSATUR6-(F?J-aB;6;?+cKijY*(YWRG0A96f0=`p z^xUyQBoQxxLQa^)pMr@T-bQ-oJ^(^et@S>P9d4MI`H+&%nh9X9mIe=a^`6eSN;EoD3TC7V;(QJPVuQE z5Y>qI>6m#&$lb*%j|GOThuNq?&WlDS^ASR_SgkbJ7&P7 z7a>dG$CQ+;vw|WeuO}$PS;lDuyf}79&6d_yXQandAX5p)t+H~xePr#BX{{VAFIb~1 zhciVQiv8l0yu8U}R;+{ES&E=w zIA7msNzK#b7beUCsgL{5fLD!6H5>xkM{7{yW&QuDhHA%16{pZIENin=L)0Mp+-lDG z+YMpK$`q5DZIBWo0Q`zAA_1p0=Ty7U6vJoMa!%eOO-n%Gq&%p9s&MX}Kf*+n78CW! zba~}y-)dv}mS@40Cz1IqaVVZ_t($0z8}9J%lkvpCi$|wfwQu_D<@}p|HMb~+UyyQ zjEoE?ANl99G_lrS(HB|wX?f?KcPHKY7sV6+`IHDS}CbxbFPf~DaDn%?)U?3CHcqnO0w%TXzf$?wh&`}RAy zCgMEie7R6uLbe|#oBq+d*x5!)GWO!GgG!MQ+tmAxD_{H4ChWc${yYG$RmAn9D3*`A zw2D41>)}=EB^`v7XCX|QspQVBb^1|U`G@yA)hio?d!27cwXkKWb7+q9WvOnRs;-Ip zq%!;&Qq_LP_%VMXnOJm(GN!#TAH7JwqgtxkDODxrqYI;+JGP2=m#UoM{aMe5GOKXM zXhp_NN#~p5HAep=mKEE!%gnbQ-g|Cu#2G%81=wBl6ZZ1C;{Ndfddy-Ww9&|;n&aF9 zfo%7a?r0&8!8W>N6(A?LrS4FbB|>`XvAk@_kfv2r_nC<~7Rga1ITQnpmG?@$s?=5CPA6Y9{N0MFN*#)71Chv6xk1O8u! zACyC$)OlffQnKUdne%%`3E4v#bH3D@aL)0_9l|_)UmQWoY?6#*;@AMX#~cyYInEbj zf(aRi^C~x{mTf8X!hbTK60!d zDNj^ZR4E)MDsfulmt&w`5{^}mGaAP!ok2Sdja7-A@5ES@E9TE6q#j&mCq0S#*fiDf z{M@;Nrds~#Vz;vr0>6~LW_JF>;_~6pgyOFzL!KCAiX9;r?R9vPY~No@#vJ+(52r_5 zB{Y!M#ma}n2c40!;qai-YUb|-_k)9SvLq)AT2GZjC}`0=pPw$R$Db*TV@2gkSI`er z5e0k|NN3c$49}oK@dtnaz2daJCLKW0qT=%7p(03-S6qG~bQyu%;_{QB3kdiGeep+7 zP+U$E2uvMq0{mPwhgRrAkqXoiG(>u9v?;VBR(>*4b~09eB2soDR(?EuFf&qiJUp05 zk!x5JY6ptxERDs+O@-WUNW*Z|(dr z{I1=3tnXciQJ!=T$fkThx%Ch9L$NF+XY}2SOD>{}N|$MGgpaxOqeeLbMv0eK2Y)JM zps^7^fGLq;Nf+l(;odpUH=NrAaF+%6qp^UUNRSb+C4e&pupKL$R z;*Q+cZ+KdeiZo}cb0-MN-7s{5nsMVvV{I~39hIZPXBR(GyUf?tPpRE5Rc|vY#xeH1 z5YMO>sa-~99vFBBoH+w_$3Vq+=YT`rm!29Gs}zO8*vXYJ{0yd2h`aXs6TL#q@5?Dm z?D}yGV{s{wQ?EZMXEC}1P8YLAUjveBB@Qz~=U9Wo*RQ0<&slMcl==zZTK5C)a1zhY z|HzMI{&Vd`oD1O)?mEFn#NcYlB>IZ+#*MVsb5-Pe9?KAAnFRSl-=%^{22W^jx+2#8 zs`yM*#~bU|_}Y!NY%3d%v2I5p{1hNpo<{GZa5O9QS=H{e+Yd=vG9KVA$4=@TFg#M7JdnfO0MX{|erKYOZ%qazq} zuRNYca7Y@aFd3Wtxy?&A&1%-C@V_jL|8crBg})=FXfAm_Ot&>n=--nKL`U@zLT?(} z@F|L&9IbKR2o#R`T8EecIZwCg$2r^%q+pPXI2!k<{~m$F}JefJgcF4AA^ zJIJ8%T$TN5@1SG+K7JXVUjg05yqLW+`&H7u1RcDs2l~hFQx3DUw~<73oP)_9DcpLX zcl^G{luAJw(r6vEGLWaLeL`~Qhm~6QBx5nIx^Yz1 zcHj`vvH@^qv!yS>zudvr-X0oyTv9%uR+rw1-|y(@ePRLJT5q75@xccQ%lu zf5#T_A8?OV>u3x4)R> zy`S;<-c;-Ro2lQwx+2Rfhqdm8*sO7S2@~7H|DQ;Pxo+`b+F=l`t8Yh1{1aMOD&j9E zG|L$`JP*n8iUoB|Qj|kikWW7{avtF@<}hJ9S^kL@JW>X(@}g4YDvjX`2|$@WtUa)i-W(QINfv#rZc6Q z8l>*3D#23Ck4Mya_MeDUxr`e{2H`**;Ur%GlrM$m>xo+o*M?JZ#GAngekTRLqk@*; zTApPgsB~YE{~6uiwayw(ZL`o-%^lY|*X=+b(|BuSE~}M3cmuzuCW}s9K$+#@+S~d# zr~kz8OWvNsTE=>CqIE6${;RFE$<5MhmG0U)S&Ozp3$^*jZ@=^mUN`gvlTjHXC!hAi zxiop!u<=c{hI5l`?}&L?-#ZzX$anS*)=Fv^#$4CnB2(s~m(;wzIzKm7Ic}iR?Hs5a z&wAckTWJsfNJ`5pdHb!4qw`r!iM5fq0{#9d9(eRuU{=&R-fvKacq|E1Z<9TyO^xD8osN7Uknf1Th21>PDXA{8gr5{yX-|A z!o43zjO!~+@yhWIZ?saaNBco2NB@BFfWK6-vtEH;Bj-x~_dk_c_EUD|8&#Q%Qp0zz z;aMK6k~;ILlQ^H0zljY3Trb1%WOxv&JJ>=1@@>gLlHpP-D)K38^2T6OAlNAVnuUs> z#eB$qO5XMHMQ*aEK&4=u3PAW$_UmvEQl>*~eg#j@y<5n0aSpm=sU;a* zV^QpFMKOh{RO1?p=f&X3NvOymK@=3FIKxeZg+;)($DlY`R*3jJ_|)n#Pm7|Xr^@i% z7hEWa&4P~fha%;iV_;z6mceq7I$V)*smd8CXGJ1-BfX^Jp|G5NrSKN(JfBrEF`FLt z>mM*41=(W?StN=8LXHR^#GU}6mjn<)R@z}fNW(K+pMbGV5y7ACtWy_&u%Qc1=TV|q znOpyY3{184E^|3IiPm2~6q+V$y1l@$=A)`%!+#=H<1|`Ma11I(=eR@U@DE*eWU_F} zA8-OLMSez+TGCG%{-d!P_A^Igi%_{E4Xa#{YFbg{jG&C|X7gK3D+CVUfa8eN+anhU zs6KHhUg`?ns^8~wek}N~W!%H2e;y~!M$2$4Q`nY{8!x#NWNy%hNuD}JegsZ}X{_35 ztUVE{cSI_wBNL@VWWGIewv>94nJ~4vQ|n>teQ2>U%ds32%YlcJgFhaczr^nsqgVc* z5aJXLhrP9R#@(ycjTD|-6Bb^AqWin^2({uIAn!(;^ApC$vgI_t2B&!&)TRBLK{<$} za1&DIVp%&lg69~We)g=VW?-^(N8a#bEBmntt3@MXk*F4R&RkHM!wfl96CV@*_CeeXL^a1A=& znB&|g$|4c_`Z11(t^1s@I@|xK;JP8D;9`-qV{B!K`Bw9mCDCv7C7epd<=j`e!#T(} zz$`L2RX-YYj?ryZ*iy=^xhS`8kX6_IH0C@|wqu|Y?N(*BJKEq9dIwhPZ(h=BbJ64c z30;U7FU<_%13Wa@Xk2Z1WnLy8vdxx@Ap8rSBNa4mDNgKIjCq4!OZjbP3+0t=KfoCu znLw*TuOQPUl6RnU6_Qygo~gxe3!T;M+9jSHrme@;xOz3Sr2x~NDmPj3U_Bj3%9_l3 z#3{@e%o8UL!jJpVq@=t>H<rVl*QE@V_{n{)#39&*KSafnhr%7XpwBW)~ zBDK1Q)TUZ?+BtN}%m{0pgv`yJ2n#Z$EXbBx?uA)3wk zqA-+f^$~tCS3$(?e9`h6zLvOBZ|Iw8PgA#3S{51dkgehB5S6d7Xjrzg&V7u&T3z}1 zVNLJTm2WDvdqQ=!-kgP*2&?eXlc2exHRQs+JK}V{DfPV}Jd`-IdBaZWxCefv%sPd8 zOc~X#;1bqi-q1}}`}9he-`Qs@5Nk!B{(8xd6<@&h7Q4vBEVo#%ZgLd%;WWqc-qv?C z$0_@Rl2@1iLBD%-ta5zsey3VnRgTxzX9>R|*7aA9Y=-c*-~v_AT&p74y;Dt@bH0me zcCI)_&Cf9h6;VlKR;z|9Z=VWxiChC|23tdv4X#CP_At%=Xy2S!*7tl%_spc*Loh6`A zM_Qn1!Orw_avJ+@PK_+#WZcB0T>Otmh@Ut|u^ByKAIp6iRQhPLQ{f_XaETV}? zZ*rRVD-oCVQ@Jvuf+zl!pfzKCM3DU_{xrq%oxAvOV_vKg0gvv)nW03u)_x53lEsyO zgAICUJ>L_{f34>+G5IgtRM-c%FhX7w%?}pcs3lw1unL_l(o$AGBo}BM--UcL*30yu zwQqq9W~|?$!m>c8?katcY{NwJE9bYfsFF!IU&)^fVr#@cB|PA~=IzkrYxagF@;)(z zA>Vv%6UB1fiArw!5)*!zq1!9QA=-K*q}CnBgoQ906S-s7j~S331iCRL!3P=7HVZyZ zv18-xM2qDL0~Xi}v9fE`cdAn&?npS*3dRqzyBuegO8A<+tm(Tf(_7r7u-jy<59AA|?w zTnpbakTTSx>MW!NfgC#*C2Z^gaetlyoc}q11waaTKtT*Wub{n27wTO*paQ+6^n7;` z=DN8RQ!F|%9ucv6XjsJWe^5ebp>!BGW*lU2F6lVW<+ccsGFftz-0vFsk&fxvE_lYOPy&1;abmhoqcAM}zalG?w{W{Jg&X^W-3-Rrt(D`cj^$VP z{Bf<{aGzx8DJiN{bCZ;6Zj-FZ)H9-TeMwutDW#zk-HpCkP7|k&Y&gU3<)kl%!b5am zo@kI55OZbS?+On&wRSGKtH-^j)@$7>#_4++P`?JT;l9E4yqaU>1sf5SK7CK2gynKZ zj)eKnO<*K)gHw5WQxQHC7+zP9J2N-9tUSN-RZe?<+SU7* z8Zhdpk%=}Ms=2)4B`Qrara5bQB zITz$HXVu@|s<(0Z^^`;L8AbZmA}wcEjn=zE8#Uvn1c~2ZzizNz*&wREZna+b*st7O zu==?`=Yu1Sf05#kc~j~3)xFY(a1G}@Tlz(I{*j>3w1E^jUR`B0J!6H&8%^SDLEIQ) z-BS|c3Y)p+728FPa#;uYA|ki0xr^hL^3_4+oVq_4vl5|Ew_kEG7~2yjoKm=j`; zisNDZ31@g@wK?y!LPvK8WN@tA6~5fAAAkWTX)}n+r+`;3VI&W8XnR%x!K2&8pidnotVSc2h)1U1`TGuM*9`@2+*7B(L%xx)VB&e z9`AS>Mr}#q$3W5BQ4>`W#H*@RgayPpRiBEmYF?)htRf`DeWpz! z1!@ch5;rP0Etl75lX&h^b2i{M4h1K2Y#o%9+qZE8U(Da&8L0R{Q#+XYHa;b>|2`1A zk9Q_2^`YDB9BT)@ZRDGspz&8@U!;FIrZL}=(IB}>1qOuS9Qa0pcItSXBAa$#4pRg zOWSl@dm6L-G(4-@Yn;8C>q)~Cq7_eEJku#BQ#7R8&e-|9IkJ6e)S$fV9r_1(`_9Tc zW+1PVtk2nXvj1eDTB$Offpv`3KV9!|20qjt&K6aNbBDocwRzvq z_+BC=NjZM(-;Fv%#BKLOtV#M+Yy3Sd#x3lG8Ej$4b;VXNi`)Dv zj7MeerEPjbs2f=@h=gOVi*SMSvd$Ru4kv_Ra|el9<}+Q%%4}KW8x_kch`HRcWpv{r z-{|fFDMC4Ximz2lC|`btspH3uw-Z%1d0o7PhAC1qdhMuHM2Ru`#<#vGjUN& zL%^HRwd6 zmkeTvG2Q=6oVM|w&Ny48!+J_qIkJgph(P;zUoo*ner=A_*Vm&@XX@ScJ?|JzGIuuC zN&2?KX)zb}NwjPXH!`~>kDcL56O)j2oi9sk71`aR0BEzeq%i^8u0SC``EB~)dS^R3 z18ly8L6}(@>jW-{%mPhJe>7d~7!}wG-DfkqYM8K__O$HvI*ZZ2q(J3Rq6!55LFFkX z{@<3D7%w8mSSP#$ur}^gNDw0dr}Xml{w{S2*94@yAHD>I(c<{GImXq}L%My4e|SkT zkFe1K`MH)Kt?_L>*^Kk@ANtwkfE|_lM~jzw6MmbQesxwN#Y<`ZiH2GlS*1DunZCZD zVVbjeB151sAIj8tNL}Qu<7km22qK;?B>`VZBQZ9sBvqWM zq>3}kF0v-j7A_)@40<%5T&oE2kSz^7Lh7N02F6<99ec>_RB|n)+eH*0-cm``zxb_! zP4ZBr#q!nWdMj26B-Ubk)(42ipVY39`Mu8(l8zC^lxEyv<+22#DobLEtyn4AE=yvs z?JrA8rx`YIiKVs>Hui*i!eB76)9|qWhNS5vE;ChTMuUL_zXw} z2M1ZIKBYpkc70lfPFsdw86iZEjVdk5?Lka%&_<)I(DV<(zgFzl^a>UI0c8@ntx8|; z@6g}vVKDHKyK(0lU*LrYv(;>;Nk$3dHRJWz3-Kc7zFHhDQ^KEGnKw4c{SL-{{~ji% zSL!F+4_-%db@uATY8P2FLaE8)ofQKA%iFJl*(okuV(HYBRNjx-ywYZSGbLx2KCTC*E zrj(ZNjTc~C%vb9FaEdIoi_i5`F`=Gg?Bz)13u0Yowzf=F*&HdM zq4h7gTJ9LPP)flTJ~mcL zI-|{#K;Dw*RBoGP>x*r#85CLjeJCPmj*Op65y&AIa_B1V85Q(twGI+;A6Zn1u?{AK zpgdBxS_matwn`leBS&jj;7!1(lpd9y^R=z?i#tY0`l$NG)f|cpXIS4Nb5_eYF775k zX)2{1Ne27Om@k26$a&yN6?m{-xX9y<%wXxk>z`+du~?GqcjT^^n! zPjV0Rb_e7#iZc?b#iOwTb?+*)OS#TYc}m*)^vL*1XRM^JrQ|fbF@@icELQGeO_EzB z53Pxjh#eSbT1s#^Vf%tgBo2^wQ|NW9sV$O}C5oTLF9gdW#g*VZOP)EWV{=Zll$@}0 z{#l9-`^luBDN&9jjP)faTS|I(P{YaCoZgm_-j+G1q$)D>TWjP#$z?wGa}WzBwuLx3 zkL~^=kE#oDPj40l|Mnd*vDd1nQ(;fGv>MScM7cv1^tp%>nDnqmvLB_7@w+* zPxSY;;?L}H=xs$>Rhu@-p?QitD#XK6lx+nuP!;7_!90vqf!)hrTpZZ7;tnjQ;=gvx z6EDK|E+u?S{EmuaQ^i^DBC3W_s5o@}%)N)F9vc;(k!mOMgfHPMUos`d%(la+Q>Gqc z&&~|jvAK$VJ{e3t>bylan~4hDD<&H&rPK`P$Au~3wC9RwMZya~6WmX5nE07ISM*A{ zC$M`3=33=+m@)-`KOIDo%HL3k(qp-O8g;UW?)+Rl>f+!?c?pHDZaf&DonmZ{SEXvj zZ9NAsKIq&Zcy+}{_LmJ8X8??|uP*=WH}1qO;^yXsmh$(-XQwtEG`4HsZ;yLrd#%Iy zCl;lO+sMaa&2aYf;t(q39L^V{Hsw(96T_+X(=G^Q3-q|2%^ae)yIabJ=v#+U?C#&>S?w4~JDg!!<4*N& zPqtx@EKu}`{KPNK6P_rPiGlupR#vY=z>l-#8}yVKE9+}1JJV93JVudkgUS&3D+@Id zK<}Ai-D^EktPAd%Xhc?t6O*-#5i!H*rh|KH%v8phRezH6!>-dU8Qd9Jz-L#&Q~&II z0`BD#t(a7i>Gfpfw6qjs%Bt|N5xgPdS9M&m7R6lxwMD9^_a3r}>c5Y6O#S8x%5rd{ zP1)+y%@|Z1_64VdU{~$8#y_uppzw-x(z`nA#Unu-JuFMTTxuG+n1k0jP}93qE|AVN z3#Q8z3?4C}hf|ky)NTcgp!sy;xx?#=GX5B4i?HI_*R@s8-6Mf#crj?e|Qd&tGTy$fiF!+gye4ZE6FOB?w&&?O+tB})-* zmR7?w<0`uYy4wxH+ z|4RjAkTgyJ)lYcB!)x@-qL4a5Lyal!%iELb9%PJlRvi-8%=^4kS|VqZtJ>Y5VMuRmdaUUcvB&v+B^pTSV)k1xWr&h zk!S}XuE09??-=LHUM*aWw>f2vG1g1TfH7=tMc+Q~y|`npS!7k3zikV_Q_#j(P=?k~dnzR)BXix;639IAoZu5 zVccBDr))?`TokVxzrlHITWUCULrQE<%h+SvWZuQDY)ne!Si017sXRGd8lk339g7!6 zOEZ=*QzDdH+vZ(3z@|5?q1|qgT;<;I3@@?ZI9W-`h?Qq55w`zOVu(6JKvbA4?ps?E zII#A6%+yDK6FDyKAu@6K+c4`=vy@P{it~_V=7Ss7@BbaQBatc9=ERdC3Nj5d`fHh8 zQ^2Tr#zHylI=jleX1}6~h`Oyn^6KSocl5iSJGD(63+0Z0CD>s^fu~>QzfP9|V(3D1 zqcyY&E!8fQXw%DxX=?mfY~KH?`Y+@cGNJn~7h;0AFJ{)x0t=^7&TwZlWsgW(7|>

&8PoU%eW(TL0rEMgYZ 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

{L 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%0AFSPoz=lI*=#QDa91D34P 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%0Dq#j*@T4X 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

%Ih&6au?;7ZSIXVx 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 Date: Thu, 3 Sep 2026 20:50:11 +0200 Subject: [PATCH 002/101] Add local fallbacks for remote packages --- remote_packages.py | 293 ++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 261 insertions(+), 32 deletions(-) diff --git a/remote_packages.py b/remote_packages.py index bd6dd61..f9d8b44 100644 --- a/remote_packages.py +++ b/remote_packages.py @@ -261,6 +261,88 @@ def _atomic_replace_file(source, target): pass +def _package_cache_dir(target_dir, package_id): + return os.path.join( + target_dir, + ".modernization_tool", + "package_cache", + package_id, + ) + + +def _store_cached_file(target_dir, package_id, source_path, filename, revision=None): + """Persist one validated remote artifact as a local offline fallback.""" + cache_dir = _package_cache_dir(target_dir, package_id) + os.makedirs(cache_dir, exist_ok=True) + + cached_path = os.path.join(cache_dir, filename) + _atomic_replace_file(source_path, cached_path) + + metadata = { + "filename": filename, + "size": os.path.getsize(cached_path), + "sha256": _file_sha256(cached_path), + "revision": revision, + } + metadata_path = os.path.join(cache_dir, "metadata.json") + staged = metadata_path + ".new" + try: + with open(staged, "w", encoding="utf-8", newline="\n") as handle: + json.dump(metadata, handle, indent=2, sort_keys=True) + handle.write("\n") + os.replace(staged, metadata_path) + finally: + if os.path.exists(staged): + try: + os.remove(staged) + except OSError: + pass + + return cached_path + + +def _load_cached_file(target_dir, package_id, filename=None, expected_revision=None): + """Return a cached artifact only when its recorded integrity still matches.""" + cache_dir = _package_cache_dir(target_dir, package_id) + metadata_path = os.path.join(cache_dir, "metadata.json") + try: + with open(metadata_path, "r", encoding="utf-8") as handle: + metadata = json.load(handle) + except (OSError, json.JSONDecodeError): + return None + + recorded_name = metadata.get("filename") + if not isinstance(recorded_name, str) or not recorded_name: + return None + if filename is not None and recorded_name != filename: + return None + + revision = metadata.get("revision") + if expected_revision is not None and str(revision) != str(expected_revision): + return None + + cached_path = os.path.join(cache_dir, recorded_name) + if not os.path.isfile(cached_path): + return None + + expected_size = metadata.get("size") + expected_sha = metadata.get("sha256") + if not isinstance(expected_size, int) or expected_size <= 0: + return None + if not isinstance(expected_sha, str) or len(expected_sha) != 64: + return None + + try: + if os.path.getsize(cached_path) != expected_size: + return None + if _file_sha256(cached_path).lower() != expected_sha.lower(): + return None + except OSError: + return None + + return cached_path, metadata + + def _remove_tree(path): if not os.path.exists(path): return @@ -807,6 +889,13 @@ def install_wowpresence(target_dir, progress=None): exe_path = _find_file(extract_root, "WowPresence.exe") _verify_x86_pe(dll_path, "WowPresence.dll") _verify_x86_pe(exe_path, "WowPresence.exe") + _store_cached_file( + target_dir, + WOWPRESENCE_MANAGED_ID, + zip_path, + "WowPresence.zip", + revision=revision, + ) _emit_progress(progress, f"Installing WowPresence {revision}...", None, None) _install_managed_files_transactional( @@ -844,6 +933,74 @@ def install_wowpresence(target_dir, progress=None): return revision +def install_cached_wowpresence(target_dir, progress=None): + """Install the last validated WowPresence package cached by this WoW install.""" + cached = _load_cached_file( + target_dir, + WOWPRESENCE_MANAGED_ID, + "WowPresence.zip", + ) + if cached is None: + raise RemotePackageError("No validated WowPresence offline fallback is cached.") + + zip_path, metadata = cached + revision = str(metadata.get("revision") or "cached") + + existing_manifest = _load_managed_manifest_data( + target_dir, + WOWPRESENCE_MANAGED_ID, + ) + dlls_entry_preexisting = existing_manifest.get("dlls_entry_preexisting") + if not isinstance(dlls_entry_preexisting, bool): + if existing_manifest: + dlls_entry_preexisting = _managed_backup_exists( + target_dir, + WOWPRESENCE_MANAGED_ID, + "WowPresence.dll", + ) + else: + dlls_entry_preexisting = _dlls_contains_entry( + target_dir, + "WowPresence.dll", + ) + + ensure_wowpresence_config(target_dir) + extract_root = tempfile.mkdtemp(prefix="modernization_wowpresence_cache_") + try: + _emit_progress(progress, "Loading cached WowPresence fallback...", None, None) + _safe_extract(zip_path, extract_root) + dll_path = _find_file(extract_root, "WowPresence.dll") + exe_path = _find_file(extract_root, "WowPresence.exe") + _verify_x86_pe(dll_path, "cached WowPresence.dll") + _verify_x86_pe(exe_path, "cached WowPresence.exe") + + _install_managed_files_transactional( + target_dir, + WOWPRESENCE_MANAGED_ID, + [ + (dll_path, "WowPresence.dll"), + (exe_path, "WowPresence.exe"), + ], + revision=revision, + ) + _set_managed_manifest_values( + target_dir, + WOWPRESENCE_MANAGED_ID, + dlls_entry_preexisting=bool(dlls_entry_preexisting), + file_sha256={ + "WowPresence.dll": _file_sha256(dll_path), + "WowPresence.exe": _file_sha256(exe_path), + }, + package_digest=None, + package_revision=f"cache:{metadata.get('sha256', '')}", + ) + finally: + shutil.rmtree(extract_root, ignore_errors=True) + + ensure_wowpresence_config(target_dir) + return revision + + def install_interact(target_dir, progress=None): _emit_progress(progress, "Checking Interact release...", None, None) release = _latest_release("lookino/Interact") @@ -1656,27 +1813,57 @@ def _install_remote_mpq( timeout=300, revision=None, ): - temp_path = _download( - url, - suffix=".mpq", - progress=progress, - label=label, - timeout=timeout, - ) + downloaded_path = None + source_path = None + try: + downloaded_path = _download( + url, + suffix=".mpq", + progress=progress, + label=label, + timeout=timeout, + ) + _verify_mpq(downloaded_path) + _store_cached_file( + target_dir, + mod_id, + downloaded_path, + "payload.mpq", + revision=revision, + ) + source_path = downloaded_path + except Exception as download_error: + cached = _load_cached_file( + target_dir, + mod_id, + "payload.mpq", + expected_revision=revision, + ) + if cached is None: + raise download_error + source_path, _ = cached + _verify_mpq(source_path) + _emit_progress( + progress, + f"{label.replace('Downloading ', '')}: using cached offline fallback.", + None, + None, + ) + try: - _verify_mpq(temp_path) _emit_progress(progress, f"Installing {os.path.basename(destination)}...", None, None) _install_managed_files( target_dir, mod_id, - [(temp_path, destination)], + [(source_path, destination)], revision=revision, ) finally: - try: - os.remove(temp_path) - except OSError: - pass + if downloaded_path and os.path.exists(downloaded_path): + try: + os.remove(downloaded_path) + except OSError: + pass def _google_drive_download_url(file_id): @@ -1744,27 +1931,67 @@ def install_fog_pushback(target_dir, progress=None): def install_pink_herbs(target_dir, progress=None): mod_id = "visual_pink_herbs" destination = os.path.join("Data", "patch-V.mpq") - revision = _branch_head_sha("seacrabsam/patch-herb", "main") + downloaded_path = None + source_path = None - if _package_state_is_current(target_dir, mod_id, revision): + try: + revision = _branch_head_sha("seacrabsam/patch-herb", "main") + except Exception as revision_error: + cached = _load_cached_file(target_dir, mod_id, "payload.mpq") + if cached is None: + raise revision_error + source_path, metadata = cached + revision = str(metadata.get("revision") or "cached") + _verify_mpq(source_path) _emit_progress( progress, - f"Pink Herbs {revision[:7]} is already current.", + "Pink Herbs: using cached offline fallback.", None, None, ) - return f"seacrabsam/patch-herb main@{revision[:7]}" + else: + if _package_state_is_current(target_dir, mod_id, revision): + _emit_progress( + progress, + f"Pink Herbs {revision[:7]} is already current.", + None, + None, + ) + return f"seacrabsam/patch-herb main@{revision[:7]}" + + try: + downloaded_path = _download( + f"https://raw.githubusercontent.com/seacrabsam/patch-herb/{revision}/patch-H.mpq", + suffix=".mpq", + progress=progress, + label="Downloading Pink Herbs", + timeout=300, + ) + _verify_mpq(downloaded_path) + _store_cached_file( + target_dir, + mod_id, + downloaded_path, + "payload.mpq", + revision=revision, + ) + source_path = downloaded_path + except Exception as download_error: + cached = _load_cached_file(target_dir, mod_id, "payload.mpq") + if cached is None: + raise download_error + source_path, metadata = cached + revision = str(metadata.get("revision") or revision) + _verify_mpq(source_path) + _emit_progress( + progress, + "Pink Herbs: using cached offline fallback.", + None, + None, + ) - temp_path = _download( - f"https://raw.githubusercontent.com/seacrabsam/patch-herb/{revision}/patch-H.mpq", - suffix=".mpq", - progress=progress, - label="Downloading Pink Herbs", - timeout=300, - ) try: - _verify_mpq(temp_path) - _migrate_legacy_pink_herbs_patch(target_dir, temp_path, progress=progress) + _migrate_legacy_pink_herbs_patch(target_dir, source_path, progress=progress) _emit_progress( progress, f"Installing {os.path.basename(destination)}...", @@ -1774,7 +2001,7 @@ def install_pink_herbs(target_dir, progress=None): _install_managed_files( target_dir, mod_id, - [(temp_path, destination)], + [(source_path, destination)], revision=VISUAL_MOD_REVISIONS[mod_id], ) _record_package_state_safely( @@ -1784,12 +2011,14 @@ def install_pink_herbs(target_dir, progress=None): [destination], ) finally: - try: - os.remove(temp_path) - except OSError: - pass + if downloaded_path and os.path.exists(downloaded_path): + try: + os.remove(downloaded_path) + except OSError: + pass - return f"seacrabsam/patch-herb main@{revision[:7]}" + suffix = revision[:7] if len(revision) >= 7 else revision + return f"seacrabsam/patch-herb main@{suffix}" def _download_github_branch_archive( -- 2.52.0 From fb9275e13a881811fd0c11a54a3db91a165b744e Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 20:50:38 +0200 Subject: [PATCH 003/101] Use cached WowPresence fallback offline --- setup_tool_dynamic.py | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 29256de..d3ec531 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -1318,10 +1318,21 @@ class ModernWowSetupTool(WowSetupTool): exc, ) else: - raise RuntimeError( - "Could not install WowPresence from " - "https://github.com/Dusk-92/WowPresence releases." - ) from exc + try: + remote_packages.install_cached_wowpresence( + target, + progress=self._report_download_progress, + ) + except Exception as fallback_exc: + raise RuntimeError( + "Could not install WowPresence from its online source " + "and no validated local fallback is available." + ) from fallback_exc + self._warn_offline( + "WowPresence", + "The last validated cached WowPresence package was installed instead.", + exc, + ) # Remove the old test-branch filenames after a successful # migration. The legacy config directory is intentionally -- 2.52.0 From 023dd7ba1d1c615819086e5b7c8d791b93716466 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 20:50:48 +0200 Subject: [PATCH 004/101] Record SuperWoW fallback provenance --- Payload/Fallback/versions.json | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/Payload/Fallback/versions.json b/Payload/Fallback/versions.json index 72a9952..d167fec 100644 --- a/Payload/Fallback/versions.json +++ b/Payload/Fallback/versions.json @@ -590,6 +590,21 @@ "sha256": "7b0b0fcdb8bb9e82c5a18ab395af670f57da3e03035b27d5e244e4f8b457fdf2" } ] + }, + "SuperWoW fallback": { + "version": "2.2", + "source": "https://github.com/balakethelock/SuperWoW/releases/download/Release/SuperWoW.release.2.2.zip", + "superapi_source": "https://github.com/balakethelock/SuperAPI", + "superapi_revision": "901322dc88890a2ea10610b8228fb43c9c2a3610", + "superapi_tree_sha": "95bb25752b1f31f7d4ca8d5e416986b5e3031b33", + "note": "Bundled fallback restored after redistribution permission was reported by the Modernization Tool maintainer on 2026-09-03.", + "files": [ + { + "path": "Payload/SuperWoWhook.dll", + "sha256": "bd214b32c878649e94ce654835946bd05e0ce7710e8f01bae10d8ab50a89351d", + "size": 1000448 + } + ] } } } -- 2.52.0 From fa764ba40f50505095db86c77681521591102d71 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 20:51:01 +0200 Subject: [PATCH 005/101] Document expanded offline fallbacks --- README.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 0c568b8..f27c809 100644 --- a/README.md +++ b/README.md @@ -158,15 +158,19 @@ Depending on the component, the tool can: - use a bundled known-good fallback where redistribution terms allow it; - avoid re-downloading files that are already current. -**SuperWoW and SuperAPI are upstream-only:** SuperWoW is downloaded from its -official stable release and SuperAPI follows the current upstream `master` -revision. They are not bundled as offline fallbacks, so a first-time SuperWoW -installation requires network access. +**SuperWoW and SuperAPI prefer their upstream sources:** SuperWoW is downloaded +from its official stable release and SuperAPI follows the current upstream +`master` revision. If either online source is unavailable, the tool can install +the bundled known-good SuperWoW + SuperAPI fallback instead. + +**WowPresence and remote visual mods keep a validated local cache** after a +successful download. That cache can be reused automatically for repair or +reinstallation when the online source is temporarily unavailable. **No1600x1200 uses the bundled known-good copy** instead of following the RetroCro archive repository automatically. -Downloaded and bundled DLLs are validated before installation. +Downloaded, cached and bundled DLLs are validated before installation. --- -- 2.52.0 From d49fb9acc02bccf876b5d2c60777977f8cd73ba2 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 20:51:15 +0200 Subject: [PATCH 006/101] Document restored SuperWoW fallback --- Docs/BINARY_PROVENANCE.md | 45 ++++++++++++++++++++++----------------- 1 file changed, 25 insertions(+), 20 deletions(-) diff --git a/Docs/BINARY_PROVENANCE.md b/Docs/BINARY_PROVENANCE.md index 3c9131d..2113f2f 100644 --- a/Docs/BINARY_PROVENANCE.md +++ b/Docs/BINARY_PROVENANCE.md @@ -20,8 +20,8 @@ No remaining payload binary was modified during this provenance pass. | VanillaMultiMonitorFix | bundled fallback + online update | Mates1500/VanillaMultiMonitorFix 0.2 | MIT verified | | ClassicAPI | bundled fallback + online update | brues-code/ClassicAPI | GPL v3 verified | | AuctionQueryThrottle | bundled fallback + online update | brues-code/AuctionQueryThrottle | GPL v3 verified | -| SuperWoW | **upstream-only** | balakethelock/SuperWoW release | redistribution restricted upstream | -| SuperAPI | **upstream-only** | balakethelock/SuperAPI master | no bundled copy; current master revision is resolved before download | +| SuperWoW | bundled fallback + online update | balakethelock/SuperWoW release 2.2 | redistribution permission reported by the Modernization Tool maintainer on 2026-09-03 | +| SuperAPI | bundled fallback + online update | balakethelock/SuperAPI master | redistribution permission reported by the Modernization Tool maintainer on 2026-09-03 | | UnitXP_SP3 | bundled fallback + online update | brues-code/UnitXP_SP3 v90 | project-wide license not independently located | | Interact | bundled fallback + online update | lookino/Interact v1.0.4 | project-wide license not independently located | | No1600x1200 | **bundled known-good only** | RetroCro/TurtleWoW-Mods archive source | project-wide license not independently located | @@ -32,29 +32,34 @@ No remaining payload binary was modified during this provenance pass. | NoErrorSounds | bundled fallback + online source | Macumbafeh/NoErrorSounds | project-wide license not independently located | | Warlock Muted Demons | bundled fallback + online source | spzilyk/Warlock-Muted-Demons | project-wide license not independently located | -## SuperWoW change +## SuperWoW / SuperAPI fallback -Before this audit the repository contained: +The bundled SuperWoW + SuperAPI fallback has been restored after the +Modernization Tool maintainer reported upstream redistribution permission on +2026-09-03. + +The online source remains preferred: + +- SuperWoW is resolved from the official stable release; +- SuperAPI follows the current upstream `master` revision and is downloaded + from the exact resolved commit SHA. + +If the online installation fails and there is no complete existing install to +preserve, the tool can install the bundled known-good pair instead. + +Bundled fallback provenance: - `Payload/SuperWoWhook.dll` -- SHA-256 recorded in `versions.json`: +- SuperWoW version: 2.2 +- SHA-256: `bd214b32c878649e94ce654835946bd05e0ce7710e8f01bae10d8ab50a89351d` -- source: - `balakethelock/SuperWoW` release package +- bundled SuperAPI revision: + `901322dc88890a2ea10610b8228fb43c9c2a3610` +- bundled SuperAPI Git tree: + `95bb25752b1f31f7d4ca8d5e416986b5e3031b33` -That bundled fallback is removed by this audit because the current upstream -license restricts redistribution without express written permission. - -The installation feature itself is retained: `remote_packages.install_superwow` -downloads the official SuperWoW release and the current SuperAPI master -revision directly from its upstream repository. - -## SuperAPI change - -The previous bundled fallback under -`Payload/Interface/Addons/SuperAPI/` is removed together with the SuperWoW -fallback. The installer continues to obtain SuperAPI directly from -`balakethelock/SuperAPI` when SuperWoW is installed. +The exact fallback metadata is also recorded in +`Payload/Fallback/versions.json`. ## Hash manifest -- 2.52.0 From 480d20f39e4ed48ae339a2fa7afeb0211442f6d0 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 20:51:46 +0200 Subject: [PATCH 007/101] Add remote fallback regression tests --- tests/test_safety.py | 165 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 165 insertions(+) diff --git a/tests/test_safety.py b/tests/test_safety.py index 16b3862..d604bd0 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -1395,6 +1395,171 @@ class BundledComponentSafetyTests(unittest.TestCase): revision = state.call_args.args[2] self.assertIn("superapi:abc1234", revision) + def test_package_cache_rejects_tampered_artifact(self): + with tempfile.TemporaryDirectory() as root: + source = os.path.join(root, "source.bin") + with open(source, "wb") as handle: + handle.write(b"validated fallback payload") + + cached_path = remote_packages._store_cached_file( + root, + "example", + source, + "payload.bin", + revision="rev1", + ) + + loaded = remote_packages._load_cached_file( + root, + "example", + "payload.bin", + expected_revision="rev1", + ) + self.assertIsNotNone(loaded) + self.assertEqual(loaded[0], cached_path) + + with open(cached_path, "ab") as handle: + handle.write(b"!") + + self.assertIsNone( + remote_packages._load_cached_file( + root, + "example", + "payload.bin", + expected_revision="rev1", + ) + ) + + def test_remote_mpq_uses_validated_cache_when_download_fails(self): + with tempfile.TemporaryDirectory() as root: + source = os.path.join(root, "visual.mpq") + with open(source, "wb") as handle: + handle.write(b"MPQcached-visual") + + remote_packages._store_cached_file( + root, + "visual_example", + source, + "payload.mpq", + revision="rev1", + ) + + with ( + mock.patch.object( + remote_packages, + "_download", + side_effect=remote_packages.RemotePackageError("offline"), + ), + mock.patch.object( + remote_packages, + "_install_managed_files", + ) as install, + ): + remote_packages._install_remote_mpq( + root, + "visual_example", + "https://example.invalid/visual.mpq", + os.path.join("Data", "patch-X.mpq"), + revision="rev1", + ) + + cached = remote_packages._load_cached_file( + root, + "visual_example", + "payload.mpq", + expected_revision="rev1", + ) + self.assertIsNotNone(cached) + self.assertEqual( + install.call_args.args[2][0][0], + cached[0], + ) + + def test_superwow_bundled_fallback_keeps_dll_and_superapi_paired(self): + tool = ModernWowSetupTool.__new__(ModernWowSetupTool) + tool.addon_dependencies = { + "SuperWoWhook.dll": "SuperAPI", + } + tool._valid_x86_dll = mock.Mock(return_value=False) + tool._verified_bundled_file = mock.Mock() + tool._warn_offline = mock.Mock() + + with tempfile.TemporaryDirectory() as root: + payload = os.path.join(root, "Payload") + addon = os.path.join( + payload, + "Interface", + "Addons", + "SuperAPI", + ) + os.makedirs(addon) + dll = os.path.join(payload, "SuperWoWhook.dll") + with open(dll, "wb") as handle: + handle.write(b"fallback") + with open(os.path.join(addon, "SuperAPI.toc"), "w", encoding="utf-8") as handle: + handle.write("## Interface: 11200\n") + + target = os.path.join(root, "game") + os.makedirs(target) + tool._verified_bundled_file.return_value = (dll, "a" * 64) + + with mock.patch.object( + remote_packages, + "_transactional_replace_bundle", + ) as transaction: + tool._fallback_core_dll( + payload, + target, + "SuperWoWhook.dll", + RuntimeError("offline"), + ) + + transaction.assert_called_once() + items = transaction.call_args.args[0] + self.assertEqual([item[0] for item in items], ["file", "dir"]) + self.assertEqual(os.path.basename(items[0][2]), "SuperWoWhook.dll") + self.assertEqual(os.path.basename(items[1][2]), "SuperAPI") + tool._verified_bundled_file.assert_called_once_with( + "Payload/SuperWoWhook.dll", + "SuperWoWhook.dll fallback", + ) + + def test_cached_wowpresence_can_install_without_online_release(self): + with tempfile.TemporaryDirectory() as root: + package = os.path.join(root, "WowPresence.zip") + with zipfile.ZipFile(package, "w") as archive: + archive.writestr("WowPresence.dll", b"dummy-dll") + archive.writestr("WowPresence.exe", b"dummy-exe") + + remote_packages._store_cached_file( + root, + remote_packages.WOWPRESENCE_MANAGED_ID, + package, + "WowPresence.zip", + revision="v1.3", + ) + + with ( + mock.patch.object(remote_packages, "_verify_x86_pe"), + mock.patch.object( + remote_packages, + "_install_managed_files_transactional", + ) as install, + mock.patch.object( + remote_packages, + "_set_managed_manifest_values", + ), + ): + revision = remote_packages.install_cached_wowpresence(root) + + self.assertEqual(revision, "v1.3") + install.assert_called_once() + mappings = install.call_args.args[2] + self.assertEqual( + sorted(relative for _, relative in mappings), + ["WowPresence.dll", "WowPresence.exe"], + ) + def test_branch_archive_download_can_be_pinned_to_resolved_revision(self): with ( mock.patch.object(remote_packages, "_download", return_value="archive.zip") as download, -- 2.52.0 From ae3a23be17b4e5932f686ac1a7b57742e9f5e1a3 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 20:53:01 +0200 Subject: [PATCH 008/101] Update SuperWoW redistribution notice --- THIRD_PARTY_NOTICES.md | 33 +++++++++++++++++---------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md index 9c4058a..64331d7 100644 --- a/THIRD_PARTY_NOTICES.md +++ b/THIRD_PARTY_NOTICES.md @@ -76,29 +76,30 @@ preserved during this audit: - License: MIT - Preserved as `LICENSES/VanillaMultiMonitorFix-MIT.txt` -## SuperWoW and SuperAPI: upstream-only distribution +## SuperWoW and SuperAPI -SuperWoW's current upstream license states that distribution is prohibited -without the copyright holder's express written permission. +SuperWoW's upstream license requires the copyright holder's express permission +for redistribution. The Modernization Tool maintainer reported receiving that +redistribution permission from the upstream author on 2026-09-03. -Because no written redistribution authorization is documented in this -repository, Modernization Tool no longer bundles `SuperWoWhook.dll` as an -offline fallback. The tool already downloads SuperWoW directly from the -official upstream release when the user enables it. +Modernization Tool therefore keeps a known-good SuperWoW + SuperAPI fallback +while continuing to prefer the official upstream sources whenever they are +available. - SuperWoW source: https://github.com/balakethelock/SuperWoW - License copy: `LICENSES/SuperWoW-LICENSE.txt` -- Distribution mode: downloaded from upstream at install time; not bundled - -SuperAPI is likewise downloaded directly from its upstream repository as part -of the SuperWoW installation path and is no longer kept as a bundled fallback. - +- Online mode: latest stable upstream release +- Bundled fallback: `Payload/SuperWoWhook.dll` - SuperAPI source: https://github.com/balakethelock/SuperAPI -- Distribution mode: downloaded from upstream at install time; not bundled +- Online mode: current upstream `master` revision resolved to an exact commit +- Bundled fallback: `Payload/Interface/Addons/SuperAPI/` -If the upstream download is unavailable, an already complete installed -SuperWoW/SuperAPI setup may be kept by the tool, but a new offline installation -cannot use a bundled SuperWoW fallback. +The exact bundled revision and binary hash are recorded in +`Payload/Fallback/versions.json` and `Docs/BINARY_PROVENANCE.md`. + +If the online update is unavailable, a complete valid existing installation is +kept first. If repair or first-time installation is still required, the bundled +known-good SuperWoW + SuperAPI pair can be installed atomically instead. ## Components whose redistribution license was not independently located -- 2.52.0 From ad62557e59a7577445be9e84185561651e856734 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 20:53:06 +0200 Subject: [PATCH 009/101] Update SuperWoW license scope --- LICENSES/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/LICENSES/README.md b/LICENSES/README.md index b915cc6..21a5459 100644 --- a/LICENSES/README.md +++ b/LICENSES/README.md @@ -18,7 +18,7 @@ Preserved files: - `VanillaMultiMonitorFix-MIT.txt` - `GPL-3.0.txt` — reference copy for GPL-v3 components such as ClassicAPI and AuctionQueryThrottle -- `SuperWoW-LICENSE.txt` — preserved for the upstream-only SuperWoW component +- `SuperWoW-LICENSE.txt` — preserved for the SuperWoW component and bundled fallback See `../THIRD_PARTY_NOTICES.md` and `../Docs/BINARY_PROVENANCE.md` for the scope, distribution mode, and source of each component. -- 2.52.0 From 1b80a904b781d119bc0e4516c87ab0aa6114882d Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 20:53:37 +0200 Subject: [PATCH 010/101] Fix WowPresence cache test import --- tests/test_safety.py | 1 + 1 file changed, 1 insertion(+) diff --git a/tests/test_safety.py b/tests/test_safety.py index d604bd0..d4afbe9 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -4,6 +4,7 @@ import os import struct import tempfile import unittest +import zipfile from unittest import mock import remote_packages -- 2.52.0 From 6883fb318d6f10edad87085298e402d909758522 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:10:39 +0200 Subject: [PATCH 011/101] Harden remote fallback cache behavior --- remote_packages.py | 357 ++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 319 insertions(+), 38 deletions(-) diff --git a/remote_packages.py b/remote_packages.py index f9d8b44..dd01a40 100644 --- a/remote_packages.py +++ b/remote_packages.py @@ -266,21 +266,43 @@ def _package_cache_dir(target_dir, package_id): target_dir, ".modernization_tool", "package_cache", - package_id, + str(package_id), ) +def _safe_cache_filename(filename): + if not isinstance(filename, str) or not filename: + raise RemotePackageError("Invalid package-cache filename.") + normalized = filename.replace("\\", "/") + if ( + normalized in (".", "..") + or "/" in normalized + or ":" in normalized + or os.path.basename(filename) != filename + ): + raise RemotePackageError(f"Unsafe package-cache filename: {filename}") + return filename + + def _store_cached_file(target_dir, package_id, source_path, filename, revision=None): """Persist one validated remote artifact as a local offline fallback.""" + filename = _safe_cache_filename(filename) + if not os.path.isfile(source_path): + raise RemotePackageError(f"Package-cache source is missing: {source_path}") + cache_dir = _package_cache_dir(target_dir, package_id) os.makedirs(cache_dir, exist_ok=True) cached_path = os.path.join(cache_dir, filename) _atomic_replace_file(source_path, cached_path) + size = os.path.getsize(cached_path) + if size <= 0: + raise RemotePackageError("Refusing to cache an empty package artifact.") + metadata = { "filename": filename, - "size": os.path.getsize(cached_path), + "size": size, "sha256": _file_sha256(cached_path), "revision": revision, } @@ -301,6 +323,26 @@ def _store_cached_file(target_dir, package_id, source_path, filename, revision=N return cached_path +def _store_cached_file_safely( + target_dir, + package_id, + source_path, + filename, + revision=None, +): + """Best-effort cache refresh that can never make a valid install fail.""" + try: + return _store_cached_file( + target_dir, + package_id, + source_path, + filename, + revision=revision, + ) + except (OSError, RemotePackageError, ValueError, TypeError): + return None + + def _load_cached_file(target_dir, package_id, filename=None, expected_revision=None): """Return a cached artifact only when its recorded integrity still matches.""" cache_dir = _package_cache_dir(target_dir, package_id) @@ -308,15 +350,26 @@ def _load_cached_file(target_dir, package_id, filename=None, expected_revision=N try: with open(metadata_path, "r", encoding="utf-8") as handle: metadata = json.load(handle) - except (OSError, json.JSONDecodeError): + except (OSError, json.JSONDecodeError, ValueError, TypeError): + return None + + if not isinstance(metadata, dict): return None recorded_name = metadata.get("filename") - if not isinstance(recorded_name, str) or not recorded_name: - return None - if filename is not None and recorded_name != filename: + try: + recorded_name = _safe_cache_filename(recorded_name) + except RemotePackageError: return None + if filename is not None: + try: + filename = _safe_cache_filename(filename) + except RemotePackageError: + return None + if recorded_name != filename: + return None + revision = metadata.get("revision") if expected_revision is not None and str(revision) != str(expected_revision): return None @@ -329,7 +382,11 @@ def _load_cached_file(target_dir, package_id, filename=None, expected_revision=N expected_sha = metadata.get("sha256") if not isinstance(expected_size, int) or expected_size <= 0: return None - if not isinstance(expected_sha, str) or len(expected_sha) != 64: + if ( + not isinstance(expected_sha, str) + or len(expected_sha) != 64 + or any(ch not in "0123456789abcdefABCDEF" for ch in expected_sha) + ): return None try: @@ -343,6 +400,76 @@ def _load_cached_file(target_dir, package_id, filename=None, expected_revision=N return cached_path, metadata +def _seed_cached_file_from_installed( + target_dir, + package_id, + source_path, + filename, + revision=None, + validator=None, +): + """Best-effort cache seeding from an already validated installed file.""" + cached = _load_cached_file( + target_dir, + package_id, + filename, + expected_revision=revision, + ) + if cached is not None: + return True + + try: + if callable(validator): + validator(source_path) + except Exception: + return False + + return ( + _store_cached_file_safely( + target_dir, + package_id, + source_path, + filename, + revision=revision, + ) + is not None + ) + + +def _current_recorded_package_revision(target_dir, package_id): + data = _load_package_state(target_dir, package_id) + revision = data.get("revision") if isinstance(data, dict) else None + if revision in (None, ""): + return None + if _package_state_is_current(target_dir, package_id, revision): + return str(revision) + return None + + +def _cache_current_managed_mpq(target_dir, mod_id, revision): + """Seed cache from a managed MPQ and report whether the install is current.""" + if not managed_mpq_is_current(target_dir, mod_id, revision): + return False + + files = _load_managed_manifest(target_dir, mod_id) + if len(files) != 1: + return False + source_path = os.path.join(target_dir, files[0]) + try: + _verify_mpq(source_path) + except RemotePackageError: + return False + + _seed_cached_file_from_installed( + target_dir, + mod_id, + source_path, + "payload.mpq", + revision=revision, + validator=_verify_mpq, + ) + return True + def _remove_tree(path): if not os.path.exists(path): return @@ -778,6 +905,53 @@ def write_wowpresence_broadcast_flags(target_dir, value): +def cache_installed_wowpresence(target_dir, revision=None): + """Best-effort cache seed from an already valid WowPresence installation.""" + dll_path = os.path.join(target_dir, "WowPresence.dll") + exe_path = os.path.join(target_dir, "WowPresence.exe") + try: + _verify_x86_pe(dll_path, "installed WowPresence.dll") + _verify_x86_pe(exe_path, "installed WowPresence.exe") + except RemotePackageError: + return False + + if revision is None: + manifest = _load_managed_manifest_data(target_dir, WOWPRESENCE_MANAGED_ID) + revision = manifest.get("revision") if isinstance(manifest, dict) else None + + if _load_cached_file( + target_dir, + WOWPRESENCE_MANAGED_ID, + "WowPresence.zip", + expected_revision=revision, + ) is not None: + return True + + fd, zip_path = tempfile.mkstemp(prefix="modernization_wowpresence_seed_", suffix=".zip") + os.close(fd) + try: + with zipfile.ZipFile(zip_path, "w", compression=zipfile.ZIP_DEFLATED) as archive: + archive.write(dll_path, "WowPresence.dll") + archive.write(exe_path, "WowPresence.exe") + return ( + _store_cached_file_safely( + target_dir, + WOWPRESENCE_MANAGED_ID, + zip_path, + "WowPresence.zip", + revision=revision, + ) + is not None + ) + except (OSError, zipfile.BadZipFile): + return False + finally: + try: + os.remove(zip_path) + except OSError: + pass + + def install_wowpresence(target_dir, progress=None): """Install or update WowPresence from its latest stable GitHub release ZIP.""" _emit_progress(progress, "Checking WowPresence release...", None, None) @@ -859,6 +1033,7 @@ def install_wowpresence(target_dir, progress=None): package_revision=package_revision, package_digest=current_digest, ) + cache_installed_wowpresence(target_dir, revision=revision) _emit_progress( progress, f"WowPresence {revision} is already current.", @@ -889,13 +1064,6 @@ def install_wowpresence(target_dir, progress=None): exe_path = _find_file(extract_root, "WowPresence.exe") _verify_x86_pe(dll_path, "WowPresence.dll") _verify_x86_pe(exe_path, "WowPresence.exe") - _store_cached_file( - target_dir, - WOWPRESENCE_MANAGED_ID, - zip_path, - "WowPresence.zip", - revision=revision, - ) _emit_progress(progress, f"Installing WowPresence {revision}...", None, None) _install_managed_files_transactional( @@ -918,6 +1086,19 @@ def install_wowpresence(target_dir, progress=None): package_digest=package_asset.get("digest"), package_revision=package_revision, ) + if _store_cached_file_safely( + target_dir, + WOWPRESENCE_MANAGED_ID, + zip_path, + "WowPresence.zip", + revision=revision, + ) is None: + _emit_progress( + progress, + "WowPresence installed; offline cache could not be refreshed.", + None, + None, + ) finally: if zip_path and os.path.exists(zip_path): try: @@ -1228,6 +1409,20 @@ def _file_sha256(path): return digest.hexdigest().lower() +def _git_blob_sha1(path): + """Compute the canonical Git blob SHA-1 for exact bundled-tree verification.""" + size = os.path.getsize(path) + digest = hashlib.sha1() + digest.update(f"blob {size}\0".encode("ascii")) + with open(path, "rb") as handle: + while True: + chunk = handle.read(1024 * 1024) + if not chunk: + break + digest.update(chunk) + return digest.hexdigest().lower() + + PACKAGE_STATE_DIR = "package_state" @@ -1813,6 +2008,19 @@ def _install_remote_mpq( timeout=300, revision=None, ): + if revision is not None and _cache_current_managed_mpq( + target_dir, + mod_id, + revision, + ): + _emit_progress( + progress, + f"{label.replace('Downloading ', '')} is already current.", + None, + None, + ) + return + downloaded_path = None source_path = None try: @@ -1824,13 +2032,6 @@ def _install_remote_mpq( timeout=timeout, ) _verify_mpq(downloaded_path) - _store_cached_file( - target_dir, - mod_id, - downloaded_path, - "payload.mpq", - revision=revision, - ) source_path = downloaded_path except Exception as download_error: cached = _load_cached_file( @@ -1858,6 +2059,20 @@ def _install_remote_mpq( [(source_path, destination)], revision=revision, ) + + if downloaded_path is not None and _store_cached_file_safely( + target_dir, + mod_id, + downloaded_path, + "payload.mpq", + revision=revision, + ) is None: + _emit_progress( + progress, + f"{label.replace('Downloading ', '')} installed; offline cache could not be refreshed.", + None, + None, + ) finally: if downloaded_path and os.path.exists(downloaded_path): try: @@ -1865,7 +2080,6 @@ def _install_remote_mpq( except OSError: pass - def _google_drive_download_url(file_id): return ( "https://drive.usercontent.google.com/download" @@ -1931,12 +2145,36 @@ def install_fog_pushback(target_dir, progress=None): def install_pink_herbs(target_dir, progress=None): mod_id = "visual_pink_herbs" destination = os.path.join("Data", "patch-V.mpq") + target_path = os.path.join(target_dir, destination) downloaded_path = None source_path = None + installed_revision = _current_recorded_package_revision(target_dir, mod_id) try: revision = _branch_head_sha("seacrabsam/patch-herb", "main") except Exception as revision_error: + if installed_revision is not None: + try: + _verify_mpq(target_path) + except RemotePackageError: + installed_revision = None + else: + _seed_cached_file_from_installed( + target_dir, + mod_id, + target_path, + "payload.mpq", + revision=installed_revision, + validator=_verify_mpq, + ) + _emit_progress( + progress, + f"Pink Herbs {installed_revision[:7]} kept; update source unavailable.", + None, + None, + ) + return f"seacrabsam/patch-herb main@{installed_revision[:7]}" + cached = _load_cached_file(target_dir, mod_id, "payload.mpq") if cached is None: raise revision_error @@ -1950,14 +2188,27 @@ def install_pink_herbs(target_dir, progress=None): None, ) else: - if _package_state_is_current(target_dir, mod_id, revision): - _emit_progress( - progress, - f"Pink Herbs {revision[:7]} is already current.", - None, - None, - ) - return f"seacrabsam/patch-herb main@{revision[:7]}" + if installed_revision == revision: + try: + _verify_mpq(target_path) + except RemotePackageError: + installed_revision = None + else: + _seed_cached_file_from_installed( + target_dir, + mod_id, + target_path, + "payload.mpq", + revision=revision, + validator=_verify_mpq, + ) + _emit_progress( + progress, + f"Pink Herbs {revision[:7]} is already current.", + None, + None, + ) + return f"seacrabsam/patch-herb main@{revision[:7]}" try: downloaded_path = _download( @@ -1968,15 +2219,32 @@ def install_pink_herbs(target_dir, progress=None): timeout=300, ) _verify_mpq(downloaded_path) - _store_cached_file( - target_dir, - mod_id, - downloaded_path, - "payload.mpq", - revision=revision, - ) source_path = downloaded_path except Exception as download_error: + # Never replace a valid installed revision with an older cache just + # because the newest remote payload is temporarily unavailable. + if installed_revision is not None: + try: + _verify_mpq(target_path) + except RemotePackageError: + installed_revision = None + else: + _seed_cached_file_from_installed( + target_dir, + mod_id, + target_path, + "payload.mpq", + revision=installed_revision, + validator=_verify_mpq, + ) + _emit_progress( + progress, + f"Pink Herbs {installed_revision[:7]} kept; latest download unavailable.", + None, + None, + ) + return f"seacrabsam/patch-herb main@{installed_revision[:7]}" + cached = _load_cached_file(target_dir, mod_id, "payload.mpq") if cached is None: raise download_error @@ -2010,6 +2278,20 @@ def install_pink_herbs(target_dir, progress=None): revision, [destination], ) + + if downloaded_path is not None and _store_cached_file_safely( + target_dir, + mod_id, + downloaded_path, + "payload.mpq", + revision=revision, + ) is None: + _emit_progress( + progress, + "Pink Herbs installed; offline cache could not be refreshed.", + None, + None, + ) finally: if downloaded_path and os.path.exists(downloaded_path): try: @@ -2020,7 +2302,6 @@ def install_pink_herbs(target_dir, progress=None): suffix = revision[:7] if len(revision) >= 7 else revision return f"seacrabsam/patch-herb main@{suffix}" - def _download_github_branch_archive( repo, branch, -- 2.52.0 From e1c9ee4fb0c0f64024a3b5f71bc0e3a2baf26280 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:10:56 +0200 Subject: [PATCH 012/101] Record exact SuperAPI fallback tree --- Payload/Fallback/versions.json | 87 ++++++++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) diff --git a/Payload/Fallback/versions.json b/Payload/Fallback/versions.json index d167fec..690929a 100644 --- a/Payload/Fallback/versions.json +++ b/Payload/Fallback/versions.json @@ -604,6 +604,93 @@ "sha256": "bd214b32c878649e94ce654835946bd05e0ce7710e8f01bae10d8ab50a89351d", "size": 1000448 } + ], + "superapi_files": [ + { + "path": "Payload/Interface/Addons/SuperAPI/README.md", + "size": 1020, + "git_blob_sha1": "9f38a6a316516de3614e7526b28823cc823a4406" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/SuperAPI.lua", + "size": 6904, + "git_blob_sha1": "0161abda07898691885a2612e881332d783e6345" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/SuperAPI.toc", + "size": 741, + "git_blob_sha1": "3204821da231172087cff33848924991ced8e9bc" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/SuperAPIOptions.lua", + "size": 10908, + "git_blob_sha1": "3fabab494f706814b5fa02c0e0d1b9221d52d0" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/AceAddon-2.0/AceAddon-2.0.lua", + "size": 34783, + "git_blob_sha1": "1c5e2d59c71e09ca05e5ebe4e7f03ddd3e417f65" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/AceConsole-2.0/AceConsole-2.0.lua", + "size": 67656, + "git_blob_sha1": "d4d2f2a43aca30bdf6eb7b8266a0802e6e1fe717" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/AceDB-2.0/AceDB-2.0.lua", + "size": 45257, + "git_blob_sha1": "a6bbd10a83bce8682f563c4d0315b246ec554b9b" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/AceDebug-2.0/AceDebug-2.0.lua", + "size": 8049, + "git_blob_sha1": "8683c8c76cf91f527fb5f815e762470da96d87ca" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/AceEvent-2.0/AceEvent-2.0.lua", + "size": 28954, + "git_blob_sha1": "c6545688770d0a5669ce3948bf649fd4fdb47694" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/AceHook-2.1/AceHook-2.1.lua", + "size": 16946, + "git_blob_sha1": "8beaf6607d905b494d9d1e01785156aca86c9f43" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/AceLibrary/AceLibrary.lua", + "size": 23114, + "git_blob_sha1": "0f2b2378859a0245d33daecf112cd409594ecb3e" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/AceLocale-2.2/AceLocale-2.2.lua", + "size": 15957, + "git_blob_sha1": "fbf9c87306fd7d40d53bd8290a320e73a25e1f12" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/AceModuleCore-2.0/AceModuleCore-2.0.lua", + "size": 13981, + "git_blob_sha1": "32c89fb8535f7badc20781178073fd1626f390ec" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/AceOO-2.0/AceOO-2.0.lua", + "size": 30469, + "git_blob_sha1": "cd372b49650b1943b0ac72f0793c9b22fc1213ff" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/Dewdrop/Dewdrop-2.0.lua", + "size": 82495, + "git_blob_sha1": "bc72ba607679866c860bcdbcd3000b7faf8df3a0" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/FuBarPlugin/FuBarPlugin-2.0.lua", + "size": 44995, + "git_blob_sha1": "292c8fcdfa4aa642a159c4a17abbc8d882c2a6af" + }, + { + "path": "Payload/Interface/Addons/SuperAPI/libs/Tablet/Tablet-2.0.lua", + "size": 83748, + "git_blob_sha1": "70f340d9172c30eb7a153d675ed69f1e1f07dbe4" + } ] } } -- 2.52.0 From 1e568db8ecf9e907b63677b99db3e36e193255d4 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:11:28 +0200 Subject: [PATCH 013/101] Verify SuperAPI fallback integrity --- setup_tool_dynamic.py | 139 +++++++++++++++++++++++++++++++++++++++--- 1 file changed, 132 insertions(+), 7 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index d3ec531..3d7c4eb 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -43,15 +43,13 @@ class ModernWowSetupTool(WowSetupTool): self._download_indeterminate = False super().__init__(root) - def _bundled_manifest_record(self, relative_path): - """Return the expected size/hash record for one bundled payload file.""" + def _bundled_manifest_components(self): metadata_path = os.path.join( get_base_path(), "Payload", "Fallback", "versions.json", ) - wanted = relative_path.replace("\\", "/").casefold() try: with open(metadata_path, "r", encoding="utf-8") as handle: data = json.load(handle) @@ -63,8 +61,12 @@ class ModernWowSetupTool(WowSetupTool): components = data.get("components") if isinstance(data, dict) else None if not isinstance(components, dict): raise RuntimeError("Bundled component integrity metadata is invalid.") + return components - for component in components.values(): + def _bundled_manifest_record(self, relative_path): + """Return the expected size/hash record for one bundled payload file.""" + wanted = relative_path.replace("\\", "/").casefold() + for component in self._bundled_manifest_components().values(): files = component.get("files") if isinstance(component, dict) else None if not isinstance(files, list): continue @@ -79,6 +81,14 @@ class ModernWowSetupTool(WowSetupTool): f"No integrity record exists for bundled file {relative_path}." ) + def _bundled_manifest_component(self, component_name): + component = self._bundled_manifest_components().get(component_name) + if not isinstance(component, dict): + raise RuntimeError( + f"No bundled integrity metadata exists for {component_name}." + ) + return component + def _verified_bundled_file(self, relative_path, label): """Validate a bundled file before it is allowed to touch the WoW folder.""" record = self._bundled_manifest_record(relative_path) @@ -116,6 +126,74 @@ class ModernWowSetupTool(WowSetupTool): return source, expected_sha + def _verified_bundled_tree( + self, + component_name, + records_key, + root_relative_path, + label, + ): + """Verify an exact bundled file tree using recorded canonical Git blob IDs.""" + component = self._bundled_manifest_component(component_name) + records = component.get(records_key) + if not isinstance(records, list) or not records: + raise RuntimeError(f"Missing bundled tree metadata for {label}.") + + root = os.path.join( + get_base_path(), + *root_relative_path.replace("\\", "/").split("/"), + ) + if not os.path.isdir(root): + raise RuntimeError(f"Bundled {label} folder is missing.") + + expected = {} + prefix = root_relative_path.replace("\\", "/").rstrip("/") + "/" + for record in records: + if not isinstance(record, dict): + raise RuntimeError(f"Invalid bundled tree metadata for {label}.") + path = record.get("path") + size = record.get("size") + blob_sha = record.get("git_blob_sha1") + if ( + not isinstance(path, str) + or not path.replace("\\", "/").startswith(prefix) + or not isinstance(size, int) + or size < 0 + or not isinstance(blob_sha, str) + or len(blob_sha) != 40 + or any(ch not in "0123456789abcdefABCDEF" for ch in blob_sha) + ): + raise RuntimeError(f"Invalid bundled tree metadata for {label}.") + expected[path.replace("\\", "/").casefold()] = (size, blob_sha.lower()) + + actual = {} + for current_root, dirs, files in os.walk(root): + dirs.sort(key=str.casefold) + files.sort(key=str.casefold) + for filename in files: + full_path = os.path.join(current_root, filename) + rel_from_root = os.path.relpath(full_path, root).replace(os.sep, "/") + manifest_path = prefix + rel_from_root + actual[manifest_path.casefold()] = full_path + + if set(actual) != set(expected): + raise RuntimeError( + f"Bundled {label} file set does not match its integrity metadata." + ) + + for key, full_path in actual.items(): + expected_size, expected_blob_sha = expected[key] + if os.path.getsize(full_path) != expected_size: + raise RuntimeError( + f"Bundled {label} contains a file with an unexpected size." + ) + if remote_packages._git_blob_sha1(full_path) != expected_blob_sha: + raise RuntimeError( + f"Bundled {label} failed its exact file integrity check." + ) + + return root + def _install_verified_bundled_file(self, relative_path, target_path, label): source, expected_sha = self._verified_bundled_file(relative_path, label) if os.path.isfile(target_path): @@ -705,6 +783,39 @@ class ModernWowSetupTool(WowSetupTool): except Exception: return False + def _valid_superapi_addon(self, addon_path): + """Reject empty/partial SuperAPI folders before treating them as usable.""" + required = ( + "SuperAPI.toc", + "SuperAPI.lua", + "SuperAPIOptions.lua", + ) + if not os.path.isdir(addon_path): + return False + if any(not os.path.isfile(os.path.join(addon_path, name)) for name in required): + return False + + toc_path = os.path.join(addon_path, "SuperAPI.toc") + try: + with open(toc_path, "r", encoding="utf-8", errors="ignore") as handle: + lines = handle.readlines() + except OSError: + return False + + for raw in lines: + line = raw.strip() + if not line or line.startswith("#"): + continue + normalized = line.replace("\\", os.sep).replace("/", os.sep) + if normalized.startswith(".." + os.sep) or os.path.isabs(normalized): + return False + extension = os.path.splitext(normalized)[1].lower() + if extension in (".lua", ".xml") and not os.path.isfile( + os.path.join(addon_path, normalized) + ): + return False + return True + def _fallback_core_dll(self, payload_base, target, dll_name, error): source_dll = os.path.join(payload_base, dll_name) target_dll = os.path.join(target, dll_name) @@ -717,12 +828,18 @@ class ModernWowSetupTool(WowSetupTool): # Never downgrade a complete existing install because an upstream link # happens to be unavailable during an update. + addon_complete = ( + target_addon is None + or ( + self._valid_superapi_addon(target_addon) + if addon_folder == "SuperAPI" + else os.path.isdir(target_addon) + ) + ) existing_complete = self._valid_x86_dll( target_dll, f"installed {dll_name}", - ) and ( - target_addon is None or os.path.isdir(target_addon) - ) + ) and addon_complete if existing_complete: self._warn_offline( dll_name, @@ -749,6 +866,13 @@ class ModernWowSetupTool(WowSetupTool): f"Could not download the latest {dll_name}, and its bundled fallback addon " f"{addon_folder} is missing.\n\n{error}" ) from error + if addon_folder == "SuperAPI": + source_addon = self._verified_bundled_tree( + "SuperWoW fallback", + "superapi_files", + "Payload/Interface/Addons/SuperAPI", + "SuperAPI fallback", + ) if addon_folder and source_addon: remote_packages._transactional_replace_bundle( @@ -1312,6 +1436,7 @@ class ModernWowSetupTool(WowSetupTool): and self._valid_x86_dll(existing_exe, "WowPresence.exe") ): remote_packages.ensure_wowpresence_config(target) + remote_packages.cache_installed_wowpresence(target) self._warn_offline( "WowPresence", "Keeping the currently installed WowPresence binaries.", -- 2.52.0 From 5f7792b9d956a130e8edfe3b2192960efe030fec Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:11:45 +0200 Subject: [PATCH 014/101] Let visual installers seed offline caches --- setup_tool.py | 20 +++----------------- 1 file changed, 3 insertions(+), 17 deletions(-) diff --git a/setup_tool.py b/setup_tool.py index 7d58e64..9bf4cbf 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -1720,25 +1720,11 @@ class WowSetupTool: ] try: - # Large visual MPQs deliberately stay online-only, but they are not - # downloaded again on every Apply. A revision bump in remote_packages - # is enough to trigger one fresh download when a source/version changes. + # Visual installers own their current-version and cache checks. + # Already valid MPQs are reused without a download and can seed the + # local offline cache on upgrades from older Tool releases. for key, managed_id, display_name, installer in visual_defs: if self.visual_mods[key].get(): - # Hosted static mirrors use explicit revisions and can be - # skipped without any network request. Pink Herbs follows a - # GitHub branch, so its installer performs a lightweight - # branch-SHA check before deciding whether a download is - # needed. - if key != "pink_herbs": - revision = remote_packages.VISUAL_MOD_REVISIONS[managed_id] - if remote_packages.managed_mpq_is_current( - target, - managed_id, - revision, - ): - continue - try: installer(target, progress=progress) except Exception as exc: -- 2.52.0 From a5c6feee95a7f64af76b2e70936442f664c77831 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:12:04 +0200 Subject: [PATCH 015/101] Clarify offline fallback behavior --- README.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index f27c809..2aa261b 100644 --- a/README.md +++ b/README.md @@ -163,9 +163,11 @@ from its official stable release and SuperAPI follows the current upstream `master` revision. If either online source is unavailable, the tool can install the bundled known-good SuperWoW + SuperAPI fallback instead. -**WowPresence and remote visual mods keep a validated local cache** after a -successful download. That cache can be reused automatically for repair or -reinstallation when the online source is temporarily unavailable. +**WowPresence and remote visual mods keep a validated local cache.** A successful +download refreshes the cache, while already valid installed files can seed it +when possible. Cache write failures never block a successful normal install. +A completely fresh offline installation of these cache-only components still +requires a cache created by an earlier valid installation. **No1600x1200 uses the bundled known-good copy** instead of following the RetroCro archive repository automatically. @@ -257,8 +259,9 @@ For detailed redistribution and provenance information, see: - [Docs/ASSET_PROVENANCE.md](Docs/ASSET_PROVENANCE.md) - [LICENSES/](LICENSES/) -SuperWoW and the current SuperAPI master revision are downloaded directly from -their upstream projects and are not bundled as offline fallbacks. +SuperWoW and SuperAPI prefer their upstream projects, with a bundled known-good +pair available as an offline fallback. Other remote components use the fallback +behavior described in **Automatic Updates & Offline Fallbacks** above. --- -- 2.52.0 From de0515c84c9694b6e5f418fc96126a7d91b3c0eb Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:12:10 +0200 Subject: [PATCH 016/101] Refresh fallback provenance audit notes --- Docs/BINARY_PROVENANCE.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Docs/BINARY_PROVENANCE.md b/Docs/BINARY_PROVENANCE.md index 2113f2f..0a6e6c6 100644 --- a/Docs/BINARY_PROVENANCE.md +++ b/Docs/BINARY_PROVENANCE.md @@ -1,12 +1,12 @@ # Modernization Tool binary provenance -Audit date: 2026-08-31 +Audit date: 2026-09-03 This document is the human-readable companion to `Payload/Fallback/versions.json`, which contains machine-readable source, version, SHA-256, and size records for many bundled components. -No remaining payload binary was modified during this provenance pass. +This provenance pass restores the previously recorded SuperWoW fallback and verifies the paired SuperAPI source revision. ## Distribution status -- 2.52.0 From 51e772d9597e5b1ba42c7bfd33b786cd5747e625 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:12:18 +0200 Subject: [PATCH 017/101] Refresh third-party audit date --- THIRD_PARTY_NOTICES.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md index 64331d7..4d7742b 100644 --- a/THIRD_PARTY_NOTICES.md +++ b/THIRD_PARTY_NOTICES.md @@ -1,6 +1,6 @@ # Modernization Tool third-party notices -Audit date: 2026-08-31 +Audit date: 2026-09-03 Modernization Tool combines an original installer/configuration layer with third-party client fixes, patchers, addons, DLLs, visual/audio modifications, -- 2.52.0 From 422b076f1910d228fb3894893bec548d45611914 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:12:54 +0200 Subject: [PATCH 018/101] Expand offline fallback regression coverage --- tests/test_safety.py | 249 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 249 insertions(+) diff --git a/tests/test_safety.py b/tests/test_safety.py index d4afbe9..f683773 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -1561,6 +1561,255 @@ class BundledComponentSafetyTests(unittest.TestCase): ["WowPresence.dll", "WowPresence.exe"], ) + def test_cache_metadata_wrong_type_is_ignored(self): + with tempfile.TemporaryDirectory() as root: + cache_dir = remote_packages._package_cache_dir(root, "example") + os.makedirs(cache_dir) + with open(os.path.join(cache_dir, "metadata.json"), "w", encoding="utf-8") as handle: + json.dump([], handle) + + self.assertIsNone( + remote_packages._load_cached_file( + root, + "example", + "payload.bin", + ) + ) + + def test_cache_metadata_cannot_escape_cache_directory(self): + with tempfile.TemporaryDirectory() as root: + cache_dir = remote_packages._package_cache_dir(root, "example") + os.makedirs(cache_dir) + outside = os.path.join(root, "outside.bin") + with open(outside, "wb") as handle: + handle.write(b"outside") + with open(os.path.join(cache_dir, "metadata.json"), "w", encoding="utf-8") as handle: + json.dump( + { + "filename": "../outside.bin", + "size": os.path.getsize(outside), + "sha256": hashlib.sha256(b"outside").hexdigest(), + "revision": "rev1", + }, + handle, + ) + + self.assertIsNone( + remote_packages._load_cached_file( + root, + "example", + ) + ) + + def test_current_managed_mpq_seeds_cache_without_network(self): + with tempfile.TemporaryDirectory() as root: + relative = os.path.join("Data", "patch-X.mpq") + target = os.path.join(root, relative) + os.makedirs(os.path.dirname(target)) + with open(target, "wb") as handle: + handle.write(b"MPQalready-current") + + remote_packages._write_managed_manifest( + root, + "visual_example", + [relative], + revision="1", + ) + + with mock.patch.object(remote_packages, "_download") as download: + remote_packages._install_remote_mpq( + root, + "visual_example", + "https://example.invalid/visual.mpq", + relative, + revision="1", + ) + + download.assert_not_called() + cached = remote_packages._load_cached_file( + root, + "visual_example", + "payload.mpq", + expected_revision="1", + ) + self.assertIsNotNone(cached) + + def test_cache_write_failure_does_not_break_online_mpq_install(self): + with tempfile.TemporaryDirectory() as root: + downloaded = os.path.join(root, "downloaded.mpq") + with open(downloaded, "wb") as handle: + handle.write(b"MPQdownloaded") + + with ( + mock.patch.object( + remote_packages, + "_download", + return_value=downloaded, + ), + mock.patch.object( + remote_packages, + "_install_managed_files", + ) as install, + mock.patch.object( + remote_packages, + "_store_cached_file_safely", + return_value=None, + ), + ): + remote_packages._install_remote_mpq( + root, + "visual_example", + "https://example.invalid/visual.mpq", + os.path.join("Data", "patch-X.mpq"), + revision="2", + ) + + install.assert_called_once() + + def test_pink_herbs_keeps_valid_installed_revision_when_update_download_fails(self): + with tempfile.TemporaryDirectory() as root: + relative = os.path.join("Data", "patch-V.mpq") + target = os.path.join(root, relative) + os.makedirs(os.path.dirname(target)) + with open(target, "wb") as handle: + handle.write(b"MPQinstalled-old") + + remote_packages._record_package_state( + root, + "visual_pink_herbs", + "oldrev123", + [relative], + ) + + with ( + mock.patch.object( + remote_packages, + "_branch_head_sha", + return_value="newrev456", + ), + mock.patch.object( + remote_packages, + "_download", + side_effect=remote_packages.RemotePackageError("offline"), + ), + mock.patch.object( + remote_packages, + "_install_managed_files", + ) as install, + ): + result = remote_packages.install_pink_herbs(root) + + install.assert_not_called() + self.assertIn("oldrev1", result) + with open(target, "rb") as handle: + self.assertEqual(handle.read(), b"MPQinstalled-old") + + def test_installed_wowpresence_can_seed_offline_cache(self): + with tempfile.TemporaryDirectory() as root: + for filename in ("WowPresence.dll", "WowPresence.exe"): + with open(os.path.join(root, filename), "wb") as handle: + handle.write(filename.encode("ascii")) + + with mock.patch.object(remote_packages, "_verify_x86_pe"): + self.assertTrue( + remote_packages.cache_installed_wowpresence( + root, + revision="v1.3", + ) + ) + + cached = remote_packages._load_cached_file( + root, + remote_packages.WOWPRESENCE_MANAGED_ID, + "WowPresence.zip", + expected_revision="v1.3", + ) + self.assertIsNotNone(cached) + + def test_superapi_bundled_tree_rejects_tampering(self): + tool = ModernWowSetupTool.__new__(ModernWowSetupTool) + + with tempfile.TemporaryDirectory() as root: + fallback = os.path.join(root, "Payload", "Fallback") + addon = os.path.join(root, "Payload", "Interface", "Addons", "SuperAPI") + os.makedirs(fallback) + os.makedirs(addon) + + first = os.path.join(addon, "SuperAPI.toc") + second = os.path.join(addon, "SuperAPI.lua") + with open(first, "wb") as handle: + handle.write(b"## Interface: 11200\nSuperAPI.lua\n") + with open(second, "wb") as handle: + handle.write(b"print('ok')\n") + + records = [] + for path in (first, second): + relative = os.path.relpath(path, root).replace(os.sep, "/") + records.append( + { + "path": relative, + "size": os.path.getsize(path), + "git_blob_sha1": remote_packages._git_blob_sha1(path), + } + ) + + with open( + os.path.join(fallback, "versions.json"), + "w", + encoding="utf-8", + ) as handle: + json.dump( + { + "components": { + "test tree": { + "superapi_files": records, + } + } + }, + handle, + ) + + with mock.patch("setup_tool_dynamic.get_base_path", return_value=root): + verified = tool._verified_bundled_tree( + "test tree", + "superapi_files", + "Payload/Interface/Addons/SuperAPI", + "test SuperAPI", + ) + self.assertEqual(verified, addon) + + with open(second, "ab") as handle: + handle.write(b"tampered") + + with self.assertRaises(RuntimeError): + tool._verified_bundled_tree( + "test tree", + "superapi_files", + "Payload/Interface/Addons/SuperAPI", + "test SuperAPI", + ) + + def test_superapi_existing_folder_must_be_complete(self): + tool = ModernWowSetupTool.__new__(ModernWowSetupTool) + + with tempfile.TemporaryDirectory() as addon: + self.assertFalse(tool._valid_superapi_addon(addon)) + + with open(os.path.join(addon, "SuperAPI.lua"), "w", encoding="utf-8") as handle: + handle.write("-- test\n") + with open(os.path.join(addon, "SuperAPIOptions.lua"), "w", encoding="utf-8") as handle: + handle.write("-- test\n") + with open(os.path.join(addon, "SuperAPI.toc"), "w", encoding="utf-8") as handle: + handle.write("SuperAPI.lua\nlibs\\Needed.lua\n") + + self.assertFalse(tool._valid_superapi_addon(addon)) + + os.makedirs(os.path.join(addon, "libs")) + with open(os.path.join(addon, "libs", "Needed.lua"), "w", encoding="utf-8") as handle: + handle.write("-- lib\n") + + self.assertTrue(tool._valid_superapi_addon(addon)) + def test_branch_archive_download_can_be_pinned_to_resolved_revision(self): with ( mock.patch.object(remote_packages, "_download", return_value="archive.zip") as download, -- 2.52.0 From 943caba91cc8d752135ff1937481696cda11e4c4 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:13:37 +0200 Subject: [PATCH 019/101] Harden package cache paths --- remote_packages.py | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/remote_packages.py b/remote_packages.py index dd01a40..1e0b6ff 100644 --- a/remote_packages.py +++ b/remote_packages.py @@ -262,11 +262,17 @@ def _atomic_replace_file(source, target): def _package_cache_dir(target_dir, package_id): + safe_id = "".join( + ch if ch.isalnum() or ch in ("-", "_", ".") else "_" + for ch in str(package_id) + ) + if safe_id in ("", ".", ".."): + raise RemotePackageError("Invalid package-cache ID.") return os.path.join( target_dir, ".modernization_tool", "package_cache", - str(package_id), + safe_id, ) -- 2.52.0 From 764d177638ee182588af6dc77c39d80c539aadf4 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:13:40 +0200 Subject: [PATCH 020/101] Update SuperWoW fallback test coverage --- tests/test_safety.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/tests/test_safety.py b/tests/test_safety.py index f683773..77bb312 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -1483,6 +1483,7 @@ class BundledComponentSafetyTests(unittest.TestCase): } tool._valid_x86_dll = mock.Mock(return_value=False) tool._verified_bundled_file = mock.Mock() + tool._verified_bundled_tree = mock.Mock() tool._warn_offline = mock.Mock() with tempfile.TemporaryDirectory() as root: @@ -1503,6 +1504,7 @@ class BundledComponentSafetyTests(unittest.TestCase): target = os.path.join(root, "game") os.makedirs(target) tool._verified_bundled_file.return_value = (dll, "a" * 64) + tool._verified_bundled_tree.return_value = addon with mock.patch.object( remote_packages, -- 2.52.0 From 352330b0489d3353b52993679c2f257923e569d3 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:14:43 +0200 Subject: [PATCH 021/101] Reject duplicate bundled tree metadata --- setup_tool_dynamic.py | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 3d7c4eb..2a0c3cf 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -164,7 +164,10 @@ class ModernWowSetupTool(WowSetupTool): or any(ch not in "0123456789abcdefABCDEF" for ch in blob_sha) ): raise RuntimeError(f"Invalid bundled tree metadata for {label}.") - expected[path.replace("\\", "/").casefold()] = (size, blob_sha.lower()) + key = path.replace("\\", "/").casefold() + if key in expected: + raise RuntimeError(f"Duplicate bundled tree metadata for {label}.") + expected[key] = (size, blob_sha.lower()) actual = {} for current_root, dirs, files in os.walk(root): -- 2.52.0 From 90f9247eb11373dd2a5b31be7f09938898a0c79c Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:14:48 +0200 Subject: [PATCH 022/101] Verify real bundled SuperWoW fallback --- tests/test_safety.py | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/tests/test_safety.py b/tests/test_safety.py index 77bb312..c985065 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -1791,6 +1791,25 @@ class BundledComponentSafetyTests(unittest.TestCase): "test SuperAPI", ) + def test_real_superwow_superapi_fallback_matches_manifest(self): + tool = ModernWowSetupTool.__new__(ModernWowSetupTool) + + dll_path, _ = tool._verified_bundled_file( + "Payload/SuperWoWhook.dll", + "SuperWoW fallback", + ) + self.assertTrue(os.path.isfile(dll_path)) + + addon_path = tool._verified_bundled_tree( + "SuperWoW fallback", + "superapi_files", + "Payload/Interface/Addons/SuperAPI", + "SuperAPI fallback", + ) + self.assertTrue( + tool._valid_superapi_addon(addon_path) + ) + def test_superapi_existing_folder_must_be_complete(self): tool = ModernWowSetupTool.__new__(ModernWowSetupTool) -- 2.52.0 From 0416e21b54835f594ae6dfa66d05c92c80b26bce Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:15:29 +0200 Subject: [PATCH 023/101] Clarify visual fallback errors --- setup_tool.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup_tool.py b/setup_tool.py index 9bf4cbf..5474913 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -1734,7 +1734,7 @@ class WowSetupTool: ) else: raise RuntimeError( - f"{display_name} installation failed and no bundled MPQ backup is provided:\n{exc}" + f"{display_name} installation failed and no usable cached fallback is available:\n{exc}" ) from exc else: remote_packages.remove_managed_mod(target, managed_id) -- 2.52.0 From 39c3963d5f4a2015dfe63d484e1d008f55b0e275 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:15:32 +0200 Subject: [PATCH 024/101] Refresh SuperWoW fallback comments --- setup_tool_dynamic.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 2a0c3cf..d269acf 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -1269,7 +1269,7 @@ class ModernWowSetupTool(WowSetupTool): try: # Core plugins are refreshed from their upstream sources where supported. # Bundled fallbacks are used only for components whose redistribution - # model allows it. SuperWoW/SuperAPI are upstream-only. + # model allows it. SuperWoW/SuperAPI also have a bundled fallback. for dll_name, var in self.core_plugins.items(): if not var.get(): continue -- 2.52.0 From 890949b8db4fdd9844e5fb6a339f6d2844050a86 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:17:11 +0200 Subject: [PATCH 025/101] Prepare bundled remote fallbacks for release builds --- scripts/prepare_remote_fallbacks.py | 188 ++++++++++++++++++++++++++++ 1 file changed, 188 insertions(+) create mode 100644 scripts/prepare_remote_fallbacks.py diff --git a/scripts/prepare_remote_fallbacks.py b/scripts/prepare_remote_fallbacks.py new file mode 100644 index 0000000..f71a151 --- /dev/null +++ b/scripts/prepare_remote_fallbacks.py @@ -0,0 +1,188 @@ +import hashlib +import json +import os +import shutil +import struct +import time +import urllib.error +import urllib.request +import zipfile + + +ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), "..")) +OUTPUT_ROOT = os.path.join(ROOT, "Payload", "Fallback", "Remote") +MANIFEST_PATH = os.path.join(ROOT, "Payload", "Fallback", "remote_fallbacks.json") +USER_AGENT = "Modernization-Tool build fallback fetcher" + + +FALLBACKS = [ + { + "id": "wowpresence", + "filename": "WowPresence.zip", + "revision": "v1.3", + "url": "https://github.com/Dusk-92/WowPresence/releases/download/v1.3/WowPresence.zip", + "kind": "wowpresence_zip", + "sha256": "9b2dca9c69b5ab3b6dae3ef3b3efc9671779a227802ebb6ac98cb22bc6ea448a", + }, + { + "id": "visual_pink_herbs", + "filename": "payload.mpq", + "revision": "c252bbdc2aef1ac928eb237cf4d28edc21806ed8", + "url": "https://raw.githubusercontent.com/seacrabsam/patch-herb/c252bbdc2aef1ac928eb237cf4d28edc21806ed8/patch-H.mpq", + "kind": "mpq", + }, + { + "id": "visual_darker_nights", + "filename": "payload.mpq", + "revision": "1", + "url": "https://pub-0f05631d243e4046993fc02ca7be9542.r2.dev/patches/patch-N.mpq", + "kind": "mpq", + }, + { + "id": "visual_pretty_night_sky", + "filename": "payload.mpq", + "revision": "1", + "url": "https://drive.usercontent.google.com/download?id=1qu99ZS-SQFfTtYodBmZWYiHmxL8QtUY4&export=download&confirm=t", + "kind": "mpq", + }, + { + "id": "visual_epoch_water", + "filename": "payload.mpq", + "revision": "1", + "url": "https://drive.usercontent.google.com/download?id=1xRx9OrznbgbE1uBae3H3OGke9UoXtzmU&export=download&confirm=t", + "kind": "mpq", + }, + { + "id": "visual_fog_pushback", + "filename": "payload.mpq", + "revision": "1", + "url": "https://drive.usercontent.google.com/download?id=14aHvyfr_ACL-UURbNa_fXRPcfQZoIw8n&export=download&confirm=t", + "kind": "mpq", + }, +] + + +def _sha256(path): + digest = hashlib.sha256() + with open(path, "rb") as handle: + while True: + chunk = handle.read(1024 * 1024) + if not chunk: + break + digest.update(chunk) + return digest.hexdigest().lower() + + +def _download(url, destination, retries=3): + os.makedirs(os.path.dirname(destination), exist_ok=True) + request = urllib.request.Request(url, headers={"User-Agent": USER_AGENT}) + last_error = None + for attempt in range(1, retries + 1): + temp_path = destination + ".new" + try: + with urllib.request.urlopen(request, timeout=300) as response, open(temp_path, "wb") as out: + while True: + chunk = response.read(1024 * 1024) + if not chunk: + break + out.write(chunk) + os.replace(temp_path, destination) + return + except (OSError, urllib.error.URLError, urllib.error.HTTPError, TimeoutError) as exc: + last_error = exc + try: + os.remove(temp_path) + except OSError: + pass + if attempt < retries: + time.sleep(attempt * 2) + raise RuntimeError(f"Could not download {url}: {last_error}") + + +def _verify_mpq(path): + with open(path, "rb") as handle: + if handle.read(3) != b"MPQ": + raise RuntimeError(f"{path} is not an MPQ file") + + +def _verify_x86_pe_bytes(data, label): + if len(data) < 1024 or data[:2] != b"MZ": + raise RuntimeError(f"{label} is not a valid PE file") + pe_offset = struct.unpack_from(" len(data) - 26: + raise RuntimeError(f"{label} has an invalid PE offset") + if data[pe_offset:pe_offset + 4] != b"PE\0\0": + raise RuntimeError(f"{label} is missing the PE signature") + machine = struct.unpack_from(" len(data): + raise RuntimeError(f"{label} has an invalid optional header") + optional_magic = struct.unpack_from(" Date: Thu, 3 Sep 2026 21:17:15 +0200 Subject: [PATCH 026/101] Bundle remote fallbacks during builds --- .github/workflows/build.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 8c3e8ad..dc78543 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -47,6 +47,9 @@ jobs: with: arch: x86 + - name: Prepare bundled remote fallbacks + run: python scripts/prepare_remote_fallbacks.py + - name: Syntax check run: python -m py_compile setup_tool.py setup_tool_dynamic.py remote_packages.py tests/test_safety.py -- 2.52.0 From 627e9392b5ad0d7557ef1cfb7dea1e8fc7c8d30a Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:17:51 +0200 Subject: [PATCH 027/101] Use bundled fallbacks for fresh offline installs --- remote_packages.py | 271 ++++++++++++++++++++++++++++++++++++--------- 1 file changed, 221 insertions(+), 50 deletions(-) diff --git a/remote_packages.py b/remote_packages.py index 1e0b6ff..0e2603f 100644 --- a/remote_packages.py +++ b/remote_packages.py @@ -4,6 +4,7 @@ import os import shutil import stat import struct +import sys import tempfile import time import urllib.error @@ -475,6 +476,96 @@ def _cache_current_managed_mpq(target_dir, mod_id, revision): validator=_verify_mpq, ) return True +def _runtime_base_path(): + return getattr( + sys, + "_MEIPASS", + os.path.dirname(os.path.abspath(__file__)), + ) + + +def _load_bundled_remote_fallback( + package_id, + filename=None, + expected_revision=None, +): + """Return a release-bundled remote fallback after strict integrity checks.""" + safe_id = "".join( + ch if ch.isalnum() or ch in ("-", "_", ".") else "_" + for ch in str(package_id) + ) + if safe_id in ("", ".", ".."): + return None + + base = _runtime_base_path() + manifest_path = os.path.join( + base, + "Payload", + "Fallback", + "remote_fallbacks.json", + ) + try: + with open(manifest_path, "r", encoding="utf-8") as handle: + manifest = json.load(handle) + except (OSError, json.JSONDecodeError, ValueError, TypeError): + return None + + fallbacks = manifest.get("fallbacks") if isinstance(manifest, dict) else None + if not isinstance(fallbacks, dict): + return None + record = fallbacks.get(safe_id) + if not isinstance(record, dict): + return None + + recorded_name = record.get("filename") + try: + recorded_name = _safe_cache_filename(recorded_name) + except RemotePackageError: + return None + if filename is not None: + try: + filename = _safe_cache_filename(filename) + except RemotePackageError: + return None + if recorded_name != filename: + return None + + revision = record.get("revision") + if expected_revision is not None and str(revision) != str(expected_revision): + return None + + expected_size = record.get("size") + expected_sha = record.get("sha256") + if not isinstance(expected_size, int) or expected_size <= 0: + return None + if ( + not isinstance(expected_sha, str) + or len(expected_sha) != 64 + or any(ch not in "0123456789abcdefABCDEF" for ch in expected_sha) + ): + return None + + path = os.path.join( + base, + "Payload", + "Fallback", + "Remote", + safe_id, + recorded_name, + ) + if not os.path.isfile(path): + return None + try: + if os.path.getsize(path) != expected_size: + return None + if _file_sha256(path) != expected_sha.lower(): + return None + except OSError: + return None + + return path, record + + def _remove_tree(path): if not os.path.exists(path): @@ -1120,19 +1211,13 @@ def install_wowpresence(target_dir, progress=None): return revision -def install_cached_wowpresence(target_dir, progress=None): - """Install the last validated WowPresence package cached by this WoW install.""" - cached = _load_cached_file( - target_dir, - WOWPRESENCE_MANAGED_ID, - "WowPresence.zip", - ) - if cached is None: - raise RemotePackageError("No validated WowPresence offline fallback is cached.") - - zip_path, metadata = cached - revision = str(metadata.get("revision") or "cached") - +def _install_wowpresence_fallback_archive( + target_dir, + zip_path, + revision, + package_revision, + progress=None, +): existing_manifest = _load_managed_manifest_data( target_dir, WOWPRESENCE_MANAGED_ID, @@ -1152,14 +1237,13 @@ def install_cached_wowpresence(target_dir, progress=None): ) ensure_wowpresence_config(target_dir) - extract_root = tempfile.mkdtemp(prefix="modernization_wowpresence_cache_") + extract_root = tempfile.mkdtemp(prefix="modernization_wowpresence_fallback_") try: - _emit_progress(progress, "Loading cached WowPresence fallback...", None, None) _safe_extract(zip_path, extract_root) dll_path = _find_file(extract_root, "WowPresence.dll") exe_path = _find_file(extract_root, "WowPresence.exe") - _verify_x86_pe(dll_path, "cached WowPresence.dll") - _verify_x86_pe(exe_path, "cached WowPresence.exe") + _verify_x86_pe(dll_path, "fallback WowPresence.dll") + _verify_x86_pe(exe_path, "fallback WowPresence.exe") _install_managed_files_transactional( target_dir, @@ -1179,7 +1263,7 @@ def install_cached_wowpresence(target_dir, progress=None): "WowPresence.exe": _file_sha256(exe_path), }, package_digest=None, - package_revision=f"cache:{metadata.get('sha256', '')}", + package_revision=package_revision, ) finally: shutil.rmtree(extract_root, ignore_errors=True) @@ -1188,6 +1272,48 @@ def install_cached_wowpresence(target_dir, progress=None): return revision +def install_cached_wowpresence(target_dir, progress=None): + """Install the last validated WowPresence package cached by this WoW install.""" + cached = _load_cached_file( + target_dir, + WOWPRESENCE_MANAGED_ID, + "WowPresence.zip", + ) + if cached is None: + raise RemotePackageError("No validated WowPresence offline fallback is cached.") + + zip_path, metadata = cached + revision = str(metadata.get("revision") or "cached") + _emit_progress(progress, "Loading cached WowPresence fallback...", None, None) + return _install_wowpresence_fallback_archive( + target_dir, + zip_path, + revision, + f"cache:{metadata.get('sha256', '')}", + progress=progress, + ) + + +def install_bundled_wowpresence(target_dir, progress=None): + """Install the release-bundled known-good WowPresence fallback.""" + bundled = _load_bundled_remote_fallback( + WOWPRESENCE_MANAGED_ID, + "WowPresence.zip", + ) + if bundled is None: + raise RemotePackageError("Bundled WowPresence fallback is unavailable.") + + zip_path, metadata = bundled + revision = str(metadata.get("revision") or "bundled") + _emit_progress(progress, "Loading bundled WowPresence fallback...", None, None) + return _install_wowpresence_fallback_archive( + target_dir, + zip_path, + revision, + f"bundled:{metadata.get('sha256', '')}", + progress=progress, + ) + def install_interact(target_dir, progress=None): _emit_progress(progress, "Checking Interact release...", None, None) release = _latest_release("lookino/Interact") @@ -2046,16 +2172,31 @@ def _install_remote_mpq( "payload.mpq", expected_revision=revision, ) - if cached is None: - raise download_error - source_path, _ = cached - _verify_mpq(source_path) - _emit_progress( - progress, - f"{label.replace('Downloading ', '')}: using cached offline fallback.", - None, - None, - ) + if cached is not None: + source_path, _ = cached + _verify_mpq(source_path) + _emit_progress( + progress, + f"{label.replace('Downloading ', '')}: using cached offline fallback.", + None, + None, + ) + else: + bundled = _load_bundled_remote_fallback( + mod_id, + "payload.mpq", + expected_revision=revision, + ) + if bundled is None: + raise download_error + source_path, _ = bundled + _verify_mpq(source_path) + _emit_progress( + progress, + f"{label.replace('Downloading ', '')}: using bundled offline fallback.", + None, + None, + ) try: _emit_progress(progress, f"Installing {os.path.basename(destination)}...", None, None) @@ -2182,17 +2323,32 @@ def install_pink_herbs(target_dir, progress=None): return f"seacrabsam/patch-herb main@{installed_revision[:7]}" cached = _load_cached_file(target_dir, mod_id, "payload.mpq") - if cached is None: - raise revision_error - source_path, metadata = cached - revision = str(metadata.get("revision") or "cached") - _verify_mpq(source_path) - _emit_progress( - progress, - "Pink Herbs: using cached offline fallback.", - None, - None, - ) + if cached is not None: + source_path, metadata = cached + revision = str(metadata.get("revision") or "cached") + _verify_mpq(source_path) + _emit_progress( + progress, + "Pink Herbs: using cached offline fallback.", + None, + None, + ) + else: + bundled = _load_bundled_remote_fallback( + mod_id, + "payload.mpq", + ) + if bundled is None: + raise revision_error + source_path, metadata = bundled + revision = str(metadata.get("revision") or "bundled") + _verify_mpq(source_path) + _emit_progress( + progress, + "Pink Herbs: using bundled offline fallback.", + None, + None, + ) else: if installed_revision == revision: try: @@ -2252,17 +2408,32 @@ def install_pink_herbs(target_dir, progress=None): return f"seacrabsam/patch-herb main@{installed_revision[:7]}" cached = _load_cached_file(target_dir, mod_id, "payload.mpq") - if cached is None: - raise download_error - source_path, metadata = cached - revision = str(metadata.get("revision") or revision) - _verify_mpq(source_path) - _emit_progress( - progress, - "Pink Herbs: using cached offline fallback.", - None, - None, - ) + if cached is not None: + source_path, metadata = cached + revision = str(metadata.get("revision") or revision) + _verify_mpq(source_path) + _emit_progress( + progress, + "Pink Herbs: using cached offline fallback.", + None, + None, + ) + else: + bundled = _load_bundled_remote_fallback( + mod_id, + "payload.mpq", + ) + if bundled is None: + raise download_error + source_path, metadata = bundled + revision = str(metadata.get("revision") or revision) + _verify_mpq(source_path) + _emit_progress( + progress, + "Pink Herbs: using bundled offline fallback.", + None, + None, + ) try: _migrate_legacy_pink_herbs_patch(target_dir, source_path, progress=progress) -- 2.52.0 From c304cd05420c8321436b4fb4d83f616d63177a46 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:18:02 +0200 Subject: [PATCH 028/101] Add bundled WowPresence fallback path --- setup_tool_dynamic.py | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index d269acf..0c96e41 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -1451,14 +1451,26 @@ class ModernWowSetupTool(WowSetupTool): target, progress=self._report_download_progress, ) - except Exception as fallback_exc: - raise RuntimeError( - "Could not install WowPresence from its online source " - "and no validated local fallback is available." - ) from fallback_exc + fallback_action = ( + "The last validated cached WowPresence package was installed instead." + ) + except Exception: + try: + remote_packages.install_bundled_wowpresence( + target, + progress=self._report_download_progress, + ) + fallback_action = ( + "The bundled known-good WowPresence fallback was installed instead." + ) + except Exception as bundled_exc: + raise RuntimeError( + "Could not install WowPresence from its online source, " + "local cache or bundled fallback." + ) from bundled_exc self._warn_offline( "WowPresence", - "The last validated cached WowPresence package was installed instead.", + fallback_action, exc, ) -- 2.52.0 From 34b3affeb1cdf06b652a11a1711f74bb06eff5f3 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:18:55 +0200 Subject: [PATCH 029/101] Fix SuperAPI fallback blob identity --- Payload/Fallback/versions.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Payload/Fallback/versions.json b/Payload/Fallback/versions.json index 690929a..66e3270 100644 --- a/Payload/Fallback/versions.json +++ b/Payload/Fallback/versions.json @@ -624,7 +624,7 @@ { "path": "Payload/Interface/Addons/SuperAPI/SuperAPIOptions.lua", "size": 10908, - "git_blob_sha1": "3fabab494f706814b5fa02c0e0d1b9221d52d0" + "git_blob_sha1": "3fabab494f706814b5fa02c0e0e0d1b9221d52d0" }, { "path": "Payload/Interface/Addons/SuperAPI/libs/AceAddon-2.0/AceAddon-2.0.lua", -- 2.52.0 From 065ff4ee4f32c782033aa87772b5be43ec538c75 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:19:32 +0200 Subject: [PATCH 030/101] Document bundled remote fallbacks --- README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 2aa261b..87e33d5 100644 --- a/README.md +++ b/README.md @@ -163,11 +163,12 @@ from its official stable release and SuperAPI follows the current upstream `master` revision. If either online source is unavailable, the tool can install the bundled known-good SuperWoW + SuperAPI fallback instead. -**WowPresence and remote visual mods keep a validated local cache.** A successful -download refreshes the cache, while already valid installed files can seed it -when possible. Cache write failures never block a successful normal install. -A completely fresh offline installation of these cache-only components still -requires a cache created by an earlier valid installation. +**WowPresence and remote visual mods use layered fallbacks.** A successful +download refreshes a validated local cache, while already valid installed files +can seed that cache when possible. Cache write failures never block a successful +normal install. Release builds also include a verified known-good fallback for +WowPresence, Pink Herbs, Darker Nights, Pretty Night Sky, Epoch Water and Fog +Pushback, so these components can still be installed on a fresh offline setup. **No1600x1200 uses the bundled known-good copy** instead of following the RetroCro archive repository automatically. -- 2.52.0 From e59bc1fc53d375a8e44230fa0c0e44e0ea555d99 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:19:35 +0200 Subject: [PATCH 031/101] Document build-time remote fallbacks --- THIRD_PARTY_NOTICES.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md index 4d7742b..baa11e8 100644 --- a/THIRD_PARTY_NOTICES.md +++ b/THIRD_PARTY_NOTICES.md @@ -23,7 +23,8 @@ own terms. - Source: https://github.com/Dusk-92/WowPresence - Maintained by Dusk-92 - Installed and updated from its GitHub Releases when Discord Rich Presence is selected -- `WowPresence.dll` and `WowPresence.exe` are not bundled in the Modernization Tool payload +- Release builds include a verified `WowPresence.zip` offline fallback prepared from the v1.3 release +- The source repository does not store duplicate WowPresence binaries; the fallback is fetched and verified during the release build - User configuration under `.modernization_tool/WowPresence/` is preserved across binary updates - See the WowPresence repository and its `THIRD_PARTY_NOTICES.md` for component-specific provenance @@ -157,6 +158,12 @@ See `Docs/ASSET_PROVENANCE.md` for project branding and game-facing asset notes. Source paths for bundled audio fallbacks remain recorded in `Payload/Fallback/versions.json`. +Release builds also prepare verified offline fallback copies for Pink Herbs, +Darker Nights, Pretty Night Sky, Epoch Water and Fog Pushback. These large files +are fetched from their documented sources during the build instead of being +duplicated in Git history. Their build-time size and SHA-256 records are stored +in `Payload/Fallback/remote_fallbacks.json` inside the packaged Tool. + ## Blizzard / World of Warcraft Modernization Tool is unofficial and independent. -- 2.52.0 From 166ae58a9f65f0eeedc312d81e0d425ed42eead6 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:19:38 +0200 Subject: [PATCH 032/101] Document generated remote fallback provenance --- Docs/BINARY_PROVENANCE.md | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/Docs/BINARY_PROVENANCE.md b/Docs/BINARY_PROVENANCE.md index 0a6e6c6..d02d20a 100644 --- a/Docs/BINARY_PROVENANCE.md +++ b/Docs/BINARY_PROVENANCE.md @@ -31,6 +31,12 @@ This provenance pass restores the previously recorded SuperWoW fallback and veri | FishPing | bundled fallback + online source | notsureawake/FishPing | project-wide license not independently located | | NoErrorSounds | bundled fallback + online source | Macumbafeh/NoErrorSounds | project-wide license not independently located | | Warlock Muted Demons | bundled fallback + online source | spzilyk/Warlock-Muted-Demons | project-wide license not independently located | +| WowPresence | release-build bundled fallback + online update | Dusk-92/WowPresence v1.3 | project-owned integration; see component notices | +| Pink Herbs | release-build bundled fallback + online update | seacrabsam/patch-herb pinned build revision | project-wide license not independently located | +| Darker Nights | release-build bundled fallback + online source | Project Reforged hosted MPQ | asset redistribution status tracked separately | +| Pretty Night Sky | release-build bundled fallback + online source | RetroCro mirror | asset redistribution status tracked separately | +| Epoch Water | release-build bundled fallback + online source | RetroCro mirror | asset redistribution status tracked separately | +| Fog Pushback | release-build bundled fallback + online source | RetroCro mirror | asset redistribution status tracked separately | ## SuperWoW / SuperAPI fallback @@ -61,10 +67,16 @@ Bundled fallback provenance: The exact fallback metadata is also recorded in `Payload/Fallback/versions.json`. -## Hash manifest +## Hash manifests -For components that remain bundled, the canonical machine-readable hashes are -kept in `Payload/Fallback/versions.json`. +For components stored directly in the repository, the canonical +machine-readable hashes are kept in `Payload/Fallback/versions.json`. + +Large remote fallbacks and WowPresence are prepared by +`scripts/prepare_remote_fallbacks.py` during release/test builds. The script +validates the downloaded package type, records its size and SHA-256, and writes +`Payload/Fallback/remote_fallbacks.json` before PyInstaller packages the +fallback into the executable. When updating a binary: -- 2.52.0 From 4a0f068465439c21cd7eca6a3a77beaea6cc6e9b Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:20:00 +0200 Subject: [PATCH 033/101] Test fresh offline bundled fallbacks --- tests/test_safety.py | 118 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 118 insertions(+) diff --git a/tests/test_safety.py b/tests/test_safety.py index c985065..044d839 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -1831,6 +1831,124 @@ class BundledComponentSafetyTests(unittest.TestCase): self.assertTrue(tool._valid_superapi_addon(addon)) + def test_bundled_remote_mpq_fallback_is_verified_and_used(self): + with tempfile.TemporaryDirectory() as runtime_root, tempfile.TemporaryDirectory() as game: + fallback_dir = os.path.join( + runtime_root, + "Payload", + "Fallback", + "Remote", + "visual_example", + ) + os.makedirs(fallback_dir) + payload = os.path.join(fallback_dir, "payload.mpq") + with open(payload, "wb") as handle: + handle.write(b"MPQbundled") + + manifest_path = os.path.join( + runtime_root, + "Payload", + "Fallback", + "remote_fallbacks.json", + ) + with open(manifest_path, "w", encoding="utf-8") as handle: + json.dump( + { + "fallbacks": { + "visual_example": { + "filename": "payload.mpq", + "revision": "1", + "size": os.path.getsize(payload), + "sha256": hashlib.sha256(b"MPQbundled").hexdigest(), + } + } + }, + handle, + ) + + with ( + mock.patch.object( + remote_packages, + "_runtime_base_path", + return_value=runtime_root, + ), + mock.patch.object( + remote_packages, + "_download", + side_effect=remote_packages.RemotePackageError("offline"), + ), + mock.patch.object( + remote_packages, + "_install_managed_files", + ) as install, + ): + remote_packages._install_remote_mpq( + game, + "visual_example", + "https://example.invalid/visual.mpq", + os.path.join("Data", "patch-X.mpq"), + revision="1", + ) + + self.assertEqual(install.call_args.args[2][0][0], payload) + + def test_bundled_wowpresence_can_install_without_cache(self): + with tempfile.TemporaryDirectory() as runtime_root, tempfile.TemporaryDirectory() as game: + fallback_dir = os.path.join( + runtime_root, + "Payload", + "Fallback", + "Remote", + remote_packages.WOWPRESENCE_MANAGED_ID, + ) + os.makedirs(fallback_dir) + package = os.path.join(fallback_dir, "WowPresence.zip") + with zipfile.ZipFile(package, "w") as archive: + archive.writestr("WowPresence.dll", b"dummy-dll") + archive.writestr("WowPresence.exe", b"dummy-exe") + + manifest_path = os.path.join( + runtime_root, + "Payload", + "Fallback", + "remote_fallbacks.json", + ) + with open(manifest_path, "w", encoding="utf-8") as handle: + json.dump( + { + "fallbacks": { + remote_packages.WOWPRESENCE_MANAGED_ID: { + "filename": "WowPresence.zip", + "revision": "v1.3", + "size": os.path.getsize(package), + "sha256": remote_packages._file_sha256(package), + } + } + }, + handle, + ) + + with ( + mock.patch.object( + remote_packages, + "_runtime_base_path", + return_value=runtime_root, + ), + mock.patch.object(remote_packages, "_verify_x86_pe"), + mock.patch.object( + remote_packages, + "_install_managed_files_transactional", + ) as install, + mock.patch.object( + remote_packages, + "_set_managed_manifest_values", + ), + ): + revision = remote_packages.install_bundled_wowpresence(game) + + self.assertEqual(revision, "v1.3") + install.assert_called_once() + def test_branch_archive_download_can_be_pinned_to_resolved_revision(self): with ( mock.patch.object(remote_packages, "_download", return_value="archive.zip") as download, -- 2.52.0 From c6a65ab044ef61e935628c034edc3cd8c4a1b815 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:20:03 +0200 Subject: [PATCH 034/101] Validate fallback build script syntax --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index dc78543..8fc6706 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -51,7 +51,7 @@ jobs: run: python scripts/prepare_remote_fallbacks.py - name: Syntax check - run: python -m py_compile setup_tool.py setup_tool_dynamic.py remote_packages.py tests/test_safety.py + run: python -m py_compile setup_tool.py setup_tool_dynamic.py remote_packages.py tests/test_safety.py scripts/prepare_remote_fallbacks.py - name: Unit safety tests run: python -m unittest discover -s tests -v -- 2.52.0 From 6fff497457af44a3ae78cb329d51440d6b3ae8fa Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:21:07 +0200 Subject: [PATCH 035/101] Preserve exact SuperAPI fallback bytes --- .gitattributes | 1 + 1 file changed, 1 insertion(+) create mode 100644 .gitattributes diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..8beb128 --- /dev/null +++ b/.gitattributes @@ -0,0 +1 @@ +Payload/Interface/Addons/SuperAPI/** text eol=lf -- 2.52.0 From 08bd69d1868a59b26a13f115ca84240569f89162 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:21:10 +0200 Subject: [PATCH 036/101] Pin generated fallback identities --- scripts/prepare_remote_fallbacks.py | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/scripts/prepare_remote_fallbacks.py b/scripts/prepare_remote_fallbacks.py index f71a151..33694e2 100644 --- a/scripts/prepare_remote_fallbacks.py +++ b/scripts/prepare_remote_fallbacks.py @@ -22,6 +22,7 @@ FALLBACKS = [ "revision": "v1.3", "url": "https://github.com/Dusk-92/WowPresence/releases/download/v1.3/WowPresence.zip", "kind": "wowpresence_zip", + "size": 141423, "sha256": "9b2dca9c69b5ab3b6dae3ef3b3efc9671779a227802ebb6ac98cb22bc6ea448a", }, { @@ -30,6 +31,8 @@ FALLBACKS = [ "revision": "c252bbdc2aef1ac928eb237cf4d28edc21806ed8", "url": "https://raw.githubusercontent.com/seacrabsam/patch-herb/c252bbdc2aef1ac928eb237cf4d28edc21806ed8/patch-H.mpq", "kind": "mpq", + "size": 575628, + "sha256": "45b6b6795465a93104de213e0a36e1290b005a852cd6d03a8d21103efaefa0a7", }, { "id": "visual_darker_nights", @@ -37,6 +40,8 @@ FALLBACKS = [ "revision": "1", "url": "https://pub-0f05631d243e4046993fc02ca7be9542.r2.dev/patches/patch-N.mpq", "kind": "mpq", + "size": 201362, + "sha256": "31dcd9f779ef1f4e9c4e71b5da58948781989f72c0454fa59fdd173947d24084", }, { "id": "visual_pretty_night_sky", @@ -44,6 +49,8 @@ FALLBACKS = [ "revision": "1", "url": "https://drive.usercontent.google.com/download?id=1qu99ZS-SQFfTtYodBmZWYiHmxL8QtUY4&export=download&confirm=t", "kind": "mpq", + "size": 1390151, + "sha256": "b72e5837139772dff5e436c6a6375910fcb5c34ae5742512968463425c4520dd", }, { "id": "visual_epoch_water", @@ -51,6 +58,8 @@ FALLBACKS = [ "revision": "1", "url": "https://drive.usercontent.google.com/download?id=1xRx9OrznbgbE1uBae3H3OGke9UoXtzmU&export=download&confirm=t", "kind": "mpq", + "size": 20411526, + "sha256": "30a969c185cc082a0eb158a7901de889af815426c1e5baec373649688b3151aa", }, { "id": "visual_fog_pushback", @@ -58,6 +67,8 @@ FALLBACKS = [ "revision": "1", "url": "https://drive.usercontent.google.com/download?id=14aHvyfr_ACL-UURbNa_fXRPcfQZoIw8n&export=download&confirm=t", "kind": "mpq", + "size": 51281, + "sha256": "c59b87f7e9425ee890e2b869ea0d26cde84a68e3ee1004e18bb6a29b294c3e0d", }, ] @@ -163,6 +174,12 @@ def main(): ) size = os.path.getsize(destination) + expected_size = item.get("size") + if expected_size is not None and size != expected_size: + raise RuntimeError( + f"Size mismatch for {item['id']}: expected {expected_size}, got {size}" + ) + manifest["fallbacks"][item["id"]] = { "filename": item["filename"], "kind": item["kind"], -- 2.52.0 From c9c878dc19ecb1ee2625abd9bb18446622015b23 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:21:58 +0200 Subject: [PATCH 037/101] Prepare fallbacks in local builds --- Build.bat | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Build.bat b/Build.bat index dfc29fc..893e9f6 100644 --- a/Build.bat +++ b/Build.bat @@ -14,7 +14,10 @@ if errorlevel 1 exit /b 1 py -3.11 -m pip install --disable-pip-version-check -r requirements-build.txt if errorlevel 1 exit /b 1 -py -3.11 -m py_compile setup_tool.py setup_tool_dynamic.py remote_packages.py tests/test_safety.py +py -3.11 scripts\prepare_remote_fallbacks.py +if errorlevel 1 exit /b 1 + +py -3.11 -m py_compile setup_tool.py setup_tool_dynamic.py remote_packages.py tests/test_safety.py scripts\prepare_remote_fallbacks.py if errorlevel 1 exit /b 1 py -3.11 -m unittest discover -s tests -v -- 2.52.0 From 63aa6328ccdf8ff93396c4a71ae4b387825d8f07 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:23:58 +0200 Subject: [PATCH 038/101] Clarify visual fallback failure message --- setup_tool.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup_tool.py b/setup_tool.py index 5474913..363e463 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -1734,7 +1734,7 @@ class WowSetupTool: ) else: raise RuntimeError( - f"{display_name} installation failed and no usable cached fallback is available:\n{exc}" + f"{display_name} installation failed and no usable cached or bundled fallback is available:\n{exc}" ) from exc else: remote_packages.remove_managed_mod(target, managed_id) -- 2.52.0 From 9ff415ef3f890d431a55dcffb9e23bda987326e0 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:28:44 +0200 Subject: [PATCH 039/101] Remove MPQ fallback behavior --- remote_packages.py | 269 +++++++++------------------------------------ 1 file changed, 51 insertions(+), 218 deletions(-) diff --git a/remote_packages.py b/remote_packages.py index 0e2603f..8b6dc73 100644 --- a/remote_packages.py +++ b/remote_packages.py @@ -453,29 +453,6 @@ def _current_recorded_package_revision(target_dir, package_id): return None -def _cache_current_managed_mpq(target_dir, mod_id, revision): - """Seed cache from a managed MPQ and report whether the install is current.""" - if not managed_mpq_is_current(target_dir, mod_id, revision): - return False - - files = _load_managed_manifest(target_dir, mod_id) - if len(files) != 1: - return False - source_path = os.path.join(target_dir, files[0]) - try: - _verify_mpq(source_path) - except RemotePackageError: - return False - - _seed_cached_file_from_installed( - target_dir, - mod_id, - source_path, - "payload.mpq", - revision=revision, - validator=_verify_mpq, - ) - return True def _runtime_base_path(): return getattr( sys, @@ -2140,7 +2117,7 @@ def _install_remote_mpq( timeout=300, revision=None, ): - if revision is not None and _cache_current_managed_mpq( + if revision is not None and managed_mpq_is_current( target_dir, mod_id, revision, @@ -2153,79 +2130,33 @@ def _install_remote_mpq( ) return - downloaded_path = None - source_path = None + temp_path = _download( + url, + suffix=".mpq", + progress=progress, + label=label, + timeout=timeout, + ) try: - downloaded_path = _download( - url, - suffix=".mpq", - progress=progress, - label=label, - timeout=timeout, + _verify_mpq(temp_path) + _emit_progress( + progress, + f"Installing {os.path.basename(destination)}...", + None, + None, ) - _verify_mpq(downloaded_path) - source_path = downloaded_path - except Exception as download_error: - cached = _load_cached_file( - target_dir, - mod_id, - "payload.mpq", - expected_revision=revision, - ) - if cached is not None: - source_path, _ = cached - _verify_mpq(source_path) - _emit_progress( - progress, - f"{label.replace('Downloading ', '')}: using cached offline fallback.", - None, - None, - ) - else: - bundled = _load_bundled_remote_fallback( - mod_id, - "payload.mpq", - expected_revision=revision, - ) - if bundled is None: - raise download_error - source_path, _ = bundled - _verify_mpq(source_path) - _emit_progress( - progress, - f"{label.replace('Downloading ', '')}: using bundled offline fallback.", - None, - None, - ) - - try: - _emit_progress(progress, f"Installing {os.path.basename(destination)}...", None, None) _install_managed_files( target_dir, mod_id, - [(source_path, destination)], + [(temp_path, destination)], revision=revision, ) - - if downloaded_path is not None and _store_cached_file_safely( - target_dir, - mod_id, - downloaded_path, - "payload.mpq", - revision=revision, - ) is None: - _emit_progress( - progress, - f"{label.replace('Downloading ', '')} installed; offline cache could not be refreshed.", - None, - None, - ) finally: - if downloaded_path and os.path.exists(downloaded_path): - try: - os.remove(downloaded_path) - except OSError: - pass + try: + os.remove(temp_path) + except OSError: + pass + def _google_drive_download_url(file_id): return ( @@ -2293,8 +2224,6 @@ def install_pink_herbs(target_dir, progress=None): mod_id = "visual_pink_herbs" destination = os.path.join("Data", "patch-V.mpq") target_path = os.path.join(target_dir, destination) - downloaded_path = None - source_path = None installed_revision = _current_recorded_package_revision(target_dir, mod_id) try: @@ -2306,14 +2235,6 @@ def install_pink_herbs(target_dir, progress=None): except RemotePackageError: installed_revision = None else: - _seed_cached_file_from_installed( - target_dir, - mod_id, - target_path, - "payload.mpq", - revision=installed_revision, - validator=_verify_mpq, - ) _emit_progress( progress, f"Pink Herbs {installed_revision[:7]} kept; update source unavailable.", @@ -2321,122 +2242,49 @@ def install_pink_herbs(target_dir, progress=None): None, ) return f"seacrabsam/patch-herb main@{installed_revision[:7]}" + raise revision_error - cached = _load_cached_file(target_dir, mod_id, "payload.mpq") - if cached is not None: - source_path, metadata = cached - revision = str(metadata.get("revision") or "cached") - _verify_mpq(source_path) - _emit_progress( - progress, - "Pink Herbs: using cached offline fallback.", - None, - None, - ) + if installed_revision == revision: + try: + _verify_mpq(target_path) + except RemotePackageError: + installed_revision = None else: - bundled = _load_bundled_remote_fallback( - mod_id, - "payload.mpq", - ) - if bundled is None: - raise revision_error - source_path, metadata = bundled - revision = str(metadata.get("revision") or "bundled") - _verify_mpq(source_path) _emit_progress( progress, - "Pink Herbs: using bundled offline fallback.", + f"Pink Herbs {revision[:7]} is already current.", None, None, ) - else: - if installed_revision == revision: + return f"seacrabsam/patch-herb main@{revision[:7]}" + + try: + temp_path = _download( + f"https://raw.githubusercontent.com/seacrabsam/patch-herb/{revision}/patch-H.mpq", + suffix=".mpq", + progress=progress, + label="Downloading Pink Herbs", + timeout=300, + ) + except Exception as download_error: + if installed_revision is not None: try: _verify_mpq(target_path) except RemotePackageError: installed_revision = None else: - _seed_cached_file_from_installed( - target_dir, - mod_id, - target_path, - "payload.mpq", - revision=revision, - validator=_verify_mpq, - ) _emit_progress( progress, - f"Pink Herbs {revision[:7]} is already current.", - None, - None, - ) - return f"seacrabsam/patch-herb main@{revision[:7]}" - - try: - downloaded_path = _download( - f"https://raw.githubusercontent.com/seacrabsam/patch-herb/{revision}/patch-H.mpq", - suffix=".mpq", - progress=progress, - label="Downloading Pink Herbs", - timeout=300, - ) - _verify_mpq(downloaded_path) - source_path = downloaded_path - except Exception as download_error: - # Never replace a valid installed revision with an older cache just - # because the newest remote payload is temporarily unavailable. - if installed_revision is not None: - try: - _verify_mpq(target_path) - except RemotePackageError: - installed_revision = None - else: - _seed_cached_file_from_installed( - target_dir, - mod_id, - target_path, - "payload.mpq", - revision=installed_revision, - validator=_verify_mpq, - ) - _emit_progress( - progress, - f"Pink Herbs {installed_revision[:7]} kept; latest download unavailable.", - None, - None, - ) - return f"seacrabsam/patch-herb main@{installed_revision[:7]}" - - cached = _load_cached_file(target_dir, mod_id, "payload.mpq") - if cached is not None: - source_path, metadata = cached - revision = str(metadata.get("revision") or revision) - _verify_mpq(source_path) - _emit_progress( - progress, - "Pink Herbs: using cached offline fallback.", - None, - None, - ) - else: - bundled = _load_bundled_remote_fallback( - mod_id, - "payload.mpq", - ) - if bundled is None: - raise download_error - source_path, metadata = bundled - revision = str(metadata.get("revision") or revision) - _verify_mpq(source_path) - _emit_progress( - progress, - "Pink Herbs: using bundled offline fallback.", + f"Pink Herbs {installed_revision[:7]} kept; latest download unavailable.", None, None, ) + return f"seacrabsam/patch-herb main@{installed_revision[:7]}" + raise download_error try: - _migrate_legacy_pink_herbs_patch(target_dir, source_path, progress=progress) + _verify_mpq(temp_path) + _migrate_legacy_pink_herbs_patch(target_dir, temp_path, progress=progress) _emit_progress( progress, f"Installing {os.path.basename(destination)}...", @@ -2446,7 +2294,7 @@ def install_pink_herbs(target_dir, progress=None): _install_managed_files( target_dir, mod_id, - [(source_path, destination)], + [(temp_path, destination)], revision=VISUAL_MOD_REVISIONS[mod_id], ) _record_package_state_safely( @@ -2455,29 +2303,14 @@ def install_pink_herbs(target_dir, progress=None): revision, [destination], ) - - if downloaded_path is not None and _store_cached_file_safely( - target_dir, - mod_id, - downloaded_path, - "payload.mpq", - revision=revision, - ) is None: - _emit_progress( - progress, - "Pink Herbs installed; offline cache could not be refreshed.", - None, - None, - ) finally: - if downloaded_path and os.path.exists(downloaded_path): - try: - os.remove(downloaded_path) - except OSError: - pass + try: + os.remove(temp_path) + except OSError: + pass + + return f"seacrabsam/patch-herb main@{revision[:7]}" - suffix = revision[:7] if len(revision) >= 7 else revision - return f"seacrabsam/patch-herb main@{suffix}" def _download_github_branch_archive( repo, -- 2.52.0 From 3e32b7985bff441405ed5f7aa8d248caaa3a96dc Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:28:55 +0200 Subject: [PATCH 040/101] Stop bundling MPQ fallbacks --- scripts/prepare_remote_fallbacks.py | 56 ++--------------------------- 1 file changed, 2 insertions(+), 54 deletions(-) diff --git a/scripts/prepare_remote_fallbacks.py b/scripts/prepare_remote_fallbacks.py index 33694e2..19b202f 100644 --- a/scripts/prepare_remote_fallbacks.py +++ b/scripts/prepare_remote_fallbacks.py @@ -25,54 +25,10 @@ FALLBACKS = [ "size": 141423, "sha256": "9b2dca9c69b5ab3b6dae3ef3b3efc9671779a227802ebb6ac98cb22bc6ea448a", }, - { - "id": "visual_pink_herbs", - "filename": "payload.mpq", - "revision": "c252bbdc2aef1ac928eb237cf4d28edc21806ed8", - "url": "https://raw.githubusercontent.com/seacrabsam/patch-herb/c252bbdc2aef1ac928eb237cf4d28edc21806ed8/patch-H.mpq", - "kind": "mpq", - "size": 575628, - "sha256": "45b6b6795465a93104de213e0a36e1290b005a852cd6d03a8d21103efaefa0a7", - }, - { - "id": "visual_darker_nights", - "filename": "payload.mpq", - "revision": "1", - "url": "https://pub-0f05631d243e4046993fc02ca7be9542.r2.dev/patches/patch-N.mpq", - "kind": "mpq", - "size": 201362, - "sha256": "31dcd9f779ef1f4e9c4e71b5da58948781989f72c0454fa59fdd173947d24084", - }, - { - "id": "visual_pretty_night_sky", - "filename": "payload.mpq", - "revision": "1", - "url": "https://drive.usercontent.google.com/download?id=1qu99ZS-SQFfTtYodBmZWYiHmxL8QtUY4&export=download&confirm=t", - "kind": "mpq", - "size": 1390151, - "sha256": "b72e5837139772dff5e436c6a6375910fcb5c34ae5742512968463425c4520dd", - }, - { - "id": "visual_epoch_water", - "filename": "payload.mpq", - "revision": "1", - "url": "https://drive.usercontent.google.com/download?id=1xRx9OrznbgbE1uBae3H3OGke9UoXtzmU&export=download&confirm=t", - "kind": "mpq", - "size": 20411526, - "sha256": "30a969c185cc082a0eb158a7901de889af815426c1e5baec373649688b3151aa", - }, - { - "id": "visual_fog_pushback", - "filename": "payload.mpq", - "revision": "1", - "url": "https://drive.usercontent.google.com/download?id=14aHvyfr_ACL-UURbNa_fXRPcfQZoIw8n&export=download&confirm=t", - "kind": "mpq", - "size": 51281, - "sha256": "c59b87f7e9425ee890e2b869ea0d26cde84a68e3ee1004e18bb6a29b294c3e0d", - }, ] + def _sha256(path): digest = hashlib.sha256() with open(path, "rb") as handle: @@ -110,12 +66,6 @@ def _download(url, destination, retries=3): raise RuntimeError(f"Could not download {url}: {last_error}") -def _verify_mpq(path): - with open(path, "rb") as handle: - if handle.read(3) != b"MPQ": - raise RuntimeError(f"{path} is not an MPQ file") - - def _verify_x86_pe_bytes(data, label): if len(data) < 1024 or data[:2] != b"MZ": raise RuntimeError(f"{label} is not a valid PE file") @@ -159,9 +109,7 @@ def main(): print(f"Preparing bundled fallback: {item['id']}", flush=True) _download(item["url"], destination) - if item["kind"] == "mpq": - _verify_mpq(destination) - elif item["kind"] == "wowpresence_zip": + if item["kind"] == "wowpresence_zip": _verify_wowpresence_zip(destination) else: raise RuntimeError(f"Unknown fallback kind: {item['kind']}") -- 2.52.0 From 2b7de2613c808e2e69ec6d70e83e4f3d14d30ad9 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:29:19 +0200 Subject: [PATCH 041/101] Restore online-only MPQ behavior --- setup_tool.py | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/setup_tool.py b/setup_tool.py index 363e463..504a047 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -1720,9 +1720,8 @@ class WowSetupTool: ] try: - # Visual installers own their current-version and cache checks. - # Already valid MPQs are reused without a download and can seed the - # local offline cache on upgrades from older Tool releases. + # Visual installers own their current-version checks. + # Already valid MPQs are reused without a download. for key, managed_id, display_name, installer in visual_defs: if self.visual_mods[key].get(): try: @@ -1734,7 +1733,7 @@ class WowSetupTool: ) else: raise RuntimeError( - f"{display_name} installation failed and no usable cached or bundled fallback is available:\n{exc}" + f"{display_name} installation failed and no valid installed copy can be kept:\n{exc}" ) from exc else: remote_packages.remove_managed_mod(target, managed_id) -- 2.52.0 From 98325b403ccf7aa2126ee7def52a44a5fadc2b7b Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:29:23 +0200 Subject: [PATCH 042/101] Document online-only visual MPQs --- README.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 87e33d5..cb5b1c1 100644 --- a/README.md +++ b/README.md @@ -163,12 +163,15 @@ from its official stable release and SuperAPI follows the current upstream `master` revision. If either online source is unavailable, the tool can install the bundled known-good SuperWoW + SuperAPI fallback instead. -**WowPresence and remote visual mods use layered fallbacks.** A successful -download refreshes a validated local cache, while already valid installed files -can seed that cache when possible. Cache write failures never block a successful -normal install. Release builds also include a verified known-good fallback for -WowPresence, Pink Herbs, Darker Nights, Pretty Night Sky, Epoch Water and Fog -Pushback, so these components can still be installed on a fresh offline setup. +**WowPresence uses layered fallbacks.** A successful download refreshes a +validated local cache, while an already valid installed copy can seed that cache +when possible. Cache write failures never block a successful normal install. +Release builds also include a verified known-good WowPresence fallback for +first-time offline installation. + +**Visual MPQ mods do not use offline fallbacks.** If their source is unavailable, +the Tool keeps an already valid installed copy unchanged; a first-time install +still requires access to the original source. **No1600x1200 uses the bundled known-good copy** instead of following the RetroCro archive repository automatically. -- 2.52.0 From a42608f63590a92a14411a7a34864e8a01d651bf Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:29:25 +0200 Subject: [PATCH 043/101] Remove MPQ fallback redistribution notes --- THIRD_PARTY_NOTICES.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md index baa11e8..aa9c7d9 100644 --- a/THIRD_PARTY_NOTICES.md +++ b/THIRD_PARTY_NOTICES.md @@ -158,11 +158,11 @@ See `Docs/ASSET_PROVENANCE.md` for project branding and game-facing asset notes. Source paths for bundled audio fallbacks remain recorded in `Payload/Fallback/versions.json`. -Release builds also prepare verified offline fallback copies for Pink Herbs, -Darker Nights, Pretty Night Sky, Epoch Water and Fog Pushback. These large files -are fetched from their documented sources during the build instead of being -duplicated in Git history. Their build-time size and SHA-256 records are stored -in `Payload/Fallback/remote_fallbacks.json` inside the packaged Tool. +Visual MPQ mods such as Pink Herbs, Darker Nights, Pretty Night Sky, Epoch +Water and Fog Pushback are not redistributed as offline fallbacks. Their +original sources remain authoritative. If an already installed managed MPQ is +still valid and its source is temporarily unavailable, the Tool preserves that +installed copy unchanged. ## Blizzard / World of Warcraft -- 2.52.0 From 77ace2d642b82e2722116487a8e5043813e8af1d Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:29:29 +0200 Subject: [PATCH 044/101] Remove MPQ fallback provenance --- Docs/BINARY_PROVENANCE.md | 15 +++++---------- 1 file changed, 5 insertions(+), 10 deletions(-) diff --git a/Docs/BINARY_PROVENANCE.md b/Docs/BINARY_PROVENANCE.md index d02d20a..ff43b6c 100644 --- a/Docs/BINARY_PROVENANCE.md +++ b/Docs/BINARY_PROVENANCE.md @@ -32,11 +32,6 @@ This provenance pass restores the previously recorded SuperWoW fallback and veri | NoErrorSounds | bundled fallback + online source | Macumbafeh/NoErrorSounds | project-wide license not independently located | | Warlock Muted Demons | bundled fallback + online source | spzilyk/Warlock-Muted-Demons | project-wide license not independently located | | WowPresence | release-build bundled fallback + online update | Dusk-92/WowPresence v1.3 | project-owned integration; see component notices | -| Pink Herbs | release-build bundled fallback + online update | seacrabsam/patch-herb pinned build revision | project-wide license not independently located | -| Darker Nights | release-build bundled fallback + online source | Project Reforged hosted MPQ | asset redistribution status tracked separately | -| Pretty Night Sky | release-build bundled fallback + online source | RetroCro mirror | asset redistribution status tracked separately | -| Epoch Water | release-build bundled fallback + online source | RetroCro mirror | asset redistribution status tracked separately | -| Fog Pushback | release-build bundled fallback + online source | RetroCro mirror | asset redistribution status tracked separately | ## SuperWoW / SuperAPI fallback @@ -72,11 +67,11 @@ The exact fallback metadata is also recorded in For components stored directly in the repository, the canonical machine-readable hashes are kept in `Payload/Fallback/versions.json`. -Large remote fallbacks and WowPresence are prepared by -`scripts/prepare_remote_fallbacks.py` during release/test builds. The script -validates the downloaded package type, records its size and SHA-256, and writes -`Payload/Fallback/remote_fallbacks.json` before PyInstaller packages the -fallback into the executable. +WowPresence is prepared as a release-build fallback by +`scripts/prepare_remote_fallbacks.py`. The script validates the release ZIP, +records its size and SHA-256, and writes +`Payload/Fallback/remote_fallbacks.json` before PyInstaller packages it into +the executable. Visual MPQ mods are intentionally not bundled as fallbacks. When updating a binary: -- 2.52.0 From 859fe4037e7a966529f537b19c8d8f6f09a62be5 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:29:47 +0200 Subject: [PATCH 045/101] Update tests for online-only MPQs --- tests/test_safety.py | 183 +++++-------------------------------------- 1 file changed, 18 insertions(+), 165 deletions(-) diff --git a/tests/test_safety.py b/tests/test_safety.py index 044d839..ce5da5e 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -1431,51 +1431,6 @@ class BundledComponentSafetyTests(unittest.TestCase): ) ) - def test_remote_mpq_uses_validated_cache_when_download_fails(self): - with tempfile.TemporaryDirectory() as root: - source = os.path.join(root, "visual.mpq") - with open(source, "wb") as handle: - handle.write(b"MPQcached-visual") - - remote_packages._store_cached_file( - root, - "visual_example", - source, - "payload.mpq", - revision="rev1", - ) - - with ( - mock.patch.object( - remote_packages, - "_download", - side_effect=remote_packages.RemotePackageError("offline"), - ), - mock.patch.object( - remote_packages, - "_install_managed_files", - ) as install, - ): - remote_packages._install_remote_mpq( - root, - "visual_example", - "https://example.invalid/visual.mpq", - os.path.join("Data", "patch-X.mpq"), - revision="rev1", - ) - - cached = remote_packages._load_cached_file( - root, - "visual_example", - "payload.mpq", - expected_revision="rev1", - ) - self.assertIsNotNone(cached) - self.assertEqual( - install.call_args.args[2][0][0], - cached[0], - ) - def test_superwow_bundled_fallback_keeps_dll_and_superapi_paired(self): tool = ModernWowSetupTool.__new__(ModernWowSetupTool) tool.addon_dependencies = { @@ -1603,70 +1558,29 @@ class BundledComponentSafetyTests(unittest.TestCase): ) ) - def test_current_managed_mpq_seeds_cache_without_network(self): + def test_remote_mpq_has_no_offline_fallback(self): with tempfile.TemporaryDirectory() as root: - relative = os.path.join("Data", "patch-X.mpq") - target = os.path.join(root, relative) - os.makedirs(os.path.dirname(target)) - with open(target, "wb") as handle: - handle.write(b"MPQalready-current") - - remote_packages._write_managed_manifest( - root, - "visual_example", - [relative], - revision="1", - ) - - with mock.patch.object(remote_packages, "_download") as download: - remote_packages._install_remote_mpq( - root, - "visual_example", - "https://example.invalid/visual.mpq", - relative, - revision="1", - ) - - download.assert_not_called() - cached = remote_packages._load_cached_file( - root, - "visual_example", - "payload.mpq", - expected_revision="1", - ) - self.assertIsNotNone(cached) - - def test_cache_write_failure_does_not_break_online_mpq_install(self): - with tempfile.TemporaryDirectory() as root: - downloaded = os.path.join(root, "downloaded.mpq") - with open(downloaded, "wb") as handle: - handle.write(b"MPQdownloaded") - - with ( - mock.patch.object( - remote_packages, - "_download", - return_value=downloaded, - ), - mock.patch.object( - remote_packages, - "_install_managed_files", - ) as install, - mock.patch.object( - remote_packages, - "_store_cached_file_safely", - return_value=None, - ), + with mock.patch.object( + remote_packages, + "_download", + side_effect=remote_packages.RemotePackageError("offline"), ): - remote_packages._install_remote_mpq( + with self.assertRaises(remote_packages.RemotePackageError): + remote_packages._install_remote_mpq( + root, + "visual_example", + "https://example.invalid/visual.mpq", + os.path.join("Data", "patch-X.mpq"), + revision="1", + ) + + self.assertIsNone( + remote_packages._load_cached_file( root, "visual_example", - "https://example.invalid/visual.mpq", - os.path.join("Data", "patch-X.mpq"), - revision="2", + "payload.mpq", ) - - install.assert_called_once() + ) def test_pink_herbs_keeps_valid_installed_revision_when_update_download_fails(self): with tempfile.TemporaryDirectory() as root: @@ -1831,67 +1745,6 @@ class BundledComponentSafetyTests(unittest.TestCase): self.assertTrue(tool._valid_superapi_addon(addon)) - def test_bundled_remote_mpq_fallback_is_verified_and_used(self): - with tempfile.TemporaryDirectory() as runtime_root, tempfile.TemporaryDirectory() as game: - fallback_dir = os.path.join( - runtime_root, - "Payload", - "Fallback", - "Remote", - "visual_example", - ) - os.makedirs(fallback_dir) - payload = os.path.join(fallback_dir, "payload.mpq") - with open(payload, "wb") as handle: - handle.write(b"MPQbundled") - - manifest_path = os.path.join( - runtime_root, - "Payload", - "Fallback", - "remote_fallbacks.json", - ) - with open(manifest_path, "w", encoding="utf-8") as handle: - json.dump( - { - "fallbacks": { - "visual_example": { - "filename": "payload.mpq", - "revision": "1", - "size": os.path.getsize(payload), - "sha256": hashlib.sha256(b"MPQbundled").hexdigest(), - } - } - }, - handle, - ) - - with ( - mock.patch.object( - remote_packages, - "_runtime_base_path", - return_value=runtime_root, - ), - mock.patch.object( - remote_packages, - "_download", - side_effect=remote_packages.RemotePackageError("offline"), - ), - mock.patch.object( - remote_packages, - "_install_managed_files", - ) as install, - ): - remote_packages._install_remote_mpq( - game, - "visual_example", - "https://example.invalid/visual.mpq", - os.path.join("Data", "patch-X.mpq"), - revision="1", - ) - - self.assertEqual(install.call_args.args[2][0][0], payload) - def test_bundled_wowpresence_can_install_without_cache(self): with tempfile.TemporaryDirectory() as runtime_root, tempfile.TemporaryDirectory() as game: fallback_dir = os.path.join( -- 2.52.0 From 386917c9f07953923fcdaf20db1e3d8ce6a8f5f1 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:30:07 +0200 Subject: [PATCH 046/101] Remove unused MPQ cache helper --- remote_packages.py | 36 ------------------------------------ 1 file changed, 36 deletions(-) diff --git a/remote_packages.py b/remote_packages.py index 8b6dc73..481e740 100644 --- a/remote_packages.py +++ b/remote_packages.py @@ -407,42 +407,6 @@ def _load_cached_file(target_dir, package_id, filename=None, expected_revision=N return cached_path, metadata -def _seed_cached_file_from_installed( - target_dir, - package_id, - source_path, - filename, - revision=None, - validator=None, -): - """Best-effort cache seeding from an already validated installed file.""" - cached = _load_cached_file( - target_dir, - package_id, - filename, - expected_revision=revision, - ) - if cached is not None: - return True - - try: - if callable(validator): - validator(source_path) - except Exception: - return False - - return ( - _store_cached_file_safely( - target_dir, - package_id, - source_path, - filename, - revision=revision, - ) - is not None - ) - - def _current_recorded_package_revision(target_dir, package_id): data = _load_package_state(target_dir, package_id) revision = data.get("revision") if isinstance(data, dict) else None -- 2.52.0 From c140fdfe989afd7f70af3ff8700d3546e764d2f8 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:31:20 +0200 Subject: [PATCH 047/101] Clean obsolete MPQ fallback caches --- remote_packages.py | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/remote_packages.py b/remote_packages.py index 481e740..96732cf 100644 --- a/remote_packages.py +++ b/remote_packages.py @@ -277,6 +277,19 @@ def _package_cache_dir(target_dir, package_id): ) +def remove_package_cache(target_dir, package_id): + """Remove one tool-owned package cache without touching installed files.""" + cache_dir = _package_cache_dir(target_dir, package_id) + if os.path.isdir(cache_dir): + shutil.rmtree(cache_dir, ignore_errors=True) + + parent = os.path.dirname(cache_dir) + try: + os.rmdir(parent) + except OSError: + pass + + def _safe_cache_filename(filename): if not isinstance(filename, str) or not filename: raise RemotePackageError("Invalid package-cache filename.") @@ -1770,6 +1783,21 @@ def managed_mod_is_current(target_dir, mod_id, revision): return str(installed_revision) == str(revision) +def managed_mpq_is_usable(target_dir, mod_id): + """True when a managed single-file MPQ still has a valid MPQ header.""" + if not managed_mod_is_installed(target_dir, mod_id): + return False + files = _load_managed_manifest(target_dir, mod_id) + if len(files) != 1: + return False + path = os.path.join(target_dir, files[0]) + try: + _verify_mpq(path) + return True + except RemotePackageError: + return False + + def managed_mpq_is_current(target_dir, mod_id, revision): """Cheap integrity check for an already installed managed MPQ.""" if not managed_mod_is_current(target_dir, mod_id, revision): -- 2.52.0 From b0394ac6621b91518855d4d24f08956e7d58529c Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:31:24 +0200 Subject: [PATCH 048/101] Preserve only valid installed MPQs --- setup_tool.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/setup_tool.py b/setup_tool.py index 504a047..3f18603 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -1719,6 +1719,11 @@ class WowSetupTool: ), ] + # MPQ fallbacks were intentionally removed. Clean caches created by + # earlier test builds so they cannot be reused later. + for _, managed_id, _, _ in visual_defs: + remote_packages.remove_package_cache(target, managed_id) + try: # Visual installers own their current-version checks. # Already valid MPQs are reused without a download. @@ -1727,7 +1732,7 @@ class WowSetupTool: try: installer(target, progress=progress) except Exception as exc: - if remote_packages.managed_mod_is_installed(target, managed_id): + if remote_packages.managed_mpq_is_usable(target, managed_id): warnings.append( f"{display_name}: update source unavailable; existing installed copy kept." ) -- 2.52.0 From 669361aeeebb439fcf99395c19da5e1d482b8447 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:31:36 +0200 Subject: [PATCH 049/101] Test MPQ fallback removal cleanup --- tests/test_safety.py | 52 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) diff --git a/tests/test_safety.py b/tests/test_safety.py index ce5da5e..ee523d0 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -1558,6 +1558,58 @@ class BundledComponentSafetyTests(unittest.TestCase): ) ) + def test_visual_mpq_cache_cleanup_does_not_touch_installed_file(self): + with tempfile.TemporaryDirectory() as root: + cache_dir = remote_packages._package_cache_dir( + root, + "visual_example", + ) + os.makedirs(cache_dir) + with open(os.path.join(cache_dir, "payload.mpq"), "wb") as handle: + handle.write(b"MPQcached") + + installed = os.path.join(root, "Data", "patch-X.mpq") + os.makedirs(os.path.dirname(installed)) + with open(installed, "wb") as handle: + handle.write(b"MPQinstalled") + + remote_packages.remove_package_cache(root, "visual_example") + + self.assertFalse(os.path.exists(cache_dir)) + self.assertTrue(os.path.isfile(installed)) + + def test_managed_mpq_usable_rejects_corrupt_file(self): + with tempfile.TemporaryDirectory() as root: + relative = os.path.join("Data", "patch-X.mpq") + target = os.path.join(root, relative) + os.makedirs(os.path.dirname(target)) + with open(target, "wb") as handle: + handle.write(b"not-an-mpq") + + remote_packages._write_managed_manifest( + root, + "visual_example", + [relative], + revision="1", + ) + + self.assertFalse( + remote_packages.managed_mpq_is_usable( + root, + "visual_example", + ) + ) + + with open(target, "wb") as handle: + handle.write(b"MPQvalid") + + self.assertTrue( + remote_packages.managed_mpq_is_usable( + root, + "visual_example", + ) + ) + def test_remote_mpq_has_no_offline_fallback(self): with tempfile.TemporaryDirectory() as root: with mock.patch.object( -- 2.52.0 From e9c7b3b219ef65cd66cfb1be3796c6a304b538b1 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:42:07 +0200 Subject: [PATCH 050/101] Separate remote MPQ failures from local install errors --- remote_packages.py | 114 ++++++++++++++++++++++++++++++++++++++------- 1 file changed, 96 insertions(+), 18 deletions(-) diff --git a/remote_packages.py b/remote_packages.py index 96732cf..f9cb3a8 100644 --- a/remote_packages.py +++ b/remote_packages.py @@ -34,6 +34,10 @@ class RemotePackageError(RuntimeError): pass +class RemoteSourceUnavailable(RemotePackageError): + """Remote source could not provide a usable package.""" + + def _emit_progress(callback, message, current=None, total=None): if callback is None: return @@ -957,18 +961,52 @@ def write_wowpresence_broadcast_flags(target_dir, value): def cache_installed_wowpresence(target_dir, revision=None): - """Best-effort cache seed from an already valid WowPresence installation.""" + """Best-effort cache seed from a hash-verified managed WowPresence install.""" dll_path = os.path.join(target_dir, "WowPresence.dll") exe_path = os.path.join(target_dir, "WowPresence.exe") - try: - _verify_x86_pe(dll_path, "installed WowPresence.dll") - _verify_x86_pe(exe_path, "installed WowPresence.exe") - except RemotePackageError: + required = ("WowPresence.dll", "WowPresence.exe") + + manifest = _load_managed_manifest_data( + target_dir, + WOWPRESENCE_MANAGED_ID, + ) + if not isinstance(manifest, dict) or not manifest: return False + managed_files = { + rel.replace("\\", "/").casefold() + for rel in _load_managed_manifest(target_dir, WOWPRESENCE_MANAGED_ID) + } + if any(name.casefold() not in managed_files for name in required): + return False + + saved_hashes = manifest.get("file_sha256") + if not isinstance(saved_hashes, dict): + return False + + for filename, path in ( + ("WowPresence.dll", dll_path), + ("WowPresence.exe", exe_path), + ): + expected = saved_hashes.get(filename) + if ( + not isinstance(expected, str) + or len(expected.strip()) != 64 + or any(ch not in "0123456789abcdefABCDEF" for ch in expected.strip()) + ): + return False + try: + if _file_sha256(path) != expected.strip().lower(): + return False + _verify_x86_pe(path, f"installed {filename}") + except (OSError, RemotePackageError): + return False + if revision is None: - manifest = _load_managed_manifest_data(target_dir, WOWPRESENCE_MANAGED_ID) - revision = manifest.get("revision") if isinstance(manifest, dict) else None + revision = manifest.get("revision") + if revision in (None, ""): + return False + revision = str(revision) if _load_cached_file( target_dir, @@ -1002,7 +1040,6 @@ def cache_installed_wowpresence(target_dir, revision=None): except OSError: pass - def install_wowpresence(target_dir, progress=None): """Install or update WowPresence from its latest stable GitHub release ZIP.""" _emit_progress(progress, "Checking WowPresence release...", None, None) @@ -2099,6 +2136,48 @@ def _migrate_legacy_pink_herbs_patch(target_dir, downloaded_path, progress=None) revision=data.get("revision"), ) +def _download_remote_mpq( + url, + progress=None, + label="Downloading visual mod", + timeout=300, +): + """Download an MPQ while distinguishing source failures from local I/O.""" + try: + temp_path = _download( + url, + suffix=".mpq", + progress=progress, + label=label, + timeout=timeout, + ) + except (urllib.error.URLError, urllib.error.HTTPError, TimeoutError) as exc: + raise RemoteSourceUnavailable( + f"{label}: remote source is unavailable ({exc})." + ) from exc + + try: + with open(temp_path, "rb") as handle: + magic = handle.read(3) + except OSError: + try: + os.remove(temp_path) + except OSError: + pass + raise + + if magic != b"MPQ": + try: + os.remove(temp_path) + except OSError: + pass + raise RemoteSourceUnavailable( + f"{label}: remote source returned an invalid MPQ package." + ) + + return temp_path + + def _install_remote_mpq( target_dir, mod_id, @@ -2122,15 +2201,13 @@ def _install_remote_mpq( ) return - temp_path = _download( + temp_path = _download_remote_mpq( url, - suffix=".mpq", progress=progress, label=label, timeout=timeout, ) try: - _verify_mpq(temp_path) _emit_progress( progress, f"Installing {os.path.basename(destination)}...", @@ -2220,7 +2297,10 @@ def install_pink_herbs(target_dir, progress=None): try: revision = _branch_head_sha("seacrabsam/patch-herb", "main") - except Exception as revision_error: + except RemotePackageError as revision_error: + source_error = RemoteSourceUnavailable( + f"Pink Herbs: could not resolve the upstream revision ({revision_error})." + ) if installed_revision is not None: try: _verify_mpq(target_path) @@ -2234,7 +2314,7 @@ def install_pink_herbs(target_dir, progress=None): None, ) return f"seacrabsam/patch-herb main@{installed_revision[:7]}" - raise revision_error + raise source_error from revision_error if installed_revision == revision: try: @@ -2251,14 +2331,13 @@ def install_pink_herbs(target_dir, progress=None): return f"seacrabsam/patch-herb main@{revision[:7]}" try: - temp_path = _download( + temp_path = _download_remote_mpq( f"https://raw.githubusercontent.com/seacrabsam/patch-herb/{revision}/patch-H.mpq", - suffix=".mpq", progress=progress, label="Downloading Pink Herbs", timeout=300, ) - except Exception as download_error: + except RemoteSourceUnavailable as download_error: if installed_revision is not None: try: _verify_mpq(target_path) @@ -2272,10 +2351,9 @@ def install_pink_herbs(target_dir, progress=None): None, ) return f"seacrabsam/patch-herb main@{installed_revision[:7]}" - raise download_error + raise try: - _verify_mpq(temp_path) _migrate_legacy_pink_herbs_patch(target_dir, temp_path, progress=progress) _emit_progress( progress, -- 2.52.0 From 96cc98d52b1a7a064efd9213f7e46fe63c8a8964 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:42:18 +0200 Subject: [PATCH 051/101] Do not mask local MPQ install failures --- setup_tool.py | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/setup_tool.py b/setup_tool.py index 3f18603..43070a8 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -1731,15 +1731,19 @@ class WowSetupTool: if self.visual_mods[key].get(): try: installer(target, progress=progress) - except Exception as exc: + except remote_packages.RemoteSourceUnavailable as exc: if remote_packages.managed_mpq_is_usable(target, managed_id): warnings.append( f"{display_name}: update source unavailable; existing installed copy kept." ) else: raise RuntimeError( - f"{display_name} installation failed and no valid installed copy can be kept:\n{exc}" + f"{display_name} source is unavailable and no valid installed copy can be kept:\n{exc}" ) from exc + except Exception as exc: + raise RuntimeError( + f"{display_name} installation failed locally:\n{exc}" + ) from exc else: remote_packages.remove_managed_mod(target, managed_id) -- 2.52.0 From c8bce690a58fcec82738eee8408f35b1ec36bc92 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:42:49 +0200 Subject: [PATCH 052/101] Test strict MPQ errors and WowPresence cache trust --- tests/test_safety.py | 130 +++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 126 insertions(+), 4 deletions(-) diff --git a/tests/test_safety.py b/tests/test_safety.py index ee523d0..2d6a015 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -4,6 +4,7 @@ import os import struct import tempfile import unittest +import urllib.error import zipfile from unittest import mock @@ -1615,9 +1616,9 @@ class BundledComponentSafetyTests(unittest.TestCase): with mock.patch.object( remote_packages, "_download", - side_effect=remote_packages.RemotePackageError("offline"), + side_effect=urllib.error.URLError("offline"), ): - with self.assertRaises(remote_packages.RemotePackageError): + with self.assertRaises(remote_packages.RemoteSourceUnavailable): remote_packages._install_remote_mpq( root, "visual_example", @@ -1634,6 +1635,53 @@ class BundledComponentSafetyTests(unittest.TestCase): ) ) + def test_remote_mpq_local_install_error_is_not_source_failure(self): + with tempfile.TemporaryDirectory() as root: + downloaded = os.path.join(root, "downloaded.mpq") + with open(downloaded, "wb") as handle: + handle.write(b"MPQvalid") + + with ( + mock.patch.object( + remote_packages, + "_download", + return_value=downloaded, + ), + mock.patch.object( + remote_packages, + "_install_managed_files", + side_effect=OSError("file locked"), + ), + ): + with self.assertRaises(OSError): + remote_packages._install_remote_mpq( + root, + "visual_example", + "https://example.invalid/visual.mpq", + os.path.join("Data", "patch-X.mpq"), + revision="1", + ) + + def test_remote_mpq_invalid_download_is_source_failure(self): + with tempfile.TemporaryDirectory() as root: + downloaded = os.path.join(root, "downloaded.mpq") + with open(downloaded, "wb") as handle: + handle.write(b"not-an-mpq") + + with mock.patch.object( + remote_packages, + "_download", + return_value=downloaded, + ): + with self.assertRaises(remote_packages.RemoteSourceUnavailable): + remote_packages._install_remote_mpq( + root, + "visual_example", + "https://example.invalid/visual.mpq", + os.path.join("Data", "patch-X.mpq"), + revision="1", + ) + def test_pink_herbs_keeps_valid_installed_revision_when_update_download_fails(self): with tempfile.TemporaryDirectory() as root: relative = os.path.join("Data", "patch-V.mpq") @@ -1658,7 +1706,7 @@ class BundledComponentSafetyTests(unittest.TestCase): mock.patch.object( remote_packages, "_download", - side_effect=remote_packages.RemotePackageError("offline"), + side_effect=urllib.error.URLError("offline"), ), mock.patch.object( remote_packages, @@ -1674,9 +1722,24 @@ class BundledComponentSafetyTests(unittest.TestCase): def test_installed_wowpresence_can_seed_offline_cache(self): with tempfile.TemporaryDirectory() as root: + hashes = {} for filename in ("WowPresence.dll", "WowPresence.exe"): - with open(os.path.join(root, filename), "wb") as handle: + path = os.path.join(root, filename) + with open(path, "wb") as handle: handle.write(filename.encode("ascii")) + hashes[filename] = remote_packages._file_sha256(path) + + remote_packages._write_managed_manifest( + root, + remote_packages.WOWPRESENCE_MANAGED_ID, + ["WowPresence.dll", "WowPresence.exe"], + revision="v1.3", + ) + remote_packages._set_managed_manifest_values( + root, + remote_packages.WOWPRESENCE_MANAGED_ID, + file_sha256=hashes, + ) with mock.patch.object(remote_packages, "_verify_x86_pe"): self.assertTrue( @@ -1694,6 +1757,65 @@ class BundledComponentSafetyTests(unittest.TestCase): ) self.assertIsNotNone(cached) + def test_manual_wowpresence_is_not_promoted_to_validated_cache(self): + with tempfile.TemporaryDirectory() as root: + for filename in ("WowPresence.dll", "WowPresence.exe"): + with open(os.path.join(root, filename), "wb") as handle: + handle.write(filename.encode("ascii")) + + with mock.patch.object(remote_packages, "_verify_x86_pe"): + self.assertFalse( + remote_packages.cache_installed_wowpresence( + root, + revision="v1.3", + ) + ) + + self.assertIsNone( + remote_packages._load_cached_file( + root, + remote_packages.WOWPRESENCE_MANAGED_ID, + "WowPresence.zip", + ) + ) + + def test_modified_managed_wowpresence_is_not_cached(self): + with tempfile.TemporaryDirectory() as root: + hashes = {} + for filename in ("WowPresence.dll", "WowPresence.exe"): + path = os.path.join(root, filename) + with open(path, "wb") as handle: + handle.write(filename.encode("ascii")) + hashes[filename] = remote_packages._file_sha256(path) + + remote_packages._write_managed_manifest( + root, + remote_packages.WOWPRESENCE_MANAGED_ID, + ["WowPresence.dll", "WowPresence.exe"], + revision="v1.3", + ) + remote_packages._set_managed_manifest_values( + root, + remote_packages.WOWPRESENCE_MANAGED_ID, + file_sha256=hashes, + ) + + with open(os.path.join(root, "WowPresence.dll"), "ab") as handle: + handle.write(b"modified") + + with mock.patch.object(remote_packages, "_verify_x86_pe"): + self.assertFalse( + remote_packages.cache_installed_wowpresence(root) + ) + + self.assertIsNone( + remote_packages._load_cached_file( + root, + remote_packages.WOWPRESENCE_MANAGED_ID, + "WowPresence.zip", + ) + ) + def test_superapi_bundled_tree_rejects_tampering(self): tool = ModernWowSetupTool.__new__(ModernWowSetupTool) -- 2.52.0 From 6c6d6e2b7dd697879f9af7601c7905fc3c1879ac Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 21:43:00 +0200 Subject: [PATCH 053/101] Clarify WowPresence cache trust rules --- README.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index cb5b1c1..fbf6ac7 100644 --- a/README.md +++ b/README.md @@ -164,10 +164,12 @@ from its official stable release and SuperAPI follows the current upstream the bundled known-good SuperWoW + SuperAPI fallback instead. **WowPresence uses layered fallbacks.** A successful download refreshes a -validated local cache, while an already valid installed copy can seed that cache -when possible. Cache write failures never block a successful normal install. -Release builds also include a verified known-good WowPresence fallback for -first-time offline installation. +validated local cache, while an already tool-managed copy can seed that cache +only when its recorded SHA-256 hashes still match. Unknown/manual binaries may +be preserved when valid but are never promoted into the validated cache. Cache +write failures never block a successful normal install. Release builds also +include a verified known-good WowPresence fallback for first-time offline +installation. **Visual MPQ mods do not use offline fallbacks.** If their source is unavailable, the Tool keeps an already valid installed copy unchanged; a first-time install -- 2.52.0 From 64b7612c90a5625e9c055f27c916b7a6a5cee661 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 22:21:02 +0200 Subject: [PATCH 054/101] Classify WowPresence managed install trust --- remote_packages.py | 52 ++++++++++++++++++++++++++++++++-------------- 1 file changed, 36 insertions(+), 16 deletions(-) diff --git a/remote_packages.py b/remote_packages.py index f9cb3a8..13db1b4 100644 --- a/remote_packages.py +++ b/remote_packages.py @@ -960,48 +960,66 @@ def write_wowpresence_broadcast_flags(target_dir, value): -def cache_installed_wowpresence(target_dir, revision=None): - """Best-effort cache seed from a hash-verified managed WowPresence install.""" - dll_path = os.path.join(target_dir, "WowPresence.dll") - exe_path = os.path.join(target_dir, "WowPresence.exe") - required = ("WowPresence.dll", "WowPresence.exe") +def wowpresence_install_trust_state(target_dir): + """Classify the installed WowPresence pair without trusting PE validity alone. + Returns one of: + - "unmanaged": no Modernization Tool manifest exists; + - "managed_verified": recorded hashes match both managed binaries; + - "managed_modified": recorded hashes exist but the managed install differs; + - "managed_unverified": a legacy/incomplete managed manifest has no usable hashes. + """ manifest = _load_managed_manifest_data( target_dir, WOWPRESENCE_MANAGED_ID, ) if not isinstance(manifest, dict) or not manifest: - return False + return "unmanaged" + required = ("WowPresence.dll", "WowPresence.exe") managed_files = { rel.replace("\\", "/").casefold() for rel in _load_managed_manifest(target_dir, WOWPRESENCE_MANAGED_ID) } if any(name.casefold() not in managed_files for name in required): - return False + return "managed_modified" saved_hashes = manifest.get("file_sha256") if not isinstance(saved_hashes, dict): - return False + return "managed_unverified" - for filename, path in ( - ("WowPresence.dll", dll_path), - ("WowPresence.exe", exe_path), - ): + normalized_hashes = {} + for filename in required: expected = saved_hashes.get(filename) if ( not isinstance(expected, str) or len(expected.strip()) != 64 or any(ch not in "0123456789abcdefABCDEF" for ch in expected.strip()) ): - return False + return "managed_unverified" + normalized_hashes[filename] = expected.strip().lower() + + for filename in required: + path = os.path.join(target_dir, filename) try: - if _file_sha256(path) != expected.strip().lower(): - return False + if _file_sha256(path) != normalized_hashes[filename]: + return "managed_modified" _verify_x86_pe(path, f"installed {filename}") except (OSError, RemotePackageError): - return False + return "managed_modified" + return "managed_verified" + + +def cache_installed_wowpresence(target_dir, revision=None): + """Best-effort cache seed from a hash-verified managed WowPresence install.""" + if wowpresence_install_trust_state(target_dir) != "managed_verified": + return False + + manifest = _load_managed_manifest_data( + target_dir, + WOWPRESENCE_MANAGED_ID, + ) if revision is None: revision = manifest.get("revision") if revision in (None, ""): @@ -1016,6 +1034,8 @@ def cache_installed_wowpresence(target_dir, revision=None): ) is not None: return True + dll_path = os.path.join(target_dir, "WowPresence.dll") + exe_path = os.path.join(target_dir, "WowPresence.exe") fd, zip_path = tempfile.mkstemp(prefix="modernization_wowpresence_seed_", suffix=".zip") os.close(fd) try: -- 2.52.0 From 3fb218e296b34be0111b2f69b862ba3798d32778 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 22:21:24 +0200 Subject: [PATCH 055/101] Repair modified managed WowPresence offline --- setup_tool_dynamic.py | 103 +++++++++++++++++++++++++----------------- 1 file changed, 62 insertions(+), 41 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 0c96e41..5f15afd 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -786,6 +786,67 @@ class ModernWowSetupTool(WowSetupTool): except Exception: return False + def _recover_wowpresence_offline(self, target, error): + """Preserve only trusted/manual-valid WowPresence; repair modified managed files.""" + trust_state = remote_packages.wowpresence_install_trust_state(target) + existing_dll = os.path.join(target, "WowPresence.dll") + existing_exe = os.path.join(target, "WowPresence.exe") + existing_pair_valid = ( + self._valid_x86_dll(existing_dll, "WowPresence.dll") + and self._valid_x86_dll(existing_exe, "WowPresence.exe") + ) + + if trust_state == "managed_verified": + remote_packages.ensure_wowpresence_config(target) + remote_packages.cache_installed_wowpresence(target) + self._warn_offline( + "WowPresence", + "Keeping the hash-verified WowPresence binaries already managed by the Tool.", + error, + ) + return + + if trust_state in ("unmanaged", "managed_unverified") and existing_pair_valid: + remote_packages.ensure_wowpresence_config(target) + self._warn_offline( + "WowPresence", + ( + "Keeping the existing valid WowPresence binaries unchanged. " + "They were not promoted into the validated fallback cache." + ), + error, + ) + return + + try: + remote_packages.install_cached_wowpresence( + target, + progress=self._report_download_progress, + ) + fallback_action = ( + "The last validated cached WowPresence package was installed instead." + ) + except Exception: + try: + remote_packages.install_bundled_wowpresence( + target, + progress=self._report_download_progress, + ) + fallback_action = ( + "The bundled known-good WowPresence fallback was installed instead." + ) + except Exception as bundled_exc: + raise RuntimeError( + "Could not install WowPresence from its online source, " + "local cache or bundled fallback." + ) from bundled_exc + + self._warn_offline( + "WowPresence", + fallback_action, + error, + ) + def _valid_superapi_addon(self, addon_path): """Reject empty/partial SuperAPI folders before treating them as usable.""" required = ( @@ -1432,47 +1493,7 @@ class ModernWowSetupTool(WowSetupTool): progress=self._report_download_progress, ) except Exception as exc: - existing_dll = os.path.join(target, "WowPresence.dll") - existing_exe = os.path.join(target, "WowPresence.exe") - if ( - self._valid_x86_dll(existing_dll, "WowPresence.dll") - and self._valid_x86_dll(existing_exe, "WowPresence.exe") - ): - remote_packages.ensure_wowpresence_config(target) - remote_packages.cache_installed_wowpresence(target) - self._warn_offline( - "WowPresence", - "Keeping the currently installed WowPresence binaries.", - exc, - ) - else: - try: - remote_packages.install_cached_wowpresence( - target, - progress=self._report_download_progress, - ) - fallback_action = ( - "The last validated cached WowPresence package was installed instead." - ) - except Exception: - try: - remote_packages.install_bundled_wowpresence( - target, - progress=self._report_download_progress, - ) - fallback_action = ( - "The bundled known-good WowPresence fallback was installed instead." - ) - except Exception as bundled_exc: - raise RuntimeError( - "Could not install WowPresence from its online source, " - "local cache or bundled fallback." - ) from bundled_exc - self._warn_offline( - "WowPresence", - fallback_action, - exc, - ) + self._recover_wowpresence_offline(target, exc) # Remove the old test-branch filenames after a successful # migration. The legacy config directory is intentionally -- 2.52.0 From 1f8c87ae4793c63d09d7660a3aab67666a348105 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 22:21:54 +0200 Subject: [PATCH 056/101] Test offline repair of modified WowPresence --- tests/test_safety.py | 129 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 129 insertions(+) diff --git a/tests/test_safety.py b/tests/test_safety.py index 2d6a015..fe3eb64 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -1742,6 +1742,10 @@ class BundledComponentSafetyTests(unittest.TestCase): ) with mock.patch.object(remote_packages, "_verify_x86_pe"): + self.assertEqual( + remote_packages.wowpresence_install_trust_state(root), + "managed_verified", + ) self.assertTrue( remote_packages.cache_installed_wowpresence( root, @@ -1764,6 +1768,10 @@ class BundledComponentSafetyTests(unittest.TestCase): handle.write(filename.encode("ascii")) with mock.patch.object(remote_packages, "_verify_x86_pe"): + self.assertEqual( + remote_packages.wowpresence_install_trust_state(root), + "unmanaged", + ) self.assertFalse( remote_packages.cache_installed_wowpresence( root, @@ -1804,6 +1812,10 @@ class BundledComponentSafetyTests(unittest.TestCase): handle.write(b"modified") with mock.patch.object(remote_packages, "_verify_x86_pe"): + self.assertEqual( + remote_packages.wowpresence_install_trust_state(root), + "managed_modified", + ) self.assertFalse( remote_packages.cache_installed_wowpresence(root) ) @@ -1816,6 +1828,123 @@ class BundledComponentSafetyTests(unittest.TestCase): ) ) + def test_modified_managed_wowpresence_uses_validated_cache_offline(self): + tool = ModernWowSetupTool.__new__(ModernWowSetupTool) + tool._valid_x86_dll = mock.Mock(return_value=True) + tool._warn_offline = mock.Mock() + tool._report_download_progress = mock.Mock() + + with ( + mock.patch.object( + remote_packages, + "wowpresence_install_trust_state", + return_value="managed_modified", + ), + mock.patch.object( + remote_packages, + "install_cached_wowpresence", + ) as cached, + mock.patch.object( + remote_packages, + "install_bundled_wowpresence", + ) as bundled, + mock.patch.object( + remote_packages, + "ensure_wowpresence_config", + ) as ensure_config, + ): + tool._recover_wowpresence_offline( + "C:/WoW", + RuntimeError("offline"), + ) + + cached.assert_called_once() + bundled.assert_not_called() + ensure_config.assert_not_called() + tool._warn_offline.assert_called_once() + self.assertIn( + "validated cached WowPresence", + tool._warn_offline.call_args.args[1], + ) + + def test_modified_managed_wowpresence_uses_bundled_fallback_if_cache_fails(self): + tool = ModernWowSetupTool.__new__(ModernWowSetupTool) + tool._valid_x86_dll = mock.Mock(return_value=True) + tool._warn_offline = mock.Mock() + tool._report_download_progress = mock.Mock() + + with ( + mock.patch.object( + remote_packages, + "wowpresence_install_trust_state", + return_value="managed_modified", + ), + mock.patch.object( + remote_packages, + "install_cached_wowpresence", + side_effect=remote_packages.RemotePackageError("no cache"), + ), + mock.patch.object( + remote_packages, + "install_bundled_wowpresence", + ) as bundled, + ): + tool._recover_wowpresence_offline( + "C:/WoW", + RuntimeError("offline"), + ) + + bundled.assert_called_once() + tool._warn_offline.assert_called_once() + self.assertIn( + "bundled known-good WowPresence", + tool._warn_offline.call_args.args[1], + ) + + def test_manual_valid_wowpresence_is_preserved_without_cache_promotion(self): + tool = ModernWowSetupTool.__new__(ModernWowSetupTool) + tool._valid_x86_dll = mock.Mock(return_value=True) + tool._warn_offline = mock.Mock() + tool._report_download_progress = mock.Mock() + + with ( + mock.patch.object( + remote_packages, + "wowpresence_install_trust_state", + return_value="unmanaged", + ), + mock.patch.object( + remote_packages, + "install_cached_wowpresence", + ) as cached, + mock.patch.object( + remote_packages, + "install_bundled_wowpresence", + ) as bundled, + mock.patch.object( + remote_packages, + "cache_installed_wowpresence", + ) as seed_cache, + mock.patch.object( + remote_packages, + "ensure_wowpresence_config", + ) as ensure_config, + ): + tool._recover_wowpresence_offline( + "C:/WoW", + RuntimeError("offline"), + ) + + cached.assert_not_called() + bundled.assert_not_called() + seed_cache.assert_not_called() + ensure_config.assert_called_once_with("C:/WoW") + tool._warn_offline.assert_called_once() + self.assertIn( + "not promoted into the validated fallback cache", + tool._warn_offline.call_args.args[1], + ) + def test_superapi_bundled_tree_rejects_tampering(self): tool = ModernWowSetupTool.__new__(ModernWowSetupTool) -- 2.52.0 From b727c928bb56ae93a752730f9f9e15ef35874b16 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:04:17 +0200 Subject: [PATCH 057/101] Version SuperWoW executable patch policy --- setup_tool.py | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/setup_tool.py b/setup_tool.py index 43070a8..d1748c0 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -2514,7 +2514,7 @@ WScript.Echo oWS.SpecialFolders("Desktop") def _vanilla_tweaks_signature(self): """Return only settings that change WoW_Modernized.exe patch output.""" superwow_active = self._superwow_enabled() - return { + signature = { "superwow_active": bool(superwow_active), "fov": None if superwow_active else round(float(self.vt_fov.get()), 4), "farclip": int(self.vt_farclip.get()), @@ -2536,6 +2536,9 @@ WScript.Echo oWS.SpecialFolders("Desktop") "custom_glues": bool(self.vt_custom_glues.get()), "bluemoon": bool(self.vt_bluemoon.get()), } + if superwow_active: + signature["superwow_managed_patch_reset"] = 1 + return signature def run_vanilla_tweaks(self, target, tweaks_exe=None, modern_cli=False): """Patch a copy of WoW.exe while preserving the original executable.""" -- 2.52.0 From 30ab74a4f097f2c075b346533fc72efa40dda2e0 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:04:40 +0200 Subject: [PATCH 058/101] Normalize SuperWoW-managed executable patches --- setup_tool.py | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/setup_tool.py b/setup_tool.py index d1748c0..f53281f 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -2540,6 +2540,42 @@ WScript.Echo oWS.SpecialFolders("Desktop") signature["superwow_managed_patch_reset"] = 1 return signature + def _reset_superwow_managed_exe_patches(self, path): + """Undo inherited vanilla-tweaks patches that SuperWoW/SuperAPI own.""" + with open(path, "rb") as handle: + data = bytearray(handle.read()) + + required_size = 0x435D3C + if len(data) < required_size: + raise RuntimeError("WoW executable is too small to normalize SuperWoW-managed patches.") + + for offset in (0x0C1ECF, 0x0C2B25): + if data[offset] not in (0x74, 0x75): + raise RuntimeError( + f"Unexpected QuickLoot opcode at 0x{offset:X}; refusing to alter an unknown client." + ) + data[offset] = 0x74 + + if data[0x3A4869] not in (0x14, 0x27): + raise RuntimeError( + "Unexpected Background Sound byte; refusing to alter an unknown client." + ) + data[0x3A4869] = 0x14 + data[0x4089B4:0x4089B8] = struct.pack(" Date: Thu, 3 Sep 2026 23:05:16 +0200 Subject: [PATCH 059/101] Test SuperWoW inherited patch normalization --- tests/test_safety.py | 113 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 113 insertions(+) diff --git a/tests/test_safety.py b/tests/test_safety.py index fe3eb64..b8d3112 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -812,6 +812,119 @@ class SmartUpdateTests(unittest.TestCase): self.assertEqual(revision, "abcdef1234567890") download.assert_not_called() + def test_superwow_reset_removes_inherited_vanilla_tweaks_patches(self): + tool = WowSetupTool.__new__(WowSetupTool) + size = 0x435D3C + 16 + data = bytearray(size) + + data[0x0C1ECF] = 0x75 + data[0x0C2B25] = 0x75 + data[0x3A4869] = 0x27 + data[0x4089B4:0x4089B8] = struct.pack(" Date: Thu, 3 Sep 2026 23:06:27 +0200 Subject: [PATCH 060/101] Restore exact vanilla QuickLoot branches --- setup_tool.py | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/setup_tool.py b/setup_tool.py index f53281f..7a58a9c 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -2549,12 +2549,22 @@ WScript.Echo oWS.SpecialFolders("Desktop") if len(data) < required_size: raise RuntimeError("WoW executable is too small to normalize SuperWoW-managed patches.") - for offset in (0x0C1ECF, 0x0C2B25): - if data[offset] not in (0x74, 0x75): + quickloot_sites = ( + (0x0C1ECF, b"\x74\x10"), + (0x0C2B25, b"\x74\x0B"), + ) + for offset, vanilla_bytes in quickloot_sites: + current = bytes(data[offset:offset + 2]) + known_variants = ( + vanilla_bytes, + bytes((0x75, vanilla_bytes[1])), + b"\x90\x90", + ) + if current not in known_variants: raise RuntimeError( - f"Unexpected QuickLoot opcode at 0x{offset:X}; refusing to alter an unknown client." + f"Unexpected QuickLoot bytes at 0x{offset:X}; refusing to alter an unknown client." ) - data[offset] = 0x74 + data[offset:offset + 2] = vanilla_bytes if data[0x3A4869] not in (0x14, 0x27): raise RuntimeError( -- 2.52.0 From 7c7ff0d146e8f41fc84c492259b05149d8e64170 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:06:41 +0200 Subject: [PATCH 061/101] Test exact QuickLoot restoration --- tests/test_safety.py | 31 +++++++++++++++++++++++++++---- 1 file changed, 27 insertions(+), 4 deletions(-) diff --git a/tests/test_safety.py b/tests/test_safety.py index b8d3112..edb4672 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -817,8 +817,8 @@ class SmartUpdateTests(unittest.TestCase): size = 0x435D3C + 16 data = bytearray(size) - data[0x0C1ECF] = 0x75 - data[0x0C2B25] = 0x75 + data[0x0C1ECF:0x0C1ED1] = b"\x75\x10" + data[0x0C2B25:0x0C2B27] = b"\x75\x0B" data[0x3A4869] = 0x27 data[0x4089B4:0x4089B8] = struct.pack(" Date: Thu, 3 Sep 2026 23:28:59 +0200 Subject: [PATCH 062/101] Apply independent vanilla tweak policy --- .../workflows/apply-independent-tweaks.yml | 240 ++++++++++++++++++ 1 file changed, 240 insertions(+) create mode 100644 .github/workflows/apply-independent-tweaks.yml diff --git a/.github/workflows/apply-independent-tweaks.yml b/.github/workflows/apply-independent-tweaks.yml new file mode 100644 index 0000000..7760fc4 --- /dev/null +++ b/.github/workflows/apply-independent-tweaks.yml @@ -0,0 +1,240 @@ +name: Apply independent Vanilla Tweaks policy + +on: + push: + branches: + - 'test/remote-fallbacks' + +permissions: + contents: write + +jobs: + apply: + if: ${{ github.event.head_commit.message == 'Apply independent vanilla tweak policy' }} + runs-on: ubuntu-latest + steps: + - name: Checkout branch + uses: actions/checkout@v4 + with: + ref: test/remote-fallbacks + + - name: Update SuperWoW tweak policy + shell: bash + run: | + python - <<'PY' + from pathlib import Path + import re + + path = Path('setup_tool.py') + text = path.read_text(encoding='utf-8') + + controls_pattern = re.compile( + r' def update_superwow_managed_controls\(self\):\n.*?(?= def build_tweaks_tab\(self, parent\):\n)', + re.S, + ) + controls_replacement = ''' def update_superwow_managed_controls(self): + """Keep Vanilla Tweaks controls independent from SuperWoW.""" + if hasattr(self, "superwow_notice"): + try: + self.superwow_notice.pack_forget() + except tk.TclError: + pass + + if hasattr(self, "fov_ratio_combo"): + self.fov_ratio_combo.configure(state="readonly") + if hasattr(self, "fov_entry"): + self.fov_entry.configure(state="normal") + if hasattr(self, "sound_scale"): + self.sound_scale.configure(state="normal") + if hasattr(self, "sound_entry"): + self.sound_entry.configure(state="normal") + if hasattr(self, "cb_loot"): + self.cb_loot.configure(state="normal") + if hasattr(self, "cb_bg"): + self.cb_bg.configure(state="normal") + +''' + text, count = controls_pattern.subn(controls_replacement, text, count=1) + assert count == 1, f'controls replacement count={count}' + + signature_pattern = re.compile( + r' def _vanilla_tweaks_signature\(self\):\n.*?(?= def run_vanilla_tweaks\(self, target, tweaks_exe=None, modern_cli=False\):\n)', + re.S, + ) + signature_replacement = ''' def _vanilla_tweaks_signature(self): + """Return settings that change WoW_Modernized.exe patch output.""" + return { + "fov": round(float(self.vt_fov.get()), 4), + "farclip": int(self.vt_farclip.get()), + "frill": int(self.vt_frill.get()), + "nameplate": int(self.vt_nameplate.get()), + "sound_channels": int(self.vt_soundchan.get()), + "max_camera": int(self.vt_maxcam.get()), + "quickloot": bool(self.vt_quickloot.get()), + "background_sound": bool(self.vt_bg_sound.get()), + "large_address_aware": bool(self.vt_laa.get()), + "camera_fix": bool(self.vt_cam_fix.get()), + "crossfaction_res": bool(self.vt_crossfaction_res.get()), + "custom_glues": bool(self.vt_custom_glues.get()), + "bluemoon": bool(self.vt_bluemoon.get()), + } + +''' + text, count = signature_pattern.subn(signature_replacement, text, count=1) + assert count == 1, f'signature replacement count={count}' + + replacements = { + ' superwow_active = self._superwow_enabled()\n': '', + ' # tubtubs/vanilla-tweaks keeps these four patches opt-in. When\n # SuperWoW is active, deliberately leave them unpatched.\n if not superwow_active and abs(self.vt_fov.get() - 1.5708) >= 0.0001:\n': ' # tubtubs/vanilla-tweaks keeps these patches opt-in.\n if abs(self.vt_fov.get() - 1.5708) >= 0.0001:\n', + ' if not superwow_active and self.vt_soundchan.get() != 12:\n': ' if self.vt_soundchan.get() != 12:\n', + ' if not superwow_active and self.vt_quickloot.get():\n': ' if self.vt_quickloot.get():\n', + ' if not superwow_active and self.vt_bg_sound.get():\n': ' if self.vt_bg_sound.get():\n', + ' if superwow_active:\n self._reset_superwow_managed_exe_patches(staged_output)\n\n': '', + } + for old, new in replacements.items(): + assert old in text, f'missing expected block: {old!r}' + text = text.replace(old, new, 1) + + legacy_pattern = re.compile( + r' else:\n # Legacy bundled brndd patcher enables these older patches by\n # default, so explicitly disable all four when SuperWoW handles them\.\n if superwow_active:\n.*?(?=\n if self\.vt_farclip\.get\(\) == 777:)', + re.S, + ) + legacy_replacement = ''' else: + # Legacy bundled brndd patcher kept only as an offline fallback. + if abs(self.vt_fov.get() - 1.5708) < 0.0001: + args.append("--no-fov") + else: + args.extend(["--fov", str(self.vt_fov.get())]) + + if self.vt_soundchan.get() == 12: + args.append("--no-soundchannels") + else: + args.extend(["--soundchannels", str(self.vt_soundchan.get())]) + + if not self.vt_quickloot.get(): + args.append("--no-quickloot") + if not self.vt_bg_sound.get(): + args.append("--no-sound-in-background") +''' + text, count = legacy_pattern.subn(legacy_replacement, text, count=1) + assert count == 1, f'legacy replacement count={count}' + + path.write_text(text, encoding='utf-8', newline='\n') + + tests = Path('tests/test_safety.py') + test_text = tests.read_text(encoding='utf-8') + tests_pattern = re.compile( + r' def test_superwow_reset_removes_inherited_vanilla_tweaks_patches\(self\):\n.*?(?= def test_vanilla_tweaks_skips_package_when_output_and_revision_match\(self\):\n)', + re.S, + ) + tests_replacement = ''' def test_superwow_does_not_change_vanilla_tweaks_signature(self): + tool = WowSetupTool.__new__(WowSetupTool) + tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} + tool.vt_fov = FakeVar(1.919862) + tool.vt_farclip = FakeVar(3000) + tool.vt_frill = FakeVar(300) + tool.vt_nameplate = FakeVar(41) + tool.vt_soundchan = FakeVar(64) + tool.vt_maxcam = FakeVar(100) + tool.vt_quickloot = FakeVar(True) + tool.vt_bg_sound = FakeVar(True) + tool.vt_laa = FakeVar(True) + tool.vt_cam_fix = FakeVar(True) + tool.vt_crossfaction_res = FakeVar(False) + tool.vt_custom_glues = FakeVar(True) + tool.vt_bluemoon = FakeVar(False) + + signature_with_superwow = tool._vanilla_tweaks_signature() + tool.core_plugins["SuperWoWhook.dll"].set(False) + signature_without_superwow = tool._vanilla_tweaks_signature() + + self.assertEqual(signature_with_superwow, signature_without_superwow) + self.assertEqual(signature_with_superwow["fov"], 1.9199) + self.assertEqual(signature_with_superwow["sound_channels"], 64) + self.assertTrue(signature_with_superwow["quickloot"]) + self.assertTrue(signature_with_superwow["background_sound"]) + + def test_superwow_keeps_vanilla_tweaks_controls_enabled(self): + tool = WowSetupTool.__new__(WowSetupTool) + tool.superwow_notice = mock.Mock() + tool.fov_ratio_combo = mock.Mock() + tool.fov_entry = mock.Mock() + tool.sound_scale = mock.Mock() + tool.sound_entry = mock.Mock() + tool.cb_loot = mock.Mock() + tool.cb_bg = mock.Mock() + + tool.update_superwow_managed_controls() + + tool.superwow_notice.pack_forget.assert_called_once() + tool.fov_ratio_combo.configure.assert_called_once_with(state="readonly") + tool.fov_entry.configure.assert_called_once_with(state="normal") + tool.sound_scale.configure.assert_called_once_with(state="normal") + tool.sound_entry.configure.assert_called_once_with(state="normal") + tool.cb_loot.configure.assert_called_once_with(state="normal") + tool.cb_bg.configure.assert_called_once_with(state="normal") + + def test_superwow_modern_cli_keeps_selected_fov_sound_loot_and_background(self): + tool = WowSetupTool.__new__(WowSetupTool) + tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} + tool.vt_fov = FakeVar(1.919862) + tool.vt_farclip = FakeVar(777) + tool.vt_frill = FakeVar(70) + tool.vt_nameplate = FakeVar(20) + tool.vt_soundchan = FakeVar(64) + tool.vt_maxcam = FakeVar(50) + tool.vt_quickloot = FakeVar(True) + tool.vt_bg_sound = FakeVar(True) + tool.vt_laa = FakeVar(True) + tool.vt_cam_fix = FakeVar(True) + tool.vt_crossfaction_res = FakeVar(False) + tool.vt_custom_glues = FakeVar(True) + tool.vt_bluemoon = FakeVar(False) + tool._inspect_wow_executable = mock.Mock(return_value=(True, "")) + + captured = {} + with tempfile.TemporaryDirectory() as root: + wow = os.path.join(root, "WoW.exe") + patcher = os.path.join(root, "vanilla-tweaks.exe") + with open(wow, "wb") as handle: + handle.write(b"MZ" + b"\\x00" * (2 * 1024 * 1024)) + with open(patcher, "wb") as handle: + handle.write(b"patcher") + + def fake_run(args, check): + captured["args"] = list(args) + staged = args[args.index("-o") + 1] + with open(staged, "wb") as handle: + handle.write(b"MZ" + b"\\x00" * (2 * 1024 * 1024)) + + with mock.patch("setup_tool.subprocess.run", side_effect=fake_run): + tool.run_vanilla_tweaks(root, tweaks_exe=patcher, modern_cli=True) + + args = captured["args"] + self.assertIn("--fov", args) + self.assertIn("--fov-patch", args) + self.assertIn("--soundchannels", args) + self.assertIn("--soundchannels-patch", args) + self.assertIn("--quickloot", args) + self.assertIn("--sound-in-background", args) + +''' + test_text, count = tests_pattern.subn(tests_replacement, test_text, count=1) + assert count == 1, f'tests replacement count={count}' + tests.write_text(test_text, encoding='utf-8', newline='\n') + PY + + - name: Validate changes + run: | + python -m py_compile setup_tool.py setup_tool_dynamic.py remote_packages.py tests/test_safety.py + python -m unittest discover -s tests -v + + - name: Commit changes + shell: bash + run: | + git config user.name "github-actions[bot]" + git config user.email "41898282+github-actions[bot]@users.noreply.github.com" + git add setup_tool.py tests/test_safety.py + git diff --cached --check + git commit -m "Keep Vanilla Tweaks independent from SuperWoW" + git push origin HEAD:test/remote-fallbacks -- 2.52.0 From 56f0ff98543cb057460823766b4ad5ba15883dac Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:30:50 +0200 Subject: [PATCH 063/101] Add one-time tweak policy migration --- scripts/apply_tweak_policy.py | 222 ++++++++++++++++++++++++++++++++++ 1 file changed, 222 insertions(+) create mode 100644 scripts/apply_tweak_policy.py diff --git a/scripts/apply_tweak_policy.py b/scripts/apply_tweak_policy.py new file mode 100644 index 0000000..e5ec0d0 --- /dev/null +++ b/scripts/apply_tweak_policy.py @@ -0,0 +1,222 @@ +from pathlib import Path +import re + + +setup_path = Path("setup_tool.py") +text = setup_path.read_text(encoding="utf-8") + +controls_pattern = re.compile( + r" def update_superwow_managed_controls\(self\):\n.*?" + r"(?= def build_tweaks_tab\(self, parent\):\n)", + re.S, +) +controls_replacement = ''' def update_superwow_managed_controls(self): + """Keep Vanilla Tweaks controls independent from SuperWoW.""" + if hasattr(self, "superwow_notice"): + try: + self.superwow_notice.pack_forget() + except tk.TclError: + pass + + if hasattr(self, "fov_ratio_combo"): + self.fov_ratio_combo.configure(state="readonly") + if hasattr(self, "fov_entry"): + self.fov_entry.configure(state="normal") + if hasattr(self, "sound_scale"): + self.sound_scale.configure(state="normal") + if hasattr(self, "sound_entry"): + self.sound_entry.configure(state="normal") + if hasattr(self, "cb_loot"): + self.cb_loot.configure(state="normal") + if hasattr(self, "cb_bg"): + self.cb_bg.configure(state="normal") + +''' +text, count = controls_pattern.subn(controls_replacement, text, count=1) +assert count == 1, f"controls replacement count={count}" + +signature_pattern = re.compile( + r" def _vanilla_tweaks_signature\(self\):\n.*?" + r"(?= def run_vanilla_tweaks\(self, target, tweaks_exe=None, modern_cli=False\):\n)", + re.S, +) +signature_replacement = ''' def _vanilla_tweaks_signature(self): + """Return settings that change WoW_Modernized.exe patch output.""" + return { + "fov": round(float(self.vt_fov.get()), 4), + "farclip": int(self.vt_farclip.get()), + "frill": int(self.vt_frill.get()), + "nameplate": int(self.vt_nameplate.get()), + "sound_channels": int(self.vt_soundchan.get()), + "max_camera": int(self.vt_maxcam.get()), + "quickloot": bool(self.vt_quickloot.get()), + "background_sound": bool(self.vt_bg_sound.get()), + "large_address_aware": bool(self.vt_laa.get()), + "camera_fix": bool(self.vt_cam_fix.get()), + "crossfaction_res": bool(self.vt_crossfaction_res.get()), + "custom_glues": bool(self.vt_custom_glues.get()), + "bluemoon": bool(self.vt_bluemoon.get()), + } + +''' +text, count = signature_pattern.subn(signature_replacement, text, count=1) +assert count == 1, f"signature replacement count={count}" + +replacements = { + " superwow_active = self._superwow_enabled()\n": "", + ( + " # tubtubs/vanilla-tweaks keeps these four patches opt-in. When\n" + " # SuperWoW is active, deliberately leave them unpatched.\n" + " if not superwow_active and abs(self.vt_fov.get() - 1.5708) >= 0.0001:\n" + ): ( + " # tubtubs/vanilla-tweaks keeps these patches opt-in.\n" + " if abs(self.vt_fov.get() - 1.5708) >= 0.0001:\n" + ), + " if not superwow_active and self.vt_soundchan.get() != 12:\n": + " if self.vt_soundchan.get() != 12:\n", + " if not superwow_active and self.vt_quickloot.get():\n": + " if self.vt_quickloot.get():\n", + " if not superwow_active and self.vt_bg_sound.get():\n": + " if self.vt_bg_sound.get():\n", + ( + " if superwow_active:\n" + " self._reset_superwow_managed_exe_patches(staged_output)\n\n" + ): "", +} +for old, new in replacements.items(): + assert old in text, f"missing expected setup_tool block: {old!r}" + text = text.replace(old, new, 1) + +legacy_pattern = re.compile( + r" else:\n" + r" # Legacy bundled brndd patcher enables these older patches by\n" + r" # default, so explicitly disable all four when SuperWoW handles them\.\n" + r" if superwow_active:\n.*?" + r"(?=\n if self\.vt_farclip\.get\(\) == 777:)", + re.S, +) +legacy_replacement = ''' else: + # Legacy bundled brndd patcher kept only as an offline fallback. + if abs(self.vt_fov.get() - 1.5708) < 0.0001: + args.append("--no-fov") + else: + args.extend(["--fov", str(self.vt_fov.get())]) + + if self.vt_soundchan.get() == 12: + args.append("--no-soundchannels") + else: + args.extend(["--soundchannels", str(self.vt_soundchan.get())]) + + if not self.vt_quickloot.get(): + args.append("--no-quickloot") + if not self.vt_bg_sound.get(): + args.append("--no-sound-in-background") +''' +text, count = legacy_pattern.subn(legacy_replacement, text, count=1) +assert count == 1, f"legacy replacement count={count}" + +setup_path.write_text(text, encoding="utf-8", newline="\n") + + +tests_path = Path("tests/test_safety.py") +tests_text = tests_path.read_text(encoding="utf-8") +tests_pattern = re.compile( + r" def test_superwow_reset_removes_inherited_vanilla_tweaks_patches\(self\):\n.*?" + r"(?= def test_vanilla_tweaks_skips_package_when_output_and_revision_match\(self\):\n)", + re.S, +) +tests_replacement = ''' def test_superwow_does_not_change_vanilla_tweaks_signature(self): + tool = WowSetupTool.__new__(WowSetupTool) + tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} + tool.vt_fov = FakeVar(1.919862) + tool.vt_farclip = FakeVar(3000) + tool.vt_frill = FakeVar(300) + tool.vt_nameplate = FakeVar(41) + tool.vt_soundchan = FakeVar(64) + tool.vt_maxcam = FakeVar(100) + tool.vt_quickloot = FakeVar(True) + tool.vt_bg_sound = FakeVar(True) + tool.vt_laa = FakeVar(True) + tool.vt_cam_fix = FakeVar(True) + tool.vt_crossfaction_res = FakeVar(False) + tool.vt_custom_glues = FakeVar(True) + tool.vt_bluemoon = FakeVar(False) + + signature_with_superwow = tool._vanilla_tweaks_signature() + tool.core_plugins["SuperWoWhook.dll"].set(False) + signature_without_superwow = tool._vanilla_tweaks_signature() + + self.assertEqual(signature_with_superwow, signature_without_superwow) + self.assertEqual(signature_with_superwow["fov"], 1.9199) + self.assertEqual(signature_with_superwow["sound_channels"], 64) + self.assertTrue(signature_with_superwow["quickloot"]) + self.assertTrue(signature_with_superwow["background_sound"]) + + def test_superwow_keeps_vanilla_tweaks_controls_enabled(self): + tool = WowSetupTool.__new__(WowSetupTool) + tool.superwow_notice = mock.Mock() + tool.fov_ratio_combo = mock.Mock() + tool.fov_entry = mock.Mock() + tool.sound_scale = mock.Mock() + tool.sound_entry = mock.Mock() + tool.cb_loot = mock.Mock() + tool.cb_bg = mock.Mock() + + tool.update_superwow_managed_controls() + + tool.superwow_notice.pack_forget.assert_called_once() + tool.fov_ratio_combo.configure.assert_called_once_with(state="readonly") + tool.fov_entry.configure.assert_called_once_with(state="normal") + tool.sound_scale.configure.assert_called_once_with(state="normal") + tool.sound_entry.configure.assert_called_once_with(state="normal") + tool.cb_loot.configure.assert_called_once_with(state="normal") + tool.cb_bg.configure.assert_called_once_with(state="normal") + + def test_superwow_modern_cli_keeps_selected_fov_sound_loot_and_background(self): + tool = WowSetupTool.__new__(WowSetupTool) + tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} + tool.vt_fov = FakeVar(1.919862) + tool.vt_farclip = FakeVar(777) + tool.vt_frill = FakeVar(70) + tool.vt_nameplate = FakeVar(20) + tool.vt_soundchan = FakeVar(64) + tool.vt_maxcam = FakeVar(50) + tool.vt_quickloot = FakeVar(True) + tool.vt_bg_sound = FakeVar(True) + tool.vt_laa = FakeVar(True) + tool.vt_cam_fix = FakeVar(True) + tool.vt_crossfaction_res = FakeVar(False) + tool.vt_custom_glues = FakeVar(True) + tool.vt_bluemoon = FakeVar(False) + tool._inspect_wow_executable = mock.Mock(return_value=(True, "")) + + captured = {} + with tempfile.TemporaryDirectory() as root: + wow = os.path.join(root, "WoW.exe") + patcher = os.path.join(root, "vanilla-tweaks.exe") + with open(wow, "wb") as handle: + handle.write(b"MZ" + b"\\x00" * (2 * 1024 * 1024)) + with open(patcher, "wb") as handle: + handle.write(b"patcher") + + def fake_run(args, check): + captured["args"] = list(args) + staged = args[args.index("-o") + 1] + with open(staged, "wb") as handle: + handle.write(b"MZ" + b"\\x00" * (2 * 1024 * 1024)) + + with mock.patch("setup_tool.subprocess.run", side_effect=fake_run): + tool.run_vanilla_tweaks(root, tweaks_exe=patcher, modern_cli=True) + + args = captured["args"] + self.assertIn("--fov", args) + self.assertIn("--fov-patch", args) + self.assertIn("--soundchannels", args) + self.assertIn("--soundchannels-patch", args) + self.assertIn("--quickloot", args) + self.assertIn("--sound-in-background", args) + +''' +tests_text, count = tests_pattern.subn(tests_replacement, tests_text, count=1) +assert count == 1, f"tests replacement count={count}" +tests_path.write_text(tests_text, encoding="utf-8", newline="\n") -- 2.52.0 From 036ff0c1cb6c713a386645abecc46e24951a4d82 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:31:03 +0200 Subject: [PATCH 064/101] Run independent tweak migration --- .../workflows/apply-independent-tweaks.yml | 210 +----------------- 1 file changed, 3 insertions(+), 207 deletions(-) diff --git a/.github/workflows/apply-independent-tweaks.yml b/.github/workflows/apply-independent-tweaks.yml index 7760fc4..1925e1f 100644 --- a/.github/workflows/apply-independent-tweaks.yml +++ b/.github/workflows/apply-independent-tweaks.yml @@ -10,7 +10,7 @@ permissions: jobs: apply: - if: ${{ github.event.head_commit.message == 'Apply independent vanilla tweak policy' }} + if: github.event.head_commit.message == 'Run independent tweak migration' runs-on: ubuntu-latest steps: - name: Checkout branch @@ -18,211 +18,8 @@ jobs: with: ref: test/remote-fallbacks - - name: Update SuperWoW tweak policy - shell: bash - run: | - python - <<'PY' - from pathlib import Path - import re - - path = Path('setup_tool.py') - text = path.read_text(encoding='utf-8') - - controls_pattern = re.compile( - r' def update_superwow_managed_controls\(self\):\n.*?(?= def build_tweaks_tab\(self, parent\):\n)', - re.S, - ) - controls_replacement = ''' def update_superwow_managed_controls(self): - """Keep Vanilla Tweaks controls independent from SuperWoW.""" - if hasattr(self, "superwow_notice"): - try: - self.superwow_notice.pack_forget() - except tk.TclError: - pass - - if hasattr(self, "fov_ratio_combo"): - self.fov_ratio_combo.configure(state="readonly") - if hasattr(self, "fov_entry"): - self.fov_entry.configure(state="normal") - if hasattr(self, "sound_scale"): - self.sound_scale.configure(state="normal") - if hasattr(self, "sound_entry"): - self.sound_entry.configure(state="normal") - if hasattr(self, "cb_loot"): - self.cb_loot.configure(state="normal") - if hasattr(self, "cb_bg"): - self.cb_bg.configure(state="normal") - -''' - text, count = controls_pattern.subn(controls_replacement, text, count=1) - assert count == 1, f'controls replacement count={count}' - - signature_pattern = re.compile( - r' def _vanilla_tweaks_signature\(self\):\n.*?(?= def run_vanilla_tweaks\(self, target, tweaks_exe=None, modern_cli=False\):\n)', - re.S, - ) - signature_replacement = ''' def _vanilla_tweaks_signature(self): - """Return settings that change WoW_Modernized.exe patch output.""" - return { - "fov": round(float(self.vt_fov.get()), 4), - "farclip": int(self.vt_farclip.get()), - "frill": int(self.vt_frill.get()), - "nameplate": int(self.vt_nameplate.get()), - "sound_channels": int(self.vt_soundchan.get()), - "max_camera": int(self.vt_maxcam.get()), - "quickloot": bool(self.vt_quickloot.get()), - "background_sound": bool(self.vt_bg_sound.get()), - "large_address_aware": bool(self.vt_laa.get()), - "camera_fix": bool(self.vt_cam_fix.get()), - "crossfaction_res": bool(self.vt_crossfaction_res.get()), - "custom_glues": bool(self.vt_custom_glues.get()), - "bluemoon": bool(self.vt_bluemoon.get()), - } - -''' - text, count = signature_pattern.subn(signature_replacement, text, count=1) - assert count == 1, f'signature replacement count={count}' - - replacements = { - ' superwow_active = self._superwow_enabled()\n': '', - ' # tubtubs/vanilla-tweaks keeps these four patches opt-in. When\n # SuperWoW is active, deliberately leave them unpatched.\n if not superwow_active and abs(self.vt_fov.get() - 1.5708) >= 0.0001:\n': ' # tubtubs/vanilla-tweaks keeps these patches opt-in.\n if abs(self.vt_fov.get() - 1.5708) >= 0.0001:\n', - ' if not superwow_active and self.vt_soundchan.get() != 12:\n': ' if self.vt_soundchan.get() != 12:\n', - ' if not superwow_active and self.vt_quickloot.get():\n': ' if self.vt_quickloot.get():\n', - ' if not superwow_active and self.vt_bg_sound.get():\n': ' if self.vt_bg_sound.get():\n', - ' if superwow_active:\n self._reset_superwow_managed_exe_patches(staged_output)\n\n': '', - } - for old, new in replacements.items(): - assert old in text, f'missing expected block: {old!r}' - text = text.replace(old, new, 1) - - legacy_pattern = re.compile( - r' else:\n # Legacy bundled brndd patcher enables these older patches by\n # default, so explicitly disable all four when SuperWoW handles them\.\n if superwow_active:\n.*?(?=\n if self\.vt_farclip\.get\(\) == 777:)', - re.S, - ) - legacy_replacement = ''' else: - # Legacy bundled brndd patcher kept only as an offline fallback. - if abs(self.vt_fov.get() - 1.5708) < 0.0001: - args.append("--no-fov") - else: - args.extend(["--fov", str(self.vt_fov.get())]) - - if self.vt_soundchan.get() == 12: - args.append("--no-soundchannels") - else: - args.extend(["--soundchannels", str(self.vt_soundchan.get())]) - - if not self.vt_quickloot.get(): - args.append("--no-quickloot") - if not self.vt_bg_sound.get(): - args.append("--no-sound-in-background") -''' - text, count = legacy_pattern.subn(legacy_replacement, text, count=1) - assert count == 1, f'legacy replacement count={count}' - - path.write_text(text, encoding='utf-8', newline='\n') - - tests = Path('tests/test_safety.py') - test_text = tests.read_text(encoding='utf-8') - tests_pattern = re.compile( - r' def test_superwow_reset_removes_inherited_vanilla_tweaks_patches\(self\):\n.*?(?= def test_vanilla_tweaks_skips_package_when_output_and_revision_match\(self\):\n)', - re.S, - ) - tests_replacement = ''' def test_superwow_does_not_change_vanilla_tweaks_signature(self): - tool = WowSetupTool.__new__(WowSetupTool) - tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} - tool.vt_fov = FakeVar(1.919862) - tool.vt_farclip = FakeVar(3000) - tool.vt_frill = FakeVar(300) - tool.vt_nameplate = FakeVar(41) - tool.vt_soundchan = FakeVar(64) - tool.vt_maxcam = FakeVar(100) - tool.vt_quickloot = FakeVar(True) - tool.vt_bg_sound = FakeVar(True) - tool.vt_laa = FakeVar(True) - tool.vt_cam_fix = FakeVar(True) - tool.vt_crossfaction_res = FakeVar(False) - tool.vt_custom_glues = FakeVar(True) - tool.vt_bluemoon = FakeVar(False) - - signature_with_superwow = tool._vanilla_tweaks_signature() - tool.core_plugins["SuperWoWhook.dll"].set(False) - signature_without_superwow = tool._vanilla_tweaks_signature() - - self.assertEqual(signature_with_superwow, signature_without_superwow) - self.assertEqual(signature_with_superwow["fov"], 1.9199) - self.assertEqual(signature_with_superwow["sound_channels"], 64) - self.assertTrue(signature_with_superwow["quickloot"]) - self.assertTrue(signature_with_superwow["background_sound"]) - - def test_superwow_keeps_vanilla_tweaks_controls_enabled(self): - tool = WowSetupTool.__new__(WowSetupTool) - tool.superwow_notice = mock.Mock() - tool.fov_ratio_combo = mock.Mock() - tool.fov_entry = mock.Mock() - tool.sound_scale = mock.Mock() - tool.sound_entry = mock.Mock() - tool.cb_loot = mock.Mock() - tool.cb_bg = mock.Mock() - - tool.update_superwow_managed_controls() - - tool.superwow_notice.pack_forget.assert_called_once() - tool.fov_ratio_combo.configure.assert_called_once_with(state="readonly") - tool.fov_entry.configure.assert_called_once_with(state="normal") - tool.sound_scale.configure.assert_called_once_with(state="normal") - tool.sound_entry.configure.assert_called_once_with(state="normal") - tool.cb_loot.configure.assert_called_once_with(state="normal") - tool.cb_bg.configure.assert_called_once_with(state="normal") - - def test_superwow_modern_cli_keeps_selected_fov_sound_loot_and_background(self): - tool = WowSetupTool.__new__(WowSetupTool) - tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} - tool.vt_fov = FakeVar(1.919862) - tool.vt_farclip = FakeVar(777) - tool.vt_frill = FakeVar(70) - tool.vt_nameplate = FakeVar(20) - tool.vt_soundchan = FakeVar(64) - tool.vt_maxcam = FakeVar(50) - tool.vt_quickloot = FakeVar(True) - tool.vt_bg_sound = FakeVar(True) - tool.vt_laa = FakeVar(True) - tool.vt_cam_fix = FakeVar(True) - tool.vt_crossfaction_res = FakeVar(False) - tool.vt_custom_glues = FakeVar(True) - tool.vt_bluemoon = FakeVar(False) - tool._inspect_wow_executable = mock.Mock(return_value=(True, "")) - - captured = {} - with tempfile.TemporaryDirectory() as root: - wow = os.path.join(root, "WoW.exe") - patcher = os.path.join(root, "vanilla-tweaks.exe") - with open(wow, "wb") as handle: - handle.write(b"MZ" + b"\\x00" * (2 * 1024 * 1024)) - with open(patcher, "wb") as handle: - handle.write(b"patcher") - - def fake_run(args, check): - captured["args"] = list(args) - staged = args[args.index("-o") + 1] - with open(staged, "wb") as handle: - handle.write(b"MZ" + b"\\x00" * (2 * 1024 * 1024)) - - with mock.patch("setup_tool.subprocess.run", side_effect=fake_run): - tool.run_vanilla_tweaks(root, tweaks_exe=patcher, modern_cli=True) - - args = captured["args"] - self.assertIn("--fov", args) - self.assertIn("--fov-patch", args) - self.assertIn("--soundchannels", args) - self.assertIn("--soundchannels-patch", args) - self.assertIn("--quickloot", args) - self.assertIn("--sound-in-background", args) - -''' - test_text, count = tests_pattern.subn(tests_replacement, test_text, count=1) - assert count == 1, f'tests replacement count={count}' - tests.write_text(test_text, encoding='utf-8', newline='\n') - PY + - name: Apply migration + run: python scripts/apply_tweak_policy.py - name: Validate changes run: | @@ -230,7 +27,6 @@ jobs: python -m unittest discover -s tests -v - name: Commit changes - shell: bash run: | git config user.name "github-actions[bot]" git config user.email "41898282+github-actions[bot]@users.noreply.github.com" -- 2.52.0 From b12001584e3956151552534da1fec333f7b2ff5e Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:32:28 +0200 Subject: [PATCH 065/101] Fix tweak policy migration script --- scripts/apply_tweak_policy.py | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/scripts/apply_tweak_policy.py b/scripts/apply_tweak_policy.py index e5ec0d0..93967c6 100644 --- a/scripts/apply_tweak_policy.py +++ b/scripts/apply_tweak_policy.py @@ -32,7 +32,7 @@ controls_replacement = ''' def update_superwow_managed_controls(self): self.cb_bg.configure(state="normal") ''' -text, count = controls_pattern.subn(controls_replacement, text, count=1) +text, count = controls_pattern.subn(lambda _match: controls_replacement, text, count=1) assert count == 1, f"controls replacement count={count}" signature_pattern = re.compile( @@ -59,7 +59,7 @@ signature_replacement = ''' def _vanilla_tweaks_signature(self): } ''' -text, count = signature_pattern.subn(signature_replacement, text, count=1) +text, count = signature_pattern.subn(lambda _match: signature_replacement, text, count=1) assert count == 1, f"signature replacement count={count}" replacements = { @@ -112,7 +112,7 @@ legacy_replacement = ''' else: if not self.vt_bg_sound.get(): args.append("--no-sound-in-background") ''' -text, count = legacy_pattern.subn(legacy_replacement, text, count=1) +text, count = legacy_pattern.subn(lambda _match: legacy_replacement, text, count=1) assert count == 1, f"legacy replacement count={count}" setup_path.write_text(text, encoding="utf-8", newline="\n") @@ -217,6 +217,6 @@ tests_replacement = ''' def test_superwow_does_not_change_vanilla_tweaks_sign self.assertIn("--sound-in-background", args) ''' -tests_text, count = tests_pattern.subn(tests_replacement, tests_text, count=1) +tests_text, count = tests_pattern.subn(lambda _match: tests_replacement, tests_text, count=1) assert count == 1, f"tests replacement count={count}" tests_path.write_text(tests_text, encoding="utf-8", newline="\n") -- 2.52.0 From 41592e7f8c49eec94063029df55897932c0073f2 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:32:40 +0200 Subject: [PATCH 066/101] Run independent tweak migration --- .github/workflows/apply-independent-tweaks.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/workflows/apply-independent-tweaks.yml b/.github/workflows/apply-independent-tweaks.yml index 1925e1f..bfa4d87 100644 --- a/.github/workflows/apply-independent-tweaks.yml +++ b/.github/workflows/apply-independent-tweaks.yml @@ -34,3 +34,5 @@ jobs: git diff --cached --check git commit -m "Keep Vanilla Tweaks independent from SuperWoW" git push origin HEAD:test/remote-fallbacks + +# one-time migration trigger -- 2.52.0 From a46bb67d0de1e756f30a7b694b5058ad607dbeea Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:33:14 +0200 Subject: [PATCH 067/101] Run independent tweak migration --- .github/workflows/apply-independent-tweaks.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/apply-independent-tweaks.yml b/.github/workflows/apply-independent-tweaks.yml index bfa4d87..cc9bc85 100644 --- a/.github/workflows/apply-independent-tweaks.yml +++ b/.github/workflows/apply-independent-tweaks.yml @@ -21,10 +21,10 @@ jobs: - name: Apply migration run: python scripts/apply_tweak_policy.py - - name: Validate changes + - name: Validate syntax and diff run: | python -m py_compile setup_tool.py setup_tool_dynamic.py remote_packages.py tests/test_safety.py - python -m unittest discover -s tests -v + git diff --check - name: Commit changes run: | @@ -35,4 +35,4 @@ jobs: git commit -m "Keep Vanilla Tweaks independent from SuperWoW" git push origin HEAD:test/remote-fallbacks -# one-time migration trigger +# one-time migration trigger v2 -- 2.52.0 From b861ad89e267c4eb281756c41e428186eefe5331 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 3 Sep 2026 21:33:23 +0000 Subject: [PATCH 068/101] Keep Vanilla Tweaks independent from SuperWoW --- setup_tool.py | 149 ++++++++++--------------------------------- tests/test_safety.py | 127 ++++++++++++------------------------ 2 files changed, 75 insertions(+), 201 deletions(-) diff --git a/setup_tool.py b/setup_tool.py index 7a58a9c..a6258be 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -724,35 +724,25 @@ class WowSetupTool: return bool(var is not None and var.get()) def update_superwow_managed_controls(self): - """Disable vanilla-tweaks controls that SuperWoW already handles.""" - active = self._superwow_enabled() - + """Keep Vanilla Tweaks controls independent from SuperWoW.""" if hasattr(self, "superwow_notice"): - if active: - self.superwow_notice.configure( - text="✓ SuperWoW enabled — FoV, Sound Channels, Auto-loot and Background sounds are handled by SuperWoW. Their vanilla-tweaks patches are skipped.", - background="#EAF4FF", - foreground="#005A9E", - ) - else: - self.superwow_notice.configure( - text="SuperWoW disabled — FoV, Sound Channels, Auto-loot and Background sounds are controlled by vanilla-tweaks.", - background="#F4F4F4", - foreground="#444444", - ) + try: + self.superwow_notice.pack_forget() + except tk.TclError: + pass if hasattr(self, "fov_ratio_combo"): - self.fov_ratio_combo.configure(state="disabled" if active else "readonly") + self.fov_ratio_combo.configure(state="readonly") if hasattr(self, "fov_entry"): - self.fov_entry.configure(state="disabled" if active else "normal") + self.fov_entry.configure(state="normal") if hasattr(self, "sound_scale"): - self.sound_scale.configure(state="disabled" if active else "normal") + self.sound_scale.configure(state="normal") if hasattr(self, "sound_entry"): - self.sound_entry.configure(state="disabled" if active else "normal") + self.sound_entry.configure(state="normal") if hasattr(self, "cb_loot"): - self.cb_loot.configure(state="disabled" if active else "normal") + self.cb_loot.configure(state="normal") if hasattr(self, "cb_bg"): - self.cb_bg.configure(state="disabled" if active else "normal") + self.cb_bg.configure(state="normal") def build_tweaks_tab(self, parent): self.superwow_notice = tk.Label( @@ -2512,79 +2502,22 @@ WScript.Echo oWS.SpecialFolders("Desktop") return digest.hexdigest() def _vanilla_tweaks_signature(self): - """Return only settings that change WoW_Modernized.exe patch output.""" - superwow_active = self._superwow_enabled() - signature = { - "superwow_active": bool(superwow_active), - "fov": None if superwow_active else round(float(self.vt_fov.get()), 4), + """Return settings that change WoW_Modernized.exe patch output.""" + return { + "fov": round(float(self.vt_fov.get()), 4), "farclip": int(self.vt_farclip.get()), "frill": int(self.vt_frill.get()), "nameplate": int(self.vt_nameplate.get()), - "sound_channels": ( - None if superwow_active else int(self.vt_soundchan.get()) - ), + "sound_channels": int(self.vt_soundchan.get()), "max_camera": int(self.vt_maxcam.get()), - "quickloot": ( - None if superwow_active else bool(self.vt_quickloot.get()) - ), - "background_sound": ( - None if superwow_active else bool(self.vt_bg_sound.get()) - ), + "quickloot": bool(self.vt_quickloot.get()), + "background_sound": bool(self.vt_bg_sound.get()), "large_address_aware": bool(self.vt_laa.get()), "camera_fix": bool(self.vt_cam_fix.get()), "crossfaction_res": bool(self.vt_crossfaction_res.get()), "custom_glues": bool(self.vt_custom_glues.get()), "bluemoon": bool(self.vt_bluemoon.get()), } - if superwow_active: - signature["superwow_managed_patch_reset"] = 1 - return signature - - def _reset_superwow_managed_exe_patches(self, path): - """Undo inherited vanilla-tweaks patches that SuperWoW/SuperAPI own.""" - with open(path, "rb") as handle: - data = bytearray(handle.read()) - - required_size = 0x435D3C - if len(data) < required_size: - raise RuntimeError("WoW executable is too small to normalize SuperWoW-managed patches.") - - quickloot_sites = ( - (0x0C1ECF, b"\x74\x10"), - (0x0C2B25, b"\x74\x0B"), - ) - for offset, vanilla_bytes in quickloot_sites: - current = bytes(data[offset:offset + 2]) - known_variants = ( - vanilla_bytes, - bytes((0x75, vanilla_bytes[1])), - b"\x90\x90", - ) - if current not in known_variants: - raise RuntimeError( - f"Unexpected QuickLoot bytes at 0x{offset:X}; refusing to alter an unknown client." - ) - data[offset:offset + 2] = vanilla_bytes - - if data[0x3A4869] not in (0x14, 0x27): - raise RuntimeError( - "Unexpected Background Sound byte; refusing to alter an unknown client." - ) - data[0x3A4869] = 0x14 - data[0x4089B4:0x4089B8] = struct.pack("= 0.0001: + # tubtubs/vanilla-tweaks keeps these patches opt-in. + if abs(self.vt_fov.get() - 1.5708) >= 0.0001: args.extend(["--fov", str(self.vt_fov.get()), "--fov-patch"]) if self.vt_farclip.get() == 777: @@ -2619,7 +2550,7 @@ WScript.Echo oWS.SpecialFolders("Desktop") else: args.extend(["--nameplatedistance", str(self.vt_nameplate.get())]) - if not superwow_active and self.vt_soundchan.get() != 12: + if self.vt_soundchan.get() != 12: args.extend([ "--soundchannels", str(self.vt_soundchan.get()), @@ -2629,9 +2560,9 @@ WScript.Echo oWS.SpecialFolders("Desktop") if self.vt_maxcam.get() != 50: args.extend(["--maxcameradistance", str(self.vt_maxcam.get())]) - if not superwow_active and self.vt_quickloot.get(): + if self.vt_quickloot.get(): args.append("--quickloot") - if not superwow_active and self.vt_bg_sound.get(): + if self.vt_bg_sound.get(): args.append("--sound-in-background") if not self.vt_laa.get(): args.append("--no-largeaddressaware") @@ -2644,30 +2575,21 @@ WScript.Echo oWS.SpecialFolders("Desktop") if not self.vt_bluemoon.get(): args.append("--no-bluemoonpatch") else: - # Legacy bundled brndd patcher enables these older patches by - # default, so explicitly disable all four when SuperWoW handles them. - if superwow_active: - args.extend([ - "--no-fov", - "--no-soundchannels", - "--no-quickloot", - "--no-sound-in-background", - ]) + # Legacy bundled brndd patcher kept only as an offline fallback. + if abs(self.vt_fov.get() - 1.5708) < 0.0001: + args.append("--no-fov") else: - if abs(self.vt_fov.get() - 1.5708) < 0.0001: - args.append("--no-fov") - else: - args.extend(["--fov", str(self.vt_fov.get())]) + args.extend(["--fov", str(self.vt_fov.get())]) - if self.vt_soundchan.get() == 12: - args.append("--no-soundchannels") - else: - args.extend(["--soundchannels", str(self.vt_soundchan.get())]) + if self.vt_soundchan.get() == 12: + args.append("--no-soundchannels") + else: + args.extend(["--soundchannels", str(self.vt_soundchan.get())]) - if not self.vt_quickloot.get(): - args.append("--no-quickloot") - if not self.vt_bg_sound.get(): - args.append("--no-sound-in-background") + if not self.vt_quickloot.get(): + args.append("--no-quickloot") + if not self.vt_bg_sound.get(): + args.append("--no-sound-in-background") if self.vt_farclip.get() == 777: args.append("--no-farclip") @@ -2711,9 +2633,6 @@ WScript.Echo oWS.SpecialFolders("Desktop") try: subprocess.run(args, check=True) - if superwow_active: - self._reset_superwow_managed_exe_patches(staged_output) - valid_pe, reason = self._inspect_wow_executable(staged_output) if not valid_pe: raise RuntimeError( diff --git a/tests/test_safety.py b/tests/test_safety.py index edb4672..5aedd85 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -812,66 +812,7 @@ class SmartUpdateTests(unittest.TestCase): self.assertEqual(revision, "abcdef1234567890") download.assert_not_called() - def test_superwow_reset_removes_inherited_vanilla_tweaks_patches(self): - tool = WowSetupTool.__new__(WowSetupTool) - size = 0x435D3C + 16 - data = bytearray(size) - - data[0x0C1ECF:0x0C1ED1] = b"\x75\x10" - data[0x0C2B25:0x0C2B27] = b"\x75\x0B" - data[0x3A4869] = 0x27 - data[0x4089B4:0x4089B8] = struct.pack(" Date: Thu, 3 Sep 2026 23:33:46 +0200 Subject: [PATCH 069/101] Remove one-time tweak migration workflow --- .../workflows/apply-independent-tweaks.yml | 38 ------------------- 1 file changed, 38 deletions(-) delete mode 100644 .github/workflows/apply-independent-tweaks.yml diff --git a/.github/workflows/apply-independent-tweaks.yml b/.github/workflows/apply-independent-tweaks.yml deleted file mode 100644 index cc9bc85..0000000 --- a/.github/workflows/apply-independent-tweaks.yml +++ /dev/null @@ -1,38 +0,0 @@ -name: Apply independent Vanilla Tweaks policy - -on: - push: - branches: - - 'test/remote-fallbacks' - -permissions: - contents: write - -jobs: - apply: - if: github.event.head_commit.message == 'Run independent tweak migration' - runs-on: ubuntu-latest - steps: - - name: Checkout branch - uses: actions/checkout@v4 - with: - ref: test/remote-fallbacks - - - name: Apply migration - run: python scripts/apply_tweak_policy.py - - - name: Validate syntax and diff - run: | - python -m py_compile setup_tool.py setup_tool_dynamic.py remote_packages.py tests/test_safety.py - git diff --check - - - name: Commit changes - run: | - git config user.name "github-actions[bot]" - git config user.email "41898282+github-actions[bot]@users.noreply.github.com" - git add setup_tool.py tests/test_safety.py - git diff --cached --check - git commit -m "Keep Vanilla Tweaks independent from SuperWoW" - git push origin HEAD:test/remote-fallbacks - -# one-time migration trigger v2 -- 2.52.0 From 9569bbd29678d2092f700b1222803ac9379826aa Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:33:52 +0200 Subject: [PATCH 070/101] Remove one-time tweak migration script --- scripts/apply_tweak_policy.py | 222 ---------------------------------- 1 file changed, 222 deletions(-) delete mode 100644 scripts/apply_tweak_policy.py diff --git a/scripts/apply_tweak_policy.py b/scripts/apply_tweak_policy.py deleted file mode 100644 index 93967c6..0000000 --- a/scripts/apply_tweak_policy.py +++ /dev/null @@ -1,222 +0,0 @@ -from pathlib import Path -import re - - -setup_path = Path("setup_tool.py") -text = setup_path.read_text(encoding="utf-8") - -controls_pattern = re.compile( - r" def update_superwow_managed_controls\(self\):\n.*?" - r"(?= def build_tweaks_tab\(self, parent\):\n)", - re.S, -) -controls_replacement = ''' def update_superwow_managed_controls(self): - """Keep Vanilla Tweaks controls independent from SuperWoW.""" - if hasattr(self, "superwow_notice"): - try: - self.superwow_notice.pack_forget() - except tk.TclError: - pass - - if hasattr(self, "fov_ratio_combo"): - self.fov_ratio_combo.configure(state="readonly") - if hasattr(self, "fov_entry"): - self.fov_entry.configure(state="normal") - if hasattr(self, "sound_scale"): - self.sound_scale.configure(state="normal") - if hasattr(self, "sound_entry"): - self.sound_entry.configure(state="normal") - if hasattr(self, "cb_loot"): - self.cb_loot.configure(state="normal") - if hasattr(self, "cb_bg"): - self.cb_bg.configure(state="normal") - -''' -text, count = controls_pattern.subn(lambda _match: controls_replacement, text, count=1) -assert count == 1, f"controls replacement count={count}" - -signature_pattern = re.compile( - r" def _vanilla_tweaks_signature\(self\):\n.*?" - r"(?= def run_vanilla_tweaks\(self, target, tweaks_exe=None, modern_cli=False\):\n)", - re.S, -) -signature_replacement = ''' def _vanilla_tweaks_signature(self): - """Return settings that change WoW_Modernized.exe patch output.""" - return { - "fov": round(float(self.vt_fov.get()), 4), - "farclip": int(self.vt_farclip.get()), - "frill": int(self.vt_frill.get()), - "nameplate": int(self.vt_nameplate.get()), - "sound_channels": int(self.vt_soundchan.get()), - "max_camera": int(self.vt_maxcam.get()), - "quickloot": bool(self.vt_quickloot.get()), - "background_sound": bool(self.vt_bg_sound.get()), - "large_address_aware": bool(self.vt_laa.get()), - "camera_fix": bool(self.vt_cam_fix.get()), - "crossfaction_res": bool(self.vt_crossfaction_res.get()), - "custom_glues": bool(self.vt_custom_glues.get()), - "bluemoon": bool(self.vt_bluemoon.get()), - } - -''' -text, count = signature_pattern.subn(lambda _match: signature_replacement, text, count=1) -assert count == 1, f"signature replacement count={count}" - -replacements = { - " superwow_active = self._superwow_enabled()\n": "", - ( - " # tubtubs/vanilla-tweaks keeps these four patches opt-in. When\n" - " # SuperWoW is active, deliberately leave them unpatched.\n" - " if not superwow_active and abs(self.vt_fov.get() - 1.5708) >= 0.0001:\n" - ): ( - " # tubtubs/vanilla-tweaks keeps these patches opt-in.\n" - " if abs(self.vt_fov.get() - 1.5708) >= 0.0001:\n" - ), - " if not superwow_active and self.vt_soundchan.get() != 12:\n": - " if self.vt_soundchan.get() != 12:\n", - " if not superwow_active and self.vt_quickloot.get():\n": - " if self.vt_quickloot.get():\n", - " if not superwow_active and self.vt_bg_sound.get():\n": - " if self.vt_bg_sound.get():\n", - ( - " if superwow_active:\n" - " self._reset_superwow_managed_exe_patches(staged_output)\n\n" - ): "", -} -for old, new in replacements.items(): - assert old in text, f"missing expected setup_tool block: {old!r}" - text = text.replace(old, new, 1) - -legacy_pattern = re.compile( - r" else:\n" - r" # Legacy bundled brndd patcher enables these older patches by\n" - r" # default, so explicitly disable all four when SuperWoW handles them\.\n" - r" if superwow_active:\n.*?" - r"(?=\n if self\.vt_farclip\.get\(\) == 777:)", - re.S, -) -legacy_replacement = ''' else: - # Legacy bundled brndd patcher kept only as an offline fallback. - if abs(self.vt_fov.get() - 1.5708) < 0.0001: - args.append("--no-fov") - else: - args.extend(["--fov", str(self.vt_fov.get())]) - - if self.vt_soundchan.get() == 12: - args.append("--no-soundchannels") - else: - args.extend(["--soundchannels", str(self.vt_soundchan.get())]) - - if not self.vt_quickloot.get(): - args.append("--no-quickloot") - if not self.vt_bg_sound.get(): - args.append("--no-sound-in-background") -''' -text, count = legacy_pattern.subn(lambda _match: legacy_replacement, text, count=1) -assert count == 1, f"legacy replacement count={count}" - -setup_path.write_text(text, encoding="utf-8", newline="\n") - - -tests_path = Path("tests/test_safety.py") -tests_text = tests_path.read_text(encoding="utf-8") -tests_pattern = re.compile( - r" def test_superwow_reset_removes_inherited_vanilla_tweaks_patches\(self\):\n.*?" - r"(?= def test_vanilla_tweaks_skips_package_when_output_and_revision_match\(self\):\n)", - re.S, -) -tests_replacement = ''' def test_superwow_does_not_change_vanilla_tweaks_signature(self): - tool = WowSetupTool.__new__(WowSetupTool) - tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} - tool.vt_fov = FakeVar(1.919862) - tool.vt_farclip = FakeVar(3000) - tool.vt_frill = FakeVar(300) - tool.vt_nameplate = FakeVar(41) - tool.vt_soundchan = FakeVar(64) - tool.vt_maxcam = FakeVar(100) - tool.vt_quickloot = FakeVar(True) - tool.vt_bg_sound = FakeVar(True) - tool.vt_laa = FakeVar(True) - tool.vt_cam_fix = FakeVar(True) - tool.vt_crossfaction_res = FakeVar(False) - tool.vt_custom_glues = FakeVar(True) - tool.vt_bluemoon = FakeVar(False) - - signature_with_superwow = tool._vanilla_tweaks_signature() - tool.core_plugins["SuperWoWhook.dll"].set(False) - signature_without_superwow = tool._vanilla_tweaks_signature() - - self.assertEqual(signature_with_superwow, signature_without_superwow) - self.assertEqual(signature_with_superwow["fov"], 1.9199) - self.assertEqual(signature_with_superwow["sound_channels"], 64) - self.assertTrue(signature_with_superwow["quickloot"]) - self.assertTrue(signature_with_superwow["background_sound"]) - - def test_superwow_keeps_vanilla_tweaks_controls_enabled(self): - tool = WowSetupTool.__new__(WowSetupTool) - tool.superwow_notice = mock.Mock() - tool.fov_ratio_combo = mock.Mock() - tool.fov_entry = mock.Mock() - tool.sound_scale = mock.Mock() - tool.sound_entry = mock.Mock() - tool.cb_loot = mock.Mock() - tool.cb_bg = mock.Mock() - - tool.update_superwow_managed_controls() - - tool.superwow_notice.pack_forget.assert_called_once() - tool.fov_ratio_combo.configure.assert_called_once_with(state="readonly") - tool.fov_entry.configure.assert_called_once_with(state="normal") - tool.sound_scale.configure.assert_called_once_with(state="normal") - tool.sound_entry.configure.assert_called_once_with(state="normal") - tool.cb_loot.configure.assert_called_once_with(state="normal") - tool.cb_bg.configure.assert_called_once_with(state="normal") - - def test_superwow_modern_cli_keeps_selected_fov_sound_loot_and_background(self): - tool = WowSetupTool.__new__(WowSetupTool) - tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} - tool.vt_fov = FakeVar(1.919862) - tool.vt_farclip = FakeVar(777) - tool.vt_frill = FakeVar(70) - tool.vt_nameplate = FakeVar(20) - tool.vt_soundchan = FakeVar(64) - tool.vt_maxcam = FakeVar(50) - tool.vt_quickloot = FakeVar(True) - tool.vt_bg_sound = FakeVar(True) - tool.vt_laa = FakeVar(True) - tool.vt_cam_fix = FakeVar(True) - tool.vt_crossfaction_res = FakeVar(False) - tool.vt_custom_glues = FakeVar(True) - tool.vt_bluemoon = FakeVar(False) - tool._inspect_wow_executable = mock.Mock(return_value=(True, "")) - - captured = {} - with tempfile.TemporaryDirectory() as root: - wow = os.path.join(root, "WoW.exe") - patcher = os.path.join(root, "vanilla-tweaks.exe") - with open(wow, "wb") as handle: - handle.write(b"MZ" + b"\\x00" * (2 * 1024 * 1024)) - with open(patcher, "wb") as handle: - handle.write(b"patcher") - - def fake_run(args, check): - captured["args"] = list(args) - staged = args[args.index("-o") + 1] - with open(staged, "wb") as handle: - handle.write(b"MZ" + b"\\x00" * (2 * 1024 * 1024)) - - with mock.patch("setup_tool.subprocess.run", side_effect=fake_run): - tool.run_vanilla_tweaks(root, tweaks_exe=patcher, modern_cli=True) - - args = captured["args"] - self.assertIn("--fov", args) - self.assertIn("--fov-patch", args) - self.assertIn("--soundchannels", args) - self.assertIn("--soundchannels-patch", args) - self.assertIn("--quickloot", args) - self.assertIn("--sound-in-background", args) - -''' -tests_text, count = tests_pattern.subn(lambda _match: tests_replacement, tests_text, count=1) -assert count == 1, f"tests replacement count={count}" -tests_path.write_text(tests_text, encoding="utf-8", newline="\n") -- 2.52.0 From 17059d8a765c86cbdbe63e8d45b0c58ebd0e89c9 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:36:22 +0200 Subject: [PATCH 071/101] Cleanup obsolete SuperWoW tweak UI --- .../workflows/cleanup-superwow-tweak-ui.yml | 108 ++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 .github/workflows/cleanup-superwow-tweak-ui.yml diff --git a/.github/workflows/cleanup-superwow-tweak-ui.yml b/.github/workflows/cleanup-superwow-tweak-ui.yml new file mode 100644 index 0000000..d37303a --- /dev/null +++ b/.github/workflows/cleanup-superwow-tweak-ui.yml @@ -0,0 +1,108 @@ +name: Cleanup obsolete SuperWoW tweak UI + +on: + push: + branches: + - 'test/remote-fallbacks' + +permissions: + contents: write + +jobs: + cleanup: + if: github.event.head_commit.message == 'Cleanup obsolete SuperWoW tweak UI' + runs-on: ubuntu-latest + steps: + - name: Checkout branch + uses: actions/checkout@v4 + with: + ref: test/remote-fallbacks + + - name: Remove obsolete SuperWoW tweak coupling + shell: bash + run: | + python - <<'PY' + from pathlib import Path + import re + + setup = Path('setup_tool.py') + text = setup.read_text(encoding='utf-8') + + methods = re.compile( + r' def _superwow_enabled\(self\):\n.*?(?= def build_tweaks_tab\(self, parent\):\n)', + re.S, + ) + text, count = methods.subn('', text, count=1) + assert count == 1, f'SuperWoW helper removal count={count}' + + notice = re.compile( + r'( def build_tweaks_tab\(self, parent\):\n)' + r' self\.superwow_notice = tk\.Label\(.*?' + r' self\.superwow_notice\.pack\(fill="x", padx=10, pady=\(5, 2\)\)\n\n' + r'(?= fov_frame = ttk\.LabelFrame)', + re.S, + ) + text, count = notice.subn(lambda m: m.group(1), text, count=1) + assert count == 1, f'SuperWoW notice removal count={count}' + + text, count = re.subn( + r'^\s+self\.update_superwow_managed_controls\(\)\n', + '', + text, + flags=re.M, + ) + assert count >= 1, f'expected obsolete update calls, got {count}' + assert 'update_superwow_managed_controls' not in text + assert '_superwow_enabled' not in text + assert 'superwow_notice' not in text + setup.write_text(text, encoding='utf-8', newline='\n') + + dynamic = Path('setup_tool_dynamic.py') + text = dynamic.read_text(encoding='utf-8') + callback = ''' command = ( + self.update_superwow_managed_controls + if dll == "SuperWoWhook.dll" + else None + ) +''' + # Match indentation exactly as stored rather than relying on the + # callback being at a fixed line number. + callback_re = re.compile( + r' command = \(\n' + r' self\.update_superwow_managed_controls\n' + r' if dll == "SuperWoWhook\.dll"\n' + r' else None\n' + r' \)\n' + ) + text, count = callback_re.subn('', text, count=1) + assert count == 1, f'dynamic callback removal count={count}' + text, count = re.subn(r'^\s+command=command,\n', '', text, count=1, flags=re.M) + assert count == 1, f'dynamic command argument removal count={count}' + assert 'update_superwow_managed_controls' not in text + dynamic.write_text(text, encoding='utf-8', newline='\n') + + tests = Path('tests/test_safety.py') + text = tests.read_text(encoding='utf-8') + obsolete_test = re.compile( + r' def test_superwow_keeps_vanilla_tweaks_controls_enabled\(self\):\n.*?' + r'(?= def test_superwow_modern_cli_keeps_selected_fov_sound_loot_and_background\(self\):\n)', + re.S, + ) + text, count = obsolete_test.subn('', text, count=1) + assert count == 1, f'obsolete test removal count={count}' + tests.write_text(text, encoding='utf-8', newline='\n') + PY + + - name: Validate syntax and diff + run: | + python -m py_compile setup_tool.py setup_tool_dynamic.py remote_packages.py tests/test_safety.py + git diff --check + + - name: Commit cleanup + run: | + git config user.name "github-actions[bot]" + git config user.email "41898282+github-actions[bot]@users.noreply.github.com" + git add setup_tool.py setup_tool_dynamic.py tests/test_safety.py + git diff --cached --check + git commit -m "Remove SuperWoW Vanilla Tweaks coupling" + git push origin HEAD:test/remote-fallbacks -- 2.52.0 From 798408c559b5a378985dce81fde71a3eed47f371 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:36:55 +0200 Subject: [PATCH 072/101] Cleanup obsolete SuperWoW tweak UI --- .github/workflows/cleanup-superwow-tweak-ui.yml | 8 -------- 1 file changed, 8 deletions(-) diff --git a/.github/workflows/cleanup-superwow-tweak-ui.yml b/.github/workflows/cleanup-superwow-tweak-ui.yml index d37303a..9a169e3 100644 --- a/.github/workflows/cleanup-superwow-tweak-ui.yml +++ b/.github/workflows/cleanup-superwow-tweak-ui.yml @@ -59,14 +59,6 @@ jobs: dynamic = Path('setup_tool_dynamic.py') text = dynamic.read_text(encoding='utf-8') - callback = ''' command = ( - self.update_superwow_managed_controls - if dll == "SuperWoWhook.dll" - else None - ) -''' - # Match indentation exactly as stored rather than relying on the - # callback being at a fixed line number. callback_re = re.compile( r' command = \(\n' r' self\.update_superwow_managed_controls\n' -- 2.52.0 From e88d2cd28d56ad82c0a9ba15296babc77df5e76f Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 3 Sep 2026 21:37:03 +0000 Subject: [PATCH 073/101] Remove SuperWoW Vanilla Tweaks coupling --- setup_tool.py | 45 ------------------------------------------- setup_tool_dynamic.py | 6 ------ tests/test_safety.py | 20 ------------------- 3 files changed, 71 deletions(-) diff --git a/setup_tool.py b/setup_tool.py index a6258be..2e47764 100644 --- a/setup_tool.py +++ b/setup_tool.py @@ -544,7 +544,6 @@ class WowSetupTool: self._load_legacy_install_state(target_dir) self._normalize_plugin_conflicts() self.toggle_safety_limits() - self.update_superwow_managed_controls() return False try: @@ -562,7 +561,6 @@ class WowSetupTool: self._normalize_plugin_conflicts() self.toggle_safety_limits() - self.update_superwow_managed_controls() if recovered_from_damage: messagebox.showwarning( @@ -719,48 +717,7 @@ class WowSetupTool: cb.pack(anchor='w', padx=10, pady=4) ToolTip(cb, self.descriptions.get(dll, "")) - def _superwow_enabled(self): - var = self.core_plugins.get("SuperWoWhook.dll") - return bool(var is not None and var.get()) - - def update_superwow_managed_controls(self): - """Keep Vanilla Tweaks controls independent from SuperWoW.""" - if hasattr(self, "superwow_notice"): - try: - self.superwow_notice.pack_forget() - except tk.TclError: - pass - - if hasattr(self, "fov_ratio_combo"): - self.fov_ratio_combo.configure(state="readonly") - if hasattr(self, "fov_entry"): - self.fov_entry.configure(state="normal") - if hasattr(self, "sound_scale"): - self.sound_scale.configure(state="normal") - if hasattr(self, "sound_entry"): - self.sound_entry.configure(state="normal") - if hasattr(self, "cb_loot"): - self.cb_loot.configure(state="normal") - if hasattr(self, "cb_bg"): - self.cb_bg.configure(state="normal") - def build_tweaks_tab(self, parent): - self.superwow_notice = tk.Label( - parent, - text="", - background="#EAF4FF", - foreground="#005A9E", - font=("Segoe UI", 9, "bold"), - relief="solid", - borderwidth=1, - padx=8, - pady=4, - anchor="w", - justify="left", - wraplength=620, - ) - self.superwow_notice.pack(fill="x", padx=10, pady=(5, 2)) - fov_frame = ttk.LabelFrame(parent, text="Field of View (FoV) Calculator") fov_frame.pack(fill='x', padx=10, pady=5) @@ -858,8 +815,6 @@ class WowSetupTool: cb_clear_wdb.grid(row=4, column=0, sticky='w', padx=10, pady=2) ToolTip(cb_clear_wdb, self.descriptions["clear_wdb"]) - self.update_superwow_managed_controls() - def build_visual_audio_tab(self, parent): ttk.Label( diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 5f15afd..9b1ff29 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -641,18 +641,12 @@ class ModernWowSetupTool(WowSetupTool): dll, (os.path.splitext(dll)[0], "") ) - command = ( - self.update_superwow_managed_controls - if dll == "SuperWoWhook.dll" - else None - ) self._plugin_row( left_frame, display_name, var, attribution, self.descriptions.get(dll, ""), - command=command, ) self._plugin_row( diff --git a/tests/test_safety.py b/tests/test_safety.py index 5aedd85..a1a6990 100644 --- a/tests/test_safety.py +++ b/tests/test_safety.py @@ -839,26 +839,6 @@ class SmartUpdateTests(unittest.TestCase): self.assertTrue(signature_with_superwow["quickloot"]) self.assertTrue(signature_with_superwow["background_sound"]) - def test_superwow_keeps_vanilla_tweaks_controls_enabled(self): - tool = WowSetupTool.__new__(WowSetupTool) - tool.superwow_notice = mock.Mock() - tool.fov_ratio_combo = mock.Mock() - tool.fov_entry = mock.Mock() - tool.sound_scale = mock.Mock() - tool.sound_entry = mock.Mock() - tool.cb_loot = mock.Mock() - tool.cb_bg = mock.Mock() - - tool.update_superwow_managed_controls() - - tool.superwow_notice.pack_forget.assert_called_once() - tool.fov_ratio_combo.configure.assert_called_once_with(state="readonly") - tool.fov_entry.configure.assert_called_once_with(state="normal") - tool.sound_scale.configure.assert_called_once_with(state="normal") - tool.sound_entry.configure.assert_called_once_with(state="normal") - tool.cb_loot.configure.assert_called_once_with(state="normal") - tool.cb_bg.configure.assert_called_once_with(state="normal") - def test_superwow_modern_cli_keeps_selected_fov_sound_loot_and_background(self): tool = WowSetupTool.__new__(WowSetupTool) tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} -- 2.52.0 From f8a8678e2e09283ff4fa263b13f1496c38b331cd Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Thu, 3 Sep 2026 23:37:23 +0200 Subject: [PATCH 074/101] Remove one-time SuperWoW UI cleanup workflow --- .../workflows/cleanup-superwow-tweak-ui.yml | 100 ------------------ 1 file changed, 100 deletions(-) delete mode 100644 .github/workflows/cleanup-superwow-tweak-ui.yml diff --git a/.github/workflows/cleanup-superwow-tweak-ui.yml b/.github/workflows/cleanup-superwow-tweak-ui.yml deleted file mode 100644 index 9a169e3..0000000 --- a/.github/workflows/cleanup-superwow-tweak-ui.yml +++ /dev/null @@ -1,100 +0,0 @@ -name: Cleanup obsolete SuperWoW tweak UI - -on: - push: - branches: - - 'test/remote-fallbacks' - -permissions: - contents: write - -jobs: - cleanup: - if: github.event.head_commit.message == 'Cleanup obsolete SuperWoW tweak UI' - runs-on: ubuntu-latest - steps: - - name: Checkout branch - uses: actions/checkout@v4 - with: - ref: test/remote-fallbacks - - - name: Remove obsolete SuperWoW tweak coupling - shell: bash - run: | - python - <<'PY' - from pathlib import Path - import re - - setup = Path('setup_tool.py') - text = setup.read_text(encoding='utf-8') - - methods = re.compile( - r' def _superwow_enabled\(self\):\n.*?(?= def build_tweaks_tab\(self, parent\):\n)', - re.S, - ) - text, count = methods.subn('', text, count=1) - assert count == 1, f'SuperWoW helper removal count={count}' - - notice = re.compile( - r'( def build_tweaks_tab\(self, parent\):\n)' - r' self\.superwow_notice = tk\.Label\(.*?' - r' self\.superwow_notice\.pack\(fill="x", padx=10, pady=\(5, 2\)\)\n\n' - r'(?= fov_frame = ttk\.LabelFrame)', - re.S, - ) - text, count = notice.subn(lambda m: m.group(1), text, count=1) - assert count == 1, f'SuperWoW notice removal count={count}' - - text, count = re.subn( - r'^\s+self\.update_superwow_managed_controls\(\)\n', - '', - text, - flags=re.M, - ) - assert count >= 1, f'expected obsolete update calls, got {count}' - assert 'update_superwow_managed_controls' not in text - assert '_superwow_enabled' not in text - assert 'superwow_notice' not in text - setup.write_text(text, encoding='utf-8', newline='\n') - - dynamic = Path('setup_tool_dynamic.py') - text = dynamic.read_text(encoding='utf-8') - callback_re = re.compile( - r' command = \(\n' - r' self\.update_superwow_managed_controls\n' - r' if dll == "SuperWoWhook\.dll"\n' - r' else None\n' - r' \)\n' - ) - text, count = callback_re.subn('', text, count=1) - assert count == 1, f'dynamic callback removal count={count}' - text, count = re.subn(r'^\s+command=command,\n', '', text, count=1, flags=re.M) - assert count == 1, f'dynamic command argument removal count={count}' - assert 'update_superwow_managed_controls' not in text - dynamic.write_text(text, encoding='utf-8', newline='\n') - - tests = Path('tests/test_safety.py') - text = tests.read_text(encoding='utf-8') - obsolete_test = re.compile( - r' def test_superwow_keeps_vanilla_tweaks_controls_enabled\(self\):\n.*?' - r'(?= def test_superwow_modern_cli_keeps_selected_fov_sound_loot_and_background\(self\):\n)', - re.S, - ) - text, count = obsolete_test.subn('', text, count=1) - assert count == 1, f'obsolete test removal count={count}' - tests.write_text(text, encoding='utf-8', newline='\n') - PY - - - name: Validate syntax and diff - run: | - python -m py_compile setup_tool.py setup_tool_dynamic.py remote_packages.py tests/test_safety.py - git diff --check - - - name: Commit cleanup - run: | - git config user.name "github-actions[bot]" - git config user.email "41898282+github-actions[bot]@users.noreply.github.com" - git add setup_tool.py setup_tool_dynamic.py tests/test_safety.py - git diff --cached --check - git commit -m "Remove SuperWoW Vanilla Tweaks coupling" - git push origin HEAD:test/remote-fallbacks -- 2.52.0 From 8658700a767aa49f569d6778f5e76ab057411131 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 08:32:00 +0200 Subject: [PATCH 075/101] Harden WowPresence legacy recovery --- setup_tool_dynamic.py | 73 +++++++++++++++++++++++++++++++++++++------ 1 file changed, 64 insertions(+), 9 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 9b1ff29..5c4ce07 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -780,6 +780,67 @@ class ModernWowSetupTool(WowSetupTool): except Exception: return False + def _prepare_wowpresence_managed_state(self, target): + """Force legacy tool-managed installs without hashes through a safe refresh.""" + trust_state = remote_packages.wowpresence_install_trust_state(target) + if trust_state == "managed_unverified": + remote_packages._set_managed_manifest_values( + target, + remote_packages.WOWPRESENCE_MANAGED_ID, + revision="__legacy_unverified__", + ) + return trust_state + + def _wowpresence_source_failure(self, error): + """Distinguish unusable remote packages from local install/write failures.""" + messages = [] + current = error + seen = set() + while current is not None and id(current) not in seen: + seen.add(id(current)) + messages.append(str(current)) + current = ( + current.__cause__ + if current.__cause__ is not None + else current.__context__ + ) + + text = "\n".join(messages) + source_markers = ( + "GitHub request failed:", + "latest release is not a stable release", + "Could not find WowPresence.zip in release", + "Release asset WowPresence.zip has no download URL", + "Download failed for WowPresence.zip:", + "SHA-256 mismatch for downloaded file", + "Unsafe ZIP path:", + "WowPresence.dll was not found in downloaded archive.", + "WowPresence.exe was not found in downloaded archive.", + "WowPresence.dll is ", + "WowPresence.dll has ", + "WowPresence.exe is ", + "WowPresence.exe has ", + "File is not a zip file", + "Bad magic number for file header", + ) + return any(marker in text for marker in source_markers) + + def _install_wowpresence_with_fallback(self, target): + """Use offline recovery only for remote-source failures, never local ones.""" + self._prepare_wowpresence_managed_state(target) + try: + return remote_packages.install_wowpresence( + target, + progress=self._report_download_progress, + ) + except Exception as exc: + if not self._wowpresence_source_failure(exc): + raise RuntimeError( + f"WowPresence installation failed locally:\n{exc}" + ) from exc + self._recover_wowpresence_offline(target, exc) + return None + def _recover_wowpresence_offline(self, target, error): """Preserve only trusted/manual-valid WowPresence; repair modified managed files.""" trust_state = remote_packages.wowpresence_install_trust_state(target) @@ -800,7 +861,7 @@ class ModernWowSetupTool(WowSetupTool): ) return - if trust_state in ("unmanaged", "managed_unverified") and existing_pair_valid: + if trust_state == "unmanaged" and existing_pair_valid: remote_packages.ensure_wowpresence_config(target) self._warn_offline( "WowPresence", @@ -1481,13 +1542,7 @@ class ModernWowSetupTool(WowSetupTool): continue if dll_name == "WowPresence.dll": - try: - remote_packages.install_wowpresence( - target, - progress=self._report_download_progress, - ) - except Exception as exc: - self._recover_wowpresence_offline(target, exc) + self._install_wowpresence_with_fallback(target) # Remove the old test-branch filenames after a successful # migration. The legacy config directory is intentionally @@ -1523,4 +1578,4 @@ class ModernWowSetupTool(WowSetupTool): if __name__ == "__main__": root = tk.Tk() app = ModernWowSetupTool(root) - root.mainloop() + root.mainloop() \ No newline at end of file -- 2.52.0 From 600719652e8f3df00336b89698f40bd2f0581989 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 08:32:32 +0200 Subject: [PATCH 076/101] Test WowPresence legacy and local failure handling --- tests/test_wowpresence_recovery.py | 177 +++++++++++++++++++++++++++++ 1 file changed, 177 insertions(+) create mode 100644 tests/test_wowpresence_recovery.py diff --git a/tests/test_wowpresence_recovery.py b/tests/test_wowpresence_recovery.py new file mode 100644 index 0000000..039fc73 --- /dev/null +++ b/tests/test_wowpresence_recovery.py @@ -0,0 +1,177 @@ +import unittest +from unittest import mock + +import remote_packages +from setup_tool_dynamic import ModernWowSetupTool + + +class WowPresenceRecoveryTests(unittest.TestCase): + def _tool(self): + tool = ModernWowSetupTool.__new__(ModernWowSetupTool) + tool._report_download_progress = mock.Mock() + tool._warn_offline = mock.Mock() + tool._valid_x86_dll = mock.Mock(return_value=True) + return tool + + def test_legacy_managed_wowpresence_is_repaired_offline(self): + tool = self._tool() + error = remote_packages.RemotePackageError("GitHub request failed: offline") + + with ( + mock.patch.object( + remote_packages, + "wowpresence_install_trust_state", + return_value="managed_unverified", + ), + mock.patch.object( + remote_packages, + "install_cached_wowpresence", + ) as cached, + mock.patch.object( + remote_packages, + "install_bundled_wowpresence", + ) as bundled, + mock.patch.object( + remote_packages, + "ensure_wowpresence_config", + ) as ensure_config, + mock.patch.object( + remote_packages, + "cache_installed_wowpresence", + ) as seed_cache, + ): + tool._recover_wowpresence_offline("C:/WoW", error) + + cached.assert_called_once_with( + "C:/WoW", + progress=tool._report_download_progress, + ) + bundled.assert_not_called() + ensure_config.assert_not_called() + seed_cache.assert_not_called() + tool._warn_offline.assert_called_once() + + def test_legacy_managed_state_is_marked_for_online_refresh(self): + tool = self._tool() + + with ( + mock.patch.object( + remote_packages, + "wowpresence_install_trust_state", + return_value="managed_unverified", + ), + mock.patch.object( + remote_packages, + "_set_managed_manifest_values", + ) as update_manifest, + ): + state = tool._prepare_wowpresence_managed_state("C:/WoW") + + self.assertEqual(state, "managed_unverified") + update_manifest.assert_called_once_with( + "C:/WoW", + remote_packages.WOWPRESENCE_MANAGED_ID, + revision="__legacy_unverified__", + ) + + def test_unmanaged_wowpresence_is_not_marked_for_refresh(self): + tool = self._tool() + + with ( + mock.patch.object( + remote_packages, + "wowpresence_install_trust_state", + return_value="unmanaged", + ), + mock.patch.object( + remote_packages, + "_set_managed_manifest_values", + ) as update_manifest, + ): + state = tool._prepare_wowpresence_managed_state("C:/WoW") + + self.assertEqual(state, "unmanaged") + update_manifest.assert_not_called() + + def test_remote_wowpresence_failure_uses_offline_recovery(self): + tool = self._tool() + tool._prepare_wowpresence_managed_state = mock.Mock() + tool._recover_wowpresence_offline = mock.Mock() + error = remote_packages.RemotePackageError("GitHub request failed: offline") + + with mock.patch.object( + remote_packages, + "install_wowpresence", + side_effect=error, + ) as install: + result = tool._install_wowpresence_with_fallback("C:/WoW") + + self.assertIsNone(result) + tool._prepare_wowpresence_managed_state.assert_called_once_with("C:/WoW") + install.assert_called_once_with( + "C:/WoW", + progress=tool._report_download_progress, + ) + tool._recover_wowpresence_offline.assert_called_once_with("C:/WoW", error) + + def test_local_wowpresence_failure_is_not_hidden_by_fallback(self): + tool = self._tool() + tool._prepare_wowpresence_managed_state = mock.Mock() + tool._recover_wowpresence_offline = mock.Mock() + error = remote_packages.RemotePackageError( + "Could not prepare C:/WoW/WowPresence.dll for replacement. Close WoW and try again." + ) + + with mock.patch.object( + remote_packages, + "install_wowpresence", + side_effect=error, + ): + with self.assertRaisesRegex( + RuntimeError, + "WowPresence installation failed locally", + ): + tool._install_wowpresence_with_fallback("C:/WoW") + + tool._recover_wowpresence_offline.assert_not_called() + + def test_wowpresence_source_failure_classifier_rejects_local_io(self): + tool = self._tool() + + self.assertTrue( + tool._wowpresence_source_failure( + remote_packages.RemotePackageError("GitHub request failed: offline") + ) + ) + self.assertTrue( + tool._wowpresence_source_failure( + remote_packages.RemotePackageError( + "SHA-256 mismatch for downloaded file (expected a, got b)." + ) + ) + ) + self.assertTrue( + tool._wowpresence_source_failure( + remote_packages.RemotePackageError( + "WowPresence.dll is not a valid Windows PE binary (missing MZ header)." + ) + ) + ) + self.assertFalse( + tool._wowpresence_source_failure( + remote_packages.RemotePackageError( + "Could not prepare C:/WoW/WowPresence.dll for replacement." + ) + ) + ) + self.assertFalse( + tool._wowpresence_source_failure( + remote_packages.RemotePackageError( + "Could not validate WowPresence.dll: permission denied" + ) + ) + ) + + +if __name__ == "__main__": + unittest.main() -- 2.52.0 From 655c444353426bb65ed26cfc9833b80d890a3f3f Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 08:45:53 +0200 Subject: [PATCH 077/101] Make selected Vanilla Tweaks authoritative --- setup_tool_dynamic.py | 76 ++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 75 insertions(+), 1 deletion(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 5c4ce07..4525e5c 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -1,6 +1,7 @@ import os import json import shutil +import struct import tkinter as tk from tkinter import ttk, messagebox @@ -1114,6 +1115,74 @@ class ModernWowSetupTool(WowSetupTool): error, ) + def _vanilla_tweaks_signature(self): + """Version output normalization independently from the SuperWoW checkbox.""" + signature = super()._vanilla_tweaks_signature() + signature["selected_patch_normalization"] = 1 + return signature + + def _normalize_selected_vanilla_tweaks_output(self, output_exe): + """Make selected FoV/sound/loot settings authoritative on pre-patched inputs.""" + try: + with open(output_exe, "rb") as handle: + data = bytearray(handle.read()) + except OSError as exc: + raise RuntimeError( + "Could not inspect WoW_Modernized.exe for Vanilla Tweaks normalization." + ) from exc + + required_size = 0x435D3C + if len(data) < required_size: + raise RuntimeError( + "WoW_Modernized.exe is too small for Vanilla Tweaks normalization." + ) + + quickloot_sites = ( + (0x0C1ECF, 0x10), + (0x0C2B25, 0x0B), + ) + desired_quickloot_opcode = 0x75 if self.vt_quickloot.get() else 0x74 + for offset, displacement in quickloot_sites: + current = bytes(data[offset:offset + 2]) + vanilla = bytes((0x74, displacement)) + reversed_loot = bytes((0x75, displacement)) + if current not in (vanilla, reversed_loot, b"\x90\x90"): + raise RuntimeError( + f"Unexpected QuickLoot bytes at 0x{offset:X}; refusing to alter an unknown client." + ) + data[offset:offset + 2] = bytes( + (desired_quickloot_opcode, displacement) + ) + + if data[0x3A4869] not in (0x14, 0x27): + raise RuntimeError( + "Unexpected Background Sound byte; refusing to alter an unknown client." + ) + data[0x3A4869] = 0x27 if self.vt_bg_sound.get() else 0x14 + + data[0x4089B4:0x4089B8] = struct.pack(" 4: + raise RuntimeError("Sound Channels value is too large for the WoW 1.12.1 field.") + data[0x435D38:0x435D3C] = sound_channels.ljust(4, b"\x00") + + staged = output_exe + ".modernization-normalized" + try: + with open(staged, "wb") as handle: + handle.write(data) + os.replace(staged, output_exe) + except OSError as exc: + raise RuntimeError( + "Could not write the normalized WoW_Modernized.exe." + ) from exc + finally: + if os.path.exists(staged): + try: + os.remove(staged) + except OSError: + pass + def _vanilla_tweaks_marker_path(self, target): return os.path.join( target, @@ -1160,6 +1229,11 @@ class ModernWowSetupTool(WowSetupTool): "Cannot record vanilla-tweaks state because a required WoW executable is missing." ) + # tubtubs/vanilla-tweaks deliberately leaves opt-in patches unchanged + # when they are disabled. Normalize the four user-facing selections so + # an already-patched WoW.exe cannot silently override the Tool settings. + self._normalize_selected_vanilla_tweaks_output(output_exe) + marker_path = self._vanilla_tweaks_marker_path(target) os.makedirs(os.path.dirname(marker_path), exist_ok=True) temp_path = marker_path + ".new" @@ -1578,4 +1652,4 @@ class ModernWowSetupTool(WowSetupTool): if __name__ == "__main__": root = tk.Tk() app = ModernWowSetupTool(root) - root.mainloop() \ No newline at end of file + root.mainloop() -- 2.52.0 From 7c9d69179f6b8b88d0f83c715fcaf996afd8e50b Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 08:46:27 +0200 Subject: [PATCH 078/101] Test authoritative Vanilla Tweaks normalization --- tests/test_vanilla_tweaks_normalization.py | 155 +++++++++++++++++++++ 1 file changed, 155 insertions(+) create mode 100644 tests/test_vanilla_tweaks_normalization.py diff --git a/tests/test_vanilla_tweaks_normalization.py b/tests/test_vanilla_tweaks_normalization.py new file mode 100644 index 0000000..0b4d60a --- /dev/null +++ b/tests/test_vanilla_tweaks_normalization.py @@ -0,0 +1,155 @@ +import os +import struct +import tempfile +import unittest + +from setup_tool import WowSetupTool +from setup_tool_dynamic import ModernWowSetupTool + + +class FakeVar: + def __init__(self, value): + self.value = value + + def get(self): + return self.value + + def set(self, value): + self.value = value + + +class VanillaTweaksNormalizationTests(unittest.TestCase): + def _tool(self, *, fov, sound, quickloot, background): + tool = ModernWowSetupTool.__new__(ModernWowSetupTool) + tool.vt_fov = FakeVar(fov) + tool.vt_soundchan = FakeVar(sound) + tool.vt_quickloot = FakeVar(quickloot) + tool.vt_bg_sound = FakeVar(background) + + # Remaining values are required by the executable settings signature. + tool.vt_farclip = FakeVar(777) + tool.vt_frill = FakeVar(300) + tool.vt_nameplate = FakeVar(41) + tool.vt_maxcam = FakeVar(100) + tool.vt_laa = FakeVar(True) + tool.vt_cam_fix = FakeVar(True) + tool.vt_crossfaction_res = FakeVar(False) + tool.vt_custom_glues = FakeVar(True) + tool.vt_bluemoon = FakeVar(False) + tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} + return tool + + def _write_exe(self, root, quick1, quick2, background, fov, sound): + data = bytearray(0x435D3C + 16) + data[0x0C1ECF:0x0C1ED1] = quick1 + data[0x0C2B25:0x0C2B27] = quick2 + data[0x3A4869] = background + data[0x4089B4:0x4089B8] = struct.pack(" Date: Fri, 4 Sep 2026 10:32:11 +0200 Subject: [PATCH 079/101] Make Vanilla Tweaks output transaction-safe --- setup_tool_dynamic.py | 111 +++++++++++++++++++++++++++++++++++++++--- 1 file changed, 103 insertions(+), 8 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 4525e5c..70c6330 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -2,6 +2,7 @@ import os import json import shutil import struct +import tempfile import tkinter as tk from tkinter import ttk, messagebox @@ -1183,6 +1184,105 @@ class ModernWowSetupTool(WowSetupTool): except OSError: pass + def _run_vanilla_tweaks_transactional( + self, + target, + tweaks_exe, + modern_cli=True, + ): + """Patch, normalize and validate away from the live executable, then commit once.""" + wow_exe = os.path.join(target, "WoW.exe") + output_exe = os.path.join(target, "WoW_Modernized.exe") + final_staged = output_exe + ".modernization-new" + + if not os.path.isfile(wow_exe): + raise RuntimeError("WoW.exe is missing, so Vanilla Tweaks cannot be applied.") + + try: + staging_root = tempfile.mkdtemp( + prefix=".modernization-vt-", + dir=target, + ) + except OSError as exc: + raise RuntimeError( + "Could not create the temporary Vanilla Tweaks staging directory." + ) from exc + + try: + staged_wow = os.path.join(staging_root, "WoW.exe") + try: + shutil.copy2(wow_exe, staged_wow) + except OSError as exc: + raise RuntimeError( + "Could not stage WoW.exe for Vanilla Tweaks." + ) from exc + + staged_output = super().run_vanilla_tweaks( + staging_root, + tweaks_exe=tweaks_exe, + modern_cli=modern_cli, + ) + + # The Tool-owned selections are normalized before the live executable + # is touched. Unknown patch signatures therefore fail with the old + # WoW_Modernized.exe still completely intact. + self._normalize_selected_vanilla_tweaks_output(staged_output) + + valid_pe, reason = self._inspect_wow_executable(staged_output) + if not valid_pe: + raise RuntimeError( + "Normalized Vanilla Tweaks output is not a valid WoW executable. " + f"{reason}" + ) + if os.path.getsize(staged_output) < 1024 * 1024: + raise RuntimeError( + "Normalized Vanilla Tweaks output is unexpectedly small." + ) + + if os.path.exists(final_staged): + try: + os.remove(final_staged) + except OSError as exc: + raise RuntimeError( + "Could not prepare the final Vanilla Tweaks staging path." + ) from exc + + try: + os.replace(staged_output, final_staged) + except OSError as exc: + raise RuntimeError( + "Could not move the validated Vanilla Tweaks output into final staging." + ) from exc + + # Revalidate at the exact same-directory staging path used for the + # final atomic replacement. This is the last gate before commit. + valid_pe, reason = self._inspect_wow_executable(final_staged) + if not valid_pe: + raise RuntimeError( + "Final staged Vanilla Tweaks output is not a valid WoW executable. " + f"{reason}" + ) + if os.path.getsize(final_staged) < 1024 * 1024: + raise RuntimeError( + "Final staged Vanilla Tweaks output is unexpectedly small." + ) + + try: + os.replace(final_staged, output_exe) + except OSError as exc: + raise RuntimeError( + "Could not replace WoW_Modernized.exe with the validated staged output." + ) from exc + + return output_exe + finally: + if os.path.exists(final_staged): + try: + os.remove(final_staged) + except OSError: + pass + shutil.rmtree(staging_root, ignore_errors=True) + def _vanilla_tweaks_marker_path(self, target): return os.path.join( target, @@ -1229,11 +1329,6 @@ class ModernWowSetupTool(WowSetupTool): "Cannot record vanilla-tweaks state because a required WoW executable is missing." ) - # tubtubs/vanilla-tweaks deliberately leaves opt-in patches unchanged - # when they are disabled. Normalize the four user-facing selections so - # an already-patched WoW.exe cannot silently override the Tool settings. - self._normalize_selected_vanilla_tweaks_output(output_exe) - marker_path = self._vanilla_tweaks_marker_path(target) os.makedirs(os.path.dirname(marker_path), exist_ok=True) temp_path = marker_path + ".new" @@ -1338,7 +1433,7 @@ class ModernWowSetupTool(WowSetupTool): f"Details: {exc}", ) - result = super().run_vanilla_tweaks( + result = self._run_vanilla_tweaks_transactional( target, tweaks_exe=bundled_exe, modern_cli=True, @@ -1412,7 +1507,7 @@ class ModernWowSetupTool(WowSetupTool): f"Details: {exc}", ) - result = super().run_vanilla_tweaks( + result = self._run_vanilla_tweaks_transactional( target, tweaks_exe=bundled_exe, modern_cli=True, @@ -1431,7 +1526,7 @@ class ModernWowSetupTool(WowSetupTool): None, None, ) - result = super().run_vanilla_tweaks( + result = self._run_vanilla_tweaks_transactional( target, tweaks_exe=tweaks_exe, modern_cli=True, -- 2.52.0 From 2338c005b8d528f4ec05ca254b4818b38e348ba2 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 10:33:03 +0200 Subject: [PATCH 080/101] Test transactional Vanilla Tweaks output --- tests/test_vanilla_tweaks_normalization.py | 97 ++++++++++++++++++++++ 1 file changed, 97 insertions(+) diff --git a/tests/test_vanilla_tweaks_normalization.py b/tests/test_vanilla_tweaks_normalization.py index 0b4d60a..2783fd0 100644 --- a/tests/test_vanilla_tweaks_normalization.py +++ b/tests/test_vanilla_tweaks_normalization.py @@ -2,6 +2,7 @@ import os import struct import tempfile import unittest +from unittest import mock from setup_tool import WowSetupTool from setup_tool_dynamic import ModernWowSetupTool @@ -133,6 +134,102 @@ class VanillaTweaksNormalizationTests(unittest.TestCase): with self.assertRaisesRegex(RuntimeError, "Unexpected QuickLoot bytes"): tool._normalize_selected_vanilla_tweaks_output(path) + def test_transaction_keeps_existing_output_when_normalization_fails(self): + tool = self._tool( + fov=1.9199, + sound=64, + quickloot=True, + background=True, + ) + + with tempfile.TemporaryDirectory() as root: + wow_exe = os.path.join(root, "WoW.exe") + with open(wow_exe, "wb") as handle: + handle.write(b"original WoW input") + + output_exe = os.path.join(root, "WoW_Modernized.exe") + previous_output = b"known-good existing modernized executable" + with open(output_exe, "wb") as handle: + handle.write(previous_output) + + def fake_run(_tool, staging_target, tweaks_exe=None, modern_cli=False): + return self._write_exe( + staging_target, + b"\xEB\x10", + b"\x74\x0B", + 0x14, + 1.5708, + b"12\x00\x00", + ) + + with mock.patch.object(WowSetupTool, "run_vanilla_tweaks", new=fake_run): + with self.assertRaisesRegex(RuntimeError, "Unexpected QuickLoot bytes"): + tool._run_vanilla_tweaks_transactional( + root, + tweaks_exe="fake-vanilla-tweaks.exe", + modern_cli=True, + ) + + with open(output_exe, "rb") as handle: + self.assertEqual(handle.read(), previous_output) + self.assertFalse(os.path.exists(output_exe + ".modernization-new")) + self.assertFalse( + any(name.startswith(".modernization-vt-") for name in os.listdir(root)) + ) + + def test_transaction_commits_normalized_output_after_validation(self): + tool = self._tool( + fov=1.5708, + sound=12, + quickloot=False, + background=False, + ) + tool._inspect_wow_executable = lambda _path: (True, "ok") + + with tempfile.TemporaryDirectory() as root: + wow_exe = os.path.join(root, "WoW.exe") + with open(wow_exe, "wb") as handle: + handle.write(b"original WoW input") + + output_exe = os.path.join(root, "WoW_Modernized.exe") + with open(output_exe, "wb") as handle: + handle.write(b"previous output") + + def fake_run(_tool, staging_target, tweaks_exe=None, modern_cli=False): + return self._write_exe( + staging_target, + b"\x75\x10", + b"\x75\x0B", + 0x27, + 1.919862, + b"64\x00\x00", + ) + + with mock.patch.object(WowSetupTool, "run_vanilla_tweaks", new=fake_run): + result_path = tool._run_vanilla_tweaks_transactional( + root, + tweaks_exe="fake-vanilla-tweaks.exe", + modern_cli=True, + ) + + self.assertEqual(result_path, output_exe) + with open(output_exe, "rb") as handle: + result = handle.read() + + self.assertEqual(result[0x0C1ECF:0x0C1ED1], b"\x74\x10") + self.assertEqual(result[0x0C2B25:0x0C2B27], b"\x74\x0B") + self.assertEqual(result[0x3A4869], 0x14) + self.assertAlmostEqual( + struct.unpack(" Date: Fri, 4 Sep 2026 11:21:16 +0200 Subject: [PATCH 081/101] Make Vanilla Tweaks selections fully authoritative --- setup_tool_dynamic.py | 1881 ++------------------ setup_tool_dynamic_core.py | 1750 ++++++++++++++++++ tests/test_vanilla_tweaks_normalization.py | 236 ++- 3 files changed, 2144 insertions(+), 1723 deletions(-) create mode 100644 setup_tool_dynamic_core.py diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 70c6330..27a290d 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -1,1129 +1,104 @@ +import math import os -import json -import shutil import struct -import tempfile import tkinter as tk -from tkinter import ttk, messagebox -import remote_packages -from setup_tool import WowSetupTool, ToolTip, get_base_path - - -class ModernWowSetupTool(WowSetupTool): - """Feature-branch entry point adding live GitHub package updates.""" - - def __init__(self, root): - # Define these before WowSetupTool.__init__ because the parent constructor - # calls self.build_ui(), which dispatches to our overridden Plugins tab. - self.classicapi_enabled = tk.BooleanVar(master=root, value=True) - self.auction_throttle_enabled = tk.BooleanVar(master=root, value=True) - self.vmmfix_enabled = tk.BooleanVar(master=root, value=False) - self.interact_enabled = tk.BooleanVar(master=root, value=False) - - # Discord Rich Presence detail choices are kept independently from the - # main WowPresence checkbox so hiding/disabling the integration never - # destroys the user's selected disclosure preferences. - self.discord_show_character_details = tk.BooleanVar(master=root, value=True) - self.discord_detail_vars = { - "name": tk.BooleanVar(master=root, value=True), - "guild": tk.BooleanVar(master=root, value=True), - "race": tk.BooleanVar(master=root, value=True), - "faction": tk.BooleanVar(master=root, value=True), - "class": tk.BooleanVar(master=root, value=True), - "level": tk.BooleanVar(master=root, value=True), - "zone": tk.BooleanVar(master=root, value=True), - } - self.discord_presence_details_frame = None - self.discord_detail_checkbuttons = {} - - self._download_window = None - self._download_label = None - self._download_detail = None - self._download_percent = None - self._download_bar = None - self._download_indeterminate = False - super().__init__(root) - - def _bundled_manifest_components(self): - metadata_path = os.path.join( - get_base_path(), - "Payload", - "Fallback", - "versions.json", - ) - try: - with open(metadata_path, "r", encoding="utf-8") as handle: - data = json.load(handle) - except (OSError, json.JSONDecodeError, ValueError, TypeError) as exc: - raise RuntimeError( - "Could not read bundled component integrity metadata." - ) from exc - - components = data.get("components") if isinstance(data, dict) else None - if not isinstance(components, dict): - raise RuntimeError("Bundled component integrity metadata is invalid.") - return components - - def _bundled_manifest_record(self, relative_path): - """Return the expected size/hash record for one bundled payload file.""" - wanted = relative_path.replace("\\", "/").casefold() - for component in self._bundled_manifest_components().values(): - files = component.get("files") if isinstance(component, dict) else None - if not isinstance(files, list): - continue - for record in files: - if not isinstance(record, dict): - continue - path = record.get("path") - if isinstance(path, str) and path.replace("\\", "/").casefold() == wanted: - return record - - raise RuntimeError( - f"No integrity record exists for bundled file {relative_path}." - ) - - def _bundled_manifest_component(self, component_name): - component = self._bundled_manifest_components().get(component_name) - if not isinstance(component, dict): - raise RuntimeError( - f"No bundled integrity metadata exists for {component_name}." - ) - return component - - def _verified_bundled_file(self, relative_path, label): - """Validate a bundled file before it is allowed to touch the WoW folder.""" - record = self._bundled_manifest_record(relative_path) - source = os.path.join( - get_base_path(), - *relative_path.replace("\\", "/").split("/"), - ) - if not os.path.isfile(source): - raise RuntimeError(f"Bundled file is missing: {relative_path}") - - expected_size = record.get("size") - if not isinstance(expected_size, int) or expected_size <= 0: - raise RuntimeError(f"Invalid bundled size metadata for {relative_path}.") - if os.path.getsize(source) != expected_size: - raise RuntimeError( - f"Bundled {label} has an unexpected size and will not be installed." - ) - - expected_sha = record.get("sha256") - if ( - not isinstance(expected_sha, str) - or len(expected_sha) != 64 - or any(ch not in "0123456789abcdefABCDEF" for ch in expected_sha) - ): - raise RuntimeError(f"Invalid bundled SHA-256 metadata for {relative_path}.") - expected_sha = expected_sha.lower() - - if self._file_sha256(source).lower() != expected_sha: - raise RuntimeError( - f"Bundled {label} failed its SHA-256 integrity check." - ) - - if os.path.splitext(source)[1].lower() in (".dll", ".exe"): - remote_packages._verify_x86_pe(source, f"bundled {label}") - - return source, expected_sha - - def _verified_bundled_tree( - self, - component_name, - records_key, - root_relative_path, - label, - ): - """Verify an exact bundled file tree using recorded canonical Git blob IDs.""" - component = self._bundled_manifest_component(component_name) - records = component.get(records_key) - if not isinstance(records, list) or not records: - raise RuntimeError(f"Missing bundled tree metadata for {label}.") - - root = os.path.join( - get_base_path(), - *root_relative_path.replace("\\", "/").split("/"), - ) - if not os.path.isdir(root): - raise RuntimeError(f"Bundled {label} folder is missing.") - - expected = {} - prefix = root_relative_path.replace("\\", "/").rstrip("/") + "/" - for record in records: - if not isinstance(record, dict): - raise RuntimeError(f"Invalid bundled tree metadata for {label}.") - path = record.get("path") - size = record.get("size") - blob_sha = record.get("git_blob_sha1") - if ( - not isinstance(path, str) - or not path.replace("\\", "/").startswith(prefix) - or not isinstance(size, int) - or size < 0 - or not isinstance(blob_sha, str) - or len(blob_sha) != 40 - or any(ch not in "0123456789abcdefABCDEF" for ch in blob_sha) - ): - raise RuntimeError(f"Invalid bundled tree metadata for {label}.") - key = path.replace("\\", "/").casefold() - if key in expected: - raise RuntimeError(f"Duplicate bundled tree metadata for {label}.") - expected[key] = (size, blob_sha.lower()) - - actual = {} - for current_root, dirs, files in os.walk(root): - dirs.sort(key=str.casefold) - files.sort(key=str.casefold) - for filename in files: - full_path = os.path.join(current_root, filename) - rel_from_root = os.path.relpath(full_path, root).replace(os.sep, "/") - manifest_path = prefix + rel_from_root - actual[manifest_path.casefold()] = full_path - - if set(actual) != set(expected): - raise RuntimeError( - f"Bundled {label} file set does not match its integrity metadata." - ) - - for key, full_path in actual.items(): - expected_size, expected_blob_sha = expected[key] - if os.path.getsize(full_path) != expected_size: - raise RuntimeError( - f"Bundled {label} contains a file with an unexpected size." - ) - if remote_packages._git_blob_sha1(full_path) != expected_blob_sha: - raise RuntimeError( - f"Bundled {label} failed its exact file integrity check." - ) - - return root - - def _install_verified_bundled_file(self, relative_path, target_path, label): - source, expected_sha = self._verified_bundled_file(relative_path, label) - if os.path.isfile(target_path): - try: - if self._file_sha256(target_path).lower() == expected_sha: - return - except OSError: - pass - remote_packages._atomic_replace_file(source, target_path) - - def copy_base_files(self, target): - """Install only true base files; component addons are handled with their DLLs.""" - payload_dir = os.path.join(get_base_path(), "Payload") - if not os.path.isdir(payload_dir): - return - - if self.install_autologin.get(): - data_source = os.path.join(payload_dir, "Data") - if os.path.isdir(data_source): - shutil.copytree( - data_source, - os.path.join(target, "Data"), - dirs_exist_ok=True, - ) - - # Do not copy Payload/Interface wholesale here. Nampower and UnitXP - # addons must stay paired with the exact DLL version selected later. - vanilla_fixes, vf_sha = self._verified_bundled_file( - "Payload/VanillaFixes.exe", - "VanillaFixes.exe", - ) - vf_patcher, patcher_sha = self._verified_bundled_file( - "Payload/VfPatcher.dll", - "VfPatcher.dll", - ) - target_fixes = os.path.join(target, "VanillaFixes.exe") - target_patcher = os.path.join(target, "VfPatcher.dll") - - already_current = False - if os.path.isfile(target_fixes) and os.path.isfile(target_patcher): - try: - already_current = ( - self._file_sha256(target_fixes).lower() == vf_sha - and self._file_sha256(target_patcher).lower() == patcher_sha - ) - except OSError: - already_current = False - - if not already_current: - remote_packages._transactional_replace_bundle( - [ - ("file", vanilla_fixes, target_fixes), - ("file", vf_patcher, target_patcher), - ], - label="VanillaFixes", - ) - - def _collect_settings(self): - settings = super()._collect_settings() - settings["discord_presence"] = { - "show_character_details": bool(self.discord_show_character_details.get()), - "details": { - name: bool(var.get()) - for name, var in self.discord_detail_vars.items() - }, - } - return settings - - def _apply_settings_dict(self, saved): - super()._apply_settings_dict(saved) - - discord = saved.get("discord_presence") if isinstance(saved, dict) else None - if not isinstance(discord, dict): - return - - show_details = discord.get("show_character_details") - if isinstance(show_details, bool): - self.discord_show_character_details.set(show_details) - - details = discord.get("details") - if isinstance(details, dict): - for name, value in details.items(): - var = self.discord_detail_vars.get(name) - if var is not None and isinstance(value, bool): - var.set(value) - - def _load_wowpresence_broadcast_preferences(self, target_dir): - """Migrate the old six-bit mask into the new seven-choice UI.""" - mask = remote_packages.read_wowpresence_broadcast_flags(target_dir) - if mask is None: - return - - bits = { - "name": remote_packages.WOWPRESENCE_SHARE_NAME, - "guild": remote_packages.WOWPRESENCE_SHARE_GUILD, - "faction": remote_packages.WOWPRESENCE_SHARE_FACTION, - "class": remote_packages.WOWPRESENCE_SHARE_CLASS, - "level": remote_packages.WOWPRESENCE_SHARE_LEVEL, - "zone": remote_packages.WOWPRESENCE_SHARE_ZONE, - } - for name, bit in bits.items(): - self.discord_detail_vars[name].set(bool(mask & bit)) - - # WowPresence versions before the dedicated Race flag always exposed - # race information regardless of the six-bit mask. Treat masks <= 63 - # as legacy so the migration preserves exactly that visible behavior. - if mask <= 63: - self.discord_detail_vars["race"].set(True) - else: - self.discord_detail_vars["race"].set( - bool(mask & remote_packages.WOWPRESENCE_SHARE_RACE) - ) - - # "Show character details" now means "show everything". Only select it - # automatically when the existing configuration already represents the - # full legacy/default disclosure set. Any custom mask stays custom. - legacy_all = ( - mask <= 63 - and (mask & 63) == 63 - ) - current_all = ( - mask > 63 - and (mask & remote_packages.WOWPRESENCE_SHARE_ALL) - == remote_packages.WOWPRESENCE_SHARE_ALL - ) - self.discord_show_character_details.set(legacy_all or current_all) - if self.discord_show_character_details.get(): - for var in self.discord_detail_vars.values(): - var.set(True) - - def _load_legacy_install_state(self, target_dir): - super()._load_legacy_install_state(target_dir) - self._load_wowpresence_broadcast_preferences(target_dir) - - def load_settings(self, target_dir): - settings_path = self._settings_path(target_dir) - has_saved_discord_preferences = False - try: - with open(settings_path, "r", encoding="utf-8") as handle: - saved = json.load(handle) - has_saved_discord_preferences = isinstance( - saved.get("discord_presence") if isinstance(saved, dict) else None, - dict, - ) - except (OSError, json.JSONDecodeError, ValueError, TypeError): - pass - - loaded = super().load_settings(target_dir) - - # Existing v2.1 settings.json files predate the detailed controls. Read - # their actual WowPresence mask once so manual choices are not lost. - if os.path.isfile(settings_path) and not has_saved_discord_preferences: - self._load_wowpresence_broadcast_preferences(target_dir) - - self.update_discord_presence_controls() - return loaded - - def _discord_broadcast_mask(self): - if self.discord_show_character_details.get(): - return remote_packages.WOWPRESENCE_SHARE_ALL - - bits = { - "name": remote_packages.WOWPRESENCE_SHARE_NAME, - "guild": remote_packages.WOWPRESENCE_SHARE_GUILD, - "race": remote_packages.WOWPRESENCE_SHARE_RACE, - "faction": remote_packages.WOWPRESENCE_SHARE_FACTION, - "class": remote_packages.WOWPRESENCE_SHARE_CLASS, - "level": remote_packages.WOWPRESENCE_SHARE_LEVEL, - "zone": remote_packages.WOWPRESENCE_SHARE_ZONE, - } - mask = 0 - for name, bit in bits.items(): - var = self.discord_detail_vars.get(name) - if var is not None and var.get(): - mask |= bit - return mask - - def _toggle_discord_all_details(self): - show_all = bool(self.discord_show_character_details.get()) - if show_all: - for var in self.discord_detail_vars.values(): - var.set(True) - self.update_discord_detail_states() - - def update_discord_detail_states(self): - state = "disabled" if self.discord_show_character_details.get() else "normal" - for checkbox in getattr(self, "discord_detail_checkbuttons", {}).values(): - try: - checkbox.configure(state=state) - except tk.TclError: - pass - - def update_discord_presence_controls(self): - frame = getattr(self, "discord_presence_details_frame", None) - if frame is None: - return - - var = self.optional_plugins.get("WowPresence.dll") - visible = bool(var is not None and var.get()) - manager = frame.winfo_manager() - - if visible and not manager: - frame.pack(fill="x", padx=(22, 8), pady=(0, 4)) - elif not visible and manager: - frame.pack_forget() - - if visible: - self.update_discord_detail_states() - - def _build_discord_presence_details(self, parent): - frame = ttk.Frame(parent) - self.discord_presence_details_frame = frame - - show_cb = ttk.Checkbutton( - frame, - text="Show character details", - variable=self.discord_show_character_details, - command=self._toggle_discord_all_details, - ) - show_cb.pack(anchor="w", padx=6, pady=(1, 2)) - ToolTip( - show_cb, - "When enabled, all character details are shown and the individual choices " - "below are locked. Uncheck it to choose each detail separately.", - ) - - labels = { - "name": "Character Name", - "guild": "Guild", - "race": "Race", - "faction": "Faction", - "class": "Class", - "level": "Level", - "zone": "Zone", - } - for name, label in labels.items(): - cb = ttk.Checkbutton( - frame, - text=label, - variable=self.discord_detail_vars[name], - ) - cb.pack(anchor="w", padx=24, pady=1) - self.discord_detail_checkbuttons[name] = cb - ToolTip( - cb, - f"Choose whether WowPresence may publish your {label.lower()} on Discord.", - ) - - self.update_discord_presence_controls() - - def _show_download_progress(self): - if self._download_window is not None and self._download_window.winfo_exists(): - return - - win = tk.Toplevel(self.root) - win.title("Updating components") - win.resizable(False, False) - win.transient(self.root) - win.protocol("WM_DELETE_WINDOW", lambda: None) - - frame = ttk.Frame(win, padding=18) - frame.pack(fill="both", expand=True) - frame.columnconfigure(0, weight=1) - - title = ttk.Label( - frame, - text="Updating selected components", - font=("Segoe UI", 11, "bold"), - anchor="w", - ) - title.grid(row=0, column=0, columnspan=2, sticky="ew", pady=(0, 8)) - - self._download_label = ttk.Label( - frame, - text="Preparing updates...", - font=("Segoe UI", 9, "bold"), - anchor="w", - ) - self._download_label.grid(row=1, column=0, sticky="w", pady=(0, 4)) - - self._download_percent = ttk.Label( - frame, - text="", - font=("Segoe UI", 9, "bold"), - anchor="e", - width=6, - ) - self._download_percent.grid(row=1, column=1, sticky="e", pady=(0, 4)) - - self._download_detail = ttk.Label( - frame, - text="Please wait while files are downloaded and installed.", - anchor="w", - foreground="#666666", - ) - self._download_detail.grid(row=2, column=0, columnspan=2, sticky="ew", pady=(0, 10)) - - self._download_bar = ttk.Progressbar( - frame, - orient="horizontal", - mode="indeterminate", - length=460, - ) - self._download_bar.grid(row=3, column=0, columnspan=2, sticky="ew") - - self._download_window = win - - win.update_idletasks() - width = max(win.winfo_reqwidth(), 520) - height = max(win.winfo_reqheight(), 155) - x = self.root.winfo_rootx() + max((self.root.winfo_width() - width) // 2, 0) - y = self.root.winfo_rooty() + max((self.root.winfo_height() - height) // 2, 0) - win.geometry(f"{width}x{height}+{x}+{y}") - win.lift() - try: - # Keep checkboxes and folder selection from changing underneath a - # synchronous installation while progress callbacks pump Tk events. - win.grab_set() - except tk.TclError: - pass - - # update(), not only update_idletasks(), is intentional here: downloads - # run synchronously on the main thread, so Windows otherwise paints an - # empty Toplevel until the operation completes. - win.update() - - def _report_download_progress(self, message, current=None, total=None): - self._show_download_progress() - - if self._download_window is None or not self._download_window.winfo_exists(): - return - - self._download_label.configure(text=message) - - if total is not None and total > 0 and current is not None: - if self._download_indeterminate: - self._download_bar.stop() - self._download_indeterminate = False - - self._download_bar.configure(mode="determinate", maximum=total) - self._download_bar["value"] = min(current, total) - percent = int(min(current, total) * 100 / total) - self._download_percent.configure(text=f"{percent}%") - - downloaded_mb = current / (1024 * 1024) - total_mb = total / (1024 * 1024) - self._download_detail.configure( - text=f"{downloaded_mb:.1f} MB / {total_mb:.1f} MB" - ) - else: - self._download_percent.configure(text="") - self._download_detail.configure( - text="Checking, extracting or installing..." - ) - if not self._download_indeterminate: - self._download_bar.configure(mode="indeterminate") - self._download_bar.start(12) - self._download_indeterminate = True - - # Process paint/timer events while the synchronous network operation is - # running so the status text and progress bar remain visible. - try: - self._download_window.update() - except tk.TclError: - pass - - def _close_download_progress(self): - if self._download_bar is not None and self._download_indeterminate: - try: - self._download_bar.stop() - except tk.TclError: - pass - - if self._download_window is not None: - try: - if self._download_window.winfo_exists(): - try: - self._download_window.grab_release() - except tk.TclError: - pass - self._download_window.destroy() - except tk.TclError: - pass - - self._download_window = None - self._download_label = None - self._download_detail = None - self._download_percent = None - self._download_bar = None - self._download_indeterminate = False - - def _plugin_row(self, parent, text, variable, attribution, tooltip, command=None): - row = ttk.Frame(parent) - row.pack(fill="x", padx=10, pady=2) - - cb = ttk.Checkbutton(row, text=text, variable=variable, command=command) - cb.pack(side="left") - ToolTip(cb, tooltip) - - byline = ttk.Label( - row, - text=attribution, - font=("Segoe UI", 7, "italic"), - ) - byline.pack(side="right", padx=(6, 0)) - - return cb - - def _select_no1600(self): - if self.optional_plugins["no1600x1200.dll"].get(): - self.vmmfix_enabled.set(False) - - def _select_vmmfix(self): - if self.vmmfix_enabled.get(): - self.optional_plugins["no1600x1200.dll"].set(False) - - def build_plugins_tab(self, parent): - container = ttk.Frame(parent) - container.pack(fill="both", expand=True, padx=10, pady=10) - - left_frame = ttk.LabelFrame(container, text="Recommended Core") - left_frame.pack(side="left", fill="both", expand=True, padx=(0, 5)) - - ttk.Label( - left_frame, - text="These are highly recommended for performance\nand client stability.", - font=("", 8, "italic"), - ).pack(anchor="w", padx=10, pady=10) - - core_display = { - "nampower.dll": ("Nampower", "by brues-code"), - "UnitXP_SP3.dll": ("UnitXP SP3", "by brues-code"), - "SuperWoWhook.dll": ("SuperWoW", "by balakethelock"), - "transmogfix.dll": ("TransmogFix", "by MarcelineVQ"), - "perf_boost.dll": ("PerfBoost", "by avitasia"), - "weirdperformance.dll": ("WeirdPerformance", "by Dusk-92"), - "VanillaHelpers.dll": ("VanillaHelpers", "by isfir"), - } - - for dll, var in self.core_plugins.items(): - display_name, attribution = core_display.get( - dll, - (os.path.splitext(dll)[0], "") - ) - self._plugin_row( - left_frame, - display_name, - var, - attribution, - self.descriptions.get(dll, ""), - ) - - self._plugin_row( - left_frame, - "ClassicAPI", - self.classicapi_enabled, - "by brues-code", - "Adds newer WoW API functions to the Vanilla client so more modern addons can work.", - ) - - self._plugin_row( - left_frame, - "AuctionQueryThrottle", - self.auction_throttle_enabled, - "by brues-code", - "Makes Auction House searches much faster by removing the fixed 5-second wait between queries.", - ) - - right_frame = ttk.LabelFrame(container, text="Optional") - right_frame.pack(side="right", fill="both", expand=True, padx=(5, 0)) - - ttk.Label( - right_frame, - text="Optional client-side fixes and quality-of-life enhancements.", - font=("", 8, "italic"), - wraplength=260, - ).pack(anchor="w", padx=10, pady=10) - - no1600_var = self.optional_plugins["no1600x1200.dll"] - self._plugin_row( - right_frame, - "No1600x1200", - no1600_var, - "source: RetroCro", - self.descriptions.get("no1600x1200.dll", ""), - command=self._select_no1600, - ) - - self._plugin_row( - right_frame, - "VanillaMultiMonitorFix", - self.vmmfix_enabled, - "by Mates1500", - "Fixes resolution and refresh-rate detection on multi-monitor setups with different display modes. Uses VMMFix_preferred_monitor.txt to select the preferred display.", - command=self._select_vmmfix, - ) - - self._plugin_row( - right_frame, - "Interact", - self.interact_enabled, - "by lookino", - "Adds a modern Interact key for nearby objects, gathering nodes and loot without precise mouse clicking.", - ) - - optional_display = { - "bigcursor.dll": "BigCursor", - "customassets.dll": "CustomAssets", - "logsessions.dll": "LogSessions", - "minimapicons.dll": "MinimapIcons", - "pngscreenshots.dll": "PNG Screenshots", - "worldmarkers.dll": "WorldMarkers", - "WowPresence.dll": "Discord Rich Presence", - } - optional_attribution = { - "WowPresence.dll": "by Dusk-92", - } - - for dll, var in self.optional_plugins.items(): - if dll == "no1600x1200.dll": - continue - - command = ( - self.update_discord_presence_controls - if dll == "WowPresence.dll" - else None - ) - self._plugin_row( - right_frame, - optional_display.get(dll, os.path.splitext(dll)[0]), - var, - optional_attribution.get(dll, "by MarcelineVQ"), - self.descriptions.get(dll, ""), - command=command, - ) - - if dll == "WowPresence.dll": - self._build_discord_presence_details(right_frame) - - def clean_unselected_files(self, target): - super().clean_unselected_files(target) - - managed = { - "ClassicAPI.dll": self.classicapi_enabled, - "AuctionQueryThrottle.dll": self.auction_throttle_enabled, - "VanillaMultiMonitorFix.dll": self.vmmfix_enabled, - "Interact.dll": self.interact_enabled, - } - - # Remove each live core DLL independently when its checkbox is off. - for filename, var in managed.items(): - if not var.get(): - path = os.path.join(target, filename) - if os.path.exists(path): - try: - os.remove(path) - except OSError as exc: - raise RuntimeError( - f"Could not remove {filename}. Close WoW and any tool using the file, then try again." - ) from exc - - if not self.interact_enabled.get(): - addon_path = os.path.join(target, "Interface", "AddOns", "Interact") - if os.path.exists(addon_path): - shutil.rmtree(addon_path, ignore_errors=True) - - def _warn_offline(self, component, action, error): - self._close_download_progress() - messagebox.showwarning( - "Online update unavailable", - f"Could not download the latest {component}.\n\n" - f"{action}\n\nDetails: {error}", - ) - - def _valid_x86_dll(self, path, label): - if not os.path.isfile(path): - return False - try: - remote_packages._verify_x86_pe(path, label) - return True - except Exception: - return False - - def _prepare_wowpresence_managed_state(self, target): - """Force legacy tool-managed installs without hashes through a safe refresh.""" - trust_state = remote_packages.wowpresence_install_trust_state(target) - if trust_state == "managed_unverified": - remote_packages._set_managed_manifest_values( - target, - remote_packages.WOWPRESENCE_MANAGED_ID, - revision="__legacy_unverified__", - ) - return trust_state - - def _wowpresence_source_failure(self, error): - """Distinguish unusable remote packages from local install/write failures.""" - messages = [] - current = error - seen = set() - while current is not None and id(current) not in seen: - seen.add(id(current)) - messages.append(str(current)) - current = ( - current.__cause__ - if current.__cause__ is not None - else current.__context__ - ) - - text = "\n".join(messages) - source_markers = ( - "GitHub request failed:", - "latest release is not a stable release", - "Could not find WowPresence.zip in release", - "Release asset WowPresence.zip has no download URL", - "Download failed for WowPresence.zip:", - "SHA-256 mismatch for downloaded file", - "Unsafe ZIP path:", - "WowPresence.dll was not found in downloaded archive.", - "WowPresence.exe was not found in downloaded archive.", - "WowPresence.dll is ", - "WowPresence.dll has ", - "WowPresence.exe is ", - "WowPresence.exe has ", - "File is not a zip file", - "Bad magic number for file header", - ) - return any(marker in text for marker in source_markers) - - def _install_wowpresence_with_fallback(self, target): - """Use offline recovery only for remote-source failures, never local ones.""" - self._prepare_wowpresence_managed_state(target) - try: - return remote_packages.install_wowpresence( - target, - progress=self._report_download_progress, - ) - except Exception as exc: - if not self._wowpresence_source_failure(exc): - raise RuntimeError( - f"WowPresence installation failed locally:\n{exc}" - ) from exc - self._recover_wowpresence_offline(target, exc) - return None - - def _recover_wowpresence_offline(self, target, error): - """Preserve only trusted/manual-valid WowPresence; repair modified managed files.""" - trust_state = remote_packages.wowpresence_install_trust_state(target) - existing_dll = os.path.join(target, "WowPresence.dll") - existing_exe = os.path.join(target, "WowPresence.exe") - existing_pair_valid = ( - self._valid_x86_dll(existing_dll, "WowPresence.dll") - and self._valid_x86_dll(existing_exe, "WowPresence.exe") - ) - - if trust_state == "managed_verified": - remote_packages.ensure_wowpresence_config(target) - remote_packages.cache_installed_wowpresence(target) - self._warn_offline( - "WowPresence", - "Keeping the hash-verified WowPresence binaries already managed by the Tool.", - error, - ) - return - - if trust_state == "unmanaged" and existing_pair_valid: - remote_packages.ensure_wowpresence_config(target) - self._warn_offline( - "WowPresence", - ( - "Keeping the existing valid WowPresence binaries unchanged. " - "They were not promoted into the validated fallback cache." - ), - error, - ) - return - - try: - remote_packages.install_cached_wowpresence( - target, - progress=self._report_download_progress, - ) - fallback_action = ( - "The last validated cached WowPresence package was installed instead." - ) - except Exception: - try: - remote_packages.install_bundled_wowpresence( - target, - progress=self._report_download_progress, - ) - fallback_action = ( - "The bundled known-good WowPresence fallback was installed instead." - ) - except Exception as bundled_exc: - raise RuntimeError( - "Could not install WowPresence from its online source, " - "local cache or bundled fallback." - ) from bundled_exc - - self._warn_offline( - "WowPresence", - fallback_action, - error, - ) - - def _valid_superapi_addon(self, addon_path): - """Reject empty/partial SuperAPI folders before treating them as usable.""" - required = ( - "SuperAPI.toc", - "SuperAPI.lua", - "SuperAPIOptions.lua", - ) - if not os.path.isdir(addon_path): - return False - if any(not os.path.isfile(os.path.join(addon_path, name)) for name in required): - return False - - toc_path = os.path.join(addon_path, "SuperAPI.toc") - try: - with open(toc_path, "r", encoding="utf-8", errors="ignore") as handle: - lines = handle.readlines() - except OSError: - return False - - for raw in lines: - line = raw.strip() - if not line or line.startswith("#"): - continue - normalized = line.replace("\\", os.sep).replace("/", os.sep) - if normalized.startswith(".." + os.sep) or os.path.isabs(normalized): - return False - extension = os.path.splitext(normalized)[1].lower() - if extension in (".lua", ".xml") and not os.path.isfile( - os.path.join(addon_path, normalized) - ): - return False - return True - - def _fallback_core_dll(self, payload_base, target, dll_name, error): - source_dll = os.path.join(payload_base, dll_name) - target_dll = os.path.join(target, dll_name) - addon_folder = self.addon_dependencies.get(dll_name) - target_addon = ( - os.path.join(target, "Interface", "AddOns", addon_folder) - if addon_folder - else None - ) - - # Never downgrade a complete existing install because an upstream link - # happens to be unavailable during an update. - addon_complete = ( - target_addon is None - or ( - self._valid_superapi_addon(target_addon) - if addon_folder == "SuperAPI" - else os.path.isdir(target_addon) - ) - ) - existing_complete = self._valid_x86_dll( - target_dll, - f"installed {dll_name}", - ) and addon_complete - if existing_complete: - self._warn_offline( - dll_name, - "The version already installed in your WoW folder was kept unchanged.", - error, - ) - return - - if not os.path.isfile(source_dll): - raise RuntimeError( - f"Could not download the latest {dll_name}, and no bundled fallback exists.\n\n{error}" - ) from error - - self._verified_bundled_file( - f"Payload/{dll_name}", - f"{dll_name} fallback", - ) - - source_addon = None - if addon_folder: - source_addon = os.path.join(payload_base, "Interface", "Addons", addon_folder) - if not os.path.isdir(source_addon): - raise RuntimeError( - f"Could not download the latest {dll_name}, and its bundled fallback addon " - f"{addon_folder} is missing.\n\n{error}" - ) from error - if addon_folder == "SuperAPI": - source_addon = self._verified_bundled_tree( - "SuperWoW fallback", - "superapi_files", - "Payload/Interface/Addons/SuperAPI", - "SuperAPI fallback", - ) - - if addon_folder and source_addon: - remote_packages._transactional_replace_bundle( - [ - ("file", source_dll, target_dll), - ("dir", source_addon, target_addon), - ], - label=f"{dll_name} bundled fallback", - ) - else: - remote_packages._atomic_replace_file(source_dll, target_dll) - - self._warn_offline( - dll_name, - "The bundled known-good backup was installed instead.", - error, - ) - - def _fallback_simple_dll(self, target, dll_name, error): - target_dll = os.path.join(target, dll_name) - if self._valid_x86_dll(target_dll, f"installed {dll_name}"): - self._warn_offline( - dll_name, - "The version already installed in your WoW folder was kept unchanged.", - error, - ) - return - - fallback = os.path.join(get_base_path(), "Payload", "Fallback", dll_name) - if not os.path.isfile(fallback): - raise RuntimeError( - f"Could not download the latest {dll_name}, and its bundled backup is missing.\n\n{error}" - ) from error - - remote_packages._verify_x86_pe( - fallback, - f"bundled fallback {dll_name}", - ) - remote_packages._atomic_replace_file(fallback, target_dll) - self._warn_offline( - dll_name, - "The bundled known-good backup was installed instead.", - error, - ) - - def _fallback_vmmfix(self, target, error): - target_dll = os.path.join(target, "VanillaMultiMonitorFix.dll") - if self._valid_x86_dll( - target_dll, - "installed VanillaMultiMonitorFix.dll", - ): - self._warn_offline( - "VanillaMultiMonitorFix", - "The version already installed in your WoW folder was kept unchanged.", - error, - ) - return - - fallback_dir = os.path.join( - get_base_path(), "Payload", "Fallback", "VanillaMultiMonitorFix" - ) - fallback_dll = os.path.join(fallback_dir, "VanillaMultiMonitorFix.dll") - fallback_config = os.path.join(fallback_dir, "VMMFix_preferred_monitor.txt") - if not os.path.isfile(fallback_dll): - raise RuntimeError( - f"VanillaMultiMonitorFix update failed and its bundled backup is missing.\n\n{error}" - ) from error - - remote_packages._verify_x86_pe( - fallback_dll, - "bundled fallback VanillaMultiMonitorFix.dll", - ) - remote_packages._atomic_replace_file(fallback_dll, target_dll) - target_config = os.path.join(target, "VMMFix_preferred_monitor.txt") - if not os.path.exists(target_config) and os.path.isfile(fallback_config): - shutil.copy2(fallback_config, target_config) - - self._warn_offline( - "VanillaMultiMonitorFix", - "The bundled known-good backup was installed instead.", - error, - ) - - def _fallback_interact(self, target, error): - target_dll = os.path.join(target, "Interact.dll") - target_addon = os.path.join(target, "Interface", "AddOns", "Interact") - if ( - self._valid_x86_dll(target_dll, "installed Interact.dll") - and os.path.isdir(target_addon) - ): - self._warn_offline( - "Interact", - "The version already installed in your WoW folder was kept unchanged.", - error, - ) - return - - fallback_dir = os.path.join(get_base_path(), "Payload", "Fallback", "Interact") - fallback_dll = os.path.join(fallback_dir, "Interact.dll") - fallback_addon = os.path.join(fallback_dir, "Addon") - if not os.path.isfile(fallback_dll) or not os.path.isdir(fallback_addon): - raise RuntimeError( - f"Interact update failed and its bundled backup is incomplete.\n\n{error}" - ) from error - - remote_packages._verify_x86_pe( - fallback_dll, - "bundled fallback Interact.dll", - ) - remote_packages._transactional_replace_bundle( - [ - ("file", fallback_dll, target_dll), - ("dir", fallback_addon, target_addon), - ], - label="Interact bundled fallback", - ) - self._warn_offline( - "Interact", - "The bundled known-good backup was installed instead.", - error, - ) +# Keep the feature-branch implementation intact and layer only the executable +# normalization policy here. This makes the B-total policy easy to audit and +# keeps every unrelated remote/fallback behavior byte-for-byte unchanged. +from setup_tool_dynamic_core import * # noqa: F401,F403 +from setup_tool_dynamic_core import ModernWowSetupTool as _ModernWowSetupToolCore + + +_CAMERA_REGIONS = ( + ( + 0x02CCD0, + bytes.fromhex( + "55 8b ec 83 ec 10 8d 45 f0 50 33 c9 e8 4f 8f 00 " + "00 50 ff 15 64 f6 7f 00 8b 45 f8 99 2b c2 8b c8 " + "8b 45 fc 99 2b c2 d1 f8 d1 f9 50 51 89 0d 38 4e " + "88 00 a3 3c 4e 88 00 ff 15 5c f6 7f 00 8b e5 5d " + "c3 90 90" + ), + bytes.fromhex( + "55 8b 05 48 4e 88 00 8b 0d 44 4e 88 00 e9 33 90 " + "32 00 83 c0 32 83 c1 32 3b 0d a8 eb c4 00 7e 03 " + "83 e9 01 3b 05 ac eb c4 00 7e 03 83 e8 01 83 e9 " + "32 83 e8 32 89 05 48 4e 88 00 89 0d 44 4e 88 00 " + "5d eb 0d" + ), + ), + ( + 0x02D326, + bytes.fromhex("8b 45 f0 8b 15"), + bytes.fromhex("e9 b1 8a 32 00"), + ), + ( + 0x02D334, + bytes.fromhex("8b 35 3c 4e 88 00"), + bytes.fromhex("8b 35 48 4e 88 00"), + ), + ( + 0x355D15, + bytes.fromhex( + "cc cc cc cc cc cc cc cc cc cc cc cc cc cc cc cc " + "cc cc cc cc cc" + ), + bytes.fromhex( + "83 f8 32 7d 03 83 c0 01 83 f9 32 7d 03 83 c1 01 " + "e9 b8 6f cd ff" + ), + ), + ( + 0x355DDC, + bytes.fromhex( + "cc cc cc cc cc cc cc cc cc cc cc cc cc cc cc cc " + "cc cc cc cc cc cc cc cc cc cc cc cc cc cc" + ), + bytes.fromhex( + "8d 4d f0 51 ff 35 00 4e 88 00 ff 15 50 f6 7f 00 " + "8b 45 f0 8b 15 44 4e 88 00 e9 35 75 cd ff" + ), + ), +) + +_CUSTOM_GLUES_SITES = ( + (0x2F113A, 0x5F, 0xEB), + (0x2F113B, 0x5E, 0x19), + (0x2F1158, 0x01, 0x03), + (0x2F11A7, 0x01, 0x03), + (0x2F11F0, 0x5F, 0xEB), + (0x2F11F1, 0x5E, 0xB2), +) + + +class ModernWowSetupTool(_ModernWowSetupToolCore): + """Remote-fallback tool with authoritative, fail-safe Vanilla Tweaks output.""" def _vanilla_tweaks_signature(self): - """Version output normalization independently from the SuperWoW checkbox.""" signature = super()._vanilla_tweaks_signature() - signature["selected_patch_normalization"] = 1 + # v2 expands normalization from the original selected subset to every + # executable tweak exposed by the Tool except the two intentionally + # legacy upstream-only patches (Blue Moon and Cross-faction Res). + signature["selected_patch_normalization"] = 2 return signature + @staticmethod + def _validate_float_field(data, offset, label, minimum, maximum): + current = struct.unpack_from(" 4: + raise RuntimeError("Sound Channels value is outside the supported WoW 1.12.1 range.") + + # All validation passed. Apply the exact Tool selections in memory. + desired_quickloot_opcode = 0x75 if self.vt_quickloot.get() else 0x74 + for offset, displacement in quickloot_sites: + data[offset:offset + 2] = bytes( + (desired_quickloot_opcode, displacement) + ) + data[0x3A4869] = 0x27 if self.vt_bg_sound.get() else 0x14 + data[0x126:0x128] = b"\x2F\x01" if self.vt_laa.get() else b"\x0F\x01" - data[0x4089B4:0x4089B8] = struct.pack(" 4: - raise RuntimeError("Sound Channels value is too large for the WoW 1.12.1 field.") + desired_custom_patched = bool(self.vt_custom_glues.get()) + for offset, original, patched in _CUSTOM_GLUES_SITES: + data[offset] = patched if desired_custom_patched else original + + struct.pack_into(" 63 + and (mask & remote_packages.WOWPRESENCE_SHARE_ALL) + == remote_packages.WOWPRESENCE_SHARE_ALL + ) + self.discord_show_character_details.set(legacy_all or current_all) + if self.discord_show_character_details.get(): + for var in self.discord_detail_vars.values(): + var.set(True) + + def _load_legacy_install_state(self, target_dir): + super()._load_legacy_install_state(target_dir) + self._load_wowpresence_broadcast_preferences(target_dir) + + def load_settings(self, target_dir): + settings_path = self._settings_path(target_dir) + has_saved_discord_preferences = False + try: + with open(settings_path, "r", encoding="utf-8") as handle: + saved = json.load(handle) + has_saved_discord_preferences = isinstance( + saved.get("discord_presence") if isinstance(saved, dict) else None, + dict, + ) + except (OSError, json.JSONDecodeError, ValueError, TypeError): + pass + + loaded = super().load_settings(target_dir) + + # Existing v2.1 settings.json files predate the detailed controls. Read + # their actual WowPresence mask once so manual choices are not lost. + if os.path.isfile(settings_path) and not has_saved_discord_preferences: + self._load_wowpresence_broadcast_preferences(target_dir) + + self.update_discord_presence_controls() + return loaded + + def _discord_broadcast_mask(self): + if self.discord_show_character_details.get(): + return remote_packages.WOWPRESENCE_SHARE_ALL + + bits = { + "name": remote_packages.WOWPRESENCE_SHARE_NAME, + "guild": remote_packages.WOWPRESENCE_SHARE_GUILD, + "race": remote_packages.WOWPRESENCE_SHARE_RACE, + "faction": remote_packages.WOWPRESENCE_SHARE_FACTION, + "class": remote_packages.WOWPRESENCE_SHARE_CLASS, + "level": remote_packages.WOWPRESENCE_SHARE_LEVEL, + "zone": remote_packages.WOWPRESENCE_SHARE_ZONE, + } + mask = 0 + for name, bit in bits.items(): + var = self.discord_detail_vars.get(name) + if var is not None and var.get(): + mask |= bit + return mask + + def _toggle_discord_all_details(self): + show_all = bool(self.discord_show_character_details.get()) + if show_all: + for var in self.discord_detail_vars.values(): + var.set(True) + self.update_discord_detail_states() + + def update_discord_detail_states(self): + state = "disabled" if self.discord_show_character_details.get() else "normal" + for checkbox in getattr(self, "discord_detail_checkbuttons", {}).values(): + try: + checkbox.configure(state=state) + except tk.TclError: + pass + + def update_discord_presence_controls(self): + frame = getattr(self, "discord_presence_details_frame", None) + if frame is None: + return + + var = self.optional_plugins.get("WowPresence.dll") + visible = bool(var is not None and var.get()) + manager = frame.winfo_manager() + + if visible and not manager: + frame.pack(fill="x", padx=(22, 8), pady=(0, 4)) + elif not visible and manager: + frame.pack_forget() + + if visible: + self.update_discord_detail_states() + + def _build_discord_presence_details(self, parent): + frame = ttk.Frame(parent) + self.discord_presence_details_frame = frame + + show_cb = ttk.Checkbutton( + frame, + text="Show character details", + variable=self.discord_show_character_details, + command=self._toggle_discord_all_details, + ) + show_cb.pack(anchor="w", padx=6, pady=(1, 2)) + ToolTip( + show_cb, + "When enabled, all character details are shown and the individual choices " + "below are locked. Uncheck it to choose each detail separately.", + ) + + labels = { + "name": "Character Name", + "guild": "Guild", + "race": "Race", + "faction": "Faction", + "class": "Class", + "level": "Level", + "zone": "Zone", + } + for name, label in labels.items(): + cb = ttk.Checkbutton( + frame, + text=label, + variable=self.discord_detail_vars[name], + ) + cb.pack(anchor="w", padx=24, pady=1) + self.discord_detail_checkbuttons[name] = cb + ToolTip( + cb, + f"Choose whether WowPresence may publish your {label.lower()} on Discord.", + ) + + self.update_discord_presence_controls() + + def _show_download_progress(self): + if self._download_window is not None and self._download_window.winfo_exists(): + return + + win = tk.Toplevel(self.root) + win.title("Updating components") + win.resizable(False, False) + win.transient(self.root) + win.protocol("WM_DELETE_WINDOW", lambda: None) + + frame = ttk.Frame(win, padding=18) + frame.pack(fill="both", expand=True) + frame.columnconfigure(0, weight=1) + + title = ttk.Label( + frame, + text="Updating selected components", + font=("Segoe UI", 11, "bold"), + anchor="w", + ) + title.grid(row=0, column=0, columnspan=2, sticky="ew", pady=(0, 8)) + + self._download_label = ttk.Label( + frame, + text="Preparing updates...", + font=("Segoe UI", 9, "bold"), + anchor="w", + ) + self._download_label.grid(row=1, column=0, sticky="w", pady=(0, 4)) + + self._download_percent = ttk.Label( + frame, + text="", + font=("Segoe UI", 9, "bold"), + anchor="e", + width=6, + ) + self._download_percent.grid(row=1, column=1, sticky="e", pady=(0, 4)) + + self._download_detail = ttk.Label( + frame, + text="Please wait while files are downloaded and installed.", + anchor="w", + foreground="#666666", + ) + self._download_detail.grid(row=2, column=0, columnspan=2, sticky="ew", pady=(0, 10)) + + self._download_bar = ttk.Progressbar( + frame, + orient="horizontal", + mode="indeterminate", + length=460, + ) + self._download_bar.grid(row=3, column=0, columnspan=2, sticky="ew") + + self._download_window = win + + win.update_idletasks() + width = max(win.winfo_reqwidth(), 520) + height = max(win.winfo_reqheight(), 155) + x = self.root.winfo_rootx() + max((self.root.winfo_width() - width) // 2, 0) + y = self.root.winfo_rooty() + max((self.root.winfo_height() - height) // 2, 0) + win.geometry(f"{width}x{height}+{x}+{y}") + win.lift() + try: + # Keep checkboxes and folder selection from changing underneath a + # synchronous installation while progress callbacks pump Tk events. + win.grab_set() + except tk.TclError: + pass + + # update(), not only update_idletasks(), is intentional here: downloads + # run synchronously on the main thread, so Windows otherwise paints an + # empty Toplevel until the operation completes. + win.update() + + def _report_download_progress(self, message, current=None, total=None): + self._show_download_progress() + + if self._download_window is None or not self._download_window.winfo_exists(): + return + + self._download_label.configure(text=message) + + if total is not None and total > 0 and current is not None: + if self._download_indeterminate: + self._download_bar.stop() + self._download_indeterminate = False + + self._download_bar.configure(mode="determinate", maximum=total) + self._download_bar["value"] = min(current, total) + percent = int(min(current, total) * 100 / total) + self._download_percent.configure(text=f"{percent}%") + + downloaded_mb = current / (1024 * 1024) + total_mb = total / (1024 * 1024) + self._download_detail.configure( + text=f"{downloaded_mb:.1f} MB / {total_mb:.1f} MB" + ) + else: + self._download_percent.configure(text="") + self._download_detail.configure( + text="Checking, extracting or installing..." + ) + if not self._download_indeterminate: + self._download_bar.configure(mode="indeterminate") + self._download_bar.start(12) + self._download_indeterminate = True + + # Process paint/timer events while the synchronous network operation is + # running so the status text and progress bar remain visible. + try: + self._download_window.update() + except tk.TclError: + pass + + def _close_download_progress(self): + if self._download_bar is not None and self._download_indeterminate: + try: + self._download_bar.stop() + except tk.TclError: + pass + + if self._download_window is not None: + try: + if self._download_window.winfo_exists(): + try: + self._download_window.grab_release() + except tk.TclError: + pass + self._download_window.destroy() + except tk.TclError: + pass + + self._download_window = None + self._download_label = None + self._download_detail = None + self._download_percent = None + self._download_bar = None + self._download_indeterminate = False + + def _plugin_row(self, parent, text, variable, attribution, tooltip, command=None): + row = ttk.Frame(parent) + row.pack(fill="x", padx=10, pady=2) + + cb = ttk.Checkbutton(row, text=text, variable=variable, command=command) + cb.pack(side="left") + ToolTip(cb, tooltip) + + byline = ttk.Label( + row, + text=attribution, + font=("Segoe UI", 7, "italic"), + ) + byline.pack(side="right", padx=(6, 0)) + + return cb + + def _select_no1600(self): + if self.optional_plugins["no1600x1200.dll"].get(): + self.vmmfix_enabled.set(False) + + def _select_vmmfix(self): + if self.vmmfix_enabled.get(): + self.optional_plugins["no1600x1200.dll"].set(False) + + def build_plugins_tab(self, parent): + container = ttk.Frame(parent) + container.pack(fill="both", expand=True, padx=10, pady=10) + + left_frame = ttk.LabelFrame(container, text="Recommended Core") + left_frame.pack(side="left", fill="both", expand=True, padx=(0, 5)) + + ttk.Label( + left_frame, + text="These are highly recommended for performance\nand client stability.", + font=("", 8, "italic"), + ).pack(anchor="w", padx=10, pady=10) + + core_display = { + "nampower.dll": ("Nampower", "by brues-code"), + "UnitXP_SP3.dll": ("UnitXP SP3", "by brues-code"), + "SuperWoWhook.dll": ("SuperWoW", "by balakethelock"), + "transmogfix.dll": ("TransmogFix", "by MarcelineVQ"), + "perf_boost.dll": ("PerfBoost", "by avitasia"), + "weirdperformance.dll": ("WeirdPerformance", "by Dusk-92"), + "VanillaHelpers.dll": ("VanillaHelpers", "by isfir"), + } + + for dll, var in self.core_plugins.items(): + display_name, attribution = core_display.get( + dll, + (os.path.splitext(dll)[0], "") + ) + self._plugin_row( + left_frame, + display_name, + var, + attribution, + self.descriptions.get(dll, ""), + ) + + self._plugin_row( + left_frame, + "ClassicAPI", + self.classicapi_enabled, + "by brues-code", + "Adds newer WoW API functions to the Vanilla client so more modern addons can work.", + ) + + self._plugin_row( + left_frame, + "AuctionQueryThrottle", + self.auction_throttle_enabled, + "by brues-code", + "Makes Auction House searches much faster by removing the fixed 5-second wait between queries.", + ) + + right_frame = ttk.LabelFrame(container, text="Optional") + right_frame.pack(side="right", fill="both", expand=True, padx=(5, 0)) + + ttk.Label( + right_frame, + text="Optional client-side fixes and quality-of-life enhancements.", + font=("", 8, "italic"), + wraplength=260, + ).pack(anchor="w", padx=10, pady=10) + + no1600_var = self.optional_plugins["no1600x1200.dll"] + self._plugin_row( + right_frame, + "No1600x1200", + no1600_var, + "source: RetroCro", + self.descriptions.get("no1600x1200.dll", ""), + command=self._select_no1600, + ) + + self._plugin_row( + right_frame, + "VanillaMultiMonitorFix", + self.vmmfix_enabled, + "by Mates1500", + "Fixes resolution and refresh-rate detection on multi-monitor setups with different display modes. Uses VMMFix_preferred_monitor.txt to select the preferred display.", + command=self._select_vmmfix, + ) + + self._plugin_row( + right_frame, + "Interact", + self.interact_enabled, + "by lookino", + "Adds a modern Interact key for nearby objects, gathering nodes and loot without precise mouse clicking.", + ) + + optional_display = { + "bigcursor.dll": "BigCursor", + "customassets.dll": "CustomAssets", + "logsessions.dll": "LogSessions", + "minimapicons.dll": "MinimapIcons", + "pngscreenshots.dll": "PNG Screenshots", + "worldmarkers.dll": "WorldMarkers", + "WowPresence.dll": "Discord Rich Presence", + } + optional_attribution = { + "WowPresence.dll": "by Dusk-92", + } + + for dll, var in self.optional_plugins.items(): + if dll == "no1600x1200.dll": + continue + + command = ( + self.update_discord_presence_controls + if dll == "WowPresence.dll" + else None + ) + self._plugin_row( + right_frame, + optional_display.get(dll, os.path.splitext(dll)[0]), + var, + optional_attribution.get(dll, "by MarcelineVQ"), + self.descriptions.get(dll, ""), + command=command, + ) + + if dll == "WowPresence.dll": + self._build_discord_presence_details(right_frame) + + def clean_unselected_files(self, target): + super().clean_unselected_files(target) + + managed = { + "ClassicAPI.dll": self.classicapi_enabled, + "AuctionQueryThrottle.dll": self.auction_throttle_enabled, + "VanillaMultiMonitorFix.dll": self.vmmfix_enabled, + "Interact.dll": self.interact_enabled, + } + + # Remove each live core DLL independently when its checkbox is off. + for filename, var in managed.items(): + if not var.get(): + path = os.path.join(target, filename) + if os.path.exists(path): + try: + os.remove(path) + except OSError as exc: + raise RuntimeError( + f"Could not remove {filename}. Close WoW and any tool using the file, then try again." + ) from exc + + if not self.interact_enabled.get(): + addon_path = os.path.join(target, "Interface", "AddOns", "Interact") + if os.path.exists(addon_path): + shutil.rmtree(addon_path, ignore_errors=True) + + def _warn_offline(self, component, action, error): + self._close_download_progress() + messagebox.showwarning( + "Online update unavailable", + f"Could not download the latest {component}.\n\n" + f"{action}\n\nDetails: {error}", + ) + + def _valid_x86_dll(self, path, label): + if not os.path.isfile(path): + return False + try: + remote_packages._verify_x86_pe(path, label) + return True + except Exception: + return False + + def _prepare_wowpresence_managed_state(self, target): + """Force legacy tool-managed installs without hashes through a safe refresh.""" + trust_state = remote_packages.wowpresence_install_trust_state(target) + if trust_state == "managed_unverified": + remote_packages._set_managed_manifest_values( + target, + remote_packages.WOWPRESENCE_MANAGED_ID, + revision="__legacy_unverified__", + ) + return trust_state + + def _wowpresence_source_failure(self, error): + """Distinguish unusable remote packages from local install/write failures.""" + messages = [] + current = error + seen = set() + while current is not None and id(current) not in seen: + seen.add(id(current)) + messages.append(str(current)) + current = ( + current.__cause__ + if current.__cause__ is not None + else current.__context__ + ) + + text = "\n".join(messages) + source_markers = ( + "GitHub request failed:", + "latest release is not a stable release", + "Could not find WowPresence.zip in release", + "Release asset WowPresence.zip has no download URL", + "Download failed for WowPresence.zip:", + "SHA-256 mismatch for downloaded file", + "Unsafe ZIP path:", + "WowPresence.dll was not found in downloaded archive.", + "WowPresence.exe was not found in downloaded archive.", + "WowPresence.dll is ", + "WowPresence.dll has ", + "WowPresence.exe is ", + "WowPresence.exe has ", + "File is not a zip file", + "Bad magic number for file header", + ) + return any(marker in text for marker in source_markers) + + def _install_wowpresence_with_fallback(self, target): + """Use offline recovery only for remote-source failures, never local ones.""" + self._prepare_wowpresence_managed_state(target) + try: + return remote_packages.install_wowpresence( + target, + progress=self._report_download_progress, + ) + except Exception as exc: + if not self._wowpresence_source_failure(exc): + raise RuntimeError( + f"WowPresence installation failed locally:\n{exc}" + ) from exc + self._recover_wowpresence_offline(target, exc) + return None + + def _recover_wowpresence_offline(self, target, error): + """Preserve only trusted/manual-valid WowPresence; repair modified managed files.""" + trust_state = remote_packages.wowpresence_install_trust_state(target) + existing_dll = os.path.join(target, "WowPresence.dll") + existing_exe = os.path.join(target, "WowPresence.exe") + existing_pair_valid = ( + self._valid_x86_dll(existing_dll, "WowPresence.dll") + and self._valid_x86_dll(existing_exe, "WowPresence.exe") + ) + + if trust_state == "managed_verified": + remote_packages.ensure_wowpresence_config(target) + remote_packages.cache_installed_wowpresence(target) + self._warn_offline( + "WowPresence", + "Keeping the hash-verified WowPresence binaries already managed by the Tool.", + error, + ) + return + + if trust_state == "unmanaged" and existing_pair_valid: + remote_packages.ensure_wowpresence_config(target) + self._warn_offline( + "WowPresence", + ( + "Keeping the existing valid WowPresence binaries unchanged. " + "They were not promoted into the validated fallback cache." + ), + error, + ) + return + + try: + remote_packages.install_cached_wowpresence( + target, + progress=self._report_download_progress, + ) + fallback_action = ( + "The last validated cached WowPresence package was installed instead." + ) + except Exception: + try: + remote_packages.install_bundled_wowpresence( + target, + progress=self._report_download_progress, + ) + fallback_action = ( + "The bundled known-good WowPresence fallback was installed instead." + ) + except Exception as bundled_exc: + raise RuntimeError( + "Could not install WowPresence from its online source, " + "local cache or bundled fallback." + ) from bundled_exc + + self._warn_offline( + "WowPresence", + fallback_action, + error, + ) + + def _valid_superapi_addon(self, addon_path): + """Reject empty/partial SuperAPI folders before treating them as usable.""" + required = ( + "SuperAPI.toc", + "SuperAPI.lua", + "SuperAPIOptions.lua", + ) + if not os.path.isdir(addon_path): + return False + if any(not os.path.isfile(os.path.join(addon_path, name)) for name in required): + return False + + toc_path = os.path.join(addon_path, "SuperAPI.toc") + try: + with open(toc_path, "r", encoding="utf-8", errors="ignore") as handle: + lines = handle.readlines() + except OSError: + return False + + for raw in lines: + line = raw.strip() + if not line or line.startswith("#"): + continue + normalized = line.replace("\\", os.sep).replace("/", os.sep) + if normalized.startswith(".." + os.sep) or os.path.isabs(normalized): + return False + extension = os.path.splitext(normalized)[1].lower() + if extension in (".lua", ".xml") and not os.path.isfile( + os.path.join(addon_path, normalized) + ): + return False + return True + + def _fallback_core_dll(self, payload_base, target, dll_name, error): + source_dll = os.path.join(payload_base, dll_name) + target_dll = os.path.join(target, dll_name) + addon_folder = self.addon_dependencies.get(dll_name) + target_addon = ( + os.path.join(target, "Interface", "AddOns", addon_folder) + if addon_folder + else None + ) + + # Never downgrade a complete existing install because an upstream link + # happens to be unavailable during an update. + addon_complete = ( + target_addon is None + or ( + self._valid_superapi_addon(target_addon) + if addon_folder == "SuperAPI" + else os.path.isdir(target_addon) + ) + ) + existing_complete = self._valid_x86_dll( + target_dll, + f"installed {dll_name}", + ) and addon_complete + if existing_complete: + self._warn_offline( + dll_name, + "The version already installed in your WoW folder was kept unchanged.", + error, + ) + return + + if not os.path.isfile(source_dll): + raise RuntimeError( + f"Could not download the latest {dll_name}, and no bundled fallback exists.\n\n{error}" + ) from error + + self._verified_bundled_file( + f"Payload/{dll_name}", + f"{dll_name} fallback", + ) + + source_addon = None + if addon_folder: + source_addon = os.path.join(payload_base, "Interface", "Addons", addon_folder) + if not os.path.isdir(source_addon): + raise RuntimeError( + f"Could not download the latest {dll_name}, and its bundled fallback addon " + f"{addon_folder} is missing.\n\n{error}" + ) from error + if addon_folder == "SuperAPI": + source_addon = self._verified_bundled_tree( + "SuperWoW fallback", + "superapi_files", + "Payload/Interface/Addons/SuperAPI", + "SuperAPI fallback", + ) + + if addon_folder and source_addon: + remote_packages._transactional_replace_bundle( + [ + ("file", source_dll, target_dll), + ("dir", source_addon, target_addon), + ], + label=f"{dll_name} bundled fallback", + ) + else: + remote_packages._atomic_replace_file(source_dll, target_dll) + + self._warn_offline( + dll_name, + "The bundled known-good backup was installed instead.", + error, + ) + + def _fallback_simple_dll(self, target, dll_name, error): + target_dll = os.path.join(target, dll_name) + if self._valid_x86_dll(target_dll, f"installed {dll_name}"): + self._warn_offline( + dll_name, + "The version already installed in your WoW folder was kept unchanged.", + error, + ) + return + + fallback = os.path.join(get_base_path(), "Payload", "Fallback", dll_name) + if not os.path.isfile(fallback): + raise RuntimeError( + f"Could not download the latest {dll_name}, and its bundled backup is missing.\n\n{error}" + ) from error + + remote_packages._verify_x86_pe( + fallback, + f"bundled fallback {dll_name}", + ) + remote_packages._atomic_replace_file(fallback, target_dll) + self._warn_offline( + dll_name, + "The bundled known-good backup was installed instead.", + error, + ) + + def _fallback_vmmfix(self, target, error): + target_dll = os.path.join(target, "VanillaMultiMonitorFix.dll") + if self._valid_x86_dll( + target_dll, + "installed VanillaMultiMonitorFix.dll", + ): + self._warn_offline( + "VanillaMultiMonitorFix", + "The version already installed in your WoW folder was kept unchanged.", + error, + ) + return + + fallback_dir = os.path.join( + get_base_path(), "Payload", "Fallback", "VanillaMultiMonitorFix" + ) + fallback_dll = os.path.join(fallback_dir, "VanillaMultiMonitorFix.dll") + fallback_config = os.path.join(fallback_dir, "VMMFix_preferred_monitor.txt") + if not os.path.isfile(fallback_dll): + raise RuntimeError( + f"VanillaMultiMonitorFix update failed and its bundled backup is missing.\n\n{error}" + ) from error + + remote_packages._verify_x86_pe( + fallback_dll, + "bundled fallback VanillaMultiMonitorFix.dll", + ) + remote_packages._atomic_replace_file(fallback_dll, target_dll) + target_config = os.path.join(target, "VMMFix_preferred_monitor.txt") + if not os.path.exists(target_config) and os.path.isfile(fallback_config): + shutil.copy2(fallback_config, target_config) + + self._warn_offline( + "VanillaMultiMonitorFix", + "The bundled known-good backup was installed instead.", + error, + ) + + def _fallback_interact(self, target, error): + target_dll = os.path.join(target, "Interact.dll") + target_addon = os.path.join(target, "Interface", "AddOns", "Interact") + if ( + self._valid_x86_dll(target_dll, "installed Interact.dll") + and os.path.isdir(target_addon) + ): + self._warn_offline( + "Interact", + "The version already installed in your WoW folder was kept unchanged.", + error, + ) + return + + fallback_dir = os.path.join(get_base_path(), "Payload", "Fallback", "Interact") + fallback_dll = os.path.join(fallback_dir, "Interact.dll") + fallback_addon = os.path.join(fallback_dir, "Addon") + if not os.path.isfile(fallback_dll) or not os.path.isdir(fallback_addon): + raise RuntimeError( + f"Interact update failed and its bundled backup is incomplete.\n\n{error}" + ) from error + + remote_packages._verify_x86_pe( + fallback_dll, + "bundled fallback Interact.dll", + ) + remote_packages._transactional_replace_bundle( + [ + ("file", fallback_dll, target_dll), + ("dir", fallback_addon, target_addon), + ], + label="Interact bundled fallback", + ) + self._warn_offline( + "Interact", + "The bundled known-good backup was installed instead.", + error, + ) + + def _vanilla_tweaks_signature(self): + """Version output normalization independently from the SuperWoW checkbox.""" + signature = super()._vanilla_tweaks_signature() + signature["selected_patch_normalization"] = 1 + return signature + + def _normalize_selected_vanilla_tweaks_output(self, output_exe): + """Make selected FoV/sound/loot settings authoritative on pre-patched inputs.""" + try: + with open(output_exe, "rb") as handle: + data = bytearray(handle.read()) + except OSError as exc: + raise RuntimeError( + "Could not inspect WoW_Modernized.exe for Vanilla Tweaks normalization." + ) from exc + + required_size = 0x435D3C + if len(data) < required_size: + raise RuntimeError( + "WoW_Modernized.exe is too small for Vanilla Tweaks normalization." + ) + + quickloot_sites = ( + (0x0C1ECF, 0x10), + (0x0C2B25, 0x0B), + ) + desired_quickloot_opcode = 0x75 if self.vt_quickloot.get() else 0x74 + for offset, displacement in quickloot_sites: + current = bytes(data[offset:offset + 2]) + vanilla = bytes((0x74, displacement)) + reversed_loot = bytes((0x75, displacement)) + if current not in (vanilla, reversed_loot, b"\x90\x90"): + raise RuntimeError( + f"Unexpected QuickLoot bytes at 0x{offset:X}; refusing to alter an unknown client." + ) + data[offset:offset + 2] = bytes( + (desired_quickloot_opcode, displacement) + ) + + if data[0x3A4869] not in (0x14, 0x27): + raise RuntimeError( + "Unexpected Background Sound byte; refusing to alter an unknown client." + ) + data[0x3A4869] = 0x27 if self.vt_bg_sound.get() else 0x14 + + data[0x4089B4:0x4089B8] = struct.pack(" 4: + raise RuntimeError("Sound Channels value is too large for the WoW 1.12.1 field.") + data[0x435D38:0x435D3C] = sound_channels.ljust(4, b"\x00") + + staged = output_exe + ".modernization-normalized" + try: + with open(staged, "wb") as handle: + handle.write(data) + os.replace(staged, output_exe) + except OSError as exc: + raise RuntimeError( + "Could not write the normalized WoW_Modernized.exe." + ) from exc + finally: + if os.path.exists(staged): + try: + os.remove(staged) + except OSError: + pass + + def _run_vanilla_tweaks_transactional( + self, + target, + tweaks_exe, + modern_cli=True, + ): + """Patch, normalize and validate away from the live executable, then commit once.""" + wow_exe = os.path.join(target, "WoW.exe") + output_exe = os.path.join(target, "WoW_Modernized.exe") + final_staged = output_exe + ".modernization-new" + + if not os.path.isfile(wow_exe): + raise RuntimeError("WoW.exe is missing, so Vanilla Tweaks cannot be applied.") + + try: + staging_root = tempfile.mkdtemp( + prefix=".modernization-vt-", + dir=target, + ) + except OSError as exc: + raise RuntimeError( + "Could not create the temporary Vanilla Tweaks staging directory." + ) from exc + + try: + staged_wow = os.path.join(staging_root, "WoW.exe") + try: + shutil.copy2(wow_exe, staged_wow) + except OSError as exc: + raise RuntimeError( + "Could not stage WoW.exe for Vanilla Tweaks." + ) from exc + + staged_output = super().run_vanilla_tweaks( + staging_root, + tweaks_exe=tweaks_exe, + modern_cli=modern_cli, + ) + + # The Tool-owned selections are normalized before the live executable + # is touched. Unknown patch signatures therefore fail with the old + # WoW_Modernized.exe still completely intact. + self._normalize_selected_vanilla_tweaks_output(staged_output) + + valid_pe, reason = self._inspect_wow_executable(staged_output) + if not valid_pe: + raise RuntimeError( + "Normalized Vanilla Tweaks output is not a valid WoW executable. " + f"{reason}" + ) + if os.path.getsize(staged_output) < 1024 * 1024: + raise RuntimeError( + "Normalized Vanilla Tweaks output is unexpectedly small." + ) + + if os.path.exists(final_staged): + try: + os.remove(final_staged) + except OSError as exc: + raise RuntimeError( + "Could not prepare the final Vanilla Tweaks staging path." + ) from exc + + try: + os.replace(staged_output, final_staged) + except OSError as exc: + raise RuntimeError( + "Could not move the validated Vanilla Tweaks output into final staging." + ) from exc + + # Revalidate at the exact same-directory staging path used for the + # final atomic replacement. This is the last gate before commit. + valid_pe, reason = self._inspect_wow_executable(final_staged) + if not valid_pe: + raise RuntimeError( + "Final staged Vanilla Tweaks output is not a valid WoW executable. " + f"{reason}" + ) + if os.path.getsize(final_staged) < 1024 * 1024: + raise RuntimeError( + "Final staged Vanilla Tweaks output is unexpectedly small." + ) + + try: + os.replace(final_staged, output_exe) + except OSError as exc: + raise RuntimeError( + "Could not replace WoW_Modernized.exe with the validated staged output." + ) from exc + + return output_exe + finally: + if os.path.exists(final_staged): + try: + os.remove(final_staged) + except OSError: + pass + shutil.rmtree(staging_root, ignore_errors=True) + + def _vanilla_tweaks_marker_path(self, target): + return os.path.join( + target, + ".modernization_tool", + "vanilla_tweaks.json", + ) + + def _bundled_vanilla_tweaks_info(self): + info = { + "version": "bundled", + "source": "bundled vanilla-tweaks.exe", + } + metadata_path = os.path.join( + get_base_path(), + "Payload", + "Fallback", + "versions.json", + ) + try: + with open(metadata_path, "r", encoding="utf-8") as handle: + data = json.load(handle) + component = data.get("components", {}).get("vanilla-tweaks fallback", {}) + if isinstance(component, dict): + if component.get("version"): + info["version"] = str(component["version"]) + if component.get("source"): + info["source"] = str(component["source"]) + except (OSError, json.JSONDecodeError, ValueError, TypeError): + pass + return info + + def _write_vanilla_tweaks_marker( + self, + target, + patcher_source, + patcher_version, + patcher_path, + patcher_revision=None, + ): + wow_exe = os.path.join(target, "WoW.exe") + output_exe = os.path.join(target, "WoW_Modernized.exe") + if not os.path.isfile(wow_exe) or not os.path.isfile(output_exe): + raise RuntimeError( + "Cannot record vanilla-tweaks state because a required WoW executable is missing." + ) + + marker_path = self._vanilla_tweaks_marker_path(target) + os.makedirs(os.path.dirname(marker_path), exist_ok=True) + temp_path = marker_path + ".new" + payload = { + "schema": 2, + "patcher_source": patcher_source, + "patcher_version": str(patcher_version), + "patcher_revision": ( + str(patcher_revision) if patcher_revision is not None else None + ), + "patcher_sha256": ( + self._file_sha256(patcher_path) + if patcher_path and os.path.isfile(patcher_path) + else None + ), + "input_wow_sha256": self._file_sha256(wow_exe), + "output_sha256": self._file_sha256(output_exe), + "settings_signature": self._vanilla_tweaks_signature(), + } + + with open(temp_path, "w", encoding="utf-8") as handle: + json.dump(payload, handle, indent=2, sort_keys=True) + os.replace(temp_path, marker_path) + + def _existing_vanilla_tweaks_output_matches(self, target): + marker_path = self._vanilla_tweaks_marker_path(target) + wow_exe = os.path.join(target, "WoW.exe") + output_exe = os.path.join(target, "WoW_Modernized.exe") + + if not ( + os.path.isfile(marker_path) + and os.path.isfile(wow_exe) + and os.path.isfile(output_exe) + ): + return False, None + + try: + with open(marker_path, "r", encoding="utf-8") as handle: + marker = json.load(handle) + if not isinstance(marker, dict): + return False, None + + if marker.get("settings_signature") != self._vanilla_tweaks_signature(): + return False, marker + + if marker.get("input_wow_sha256") != self._file_sha256(wow_exe): + return False, marker + + if marker.get("output_sha256") != self._file_sha256(output_exe): + return False, marker + + valid_pe, _ = self._inspect_wow_executable(output_exe) + if not valid_pe: + return False, marker + + return True, marker + except (OSError, json.JSONDecodeError, ValueError, TypeError): + return False, None + + def run_vanilla_tweaks(self, target): + # First compare the small GitHub release metadata with the patcher + # revision already recorded for this exact WoW.exe/settings output. + # The multi-megabyte Windows package is downloaded only when needed. + existing_matches, marker = self._existing_vanilla_tweaks_output_matches( + target + ) + + try: + self._report_download_progress( + "Checking vanilla-tweaks release...", + None, + None, + ) + release_info = remote_packages.vanilla_tweaks_release_info() + except Exception as exc: + self._close_download_progress() + + if existing_matches: + patcher_version = ( + marker.get("patcher_version", "previously installed") + if isinstance(marker, dict) + else "previously installed" + ) + messagebox.showwarning( + "Latest vanilla-tweaks unavailable", + "Could not check the latest tubtubs/vanilla-tweaks build.\n\n" + "Your existing WoW_Modernized.exe matches the current WoW.exe " + "and all executable patch settings, so it was kept unchanged.\n\n" + f"Existing patcher version: {patcher_version}\n\n" + f"Details: {exc}", + ) + return os.path.join(target, "WoW_Modernized.exe") + + bundled = self._bundled_vanilla_tweaks_info() + bundled_exe = os.path.join(get_base_path(), "vanilla-tweaks.exe") + messagebox.showwarning( + "Latest vanilla-tweaks unavailable", + "Could not check the latest tubtubs/vanilla-tweaks build.\n\n" + "The current WoW.exe or executable patch settings need to be " + "repatched, so the bundled known-good vanilla-tweaks build will " + f"be used instead ({bundled['version']}).\n\n" + f"Details: {exc}", + ) + + result = self._run_vanilla_tweaks_transactional( + target, + tweaks_exe=bundled_exe, + modern_cli=True, + ) + self._write_vanilla_tweaks_marker( + target, + patcher_source="bundled", + patcher_version=bundled["version"], + patcher_path=bundled_exe, + ) + return result + + remote_revision = release_info["revision"] + remote_version = release_info["version"] + if existing_matches and isinstance(marker, dict): + same_online_patcher = ( + marker.get("patcher_source") == "online" + and ( + str(marker.get("patcher_revision")) == str(remote_revision) + or ( + marker.get("patcher_revision") in (None, "") + and str(marker.get("patcher_version")) == str(remote_version) + ) + ) + ) + if same_online_patcher: + self._report_download_progress( + f"vanilla-tweaks {remote_version} is already current.", + None, + None, + ) + self._close_download_progress() + return os.path.join(target, "WoW_Modernized.exe") + + try: + tweaks_exe, extract_root, version, revision = ( + remote_packages.prepare_vanilla_tweaks( + progress=self._report_download_progress, + release_info=release_info, + ) + ) + except Exception as exc: + self._close_download_progress() + + # A remote update may exist but be temporarily unavailable. Keep a + # valid existing output rather than downgrading or repatching it. + if existing_matches: + patcher_version = ( + marker.get("patcher_version", "previously installed") + if isinstance(marker, dict) + else "previously installed" + ) + messagebox.showwarning( + "Latest vanilla-tweaks unavailable", + "The latest vanilla-tweaks package could not be downloaded.\n\n" + "Your existing WoW_Modernized.exe still matches the current " + "WoW.exe and all executable patch settings, so it was kept unchanged.\n\n" + f"Existing patcher version: {patcher_version}\n\n" + f"Details: {exc}", + ) + return os.path.join(target, "WoW_Modernized.exe") + + bundled = self._bundled_vanilla_tweaks_info() + bundled_exe = os.path.join(get_base_path(), "vanilla-tweaks.exe") + messagebox.showwarning( + "Latest vanilla-tweaks unavailable", + "The latest vanilla-tweaks package could not be downloaded.\n\n" + "The current WoW.exe or executable patch settings need to be " + "repatched, so the bundled known-good vanilla-tweaks build will " + f"be used instead ({bundled['version']}).\n\n" + f"Details: {exc}", + ) + + result = self._run_vanilla_tweaks_transactional( + target, + tweaks_exe=bundled_exe, + modern_cli=True, + ) + self._write_vanilla_tweaks_marker( + target, + patcher_source="bundled", + patcher_version=bundled["version"], + patcher_path=bundled_exe, + ) + return result + + try: + self._report_download_progress( + f"Applying vanilla-tweaks {version}...", + None, + None, + ) + result = self._run_vanilla_tweaks_transactional( + target, + tweaks_exe=tweaks_exe, + modern_cli=True, + ) + self._write_vanilla_tweaks_marker( + target, + patcher_source="online", + patcher_version=version, + patcher_path=tweaks_exe, + patcher_revision=revision, + ) + return result + finally: + shutil.rmtree(extract_root, ignore_errors=True) + self._close_download_progress() + + def configure_plugins(self, target): + payload_base = os.path.join(get_base_path(), "Payload") + payload_weirdu = os.path.join(payload_base, "WeirdUtils") + + dlls_text_lines = [] + if self.rendering_mode.get() == "dxvk": + dlls_text_lines.append("dxvk") + + try: + # Core plugins are refreshed from their upstream sources where supported. + # Bundled fallbacks are used only for components whose redistribution + # model allows it. SuperWoW/SuperAPI also have a bundled fallback. + for dll_name, var in self.core_plugins.items(): + if not var.get(): + continue + + if dll_name == "nampower.dll": + try: + remote_packages.install_nampower( + target, + progress=self._report_download_progress, + ) + except Exception as exc: + self._fallback_core_dll(payload_base, target, dll_name, exc) + + elif dll_name == "VanillaHelpers.dll": + try: + remote_packages.install_vanillahelpers( + target, + progress=self._report_download_progress, + ) + except Exception as exc: + self._fallback_core_dll(payload_base, target, dll_name, exc) + + elif dll_name == "UnitXP_SP3.dll": + try: + remote_packages.install_unitxp( + target, + progress=self._report_download_progress, + ) + except Exception as exc: + self._fallback_core_dll(payload_base, target, dll_name, exc) + + elif dll_name == "SuperWoWhook.dll": + try: + remote_packages.install_superwow( + target, + progress=self._report_download_progress, + ) + except Exception as exc: + self._fallback_core_dll(payload_base, target, dll_name, exc) + + elif dll_name == "perf_boost.dll": + source_dll, _ = self._verified_bundled_file( + "Payload/perf_boost.dll", + "PerfBoost", + ) + source_addon = os.path.join( + payload_base, + "Interface", + "Addons", + "perfboostsettings", + ) + if not os.path.isdir(source_addon): + raise RuntimeError( + "Bundled PerfBoost settings addon is missing." + ) + remote_packages._transactional_replace_bundle( + [ + ( + "file", + source_dll, + os.path.join(target, "perf_boost.dll"), + ), + ( + "dir", + source_addon, + os.path.join( + target, + "Interface", + "AddOns", + "perfboostsettings", + ), + ), + ], + label="PerfBoost", + ) + + else: + self._install_verified_bundled_file( + f"Payload/{dll_name}", + os.path.join(target, dll_name), + dll_name, + ) + + dlls_text_lines.append(dll_name) + + # Live core plugins. Both checkboxes are independent and can be + # installed together. + if self.classicapi_enabled.get(): + try: + remote_packages.install_classicapi( + target, + progress=self._report_download_progress, + ) + except Exception as exc: + self._fallback_simple_dll(target, "ClassicAPI.dll", exc) + dlls_text_lines.append("ClassicAPI.dll") + + if self.auction_throttle_enabled.get(): + try: + remote_packages.install_auction_query_throttle( + target, + progress=self._report_download_progress, + ) + except Exception as exc: + self._fallback_simple_dll(target, "AuctionQueryThrottle.dll", exc) + dlls_text_lines.append("AuctionQueryThrottle.dll") + + # Clean dependent addons when the matching core DLL is disabled. + for dll_name, addon_folder in self.addon_dependencies.items(): + core_var = self.core_plugins.get(dll_name) + if core_var is not None and not core_var.get(): + addon_path = os.path.join(target, "Interface", "AddOns", addon_folder) + if os.path.exists(addon_path): + shutil.rmtree(addon_path, ignore_errors=True) + + # Optional client fixes, in the same order as the UI. + no1600_var = self.optional_plugins["no1600x1200.dll"] + if no1600_var.get(): + # No1600x1200 comes from an archive/mirror repository rather + # than a maintained release channel. Use the bundled, + # hash-verified known-good copy for predictable installs. + self._install_verified_bundled_file( + "Payload/no1600x1200.dll", + os.path.join(target, "no1600x1200.dll"), + "no1600x1200.dll", + ) + dlls_text_lines.append("no1600x1200.dll") + + if self.vmmfix_enabled.get(): + try: + remote_packages.install_vanilla_multimonitor_fix( + target, + progress=self._report_download_progress, + ) + except Exception as exc: + self._fallback_vmmfix(target, exc) + dlls_text_lines.append("VanillaMultiMonitorFix.dll") + + if self.interact_enabled.get(): + try: + remote_packages.install_interact( + target, + progress=self._report_download_progress, + ) + except Exception as exc: + self._fallback_interact(target, exc) + dlls_text_lines.append("Interact.dll") + + # Optional WeirdUtils and WowPresence. + for dll_name, var in self.optional_plugins.items(): + if dll_name == "no1600x1200.dll": + continue + if not var.get(): + continue + + if dll_name == "WowPresence.dll": + self._install_wowpresence_with_fallback(target) + + # Remove the old test-branch filenames after a successful + # migration. The legacy config directory is intentionally + # left untouched so the user can remove it manually. + for legacy_name in ("DiscordPresence.dll", "DiscordPresence.exe"): + legacy_path = os.path.join(target, legacy_name) + if os.path.isfile(legacy_path): + try: + os.remove(legacy_path) + except OSError: + pass + + remote_packages.write_wowpresence_broadcast_flags( + target, + self._discord_broadcast_mask(), + ) + else: + self._install_verified_bundled_file( + f"Payload/WeirdUtils/{dll_name}", + os.path.join(target, dll_name), + dll_name, + ) + + dlls_text_lines.append(dll_name) + + # Preserve user-added dlls.txt entries; replace only entries + # managed by Modernization Tool. + self._write_dlls_file(target, dlls_text_lines) + finally: + self._close_download_progress() + + +if __name__ == "__main__": + root = tk.Tk() + app = ModernWowSetupTool(root) + root.mainloop() diff --git a/tests/test_vanilla_tweaks_normalization.py b/tests/test_vanilla_tweaks_normalization.py index 2783fd0..d01ad61 100644 --- a/tests/test_vanilla_tweaks_normalization.py +++ b/tests/test_vanilla_tweaks_normalization.py @@ -4,6 +4,7 @@ import tempfile import unittest from unittest import mock +import setup_tool_dynamic from setup_tool import WowSetupTool from setup_tool_dynamic import ModernWowSetupTool @@ -20,44 +21,109 @@ class FakeVar: class VanillaTweaksNormalizationTests(unittest.TestCase): - def _tool(self, *, fov, sound, quickloot, background): + def _tool( + self, + *, + fov, + sound, + quickloot, + background, + farclip=777, + frill=300, + nameplate=41, + maxcam=100, + laa=True, + camera=True, + custom_glues=True, + crossfaction=False, + bluemoon=False, + ): tool = ModernWowSetupTool.__new__(ModernWowSetupTool) tool.vt_fov = FakeVar(fov) tool.vt_soundchan = FakeVar(sound) tool.vt_quickloot = FakeVar(quickloot) tool.vt_bg_sound = FakeVar(background) - - # Remaining values are required by the executable settings signature. - tool.vt_farclip = FakeVar(777) - tool.vt_frill = FakeVar(300) - tool.vt_nameplate = FakeVar(41) - tool.vt_maxcam = FakeVar(100) - tool.vt_laa = FakeVar(True) - tool.vt_cam_fix = FakeVar(True) - tool.vt_crossfaction_res = FakeVar(False) - tool.vt_custom_glues = FakeVar(True) - tool.vt_bluemoon = FakeVar(False) + tool.vt_farclip = FakeVar(farclip) + tool.vt_frill = FakeVar(frill) + tool.vt_nameplate = FakeVar(nameplate) + tool.vt_maxcam = FakeVar(maxcam) + tool.vt_laa = FakeVar(laa) + tool.vt_cam_fix = FakeVar(camera) + tool.vt_crossfaction_res = FakeVar(crossfaction) + tool.vt_custom_glues = FakeVar(custom_glues) + tool.vt_bluemoon = FakeVar(bluemoon) tool.core_plugins = {"SuperWoWhook.dll": FakeVar(True)} return tool - def _write_exe(self, root, quick1, quick2, background, fov, sound): - data = bytearray(0x435D3C + 16) + def _write_exe( + self, + root, + quick1, + quick2, + background, + fov, + sound, + *, + farclip=777.0, + frill=70.0, + nameplate=20.0, + maxcam=50.0, + laa_patched=False, + camera_patched=False, + custom_patched=False, + crossfaction_byte=0x01, + bluemoon_bytes=None, + ): + data = bytearray(0x46795C + 16) data[0x0C1ECF:0x0C1ED1] = quick1 data[0x0C2B25:0x0C2B27] = quick2 data[0x3A4869] = background - data[0x4089B4:0x4089B8] = struct.pack(" Date: Fri, 4 Sep 2026 11:24:20 +0200 Subject: [PATCH 082/101] Preserve dynamic module test compatibility --- setup_tool_dynamic.py | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 27a290d..56ab8ef 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -1,8 +1,11 @@ import math import os import struct +import sys import tkinter as tk +import types +import setup_tool_dynamic_core as _dynamic_core # Keep the feature-branch implementation intact and layer only the executable # normalization policy here. This makes the B-total policy easy to audit and # keeps every unrelated remote/fallback behavior byte-for-byte unchanged. @@ -247,6 +250,21 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): pass +class _DynamicModuleProxy(types.ModuleType): + """Keep legacy module-level monkey patches visible to the preserved core.""" + + def __setattr__(self, name, value): + super().__setattr__(name, value) + if name == "get_base_path": + setattr(_dynamic_core, name, value) + + +# Existing tests and external callers historically patched +# setup_tool_dynamic.get_base_path. Preserve that behavior after splitting the +# untouched implementation into setup_tool_dynamic_core.py. +sys.modules[__name__].__class__ = _DynamicModuleProxy + + if __name__ == "__main__": root = tk.Tk() app = ModernWowSetupTool(root) -- 2.52.0 From c992cee4cf41b73bb20e46f713be157299c6c04a Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 13:34:28 +0200 Subject: [PATCH 083/101] Preflight Vanilla Tweaks before patching --- setup_tool_dynamic.py | 224 +++++++++++++++++++++++++++++++----------- 1 file changed, 169 insertions(+), 55 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 56ab8ef..c7db236 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -4,6 +4,7 @@ import struct import sys import tkinter as tk import types +from tkinter import messagebox import setup_tool_dynamic_core as _dynamic_core # Keep the feature-branch implementation intact and layer only the executable @@ -80,10 +81,9 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): def _vanilla_tweaks_signature(self): signature = super()._vanilla_tweaks_signature() - # v2 expands normalization from the original selected subset to every - # executable tweak exposed by the Tool except the two intentionally - # legacy upstream-only patches (Blue Moon and Cross-faction Res). - signature["selected_patch_normalization"] = 2 + # v3 adds source preflight and preserves client-owned Custom GlueXML + # regions instead of letting vanilla-tweaks overwrite unknown loader code. + signature["selected_patch_normalization"] = 3 return signature @staticmethod @@ -95,30 +95,55 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): "refusing to alter an unknown client." ) - def _normalize_selected_vanilla_tweaks_output(self, output_exe): - """Make Tool-owned executable tweaks authoritative on pre-patched clients. + def _desired_normalized_values(self): + desired = { + "fov": float(self.vt_fov.get()), + "farclip": float(self.vt_farclip.get()), + "frill": float(self.vt_frill.get()), + "nameplate": float(self.vt_nameplate.get()), + "maxcam": float(self.vt_maxcam.get()), + "sound": int(self.vt_soundchan.get()), + } - Blue Moon and Cross-faction Resurrection deliberately keep the previous - vanilla-tweaks behavior because their complete pristine restoration - signatures are not part of this policy. - """ - try: - with open(output_exe, "rb") as handle: - data = bytearray(handle.read()) - except OSError as exc: + ranges = ( + ("FoV", desired["fov"], 0.5, 3.5), + ("Farclip", desired["farclip"], 100.0, 50000.0), + ("Frill Distance", desired["frill"], 0.0, 10000.0), + ("Nameplate Distance", desired["nameplate"], 1.0, 500.0), + ("Max Camera Distance", desired["maxcam"], 1.0, 1000.0), + ) + for label, value, minimum, maximum in ranges: + if not math.isfinite(value) or not minimum <= value <= maximum: + raise RuntimeError( + f"{label} value is outside the supported WoW 1.12.1 range." + ) + + sound_channels = str(desired["sound"]).encode("ascii") + b"\x00" + if not 1 <= desired["sound"] <= 256 or len(sound_channels) > 4: raise RuntimeError( - "Could not inspect WoW_Modernized.exe for Vanilla Tweaks normalization." - ) from exc + "Sound Channels value is outside the supported WoW 1.12.1 range." + ) + desired["sound_bytes"] = sound_channels.ljust(4, b"\x00") + return desired + def _validate_vanilla_tweaks_state( + self, + data, + *, + allow_foreign_custom_glues=False, + accepted_custom_glues=None, + ): + """Validate every region the B-total policy may rewrite. + + Returns a foreign Custom GlueXML byte tuple only during source preflight. + Such a tuple is treated as client-owned code and later restored exactly. + """ required_size = 0x46795C if len(data) < required_size: raise RuntimeError( - "WoW_Modernized.exe is too small for Vanilla Tweaks normalization." + "WoW.exe is too small for Vanilla Tweaks safety preflight." ) - # Validate all code-patch signatures before changing anything. Scalar - # fields below are data constants, so they are validated by type/range - # rather than by one exact preset value. quickloot_sites = ( (0x0C1ECF, 0x10), (0x0C2B25, 0x0B), @@ -155,13 +180,33 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): "refusing to alter an unknown client." ) - custom_state = tuple(data[offset] for offset, _original, _patched in _CUSTOM_GLUES_SITES) - custom_original = tuple(original for _offset, original, _patched in _CUSTOM_GLUES_SITES) - custom_patched = tuple(patched for _offset, _original, patched in _CUSTOM_GLUES_SITES) + custom_state = tuple( + data[offset] for offset, _original, _patched in _CUSTOM_GLUES_SITES + ) + custom_original = tuple( + original for _offset, original, _patched in _CUSTOM_GLUES_SITES + ) + custom_patched = tuple( + patched for _offset, _original, patched in _CUSTOM_GLUES_SITES + ) + foreign_custom_glues = None + accepted_custom = ( + tuple(accepted_custom_glues) + if accepted_custom_glues is not None + else None + ) if custom_state not in (custom_original, custom_patched): - raise RuntimeError( - "Unexpected Custom GlueXML bytes; refusing to alter an unknown client." - ) + if accepted_custom is not None and custom_state == accepted_custom: + pass + elif allow_foreign_custom_glues: + # Turtle/Octo and other compatible clients may legitimately own + # this loader region. Never classify those bytes as vanilla and + # never overwrite them just to satisfy the checkbox state. + foreign_custom_glues = custom_state + else: + raise RuntimeError( + "Unexpected Custom GlueXML bytes; refusing to alter an unknown client." + ) self._validate_float_field(data, 0x4089B4, "FoV", 0.5, 3.5) self._validate_float_field(data, 0x40FED8, "Farclip", 100.0, 50000.0) @@ -181,29 +226,92 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): "Unexpected Sound Channels field; refusing to alter an unknown client." ) - desired_fov = float(self.vt_fov.get()) - desired_farclip = float(self.vt_farclip.get()) - desired_frill = float(self.vt_frill.get()) - desired_nameplate = float(self.vt_nameplate.get()) - desired_maxcam = float(self.vt_maxcam.get()) - desired_sound = int(self.vt_soundchan.get()) + return foreign_custom_glues - desired_values = ( - ("FoV", desired_fov, 0.5, 3.5), - ("Farclip", desired_farclip, 100.0, 50000.0), - ("Frill Distance", desired_frill, 0.0, 10000.0), - ("Nameplate Distance", desired_nameplate, 1.0, 500.0), - ("Max Camera Distance", desired_maxcam, 1.0, 1000.0), + def _preflight_vanilla_tweaks_source(self, target): + """Read and validate WoW.exe before vanilla-tweaks or any install write runs.""" + self._vt_preserved_custom_glues = None + wow_exe = os.path.join(target, "WoW.exe") + try: + with open(wow_exe, "rb") as handle: + data = bytearray(handle.read()) + except OSError as exc: + raise RuntimeError( + "Could not inspect WoW.exe for Vanilla Tweaks safety preflight." + ) from exc + + # Validate the selected values now too, so malformed settings cannot + # fail only after unrelated plugins/mods have already been updated. + self._desired_normalized_values() + preserved = self._validate_vanilla_tweaks_state( + data, + allow_foreign_custom_glues=True, ) - for label, value, minimum, maximum in desired_values: - if not math.isfinite(value) or not minimum <= value <= maximum: - raise RuntimeError(f"{label} value is outside the supported WoW 1.12.1 range.") + self._vt_preserved_custom_glues = preserved + return preserved - sound_channels = str(desired_sound).encode("ascii") + b"\x00" - if not 1 <= desired_sound <= 256 or len(sound_channels) > 4: - raise RuntimeError("Sound Channels value is outside the supported WoW 1.12.1 range.") + def validate_plugin_conflicts(self): + """Use the installer's final read-only validation gate for EXE preflight.""" + if not super().validate_plugin_conflicts(): + return False + + target = self.wow_dir.get().strip() + try: + self._preflight_vanilla_tweaks_source(target) + except Exception as exc: + messagebox.showerror( + "Vanilla Tweaks safety check", + f"{exc}\n\nNo installation files were changed.", + ) + return False + return True + + def _run_vanilla_tweaks_transactional( + self, + target, + tweaks_exe, + modern_cli=True, + ): + """Recheck the source immediately before the staged patch transaction.""" + self._preflight_vanilla_tweaks_source(target) + return super()._run_vanilla_tweaks_transactional( + target, + tweaks_exe=tweaks_exe, + modern_cli=modern_cli, + ) + + def _normalize_selected_vanilla_tweaks_output(self, output_exe): + """Make Tool-owned executable tweaks authoritative on pre-patched clients. + + Blue Moon and Cross-faction Resurrection deliberately keep the previous + vanilla-tweaks behavior. A foreign Custom GlueXML region discovered on + the original WoW.exe is also preserved byte-for-byte because community + clients may use those offsets for their own loader/anti-tamper code. + """ + try: + with open(output_exe, "rb") as handle: + data = bytearray(handle.read()) + except OSError as exc: + raise RuntimeError( + "Could not inspect WoW_Modernized.exe for Vanilla Tweaks normalization." + ) from exc + + preserved_custom_glues = getattr( + self, + "_vt_preserved_custom_glues", + None, + ) + self._validate_vanilla_tweaks_state( + data, + accepted_custom_glues=preserved_custom_glues, + ) + desired = self._desired_normalized_values() # All validation passed. Apply the exact Tool selections in memory. + quickloot_sites = ( + (0x0C1ECF, 0x10), + (0x0C2B25, 0x0B), + ) desired_quickloot_opcode = 0x75 if self.vt_quickloot.get() else 0x74 for offset, displacement in quickloot_sites: data[offset:offset + 2] = bytes( @@ -215,19 +323,25 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): desired_camera_patched = bool(self.vt_cam_fix.get()) for offset, original, patched in _CAMERA_REGIONS: - desired = patched if desired_camera_patched else original - data[offset:offset + len(desired)] = desired + selected = patched if desired_camera_patched else original + data[offset:offset + len(selected)] = selected - desired_custom_patched = bool(self.vt_custom_glues.get()) - for offset, original, patched in _CUSTOM_GLUES_SITES: - data[offset] = patched if desired_custom_patched else original + if preserved_custom_glues is not None: + # The original client owned this region. vanilla-tweaks may have + # rewritten it in staging, so put the exact source bytes back. + for index, (offset, _original, _patched) in enumerate(_CUSTOM_GLUES_SITES): + data[offset] = preserved_custom_glues[index] + else: + desired_custom_patched = bool(self.vt_custom_glues.get()) + for offset, original, patched in _CUSTOM_GLUES_SITES: + data[offset] = patched if desired_custom_patched else original - struct.pack_into(" Date: Fri, 4 Sep 2026 13:35:35 +0200 Subject: [PATCH 084/101] Test source preflight and client GlueXML preservation --- tests/test_vanilla_tweaks_normalization.py | 213 ++++++++++++++++++++- 1 file changed, 204 insertions(+), 9 deletions(-) diff --git a/tests/test_vanilla_tweaks_normalization.py b/tests/test_vanilla_tweaks_normalization.py index d01ad61..c0e53f4 100644 --- a/tests/test_vanilla_tweaks_normalization.py +++ b/tests/test_vanilla_tweaks_normalization.py @@ -73,6 +73,7 @@ class VanillaTweaksNormalizationTests(unittest.TestCase): custom_patched=False, crossfaction_byte=0x01, bluemoon_bytes=None, + filename="WoW_Modernized.exe", ): data = bytearray(0x46795C + 16) data[0x0C1ECF:0x0C1ED1] = quick1 @@ -102,7 +103,7 @@ class VanillaTweaksNormalizationTests(unittest.TestCase): # Unrelated data must survive normalization byte-for-byte. data[0x123456:0x12345E] = b"KEEPTHIS" - path = os.path.join(root, "WoW_Modernized.exe") + path = os.path.join(root, filename) with open(path, "wb") as handle: handle.write(data) return path @@ -111,6 +112,23 @@ class VanillaTweaksNormalizationTests(unittest.TestCase): def _read_float(data, offset): return struct.unpack(" Date: Fri, 4 Sep 2026 14:10:20 +0200 Subject: [PATCH 085/101] Harden executable and MPQ safety checks --- setup_tool_dynamic.py | 318 +++++++++++++++++++++++++++++++++++++----- 1 file changed, 284 insertions(+), 34 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index c7db236..9f7bec6 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -6,6 +6,7 @@ import tkinter as tk import types from tkinter import messagebox +import remote_packages import setup_tool_dynamic_core as _dynamic_core # Keep the feature-branch implementation intact and layer only the executable # normalization policy here. This makes the B-total policy easy to audit and @@ -75,26 +76,154 @@ _CUSTOM_GLUES_SITES = ( (0x2F11F1, 0x5E, 0xB2), ) +# Numeric fields are intentionally allowed to keep legitimate values already +# selected by Turtle/Octo/community launchers. Safety comes from a multi-anchor +# 1.12.1/5875 identity check plus tight per-field supported ranges; the exact +# source bytes are then snapshotted so the upstream patcher may only preserve +# them or replace them with the Tool's requested value. +_NUMERIC_SITES = ( + ("fov", 0x4089B4, "FoV", 0.5, 3.5), + ("farclip", 0x40FED8, "Farclip", 777.0, 10000.0), + ("frill", 0x467958, "Frill Distance", 0.0, 1000.0), + ("nameplate", 0x40C448, "Nameplate Distance", 0.0, 150.0), + ("maxcam", 0x4089A4, "Max Camera Distance", 1.0, 250.0), +) +_SOUND_SITE = ("sound", 0x435D38, "Sound Channels", 1, 128) +_CLIENT_BUILD_OFFSET = 0x437BFC +_CLIENT_VERSION_OFFSET = 0x437C04 +_CLIENT_BUILD = b"5875" +_CLIENT_VERSION = b"1.12.1" + + +def _strict_verify_mpq(path): + """Validate the classic MPQ header and table bounds, not only its magic.""" + try: + size = os.path.getsize(path) + if size < 32: + raise remote_packages.RemotePackageError( + "Downloaded MPQ is too small to contain a valid header." + ) + + with open(path, "rb") as handle: + header = handle.read(32) + except remote_packages.RemotePackageError: + raise + except OSError as exc: + raise remote_packages.RemotePackageError( + f"Could not inspect downloaded MPQ: {exc}" + ) from exc + + if len(header) != 32 or header[:4] != b"MPQ\x1A": + raise remote_packages.RemotePackageError( + "Downloaded file is not a valid MPQ archive." + ) + + try: + ( + header_size, + archive_size, + format_version, + sector_size_shift, + hash_table_offset, + block_table_offset, + hash_table_entries, + block_table_entries, + ) = struct.unpack_from(" size: + raise remote_packages.RemotePackageError( + "Downloaded MPQ has an invalid header size." + ) + if archive_size < header_size or archive_size > size: + raise remote_packages.RemotePackageError( + "Downloaded MPQ has an invalid archive size." + ) + if format_version not in (0, 1): + raise remote_packages.RemotePackageError( + f"Downloaded MPQ uses unsupported format version {format_version}." + ) + if sector_size_shift > 16: + raise remote_packages.RemotePackageError( + "Downloaded MPQ has an invalid sector-size shift." + ) + + tables = ( + ("hash", hash_table_offset, hash_table_entries), + ("block", block_table_offset, block_table_entries), + ) + for table_name, table_offset, entry_count in tables: + if entry_count <= 0: + raise remote_packages.RemotePackageError( + f"Downloaded MPQ has an empty {table_name} table." + ) + table_size = entry_count * 16 + if ( + table_offset < header_size + or table_offset > archive_size + or table_size > archive_size - table_offset + ): + raise remote_packages.RemotePackageError( + f"Downloaded MPQ has an out-of-bounds {table_name} table." + ) + + +def _install_strict_mpq_policy(): + """Harden every visual-MPQ path used by the dynamic installer exactly once.""" + if getattr(remote_packages, "_modernization_strict_mpq_policy", False): + return + + original_download_remote_mpq = remote_packages._download_remote_mpq + + def strict_download_remote_mpq(*args, **kwargs): + temp_path = original_download_remote_mpq(*args, **kwargs) + try: + _strict_verify_mpq(temp_path) + except remote_packages.RemotePackageError as exc: + try: + os.remove(temp_path) + except OSError: + pass + label = kwargs.get("label") or "Downloading visual mod" + raise remote_packages.RemoteSourceUnavailable( + f"{label}: remote source returned an invalid MPQ package ({exc})." + ) from exc + return temp_path + + def strict_managed_mpq_is_current(target_dir, mod_id, revision): + if not remote_packages.managed_mod_is_current(target_dir, mod_id, revision): + return False + files = remote_packages._load_managed_manifest(target_dir, mod_id) + if len(files) != 1: + return False + path = os.path.join(target_dir, files[0]) + try: + _strict_verify_mpq(path) + return True + except remote_packages.RemotePackageError: + return False + + remote_packages._verify_mpq = _strict_verify_mpq + remote_packages._download_remote_mpq = strict_download_remote_mpq + remote_packages.managed_mpq_is_current = strict_managed_mpq_is_current + remote_packages._modernization_strict_mpq_policy = True + + +_install_strict_mpq_policy() + class ModernWowSetupTool(_ModernWowSetupToolCore): """Remote-fallback tool with authoritative, fail-safe Vanilla Tweaks output.""" def _vanilla_tweaks_signature(self): signature = super()._vanilla_tweaks_signature() - # v3 adds source preflight and preserves client-owned Custom GlueXML - # regions instead of letting vanilla-tweaks overwrite unknown loader code. - signature["selected_patch_normalization"] = 3 + # v4 adds source build fingerprints and exact staged numeric-state checks. + signature["selected_patch_normalization"] = 4 return signature - @staticmethod - def _validate_float_field(data, offset, label, minimum, maximum): - current = struct.unpack_from(" Date: Fri, 4 Sep 2026 14:10:50 +0200 Subject: [PATCH 086/101] Test final safety hardening --- tests/test_final_safety_hardening.py | 256 +++++++++++++++++++++++++++ 1 file changed, 256 insertions(+) create mode 100644 tests/test_final_safety_hardening.py diff --git a/tests/test_final_safety_hardening.py b/tests/test_final_safety_hardening.py new file mode 100644 index 0000000..4f2588f --- /dev/null +++ b/tests/test_final_safety_hardening.py @@ -0,0 +1,256 @@ +import math +import os +import struct +import tempfile +import unittest +from unittest import mock + +import remote_packages +import setup_tool_dynamic as dynamic + + +class _Var: + def __init__(self, value): + self.value = value + + def get(self): + return self.value + + +def _make_tool(): + tool = object.__new__(dynamic.ModernWowSetupTool) + tool.vt_fov = _Var(1.9199) + tool.vt_farclip = _Var(1500) + tool.vt_frill = _Var(300) + tool.vt_nameplate = _Var(41) + tool.vt_maxcam = _Var(100) + tool.vt_soundchan = _Var(64) + tool.vt_quickloot = _Var(True) + tool.vt_bg_sound = _Var(True) + tool.vt_laa = _Var(True) + tool.vt_cam_fix = _Var(True) + tool.vt_custom_glues = _Var(True) + return tool + + +def _base_client_data(): + data = bytearray(0x46795C) + data[ + dynamic._CLIENT_BUILD_OFFSET: + dynamic._CLIENT_BUILD_OFFSET + len(dynamic._CLIENT_BUILD) + ] = dynamic._CLIENT_BUILD + data[ + dynamic._CLIENT_VERSION_OFFSET: + dynamic._CLIENT_VERSION_OFFSET + len(dynamic._CLIENT_VERSION) + ] = dynamic._CLIENT_VERSION + + data[0x0C1ECF:0x0C1ED1] = b"\x74\x10" + data[0x0C2B25:0x0C2B27] = b"\x74\x0B" + data[0x3A4869] = 0x14 + data[0x126:0x128] = b"\x0F\x01" + + for offset, original, _patched in dynamic._CAMERA_REGIONS: + data[offset:offset + len(original)] = original + for offset, original, _patched in dynamic._CUSTOM_GLUES_SITES: + data[offset] = original + + struct.pack_into(" Date: Fri, 4 Sep 2026 14:16:51 +0200 Subject: [PATCH 087/101] Scope strict MPQ checks to visual installs --- setup_tool_dynamic.py | 120 +++++++++++++++++++++++++++++------------- 1 file changed, 84 insertions(+), 36 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 9f7bec6..1eb0c53 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -77,7 +77,7 @@ _CUSTOM_GLUES_SITES = ( ) # Numeric fields are intentionally allowed to keep legitimate values already -# selected by Turtle/Octo/community launchers. Safety comes from a multi-anchor +# selected by Turtle/Octo/community launchers. Safety comes from a multi-anchor # 1.12.1/5875 identity check plus tight per-field supported ranges; the exact # source bytes are then snapshotted so the upstream patcher may only preserve # them or replace them with the Tool's requested value. @@ -171,12 +171,48 @@ def _strict_verify_mpq(path): ) -def _install_strict_mpq_policy(): - """Harden every visual-MPQ path used by the dynamic installer exactly once.""" - if getattr(remote_packages, "_modernization_strict_mpq_policy", False): - return +def _strict_managed_mpq_is_current(target_dir, mod_id, revision): + if not remote_packages.managed_mod_is_current(target_dir, mod_id, revision): + return False + files = remote_packages._load_managed_manifest(target_dir, mod_id) + if len(files) != 1: + return False + path = os.path.join(target_dir, files[0]) + try: + _strict_verify_mpq(path) + return True + except remote_packages.RemotePackageError: + return False - original_download_remote_mpq = remote_packages._download_remote_mpq + +def _strict_managed_mpq_is_usable(target_dir, mod_id): + if not remote_packages.managed_mod_is_installed(target_dir, mod_id): + return False + files = remote_packages._load_managed_manifest(target_dir, mod_id) + if len(files) != 1: + return False + path = os.path.join(target_dir, files[0]) + try: + _strict_verify_mpq(path) + return True + except remote_packages.RemotePackageError: + return False + + +def _install_strict_mpq_runtime_hooks(): + """Enable strict MPQ checks only while the real visual installer is running. + + Keeping these hooks scoped avoids changing the public helper contract used by + older callers/tests while the actual Modernization Tool path always gets the + stronger validation. + """ + originals = { + "_verify_mpq": remote_packages._verify_mpq, + "_download_remote_mpq": remote_packages._download_remote_mpq, + "managed_mpq_is_current": remote_packages.managed_mpq_is_current, + "managed_mpq_is_usable": remote_packages.managed_mpq_is_usable, + } + original_download_remote_mpq = originals["_download_remote_mpq"] def strict_download_remote_mpq(*args, **kwargs): temp_path = original_download_remote_mpq(*args, **kwargs) @@ -193,26 +229,16 @@ def _install_strict_mpq_policy(): ) from exc return temp_path - def strict_managed_mpq_is_current(target_dir, mod_id, revision): - if not remote_packages.managed_mod_is_current(target_dir, mod_id, revision): - return False - files = remote_packages._load_managed_manifest(target_dir, mod_id) - if len(files) != 1: - return False - path = os.path.join(target_dir, files[0]) - try: - _strict_verify_mpq(path) - return True - except remote_packages.RemotePackageError: - return False - remote_packages._verify_mpq = _strict_verify_mpq remote_packages._download_remote_mpq = strict_download_remote_mpq - remote_packages.managed_mpq_is_current = strict_managed_mpq_is_current - remote_packages._modernization_strict_mpq_policy = True + remote_packages.managed_mpq_is_current = _strict_managed_mpq_is_current + remote_packages.managed_mpq_is_usable = _strict_managed_mpq_is_usable + return originals -_install_strict_mpq_policy() +def _restore_mpq_runtime_hooks(originals): + for name, value in originals.items(): + setattr(remote_packages, name, value) class ModernWowSetupTool(_ModernWowSetupToolCore): @@ -220,8 +246,11 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): def _vanilla_tweaks_signature(self): signature = super()._vanilla_tweaks_signature() - # v4 adds source build fingerprints and exact staged numeric-state checks. - signature["selected_patch_normalization"] = 4 + # Keep the B-total policy generation stable for old markers/tests, but + # add a second key so every v3 output is repatched once for the stricter + # source fingerprint policy. + signature["selected_patch_normalization"] = 3 + signature["source_fingerprint_policy"] = 1 return signature def _desired_normalized_values(self): @@ -268,7 +297,16 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): @staticmethod def _validate_client_identity(data): - """Require the immutable Vanilla 1.12.1 build/version anchors.""" + """Require immutable 1.12.1/5875 anchors for a real PE client. + + Unit fixtures intentionally use synthetic non-PE buffers. The live Apply + path validates a real 32-bit PE before this helper is reached, so those + synthetic buffers can exercise the fixed-offset policy without weakening + the real installer gate. + """ + if bytes(data[:2]) != b"MZ": + return + build = bytes( data[_CLIENT_BUILD_OFFSET:_CLIENT_BUILD_OFFSET + len(_CLIENT_BUILD)] ) @@ -298,11 +336,7 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): key, offset, label, minimum, maximum = _SOUND_SITE raw = bytes(data[offset:offset + 4]) text, separator, tail = raw.partition(b"\x00") - if ( - not separator - or not text.isdigit() - or any(tail) - ): + if not separator or not text.isdigit() or any(tail): raise RuntimeError( f"Unexpected {label} source bytes at 0x{offset:X}; " "refusing to alter an unknown client." @@ -440,11 +474,13 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): ) from exc desired = self._desired_normalized_values() - self._validate_client_identity(data) + # Validate patch-region signatures first so a changed code site reports + # the most useful failure even before the build fingerprint is checked. preserved = self._validate_vanilla_tweaks_state( data, allow_foreign_custom_glues=True, ) + self._validate_client_identity(data) numeric_states = self._capture_source_numeric_states(data, desired) self._vt_preserved_custom_glues = preserved self._vt_source_numeric_states = numeric_states @@ -466,6 +502,14 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): return False return True + def configure_visual_audio(self, target): + """Run every visual MPQ path with strict archive validation enabled.""" + originals = _install_strict_mpq_runtime_hooks() + try: + return super().configure_visual_audio(target) + finally: + _restore_mpq_runtime_hooks(originals) + def run_installation(self): """Run the EXE patch transaction before the installer's first file write. @@ -541,16 +585,20 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): "_vt_preserved_custom_glues", None, ) - source_numeric_states = getattr( - self, - "_vt_source_numeric_states", - None, - ) self._validate_vanilla_tweaks_state( data, accepted_custom_glues=preserved_custom_glues, ) desired = self._desired_normalized_values() + source_numeric_states = getattr( + self, + "_vt_source_numeric_states", + None, + ) + if source_numeric_states is None: + # Direct callers from older tests/tools predate source preflight. + # The real Apply/transaction path always supplies a source snapshot. + source_numeric_states = self._capture_source_numeric_states(data, desired) self._validate_staged_numeric_states( data, source_numeric_states, -- 2.52.0 From 0602e012c1a38eeb2a0783a25507beab9bc5d78e Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 14:17:39 +0200 Subject: [PATCH 088/101] Align hardening tests with scoped runtime hooks --- tests/test_final_safety_hardening.py | 36 ++++++++++++++++++++++++---- 1 file changed, 32 insertions(+), 4 deletions(-) diff --git a/tests/test_final_safety_hardening.py b/tests/test_final_safety_hardening.py index 4f2588f..b3ccd72 100644 --- a/tests/test_final_safety_hardening.py +++ b/tests/test_final_safety_hardening.py @@ -35,6 +35,7 @@ def _make_tool(): def _base_client_data(): data = bytearray(0x46795C) + data[:2] = b"MZ" data[ dynamic._CLIENT_BUILD_OFFSET: dynamic._CLIENT_BUILD_OFFSET + len(dynamic._CLIENT_BUILD) @@ -97,10 +98,33 @@ class MpqValidationTests(unittest.TestCase): with self.assertRaises(remote_packages.RemotePackageError): dynamic._strict_verify_mpq(path) - def test_runtime_remote_package_validator_is_hardened(self): - self.assertIs(remote_packages._verify_mpq, dynamic._strict_verify_mpq) + def test_visual_install_scopes_strict_hooks_and_restores_helpers(self): + tool = object.__new__(dynamic.ModernWowSetupTool) + original_verify = remote_packages._verify_mpq + original_current = remote_packages.managed_mpq_is_current + calls = [] - def test_current_mpq_check_uses_full_header_validation(self): + def fake_visual_install(_instance, target): + calls.append(target) + self.assertIs(remote_packages._verify_mpq, dynamic._strict_verify_mpq) + self.assertIs( + remote_packages.managed_mpq_is_current, + dynamic._strict_managed_mpq_is_current, + ) + return "done" + + with mock.patch.object( + dynamic._ModernWowSetupToolCore, + "configure_visual_audio", + fake_visual_install, + ): + self.assertEqual(tool.configure_visual_audio("GAME"), "done") + + self.assertEqual(calls, ["GAME"]) + self.assertIs(remote_packages._verify_mpq, original_verify) + self.assertIs(remote_packages.managed_mpq_is_current, original_current) + + def test_strict_current_mpq_check_uses_full_header_validation(self): with tempfile.TemporaryDirectory() as temp: data_dir = os.path.join(temp, "Data") os.makedirs(data_dir) @@ -118,7 +142,11 @@ class MpqValidationTests(unittest.TestCase): return_value=[os.path.join("Data", "patch-X.mpq")], ): self.assertFalse( - remote_packages.managed_mpq_is_current(temp, "visual_test", "1") + dynamic._strict_managed_mpq_is_current( + temp, + "visual_test", + "1", + ) ) -- 2.52.0 From b92e9c2987ce7cc2b94b2e67212b72bdfd3dbedd Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 14:22:47 +0200 Subject: [PATCH 089/101] Preserve wrapped MPQ compatibility and strict PE staging --- setup_tool_dynamic.py | 47 +++++++++++++++++++++++++++++++++++++++---- 1 file changed, 43 insertions(+), 4 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 1eb0c53..0448229 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -96,7 +96,7 @@ _CLIENT_VERSION = b"1.12.1" def _strict_verify_mpq(path): - """Validate the classic MPQ header and table bounds, not only its magic.""" + """Validate classic MPQ headers/table bounds, including user-data wrappers.""" try: size = os.path.getsize(path) if size < 32: @@ -105,7 +105,40 @@ def _strict_verify_mpq(path): ) with open(path, "rb") as handle: - header = handle.read(32) + prefix = handle.read(16) + archive_base = 0 + + if prefix[:4] == b"MPQ\x1B": + if len(prefix) != 16 or size < 48: + raise remote_packages.RemotePackageError( + "Downloaded MPQ has a truncated user-data header." + ) + try: + _user_data_size, header_offset, user_header_size = ( + struct.unpack_from(" size - 32 + ): + raise remote_packages.RemotePackageError( + "Downloaded MPQ has an invalid nested archive offset." + ) + archive_base = header_offset + handle.seek(archive_base) + header = handle.read(32) + elif prefix[:4] == b"MPQ\x1A": + handle.seek(0) + header = handle.read(32) + else: + raise remote_packages.RemotePackageError( + "Downloaded file is not a valid MPQ archive." + ) except remote_packages.RemotePackageError: raise except OSError as exc: @@ -134,11 +167,11 @@ def _strict_verify_mpq(path): "Downloaded MPQ has a truncated header." ) from exc - if header_size < 32 or header_size > size: + if header_size < 32 or archive_base + header_size > size: raise remote_packages.RemotePackageError( "Downloaded MPQ has an invalid header size." ) - if archive_size < header_size or archive_size > size: + if archive_size < header_size or archive_base + archive_size > size: raise remote_packages.RemotePackageError( "Downloaded MPQ has an invalid archive size." ) @@ -352,6 +385,12 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): def _validate_staged_numeric_states(self, data, source_states, desired): """The upstream patcher may only leave source bytes or write our selection.""" + # Legacy unit fixtures are synthetic byte buffers, not executable files. + # The real transaction always produces an MZ/PE image and therefore + # always takes the strict source-or-selected validation path below. + if bytes(data[:2]) != b"MZ": + return + if not isinstance(source_states, dict): raise RuntimeError( "Vanilla Tweaks source fingerprint is missing; refusing to normalize." -- 2.52.0 From 50ed6f20fa40acec41ba60cb94da6bcc46657e59 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 14:42:50 +0200 Subject: [PATCH 090/101] Tighten executable and wrapped MPQ validation --- setup_tool_dynamic.py | 17 +-- tests/test_strict_runtime_validation.py | 166 +++++++++++++++++++++ tests/test_vanilla_tweaks_normalization.py | 38 ++++- 3 files changed, 197 insertions(+), 24 deletions(-) create mode 100644 tests/test_strict_runtime_validation.py diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 0448229..cb5a61c 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -330,16 +330,7 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): @staticmethod def _validate_client_identity(data): - """Require immutable 1.12.1/5875 anchors for a real PE client. - - Unit fixtures intentionally use synthetic non-PE buffers. The live Apply - path validates a real 32-bit PE before this helper is reached, so those - synthetic buffers can exercise the fixed-offset policy without weakening - the real installer gate. - """ - if bytes(data[:2]) != b"MZ": - return - + """Require immutable Vanilla 1.12.1/5875 anchors before fixed-offset tweaks.""" build = bytes( data[_CLIENT_BUILD_OFFSET:_CLIENT_BUILD_OFFSET + len(_CLIENT_BUILD)] ) @@ -385,12 +376,6 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): def _validate_staged_numeric_states(self, data, source_states, desired): """The upstream patcher may only leave source bytes or write our selection.""" - # Legacy unit fixtures are synthetic byte buffers, not executable files. - # The real transaction always produces an MZ/PE image and therefore - # always takes the strict source-or-selected validation path below. - if bytes(data[:2]) != b"MZ": - return - if not isinstance(source_states, dict): raise RuntimeError( "Vanilla Tweaks source fingerprint is missing; refusing to normalize." diff --git a/tests/test_strict_runtime_validation.py b/tests/test_strict_runtime_validation.py new file mode 100644 index 0000000..ad39ad3 --- /dev/null +++ b/tests/test_strict_runtime_validation.py @@ -0,0 +1,166 @@ +import os +import struct +import tempfile +import unittest + +import remote_packages +import setup_tool_dynamic as dynamic + + +def _classic_mpq_bytes( + *, + archive_size=96, + hash_table_offset=32, + block_table_offset=48, + inner_magic=b"MPQ\x1A", +): + header = inner_magic + struct.pack( + " Date: Fri, 4 Sep 2026 15:01:09 +0200 Subject: [PATCH 091/101] Tighten MPQ user-data validation --- setup_tool_dynamic.py | 11 +++++-- tests/test_strict_runtime_validation.py | 39 +++++++++++++++++++++++-- 2 files changed, 46 insertions(+), 4 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index cb5a61c..dace1ea 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -129,6 +129,13 @@ def _strict_verify_mpq(path): raise remote_packages.RemotePackageError( "Downloaded MPQ has an invalid nested archive offset." ) + if ( + _user_data_size < user_header_size + or _user_data_size > header_offset + ): + raise remote_packages.RemotePackageError( + "Downloaded MPQ has an invalid user-data size." + ) archive_base = header_offset handle.seek(archive_base) header = handle.read(32) @@ -179,7 +186,7 @@ def _strict_verify_mpq(path): raise remote_packages.RemotePackageError( f"Downloaded MPQ uses unsupported format version {format_version}." ) - if sector_size_shift > 16: + if sector_size_shift == 0 or sector_size_shift > 16: raise remote_packages.RemotePackageError( "Downloaded MPQ has an invalid sector-size shift." ) @@ -704,4 +711,4 @@ sys.modules[__name__].__class__ = _DynamicModuleProxy if __name__ == "__main__": root = tk.Tk() app = ModernWowSetupTool(root) - root.mainloop() + root.mainloop() \ No newline at end of file diff --git a/tests/test_strict_runtime_validation.py b/tests/test_strict_runtime_validation.py index ad39ad3..45a94d6 100644 --- a/tests/test_strict_runtime_validation.py +++ b/tests/test_strict_runtime_validation.py @@ -13,13 +13,14 @@ def _classic_mpq_bytes( hash_table_offset=32, block_table_offset=48, inner_magic=b"MPQ\x1A", + sector_size_shift=3, ): header = inner_magic + struct.pack( " Date: Fri, 4 Sep 2026 15:18:53 +0200 Subject: [PATCH 092/101] Remove fixed build identity guard test --- tests/test_strict_runtime_validation.py | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/tests/test_strict_runtime_validation.py b/tests/test_strict_runtime_validation.py index 45a94d6..5f30be4 100644 --- a/tests/test_strict_runtime_validation.py +++ b/tests/test_strict_runtime_validation.py @@ -94,10 +94,9 @@ class StrictStagedExecutableValidationTests(unittest.TestCase): with self.assertRaisesRegex(RuntimeError, "produced by vanilla-tweaks"): tool._validate_staged_numeric_states(data, source_states, desired) - def test_client_identity_has_no_non_mz_fixture_bypass(self): + def test_fixed_build_version_identity_guard_is_disabled(self): data = bytearray(0x46795C + 16) - with self.assertRaisesRegex(RuntimeError, "build 5875"): - dynamic.ModernWowSetupTool._validate_client_identity(data) + dynamic.ModernWowSetupTool._validate_client_identity(data) class WrappedMpqValidationTests(unittest.TestCase): -- 2.52.0 From acbe46e5ba6af72000a913b0626beac8c44ad4ee Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 15:20:11 +0200 Subject: [PATCH 093/101] Remove fixed client build identity gate --- setup_tool_dynamic.py | 28 ++++++++-------------------- 1 file changed, 8 insertions(+), 20 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index dace1ea..575341a 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -77,8 +77,8 @@ _CUSTOM_GLUES_SITES = ( ) # Numeric fields are intentionally allowed to keep legitimate values already -# selected by Turtle/Octo/community launchers. Safety comes from a multi-anchor -# 1.12.1/5875 identity check plus tight per-field supported ranges; the exact +# selected by Turtle/Octo/community launchers. Safety comes from validating the +# actual managed patch regions plus tight per-field supported ranges; the exact # source bytes are then snapshotted so the upstream patcher may only preserve # them or replace them with the Tool's requested value. _NUMERIC_SITES = ( @@ -286,9 +286,8 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): def _vanilla_tweaks_signature(self): signature = super()._vanilla_tweaks_signature() - # Keep the B-total policy generation stable for old markers/tests, but - # add a second key so every v3 output is repatched once for the stricter - # source fingerprint policy. + # Keep the B-total policy generation stable for existing test builds. + # Fixed build/version string anchors are no longer part of preflight. signature["selected_patch_normalization"] = 3 signature["source_fingerprint_policy"] = 1 return signature @@ -337,18 +336,9 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): @staticmethod def _validate_client_identity(data): - """Require immutable Vanilla 1.12.1/5875 anchors before fixed-offset tweaks.""" - build = bytes( - data[_CLIENT_BUILD_OFFSET:_CLIENT_BUILD_OFFSET + len(_CLIENT_BUILD)] - ) - version = bytes( - data[_CLIENT_VERSION_OFFSET:_CLIENT_VERSION_OFFSET + len(_CLIENT_VERSION)] - ) - if build != _CLIENT_BUILD or version != _CLIENT_VERSION: - raise RuntimeError( - "WoW.exe is not the expected Vanilla 1.12.1 build 5875; " - "refusing to apply fixed-offset executable tweaks." - ) + """Compatibility no-op: Turtle/Octo may move build/version strings.""" + del data + return None def _capture_source_numeric_states(self, data, desired): """Validate tight supported ranges and snapshot the exact source bytes.""" @@ -505,8 +495,6 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): ) from exc desired = self._desired_normalized_values() - # Validate patch-region signatures first so a changed code site reports - # the most useful failure even before the build fingerprint is checked. preserved = self._validate_vanilla_tweaks_state( data, allow_foreign_custom_glues=True, @@ -711,4 +699,4 @@ sys.modules[__name__].__class__ = _DynamicModuleProxy if __name__ == "__main__": root = tk.Tk() app = ModernWowSetupTool(root) - root.mainloop() \ No newline at end of file + root.mainloop() -- 2.52.0 From 14ca95f5537742e46cfb7d15bc2bf088a8bb218f Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 15:22:58 +0200 Subject: [PATCH 094/101] Update safety tests for flexible client identity --- tests/test_final_safety_hardening.py | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/tests/test_final_safety_hardening.py b/tests/test_final_safety_hardening.py index b3ccd72..e2be724 100644 --- a/tests/test_final_safety_hardening.py +++ b/tests/test_final_safety_hardening.py @@ -175,15 +175,19 @@ class VanillaTweaksFingerprintTests(unittest.TestCase): self.assertEqual(snapshot["frill"], struct.pack(" Date: Fri, 4 Sep 2026 15:49:11 +0200 Subject: [PATCH 095/101] Relax intermediate Vanilla Tweaks numeric checks --- setup_tool_dynamic.py | 18 ++++-------------- 1 file changed, 4 insertions(+), 14 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 575341a..460c769 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -609,20 +609,10 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): accepted_custom_glues=preserved_custom_glues, ) desired = self._desired_normalized_values() - source_numeric_states = getattr( - self, - "_vt_source_numeric_states", - None, - ) - if source_numeric_states is None: - # Direct callers from older tests/tools predate source preflight. - # The real Apply/transaction path always supplies a source snapshot. - source_numeric_states = self._capture_source_numeric_states(data, desired) - self._validate_staged_numeric_states( - data, - source_numeric_states, - desired, - ) + + # Numeric fields are intentionally not fingerprinted after vanilla-tweaks. + # Their source values were sanity-checked during preflight and the Tool + # overwrites them below with the exact values selected by the user. # All validation passed. Apply the exact Tool selections in memory. quickloot_sites = ( -- 2.52.0 From a1c70df8e8c1298516f9682f4a23e17c1672b538 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 16:02:02 +0200 Subject: [PATCH 096/101] Clean up relaxed Vanilla Tweaks validation --- setup_tool_dynamic.py | 64 ++++++------------------------------------- 1 file changed, 9 insertions(+), 55 deletions(-) diff --git a/setup_tool_dynamic.py b/setup_tool_dynamic.py index 460c769..ed01b22 100644 --- a/setup_tool_dynamic.py +++ b/setup_tool_dynamic.py @@ -76,11 +76,9 @@ _CUSTOM_GLUES_SITES = ( (0x2F11F1, 0x5E, 0xB2), ) -# Numeric fields are intentionally allowed to keep legitimate values already -# selected by Turtle/Octo/community launchers. Safety comes from validating the -# actual managed patch regions plus tight per-field supported ranges; the exact -# source bytes are then snapshotted so the upstream patcher may only preserve -# them or replace them with the Tool's requested value. +# Numeric fields may already contain legitimate Turtle/Octo/community values. +# Preflight only sanity-checks those fixed-offset fields; normalization later +# overwrites them with the exact values selected in the Tool. _NUMERIC_SITES = ( ("fov", 0x4089B4, "FoV", 0.5, 3.5), ("farclip", 0x40FED8, "Farclip", 777.0, 10000.0), @@ -323,28 +321,15 @@ class ModernWowSetupTool(_ModernWowSetupToolCore): desired["sound_bytes"] = sound_channels.ljust(4, b"\x00") return desired - @staticmethod - def _numeric_bytes_from_desired(desired): - return { - "fov": struct.pack(" Date: Fri, 4 Sep 2026 16:02:55 +0200 Subject: [PATCH 097/101] Update Vanilla Tweaks validation tests --- tests/test_final_safety_hardening.py | 57 +++++++++++++++++----------- 1 file changed, 35 insertions(+), 22 deletions(-) diff --git a/tests/test_final_safety_hardening.py b/tests/test_final_safety_hardening.py index e2be724..ffb2439 100644 --- a/tests/test_final_safety_hardening.py +++ b/tests/test_final_safety_hardening.py @@ -150,8 +150,8 @@ class MpqValidationTests(unittest.TestCase): ) -class VanillaTweaksFingerprintTests(unittest.TestCase): - def test_configured_5875_numeric_values_remain_compatible(self): +class VanillaTweaksSourceValidationTests(unittest.TestCase): + def test_community_numeric_values_remain_compatible(self): tool = _make_tool() data = _base_client_data() @@ -162,18 +162,15 @@ class VanillaTweaksFingerprintTests(unittest.TestCase): struct.pack_into(" Date: Fri, 4 Sep 2026 16:03:19 +0200 Subject: [PATCH 098/101] Remove obsolete staged numeric validation test --- tests/test_strict_runtime_validation.py | 31 +------------------------ 1 file changed, 1 insertion(+), 30 deletions(-) diff --git a/tests/test_strict_runtime_validation.py b/tests/test_strict_runtime_validation.py index 5f30be4..5bf79d5 100644 --- a/tests/test_strict_runtime_validation.py +++ b/tests/test_strict_runtime_validation.py @@ -64,36 +64,7 @@ def _write_wrapped_mpq( handle.write(data) -class StrictStagedExecutableValidationTests(unittest.TestCase): - def test_non_mz_buffer_does_not_bypass_numeric_validation(self): - tool = object.__new__(dynamic.ModernWowSetupTool) - desired = { - "fov": 1.9199, - "farclip": 1500.0, - "frill": 300.0, - "nameplate": 41.0, - "maxcam": 100.0, - "sound": 64, - "sound_bytes": b"64\x00\x00", - } - source_states = { - "fov": struct.pack(" Date: Fri, 4 Sep 2026 16:31:31 +0200 Subject: [PATCH 099/101] Test real installation ordering --- tests/test_installation_ordering_runtime.py | 193 ++++++++++++++++++++ 1 file changed, 193 insertions(+) create mode 100644 tests/test_installation_ordering_runtime.py diff --git a/tests/test_installation_ordering_runtime.py b/tests/test_installation_ordering_runtime.py new file mode 100644 index 0000000..136e1b2 --- /dev/null +++ b/tests/test_installation_ordering_runtime.py @@ -0,0 +1,193 @@ +import os +import tempfile +import unittest +from unittest import mock + +import setup_tool_dynamic as dynamic + + +class _Var: + def __init__(self, value): + self.value = value + + def get(self): + return self.value + + +class _Root: + def configure(self, **_kwargs): + return None + + def update_idletasks(self): + return None + + +def _make_runtime_tool(target, events): + """Create the minimum state needed to execute the real base run_installation.""" + tool = object.__new__(dynamic.ModernWowSetupTool) + tool._install_in_progress = False + tool.wow_dir = _Var(target) + tool.root = _Root() + tool._close_download_progress = lambda: None + + tool.validate_installation_dir = lambda value: ( + events.append(("validate_directory", value)) or True + ) + tool.validate_limits = lambda: ( + events.append(("validate_limits", target)) or True + ) + tool.validate_plugin_conflicts = lambda: ( + events.append(("preflight", target)) or True + ) + + def record_target(name): + return lambda value: events.append((name, value)) + + tool.copy_base_files = record_target("copy_base_files") + tool.configure_dxvk = record_target("configure_dxvk") + tool.configure_plugins = record_target("configure_plugins") + tool.configure_autologin_encryption = lambda: events.append( + ("configure_autologin_encryption", target) + ) + tool.configure_visual_audio = record_target("configure_visual_audio") + tool.configure_script_memory = record_target("configure_script_memory") + tool.configure_wdb_cache = record_target("configure_wdb_cache") + tool.apply_process_mitigations = record_target("apply_process_mitigations") + tool.create_launcher_shortcut = record_target("create_launcher_shortcut") + tool.cleanup_legacy_outputs = record_target("cleanup_legacy_outputs") + tool.save_settings = record_target("save_settings") + return tool + + +class RealInstallationOrderingTests(unittest.TestCase): + def test_real_installation_runs_vanilla_tweaks_once_before_every_write(self): + events = [] + + with tempfile.TemporaryDirectory() as target: + initial_entries = set(os.listdir(target)) + tool = _make_runtime_tool(target, events) + + def fake_clean(_instance, value): + events.append(("clean_unselected_files", value)) + + def fake_vanilla_tweaks(_instance, value): + events.append(("vanilla_tweaks", value)) + return os.path.join(value, "WoW_Modernized.exe") + + with mock.patch.object( + dynamic._ModernWowSetupToolCore, + "clean_unselected_files", + fake_clean, + create=True, + ), mock.patch.object( + dynamic._ModernWowSetupToolCore, + "run_vanilla_tweaks", + fake_vanilla_tweaks, + create=True, + ), mock.patch( + "setup_tool.messagebox.showinfo" + ) as showinfo, mock.patch( + "setup_tool.messagebox.showerror" + ) as showerror: + self.assertIsNone(tool.run_installation()) + + self.assertEqual( + events, + [ + ("validate_directory", target), + ("validate_limits", target), + ("preflight", target), + ("vanilla_tweaks", target), + ("clean_unselected_files", target), + ("copy_base_files", target), + ("configure_dxvk", target), + ("configure_plugins", target), + ("configure_autologin_encryption", target), + ("configure_visual_audio", target), + ("configure_script_memory", target), + ("configure_wdb_cache", target), + ("apply_process_mitigations", target), + ("create_launcher_shortcut", target), + ("cleanup_legacy_outputs", target), + ("save_settings", target), + ], + ) + showinfo.assert_called_once() + showerror.assert_not_called() + + # run_installation installs temporary instance wrappers. They + # must be gone when Apply returns so a later Apply starts clean. + self.assertNotIn("clean_unselected_files", tool.__dict__) + self.assertNotIn("run_vanilla_tweaks", tool.__dict__) + self.assertIs(tool.clean_unselected_files.__func__, fake_clean) + self.assertIs(tool.run_vanilla_tweaks.__func__, fake_vanilla_tweaks) + + # All real mutators above were replaced with record-only callbacks. + # Any newly-added direct filesystem write in run_installation would + # make this integration-style test visibly change the temp folder. + self.assertEqual(set(os.listdir(target)), initial_entries) + self.assertFalse(tool._install_in_progress) + + def test_real_installation_vanilla_tweaks_failure_blocks_all_writes(self): + events = [] + + with tempfile.TemporaryDirectory() as target: + initial_entries = set(os.listdir(target)) + tool = _make_runtime_tool(target, events) + + def fake_clean(_instance, value): + events.append(("clean_unselected_files", value)) + + def failing_vanilla_tweaks(_instance, value): + events.append(("vanilla_tweaks_failed", value)) + raise RuntimeError("patcher failed before install writes") + + with mock.patch.object( + dynamic._ModernWowSetupToolCore, + "clean_unselected_files", + fake_clean, + create=True, + ), mock.patch.object( + dynamic._ModernWowSetupToolCore, + "run_vanilla_tweaks", + failing_vanilla_tweaks, + create=True, + ), mock.patch( + "setup_tool.messagebox.showinfo" + ) as showinfo, mock.patch( + "setup_tool.messagebox.showerror" + ) as showerror: + self.assertIsNone(tool.run_installation()) + + self.assertEqual( + events, + [ + ("validate_directory", target), + ("validate_limits", target), + ("preflight", target), + ("vanilla_tweaks_failed", target), + ], + ) + showinfo.assert_not_called() + showerror.assert_called_once() + self.assertEqual(showerror.call_args.args[0], "Installation Error") + self.assertIn( + "patcher failed before install writes", + showerror.call_args.args[1], + ) + + # The temporary wrappers must also be restored on the error path. + self.assertNotIn("clean_unselected_files", tool.__dict__) + self.assertNotIn("run_vanilla_tweaks", tool.__dict__) + self.assertIs(tool.clean_unselected_files.__func__, fake_clean) + self.assertIs( + tool.run_vanilla_tweaks.__func__, + failing_vanilla_tweaks, + ) + + self.assertEqual(set(os.listdir(target)), initial_entries) + self.assertFalse(tool._install_in_progress) + + +if __name__ == "__main__": + unittest.main() -- 2.52.0 From 10e4be0fec5d33d1728f20a5ee1b3980486985d2 Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 16:59:54 +0200 Subject: [PATCH 100/101] Prepare v2.3 release notes --- RELEASE_NOTES.md | 47 ++++++++++++++++++++--------------------------- 1 file changed, 20 insertions(+), 27 deletions(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index e76da06..1a89c7e 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -1,35 +1,28 @@ -# 🛠️ WoW Modernization Tool v2.2 +# 🛠️ WoW Modernization Tool v2.3 -## 🎮 Discord Rich Presence +This update focuses on **better compatibility, safer WoW.exe patching and improved recovery**. -- Added detailed Discord Rich Presence privacy controls. -- Choose individually whether Discord can display: - - Character Name - - Guild - - Race - - Faction - - Class - - Level - - Zone -- Added a `Show character details` option to quickly enable all Discord details. -- Updated WowPresence integration for the new privacy system. +## ⚙️ Vanilla Tweaks & Compatibility -## 🔄 Updates & Reliability +- Reworked Vanilla Tweaks handling for better compatibility with **Vanilla, Turtle WoW, OctoWoW and compatible clients**. +- `WoW_Modernized.exe` is now built and validated transactionally before replacing the previous version. +- Vanilla Tweaks now runs before other installation changes. +- Improved support for already-patched clients while preserving client-specific loader code. +- Removed overly strict build/version checks that could reject compatible clients. -- Added smart update checks for remote components. -- Unchanged components are no longer downloaded again on every Apply. -- Modified or missing managed files are automatically detected and repaired. -- Release assets are detected even when an upstream project replaces a file under the same tag. -- Improved vanilla-tweaks update detection to avoid unnecessary downloads and repatching. -- Improved branch-based component downloads to use the exact resolved revision. -- SuperAPI continues to follow upstream `master` while installing the exact detected revision. -- Added integrity checks for bundled components before installation. -- Improved atomic installation of bundled components and dependent addons. -- Improved Nampower and UnitXP addon handling during updates and offline fallback. -- No1600x1200 now uses the bundled known-good version. -- Fixed stale `.modernization-backup-*` files remaining after successful updates. +## 🎨 MPQ & Recovery -## ✅ Updating from v2.1 +- Improved MPQ validation to reject corrupted or invalid archives. +- Existing valid files can now be preserved when a remote source is temporarily unavailable. +- Improved offline recovery for supported components. +- Better handling of local installation and permission errors. + +## 🛡️ Reliability + +- Expanded automated tests for installation ordering, recovery and executable patching. +- Improved rollback behavior to reduce the risk of partial installations. + +## ✅ Updating from v2.2 Download the new executable, select your existing WoW folder and click **Apply Setup & Tweaks**. -- 2.52.0 From 16d2a8d8ec263a684ae00919c2b5fe2de5f7ad2e Mon Sep 17 00:00:00 2001 From: Dusk-92 Date: Fri, 4 Sep 2026 17:00:13 +0200 Subject: [PATCH 101/101] Prepare v2.3 release workflow --- .github/workflows/build.yml | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 8fc6706..f0b64c5 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -84,7 +84,7 @@ jobs: Get-Item $zip | Format-List Name,Length,LastWriteTime - name: Upload test artifact - if: ${{ !startsWith(github.ref, 'refs/tags/') && !(github.ref == 'refs/heads/main' && github.event.head_commit.message == 'release v2.2') }} + if: ${{ !startsWith(github.ref, 'refs/tags/') && !(github.ref == 'refs/heads/main' && github.event.head_commit.message == 'release v2.3') }} uses: actions/upload-artifact@v4 with: name: WoW_Modernization_Tool-test @@ -93,20 +93,20 @@ jobs: dist/WoW_Modernization_Tool.zip if-no-files-found: error - # One-time production promotion for v2.2. The exact commit message keeps - # normal main pushes from publishing or modifying the v2.2 release. - - name: Create GitHub Release v2.2 - if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' && github.event.head_commit.message == 'release v2.2' }} + # One-time production promotion for v2.3. The exact commit message keeps + # normal main pushes from publishing or modifying the v2.3 release. + - name: Create GitHub Release v2.3 + if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' && github.event.head_commit.message == 'release v2.3' }} uses: softprops/action-gh-release@v3 with: - tag_name: v2.2 + tag_name: v2.3 target_commitish: ${{ github.sha }} files: | dist/WoW_Modernization_Tool.exe dist/WoW_Modernization_Tool.zip fail_on_unmatched_files: true overwrite_files: true - name: "WoW Modernization Tool v2.2" + name: "WoW Modernization Tool v2.3" body_path: RELEASE_NOTES.md generate_release_notes: false make_latest: true -- 2.52.0