Refactor API functions to enhance parameter aliasing and improve documentation clarity

api/UnitStat.lua

@@ -1,16 +1,18 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param unit string 
----@param statIndex 5 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@return number stat 
----@return number effectiveStat 
----@return number posBuff 
----@return number negBuff 
+---@alias statIndex
+---| 1 - Strength
+---| 2 - Agility
+---| 3 - Stamina
+---| 4 - Intellect
+---| 5 - Spirit
+
+---@param unit string
+---@param statIndex statIndex
+---@return number stat
+---@return number effectiveStat
+---@return number posBuff
+---@return number negBuff
 ---Returns information about a basic character statistic for the player or pet
-function UnitStat(unit, statIndex, 1, 2, 3, 4, 5) end
+function UnitStat(unit, statIndex) end