Enhance documentation for calendar event functions by refining return types and parameter aliases

api/CalendarEventGetInviteSortCriterion.lua

@@ -1,10 +1,12 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@return status criterion
----@return CLASS_SORT_ORDER class
----@return  name
----@return  status
+---@alias criterion
+---| "CLASS" Sorted by character class (according to the global table CLASS_SORT_ORDER)
+---| "NAME" Sorted by character name
+---| "STATUS" Sorted by invite status
+
+---@return criterion
 ---@return boolean reverse
 ---Returns the current sort mode for the event invite/signup list
 function CalendarEventGetInviteSortCriterion() end