JSDoc for types

[david-luna]

As an exercise on the type system and to remove the tsc build step it is possible to replace the TypeScript grammar in favor of adding JSDoc comments. VSCode supports it so we should not loose any type metadata.

Also check if possible to generate an index.d.ts file from the JSDoc info.

[david-luna]

Tip for method overloading

microsoft/TypeScript#25590 (comment)

[david-luna]

The heavy usage of type parameters and arguments makes it not possible, yet. JSDoc support from TS is not wide in terms of generic types https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html

To be reviewed after a while

[david-luna]

Revisit this based on the tip explained in this article
https://dev.to/manuartero/type-hints-on-pure-js-files-8ee

The idea is to have a pure js lib but exporting types and also using the internally. So there is no need for source maps and also will give more control to bundlers

[david-luna]

done in https://github.com/david-luna/basol/releases/tag/0.5.0. Also moved to ESM