typedoc 0.22.6 → 0.22.10

package/README.md

@@ -99,8 +99,8 @@ For a complete list of the command line arguments run `typedoc --help` or visit
 
 #### Theming
 
--   `--theme <default|minimal|path/to/theme>`<br>
-    Specify the path to the theme that should be used.
+-   `--theme <default|plugin defined theme>`<br>
+    Specify the theme that should be used.
 -   `--name <Documentation title>`<br>
     Set the name of the project that will be used in the header of the template.
 -   `--readme <path/to/readme|none>`<br>

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export { normalizePath } from "./lib/utils/fs";
 export * from "./lib/models";
 export { Converter, Context } from "./lib/converter";
 export { Renderer, DefaultTheme, DefaultThemeRenderContext, UrlMapping, Theme, PageEvent, RendererEvent, MarkdownEvent, } from "./lib/output";
-export type { RenderTemplate } from "./lib/output";
-export { ArgumentsReader, BindOption, JSX, LogLevel, Logger, Options, ParameterHint, ParameterType, TSConfigReader, TypeDocReader, EntryPointStrategy, } from "./lib/utils";
+export type { RenderTemplate, RendererHooks } from "./lib/output";
+export { ArgumentsReader, BindOption, JSX, LogLevel, Logger, Options, ParameterHint, ParameterType, TSConfigReader, TypeDocReader, EntryPointStrategy, EventHooks, } from "./lib/utils";
 export type { OptionsReader, TypeDocOptions, TypeDocOptionMap, ValidationOptions, TypeDocOptionValues, KeyToDeclaration, DeclarationOption, DeclarationOptionBase, StringDeclarationOption, NumberDeclarationOption, BooleanDeclarationOption, ArrayDeclarationOption, MixedDeclarationOption, MapDeclarationOption, FlagsDeclarationOption, DeclarationOptionToOptionType, SortStrategy, ParameterTypeToOptionTypeMap, DocumentationEntryPoint, } from "./lib/utils";
 export type { EventMap, EventCallback } from "./lib/utils/events";
 export { JSONOutput, Serializer, SerializerComponent, SerializeEvent, } from "./lib/serialization";

package/dist/index.js

@@ -10,7 +10,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TypeScript = exports.SerializeEvent = exports.SerializerComponent = exports.Serializer = exports.JSONOutput = exports.EntryPointStrategy = exports.TypeDocReader = exports.TSConfigReader = exports.ParameterType = exports.ParameterHint = exports.Options = exports.Logger = exports.LogLevel = exports.JSX = exports.BindOption = exports.ArgumentsReader = exports.MarkdownEvent = exports.RendererEvent = exports.PageEvent = exports.Theme = exports.UrlMapping = exports.DefaultThemeRenderContext = exports.DefaultTheme = exports.Renderer = exports.Context = exports.Converter = exports.normalizePath = exports.resetReflectionID = exports.Event = exports.EventDispatcher = exports.Application = void 0;
+exports.TypeScript = exports.SerializeEvent = exports.SerializerComponent = exports.Serializer = exports.JSONOutput = exports.EventHooks = exports.EntryPointStrategy = exports.TypeDocReader = exports.TSConfigReader = exports.ParameterType = exports.ParameterHint = exports.Options = exports.Logger = exports.LogLevel = exports.JSX = exports.BindOption = exports.ArgumentsReader = exports.MarkdownEvent = exports.RendererEvent = exports.PageEvent = exports.Theme = exports.UrlMapping = exports.DefaultThemeRenderContext = exports.DefaultTheme = exports.Renderer = exports.Context = exports.Converter = exports.normalizePath = exports.resetReflectionID = exports.Event = exports.EventDispatcher = exports.Application = void 0;
 var application_1 = require("./lib/application");
 Object.defineProperty(exports, "Application", { enumerable: true, get: function () { return application_1.Application; } });
 var events_1 = require("./lib/utils/events");
@@ -45,6 +45,7 @@ Object.defineProperty(exports, "ParameterType", { enumerable: true, get: functio
 Object.defineProperty(exports, "TSConfigReader", { enumerable: true, get: function () { return utils_1.TSConfigReader; } });
 Object.defineProperty(exports, "TypeDocReader", { enumerable: true, get: function () { return utils_1.TypeDocReader; } });
 Object.defineProperty(exports, "EntryPointStrategy", { enumerable: true, get: function () { return utils_1.EntryPointStrategy; } });
+Object.defineProperty(exports, "EventHooks", { enumerable: true, get: function () { return utils_1.EventHooks; } });
 var serialization_1 = require("./lib/serialization");
 Object.defineProperty(exports, "JSONOutput", { enumerable: true, get: function () { return serialization_1.JSONOutput; } });
 Object.defineProperty(exports, "Serializer", { enumerable: true, get: function () { return serialization_1.Serializer; } });

package/dist/lib/application.js

@@ -21,6 +21,7 @@ const exports_1 = require("./validation/exports");
 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");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const packageInfo = require("../../package.json");
 const supportedVersionMajorMinor = packageInfo.peerDependencies.typescript
@@ -79,9 +80,7 @@ let Application = Application_1 = class Application extends component_1.Childabl
             this.options.setLogger(this.logger);
         }
         this.logger.level = this.options.getValue("logLevel");
-        const plugins = this.options.isSet("plugin")
-            ? this.options.getValue("plugin")
-            : (0, index_2.discoverNpmPlugins)(this);
+        const plugins = (0, index_2.discoverPlugins)(this);
         (0, index_2.loadPlugins)(this, plugins);
         this.options.reset();
         for (const [key, val] of Object.entries(options)) {
@@ -94,6 +93,9 @@ let Application = Application_1 = class Application extends component_1.Childabl
             }
         }
         this.options.read(this.logger);
+        if ((0, general_1.hasBeenLoadedMultipleTimes)()) {
+            this.logger.warn(`TypeDoc has been loaded multiple times. This is commonly caused by plugins which have their own installation of TypeDoc. This will likely break things.`);
+        }
     }
     /**
      * Return the application / root component instance.

package/dist/lib/converter/converter.d.ts

@@ -1,6 +1,6 @@
 import * as ts from "typescript";
 import type { Application } from "../application";
-import { Type, ProjectReflection, ReflectionKind } from "../models/index";
+import { ProjectReflection, ReflectionKind, SomeType } from "../models/index";
 import { Context } from "./context";
 import { ConverterComponent } from "./components";
 import { ChildableComponent } from "../utils/component";
@@ -97,7 +97,7 @@ export declare class Converter extends ChildableComponent<Application, Converter
      * @returns The TypeDoc type reflection representing the given node and type.
      * @internal
      */
-    convertType(context: Context, node: ts.TypeNode | ts.Type | undefined): Type;
+    convertType(context: Context, node: ts.TypeNode | ts.Type | undefined): SomeType;
     /** @internal */
     getNodesForSymbol(symbol: ts.Symbol, kind: ReflectionKind): ts.Declaration[];
     /**

package/dist/lib/converter/converter.js

@@ -354,6 +354,7 @@ function getSymbolForModuleLike(context, node) {
 }
 function getExports(context, node, symbol) {
     var _a;
+    let result;
     // The generated docs aren't great, but you really ought not be using
     // this in the first place... so it's better than nothing.
     const exportEq = (_a = symbol === null || symbol === void 0 ? void 0 : symbol.exports) === null || _a === void 0 ? void 0 : _a.get("export=");
@@ -361,21 +362,37 @@ function getExports(context, node, symbol) {
         // JS users might also have exported types here.
         // We need to filter for types because otherwise static methods can show up as both
         // members of the export= class and as functions if a class is directly exported.
-        return [exportEq].concat(context.checker
+        result = [exportEq].concat(context.checker
             .getExportsOfModule(symbol)
             .filter((s) => !(0, enum_1.hasAnyFlag)(s.flags, ts.SymbolFlags.Prototype | ts.SymbolFlags.Value)));
     }
-    if (symbol) {
-        return context.checker
+    else if (symbol) {
+        result = context.checker
             .getExportsOfModule(symbol)
             .filter((s) => !(0, enum_1.hasAllFlags)(s.flags, ts.SymbolFlags.Prototype));
     }
-    // Global file with no inferred top level symbol, get all symbols declared in this file.
-    const sourceFile = node.getSourceFile();
-    const globalSymbols = context.checker
-        .getSymbolsInScope(node, ts.SymbolFlags.ModuleMember)
-        .filter((s) => { var _a; return (_a = s.getDeclarations()) === null || _a === void 0 ? void 0 : _a.some((d) => d.getSourceFile() === sourceFile); });
-    return globalSymbols;
+    else {
+        // Global file with no inferred top level symbol, get all symbols declared in this file.
+        const sourceFile = node.getSourceFile();
+        result = context.checker
+            .getSymbolsInScope(node, ts.SymbolFlags.ModuleMember)
+            .filter((s) => {
+            var _a;
+            return (_a = s
+                .getDeclarations()) === null || _a === void 0 ? void 0 : _a.some((d) => d.getSourceFile() === sourceFile);
+        });
+    }
+    // Put symbols named "default" last, #1795
+    result.sort((a, b) => {
+        if (a.name === "default") {
+            return 1;
+        }
+        else if (b.name === "default") {
+            return -1;
+        }
+        return 0;
+    });
+    return result;
 }
 function isDirectExport(symbol, file) {
     var _a, _b;

package/dist/lib/converter/plugins/CategoryPlugin.d.ts

@@ -1,4 +1,4 @@
-import { Reflection, DeclarationReflection } from "../../models";
+import { DeclarationReflection } from "../../models";
 import { ReflectionCategory } from "../../models/ReflectionCategory";
 import { ConverterComponent } from "../components";
 /**
@@ -49,7 +49,7 @@ export declare class CategoryPlugin extends ConverterComponent {
      * @param reflection The reflection.
      * @returns The category the reflection belongs to
      */
-    static getCategories(reflection: Reflection): Set<string>;
+    static getCategories(reflection: DeclarationReflection): Set<string>;
     /**
      * Callback used to sort categories by name.
      *

package/dist/lib/converter/plugins/CategoryPlugin.js

@@ -143,8 +143,11 @@ let CategoryPlugin = CategoryPlugin_1 = class CategoryPlugin extends components_
      * @returns The category the reflection belongs to
      */
     static getCategories(reflection) {
+        var _a, _b, _c;
         function extractCategoryTag(comment) {
             const categories = new Set();
+            if (!comment)
+                return categories;
             const tags = comment.tags;
             const commentTags = [];
             tags.forEach((tag) => {
@@ -161,20 +164,21 @@ let CategoryPlugin = CategoryPlugin_1 = class CategoryPlugin extends components_
             comment.tags = commentTags;
             return categories;
         }
-        const categories = new Set();
+        let categories = new Set();
         if (reflection.comment) {
-            return extractCategoryTag(reflection.comment);
+            categories = extractCategoryTag(reflection.comment);
         }
-        else if (reflection instanceof models_1.DeclarationReflection &&
-            reflection.signatures) {
+        else if (reflection.signatures) {
             for (const sig of reflection.signatures) {
-                for (const cat of sig.comment
-                    ? extractCategoryTag(sig.comment)
-                    : []) {
+                for (const cat of extractCategoryTag(sig.comment)) {
                     categories.add(cat);
                 }
             }
         }
+        if (((_a = reflection.type) === null || _a === void 0 ? void 0 : _a.type) === "reflection") {
+            (_b = reflection.type.declaration.comment) === null || _b === void 0 ? void 0 : _b.removeTags("category");
+            (_c = reflection.type.declaration.signatures) === null || _c === void 0 ? void 0 : _c.forEach((s) => { var _a; return (_a = s.comment) === null || _a === void 0 ? void 0 : _a.removeTags("category"); });
+        }
         return categories;
     }
     /**

package/dist/lib/converter/plugins/{GitHubPlugin.d.ts → SourceLinkPlugin.d.ts}

@@ -25,16 +25,16 @@ export declare class Repository {
      */
     project?: string;
     /**
-     * The hostname for this GitHub or Bitbucket project.
+     * The hostname for this GitHub/Bitbucket/.etc project.
      *
      * Defaults to: `github.com` (for normal, public GitHub instance projects)
      *
-     * Or the hostname for an enterprise version of GitHub, e.g. `github.acme.com`
+     * Can be the hostname for an enterprise version of GitHub, e.g. `github.acme.com`
      * (if found as a match in the list of git remotes).
      */
     hostname: string;
     /**
-     * Whether this is a GitHub or Bitbucket repository.
+     * Whether this is a GitHub, Bitbucket, or other type of repository.
      */
     type: RepositoryType;
     /**
@@ -73,7 +73,7 @@ export declare class Repository {
  * A handler that watches for repositories with GitHub origin and links
  * their source files to the related GitHub pages.
  */
-export declare class GitHubPlugin extends ConverterComponent {
+export declare class SourceLinkPlugin extends ConverterComponent {
     /**
      * List of known repositories.
      */

package/dist/lib/converter/plugins/{GitHubPlugin.js → SourceLinkPlugin.js}

@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GitHubPlugin = exports.Repository = void 0;
+exports.SourceLinkPlugin = exports.Repository = void 0;
 const Path = require("path");
 const child_process_1 = require("child_process");
 const components_1 = require("../components");
@@ -14,8 +14,13 @@ const base_path_1 = require("../utils/base-path");
 const converter_1 = require("../converter");
 const utils_1 = require("../../utils");
 const models_1 = require("../../models");
+const TEN_MEGABYTES = 1024 * 10000;
 function git(...args) {
-    return (0, child_process_1.spawnSync)("git", args, { encoding: "utf-8", windowsHide: true });
+    return (0, child_process_1.spawnSync)("git", args, {
+        encoding: "utf-8",
+        windowsHide: true,
+        maxBuffer: TEN_MEGABYTES,
+    });
 }
 /**
  * Stores data of a repository.
@@ -32,25 +37,32 @@ class Repository {
          */
         this.files = [];
         /**
-         * The hostname for this GitHub or Bitbucket project.
+         * The hostname for this GitHub/Bitbucket/.etc project.
          *
          * Defaults to: `github.com` (for normal, public GitHub instance projects)
          *
-         * Or the hostname for an enterprise version of GitHub, e.g. `github.acme.com`
+         * Can be the hostname for an enterprise version of GitHub, e.g. `github.acme.com`
          * (if found as a match in the list of git remotes).
          */
         this.hostname = "github.com";
         /**
-         * Whether this is a GitHub or Bitbucket repository.
+         * Whether this is a GitHub, Bitbucket, or other type of repository.
          */
         this.type = models_1.RepositoryType.GitHub;
         this.path = path;
         this.branch = gitRevision || "master";
         for (let i = 0, c = repoLinks.length; i < c; i++) {
             let match = /(github(?:\.[a-z]+)*\.[a-z]{2,})[:/]([^/]+)\/(.*)/.exec(repoLinks[i]);
+            // Github Enterprise
+            if (!match) {
+                match = /(\w+\.githubprivate.com)[:/]([^/]+)\/(.*)/.exec(repoLinks[i]);
+            }
             if (!match) {
                 match = /(bitbucket.org)[:/]([^/]+)\/(.*)/.exec(repoLinks[i]);
             }
+            if (!match) {
+                match = /(gitlab.com)[:/]([^/]+)\/(.*)/.exec(repoLinks[i]);
+            }
             if (match) {
                 this.hostname = match[1];
                 this.user = match[2];
@@ -61,10 +73,15 @@ class Repository {
                 break;
             }
         }
-        if (this.hostname.includes("bitbucket.org"))
+        if (this.hostname.includes("bitbucket.org")) {
             this.type = models_1.RepositoryType.Bitbucket;
-        else
+        }
+        else if (this.hostname.includes("gitlab.com")) {
+            this.type = models_1.RepositoryType.GitLab;
+        }
+        else {
             this.type = models_1.RepositoryType.GitHub;
+        }
         let out = git("-C", path, "ls-files");
         if (out.status === 0) {
             out.stdout.split("\n").forEach((file) => {
@@ -103,10 +120,13 @@ class Repository {
             `https://${this.hostname}`,
             this.user,
             this.project,
-            this.type === "github" ? "blob" : "src",
+            this.type === models_1.RepositoryType.GitLab ? "-" : undefined,
+            this.type === models_1.RepositoryType.Bitbucket ? "src" : "blob",
             this.branch,
             fileName.substr(this.path.length + 1),
-        ].join("/");
+        ]
+            .filter((s) => !!s)
+            .join("/");
     }
     /**
      * Try to create a new repository instance.
@@ -129,6 +149,7 @@ class Repository {
         switch (repositoryType) {
             default:
             case models_1.RepositoryType.GitHub:
+            case models_1.RepositoryType.GitLab:
                 return "L" + lineNumber;
             case models_1.RepositoryType.Bitbucket:
                 return "lines-" + lineNumber;
@@ -140,7 +161,7 @@ exports.Repository = Repository;
  * A handler that watches for repositories with GitHub origin and links
  * their source files to the related GitHub pages.
  */
-let GitHubPlugin = class GitHubPlugin extends components_1.ConverterComponent {
+let SourceLinkPlugin = class SourceLinkPlugin extends components_1.ConverterComponent {
     constructor() {
         super(...arguments);
         /**
@@ -225,11 +246,11 @@ let GitHubPlugin = class GitHubPlugin extends components_1.ConverterComponent {
 };
 __decorate([
     (0, utils_1.BindOption)("gitRevision")
-], GitHubPlugin.prototype, "gitRevision", void 0);
+], SourceLinkPlugin.prototype, "gitRevision", void 0);
 __decorate([
     (0, utils_1.BindOption)("gitRemote")
-], GitHubPlugin.prototype, "gitRemote", void 0);
-GitHubPlugin = __decorate([
-    (0, components_1.Component)({ name: "git-hub" })
-], GitHubPlugin);
-exports.GitHubPlugin = GitHubPlugin;
+], SourceLinkPlugin.prototype, "gitRemote", void 0);
+SourceLinkPlugin = __decorate([
+    (0, components_1.Component)({ name: "source-link" })
+], SourceLinkPlugin);
+exports.SourceLinkPlugin = SourceLinkPlugin;

package/dist/lib/converter/plugins/index.d.ts

@@ -1,7 +1,7 @@
 export { CategoryPlugin } from "./CategoryPlugin";
 export { CommentPlugin } from "./CommentPlugin";
 export { DecoratorPlugin } from "./DecoratorPlugin";
-export { GitHubPlugin } from "./GitHubPlugin";
+export { SourceLinkPlugin } from "./SourceLinkPlugin";
 export { GroupPlugin } from "./GroupPlugin";
 export { ImplementsPlugin } from "./ImplementsPlugin";
 export { PackagePlugin } from "./PackagePlugin";

package/dist/lib/converter/plugins/index.js

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InheritDocPlugin = exports.TypePlugin = exports.SourcePlugin = exports.PackagePlugin = exports.ImplementsPlugin = exports.GroupPlugin = exports.GitHubPlugin = exports.DecoratorPlugin = exports.CommentPlugin = exports.CategoryPlugin = void 0;
+exports.InheritDocPlugin = exports.TypePlugin = exports.SourcePlugin = exports.PackagePlugin = exports.ImplementsPlugin = exports.GroupPlugin = exports.SourceLinkPlugin = exports.DecoratorPlugin = exports.CommentPlugin = exports.CategoryPlugin = void 0;
 var CategoryPlugin_1 = require("./CategoryPlugin");
 Object.defineProperty(exports, "CategoryPlugin", { enumerable: true, get: function () { return CategoryPlugin_1.CategoryPlugin; } });
 var CommentPlugin_1 = require("./CommentPlugin");
 Object.defineProperty(exports, "CommentPlugin", { enumerable: true, get: function () { return CommentPlugin_1.CommentPlugin; } });
 var DecoratorPlugin_1 = require("./DecoratorPlugin");
 Object.defineProperty(exports, "DecoratorPlugin", { enumerable: true, get: function () { return DecoratorPlugin_1.DecoratorPlugin; } });
-var GitHubPlugin_1 = require("./GitHubPlugin");
-Object.defineProperty(exports, "GitHubPlugin", { enumerable: true, get: function () { return GitHubPlugin_1.GitHubPlugin; } });
+var SourceLinkPlugin_1 = require("./SourceLinkPlugin");
+Object.defineProperty(exports, "SourceLinkPlugin", { enumerable: true, get: function () { return SourceLinkPlugin_1.SourceLinkPlugin; } });
 var GroupPlugin_1 = require("./GroupPlugin");
 Object.defineProperty(exports, "GroupPlugin", { enumerable: true, get: function () { return GroupPlugin_1.GroupPlugin; } });
 var ImplementsPlugin_1 = require("./ImplementsPlugin");

package/dist/lib/converter/symbols.js

@@ -99,7 +99,10 @@ function convertSymbol(context, symbol, exportSymbol) {
         // This might be here if a namespace is declared several times.
         flags = (0, enum_1.removeFlag)(flags, ts.SymbolFlags.ValueModule);
     }
-    if ((0, enum_1.hasAllFlags)(symbol.flags, ts.SymbolFlags.Method)) {
+    if ((0, enum_1.hasAnyFlag)(symbol.flags, ts.SymbolFlags.Method |
+        ts.SymbolFlags.Interface |
+        ts.SymbolFlags.Class |
+        ts.SymbolFlags.Variable)) {
         // This happens when someone declares an object with methods:
         // { methodProperty() {} }
         flags = (0, enum_1.removeFlag)(flags, ts.SymbolFlags.Property);
@@ -528,7 +531,7 @@ function convertAccessor(context, symbol, exportSymbol) {
 function isInherited(context, symbol) {
     var _a;
     const parentSymbol = context.project.getSymbolFromReflection(context.scope);
-    assert(parentSymbol);
+    assert(parentSymbol, `No parent symbol found for ${symbol.name} in ${context.scope.name}`);
     return (((_a = parentSymbol
         .getDeclarations()) === null || _a === void 0 ? void 0 : _a.some((d) => { var _a; return (_a = symbol.getDeclarations()) === null || _a === void 0 ? void 0 : _a.some((d2) => d2.parent === d); })) === false);
 }

package/dist/lib/converter/types.d.ts

@@ -1,10 +1,10 @@
 import * as ts from "typescript";
-import { Type } from "../models";
+import { SomeType } from "../models";
 import type { Context } from "./context";
 export interface TypeConverter<TNode extends ts.TypeNode = ts.TypeNode, TType extends ts.Type = ts.Type> {
     kind: TNode["kind"][];
-    convert(context: Context, node: TNode): Type;
-    convertType(context: Context, type: TType, node: TNode): Type;
+    convert(context: Context, node: TNode): SomeType;
+    convertType(context: Context, type: TType, node: TNode): SomeType;
 }
 export declare function loadConverters(): void;
-export declare function convertType(context: Context, typeOrNode: ts.Type | ts.TypeNode | undefined): Type;
+export declare function convertType(context: Context, typeOrNode: ts.Type | ts.TypeNode | undefined): SomeType;

package/dist/lib/converter/utils/reflections.d.ts

@@ -1,5 +1,5 @@
-import { Reflection, Type } from "../../models";
-export declare function removeUndefined(type: Type): Type;
+import { Reflection, SomeType } from "../../models";
+export declare function removeUndefined(type: SomeType): SomeType;
 /**
  * Copy the comment of the source reflection to the target reflection.
  *

package/dist/lib/models/reflections/abstract.js

@@ -83,7 +83,9 @@ var ReflectionKind;
         ReflectionKind.Function |
         ReflectionKind.ObjectLiteral;
     /** @internal */
-    ReflectionKind.Inheritable = ReflectionKind.Property |
+    ReflectionKind.Inheritable = ReflectionKind.Accessor |
+        ReflectionKind.IndexSignature |
+        ReflectionKind.Property |
         ReflectionKind.Method |
         ReflectionKind.Constructor;
 })(ReflectionKind = exports.ReflectionKind || (exports.ReflectionKind = {}));
@@ -316,14 +318,18 @@ class Reflection {
                 target = target.parent;
             }
             if (!target._aliases) {
-                target._aliases = [];
+                target._aliases = new Map();
+            }
+            let suffix = "";
+            if (!target._aliases.has(alias)) {
+                target._aliases.set(alias, 1);
             }
-            let suffix = "", index = 0;
-            while (target._aliases.includes(alias + suffix)) {
-                suffix = "-" + (++index).toString();
+            else {
+                const count = target._aliases.get(alias);
+                suffix = "-" + count.toString();
+                target._aliases.set(alias, count + 1);
             }
             alias += suffix;
-            target._aliases.push(alias);
             this._alias = alias;
         }
         return this._alias;

package/dist/lib/models/reflections/declaration.d.ts

@@ -1,4 +1,5 @@
 import type * as ts from "typescript";
+import type { SomeType } from "..";
 import { ReferenceType, Type } from "../types";
 import { TraverseCallback } from "./abstract";
 import { ContainerReflection } from "./container";
@@ -42,12 +43,12 @@ export declare class DeclarationReflection extends ContainerReflection {
      * If the reflection represents a variable or a property, this is the value type.<br />
      * If the reflection represents a signature, this is the return type.
      */
-    type?: Type;
+    type?: SomeType;
     typeParameters?: TypeParameterReflection[];
     /**
      * A list of call signatures attached to this declaration.
      *
-     * TypeDoc creates one declaration per function that may contain ore or more
+     * TypeDoc creates one declaration per function that may contain one or more
      * signature reflections.
      */
     signatures?: SignatureReflection[];

package/dist/lib/models/reflections/parameter.d.ts

@@ -1,10 +1,10 @@
-import { Type } from "../types";
+import type { SomeType } from "..";
 import { Reflection, TraverseCallback } from "./abstract";
 import type { SignatureReflection } from "./signature";
 export declare class ParameterReflection extends Reflection {
     parent?: SignatureReflection;
     defaultValue?: string;
-    type?: Type;
+    type?: SomeType;
     /**
      * Traverse all potential child reflections of this reflection.
      *

package/dist/lib/models/sources/repository.d.ts

@@ -1,4 +1,5 @@
 export declare enum RepositoryType {
     GitHub = "github",
-    Bitbucket = "bitbucket"
+    Bitbucket = "bitbucket",
+    GitLab = "gitlab"
 }

package/dist/lib/models/sources/repository.js

@@ -5,4 +5,5 @@ var RepositoryType;
 (function (RepositoryType) {
     RepositoryType["GitHub"] = "github";
     RepositoryType["Bitbucket"] = "bitbucket";
+    RepositoryType["GitLab"] = "gitlab";
 })(RepositoryType = exports.RepositoryType || (exports.RepositoryType = {}));

package/dist/lib/models/types.d.ts

@@ -354,9 +354,9 @@ export declare class TypeOperatorType extends Type {
  * ```
  */
 export declare class UnionType extends Type {
-    types: Type[];
+    types: SomeType[];
     readonly type = "union";
-    constructor(types: Type[]);
+    constructor(types: SomeType[]);
     toString(): string;
     private normalize;
 }

package/dist/lib/output/index.d.ts

@@ -2,6 +2,7 @@ export { PageEvent, RendererEvent, MarkdownEvent } from "./events";
 export { UrlMapping } from "./models/UrlMapping";
 export type { RenderTemplate } from "./models/UrlMapping";
 export { Renderer } from "./renderer";
+export type { RendererHooks } from "./renderer";
 export { Theme } from "./theme";
 export { DefaultTheme } from "./themes/default/DefaultTheme";
 export { DefaultThemeRenderContext } from "./themes/default/DefaultThemeRenderContext";

package/dist/lib/output/renderer.d.ts

@@ -12,7 +12,32 @@ import type { Theme } from "./theme";
 import type { ProjectReflection } from "../models/reflections/project";
 import { RendererComponent } from "./components";
 import { ChildableComponent } from "../utils/component";
+import { EventHooks } from "../utils";
 import type { Theme as ShikiTheme } from "shiki";
+import type { JsxElement } from "../utils/jsx.elements";
+import type { DefaultThemeRenderContext } from "./themes/default/DefaultThemeRenderContext";
+/**
+ * Describes the hooks available to inject output in the default theme.
+ * If the available hooks don't let you put something where you'd like, please open an issue!
+ */
+export interface RendererHooks {
+    /**
+     * Applied immediately after the opening `<head>` tag.
+     */
+    "head.begin": [DefaultThemeRenderContext];
+    /**
+     * Applied immediately before the closing `</head>` tag.
+     */
+    "head.end": [DefaultThemeRenderContext];
+    /**
+     * Applied immediately after the opening `<body>` tag.
+     */
+    "body.begin": [DefaultThemeRenderContext];
+    /**
+     * Applied immediately before the closing `</body>` tag.
+     */
+    "body.end": [DefaultThemeRenderContext];
+}
 /**
  * The renderer processes a {@link ProjectReflection} using a {@link Theme} instance and writes
  * the emitted html documents to a output directory. You can specify which theme should be used
@@ -56,6 +81,15 @@ export declare class Renderer extends ChildableComponent<Application, RendererCo
      * The theme that is used to render the documentation.
      */
     theme?: Theme;
+    /**
+     * Hooks which will be called when rendering pages.
+     * Note:
+     * - Hooks added during output will be discarded at the end of rendering.
+     * - Hooks added during a page render will be discarded at the end of that page's render.
+     *
+     * See {@link RendererHooks} for a description of each available hook, and when it will be called.
+     */
+    hooks: EventHooks<RendererHooks, JsxElement>;
     /** @internal */
     themeName: string;
     /** @internal */