Yeah, this is weird 😆 Should we be proposing a change in jsdoc or protobufjs instead? I'm a little worried about trying to accurately parse JavaScript in a way that's complete/effective here.

I'm only parsing protos, not JavaScript, so it's probably easier and more predictable.

jsdoc is out of question, it just reads what is in protos/protos.js. But protobufjs did not put the comments there because they ignore //-style comments.

Fixing this in pbjs may be an option, but a harder one (let me say this - I spent like half an hour staring at that code and did not immediately figure out how to make it work there). So I still opt for local proto rewrite.

Note that we don't really use these protos for anything in the runtime (they are now published just for reference, we don't load them), and if any parsing problem happens, we'll catch it when synthtool fails (when we run npx compileProtos src).

I need to think more about the proper way of doing this, given that we now can make protobuf.js releases.