fix: add doc-check script and export types used by functions

[achingbrain]

Uses tsc to attempt to compile any typescript code blocks in markdown files to ensure our examples don't get out of date.

Change checklist

• [x] I have performed a self-review of my own code
• [ ] I have made corresponding changes to the documentation if necessary (this includes comments as well)
• [ ] I have added tests that prove my fix is effective or that my feature works

[achingbrain]

Needs another push or two to fix up the out of date examples.