this is exactly what JSDoc is for, it's had these capabilities from the start.