JSDoc `@private` on constructor without parameters is omitted in declaration files

🔎 Search Terms

jsdoc private constructor

🕗 Version & Regression Information

• This is the behavior in every version I tried back through TS 3.8 where JSDoc support was added, and I reviewed the FAQ for entries about JSDoc

⏯ Playground Link

https://www.typescriptlang.org/play/?target=99&module=1&ts=5.5.0-beta&ssl=8&ssc=10&pln=1&pc=1&filetype=js#code/MYGwhgzhAEBiD29oG8BQ0PQPQCofs2h2gAEAHAJwEsA3MAFwFMDMcsXph4A7CeigK7B68CgAoAlCgC+qWam6MA7nESSgA

💻 Code

// foo.js
class Foo {
    /**
     * @private
     */
    constructor() {}
}

new Foo()
// Constructor of class 'Foo' is private and only accessible within the class declaration.(2673)

🙁 Actual behavior

Emits the declaration file:

declare class Foo {
}

🙂 Expected behavior

Should emit the declaration file:

declare class Foo {
    /**
     * @private
     */
    private constructor();
}

Additional information about the issue

I ran into this as it was requested that TypeDoc add a new JSDoc tag to work around this issue. This seems wrong since the declaration file doesn't accurately describe the types within the file, but it's also very unfortunate that it results in the loss of any documentation added to the constructor.

https://github.com/TypeStrong/typedoc/issues/2577

从链接的 TypeScript Playground 复现开始，使用 foo.js，并将生成的声明文件与预期输出进行比较。跟踪无参数构造函数的 @private JSDoc 在声明生成期间是如何表示的。完成标准是生成的 .d.ts 保留私有构造函数及其文档，同时不改变报告的构造函数访问行为。