Feature: return comments with the parser

[Janther]

added the comments option and when it's set to true, the AST will have an extra property with an array of all of the comments within the source.
Also fixed a bug where the loc of a token will display the wrong end property if the token contained new lines.

Once this is published prettier-plugin-solidity won't need solidity-comments-extractor anymore.

[fvictorio]

This is great, thanks a lot @Janther!

I left two very optional comments, feel free to merge whether you apply them or not.

[tonisives]

Just saying the comment parsing seems to be incorrect for some functions. For instance, this one:

    /**
        @notice Returns square-root spot price, lower and upper bounds of the AMM position. 
     */
    function getAMMState()

link

[fvictorio]

@tonisives what does the parser produce and why do you think it's wrong? I tried it and got:

[
  {
    type: 'BlockComment',
    value: '*\n' +
      '        @notice Returns square-root spot price, lower and upper bounds of the AMM position. \n' +
      '     '
  }
]

which looks correct to me.

[tonisives]

I am not familiar with AST representation of comments. I can only write my preference.

*
            @notice Returns square-root spot price, lower and upper bounds of the AMM position. 
         

If I look at this result, then it is missing * and / \ characters.

Another issue is with /// function comments.
They are missing 2 of the / in front of the comment

[source](https://github.com/sherlock-audit/2024-03-arrakis/blob/main/arrakis-modular/src/ArrakisMetaVaultFactory.sol#L121)

I would also like to get the whole comment (all 9 lines), but they are as separate objects in the result.

I think it is normal to expect that /// lines above the function compose the full function comment. But again, I don't know AST comments format at all.