JSDoc @api tag

[aweebit]

I have been looking for documentation on the @api tag used to mark private API methods in tj/commander.js, but I could not find any. However, VSCode clearly has support for it because the words private, protected and public following the tag are highlighted differently than other words. I would like to find the code responsible for the highlighting so as to learn about how and why it was added. Could you please point me in the right direction?

[aweebit]

I found 9ad4bcd introducing support for the @api tag, but the commit does not seem to be included in any PR, and since there is also no commit description, I could not find any explanation on why the support was added. I would be grateful if you could explain it to me. Is there documentation on the tag somewhere I could not find, or was it simply added to support some de facto usage like the one in the aforementioned Commander library?

[mjbvz]

The grammar that provides jsdoc highlighting lives in https://github.com/microsoft/TypeScript-TmLanguage