Fix missing comments on type-only classes/functions

Resolves #2970

Author: Gerrit0

CHANGELOG.md

@@ -4,6 +4,10 @@ title: Changelog
 
 ## Unreleased
 
+### Bug Fixes
+
+- Classes and functions exported with `export { type X }` are no longer missing comments, #2970.
+
 ## v0.28.6 (2025-06-27)
 
 ### Features

src/lib/converter/comments/discovery.ts

@@ -80,6 +80,7 @@ const wantedKinds: Record<ReflectionKind, ts.SyntaxKind[]> = {
     [ReflectionKind.Interface]: [
         ts.SyntaxKind.InterfaceDeclaration,
         ts.SyntaxKind.TypeAliasDeclaration,
+        ts.SyntaxKind.ClassDeclaration, // type only exports
     ],
     [ReflectionKind.Constructor]: [ts.SyntaxKind.Constructor],
     [ReflectionKind.Property]: variablePropertyKinds,
@@ -104,7 +105,12 @@ const wantedKinds: Record<ReflectionKind, ts.SyntaxKind[]> = {
     [ReflectionKind.Accessor]: [ts.SyntaxKind.PropertyDeclaration],
     [ReflectionKind.GetSignature]: [ts.SyntaxKind.GetAccessor],
     [ReflectionKind.SetSignature]: [ts.SyntaxKind.SetAccessor],
-    [ReflectionKind.TypeAlias]: [ts.SyntaxKind.TypeAliasDeclaration],
+    [ReflectionKind.TypeAlias]: [
+        ts.SyntaxKind.TypeAliasDeclaration,
+        ts.SyntaxKind.FunctionDeclaration, // type only exports
+        // Intentionally not included to avoid comments being copied for variable/alias combos
+        // ts.SyntaxKind.VariableDeclaration,
+    ],
     [ReflectionKind.Reference]: [
         ts.SyntaxKind.NamespaceExport,
         ts.SyntaxKind.ExportSpecifier,

src/test/converter2/issues/gh2970.ts

@@ -0,0 +1,10 @@
+/** Comment */
+class Class {}
+
+/** Comment */
+const Var = 123;
+
+/** Comment */
+function Func() {}
+
+export type { Class, Func, Var };

src/test/issues.c2.test.ts

@@ -2126,4 +2126,13 @@ describe("Issue Tests", () => {
         const project = convert();
         equal(project.children?.map(c => c.name), ["third"]);
     });
+
+    it("#2970 includes comments on type only exports", () => {
+        const project = convert();
+        equal(project.children?.map(c => [c.name, Comment.combineDisplayParts(c.comment?.summary)]), [
+            ["Class", "Comment"],
+            ["Func", "Comment"],
+            ["Var", "Comment"],
+        ]);
+    });
 });