typedoc 0.26.11 → 0.27.0-beta.1

package/dist/lib/converter/converter.js

@@ -1,4 +1,3 @@
-"use strict";
 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";
@@ -33,56 +32,40 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-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.Converter = void 0;
-const typescript_1 = __importDefault(require("typescript"));
-const index_1 = require("../models/index");
-const context_1 = require("./context");
-const components_1 = require("./components");
-const component_1 = require("../utils/component");
-const utils_1 = require("../utils");
-const types_1 = require("./types");
-const converter_events_1 = require("./converter-events");
-const symbols_1 = require("./symbols");
-const paths_1 = require("../utils/paths");
-const enum_1 = require("../utils/enum");
-const parser_1 = require("./comments/parser");
-const rawLexer_1 = require("./comments/rawLexer");
-const linkResolver_1 = require("./comments/linkResolver");
-const declarationReference_1 = require("./comments/declarationReference");
-const path_1 = require("path");
+import ts from "typescript";
+import { Comment, DocumentReflection, ProjectReflection, ReflectionKind, } from "../models/index.js";
+import { Context } from "./context.js";
+import { AbstractComponent } from "../utils/component.js";
+import { Option, MinimalSourceFile, readFile, unique, getDocumentEntryPoints, } from "../utils/index.js";
+import { convertType } from "./types.js";
+import { ConverterEvents } from "./converter-events.js";
+import { convertSymbol } from "./symbols.js";
+import { createMinimatch, matchesAny, nicePath } from "../utils/paths.js";
+import { hasAllFlags, hasAnyFlag } from "../utils/enum.js";
+import { parseCommentString } from "./comments/parser.js";
+import { lexCommentString } from "./comments/rawLexer.js";
+import { resolvePartLinks, resolveLinks, } from "./comments/linkResolver.js";
+import { meaningToString, } from "./comments/declarationReference.js";
+import { basename, dirname, resolve } from "path";
+import { GroupPlugin } from "./plugins/GroupPlugin.js";
+import { CategoryPlugin } from "./plugins/CategoryPlugin.js";
+import { CommentPlugin } from "./plugins/CommentPlugin.js";
+import { ImplementsPlugin } from "./plugins/ImplementsPlugin.js";
+import { InheritDocPlugin } from "./plugins/InheritDocPlugin.js";
+import { LinkResolverPlugin } from "./plugins/LinkResolverPlugin.js";
+import { PackagePlugin } from "./plugins/PackagePlugin.js";
+import { SourcePlugin } from "./plugins/SourcePlugin.js";
+import { TypePlugin } from "./plugins/TypePlugin.js";
+import { IncludePlugin } from "./plugins/IncludePlugin.js";
+import { MergeModuleWithPlugin } from "./plugins/MergeModuleWithPlugin.js";
 /**
  * Compiles source files using TypeScript and converts compiler symbols to reflections.
+ *
+ * @group Common
+ * @summary Responsible for converting TypeScript symbols into {@link Reflection}s and {@link Type}s.
  */
 let Converter = (() => {
-    var _Converter_externalPattern_accessor_storage, _Converter_excludeExternals_accessor_storage, _Converter_excludeNotDocumented_accessor_storage, _Converter_excludePrivate_accessor_storage, _Converter_excludeProtected_accessor_storage, _Converter_excludeReferences_accessor_storage, _Converter_commentStyle_accessor_storage, _Converter_validation_accessor_storage, _Converter_externalSymbolLinkMappings_accessor_storage, _Converter_preserveLinkText_accessor_storage, _Converter_maxTypeConversionDepth_accessor_storage;
-    let _classDecorators = [(0, component_1.Component)({
-            name: "converter",
-            internal: true,
-            childClass: components_1.ConverterComponent,
-        })];
-    let _classDescriptor;
-    let _classExtraInitializers = [];
-    let _classThis;
-    let _classSuper = component_1.ChildableComponent;
+    let _classSuper = AbstractComponent;
     let _externalPattern_decorators;
     let _externalPattern_initializers = [];
     let _externalPattern_extraInitializers = [];
@@ -116,59 +99,151 @@ let Converter = (() => {
     let _maxTypeConversionDepth_decorators;
     let _maxTypeConversionDepth_initializers = [];
     let _maxTypeConversionDepth_extraInitializers = [];
-    var Converter = _classThis = class extends _classSuper {
+    return class Converter extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _externalPattern_decorators = [Option("externalPattern")];
+            _excludeExternals_decorators = [Option("excludeExternals")];
+            _excludeNotDocumented_decorators = [Option("excludeNotDocumented")];
+            _excludePrivate_decorators = [Option("excludePrivate")];
+            _excludeProtected_decorators = [Option("excludeProtected")];
+            _excludeReferences_decorators = [Option("excludeReferences")];
+            _commentStyle_decorators = [Option("commentStyle")];
+            _validation_decorators = [Option("validation")];
+            _externalSymbolLinkMappings_decorators = [Option("externalSymbolLinkMappings")];
+            _preserveLinkText_decorators = [Option("preserveLinkText")];
+            _maxTypeConversionDepth_decorators = [Option("maxTypeConversionDepth")];
+            __esDecorate(this, null, _externalPattern_decorators, { kind: "accessor", name: "externalPattern", static: false, private: false, access: { has: obj => "externalPattern" in obj, get: obj => obj.externalPattern, set: (obj, value) => { obj.externalPattern = value; } }, metadata: _metadata }, _externalPattern_initializers, _externalPattern_extraInitializers);
+            __esDecorate(this, null, _excludeExternals_decorators, { kind: "accessor", name: "excludeExternals", static: false, private: false, access: { has: obj => "excludeExternals" in obj, get: obj => obj.excludeExternals, set: (obj, value) => { obj.excludeExternals = value; } }, metadata: _metadata }, _excludeExternals_initializers, _excludeExternals_extraInitializers);
+            __esDecorate(this, null, _excludeNotDocumented_decorators, { kind: "accessor", name: "excludeNotDocumented", static: false, private: false, access: { has: obj => "excludeNotDocumented" in obj, get: obj => obj.excludeNotDocumented, set: (obj, value) => { obj.excludeNotDocumented = value; } }, metadata: _metadata }, _excludeNotDocumented_initializers, _excludeNotDocumented_extraInitializers);
+            __esDecorate(this, null, _excludePrivate_decorators, { kind: "accessor", name: "excludePrivate", static: false, private: false, access: { has: obj => "excludePrivate" in obj, get: obj => obj.excludePrivate, set: (obj, value) => { obj.excludePrivate = value; } }, metadata: _metadata }, _excludePrivate_initializers, _excludePrivate_extraInitializers);
+            __esDecorate(this, null, _excludeProtected_decorators, { kind: "accessor", name: "excludeProtected", static: false, private: false, access: { has: obj => "excludeProtected" in obj, get: obj => obj.excludeProtected, set: (obj, value) => { obj.excludeProtected = value; } }, metadata: _metadata }, _excludeProtected_initializers, _excludeProtected_extraInitializers);
+            __esDecorate(this, null, _excludeReferences_decorators, { kind: "accessor", name: "excludeReferences", static: false, private: false, access: { has: obj => "excludeReferences" in obj, get: obj => obj.excludeReferences, set: (obj, value) => { obj.excludeReferences = value; } }, metadata: _metadata }, _excludeReferences_initializers, _excludeReferences_extraInitializers);
+            __esDecorate(this, null, _commentStyle_decorators, { kind: "accessor", name: "commentStyle", static: false, private: false, access: { has: obj => "commentStyle" in obj, get: obj => obj.commentStyle, set: (obj, value) => { obj.commentStyle = value; } }, metadata: _metadata }, _commentStyle_initializers, _commentStyle_extraInitializers);
+            __esDecorate(this, null, _validation_decorators, { kind: "accessor", name: "validation", static: false, private: false, access: { has: obj => "validation" in obj, get: obj => obj.validation, set: (obj, value) => { obj.validation = value; } }, metadata: _metadata }, _validation_initializers, _validation_extraInitializers);
+            __esDecorate(this, null, _externalSymbolLinkMappings_decorators, { kind: "accessor", name: "externalSymbolLinkMappings", static: false, private: false, access: { has: obj => "externalSymbolLinkMappings" in obj, get: obj => obj.externalSymbolLinkMappings, set: (obj, value) => { obj.externalSymbolLinkMappings = value; } }, metadata: _metadata }, _externalSymbolLinkMappings_initializers, _externalSymbolLinkMappings_extraInitializers);
+            __esDecorate(this, null, _preserveLinkText_decorators, { kind: "accessor", name: "preserveLinkText", static: false, private: false, access: { has: obj => "preserveLinkText" in obj, get: obj => obj.preserveLinkText, set: (obj, value) => { obj.preserveLinkText = value; } }, metadata: _metadata }, _preserveLinkText_initializers, _preserveLinkText_extraInitializers);
+            __esDecorate(this, null, _maxTypeConversionDepth_decorators, { kind: "accessor", name: "maxTypeConversionDepth", static: false, private: false, access: { has: obj => "maxTypeConversionDepth" in obj, get: obj => obj.maxTypeConversionDepth, set: (obj, value) => { obj.maxTypeConversionDepth = value; } }, metadata: _metadata }, _maxTypeConversionDepth_initializers, _maxTypeConversionDepth_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        #externalPattern_accessor_storage = __runInitializers(this, _externalPattern_initializers, void 0);
         /** @internal */
-        get externalPattern() { return __classPrivateFieldGet(this, _Converter_externalPattern_accessor_storage, "f"); }
-        set externalPattern(value) { __classPrivateFieldSet(this, _Converter_externalPattern_accessor_storage, value, "f"); }
+        get externalPattern() { return this.#externalPattern_accessor_storage; }
+        set externalPattern(value) { this.#externalPattern_accessor_storage = value; }
+        externalPatternCache = __runInitializers(this, _externalPattern_extraInitializers);
+        excludeCache;
+        #excludeExternals_accessor_storage = __runInitializers(this, _excludeExternals_initializers, void 0);
         /** @internal */
-        get excludeExternals() { return __classPrivateFieldGet(this, _Converter_excludeExternals_accessor_storage, "f"); }
-        set excludeExternals(value) { __classPrivateFieldSet(this, _Converter_excludeExternals_accessor_storage, value, "f"); }
+        get excludeExternals() { return this.#excludeExternals_accessor_storage; }
+        set excludeExternals(value) { this.#excludeExternals_accessor_storage = value; }
+        #excludeNotDocumented_accessor_storage = (__runInitializers(this, _excludeExternals_extraInitializers), __runInitializers(this, _excludeNotDocumented_initializers, void 0));
         /** @internal */
-        get excludeNotDocumented() { return __classPrivateFieldGet(this, _Converter_excludeNotDocumented_accessor_storage, "f"); }
-        set excludeNotDocumented(value) { __classPrivateFieldSet(this, _Converter_excludeNotDocumented_accessor_storage, value, "f"); }
+        get excludeNotDocumented() { return this.#excludeNotDocumented_accessor_storage; }
+        set excludeNotDocumented(value) { this.#excludeNotDocumented_accessor_storage = value; }
+        #excludePrivate_accessor_storage = (__runInitializers(this, _excludeNotDocumented_extraInitializers), __runInitializers(this, _excludePrivate_initializers, void 0));
         /** @internal */
-        get excludePrivate() { return __classPrivateFieldGet(this, _Converter_excludePrivate_accessor_storage, "f"); }
-        set excludePrivate(value) { __classPrivateFieldSet(this, _Converter_excludePrivate_accessor_storage, value, "f"); }
+        get excludePrivate() { return this.#excludePrivate_accessor_storage; }
+        set excludePrivate(value) { this.#excludePrivate_accessor_storage = value; }
+        #excludeProtected_accessor_storage = (__runInitializers(this, _excludePrivate_extraInitializers), __runInitializers(this, _excludeProtected_initializers, void 0));
         /** @internal */
-        get excludeProtected() { return __classPrivateFieldGet(this, _Converter_excludeProtected_accessor_storage, "f"); }
-        set excludeProtected(value) { __classPrivateFieldSet(this, _Converter_excludeProtected_accessor_storage, value, "f"); }
+        get excludeProtected() { return this.#excludeProtected_accessor_storage; }
+        set excludeProtected(value) { this.#excludeProtected_accessor_storage = value; }
+        #excludeReferences_accessor_storage = (__runInitializers(this, _excludeProtected_extraInitializers), __runInitializers(this, _excludeReferences_initializers, void 0));
         /** @internal */
-        get excludeReferences() { return __classPrivateFieldGet(this, _Converter_excludeReferences_accessor_storage, "f"); }
-        set excludeReferences(value) { __classPrivateFieldSet(this, _Converter_excludeReferences_accessor_storage, value, "f"); }
+        get excludeReferences() { return this.#excludeReferences_accessor_storage; }
+        set excludeReferences(value) { this.#excludeReferences_accessor_storage = value; }
+        #commentStyle_accessor_storage = (__runInitializers(this, _excludeReferences_extraInitializers), __runInitializers(this, _commentStyle_initializers, void 0));
         /** @internal */
-        get commentStyle() { return __classPrivateFieldGet(this, _Converter_commentStyle_accessor_storage, "f"); }
-        set commentStyle(value) { __classPrivateFieldSet(this, _Converter_commentStyle_accessor_storage, value, "f"); }
+        get commentStyle() { return this.#commentStyle_accessor_storage; }
+        set commentStyle(value) { this.#commentStyle_accessor_storage = value; }
+        #validation_accessor_storage = (__runInitializers(this, _commentStyle_extraInitializers), __runInitializers(this, _validation_initializers, void 0));
         /** @internal */
-        get validation() { return __classPrivateFieldGet(this, _Converter_validation_accessor_storage, "f"); }
-        set validation(value) { __classPrivateFieldSet(this, _Converter_validation_accessor_storage, value, "f"); }
+        get validation() { return this.#validation_accessor_storage; }
+        set validation(value) { this.#validation_accessor_storage = value; }
+        #externalSymbolLinkMappings_accessor_storage = (__runInitializers(this, _validation_extraInitializers), __runInitializers(this, _externalSymbolLinkMappings_initializers, void 0));
         /** @internal */
-        get externalSymbolLinkMappings() { return __classPrivateFieldGet(this, _Converter_externalSymbolLinkMappings_accessor_storage, "f"); }
-        set externalSymbolLinkMappings(value) { __classPrivateFieldSet(this, _Converter_externalSymbolLinkMappings_accessor_storage, value, "f"); }
+        get externalSymbolLinkMappings() { return this.#externalSymbolLinkMappings_accessor_storage; }
+        set externalSymbolLinkMappings(value) { this.#externalSymbolLinkMappings_accessor_storage = value; }
+        #preserveLinkText_accessor_storage = (__runInitializers(this, _externalSymbolLinkMappings_extraInitializers), __runInitializers(this, _preserveLinkText_initializers, void 0));
         /** @internal */
-        get preserveLinkText() { return __classPrivateFieldGet(this, _Converter_preserveLinkText_accessor_storage, "f"); }
-        set preserveLinkText(value) { __classPrivateFieldSet(this, _Converter_preserveLinkText_accessor_storage, value, "f"); }
+        get preserveLinkText() { return this.#preserveLinkText_accessor_storage; }
+        set preserveLinkText(value) { this.#preserveLinkText_accessor_storage = value; }
+        #maxTypeConversionDepth_accessor_storage = (__runInitializers(this, _preserveLinkText_extraInitializers), __runInitializers(this, _maxTypeConversionDepth_initializers, void 0));
         /** @internal */
-        get maxTypeConversionDepth() { return __classPrivateFieldGet(this, _Converter_maxTypeConversionDepth_accessor_storage, "f"); }
-        set maxTypeConversionDepth(value) { __classPrivateFieldSet(this, _Converter_maxTypeConversionDepth_accessor_storage, value, "f"); }
+        get maxTypeConversionDepth() { return this.#maxTypeConversionDepth_accessor_storage; }
+        set maxTypeConversionDepth(value) { this.#maxTypeConversionDepth_accessor_storage = value; }
+        _config = __runInitializers(this, _maxTypeConversionDepth_extraInitializers);
+        _externalSymbolResolvers = [];
         get config() {
             return this._config || this._buildCommentParserConfig();
         }
+        /**
+         * General events
+         */
+        /**
+         * Triggered when the converter begins converting a project.
+         * The listener will be given a {@link Context} object.
+         * @event
+         */
+        static EVENT_BEGIN = ConverterEvents.BEGIN;
+        /**
+         * Triggered when the converter has finished converting a project.
+         * The listener will be given a {@link Context} object.
+         * @event
+         */
+        static EVENT_END = ConverterEvents.END;
+        /**
+         * Factory events
+         */
+        /**
+         * Triggered when the converter has created a declaration reflection.
+         * The listener will be given {@link Context} and a {@link Models.DeclarationReflection}.
+         * @event
+         */
+        static EVENT_CREATE_DECLARATION = ConverterEvents.CREATE_DECLARATION;
+        /**
+         * Triggered when the converter has created a signature reflection.
+         * The listener will be given {@link Context}, {@link Models.SignatureReflection} | {@link Models.ProjectReflection} the declaration,
+         * `ts.SignatureDeclaration | ts.IndexSignatureDeclaration | ts.JSDocSignature | undefined`,
+         * and `ts.Signature | undefined`. The signature will be undefined if the created signature is an index signature.
+         * @event
+         */
+        static EVENT_CREATE_SIGNATURE = ConverterEvents.CREATE_SIGNATURE;
+        /**
+         * Triggered when the converter has created a parameter reflection.
+         * The listener will be given {@link Context}, {@link Models.ParameterReflection} and a `ts.Node?`
+         * @event
+         */
+        static EVENT_CREATE_PARAMETER = ConverterEvents.CREATE_PARAMETER;
+        /**
+         * Triggered when the converter has created a type parameter reflection.
+         * The listener will be given {@link Context} and a {@link Models.TypeParameterReflection}
+         * @event
+         */
+        static EVENT_CREATE_TYPE_PARAMETER = ConverterEvents.CREATE_TYPE_PARAMETER;
+        /**
+         * Resolve events
+         */
+        /**
+         * Triggered when the converter begins resolving a project.
+         * The listener will be given {@link Context}.
+         * @event
+         */
+        static EVENT_RESOLVE_BEGIN = ConverterEvents.RESOLVE_BEGIN;
+        /**
+         * Triggered when the converter resolves a reflection.
+         * The listener will be given {@link Context} and a {@link Reflection}.
+         * @event
+         */
+        static EVENT_RESOLVE = ConverterEvents.RESOLVE;
+        /**
+         * Triggered when the converter has finished resolving a project.
+         * The listener will be given {@link Context}.
+         * @event
+         */
+        static EVENT_RESOLVE_END = ConverterEvents.RESOLVE_END;
         constructor(owner) {
             super(owner);
-            _Converter_externalPattern_accessor_storage.set(this, __runInitializers(this, _externalPattern_initializers, void 0));
-            this.externalPatternCache = __runInitializers(this, _externalPattern_extraInitializers);
-            _Converter_excludeExternals_accessor_storage.set(this, __runInitializers(this, _excludeExternals_initializers, void 0));
-            _Converter_excludeNotDocumented_accessor_storage.set(this, (__runInitializers(this, _excludeExternals_extraInitializers), __runInitializers(this, _excludeNotDocumented_initializers, void 0)));
-            _Converter_excludePrivate_accessor_storage.set(this, (__runInitializers(this, _excludeNotDocumented_extraInitializers), __runInitializers(this, _excludePrivate_initializers, void 0)));
-            _Converter_excludeProtected_accessor_storage.set(this, (__runInitializers(this, _excludePrivate_extraInitializers), __runInitializers(this, _excludeProtected_initializers, void 0)));
-            _Converter_excludeReferences_accessor_storage.set(this, (__runInitializers(this, _excludeProtected_extraInitializers), __runInitializers(this, _excludeReferences_initializers, void 0)));
-            _Converter_commentStyle_accessor_storage.set(this, (__runInitializers(this, _excludeReferences_extraInitializers), __runInitializers(this, _commentStyle_initializers, void 0)));
-            _Converter_validation_accessor_storage.set(this, (__runInitializers(this, _commentStyle_extraInitializers), __runInitializers(this, _validation_initializers, void 0)));
-            _Converter_externalSymbolLinkMappings_accessor_storage.set(this, (__runInitializers(this, _validation_extraInitializers), __runInitializers(this, _externalSymbolLinkMappings_initializers, void 0)));
-            _Converter_preserveLinkText_accessor_storage.set(this, (__runInitializers(this, _externalSymbolLinkMappings_extraInitializers), __runInitializers(this, _preserveLinkText_initializers, void 0)));
-            _Converter_maxTypeConversionDepth_accessor_storage.set(this, (__runInitializers(this, _preserveLinkText_extraInitializers), __runInitializers(this, _maxTypeConversionDepth_initializers, void 0)));
-            this._config = __runInitializers(this, _maxTypeConversionDepth_extraInitializers);
-            this._externalSymbolResolvers = [];
             const userConfiguredSymbolResolver = (ref, refl, _part, symbolId) => {
                 if (symbolId) {
                     return userConfiguredSymbolResolver(symbolId.toDeclarationReference(), refl, undefined, undefined);
@@ -187,7 +262,7 @@ let Converter = (() => {
                     name += ref.symbolReference.path.map((p) => p.path).join(".");
                 }
                 if (ref.symbolReference.meaning) {
-                    name += (0, declarationReference_1.meaningToString)(ref.symbolReference.meaning);
+                    name += meaningToString(ref.symbolReference.meaning);
                 }
                 if (typeof modLinks[name] === "string") {
                     return modLinks[name];
@@ -197,15 +272,26 @@ let Converter = (() => {
                 }
             };
             this.addUnknownSymbolResolver(userConfiguredSymbolResolver);
+            new CategoryPlugin(this);
+            new CommentPlugin(this);
+            new GroupPlugin(this);
+            new ImplementsPlugin(this);
+            new InheritDocPlugin(this);
+            new LinkResolverPlugin(this);
+            new PackagePlugin(this);
+            new SourcePlugin(this);
+            new TypePlugin(this);
+            new IncludePlugin(this);
+            new MergeModuleWithPlugin(this);
         }
         /**
          * Compile the given source files and create a project reflection for them.
          */
         convert(entryPoints) {
-            const programs = (0, utils_1.unique)(entryPoints.map((e) => e.program));
+            const programs = unique(entryPoints.map((e) => e.program));
             this.externalPatternCache = void 0;
-            const project = new index_1.ProjectReflection(this.application.options.getValue("name"), this.application.files);
-            const context = new context_1.Context(this, programs, project);
+            const project = new ProjectReflection(this.application.options.getValue("name"), this.application.files);
+            const context = new Context(this, programs, project);
             this.trigger(Converter.EVENT_BEGIN, context);
             this.addProjectDocuments(project);
             this.compile(entryPoints, context);
@@ -216,11 +302,11 @@ let Converter = (() => {
         }
         /** @internal */
         addProjectDocuments(project) {
-            const projectDocuments = (0, utils_1.getDocumentEntryPoints)(this.application.logger, this.application.options);
+            const projectDocuments = getDocumentEntryPoints(this.application.logger, this.application.options);
             for (const { displayName, path } of projectDocuments) {
                 let file;
                 try {
-                    file = new utils_1.MinimalSourceFile((0, utils_1.readFile)(path), path);
+                    file = new MinimalSourceFile(readFile(path), path);
                 }
                 catch (error) {
                     this.application.logger.error(this.application.logger.i18n.failed_to_read_0_when_processing_project_document(path));
@@ -231,7 +317,7 @@ let Converter = (() => {
         }
         /** @internal */
         convertSymbol(context, symbol, exportSymbol) {
-            (0, symbols_1.convertSymbol)(context, symbol, exportSymbol);
+            convertSymbol(context, symbol, exportSymbol);
         }
         /**
          * Convert the given TypeScript type into its TypeDoc type reflection.
@@ -241,13 +327,13 @@ let Converter = (() => {
          * @internal
          */
         convertType(context, node) {
-            return (0, types_1.convertType)(context, node);
+            return convertType(context, node);
         }
         /**
          * Parse the given file into a comment. Intended to be used with markdown files.
          */
         parseRawComment(file, files) {
-            return (0, parser_1.parseCommentString)((0, rawLexer_1.lexCommentString)(file.text), this.config, file, this.application.logger, files);
+            return parseCommentString(lexCommentString(file.text), this.config, file, this.application.logger, files);
         }
         /**
          * Adds a new resolver that the theme can use to try to figure out how to link to a symbol declared
@@ -273,11 +359,11 @@ let Converter = (() => {
             }
         }
         resolveLinks(comment, owner) {
-            if (comment instanceof index_1.Comment) {
-                (0, linkResolver_1.resolveLinks)(comment, owner, (ref, part, refl, id) => this.resolveExternalLink(ref, part, refl, id), { preserveLinkText: this.preserveLinkText });
+            if (comment instanceof Comment) {
+                resolveLinks(comment, owner, (ref, part, refl, id) => this.resolveExternalLink(ref, part, refl, id), { preserveLinkText: this.preserveLinkText });
             }
             else {
-                return (0, linkResolver_1.resolvePartLinks)(owner, comment, (ref, part, refl, id) => this.resolveExternalLink(ref, part, refl, id), { preserveLinkText: this.preserveLinkText });
+                return resolvePartLinks(owner, comment, (ref, part, refl, id) => this.resolveExternalLink(ref, part, refl, id), { preserveLinkText: this.preserveLinkText });
             }
         }
         /**
@@ -329,16 +415,10 @@ let Converter = (() => {
                 moduleContext = context;
             }
             else {
-                const reflection = context.createDeclarationReflection(index_1.ReflectionKind.Module, symbol, void 0, entryName);
+                const reflection = context.createDeclarationReflection(ReflectionKind.Module, symbol, void 0, entryName);
                 if (!reflection.comment && !symbol) {
                     reflection.comment = context.getFileComment(node);
                 }
-                if (entryPoint.readmeFile) {
-                    const readme = (0, utils_1.readFile)(entryPoint.readmeFile);
-                    const { content } = this.parseRawComment(new utils_1.MinimalSourceFile(readme, entryPoint.readmeFile), context.project.files);
-                    reflection.readme = content;
-                }
-                reflection.packageVersion = entryPoint.version;
                 context.finalizeDeclarationReflection(reflection);
                 moduleContext = context.withScope(reflection);
             }
@@ -380,34 +460,34 @@ let Converter = (() => {
             return this.excludeExternals && this.isExternal(symbol);
         }
         isExcluded(symbol) {
-            this.excludeCache ??= (0, paths_1.createMinimatch)(this.application.options.getValue("exclude"));
+            this.excludeCache ??= createMinimatch(this.application.options.getValue("exclude"));
             const cache = this.excludeCache;
-            return (symbol.getDeclarations() ?? []).some((node) => (0, paths_1.matchesAny)(cache, node.getSourceFile().fileName));
+            return (symbol.getDeclarations() ?? []).some((node) => matchesAny(cache, node.getSourceFile().fileName));
         }
         /** @internal */
         isExternal(symbol) {
-            this.externalPatternCache ??= (0, paths_1.createMinimatch)(this.externalPattern);
+            this.externalPatternCache ??= createMinimatch(this.externalPattern);
             const cache = this.externalPatternCache;
-            return (symbol.getDeclarations() ?? []).some((node) => (0, paths_1.matchesAny)(cache, node.getSourceFile().fileName));
+            return (symbol.getDeclarations() ?? []).some((node) => matchesAny(cache, node.getSourceFile().fileName));
         }
         processDocumentTags(reflection, parent) {
             let relativeTo = reflection.comment?.sourcePath;
             if (relativeTo) {
-                relativeTo = (0, path_1.dirname)(relativeTo);
+                relativeTo = dirname(relativeTo);
                 const tags = reflection.comment?.getTags("@document") || [];
                 reflection.comment?.removeTags("@document");
                 for (const tag of tags) {
-                    const path = index_1.Comment.combineDisplayParts(tag.content);
+                    const path = Comment.combineDisplayParts(tag.content);
                     let file;
                     try {
-                        const resolved = (0, path_1.resolve)(relativeTo, path);
-                        file = new utils_1.MinimalSourceFile((0, utils_1.readFile)(resolved), resolved);
+                        const resolved = resolve(relativeTo, path);
+                        file = new MinimalSourceFile(readFile(resolved), resolved);
                     }
                     catch {
-                        this.application.logger.warn(this.application.logger.i18n.failed_to_read_0_when_processing_document_tag_in_1((0, paths_1.nicePath)(path), (0, paths_1.nicePath)(reflection.comment.sourcePath)));
+                        this.application.logger.warn(this.application.logger.i18n.failed_to_read_0_when_processing_document_tag_in_1(nicePath(path), nicePath(reflection.comment.sourcePath)));
                         continue;
                     }
-                    this.addDocument(parent, file, (0, path_1.basename)(file.fileName).replace(/\.[^.]+$/, ""));
+                    this.addDocument(parent, file, basename(file.fileName).replace(/\.[^.]+$/, ""));
                 }
             }
         }
@@ -415,21 +495,22 @@ let Converter = (() => {
             const { content, frontmatter } = this.parseRawComment(file, parent.project.files);
             const children = frontmatter["children"];
             delete frontmatter["children"];
-            const docRefl = new index_1.DocumentReflection(displayName, parent, content, frontmatter);
+            const docRefl = new DocumentReflection(displayName, parent, content, frontmatter);
             parent.addChild(docRefl);
             parent.project.registerReflection(docRefl, undefined, file.fileName);
+            this.trigger(ConverterEvents.CREATE_DOCUMENT, undefined, docRefl);
             const childrenToAdd = [];
             if (children && typeof children === "object") {
                 if (Array.isArray(children)) {
                     for (const child of children) {
                         if (typeof child === "string") {
                             childrenToAdd.push([
-                                (0, path_1.basename)(child).replace(/\.[^.]+$/, ""),
+                                basename(child).replace(/\.[^.]+$/, ""),
                                 child,
                             ]);
                         }
                         else {
-                            this.application.logger.error(this.application.i18n.frontmatter_children_0_should_be_an_array_of_strings_or_object_with_string_values((0, paths_1.nicePath)(file.fileName)));
+                            this.application.logger.error(this.application.i18n.frontmatter_children_0_should_be_an_array_of_strings_or_object_with_string_values(nicePath(file.fileName)));
                             return;
                         }
                     }
@@ -440,20 +521,20 @@ let Converter = (() => {
                             childrenToAdd.push([name, path]);
                         }
                         else {
-                            this.application.logger.error(this.application.i18n.frontmatter_children_0_should_be_an_array_of_strings_or_object_with_string_values((0, paths_1.nicePath)(file.fileName)));
+                            this.application.logger.error(this.application.i18n.frontmatter_children_0_should_be_an_array_of_strings_or_object_with_string_values(nicePath(file.fileName)));
                             return;
                         }
                     }
                 }
             }
             for (const [displayName, path] of childrenToAdd) {
-                const absPath = (0, path_1.resolve)((0, path_1.dirname)(file.fileName), path);
+                const absPath = resolve(dirname(file.fileName), path);
                 let childFile;
                 try {
-                    childFile = new utils_1.MinimalSourceFile((0, utils_1.readFile)(absPath), absPath);
+                    childFile = new MinimalSourceFile(readFile(absPath), absPath);
                 }
                 catch (error) {
-                    this.application.logger.error(this.application.logger.i18n.failed_to_read_0_when_processing_document_child_in_1(path, (0, paths_1.nicePath)(file.fileName)));
+                    this.application.logger.error(this.application.logger.i18n.failed_to_read_0_when_processing_document_child_in_1(path, nicePath(file.fileName)));
                     continue;
                 }
                 this.addDocument(docRefl, childFile, displayName);
@@ -475,117 +556,8 @@ let Converter = (() => {
             return this._config;
         }
     };
-    _Converter_externalPattern_accessor_storage = new WeakMap();
-    _Converter_excludeExternals_accessor_storage = new WeakMap();
-    _Converter_excludeNotDocumented_accessor_storage = new WeakMap();
-    _Converter_excludePrivate_accessor_storage = new WeakMap();
-    _Converter_excludeProtected_accessor_storage = new WeakMap();
-    _Converter_excludeReferences_accessor_storage = new WeakMap();
-    _Converter_commentStyle_accessor_storage = new WeakMap();
-    _Converter_validation_accessor_storage = new WeakMap();
-    _Converter_externalSymbolLinkMappings_accessor_storage = new WeakMap();
-    _Converter_preserveLinkText_accessor_storage = new WeakMap();
-    _Converter_maxTypeConversionDepth_accessor_storage = new WeakMap();
-    __setFunctionName(_classThis, "Converter");
-    (() => {
-        const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
-        _externalPattern_decorators = [(0, utils_1.Option)("externalPattern")];
-        _excludeExternals_decorators = [(0, utils_1.Option)("excludeExternals")];
-        _excludeNotDocumented_decorators = [(0, utils_1.Option)("excludeNotDocumented")];
-        _excludePrivate_decorators = [(0, utils_1.Option)("excludePrivate")];
-        _excludeProtected_decorators = [(0, utils_1.Option)("excludeProtected")];
-        _excludeReferences_decorators = [(0, utils_1.Option)("excludeReferences")];
-        _commentStyle_decorators = [(0, utils_1.Option)("commentStyle")];
-        _validation_decorators = [(0, utils_1.Option)("validation")];
-        _externalSymbolLinkMappings_decorators = [(0, utils_1.Option)("externalSymbolLinkMappings")];
-        _preserveLinkText_decorators = [(0, utils_1.Option)("preserveLinkText")];
-        _maxTypeConversionDepth_decorators = [(0, utils_1.Option)("maxTypeConversionDepth")];
-        __esDecorate(_classThis, null, _externalPattern_decorators, { kind: "accessor", name: "externalPattern", static: false, private: false, access: { has: obj => "externalPattern" in obj, get: obj => obj.externalPattern, set: (obj, value) => { obj.externalPattern = value; } }, metadata: _metadata }, _externalPattern_initializers, _externalPattern_extraInitializers);
-        __esDecorate(_classThis, null, _excludeExternals_decorators, { kind: "accessor", name: "excludeExternals", static: false, private: false, access: { has: obj => "excludeExternals" in obj, get: obj => obj.excludeExternals, set: (obj, value) => { obj.excludeExternals = value; } }, metadata: _metadata }, _excludeExternals_initializers, _excludeExternals_extraInitializers);
-        __esDecorate(_classThis, null, _excludeNotDocumented_decorators, { kind: "accessor", name: "excludeNotDocumented", static: false, private: false, access: { has: obj => "excludeNotDocumented" in obj, get: obj => obj.excludeNotDocumented, set: (obj, value) => { obj.excludeNotDocumented = value; } }, metadata: _metadata }, _excludeNotDocumented_initializers, _excludeNotDocumented_extraInitializers);
-        __esDecorate(_classThis, null, _excludePrivate_decorators, { kind: "accessor", name: "excludePrivate", static: false, private: false, access: { has: obj => "excludePrivate" in obj, get: obj => obj.excludePrivate, set: (obj, value) => { obj.excludePrivate = value; } }, metadata: _metadata }, _excludePrivate_initializers, _excludePrivate_extraInitializers);
-        __esDecorate(_classThis, null, _excludeProtected_decorators, { kind: "accessor", name: "excludeProtected", static: false, private: false, access: { has: obj => "excludeProtected" in obj, get: obj => obj.excludeProtected, set: (obj, value) => { obj.excludeProtected = value; } }, metadata: _metadata }, _excludeProtected_initializers, _excludeProtected_extraInitializers);
-        __esDecorate(_classThis, null, _excludeReferences_decorators, { kind: "accessor", name: "excludeReferences", static: false, private: false, access: { has: obj => "excludeReferences" in obj, get: obj => obj.excludeReferences, set: (obj, value) => { obj.excludeReferences = value; } }, metadata: _metadata }, _excludeReferences_initializers, _excludeReferences_extraInitializers);
-        __esDecorate(_classThis, null, _commentStyle_decorators, { kind: "accessor", name: "commentStyle", static: false, private: false, access: { has: obj => "commentStyle" in obj, get: obj => obj.commentStyle, set: (obj, value) => { obj.commentStyle = value; } }, metadata: _metadata }, _commentStyle_initializers, _commentStyle_extraInitializers);
-        __esDecorate(_classThis, null, _validation_decorators, { kind: "accessor", name: "validation", static: false, private: false, access: { has: obj => "validation" in obj, get: obj => obj.validation, set: (obj, value) => { obj.validation = value; } }, metadata: _metadata }, _validation_initializers, _validation_extraInitializers);
-        __esDecorate(_classThis, null, _externalSymbolLinkMappings_decorators, { kind: "accessor", name: "externalSymbolLinkMappings", static: false, private: false, access: { has: obj => "externalSymbolLinkMappings" in obj, get: obj => obj.externalSymbolLinkMappings, set: (obj, value) => { obj.externalSymbolLinkMappings = value; } }, metadata: _metadata }, _externalSymbolLinkMappings_initializers, _externalSymbolLinkMappings_extraInitializers);
-        __esDecorate(_classThis, null, _preserveLinkText_decorators, { kind: "accessor", name: "preserveLinkText", static: false, private: false, access: { has: obj => "preserveLinkText" in obj, get: obj => obj.preserveLinkText, set: (obj, value) => { obj.preserveLinkText = value; } }, metadata: _metadata }, _preserveLinkText_initializers, _preserveLinkText_extraInitializers);
-        __esDecorate(_classThis, null, _maxTypeConversionDepth_decorators, { kind: "accessor", name: "maxTypeConversionDepth", static: false, private: false, access: { has: obj => "maxTypeConversionDepth" in obj, get: obj => obj.maxTypeConversionDepth, set: (obj, value) => { obj.maxTypeConversionDepth = value; } }, metadata: _metadata }, _maxTypeConversionDepth_initializers, _maxTypeConversionDepth_extraInitializers);
-        __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
-        Converter = _classThis = _classDescriptor.value;
-        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-    })();
-    /**
-     * General events
-     */
-    /**
-     * Triggered when the converter begins converting a project.
-     * The listener will be given a {@link Context} object.
-     * @event
-     */
-    _classThis.EVENT_BEGIN = converter_events_1.ConverterEvents.BEGIN;
-    /**
-     * Triggered when the converter has finished converting a project.
-     * The listener will be given a {@link Context} object.
-     * @event
-     */
-    _classThis.EVENT_END = converter_events_1.ConverterEvents.END;
-    /**
-     * Factory events
-     */
-    /**
-     * Triggered when the converter has created a declaration reflection.
-     * The listener will be given {@link Context} and a {@link Models.DeclarationReflection}.
-     * @event
-     */
-    _classThis.EVENT_CREATE_DECLARATION = converter_events_1.ConverterEvents.CREATE_DECLARATION;
-    /**
-     * Triggered when the converter has created a signature reflection.
-     * The listener will be given {@link Context}, {@link Models.SignatureReflection} | {@link Models.ProjectReflection} the declaration,
-     * `ts.SignatureDeclaration | ts.IndexSignatureDeclaration | ts.JSDocSignature | undefined`,
-     * and `ts.Signature | undefined`. The signature will be undefined if the created signature is an index signature.
-     * @event
-     */
-    _classThis.EVENT_CREATE_SIGNATURE = converter_events_1.ConverterEvents.CREATE_SIGNATURE;
-    /**
-     * Triggered when the converter has created a parameter reflection.
-     * The listener will be given {@link Context}, {@link Models.ParameterReflection} and a `ts.Node?`
-     * @event
-     */
-    _classThis.EVENT_CREATE_PARAMETER = converter_events_1.ConverterEvents.CREATE_PARAMETER;
-    /**
-     * Triggered when the converter has created a type parameter reflection.
-     * The listener will be given {@link Context} and a {@link Models.TypeParameterReflection}
-     * @event
-     */
-    _classThis.EVENT_CREATE_TYPE_PARAMETER = converter_events_1.ConverterEvents.CREATE_TYPE_PARAMETER;
-    /**
-     * Resolve events
-     */
-    /**
-     * Triggered when the converter begins resolving a project.
-     * The listener will be given {@link Context}.
-     * @event
-     */
-    _classThis.EVENT_RESOLVE_BEGIN = converter_events_1.ConverterEvents.RESOLVE_BEGIN;
-    /**
-     * Triggered when the converter resolves a reflection.
-     * The listener will be given {@link Context} and a {@link Reflection}.
-     * @event
-     */
-    _classThis.EVENT_RESOLVE = converter_events_1.ConverterEvents.RESOLVE;
-    /**
-     * Triggered when the converter has finished resolving a project.
-     * The listener will be given {@link Context}.
-     * @event
-     */
-    _classThis.EVENT_RESOLVE_END = converter_events_1.ConverterEvents.RESOLVE_END;
-    (() => {
-        __runInitializers(_classThis, _classExtraInitializers);
-    })();
-    return Converter = _classThis;
 })();
-exports.Converter = Converter;
+export { Converter };
 function getSymbolForModuleLike(context, node) {
     const symbol = context.checker.getSymbolAtLocation(node) ?? node.symbol;
     if (symbol) {
@@ -596,15 +568,15 @@ function getSymbolForModuleLike(context, node) {
     // "globals" file, but this is uncommon enough that I'm skipping it for now.
     const sourceFile = node.getSourceFile();
     const globalSymbols = context.checker
-        .getSymbolsInScope(node, typescript_1.default.SymbolFlags.ModuleMember)
+        .getSymbolsInScope(node, ts.SymbolFlags.ModuleMember)
         .filter((s) => s.getDeclarations()?.some((d) => d.getSourceFile() === sourceFile));
     // Detect declaration files with declare module "foo" as their only export
     // and lift that up one level as the source file symbol
     if (globalSymbols.length === 1 &&
         globalSymbols[0]
             .getDeclarations()
-            ?.every((declaration) => typescript_1.default.isModuleDeclaration(declaration) &&
-            typescript_1.default.isStringLiteral(declaration.name))) {
+            ?.every((declaration) => ts.isModuleDeclaration(declaration) &&
+            ts.isStringLiteral(declaration.name))) {
         return globalSymbols[0];
     }
 }
@@ -619,21 +591,22 @@ function getExports(context, node, symbol) {
         // members of the export= class and as functions if a class is directly exported.
         result = [exportEq].concat(context.checker
             .getExportsOfModule(symbol)
-            .filter((s) => !(0, enum_1.hasAnyFlag)(s.flags, typescript_1.default.SymbolFlags.Prototype | typescript_1.default.SymbolFlags.Value)));
+            .filter((s) => !hasAnyFlag(s.flags, ts.SymbolFlags.Prototype | ts.SymbolFlags.Value)));
     }
     else if (symbol) {
         result = context.checker
             .getExportsOfModule(symbol)
-            .filter((s) => !(0, enum_1.hasAllFlags)(s.flags, typescript_1.default.SymbolFlags.Prototype));
+            .filter((s) => !hasAllFlags(s.flags, ts.SymbolFlags.Prototype));
         if (result.length === 0) {
-            const globalDecl = node.statements.find((s) => typescript_1.default.isModuleDeclaration(s) &&
-                s.flags & typescript_1.default.NodeFlags.GlobalAugmentation);
+            const globalDecl = node.statements.find((s) => ts.isModuleDeclaration(s) &&
+                s.flags & ts.NodeFlags.GlobalAugmentation);
             if (globalDecl) {
                 const globalSymbol = context.getSymbolAtLocation(globalDecl);
                 if (globalSymbol) {
                     result = context.checker
                         .getExportsOfModule(globalSymbol)
-                        .filter((exp) => exp.declarations?.some((d) => d.getSourceFile() === node));
+                        .filter((exp) => exp.declarations?.some((d) => d.getSourceFile() === node))
+                        .map((s) => context.checker.getMergedSymbol(s));
                 }
             }
         }
@@ -642,7 +615,7 @@ function getExports(context, node, symbol) {
         // Global file with no inferred top level symbol, get all symbols declared in this file.
         const sourceFile = node.getSourceFile();
         result = context.checker
-            .getSymbolsInScope(node, typescript_1.default.SymbolFlags.ModuleMember)
+            .getSymbolsInScope(node, ts.SymbolFlags.ModuleMember)
             .filter((s) => s
             .getDeclarations()
             ?.some((d) => d.getSourceFile() === sourceFile));