Right now, our API reference and typings are defined separately. Because of this, we have to manually write both docs and typescript types for our public API. Sometimes they get out of sync.

This needs to be solved by introducing automatic generation of either docs by code or code by docs.