JSDoc support for @yields

It would be nice to be able to use the @yields JSDoc tag.

We work with JS and JSDoc, but taking advantage of TSC and VSCode.
We also use the valid-jsdoc eslint rule.

We have:

/** @typedef Thing (...) */

function* walkThings() {
//... some yield here and there
}

We want to

/**
 * @yields {Thing}
 */
function* walkThings() {
//... some yield here and there
}

We can't do

/**
 * @returns {IterableIterator<Something>}
 */
function* walkThings() {
//... some yield here and there
}

Because it doesn't return, but yields, and eslint complains about it. We can disable the rule here, but it is not the desirable scenario.

リポジトリのファイルもテストも指定されていません。まず、ジェネレーター関数と @returns に対する TypeScript の既存の JSDoc 処理を追跡し、次に @yields {Thing} の例と比較してください。タグが意図した yield 型で受け入れられ、焦点を絞ったテストでカバーされれば完了です。