René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"JsDoc is missing/duplicated in declarations for overloads declared in classes declared in functions","articleBody":"### 🔎 Search Terms\n\njsdoc overloads compiler declaration class function\n\n### 🕗 Version \u0026 Regression Information\n\n- This is the behavior in every version I tried, and I reviewed the FAQ for entries about  overloads, classes, et al.\r\n\n\n### ⏯ Playground Link\n\nhttps://www.typescriptlang.org/play/?ts=5.5.3#code/PQKhCgAIUgVALAlgZ0gEwPYGMCuBbAUwDsAXAQxMQyMhUgAcAnDegxgGwE9aaT4DIAOjSCSyKCGDgs7MslQAxDBkgBvKJE2gIm3TAQCA5srSRkiQ0Qo5GBDXqm7IAM2UAKAEZlGALjMlGRCJDAEo-ADcMRDQAbntIbXjoSAABNAImAjIsEgJTBDpzS2tbWlR0zOzctCTJeNcMNzD-QOC4pwbPbwB+P2QAoNC+geDIAB9ISOi1JN1bEhsaAHIkJfbdAF9IcA3wcETkg3RsfGJySmoeIRExMsgvGugpZxwiHKoaAFkyAGsCACFvE0Zk55otIDI5KhAYwQU5dAd4Xo4PxIMYMKYilYFrZZg48S53F5fC1Bs0prECYikck0hlbFgKHkUYULNibAI6BUGUzHjTkgTDkhUFiSpzUHgUOZRs5mHhIHwBMJROJ+U8CZ1mv1WoZ1kjOsTeqTglqRoZxpMoqZ1Gq5gQcctVgTdk5dhsgA\n\n### 💻 Code\n\n```ts\r\n/**\r\n * This documentation is properly in the .d.ts\r\n */\r\nclass Foo {\r\n    /**\r\n     * The good signature\r\n     */\r\n    foo(bar: string): void;\r\n    /**\r\n     * @depreacted This signature is depreacted\r\n     */\r\n    foo(): string;\r\n    foo(bar?: string): string | void {\r\n        return 'hi';\r\n    } \r\n}\r\n\r\n/**\r\n * The documentation in .d.ts is bad\r\n */\r\nfunction MakeBar() {\r\n    return class Bar {\r\n        /**\r\n         * The good signature\r\n         */\r\n        foo(bar: string): void;\r\n        /**\r\n         * @deprecated This signature is deprecated\r\n         * \r\n         * This signature is missing from the .d.ts\r\n         */\r\n        foo(): string;\r\n        foo(bar?: string): string | void {\r\n            return 'hi'\r\n        }\r\n    }\r\n}\r\n```\r\n\n\n### 🙁 Actual behavior\n\nThe jsdoc in the `d.t.s` file duplicates the jsdoc for the first signature found on all other overloaded signatures when a function returns a constructor.  This behavior does not appear in normal class definitions.\n\n### 🙂 Expected behavior\n\nThe JSDoc on each signature should match what's written for that signature in the `.ts` file.\n\n### Additional information about the issue\n\nIntellisense that's picked up directly from the `.ts` file works fine - it understands the difference between the signatures, it's only the declaration file that's broken.","author":{"url":"https://github.com/amerrit2","@type":"Person","name":"amerrit2"},"datePublished":"2024-07-23T17:50:17.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/59397/TypeScript/issues/59397"}