Annotate the TypeScript definitions file with appropriate JSDoc comments

[dead-claudia]

Low-priority for me, but I'm definitely willing to accept outside help for this. The docs are relatively complete, so this should be easy for anyone to do, even if they don't really understand JS well.