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

Comece pela reprodução vinculada no TypeScript Playground usando foo.js e compare o arquivo de declaração emitido com a saída esperada. Rastreie como o JSDoc @private do construtor sem parâmetros é representado durante a geração de declarações. A tarefa estará concluída quando o .d.ts emitido preservar o construtor privado e sua documentação sem alterar o comportamento de acesso do construtor relatado.