Refactor API functions to improve parameter aliasing and enhance documentation clarity

api/GetWorldPVPAreaInfo.lua

@@ -1,14 +1,16 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param pvpMapID 2 
----@param 1  
----@param 2  
----@return number pvpID 
----@return string localizedName 
----@return boolean isActive 
----@return boolean canQueue 
----@return number waitTime 
----@return boolean canEnter 
+---@alias pvpMapID
+---| 1 - Wintergrasp
+---| 2 - Tol Barad
+
+---@param pvpMapID pvpMapID
+---@return number pvpID
+---@return string localizedName
+---@return boolean isActive
+---@return boolean canQueue
+---@return number waitTime
+---@return boolean canEnter
 ---Returns information about a given world PvP zone
-function GetWorldPVPAreaInfo(pvpMapID, 1, 2) end
+function GetWorldPVPAreaInfo(pvpMapID) end