adding typescript types via [jsdoc](https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html) has some benefits: - no build changes needed - helps with trivial parameter errors and autocompletion - helps with new contributors i'm willing to open a PR.
