3.6.0 breaks interface exports

[buu700]

3.6.0 seems to have regressed in handling @interface and/or @export.

Using protobufjs with jsdoc@3.5.5 works as expected. After updating to 3.6.0, the pbts command that takes a generated JS file as input and outputs a TypeScript type definition file fails to export required interfaces.

I don't know exactly what protobufjs is doing under-the-hood, but it looks like this is the relevant function that uses jsdoc.

Input code

Protobuf code like this:

/** A class. */
message Balls {
	/** A string. */
	required string test = 1;
}

Would output code that includes this:

/**
 * Properties of a Balls.
 * @exports IBalls
 * @interface IBalls
 * @property {string} test A string.
 */

Expected behavior

The final output should include an interface IBalls (and a class Balls that implements IBalls).

Current behavior

No IBalls.

Your environment

Software	Version
JSDoc	3.6.0
Node.js	10.15.3
npm	6.4.1
Operating system	Debian 9.9

[hegemonic]

When I save your sample output as a JS file and run JSDoc 3.6.1 on that file, it generates the appropriate docs:

I'm guessing that your real input file is more complicated. Can you point me to the repo that contains the full input file, or share it with me in a gist (privately if necessary)?

[bcoe]

We are bumping into similar issues in the library:

https://github.com/googleapis/nodejs-resource

When generating jsdoc with 3.5.5, a page is generated correctly for the:

export {Project};

and

export {Resource};

On 3.6.x no Resource.html or Project.html is generated.

[hegemonic]

Thanks for the pointer, @bcoe. I can reproduce the issue with that repo, and this is definitely a bug in JSDoc 3.6.x. I'm continuing to investigate.

The temporary solution is to pin to JSDoc 3.5.5.

[hegemonic]

Looks like the culprit is cc66657. I'll have to think about how to fix this regression without regressing #1129 as well.

Fix coming soon, but "soon" might mean "a few days from now."

[bcoe]

@hegemonic thank you for digging into this 👍

[hegemonic]

Fixed on master and JSDoc 3.6.2, which I just released. Thanks for your patience!

[bcoe]

@hegemonic thank you 👍, I will start testing it out on some repos tomorrow.

[buu700]

Hey @hegemonic, I just tested this with both 3.6.2 and 3.6.3 on Node versions 10.17.0 and 12.13.1, and I'm still running into the original issue.

3.5.5 continues to work as expected, aside from #1643 (which I have a temporary workaround for, so not a blocker atm).

[brettz9]

Could this be reopened?

[SharpDevSa]

pbts with JSDoc 3.6.3 does not output the correct result for Enums as well.
Enum is missing.
Node version: 12.16.0
protobufjs: 6.8.8
JSDoc was directly updated in protobufjs package,

[buu700]

I can confirm that this is still an issue with jsdoc 3.6.6, protobufjs 6.11.2, and Node 14.17.0. Please reopen, @hegemonic.