Refactor API functions to enhance parameter aliasing and improve documentation clarity

api/SetNextBarberShopStyle.lua

@@ -1,10 +1,12 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param styleIndex 3 
----@param 1  
----@param 2  
----@param 3  
----@param reverse boolean 
+---@alias barberShopStyleIndex
+---| 1 - Hair (or Horn) Style
+---| 2 - Hair (or Horn) Color
+---| 3 - Varies by race and gender: Facial Hair, Earrings, Features, Hair, Horns, Markings, Normal, Piercings, or Tusks
+
+---@param styleIndex barberShopStyleIndex
+---@param reverse boolean
 ---Selects the next style for a barber shop style option. Changes the underlying data (and thus the character's appearance) only; the default barbershop UI does not update.
-function SetNextBarberShopStyle(styleIndex, 1, 2, 3, reverse) end
+function SetNextBarberShopStyle(styleIndex, reverse) end