- Fix: project documents were removed when merging into a single project

- Adjust merge-project unit test accordingly

src/merger/project_merger.ts

@@ -52,9 +52,11 @@ export class ProjectMerger {
      */
     private clearProject(): void {
         this.project.children = [];
-        this.project.documents = [];
-        this.project.childrenIncludingDocuments = [];
         this.project.children.forEach((child) => this.project.removeReflection(child));
+
+        // keep project documents that are included with the TypeDoc config parameter "projectDocuments"
+        this.project.childrenIncludingDocuments =
+            this.project.childrenIncludingDocuments?.filter((item) => item instanceof DocumentReflection) ?? [];
     }
 
     /**

test/merge-project/input/project-documents/doc1.md

@@ -0,0 +1 @@
+# This is the project documentation file doc1.md

test/merge-project/test.cy.ts

@@ -15,4 +15,8 @@ describe("index.html", () => {
         cy.get("nav").find("a[href='./classes/B.html']");
         cy.get("nav").find("a[href='./classes/C.html']");
     });
+
+    it("contains a link to the project documentation", () => {
+        cy.get("nav").find("a[href='./documents/doc1.html']");
+    });
 });

test/merge-project/typedoc.json

@@ -0,0 +1,10 @@
+{
+    "$schema": "https://typedoc.org/schema.json",
+    "name": "Project Merge-Project",
+    "entryPoints": ["input/*.ts"],
+    "entryPointStrategy": "expand",
+    "projectDocuments": ["input/project-documents/*.md"],
+    "out": "output",
+    "plugin": ["typedoc-plugin-merge-modules"],
+    "mergeModulesMergeMode": "project"
+}

test/test.js

@@ -9,7 +9,7 @@ execSync("call npx cypress run --quiet --spec 'merge-off/test.cy.ts'", { stdio:
 
 console.log("=================================== TEST MERGE PROJECT =============================================");
 // prettier-ignore
-execSync("npx typedoc --tsconfig merge-project/tsconfig.json --plugin typedoc-plugin-merge-modules --mergeModulesMergeMode project --entryPointStrategy expand --out merge-project/output merge-project/input", { stdio: "inherit" });
+execSync("cd merge-project && npx typedoc", { stdio: "inherit" });
 execSync("npx cypress run --quiet --spec 'merge-project/test.cy.ts'", { stdio: "inherit" });
 
 console.log("==================================== TEST MERGE MODULE =============================================");