Hello! Thank you for the project.

Fixes #52

Overview

I noticed discussion over at #52 about typings support, & personally I would benefit a lot from its ease-of-use. So, I went ahead & implemented it into the build process, (& taking note of the discussion thus) without migrating the entire project over to the Typescript language. This was done with some explicit JSDoc types over annonymous functions that TS didn't like, as well as some general improvements such as copying over the in-code explanations out for consumers to read inline.

Notes

• Not everything has been typed fully, there are a lot of props 😅.
• There exists a few extraneous type exports that are prefixed with a _ because by default Typescript exports all JSDoc @typedefs. In theory you should be able to assign the types to an unused variable & reference it with typeof, but I couldn't get it to work.
• I added @types/three, which will now have to be tracked to the three version associated with the package. (Maybe consider making it a peer dependency in the future?)
• There weren't any stylistic constraints on how JSDoc were to be written, so I kinda just went along with what worked. Please do make any changes there as required.
• I had to disable the ESLint rule valid-jsdoc, since it didn't like doing typings inline within the constructor. I assume this can be workarounded by doing @prop on the class's JSDoc, but imo it becomes hard to trace when doing new implementations.