feat(jest-docblock): support multiple of the same @pragma

[azz]

Summary

Currently, when jest-docblock parses:

/**
 * @foo x
 * @foo y
 */

we get { foo: 'y' }.

This PR changes it to { foo: ['x', 'y'] } when there are multiple.

The PR also adds support for that in docblock.print().

Test plan

Unit tests added and passing.

cc @vjeux

[codecov-io]

Codecov Report

Merging #5502 into master will increase coverage by 0.03%.
The diff coverage is 40%.

@@            Coverage Diff             @@
##           master    #5502      +/-   ##
==========================================
+ Coverage   61.67%   61.71%   +0.03%     
==========================================
  Files         213      213              
  Lines        7071     7075       +4     
  Branches        3        3              
==========================================
+ Hits         4361     4366       +5     
+ Misses       2709     2708       -1     
  Partials        1        1

Impacted Files	Coverage Δ
packages/jest-haste-map/src/worker.js	96% <100%> (+0.16%)	⬆️
packages/jest-docblock/src/index.js	53.84% <25%> (+10.36%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 3942361...104fc53. Read the comment docs.

[cpojer]

Awesome, thanks for the fix. Internally at FB we discussed making this throw instead and I think for our internal use cases this makes sense, however I do not think that in open source Jest we can make such a decision. It's easier to support multiple of the same directives without having to ask users to change their behavior.

[azz]

Yeah, I can easily imagine this breaking TypeScript JSDoc, e.g:

/**
 * @typedef {Object} SpecialType - creates a new type named 'SpecialType'
 * @property {string} prop1 - a string property of SpecialType
 * @property {number} prop2 - a number property of SpecialType
 * @property {number=} prop3 - an optional number property of SpecialType
 * @prop {number} [prop4] - an optional number property of SpecialType
 * @prop {number} [prop5=42] - an optional number property of SpecialType with default value
 */

[vjeux]

Thanks for doing this!

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.
Please note this issue tracker is not a help forum. We recommend using StackOverflow or our discord channel for questions.