JSDoc

Problems to be aware of:

  • object is converted to any for some reason.
  • If you have an error in the jsdoc, you get no warning/error. TS just silently doesn't type annotate the function.
  • casting can be verbose

(thanks Gil Tayar and Gleb Bahmutov for sharing above commentary)