Merge pull request #21 from blutorange/update-typedoc-0.27

Switch from CommonJS to ESM, required for support for TypeDoc 0.27.x

package.json

@@ -1,6 +1,7 @@
 {
     "name": "typedoc-plugin-merge-modules",
     "version": "6.0.3",
+    "type": "module",
     "description": "Plugin for TypeDoc that merges the content of modules.",
     "author": {
         "name": "Krisztián Balla",
@@ -22,11 +23,11 @@
         "eslint-plugin-unicorn": "54.0.0",
         "prettier": "3.3.3",
         "rimraf": "6.0.1",
-        "typedoc": "0.26.7",
+        "typedoc": "0.27.0",
         "typescript": "5.5.4"
     },
     "peerDependencies": {
-        "typedoc": "0.26.x"
+        "typedoc": "0.26.x || 0.27.x"
     },
     "repository": {
         "type": "git",

src/index.ts

@@ -1,6 +1,6 @@
-import { Application } from "typedoc";
-import { Plugin } from "./plugin";
-import { PluginConfig } from "./plugin_options";
+import type { Application } from "typedoc";
+import { Plugin } from "./plugin.js";
+import type { PluginConfig } from "./plugin_options.js";
 
 /**
  * Type that can be intersected with TypeDoc's config type to have static type checking for the plugin's configuration.

src/merger/module_bundle.ts

@@ -1,10 +1,10 @@
-import { Comment, DeclarationReflection, DocumentReflection, ProjectReflection, ReflectionKind } from "typedoc";
+import { Comment, DeclarationReflection, DocumentReflection, type ProjectReflection, ReflectionKind } from "typedoc";
 import {
     getNameFromDescriptionTag,
     moveDeclarationReflectionToTarget,
     moveDocumentReflectionToTarget,
     removeTagFromCommentsOf,
-} from "../utils";
+} from "../utils.js";
 
 /**
  * Name of the comment tag that can be used to mark a module as the target module within the bundle.

src/merger/module_category_merger.ts

@@ -1,5 +1,5 @@
-import { DeclarationReflection } from "typedoc";
-import { ModuleMerger } from "./module_merger";
+import type { DeclarationReflection } from "typedoc";
+import { ModuleMerger } from "./module_merger.js";
 
 /**
  * Merger that merges the content of modules based on their JSDoc module annotation and category.

src/merger/module_merger.ts

@@ -1,7 +1,7 @@
-import { Plugin } from "src/plugin";
-import { DeclarationReflection, ProjectReflection } from "typedoc";
-import { getModulesFrom } from "../utils";
-import { ModuleBundle } from "./module_bundle";
+import type { Plugin } from "src/plugin.js";
+import type { DeclarationReflection, ProjectReflection } from "typedoc";
+import { getModulesFrom } from "../utils.js";
+import { ModuleBundle } from "./module_bundle.js";
 
 /**
  * Merger that merges the content of modules based on their JSDoc module annotation.

src/merger/project_merger.ts

@@ -1,7 +1,7 @@
-import { ProjectReflection } from "typedoc";
-import { Plugin } from "../plugin";
-import { getModulesFrom } from "../utils";
-import { ModuleBundle } from "./module_bundle";
+import type { ProjectReflection } from "typedoc";
+import type { Plugin } from "../plugin.js";
+import { getModulesFrom } from "../utils.js";
+import { ModuleBundle } from "./module_bundle.js";
 
 /**
  * Merger that moves the content of all modules into the project root.

src/plugin.ts

@@ -1,17 +1,17 @@
 import {
     Application,
-    Context,
+    type Context,
     Converter,
-    DeclarationReflection,
+    type DeclarationReflection,
     EntryPointStrategy,
-    ProjectReflection,
+    type ProjectReflection,
     ReflectionKind,
 } from "typedoc";
-import { ModuleCategoryMerger } from "./merger/module_category_merger";
-import { ModuleMerger } from "./merger/module_merger";
-import { ProjectMerger } from "./merger/project_merger";
-import { PluginOptions } from "./plugin_options";
-import { tryGetOriginalReflectionName } from "./utils";
+import { ModuleCategoryMerger } from "./merger/module_category_merger.js";
+import { ModuleMerger } from "./merger/module_merger.js";
+import { ProjectMerger } from "./merger/project_merger.js";
+import { PluginOptions } from "./plugin_options.js";
+import { tryGetOriginalReflectionName } from "./utils.js";
 
 /**
  * The "Merge Modules" plugin.

src/plugin_options.ts

@@ -1,4 +1,4 @@
-import { Application, ParameterType } from "typedoc";
+import { type Application, ParameterType } from "typedoc";
 
 /** Type for the plugin's mode. */
 type Mode = "project" | "module" | "module-category" | "off";

src/utils.ts

@@ -1,12 +1,12 @@
 import {
-    CommentTag,
-    Context,
+    type CommentTag,
+    type Context,
     DeclarationReflection,
-    DocumentReflection,
-    ProjectReflection,
+    type DocumentReflection,
+    type ProjectReflection,
     ReflectionKind,
 } from "typedoc";
-import * as ts from "typescript";
+import type * as ts from "typescript";
 
 /**
  * Type extending the TypeScript Declaration interface with a possible identifier object as a name.

test/cypress.config.js

@@ -1,11 +1,12 @@
-// eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/unbound-method
-const { defineConfig } = require("cypress");
+import { defineConfig } from "cypress";
 
-module.exports = defineConfig({
+const config = defineConfig({
     e2e: {
         specPattern: "**/*.cy.ts",
         supportFile: false,
         video: false,
         screenshotOnRunFailure: false,
     },
 });
+
+export default config;

test/merge-module-category/test.cy.ts

@@ -46,7 +46,7 @@ describe("modules/merged-1.html", () => {
     });
 
     it("contains a sub link to the class C", () => {
-        cy.get("nav").find("a[href='../classes/merged-1.C.html']");
+        cy.get("nav").find("a[href='../classes/merged.C.html']");
     });
 });
 
@@ -56,6 +56,6 @@ describe("modules/merged-2.html", () => {
     });
 
     it("contains a sub link to the class D", () => {
-        cy.get("nav").find("a[href='../classes/merged-2.D.html']");
+        cy.get("nav").find("a[href='../classes/merged.D.html']");
     });
 });

test/merge-module-monorepo/test.cy.ts

@@ -43,29 +43,29 @@ describe("modules/Project_2.merged.html", () => {
     });
 
     it("contains index links to the classes A, B and C", () => {
-        cy.get(".col-content .tsd-index-list").find("a[href='../classes/Project_2.merged.A.html']");
-        cy.get(".col-content .tsd-index-list").find("a[href='../classes/Project_2.merged.B.html']");
-        cy.get(".col-content .tsd-index-list").find("a[href='../classes/Project_2.merged.C.html']");
+        cy.get(".col-content .tsd-member-summaries").find("a[href='../classes/Project_2.merged.A.html']");
+        cy.get(".col-content .tsd-member-summaries").find("a[href='../classes/Project_2.merged.B.html']");
+        cy.get(".col-content .tsd-member-summaries").find("a[href='../classes/Project_2.merged.C.html']");
     });
 
     it("contains the category Alpha and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(2)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(2)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Alpha");
+        cy.get(sectionSelector + " h2").should("have.text", " Alpha");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of A.");
     });
 
     it("contains the category Beta and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(3)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(3)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Beta");
+        cy.get(sectionSelector + " h2").should("have.text", " Beta");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of B.");
     });
 
     it("contains the category Gamma and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(1)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(1)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Gamma");
+        cy.get(sectionSelector + " h2").should("have.text", " Gamma");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of C.");
     });
 });

test/merge-module/test.cy.ts

@@ -32,9 +32,9 @@ describe("modules/notMerged.html", () => {
     });
 
     it("contains the category Gamma and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(1)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(1)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Gamma");
+        cy.get(sectionSelector + " h2").should("have.text", " Gamma");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of C.");
     });
 });
@@ -50,16 +50,16 @@ describe("modules/merged.html", () => {
     });
 
     it("contains the category Alpha and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(1)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(1)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Alpha");
+        cy.get(sectionSelector + " h2").should("have.text", " Alpha");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of A.");
     });
 
     it("contains the category Beta and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(2)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(2)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Beta");
+        cy.get(sectionSelector + " h2").should("have.text", " Beta");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of B.");
     });
 });

test/merge-project-monorepo/test.cy.ts

@@ -28,23 +28,23 @@ describe("modules.html", () => {
     });
 
     it("contains the category Alpha and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(1)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(1)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Alpha");
+        cy.get(sectionSelector + " h2").should("have.text", " Alpha");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of A.");
     });
 
     it("contains the category Beta and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(2)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(2)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Beta");
+        cy.get(sectionSelector + " h2").should("have.text", " Beta");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of B.");
     });
 
     it("contains the category Gamma and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(3)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(3)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Gamma");
+        cy.get(sectionSelector + " h2").should("have.text", " Gamma");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of C.");
     });
 });

test/merge-project/test.cy.ts

@@ -27,23 +27,23 @@ describe("modules.html", () => {
     });
 
     it("contains the category Alpha and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(1)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(1)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Alpha");
+        cy.get(sectionSelector + " h2").should("have.text", " Alpha");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of A.");
     });
 
     it("contains the category Beta and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(2)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(2)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Beta");
+        cy.get(sectionSelector + " h2").should("have.text", " Beta");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of B.");
     });
 
     it("contains the category Gamma and its description", () => {
-        const sectionSelector = ".col-content .tsd-index-section:nth-of-type(3)";
+        const sectionSelector = ".col-content .tsd-panel-group:nth-of-type(3)";
 
-        cy.get(sectionSelector + " h3").should("have.text", "Gamma");
+        cy.get(sectionSelector + " h2").should("have.text", " Gamma");
         cy.get(sectionSelector + " p").should("have.text", "Category description from the file of C.");
     });
 });

test/prepare_test.js

@@ -1,29 +1,24 @@
-/* eslint-disable @typescript-eslint/no-var-requires */
-const fs = require("fs");
-const path = require("path");
+import fs from "node:fs/promises";
+import path from "node:path";
 
 console.log("=================================== SETTING UP THE TESTS ===========================================");
 
-if (!fs.existsSync(path.join("..", "dist"))) {
+if (
+    !(await fs
+        .access(path.join("..", "dist"))
+        .then(() => true)
+        .catch(() => false))
+) {
     console.error("ERROR: Cannot find 'dist' folder. Did you forget to build the plugin with 'npm run build'?");
     process.exit(1);
 }
 
 console.log("Copying current build of plugin to node_modules for testing...");
 const nodeModulesSubDir = path.join("..", "node_modules", "typedoc-plugin-merge-modules");
 
-fs.rm(nodeModulesSubDir, { recursive: true, force: true }, (rmErr) => {
-    if (rmErr) {
-        throw rmErr;
-    }
-    fs.mkdir(path.join(nodeModulesSubDir, "dist"), { recursive: true }, (mkDirErr) => {
-        if (mkDirErr) {
-            throw mkDirErr;
-        } else {
-            fs.copyFileSync(path.join("..", "package.json"), path.join(nodeModulesSubDir, "package.json"));
-            fs.cpSync(path.join("..", "dist"), path.join(nodeModulesSubDir, "dist"), { recursive: true });
-        }
-    });
-});
+await fs.rm(nodeModulesSubDir, { recursive: true, force: true });
+await fs.mkdir(path.join(nodeModulesSubDir, "dist"), { recursive: true });
+await fs.copyFile(path.join("..", "package.json"), path.join(nodeModulesSubDir, "package.json"));
+await fs.cp(path.join("..", "dist"), path.join(nodeModulesSubDir, "dist"), { recursive: true });
 
 console.log("DONE\n");

test/test.js

@@ -1,5 +1,4 @@
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-const { execSync } = require("child_process");
+import { execSync } from "node:child_process";
 const execOptions = { stdio: "inherit" };
 
 console.log("===================================== TEST MERGE OFF ===============================================");

tsconfig.json

@@ -3,12 +3,14 @@
     "compilerOptions": {
         "outDir": "dist",
         "target": "es2015",
-        "module": "commonjs",
+        "module": "node16",
         "declaration": true,
         "baseUrl": "./",
         "strict": true,
         "noImplicitOverride": true,
         "exactOptionalPropertyTypes": true,
-        "esModuleInterop": true
+        "esModuleInterop": true,
+        "isolatedModules": true,
+        "verbatimModuleSyntax": true
     }
 }