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 がプライベートコンストラクターとそのドキュメントを保持し、報告されているコンストラクターのアクセス動作を変更しなければ完了です。