[api-extractor]: Add support for @throws

[vidartf]

Fixes #1631.

Note: I originally added a @throws line to one of the interfaces callables, and spent quite some time debugging why this didn't cause any change. I then realized that interface callables are not documented?

[octogonz]

Note: I originally added a @throws line to one of the interfaces callables, and spent quite some time debugging why this didn't cause any change. I then realized that interface callables are not documented?

Hmmm... you're right. Call signatures are a somewhat obscure feature, so I guess this is a loose end that never got finished. 🤷‍♂ We never use call signatures in the Rush Stack APIs.

I see that call signatures are correctly serialized into the .api.json file, so it should be pretty easy to add a case to MarkdownDocumenter.ts to support them. Since they don't have a name, there might be a design question about how to represent them in the docs (perhaps related to the ae-ambiguous-ids discussion). Probably a pretty easy work item, though. Feel free to open an issue if you need this.

[octogonz]

@vidartf Thanks for contributing this feature! It's been published with API Documenter 7.7.0.