JSDoc @typedef property description lost

[mjbvz]

TypeScript Version: 3.8.0-dev.20191125

Search Terms:

• jsdoc
• typedef
• property

Repo
For the JS:

/** @typedef {Object.<string, any>} type
 * @property {string} prop1 - Missing Description 1
 * @property {string} prop2 - Missing Description 2
*/

/** @type {type} */
var a = {
    prop1: null,
    prop2: null
}

/** @type {type}
 * @class */
function b(){
    this.prop1 = null;
    this.prop2 = null;
}

var c = new b();

Type c.prop1 to view prop1 suggestion

Expected behavior:
Description from the typedef is shown: Missing Description 1

Actual behavior:
No description (but the property does have the correct type)

[edaanen]

Is there any news on this issue!? I have the same problem with the TS definition files of my libraries.
This works:
type Test
{
/** my prop description */
myProp: boolean;
}

but this doesn't work (and this is how all libraries are documented following JSDOC documentation):

    /**
     * @typedef {Object} borderPadding
     * @property width - <p>Total padding and border width.</p>
     * @property height - <p>Total padding and border height.</p>
     * @property borderTop - <p>The width of the top border.</p>
     * @property borderRight - <p>The width of the right border.</p>
     * @property borderBottom - <p>The width of the bottom border.</p>
     * @property borderLeft - <p>The width of the left border.</p>
     * @property paddingTop - <p>The width of the top padding.</p>
     * @property paddingRight - <p>The width of the right padding.</p>
     * @property paddingBottom - <p>The width of the bottom padding.</p>
     * @property paddingLeft - <p>The width of the left padding.</p>
     */
    type borderPadding = {
        width: number;
        height: number;
        borderTop: number;
        borderRight: number;
        borderBottom: number;
        borderLeft: number;
        paddingTop: number;
        paddingRight: number;
        paddingBottom: number;
        paddingLeft: number;
    };

[FireController1847]

I'd also be curious to know if there's any updates on this issue a year later.

[conlanpatrek]

As a workaround, I've noticed that I can document my descriptions on the following line and they will not be lost.

e.g.

    /**
     * @typedef {object}  Vector2
     * @property {number} x
     * My description for the x property
     * @property {number} y
     * My description for the y property
     */

It's not the JSDoc documented way to do this, but it seems to get intellisense to behave.