arrow function jsdoc missing in IDE

[dckc]

Describe the bug

compare jsdoc in the code:

endo/packages/pass-style/src/make-far.js

Lines 166 to 178 in 39b8599

	/**
	* A concise convenience for the most common `Remotable` use.
	*
	* For far objects (as opposed to far functions), also adds a miranda
	* `GET_METHOD_NAMES` method that returns an array of all the method names,
	* if there is not yet any method named `GET_METHOD_NAMES`. (Hence "miranda")
	*
	* @template {{}} T
	* @param {string} farName This name will be prepended with `Alleged: `
	* for now to form the `Remotable` `iface` argument.
	* @param {T} [remotable] The object used as the remotable
	*/
	export const Far = (farName, remotable = undefined) => {

with IDE experience:

The latter is missing the prose from the former.

Steps to reproduce

We can also see that the prose is missing in
https://npmfs.com/package/@endo/pass-style/1.3.0/src/make-far.d.ts

Expected behavior

prose from JSDoc shows up on hover and in make-far.d.ts.

Platform environment

unremarkable, I'm pretty sure

Additional context

@turadg diagnosed the causes as being missing return type annotations lack of support for docstrings on arrow functions.

• JSDoc annotations missing for arrow function exports Agoric/agoric-sdk#9136

I'm working on reference documentation

• API Reference Docs - Docs Revamp Agoric/documentation#1031

[turadg]

With some additional debugging we found that problem issue is actually,

• Missing JSDoc description when using arrow functions in --allowJs + --declaration microsoft/TypeScript#34860