Merge master into module rework

PermoksAccountManager.toc

@@ -1,4 +1,4 @@
-## Interface: 110000
+## Interface: 110200, 120001
 ## Title: Permoks Account Manager
 ## Version: @project-version@
 ## SavedVariables: PermoksAccountManagerDB

PermoksAccountManager_Mists.toc

@@ -0,0 +1,46 @@
+## Interface: 50500
+## Title: Permoks Account Manager
+## Author: Permok
+## Version: @project-version@
+## SavedVariables: PermoksAccountManagerDB
+## X-Curse-Project-ID: 582886
+## X-Wago-ID: 25NRoe63
+
+
+libs\LibStub\LibStub.lua
+libs\CallbackHandler-1.0\CallbackHandler-1.0.lua
+libs\AceAddon-3.0\AceAddon-3.0.xml
+libs\AceConsole-3.0\AceConsole-3.0.xml
+libs\AceEvent-3.0\AceEvent-3.0.xml
+libs\AceDB-3.0\AceDB-3.0.xml
+libs\AceGUI-3.0\AceGUI-3.0.xml
+libs\AceConfig-3.0\AceConfig-3.0.xml
+libs\AceComm-3.0\AceComm-3.0.xml
+libs\AceLocale-3.0\AceLocale-3.0.xml
+libs\LibDataBroker-1.1\LibDataBroker-1.1.lua
+libs\LibDBIcon-1.0\lib.xml
+libs\LibQTip-1.0\lib.xml
+libs\LibDeflate\LibDeflate.lua
+libs\LibSerialize\LibSerialize.lua
+libs\LibSharedMedia-3.0\lib.xml
+libs\AceGUI-3.0-SharedMediaWidgets\widget.xml
+libs\AceGUIWidget-TwoTextButton.lua
+
+modules.lua
+locales\locales.xml
+commands.lua
+communication.lua
+
+db\db-mop.lua
+
+modules\accounts.lua
+modules\character.lua
+modules\currencies.lua
+modules\factions.lua
+modules\instances.lua
+modules\quests.lua
+modules\items.lua
+modules\classic_professions.lua
+
+PermoksAccountManager.lua
+options.lua

api.lua

@@ -3,12 +3,118 @@ _G.PAMAPI = {}
 
 local api = _G.PAMAPI
 
-function api.AddModule(...)
-	if ... then
-		local added = PermoksAccountManager:AddModule(...)
+--[[
+PAM API quick reference
+
+How to add a module
+1. Create a unique module name.
+2. Build a payload table:
+   - update(charInfo): fills or refreshes data on the current character.
+   - labels: table of rowIdentifier = labelRow.
+   - events: eventName = callback or { callbackA, callbackB }.
+     Every callback receives (charInfo, ...eventArgs).
+   - share: optional map of callbackFunction = charInfoKey.
+     After that callback runs, PAM shares charInfo[charInfoKey] with synced accounts.
+3. Register the module with:
+   local module = _G.PAMAPI.AddModule("my_module", payload, true)
+   Pass true for forceLoad when you want the module to register events and run update() immediately.
+4. Keep every row identifier unique across all PAM modules.
+
+Minimal complete example
+local api = _G.PAMAPI
+
+local function UpdateExample(charInfo)
+    charInfo.exampleModule = charInfo.exampleModule or {}
+    charInfo.exampleModule.status = IsResting() and "Resting" or "Awake"
+end
+
+local payload = {
+    update = UpdateExample,
+    labels = {
+        example_status = {
+            label = "Example Status",
+            group = "other",
+            version = false,
+            data = function(altData)
+                return altData.exampleModule and altData.exampleModule.status or "-"
+            end,
+        },
+    },
+    events = {
+        PLAYER_ENTERING_WORLD = UpdateExample,
+        PLAYER_UPDATE_RESTING = UpdateExample,
+    },
+    share = {
+        [UpdateExample] = "exampleModule",
+    },
+}
+
+api.AddModule("example_module", payload, true)
+
+Built-in labelRow.type values supported by PAM without custom registration
+- quest: reads altData.questInfo[questType][visibility][key].
+- currency: reads altData.currencyInfo[key].
+- faction: reads altData.factions[key].
+- item: reads altData.itemCounts[key].
+- sanctum: reads altData.sanctumInfo with labelRow.key.
+- raid: reads altData.instanceInfo.raids[key].
+- pvp: reads altData.pvp[key].
+- vault: reads altData.vaultInfo[key].
+
+If you do not want to use one of the built-in types, set data = function(altData, labelRow, rowIdentifier)
+on the row instead. Bundled types such as gold, keystone, spark, worldquest, renown, and similar module-
+specific types are not core defaults; they are registered by their owning modules.
+
+Common label row fields
+- label: string or function returning the row name shown in the UI.
+- type: optional string; use one of the built-in types above or a custom type you registered yourself.
+- data: optional fallback renderer used when no built-in/custom type is needed.
+- key: optional lookup key used by most built-in types.
+- group: optional group/category key such as character, currency, item, dungeons, raids, reputation,
+  profession, resetDaily, resetWeekly, or other.
+- version: false for all game versions, or a specific WOW_PROJECT_* constant.
+- tooltip: true to use the default tooltip for the type, or a function for a custom tooltip.
+- customTooltip: function(button, altData, labelRow, rowIdentifier) for full tooltip control.
+- color: function(altData) returning a ColorMixin.
+- OnClick: function(buttonName, altData) for row click handling.
+- warband: true to show in the warband column, "unique" for warband-only rows.
+- passKey: for custom label types, prepends labelRow.key or rowIdentifier to the callback arguments.
+- passRow: for custom label types, prepends the full labelRow to the callback arguments.
+
+Available functions
+- PAMAPI.AddModule(moduleName, payload, forceLoad)
+  moduleName: unique string used to register the module.
+  payload: table containing update, labels, optional events, and optional share.
+  forceLoad: boolean; pass true to load the module immediately.
+  returns: the created module object, or nil when registration fails.
+
+- module:AddCustomLabelType(customType, callback, alwaysForceUpdate, ...)
+  customType: string that your label rows use in labelRow.type.
+  callback: renderer called with the altData fields named in ... after PAM extracts them.
+  alwaysForceUpdate: boolean; when true, callback arguments are rebuilt every refresh instead of cached.
+  ...: one or more altData keys, for example "itemCounts", "currencyInfo", or "exampleModule".
+
+- PAMAPI.GetCharacterInfo(key)
+  key: string key from the current character info table.
+  returns: PermoksAccountManager.charInfo[key], or nil.
+
+- PAMAPI.GetCharactersForAccount(account)
+  account: account key from db.global.accounts, for example "main" or a synced account id.
+  returns: db.global.accounts[account].data, or nil.
+
+- PAMAPI.Import(importString)
+  importString: export string created by PAM.
+  effect: overwrites the imported custom/category/options data and reruns OnLogin() to refresh state.
+]]
+
+
+function api.AddModule(moduleName, payload, forceLoad)
+	if moduleName and payload then
+		local added = PermoksAccountManager:AddModule(moduleName, payload, forceLoad)
 		if added then
 			PermoksAccountManager.UpdateCustomLabelOptions()
 		end
+		return added
 	end
 end
 
@@ -23,3 +129,15 @@ function api.GetCharactersForAccount(account)
 		return PermoksAccountManager.db.global.accounts[account].data
 	end
 end
+
+function api.Import(importString)
+	local data = PermoksAccountManager:ParseImportString(importString)
+	if data then
+		PermoksAccountManager.db.global.custom = data.custom
+		PermoksAccountManager.db.global.options = data.options
+		PermoksAccountManager.db.global.internalVersion = data.internalVersion
+	end
+
+	--TODO: Handle the import more gracefully. This should work for now. Forcing a reload would probably be more secure.
+	PermoksAccountManager:OnLogin()
+end

commands.lua

@@ -193,6 +193,13 @@ function commands.SECRET()
 	end
 end
 
+function commands.SETVERSION(version)
+	version = tonumber(version)
+	if version then
+		PermoksAccountManager.db.global.internalTWWVersion = version
+	end
+end
+
 function commands.CL()
 	PermoksAccountManager.db.global.customLabels = not PermoksAccountManager.db.global.customLabels
 end
@@ -224,6 +231,10 @@ function PermoksAccountManager:Purge()
 	self:OnLogin()
 
 	self:Print("Please reload your interface to update the displayed info.")
+
+	if self.isRetail then
+		self:Print("To update Warband currency info a relog is required.")
+	end
 end
 
 function PermoksAccountManager:ResetCategories()