New Implementation

[dantleech]

Completely new AST based implementation:

• Produces reliable AST
• Captures node byte-offsets (e.g. to faciliate editing)
• Support parsing generics
• Feature parity with existing parser

The parser is around ~33% faster than the PHPStan docblock parser (although the benchmark is quite naieve currently):

\Phpactor\Docblock\Tests\Benchmark\PhpstanParserBench

    benchParse..............................I32 250.285 μs (±14.90%)

\Phpactor\Docblock\Tests\Benchmark\PhpactorParserBench

    benchParse..............................I32 185.466 μs (±14.97%)

But still around *3 times slower^ than the existing implementation, it might be possible to reduce this perforamance gap, and I'm not sure what the final performance impact would be.

TODO:

• Create a test which parses the phpstorm stubs.
• See if performance can be improved further
• Support multi-line descriptions

[BladeMF]

Do we get completion within type declarations in the doc block with this?

[dantleech]

Do we get completion within type declarations in the doc block with this?

This is just the parser, it just provides information about the docblock.