Clarify calendar implementation TS types

* Renames calendar implementation types for clarity
* Moves calendar type declarations together
* Adds documetation for calendar types

Author: justingrant