fix jsdoc @param union type support & @returns * all type support

[hirokith]

No description provided.

[hirokith]

Two weeks gone, is there anyone maintaining this package's upgrade? Need this pr to be merged badly!

[fkling]

Sorry, I've been on vacation for exactly two weeks :)

[fkling]

I'm wondering if this shouldn't rather be something like {name: 'union', value: ['string', 'Object']}. What do you think @janicduplessis?

[janicduplessis]

I agree we should keep this as an object since it's easier to use after. We should try to have a similar output object as the flow type definitions.

/**
 * @param test Test
 */
function (test: string | Object) {}

and

/**
 * @param {string | Object} test Test
 */
function (test) {}

should result in the same thing.

You could take a look at what the object we return for flow types look like and return something similar.

[hirokith]

OK, I'll update the commit soon.

[hirokith]

Another week gone, so when will this to be merged and when will next version to be published?

[fkling]

Sorry for the slow progress here, the last couple of weeks just had been really busy (I was traveling most of the time).

If we want to stay compatible with flow types, I think * should be mapped to mixed or any.

[hirokith]

OK, thank you for your suggestion, I've updated the commit~

[danez]

👍