Refactor API functions to enhance parameter aliasing and improve documentation clarity

api/UnitResistance.lua

@@ -1,16 +1,18 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param unit string 
----@param resistanceIndex 5 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@return number base 
----@return number resistance 
----@return number positive 
----@return number negative 
+---@alias resistanceIndex
+---| 1 - Fire
+---| 2 - Nature
+---| 3 - Frost
+---| 4 - Shadow
+---| 5 - Arcane
+
+---@param unit string
+---@param resistanceIndex resistanceIndex
+---@return number base
+---@return number resistance
+---@return number positive
+---@return number negative
 ---Returns information about the player's or pet's magic resistance
-function UnitResistance(unit, resistanceIndex, 1, 2, 3, 4, 5) end
+function UnitResistance(unit, resistanceIndex) end