Fix discovery of module comments

Resolves #1963

CHANGELOG.md

@@ -3,6 +3,7 @@
 ### Bug Fixes
 
 -   Module comments will no longer be inappropriately attached to signatures, #1962.
+-   Projects with a single entry point will now parse `@module` comments in the entry point, #1963.
 -   Removed duplicate "in comment" warning when parsing comments, #1964.
 
 ## v0.23.1 (2022-06-26)

src/lib/converter/converter.ts

@@ -13,7 +13,7 @@ import { createMinimatch, matchesAny } from "../utils/paths";
 import type { IMinimatch } from "minimatch";
 import { hasAllFlags, hasAnyFlag } from "../utils/enum";
 import type { DocumentationEntryPoint } from "../utils/entry-point";
-import type { CommentParserConfig } from "./comments";
+import { CommentParserConfig, getComment } from "./comments";
 import type { CommentStyle } from "../utils/options/declaration";
 
 /**
@@ -238,6 +238,15 @@ export class Converter extends ChildableComponent<
             // Special case for when we're giving a single entry point, we don't need to
             // create modules for each entry. Register the project as this module.
             context.project.registerReflection(context.project, symbol);
+            context.project.comment =
+                symbol &&
+                getComment(
+                    symbol,
+                    context.project.kind,
+                    this.config,
+                    this.application.logger,
+                    this.commentStyle
+                );
             context.trigger(
                 Converter.EVENT_CREATE_DECLARATION,
                 context.project

src/test/converter2/issues/gh1963.ts

@@ -0,0 +1,9 @@
+/**
+ * Module comment
+ * @module
+ */
+
+/**
+ * Some code reproducing a bug.
+ */
+export const bug = 123;

src/test/issueTests.ts

@@ -529,11 +529,14 @@ export const issueTests: {
     gh1962(project) {
         const foo = query(project, "foo");
         ok(foo.signatures);
-        // #1963
-        // ok(project.hasComment(), "Missing module comment");
+        ok(project.hasComment(), "Missing module comment");
         ok(
             !foo.signatures[0].hasComment(),
             "Module comment attached to signature"
         );
     },
+
+    gh1963(project) {
+        ok(project.hasComment(), "Missing module comment");
+    },
 };