Added better support for jsdoc tags

[gionkunz]

Hi there

Great library! This is perfect for use in static site generators where I currently also created a plugin (for assemble.io https://www.npmjs.org/package/assemble-dox )

I always hoped to use some more complex JSdoc annotations / types tag in dox, so I've created this pull request. Basically it changes the parsing a bit to make it more robust for complex types and white spaces. Then it uses a parser / lexer module to parse the JSDoc tag type strings. As a side effect there is now also support for nullable, non-nullable, vairable and optional on param, return, throws and type tags. Also there is a new typesDescription field on the tag objects that contains an HTML formatted type string.

I've updated the existing tests slightly (i think there was a wrong handling with the ? sign which is for flagging nullable and not optional) and also added new tests. I've also update the documentation.

This PR solves #135 and #82.

Hope I got the whole picture here and didn't miss anything.

Cheers
Gion

[shellscape]

👍

[thom4parisot]

👍

[gionkunz]

@evindor I see you're still actively developing on the library. Could you take a look at this PR? I'd really like to remove the git URL of my fork from my package.json :-D

[evindor]

@gionkunz yeah sure, this one is pretty large and i'm currently quite busy with my regular job but i'll have a look ASAP.

[evindor]

Hope i'll review it today/tomorrow.

[gionkunz]

Cool thanks man. No worries I understand.

[gionkunz]

Hi @evindor did you had a chance to review this PR? If you need me to change anything please let me know.

[gionkunz]

Hey @evindor please let me know if you need anything else.

[evindor]

@gionkunz I'm sorry it took so long :(

[shellscape]

nonsense @evindor! I appreciate that this project remains active, and the time you're able to throw at it.

[gionkunz]

@evindor thanks for your review! Much appreciated. Now Ill update my assemble-dox plugin and start going crazy with complex jsdoc type tags :-))