typedoc 0.26.11 → 0.27.0-beta.1

package/dist/lib/application.js

@@ -1,20 +1,3 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
 var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
     function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
     var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
@@ -49,73 +32,48 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
-    if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
-    return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Application = void 0;
-exports.createAppForTesting = createAppForTesting;
-const Path = __importStar(require("path"));
-const typescript_1 = __importDefault(require("typescript"));
-const index_1 = require("./converter/index");
-const renderer_1 = require("./output/renderer");
-const serialization_1 = require("./serialization");
-const index_2 = require("./utils/index");
-const component_1 = require("./utils/component");
-const utils_1 = require("./utils");
-const array_1 = require("./utils/array");
-const assert_1 = require("assert");
-const entry_point_1 = require("./utils/entry-point");
-const paths_1 = require("./utils/paths");
-const general_1 = require("./utils/general");
-const exports_1 = require("./validation/exports");
-const documentation_1 = require("./validation/documentation");
-const links_1 = require("./validation/links");
-const application_events_1 = require("./application-events");
-const tsconfig_1 = require("./utils/tsconfig");
-const fs_1 = require("./utils/fs");
-const ReflectionSymbolId_1 = require("./models/reflections/ReflectionSymbolId");
-const internationalization_1 = require("./internationalization/internationalization");
-const highlighter_1 = require("./utils/highlighter");
-const FileRegistry_1 = require("./models/FileRegistry");
-// eslint-disable-next-line @typescript-eslint/no-require-imports
-const packageInfo = require("../../package.json");
+import * as Path from "path";
+import ts from "typescript";
+import { Deserializer, Serializer, } from "./serialization/index.js";
+import { Converter } from "./converter/index.js";
+import { Renderer } from "./output/renderer.js";
+import { Logger, ConsoleLogger, loadPlugins, writeFile, TSConfigReader, TypeDocReader, PackageJsonReader, AbstractComponent, } from "./utils/index.js";
+import { Options, Option } from "./utils/index.js";
+import { unique } from "./utils/array.js";
+import { ok } from "assert";
+import { EntryPointStrategy, getEntryPoints, getPackageDirectories, getWatchEntryPoints, inferEntryPoints, } from "./utils/entry-point.js";
+import { nicePath } from "./utils/paths.js";
+import { getLoadedPaths, hasBeenLoadedMultipleTimes } from "./utils/general.js";
+import { validateExports } from "./validation/exports.js";
+import { validateDocumentation } from "./validation/documentation.js";
+import { validateLinks } from "./validation/links.js";
+import { ApplicationEvents } from "./application-events.js";
+import { findTsConfigFile } from "./utils/tsconfig.js";
+import { deriveRootDir, glob, readFile } from "./utils/fs.js";
+import { addInferredDeclarationMapPaths } from "./models/reflections/ReflectionSymbolId.js";
+import { Internationalization, } from "./internationalization/internationalization.js";
+import { loadShikiMetadata } from "./utils/highlighter.js";
+import { ValidatingFileRegistry, FileRegistry } from "./models/FileRegistry.js";
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { createRequire } from "module";
+import { Outputs } from "./output/output.js";
+import { validateMergeModuleWith } from "./validation/unusedMergeModuleWith.js";
+const packageInfo = JSON.parse(readFileSync(Path.join(fileURLToPath(import.meta.url), "../../../package.json"), "utf8"));
 const supportedVersionMajorMinor = packageInfo.peerDependencies.typescript
     .split("||")
     .map((version) => version.replace(/^\s*|\.x\s*$/g, ""));
 const DETECTOR = Symbol();
-function createAppForTesting() {
+export function createAppForTesting() {
     // @ts-expect-error private constructor
     const app = new Application(DETECTOR);
-    app.files = new FileRegistry_1.FileRegistry();
+    app.files = new FileRegistry();
     return app;
 }
 const DEFAULT_READERS = [
-    new index_2.TypeDocReader(),
-    new index_2.PackageJsonReader(),
-    new index_2.TSConfigReader(),
+    new TypeDocReader(),
+    new PackageJsonReader(),
+    new TSConfigReader(),
 ];
 /**
  * The default TypeDoc main application class.
@@ -134,14 +92,12 @@ const DEFAULT_READERS = [
  *
  * Access to an Application instance can be retrieved with {@link Application.bootstrap} or
  * {@link Application.bootstrapWithPlugins}. It can not be constructed manually.
+ *
+ * @group Common
+ * @summary Root level class which contains most useful behavior.
  */
 let Application = (() => {
-    var _Application_lang_accessor_storage, _Application_skipErrorChecking_accessor_storage, _Application_entryPointStrategy_accessor_storage, _Application_entryPoints_accessor_storage;
-    let _classDecorators = [(0, component_1.Component)({ name: "application", internal: true })];
-    let _classDescriptor;
-    let _classExtraInitializers = [];
-    let _classThis;
-    let _classSuper = component_1.ChildableComponent;
+    let _classSuper = AbstractComponent;
     let _lang_decorators;
     let _lang_initializers = [];
     let _lang_extraInitializers = [];
@@ -154,19 +110,86 @@ let Application = (() => {
     let _entryPoints_decorators;
     let _entryPoints_initializers = [];
     let _entryPoints_extraInitializers = [];
-    var Application = _classThis = class extends _classSuper {
+    return class Application extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _lang_decorators = [Option("lang")];
+            _skipErrorChecking_decorators = [Option("skipErrorChecking")];
+            _entryPointStrategy_decorators = [Option("entryPointStrategy")];
+            _entryPoints_decorators = [Option("entryPoints")];
+            __esDecorate(this, null, _lang_decorators, { kind: "accessor", name: "lang", static: false, private: false, access: { has: obj => "lang" in obj, get: obj => obj.lang, set: (obj, value) => { obj.lang = value; } }, metadata: _metadata }, _lang_initializers, _lang_extraInitializers);
+            __esDecorate(this, null, _skipErrorChecking_decorators, { kind: "accessor", name: "skipErrorChecking", static: false, private: false, access: { has: obj => "skipErrorChecking" in obj, get: obj => obj.skipErrorChecking, set: (obj, value) => { obj.skipErrorChecking = value; } }, metadata: _metadata }, _skipErrorChecking_initializers, _skipErrorChecking_extraInitializers);
+            __esDecorate(this, null, _entryPointStrategy_decorators, { kind: "accessor", name: "entryPointStrategy", static: false, private: false, access: { has: obj => "entryPointStrategy" in obj, get: obj => obj.entryPointStrategy, set: (obj, value) => { obj.entryPointStrategy = value; } }, metadata: _metadata }, _entryPointStrategy_initializers, _entryPointStrategy_extraInitializers);
+            __esDecorate(this, null, _entryPoints_decorators, { kind: "accessor", name: "entryPoints", static: false, private: false, access: { has: obj => "entryPoints" in obj, get: obj => obj.entryPoints, set: (obj, value) => { obj.entryPoints = value; } }, metadata: _metadata }, _entryPoints_initializers, _entryPoints_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        /**
+         * The converter used to create the declaration reflections.
+         */
+        converter;
+        outputs = new Outputs(this);
+        /**
+         * The renderer used to generate the HTML documentation output.
+         */
+        renderer;
+        /**
+         * The serializer used to generate JSON output.
+         */
+        serializer = new Serializer();
+        /**
+         * The deserializer used to restore previously serialized JSON output.
+         */
+        deserializer = new Deserializer(this);
+        /**
+         * The logger that should be used to output messages.
+         */
+        logger = new ConsoleLogger();
+        /**
+         * Internationalization module which supports translating according to
+         * the `lang` option.
+         */
+        internationalization = new Internationalization(this);
+        /**
+         * Proxy based shortcuts for internationalization keys.
+         */
+        i18n = this.internationalization.proxy;
+        options = new Options(this.i18n);
+        files = new ValidatingFileRegistry();
+        #lang_accessor_storage = __runInitializers(this, _lang_initializers, void 0);
         /** @internal */
-        get lang() { return __classPrivateFieldGet(this, _Application_lang_accessor_storage, "f"); }
-        set lang(value) { __classPrivateFieldSet(this, _Application_lang_accessor_storage, value, "f"); }
+        get lang() { return this.#lang_accessor_storage; }
+        set lang(value) { this.#lang_accessor_storage = value; }
+        #skipErrorChecking_accessor_storage = (__runInitializers(this, _lang_extraInitializers), __runInitializers(this, _skipErrorChecking_initializers, void 0));
         /** @internal */
-        get skipErrorChecking() { return __classPrivateFieldGet(this, _Application_skipErrorChecking_accessor_storage, "f"); }
-        set skipErrorChecking(value) { __classPrivateFieldSet(this, _Application_skipErrorChecking_accessor_storage, value, "f"); }
+        get skipErrorChecking() { return this.#skipErrorChecking_accessor_storage; }
+        set skipErrorChecking(value) { this.#skipErrorChecking_accessor_storage = value; }
+        #entryPointStrategy_accessor_storage = (__runInitializers(this, _skipErrorChecking_extraInitializers), __runInitializers(this, _entryPointStrategy_initializers, void 0));
         /** @internal */
-        get entryPointStrategy() { return __classPrivateFieldGet(this, _Application_entryPointStrategy_accessor_storage, "f"); }
-        set entryPointStrategy(value) { __classPrivateFieldSet(this, _Application_entryPointStrategy_accessor_storage, value, "f"); }
+        get entryPointStrategy() { return this.#entryPointStrategy_accessor_storage; }
+        set entryPointStrategy(value) { this.#entryPointStrategy_accessor_storage = value; }
+        #entryPoints_accessor_storage = (__runInitializers(this, _entryPointStrategy_extraInitializers), __runInitializers(this, _entryPoints_initializers, void 0));
         /** @internal */
-        get entryPoints() { return __classPrivateFieldGet(this, _Application_entryPoints_accessor_storage, "f"); }
-        set entryPoints(value) { __classPrivateFieldSet(this, _Application_entryPoints_accessor_storage, value, "f"); }
+        get entryPoints() { return this.#entryPoints_accessor_storage; }
+        set entryPoints(value) { this.#entryPoints_accessor_storage = value; }
+        /**
+         * The version number of TypeDoc.
+         */
+        static VERSION = packageInfo.version;
+        /**
+         * Emitted after plugins have been loaded and options have been read, but before they have been frozen.
+         * The listener will be given an instance of {@link Application}.
+         */
+        static EVENT_BOOTSTRAP_END = ApplicationEvents.BOOTSTRAP_END;
+        /**
+         * Emitted after a project has been deserialized from JSON.
+         * The listener will be given an instance of {@link ProjectReflection}.
+         */
+        static EVENT_PROJECT_REVIVE = ApplicationEvents.REVIVE;
+        /**
+         * Emitted when validation is being run.
+         * The listener will be given an instance of {@link ProjectReflection}.
+         */
+        static EVENT_VALIDATE_PROJECT = ApplicationEvents.VALIDATE_PROJECT;
         /**
          * Create a new TypeDoc application instance.
          */
@@ -175,50 +198,31 @@ let Application = (() => {
                 throw new Error("An application handle must be retrieved with Application.bootstrap or Application.bootstrapWithPlugins");
             }
             super(null); // We own ourselves
-            /**
-             * The serializer used to generate JSON output.
-             */
-            this.serializer = new serialization_1.Serializer();
-            /**
-             * The deserializer used to restore previously serialized JSON output.
-             */
-            this.deserializer = new serialization_1.Deserializer(this);
-            /**
-             * The logger that should be used to output messages.
-             */
-            this.logger = new index_2.ConsoleLogger();
-            /**
-             * Internationalization module which supports translating according to
-             * the `lang` option.
-             */
-            this.internationalization = new internationalization_1.Internationalization(this);
-            /**
-             * Proxy based shortcuts for internationalization keys.
-             */
-            this.i18n = this.internationalization.proxy;
-            this.options = new utils_1.Options(this.i18n);
-            this.files = new FileRegistry_1.ValidatingFileRegistry();
-            _Application_lang_accessor_storage.set(this, __runInitializers(this, _lang_initializers, void 0));
-            _Application_skipErrorChecking_accessor_storage.set(this, (__runInitializers(this, _lang_extraInitializers), __runInitializers(this, _skipErrorChecking_initializers, void 0)));
-            _Application_entryPointStrategy_accessor_storage.set(this, (__runInitializers(this, _skipErrorChecking_extraInitializers), __runInitializers(this, _entryPointStrategy_initializers, void 0)));
-            _Application_entryPoints_accessor_storage.set(this, (__runInitializers(this, _entryPointStrategy_extraInitializers), __runInitializers(this, _entryPoints_initializers, void 0)));
             __runInitializers(this, _entryPoints_extraInitializers);
-            this.converter = new index_1.Converter(this);
-            this.renderer = new renderer_1.Renderer(this);
+            this.converter = new Converter(this);
+            this.renderer = new Renderer(this);
             this.logger.i18n = this.i18n;
+            this.outputs.addOutput("json", async (out, project) => {
+                const ser = this.serializer.projectToObject(project, process.cwd());
+                const space = this.options.getValue("pretty") ? "\t" : "";
+                await writeFile(out, JSON.stringify(ser, null, space) + "\n");
+            });
+            this.outputs.addOutput("html", async (out, project) => {
+                await this.renderer.render(project, out);
+            });
         }
         /**
          * Initialize TypeDoc, loading plugins if applicable.
          */
         static async bootstrapWithPlugins(options = {}, readers = DEFAULT_READERS) {
-            await (0, highlighter_1.loadShikiMetadata)();
+            await loadShikiMetadata();
             const app = new Application(DETECTOR);
             readers.forEach((r) => app.options.addReader(r));
             app.options.reset();
             app.setOptions(options, /* reportErrors */ false);
-            await app.options.read(new index_2.Logger());
+            await app.options.read(new Logger());
             app.logger.level = app.options.getValue("logLevel");
-            await (0, index_2.loadPlugins)(app, app.options.getValue("plugin"));
+            await loadPlugins(app, app.options.getValue("plugin"));
             await app._bootstrap(options);
             return app;
         }
@@ -235,7 +239,7 @@ let Application = (() => {
          * @param readers Option readers to use to discover options from config files.
          */
         static async bootstrap(options = {}, readers = DEFAULT_READERS) {
-            await (0, highlighter_1.loadShikiMetadata)();
+            await loadShikiMetadata();
             const app = new Application(DETECTOR);
             readers.forEach((r) => app.options.addReader(r));
             await app._bootstrap(options);
@@ -250,10 +254,10 @@ let Application = (() => {
             for (const [lang, locales] of Object.entries(this.options.getValue("locales"))) {
                 this.internationalization.addTranslations(lang, locales);
             }
-            if ((0, general_1.hasBeenLoadedMultipleTimes)()) {
-                this.logger.warn(this.i18n.loaded_multiple_times_0((0, general_1.getLoadedPaths)().join("\n\t")));
+            if (hasBeenLoadedMultipleTimes()) {
+                this.logger.warn(this.i18n.loaded_multiple_times_0(getLoadedPaths().join("\n\t")));
             }
-            this.trigger(application_events_1.ApplicationEvents.BOOTSTRAP_END, this);
+            this.trigger(ApplicationEvents.BOOTSTRAP_END, this);
             if (!this.internationalization.hasTranslations(this.lang)) {
                 // Not internationalized as by definition we don't know what to include here.
                 this.logger.warn(`Options specified "${this.lang}" as the language to use, but TypeDoc does not support it.`);
@@ -269,34 +273,45 @@ let Application = (() => {
                 this.options.setValue("useHostedBaseUrlForAbsoluteLinks", false);
             }
         }
+        /** @internal */
         setOptions(options, reportErrors = true) {
+            let success = true;
             for (const [key, val] of Object.entries(options)) {
                 try {
                     this.options.setValue(key, val);
                 }
                 catch (error) {
-                    (0, assert_1.ok)(error instanceof Error);
+                    success = false;
+                    ok(error instanceof Error);
                     if (reportErrors) {
                         this.logger.error(error.message);
                     }
                 }
             }
+            return success;
         }
         /**
          * Return the path to the TypeScript compiler.
          */
         getTypeScriptPath() {
-            return (0, paths_1.nicePath)(Path.dirname(require.resolve("typescript")));
+            const req = createRequire(import.meta.url);
+            return nicePath(Path.dirname(req.resolve("typescript")));
         }
         getTypeScriptVersion() {
-            return typescript_1.default.version;
+            return ts.version;
+        }
+        async getEntryPoints() {
+            if (this.options.isSet("entryPoints")) {
+                return this.getDefinedEntryPoints();
+            }
+            return inferEntryPoints(this.logger, this.options);
         }
         /**
          * Gets the entry points to be documented according to the current `entryPoints` and `entryPointStrategy` options.
          * May return undefined if entry points fail to be expanded.
          */
-        getEntryPoints() {
-            return (0, entry_point_1.getEntryPoints)(this.logger, this.options);
+        getDefinedEntryPoints() {
+            return getEntryPoints(this.logger, this.options);
         }
         /**
          * Run the converter for the given set of files and return the generated reflections.
@@ -309,24 +324,24 @@ let Application = (() => {
             // with a few different settings.
             this.options.freeze();
             this.logger.verbose(`Using TypeScript ${this.getTypeScriptVersion()} from ${this.getTypeScriptPath()}`);
-            if (this.entryPointStrategy === entry_point_1.EntryPointStrategy.Merge) {
+            if (this.entryPointStrategy === EntryPointStrategy.Merge) {
                 return this._merge();
             }
-            if (this.entryPointStrategy === entry_point_1.EntryPointStrategy.Packages) {
+            if (this.entryPointStrategy === EntryPointStrategy.Packages) {
                 return this._convertPackages();
             }
-            if (!supportedVersionMajorMinor.some((version) => version == typescript_1.default.versionMajorMinor)) {
+            if (!supportedVersionMajorMinor.some((version) => version == ts.versionMajorMinor)) {
                 this.logger.warn(this.i18n.unsupported_ts_version_0(supportedVersionMajorMinor.join(", ")));
             }
-            const entryPoints = this.getEntryPoints();
+            const entryPoints = await this.getEntryPoints();
             if (!entryPoints) {
                 // Fatal error already reported.
                 return;
             }
-            const programs = (0, array_1.unique)(entryPoints.map((e) => e.program));
+            const programs = unique(entryPoints.map((e) => e.program));
             this.logger.verbose(`Converting with ${programs.length} programs ${entryPoints.length} entry points`);
             if (this.skipErrorChecking === false) {
-                const errors = programs.flatMap((program) => typescript_1.default.getPreEmitDiagnostics(program));
+                const errors = programs.flatMap((program) => ts.getPreEmitDiagnostics(program));
                 if (errors.length) {
                     this.logger.diagnostics(errors);
                     return;
@@ -346,11 +361,11 @@ let Application = (() => {
         convertAndWatch(success) {
             this.options.freeze();
             if (!this.options.getValue("preserveWatchOutput") &&
-                this.logger instanceof index_2.ConsoleLogger) {
-                typescript_1.default.sys.clearScreen?.();
+                this.logger instanceof ConsoleLogger) {
+                ts.sys.clearScreen?.();
             }
             this.logger.verbose(`Using TypeScript ${this.getTypeScriptVersion()} from ${this.getTypeScriptPath()}`);
-            if (!supportedVersionMajorMinor.some((version) => version == typescript_1.default.versionMajorMinor)) {
+            if (!supportedVersionMajorMinor.some((version) => version == ts.versionMajorMinor)) {
                 this.logger.warn(this.i18n.unsupported_ts_version_0(supportedVersionMajorMinor.join(", ")));
             }
             if (Object.keys(this.options.getCompilerOptions()).length === 0) {
@@ -363,25 +378,25 @@ let Application = (() => {
                 return;
             }
             // Support for packages mode is currently unimplemented
-            if (this.entryPointStrategy !== entry_point_1.EntryPointStrategy.Resolve &&
-                this.entryPointStrategy !== entry_point_1.EntryPointStrategy.Expand) {
+            if (this.entryPointStrategy !== EntryPointStrategy.Resolve &&
+                this.entryPointStrategy !== EntryPointStrategy.Expand) {
                 this.logger.error(this.i18n.strategy_not_supported_in_watch_mode());
                 return;
             }
-            const tsconfigFile = (0, tsconfig_1.findTsConfigFile)(this.options.getValue("tsconfig")) ??
+            const tsconfigFile = findTsConfigFile(this.options.getValue("tsconfig")) ??
                 "tsconfig.json";
             // We don't want to do it the first time to preserve initial debug status messages. They'll be lost
             // after the user saves a file, but better than nothing...
             let firstStatusReport = true;
-            const host = typescript_1.default.createWatchCompilerHost(tsconfigFile, {}, typescript_1.default.sys, typescript_1.default.createEmitAndSemanticDiagnosticsBuilderProgram, (diagnostic) => this.logger.diagnostic(diagnostic), (status, newLine, _options, errorCount) => {
+            const host = ts.createWatchCompilerHost(tsconfigFile, {}, ts.sys, ts.createEmitAndSemanticDiagnosticsBuilderProgram, (diagnostic) => this.logger.diagnostic(diagnostic), (status, newLine, _options, errorCount) => {
                 if (!firstStatusReport &&
                     errorCount === void 0 &&
                     !this.options.getValue("preserveWatchOutput") &&
-                    this.logger instanceof index_2.ConsoleLogger) {
-                    typescript_1.default.sys.clearScreen?.();
+                    this.logger instanceof ConsoleLogger) {
+                    ts.sys.clearScreen?.();
                 }
                 firstStatusReport = false;
-                this.logger.info(typescript_1.default.flattenDiagnosticMessageText(status.messageText, newLine));
+                this.logger.info(ts.flattenDiagnosticMessageText(status.messageText, newLine));
             });
             let successFinished = true;
             let currentProgram;
@@ -395,7 +410,7 @@ let Application = (() => {
                     }
                     this.logger.resetErrors();
                     this.logger.resetWarnings();
-                    const entryPoints = (0, entry_point_1.getWatchEntryPoints)(this.logger, this.options, currentProgram);
+                    const entryPoints = getWatchEntryPoints(this.logger, this.options, currentProgram);
                     if (!entryPoints) {
                         return;
                     }
@@ -418,13 +433,13 @@ let Application = (() => {
             };
             const origAfterProgramCreate = host.afterProgramCreate;
             host.afterProgramCreate = (program) => {
-                if (typescript_1.default.getPreEmitDiagnostics(program.getProgram()).length === 0) {
+                if (ts.getPreEmitDiagnostics(program.getProgram()).length === 0) {
                     currentProgram = program.getProgram();
                     runSuccess();
                 }
                 origAfterProgramCreate?.(program);
             };
-            typescript_1.default.createWatchProgram(host);
+            ts.createWatchProgram(host);
         }
         validate(project) {
             const checks = this.options.getValue("validation");
@@ -432,32 +447,35 @@ let Application = (() => {
             // No point in validating exports when merging. Warnings will have already been emitted when
             // creating the project jsons that this run merges together.
             if (checks.notExported &&
-                this.entryPointStrategy !== entry_point_1.EntryPointStrategy.Merge) {
-                (0, exports_1.validateExports)(project, this.logger, this.options.getValue("intentionallyNotExported"));
+                this.entryPointStrategy !== EntryPointStrategy.Merge) {
+                validateExports(project, this.logger, this.options.getValue("intentionallyNotExported"));
             }
             if (checks.notDocumented) {
-                (0, documentation_1.validateDocumentation)(project, this.logger, this.options.getValue("requiredToBeDocumented"));
+                validateDocumentation(project, this.logger, this.options.getValue("requiredToBeDocumented"));
             }
             if (checks.invalidLink) {
-                (0, links_1.validateLinks)(project, this.logger);
+                validateLinks(project, this.logger);
+            }
+            if (checks.unusedMergeModuleWith) {
+                validateMergeModuleWith(project, this.logger);
             }
             this.trigger(Application.EVENT_VALIDATE_PROJECT, project);
             this.logger.verbose(`Validation took ${Date.now() - start}ms`);
         }
+        /**
+         * Render outputs selected with options for the specified project
+         */
+        async generateOutputs(project) {
+            await this.outputs.writeOutputs(project);
+        }
         /**
          * Render HTML for the given project
          */
         async generateDocs(project, out) {
-            const start = Date.now();
-            out = Path.resolve(out);
-            await this.renderer.render(project, out);
-            if (this.logger.hasErrors()) {
-                this.logger.error(this.i18n.docs_could_not_be_generated());
-            }
-            else {
-                this.logger.info(this.i18n.docs_generated_at_0((0, paths_1.nicePath)(out)));
-                this.logger.verbose(`HTML rendering took ${Date.now() - start}ms`);
-            }
+            await this.outputs.writeOutput({
+                name: "html",
+                path: out,
+            }, project);
         }
         /**
          * Write the reflections to a json file.
@@ -466,13 +484,10 @@ let Application = (() => {
          * @returns Whether the JSON file could be written successfully.
          */
         async generateJson(project, out) {
-            const start = Date.now();
-            out = Path.resolve(out);
-            const ser = this.serializer.projectToObject(project, process.cwd());
-            const space = this.options.getValue("pretty") ? "\t" : "";
-            await (0, index_2.writeFile)(out, JSON.stringify(ser, null, space) + "\n");
-            this.logger.info(this.i18n.json_written_to_0((0, paths_1.nicePath)(out)));
-            this.logger.verbose(`JSON rendering took ${Date.now() - start}ms`);
+            await this.outputs.writeOutput({
+                name: "json",
+                path: out,
+            }, project);
         }
         /**
          * Print the version number.
@@ -490,7 +505,7 @@ let Application = (() => {
                 this.logger.error(this.i18n.no_entry_points_for_packages());
                 return;
             }
-            const packageDirs = (0, entry_point_1.getPackageDirectories)(this.logger, this.options, this.options.getValue("entryPoints"));
+            const packageDirs = getPackageDirectories(this.logger, this.options, this.options.getValue("entryPoints"));
             if (packageDirs.length === 0) {
                 this.logger.error(this.i18n.failed_to_find_packages());
                 return;
@@ -501,32 +516,37 @@ let Application = (() => {
             const projectsToConvert = [];
             // Generate a json file for each package
             for (const dir of packageDirs) {
-                this.logger.verbose(`Reading project at ${(0, paths_1.nicePath)(dir)}`);
+                this.logger.verbose(`Reading project at ${nicePath(dir)}`);
                 let opts;
                 try {
                     opts = origOptions.copyForPackage(dir);
                 }
                 catch (error) {
-                    (0, assert_1.ok)(error instanceof Error);
+                    ok(error instanceof Error);
                     this.logger.error(error.message);
-                    this.logger.info(this.i18n.previous_error_occurred_when_reading_options_for_0((0, paths_1.nicePath)(dir)));
+                    this.logger.info(this.i18n.previous_error_occurred_when_reading_options_for_0(nicePath(dir)));
                     continue;
                 }
                 await opts.read(this.logger, dir);
                 // Invalid links should only be reported after everything has been merged.
-                opts.setValue("validation", { invalidLink: false });
+                // Same goes for @mergeModuleWith, should only be validated after merging
+                // everything together.
+                opts.setValue("validation", {
+                    invalidLink: false,
+                    unusedMergeModuleWith: false,
+                });
                 if (opts.getValue("entryPointStrategy") ===
-                    entry_point_1.EntryPointStrategy.Packages) {
-                    this.logger.error(this.i18n.nested_packages_unsupported_0((0, paths_1.nicePath)(dir)));
+                    EntryPointStrategy.Packages) {
+                    this.logger.error(this.i18n.nested_packages_unsupported_0(nicePath(dir)));
                     continue;
                 }
-                (0, ReflectionSymbolId_1.addInferredDeclarationMapPaths)(opts.getCompilerOptions(), opts.getFileNames());
+                addInferredDeclarationMapPaths(opts.getCompilerOptions(), opts.getFileNames());
                 projectsToConvert.push({ dir, options: opts });
             }
             for (const { dir, options } of projectsToConvert) {
-                this.logger.info(this.i18n.converting_project_at_0((0, paths_1.nicePath)(dir)));
+                this.logger.info(this.i18n.converting_project_at_0(nicePath(dir)));
                 this.options = options;
-                this.files = new FileRegistry_1.ValidatingFileRegistry();
+                this.files = new ValidatingFileRegistry();
                 let project = await this.convert();
                 if (project) {
                     this.validate(project);
@@ -548,8 +568,12 @@ let Application = (() => {
                 return;
             }
             this.logger.info(this.i18n.merging_converted_projects());
-            const result = this.deserializer.reviveProjects(this.options.getValue("name") || "Documentation", projects, process.cwd(), this.files);
-            this.trigger(application_events_1.ApplicationEvents.REVIVE, result);
+            const result = this.deserializer.reviveProjects(this.options.getValue("name") || "Documentation", projects, {
+                projectRoot: process.cwd(),
+                registry: this.files,
+                addProjectDocuments: true,
+            });
+            this.trigger(ApplicationEvents.REVIVE, result);
             return result;
         }
         _merge() {
@@ -558,83 +582,39 @@ let Application = (() => {
                 this.logger.error(this.i18n.no_entry_points_to_merge());
                 return;
             }
-            const rootDir = (0, fs_1.deriveRootDir)(this.entryPoints);
+            const rootDir = deriveRootDir(this.entryPoints);
             const entryPoints = this.entryPoints.flatMap((entry) => {
-                const result = (0, fs_1.glob)(entry, rootDir);
+                const result = glob(entry, rootDir);
                 if (result.length === 0) {
-                    this.logger.warn(this.i18n.entrypoint_did_not_match_files_0((0, paths_1.nicePath)(entry)));
+                    this.logger.warn(this.i18n.entrypoint_did_not_match_files_0(nicePath(entry)));
                 }
-                else {
-                    this.logger.verbose(`Expanded ${(0, paths_1.nicePath)(entry)} to:\n\t${result
-                        .map(paths_1.nicePath)
+                else if (result.length !== 1) {
+                    this.logger.verbose(`Expanded ${nicePath(entry)} to:\n\t${result
+                        .map(nicePath)
                         .join("\n\t")}`);
                 }
                 return result;
             });
             const jsonProjects = entryPoints.map((path) => {
                 try {
-                    return JSON.parse((0, fs_1.readFile)(path));
+                    return JSON.parse(readFile(path));
                 }
                 catch {
-                    this.logger.error(this.i18n.failed_to_parse_json_0((0, paths_1.nicePath)(path)));
+                    this.logger.error(this.i18n.failed_to_parse_json_0(nicePath(path)));
                     return null;
                 }
             });
             if (this.logger.hasErrors())
                 return;
-            const result = this.deserializer.reviveProjects(this.options.getValue("name"), jsonProjects, process.cwd(), this.files);
+            const result = this.deserializer.reviveProjects(this.options.getValue("name"), jsonProjects, {
+                projectRoot: process.cwd(),
+                registry: this.files,
+                addProjectDocuments: true,
+            });
             this.logger.verbose(`Reviving projects took ${Date.now() - start}ms`);
-            // If we only revived one project, the project documents were set for
-            // it when it was created. If we revived more than one project then
-            // it's convenient to be able to add more documents now.
-            if (jsonProjects.length > 1) {
-                this.converter.addProjectDocuments(result);
-            }
-            this.trigger(application_events_1.ApplicationEvents.REVIVE, result);
+            this.trigger(ApplicationEvents.REVIVE, result);
             return result;
         }
     };
-    _Application_lang_accessor_storage = new WeakMap();
-    _Application_skipErrorChecking_accessor_storage = new WeakMap();
-    _Application_entryPointStrategy_accessor_storage = new WeakMap();
-    _Application_entryPoints_accessor_storage = new WeakMap();
-    __setFunctionName(_classThis, "Application");
-    (() => {
-        const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
-        _lang_decorators = [(0, utils_1.Option)("lang")];
-        _skipErrorChecking_decorators = [(0, utils_1.Option)("skipErrorChecking")];
-        _entryPointStrategy_decorators = [(0, utils_1.Option)("entryPointStrategy")];
-        _entryPoints_decorators = [(0, utils_1.Option)("entryPoints")];
-        __esDecorate(_classThis, null, _lang_decorators, { kind: "accessor", name: "lang", static: false, private: false, access: { has: obj => "lang" in obj, get: obj => obj.lang, set: (obj, value) => { obj.lang = value; } }, metadata: _metadata }, _lang_initializers, _lang_extraInitializers);
-        __esDecorate(_classThis, null, _skipErrorChecking_decorators, { kind: "accessor", name: "skipErrorChecking", static: false, private: false, access: { has: obj => "skipErrorChecking" in obj, get: obj => obj.skipErrorChecking, set: (obj, value) => { obj.skipErrorChecking = value; } }, metadata: _metadata }, _skipErrorChecking_initializers, _skipErrorChecking_extraInitializers);
-        __esDecorate(_classThis, null, _entryPointStrategy_decorators, { kind: "accessor", name: "entryPointStrategy", static: false, private: false, access: { has: obj => "entryPointStrategy" in obj, get: obj => obj.entryPointStrategy, set: (obj, value) => { obj.entryPointStrategy = value; } }, metadata: _metadata }, _entryPointStrategy_initializers, _entryPointStrategy_extraInitializers);
-        __esDecorate(_classThis, null, _entryPoints_decorators, { kind: "accessor", name: "entryPoints", static: false, private: false, access: { has: obj => "entryPoints" in obj, get: obj => obj.entryPoints, set: (obj, value) => { obj.entryPoints = value; } }, metadata: _metadata }, _entryPoints_initializers, _entryPoints_extraInitializers);
-        __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
-        Application = _classThis = _classDescriptor.value;
-        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-    })();
-    /**
-     * The version number of TypeDoc.
-     */
-    _classThis.VERSION = packageInfo.version;
-    /**
-     * Emitted after plugins have been loaded and options have been read, but before they have been frozen.
-     * The listener will be given an instance of {@link Application}.
-     */
-    _classThis.EVENT_BOOTSTRAP_END = application_events_1.ApplicationEvents.BOOTSTRAP_END;
-    /**
-     * Emitted after a project has been deserialized from JSON.
-     * The listener will be given an instance of {@link ProjectReflection}.
-     */
-    _classThis.EVENT_PROJECT_REVIVE = application_events_1.ApplicationEvents.REVIVE;
-    /**
-     * Emitted when validation is being run.
-     * The listener will be given an instance of {@link ProjectReflection}.
-     */
-    _classThis.EVENT_VALIDATE_PROJECT = application_events_1.ApplicationEvents.VALIDATE_PROJECT;
-    (() => {
-        __runInitializers(_classThis, _classExtraInitializers);
-    })();
-    return Application = _classThis;
 })();
-exports.Application = Application;
+export { Application };