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

api/CalendarEventGetCalendarType.lua

@@ -1,9 +1,6 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@return PLAYER calendarType
----@return  GUILD_ANNOUNCEMENT
----@return  GUILD_EVENT
----@return  PLAYER
+---@return calendarType
 ---Returns the type of the selected calendar event
 function CalendarEventGetCalendarType() end