Refactor API functions to standardize parameter aliases and improve documentation clarity

api/CalendarSetMonth.lua

@@ -1,9 +1,6 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param monthOffset 1 
----@param -1  
----@param 0  
----@param 1  
+---@param monthOffset monthOffset
 ---Sets the calendar's month relative to its current month
-function CalendarSetMonth(monthOffset, -1, 0, 1) end
+function CalendarSetMonth(monthOffset) end

api/CollapseGuildTradeSkillHeader.lua

@@ -1,17 +1,19 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param professionID 773 
----@param 164  
----@param 165  
----@param 171  
----@param 182  
----@param 186  
----@param 197  
----@param 202  
----@param 333  
----@param 393  
----@param 755  
----@param 773  
+---@alias professionID
+---| 164 - Blacksmithing
+---| 165 - Leatherworking
+---| 171 - Alchemy
+---| 182 - Herbalism
+---| 186 - Mining
+---| 197 - Tailoring
+---| 202 - Engineering
+---| 333 - Enchanting
+---| 393 - Skinning
+---| 755 - Jewelcrafting
+---| 773 - Inscription
+
+---@param professionID professionID
 ---Collapses the corresponding profession in the guild window. This function is used to collapse a single profession in the guild window (professions view) based on its ID. Can also be done while window is not visible. See ExpandGuildTradeSkillHeader() for opening the view.
-function CollapseGuildTradeSkillHeader(professionID, 164, 165, 171, 182, 186, 197, 202, 333, 393, 755, 773) end
+function CollapseGuildTradeSkillHeader(professionID) end

api/ConfirmLootRoll.lua

@@ -1,10 +1,7 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param id number 
----@param rollType 2 
----@param 0  
----@param 1  
----@param 2  
+---@param id number
+---@param rollType rollType
 ---Confirms the player's intent regarding an item up for loot rolling. Usable after the CONFIRM_LOOT_ROLL event fires, warning that an item binds on pickup.
-function ConfirmLootRoll(id, rollType, 0, 1, 2) end
+function ConfirmLootRoll(id, rollType) end

api/DeclineName.lua

@@ -1,16 +1,13 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param name string 
----@param gender 3 
----@param 1or nil  
----@param 2  
----@param 3  
----@param declensionSet number 
----@return string genitive 
----@return string dative 
----@return string accusative 
----@return string instrumental 
----@return string prepositional 
+---@param name string
+---@param gender gender
+---@param declensionSet number
+---@return string genitive
+---@return string dative
+---@return string accusative
+---@return string instrumental
+---@return string prepositional
 ---Returns suggested declensions for a name. In the Russian language, nouns (including proper names) take different form based on their usage in a sentence. When the player enters the base name for a character or pet, the game suggests one or more sets of variations for the five additional cases; the player is asked to choose from among the suggestions and/or enter their own. (The set of declensions ultimately chosen/entered by the player are only used internally and not available to addons.) Has no effect in non-Russian-localized clients.
-function DeclineName(name, gender, 1or nil, 2, 3, declensionSet) end
+function DeclineName(name, gender, declensionSet) end

api/DestroyTotem.lua

@@ -1,10 +1,6 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param slot 4 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
+---@param slot totemSlot
 ---Destroys a specific totem (or ghoul). Totem functions are also used for ghouls summoned by a Death Knight's Raise Dead ability (if the ghoul is not made a controllable pet by the Master of Ghouls talent).
-function DestroyTotem(slot, 1, 2, 3, 4) end
+function DestroyTotem(slot) end

api/DoTradeSkill.lua

@@ -1,7 +1,7 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param index number 
----@param repeat number 
+---@param index number
+---@param repeatn number
 ---Performs a trade skill recipe
-function DoTradeSkill(index, repeat) end
+function DoTradeSkill(index, repeatn) end

api/ExpandGuildTradeSkillHeader.lua

@@ -1,17 +1,6 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param professionID 773 
----@param 164  
----@param 165  
----@param 171  
----@param 182  
----@param 186  
----@param 197  
----@param 202  
----@param 333  
----@param 393  
----@param 755  
----@param 773  
+---@param professionID professionID
 ---Expands the corresponding profession in the guild window. This function is used to expand a single profession in the guild window (professions view) based on its ID. Can also be done while window is not visible. See CollapseGuildTradeSkillHeader() for closing the view again.
-function ExpandGuildTradeSkillHeader(professionID, 164, 165, 171, 182, 186, 197, 202, 333, 393, 755, 773) end
+function ExpandGuildTradeSkillHeader(professionID) end

api/GetAttackPowerForStat.lua

@@ -1,13 +1,8 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param statIndex 5 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@param effectiveStat number 
----@return number attackPower 
+---@param statIndex statIndex
+---@param effectiveStat number
+---@return number attackPower
 ---Returns the attack power bonus provided by one of the player's basic statistics
-function GetAttackPowerForStat(statIndex, 1, 2, 3, 4, 5, effectiveStat) end
+function GetAttackPowerForStat(statIndex, effectiveStat) end

api/GetAuctionInvTypes.lua

@@ -1,15 +1,15 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param classIndex number 
----@param subClassIndex 5 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@return string token 
----@return 1nil display 
----@return list ... 
+---@alias subClassIndex
+---| 1 - Miscellaneous
+---| 2 - Cloth
+---| 3 - Leather
+---| 4 - Mail
+---| 5 - Plate
+
+---@param classIndex number
+---@param subClassIndex subClassIndex
+---@return (string|boolean)[] #Pairs of token-display, try use {} to cram into table
 ---Returns a list of the inventory subtypes for a given auction house item subclass. Inventory types are the second level of hierarchy seen when browsing item classes (categories) and subclasses at the Auction House: Head, Neck, Shirt, et al for Miscellaneous; Head, Shoulder, Chest, Wrist, et al for Cloth; etc. This function still returns valid information if the player is not interacting with an auctioneer.
-function GetAuctionInvTypes(classIndex, subClassIndex, 1, 2, 3, 4, 5) end
+function GetAuctionInvTypes(classIndex, subClassIndex) end

api/GetAutoCompleteResults.lua

@@ -1,25 +1,29 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param inputString string 
----@param includeBitfield AUTOCOMPLETE_FLAG_ALL 
----@param 0x00000000 AUTOCOMPLETE_FLAG_NONE 
----@param 0x00000001 AUTOCOMPLETE_FLAG_IN_GROUP 
----@param 0x00000002 AUTOCOMPLETE_FLAG_IN_GUILD 
----@param 0x00000004 AUTOCOMPLETE_FLAG_FRIEND 
----@param 0x00000010 AUTOCOMPLETE_FLAG_INTERACTED_WITH 
----@param 0x00000020 AUTOCOMPLETE_FLAG_ONLINE 
----@param 0xffffffff AUTOCOMPLETE_FLAG_ALL 
----@param excludeBitfield AUTOCOMPLETE_FLAG_ALL 
----@param 0x00000000 AUTOCOMPLETE_FLAG_NONE 
----@param 0x00000001 AUTOCOMPLETE_FLAG_IN_GROUP 
----@param 0x00000002 AUTOCOMPLETE_FLAG_IN_GUILD 
----@param 0x00000004 AUTOCOMPLETE_FLAG_FRIEND 
----@param 0x00000010 AUTOCOMPLETE_FLAG_INTERACTED_WITH 
----@param 0x00000020 AUTOCOMPLETE_FLAG_ONLINE 
----@param 0xffffffff AUTOCOMPLETE_FLAG_ALL 
----@param maxResults number 
----@param cursorPosition number 
----@return list ... 
+---@alias includeBitfield #One or more of the following flags (combined via bit.bor()), indicating which characters should be included in the result list: (number, bitfield)
+---| 0x00000000 - AUTOCOMPLETE_FLAG_NONE: No characters
+---| 0x00000001 - AUTOCOMPLETE_FLAG_IN_GROUP: Characters in the player's party or raid
+---| 0x00000002 - AUTOCOMPLETE_FLAG_IN_GUILD: Characters in the player's guild
+---| 0x00000004 - AUTOCOMPLETE_FLAG_FRIEND: Characters from the player's friends list
+---| 0x00000010 - AUTOCOMPLETE_FLAG_INTERACTED_WITH: Characters with whom the player has recently interacted
+---| 0x00000020 - AUTOCOMPLETE_FLAG_ONLINE: Currently online friends and guildmates
+---| 0xffffffff - AUTOCOMPLETE_FLAG_ALL: All characters
+
+---@alias excludeBitfield #One or more of the following flags (combined via bit.bor()), indicating which characters should be excluded from the result list: (number, bitfield)
+---| 0x00000000 - AUTOCOMPLETE_FLAG_NONE: No characters
+---| 0x00000001 - AUTOCOMPLETE_FLAG_IN_GROUP: Characters in the player's party or raid
+---| 0x00000002 - AUTOCOMPLETE_FLAG_IN_GUILD: Characters in the player's guild
+---| 0x00000004 - AUTOCOMPLETE_FLAG_FRIEND: Characters from the player's friends list
+---| 0x00000010 - AUTOCOMPLETE_FLAG_INTERACTED_WITH: Characters with whom the player has recently interacted
+---| 0x00000020 - AUTOCOMPLETE_FLAG_ONLINE: Currently online friends and guildmates
+---| 0xffffffff - AUTOCOMPLETE_FLAG_ALL: All characters
+
+---@param inputString string
+---@param includeBitfield includeBitfield
+---@param excludeBitfield excludeBitfield
+---@param maxResults number
+---@param cursorPosition number
+---@return string[] results
 ---Returns a list of character names which complete a given partial name prefix
-function GetAutoCompleteResults(inputString, includeBitfield, 0x00000000, 0x00000001, 0x00000002, 0x00000004, 0x00000010, 0x00000020, 0xffffffff, excludeBitfield, 0x00000000, 0x00000001, 0x00000002, 0x00000004, 0x00000010, 0x00000020, 0xffffffff, maxResults, cursorPosition) end
+function GetAutoCompleteResults(inputString, includeBitfield, excludeBitfield, maxResults, cursorPosition) end

api/GetBarberShopStyleInfo.lua

@@ -1,13 +1,10 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param styleIndex 3 
----@param 1  
----@param 2  
----@param 3  
----@return string name 
----@return string unused 
----@return number cost 
----@return 1nil isCurrent 
+---@param styleIndex barberShopStyleIndex
+---@return string name
+---@return string unused
+---@return number cost
+---@return 1nil isCurrent
 ---Returns information about the selected barber shop style option
-function GetBarberShopStyleInfo(styleIndex, 1, 2, 3) end
+function GetBarberShopStyleInfo(styleIndex) end

api/GetBattlefieldTeamInfo.lua

@@ -1,13 +1,15 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param index 1 
----@param 0  
----@param 1  
----@return string teamName 
----@return number teamRating 
----@return number newTeamRating 
----@return number teamMMR 
----@return number numPlayers 
+---@alias battlegroundGroup
+---| 0 - Green Team/Horde
+---| 1 - Gold Team/Alliance
+
+---@param index battlegroundGroup
+---@return string teamName
+---@return number teamRating
+---@return number newTeamRating
+---@return number teamMMR
+---@return number numPlayers
 ---Returns info about teams and their rating and MMR in a rated arena match. Usable following the UPDATE_BATTLEFIELD_SCORE event.
-function GetBattlefieldTeamInfo(index, 0, 1) end
+function GetBattlefieldTeamInfo(index) end

api/GetFunctionCPUUsage.lua

@@ -1,9 +1,9 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param function function 
----@param includeSubroutines boolean 
----@return number usage 
----@return number calls 
+---@param func function
+---@param includeSubroutines boolean #True to include time spent in other functions called by the given function; false to count only time spent in the function body (boolean)
+---@return number usage #Amount of CPU time used by the function (in milliseconds) since the UI was loaded or ResetCPUUsage() was last called (number)
+---@return number calls #Number of times the function has been called (number)
 ---Returns information about CPU usage by a function. Only returns valid data if the scriptProfile CVar is set to 1; returns 0 otherwise.
-function GetFunctionCPUUsage(function, includeSubroutines) end
+function GetFunctionCPUUsage(func, includeSubroutines) end

api/GetGlyphLink.lua

@@ -1,11 +1,8 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param socket number 
----@param talentGroup nil 
----@param 1  
----@param 2  
----@param nil  
----@return string link 
+---@param socket number
+---@param talentGroup talentGroup
+---@return string link
 ---Gets a hyperlink for the contents of a glyph socket. Glyph links are distinct from item and spell links: e.g. "|cff66bbff|Hglyph:21:361|h[Glyph of Hunter's Mark]|h|r".
-function GetGlyphLink(socket, talentGroup, 1, 2, nil) end
+function GetGlyphLink(socket, talentGroup) end

api/GetGlyphSocketInfo.lua

@@ -1,15 +1,12 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param socket number 
----@param talentGroup nil 
----@param 1  
----@param 2  
----@param nil  
----@return boolean enabled 
----@return number glyphType 
----@return number glyphTooltipIndex 
----@return number glyphSpell 
----@return string icon 
+---@param socket number
+---@param talentGroup talentGroup
+---@return boolean enabled
+---@return number glyphType
+---@return number glyphTooltipIndex
+---@return number glyphSpell
+---@return string icon
 ---Returns information about a glyph socket and its contents. The spell ID referenced in the third return glyphSpell refers to the spell used to put the glyph in the socket -- not the Inscription spell that creates a glyph item, but the spell associated with that item's "Use:" effect.
-function GetGlyphSocketInfo(socket, talentGroup, 1, 2, nil) end
+function GetGlyphSocketInfo(socket, talentGroup) end

api/GetNumDeclensionSets.lua

@@ -1,11 +1,12 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param name string 
----@param gender 3 
----@param 1 or nil  
----@param 2  
----@param 3  
----@return number numSets 
+---@alias gender
+---| 1 or nil - Neuter
+---| 2 - Male
+---| 3 - Female
+
+---@param name string
+---@param gender gender
 ---Returns the number of suggested declension sets for a name. Used in the Russian localized World of Warcraft client; see DeclineName for further details. Returns 0 in other locales.
-function GetNumDeclensionSets(name, gender, 1 or nil, 2, 3) end
+function GetNumDeclensionSets(name, gender) end

api/GetRaidBuffTrayAuraInfo.lua

@@ -1,13 +1,23 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param nil number 
----@return string name 
----@return string rank 
----@return string texture 
----@return number duration 
----@return number expiration 
----@return number spellId 
----@return number slot 
----Returns the active buff for a given raid buff category. As of 5.0, the default BuffFrames aggregate standard raid buffs. GetRaidBuffTrayAuraInfo is used to determine which buff category is active. Current raid buff categories are:  RAID_BUFF_1 Stats RAID_BUFF_2 Stamina RAID_BUFF_3 Attack Power RAID_BUFF_4 Haste RAID_BUFF_5 Spell Power RAID_BUFF_6 Critical Strike RAID_BUFF_7 Mastery RAID_BUFF_8 Multistrike RAID_BUFF_9 Versatility  The highest raid buff category number is indicated by NUM_LE_RAID_BUFF_TYPES.
-function GetRaidBuffTrayAuraInfo(nil) end
+---@param index number
+---@return string name
+---@return string rank
+---@return string texture
+---@return number duration
+---@return number expiration
+---@return number spellId
+---@return number slot
+--- Returns the active buff for a given raid buff category. As of 5.0, the default BuffFrames aggregate standard raid buffs. GetRaidBuffTrayAuraInfo is used to determine which buff category is active. Current raid buff categories are:
+--  RAID_BUFF_1 Stats
+--  RAID_BUFF_2 Stamina
+--  RAID_BUFF_3 Attack Power
+--  RAID_BUFF_4 Haste
+--  RAID_BUFF_5 Spell Power
+--  RAID_BUFF_6 Critical Strike
+--  RAID_BUFF_7 Mastery
+--  RAID_BUFF_8 Multistrike
+--  RAID_BUFF_9 Versatility
+-- The highest raid buff category number is indicated by NUM_LE_RAID_BUFF_TYPES.
+function GetRaidBuffTrayAuraInfo(index) end

api/GetRuneCooldown.lua

@@ -1,15 +1,9 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param slot 6 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@param 6  
----@return number start 
----@return number duration 
----@return boolean runeReady 
+---@param slot runeSlot
+---@return number start
+---@return number duration
+---@return boolean runeReady
 ---Returns cooldown information about one of the player's rune resources. Note the placement of runes 3-4 (normally Unholy) and 5-6 (normally Frost) are reversed in the default UI. Also note the behavior of returned values differs slightly from most other GetXYZCooldown-style functions.
-function GetRuneCooldown(slot, 1, 2, 3, 4, 5, 6) end
+function GetRuneCooldown(slot) end

api/GetRuneCount.lua

@@ -1,13 +1,7 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param slot 6 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@param 6  
----@return number count 
+---@param slot runeSlot
+---@return number count
 ---Returns the number of available rune resources in one of the player's rune slots. Returns 1 if a rune is ready and 0 if a rune is on cooldown.
-function GetRuneCount(slot, 1, 2, 3, 4, 5, 6) end
+function GetRuneCount(slot) end

api/GetRuneType.lua

@@ -1,17 +1,21 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param slot 6 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@param 6  
----@return 4 runeType 
----@return  1 
----@return  2 
----@return  3 
----@return  4 
+---@alias runeSlot
+---| 1 - Leftmost
+---| 2 - Second from left
+---| 3 - Fifth from left (second from right)
+---| 4 - Sixth from left (rightmost)
+---| 5 - Third from left
+---| 6 - Fourth from left
+
+---@alias runeType
+---| 1 - Blood rune
+---| 2 - Unholy rune
+---| 3 - Frost rune
+---| 4 - Death rune
+
+---@param slot runeSlot
+---@return runeType runeType
 ---Returns the type of one of the player's rune resources. Note the placement of runes 3-4 (normally Unholy) and 5-6 (normally Frost) are reversed in the default UI.
-function GetRuneType(slot, 1, 2, 3, 4, 5, 6) end
+function GetRuneType(slot) end

api/GetSpellBonusDamage.lua

@@ -1,14 +1,7 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param school 7 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@param 6  
----@param 7  
----@return number minModifier 
+---@param school spellSchool
+---@return number minModifier
 ---Returns the player's spell damage bonus for a spell school
-function GetSpellBonusDamage(school, 1, 2, 3, 4, 5, 6, 7) end
+function GetSpellBonusDamage(school) end

api/GetSpellCritChance.lua

@@ -1,14 +1,16 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param school 7 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@param 6  
----@param 7  
----@return number minCrit 
+---@alias spellSchool
+---| 1 - Physical
+---| 2 - Holy
+---| 3 - Fire
+---| 4 - Nature
+---| 5 - Frost
+---| 6 - Shadow
+---| 7 - Arcane
+
+---@param school spellSchool
+---@return number minCrit
 ---Returns the player's spell critical strike chance for a spell school
-function GetSpellCritChance(school, 1, 2, 3, 4, 5, 6, 7) end
+function GetSpellCritChance(school) end

api/GetStablePetFoodTypes.lua

@@ -1,9 +1,7 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param index 1 to NUM_PET_STABLE_SLOTS 
----@param 0  
----@param 1 to NUM_PET_STABLE_SLOTS  
----@return list ... 
+---@param index number
+---@return string[] foodTypes
 ---Returns the types of food that a stabled pet will eat
-function GetStablePetFoodTypes(index, 0, 1 to NUM_PET_STABLE_SLOTS) end
+function GetStablePetFoodTypes(index) end

api/GetStablePetInfo.lua

@@ -1,13 +1,11 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param index 1 to NUM_PET_STABLE_SLOTS 
----@param 0  
----@param 1 to NUM_PET_STABLE_SLOTS  
----@return string icon 
----@return string name 
----@return number level 
----@return string family 
----@return string talent 
+---@param index number
+---@return string icon
+---@return string name
+---@return number level
+---@return string family
+---@return string talent
 ---Returns information about a stabled pet
-function GetStablePetInfo(index, 0, 1 to NUM_PET_STABLE_SLOTS) end
+function GetStablePetInfo(index) end

api/GetTalentLink.lua

@@ -1,14 +1,11 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param tabIndex number 
----@param talentIndex number 
----@param inspect boolean 
----@param pet boolean 
----@param talentGroup nil 
----@param 1  
----@param 2  
----@param nil  
----@return string link 
+---@param tabIndex number
+---@param talentIndex number
+---@param inspect boolean
+---@param pet boolean
+---@param talentGroup talentGroup
+---@return string link
 ---Returns a hyperlink for a talent
-function GetTalentLink(tabIndex, talentIndex, inspect, pet, talentGroup, 1, 2, nil) end
+function GetTalentLink(tabIndex, talentIndex, inspect, pet, talentGroup) end

api/GetTotemInfo.lua

@@ -1,15 +1,11 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param slot 4 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@return boolean haveTotem 
----@return string name 
----@return number startTime 
----@return number duration 
----@return string icon 
+---@param slot totemSlot
+---@return boolean haveTotem
+---@return string name
+---@return number startTime
+---@return number duration
+---@return string icon
 ---Returns information on a currently active totem (or ghoul). Totem functions are also used for ghouls summoned by a Death Knight's Raise Dead ability (if the ghoul is not made a controllable pet by the Master of Ghouls talent), for druids' wild mushrooms, and Affliction Warlock's Soul Effigy.
-function GetTotemInfo(slot, 1, 2, 3, 4) end
+function GetTotemInfo(slot) end

api/GetTotemTimeLeft.lua

@@ -1,11 +1,7 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param slot 4 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@return number seconds 
+---@param slot totemSlot
+---@return number seconds
 ---Returns the time remaining before a totem (or ghoul) automatically disappears. Using GetTime() and the third and fourth returns (startTime and duration) of GetTotemInfo() instead of this function is recommended if frequent updates are needed. Totem functions are also used for ghouls summoned by a Death Knight's Raise Dead ability (if the ghoul is not made a controllable pet by the Master of Ghouls talent).
-function GetTotemTimeLeft(slot, 1, 2, 3, 4) end
+function GetTotemTimeLeft(slot) end

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

api/GuildControlSetRankFlag.lua

@@ -1,23 +1,25 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param index 17 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@param 6  
----@param 7  
----@param 8  
----@param 9  
----@param 10  
----@param 11  
----@param 12  
----@param 13  
----@param 15  
----@param 16  
----@param 17  
----@param enabled boolean 
+---@alias guildControlRankFlag
+---| 1 - Guildchat listen
+---| 2 - Guildchat speak
+---| 3 - Officerchat listen
+---| 4 - Officerchat speak
+---| 5 - Promote
+---| 6 - Demote
+---| 7 - Invite Member
+---| 8 - Remove Member
+---| 9 - Set MOTD
+---| 10 - Edit Public Notes
+---| 11 - View Officer Note
+---| 12 - Edit Officer Note
+---| 13 - Modify Guild Info
+---| 15 - Use guild funds for repairs
+---| 16 - Withdraw gold from the guild bank
+---| 17 - Create Guild Event
+
+---@param index guildControlRankFlag
+---@param enabled boolean
 ---Enables or disables a privilege for the guild rank being edited. Changes are not saved until a call is made to GuildControlSaveRank().
-function GuildControlSetRankFlag(index, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, enabled) end
+function GuildControlSetRankFlag(index, enabled) end

api/IsMouseButtonDown.lua

@@ -1,12 +1,14 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param button 5 or Button5 
----@param 1 or LeftButton  
----@param 2 or RightButton  
----@param 3 or MiddleButton  
----@param 4 or Button4  
----@param 5 or Button5  
----@return 1nil isDown 
+---@alias mouseButton
+---| 1 or "LeftButton" - Primary mouse button
+---| 2 or "RightButton" - Secondary mouse button
+---| 3 or "MiddleButton" - Third mouse button (or clickable scroll control)
+---| 4 or "Button4" - Fourth mouse button
+---| 5 or "Button5" - Fifth mouse button
+
+---@param button mouseButton
+---@return boolean isDown
 ---Returns whether a given mouse button is held down. If no button is specified, returns 1 if any mouse button is held down.
-function IsMouseButtonDown(button, 1 or LeftButton, 2 or RightButton, 3 or MiddleButton, 4 or Button4, 5 or Button5) end
+function IsMouseButtonDown(button) end

api/KBArticle_BeginLoading.lua

@@ -1,9 +1,11 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param articleId number 
----@param searchType 2 
----@param 1  
----@param 2  
+---@alias searchType
+---| 1 - Default "top issues" search
+---| 2 - Search for specific text
+
+---@param articleId number
+---@param searchType searchType
 ---Requests a specific knowledge base article from the server
-function KBArticle_BeginLoading(articleId, searchType, 1, 2) end
+function KBArticle_BeginLoading(articleId, searchType) end

api/LearnTalent.lua

@@ -1,12 +1,14 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param tabIndex number 
----@param talentIndex number 
----@param isPet boolean 
----@param talentGroup nil 
----@param 1  
----@param 2  
----@param nil  
+---@alias talentGroup
+---| 1 - Primary Talents
+---| 2 - Secondary Talents
+---| nil - Currently active talents
+
+---@param tabIndex number
+---@param talentIndex number
+---@param isPet boolean
+---@param talentGroup talentGroup
 ---Learns a talent, spending one talent point
-function LearnTalent(tabIndex, talentIndex, isPet, talentGroup, 1, 2, nil) end
+function LearnTalent(tabIndex, talentIndex, isPet, talentGroup) end

api/LoadBindings.lua

@@ -1,9 +1,11 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param set 2 
----@param 0  
----@param 1  
----@param 2  
+---@alias bindingSet
+---| 0 - Default key bindings
+---| 1 - Account-wide key bindings
+---| 2 - Character-specific key bindings
+
+---@param set bindingSet
 ---Loads a set of key bindings. The UPDATE_BINDINGS event fires when the new bindings have taken effect.
-function LoadBindings(set, 0, 1, 2) end
+function LoadBindings(set) end

api/MovieRecording_IsCodecSupported.lua

@@ -1,11 +1,13 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param codecID 1836070006 
----@param 1635148593  
----@param 1768124260  
----@param 1835692129  
----@param 1836070006  
----@return boolean isSupported 
+---@alias codecID
+---| 1635148593 - H.264 - supported natively by Apple devices like the iPod, iPhone and AppleTV; best ratio quality/size but slowest to compress
+---| 1768124260 - Apple Intermediate Codec - fastest to compress, but exclusive to Mac OS X
+---| 1835692129 - Motion JPEG - faster to compress than H.264 but it will generate a bigger file
+---| 1836070006 - MPEG-4 - supported by many digital cameras and iMovie
+
+---@param codecID codecID
+---@return boolean isSupported
 ---Returns whether a video codec is supported on the current system
-function MovieRecording_IsCodecSupported(codecID, 1635148593, 1768124260, 1835692129, 1836070006) end
+function MovieRecording_IsCodecSupported(codecID) end

api/PickupStablePet.lua

@@ -1,8 +1,6 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param index 1 to NUM_PET_STABLE_SLOTS 
----@param 0  
----@param 1 to NUM_PET_STABLE_SLOTS  
+---@param index number #0 for active pet otherwise 1 to NUM_PET_STABLE_SLOTS
 ---Puts a pet from the stables onto the cursor. Use with ClickStablePet to move pets between stabled and active status.
-function PickupStablePet(index, 0, 1 to NUM_PET_STABLE_SLOTS) end
+function PickupStablePet(index) end

api/RespondInstanceLock.lua

@@ -1,8 +1,6 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param response true 
----@param false  
----@param true  
----Allows leaving a recently entered instance to which the player would otherwise be saved.    Applies when the player enters an instance to which other members of her group are saved; if the player leaves the within the time limit (see GetInstanceLockTimeRemaining()) she will not be saved to the instance.
-function RespondInstanceLock(response, false, true) end
+---@param response boolean
+---Allows leaving a recently entered instance to which the player would otherwise be saved. Applies when the player enters an instance to which other members of her group are saved; if the player leaves the within the time limit (see GetInstanceLockTimeRemaining()) she will not be saved to the instance.
+function RespondInstanceLock(response) end

api/RollOnLoot.lua

@@ -1,11 +1,13 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param id number 
----@param rollType 3 
----@param 0  
----@param 1  
----@param 2  
----@param 3  
+---@alias rollType number
+---| 0 - Pass (declines the loot)
+---| 1 - Roll "need" (wins if highest roll)
+---| 2 - Roll "greed" (wins if highest roll and no other member rolls "need")
+---| 3 - Disenchant
+
+---@param id number
+---@param rollType rollType
 ---Register the player's intent regarding an item up for loot rolling. Rolls are not actually performed until all eligible group members have registered their intent or the time period for rolling expires. If the item binds on pickup, the CONFIRM_LOOT_ROLL event fires, indicating that ConfirmLootRoll(id) must be called in order to actually roll on the item.
-function RollOnLoot(id, rollType, 0, 1, 2, 3) end
+function RollOnLoot(id, rollType) end

api/RunMacro.lua

@@ -1,8 +1,8 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param index number 
----@param name string 
----@param "button" string 
+---@param index number
+---@param name string
+---@param button string
 ---Runs a macro
-function RunMacro(index, name, "button") end
+function RunMacro(index, name, button) end

api/RunMacroText.lua

@@ -1,7 +1,7 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param "text" string 
----@param "button" string 
+---@param text string
+---@param button string
 ---Runs arbitrary text as a macro
-function RunMacroText("text", "button") end
+function RunMacroText(text, button) end

api/SetBattlefieldScoreFaction.lua

@@ -1,9 +1,11 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param faction nil 
----@param 0  
----@param 1  
----@param nil  
+---@alias battlegroundFaction
+---| 0 - Horde
+---| 1 - Alliance
+---| nil - All
+
+---@param faction battlegroundFaction
 ---Filters the battleground scoreboard by faction/team
-function SetBattlefieldScoreFaction(faction, 0, 1, nil) end
+function SetBattlefieldScoreFaction(faction) end

api/SetGuildBankTabPermissions.lua

@@ -1,10 +1,12 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param tab number 
----@param permission 2 
----@param 1  
----@param 2  
----@param enabled boolean 
+---@alias guildBankTab
+---| 1 - View tab
+---| 2 - Deposit items
+
+---@param tab guildBankTab
+---@param permission guildBankTab
+---@param enabled boolean
 ---Changes guild bank tab permissions for the guild rank being edited
-function SetGuildBankTabPermissions(tab, permission, 1, 2, enabled) end
+function SetGuildBankTabPermissions(tab, permission, enabled) end

api/SetMapZoom.lua

@@ -1,16 +1,18 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param continentIndex 7 
----@param -1  
----@param 0  
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@param 6  
----@param 7  
----@param zoneIndex number 
+---@alias continentIndex
+---| -1 - Cosmic map
+---| 0 - Entire Azeroth map
+---| 1 - Kalimdor
+---| 2 - Eastern Kingdoms
+---| 3 - Outland
+---| 4 - Northrend
+---| 5 - The Maelstrom
+---| 6 - Pandaria
+---| 7 - Draenor
+
+---@param continentIndex continentIndex
+---@param zoneIndex number
 ---Sets the world map to show a specific zone or continent
-function SetMapZoom(continentIndex, -1, 0, 1, 2, 3, 4, 5, 6, 7, zoneIndex) end
+function SetMapZoom(continentIndex, zoneIndex) end

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

api/SetRaidTarget.lua

@@ -1,17 +1,19 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param unit string 
----@param name string 
----@param index 8 
----@param 0  
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@param 6  
----@param 7  
----@param 8  
+---@alias raidTargetIndex
+---| 0 - Clear any raid target markers
+---| 1 - Star
+---| 2 - Circle
+---| 3 - Diamond
+---| 4 - Triangle
+---| 5 - Moon
+---| 6 - Square
+---| 7 - Cross
+---| 8 - Skull
+
+---@param unit string
+---@param name string
+---@param index raidTargetIndex
 ---Puts a raid target marker on a unit
-function SetRaidTarget(unit, name, index, 0, 1, 2, 3, 4, 5, 6, 7, 8) end
+function SetRaidTarget(unit, name, index) end

api/StartAuction.lua

@@ -1,13 +1,10 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param minBid number 
----@param buyoutPrice number 
----@param runTime 3 
----@param 1  
----@param 2  
----@param 3  
----@param stackSize number 
----@param numStacks number 
+---@param minBid number
+---@param buyoutPrice number
+---@param runTime auctionRunTime
+---@param stackSize number
+---@param numStacks number
 ---Creates an auction for the item currently in the "auction item" slot. Has no effect unless an item has been placed in the Create Auction UI's "auction item" slot (see ClickAuctionSellItemButton()). With patch 3.3.3 the runTime arg was changed from minutes to an index and the stackSize/numStacks args were added for batch posting.
-function StartAuction(minBid, buyoutPrice, runTime, 1, 2, 3, stackSize, numStacks) end
+function StartAuction(minBid, buyoutPrice, runTime, stackSize, numStacks) end

api/TargetTotem.lua

@@ -1,10 +1,12 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param slot 4 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
+---@alias totemSlot
+---| 1 - Fire (or Death Knight's ghoul)
+---| 2 - Earth
+---| 3 - Water
+---| 4 - Air
+
+---@param slot totemSlot
 ---Targets one of the player's totems (or a Death Knight's ghoul). Totem functions are also used for ghouls summoned by a Death Knight's Raise Dead ability (if the ghoul is not made a controllable pet by the Master of Ghouls talent).
-function TargetTotem(slot, 1, 2, 3, 4) end
+function TargetTotem(slot) end

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

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

api/securecall.lua

@@ -1,8 +1,8 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param function function 
----@param ... list 
----@return list ... 
+---@param func function
+---@param ... any
+---@return ... any
 ---Calls a function without tainting the execution path. Meaningless when called from outside of the secure environment. Used in Blizzard code to call functions which may be tainted or operate on potentially tainted variables. For example, consider the function CloseSpecialWindows, which iterates through the table UISpecialFrames and hides any frames named therein. Addon authors may put the names of their frames in that table to make them automatically close when the user presses the ESC key, but this taints UISpecialFrames. Were the default UI to then call CloseSpecialWindows normally, every frame in UISpecialFrames would become tainted, which could later lead to errors when handlers on those frames call protected functions. Instead, the default UI uses securecall(CloseSpecialWindows): within CloseSpecialWindows the execution path may become tainted, but afterward the environment remains secure.
-function securecall(function, ...) end
+function securecall(func, ...) end

api/select.lua

@@ -1,9 +1,8 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param index number 
----@param # string 
----@param ... list 
----@return list ... 
----Returns one or more values from a list (...), or the number of values in a list
-function select(index, #, ...) end
+---@param index number|"#"
+---@param ... any
+---@return ... any
+---Returns one or more values from a list (...) (if using index), or the number of values in a list (if using #)
+function select(index, ...) end