Support @include in readme file

Ref: #2814

Author: Gerrit0

CHANGELOG.md

@@ -4,6 +4,10 @@ title: Changelog
 
 ## Unreleased
 
+### Bug Fixes
+
+-   `@include` and `@includeCode` now work in the readme file, #2814.
+
 ## v0.27.5 (2024-12-14)
 
 ### Bug Fixes

src/lib/converter/converter.ts

@@ -248,6 +248,9 @@ export class Converter extends AbstractComponent<Application, ConverterEvents> {
      */
     static readonly EVENT_RESOLVE_END = ConverterEvents.RESOLVE_END;
 
+    /** @internal @hidden */
+    includePlugin: IncludePlugin;
+
     constructor(owner: Application) {
         super(owner);
 
@@ -304,7 +307,7 @@ export class Converter extends AbstractComponent<Application, ConverterEvents> {
         new PackagePlugin(this);
         new SourcePlugin(this);
         new TypePlugin(this);
-        new IncludePlugin(this);
+        this.includePlugin = new IncludePlugin(this);
         new MergeModuleWithPlugin(this);
     }
 

src/lib/converter/plugins/IncludePlugin.ts

@@ -46,7 +46,7 @@ export class IncludePlugin extends ConverterComponent {
         }
     }
 
-    private checkIncludeTagsParts(
+    checkIncludeTagsParts(
         refl: Reflection,
         relative: string,
         parts: CommentDisplayPart[],

src/lib/converter/plugins/PackagePlugin.ts

@@ -135,6 +135,14 @@ export class PackagePlugin extends ConverterComponent {
             );
 
             project.readme = content;
+
+            // This isn't ideal, but seems better than figuring out the readme
+            // path over in the include plugin...
+            this.owner.includePlugin.checkIncludeTagsParts(
+                project,
+                Path.dirname(this.readmeFile),
+                content,
+            );
         }
 
         if (this.packageJson) {