typedoc 0.23.15 → 0.23.17

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

@@ -6,6 +6,7 @@ export declare class SourcePlugin extends ConverterComponent {
     readonly disableSources: boolean;
     readonly gitRevision: string;
     readonly gitRemote: string;
+    readonly sourceLinkTemplate: string;
     readonly basePath: string;
     /**
      * All file names to find the base path from.

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

@@ -100,10 +100,7 @@ let SourcePlugin = class SourcePlugin extends components_1.ConverterComponent {
             for (const source of refl.sources || []) {
                 if (repository_1.gitIsInstalled) {
                     const repo = this.getRepository(source.fullFileName);
-                    source.url = repo?.getURL(source.fullFileName);
-                    if (source.url) {
-                        source.url += `#${repo.getLineNumberAnchor(source.line)}`;
-                    }
+                    source.url = repo?.getURL(source.fullFileName, source.line);
                 }
                 source.fileName = (0, fs_1.normalizePath)((0, path_1.relative)(basePath, source.fullFileName));
             }
@@ -131,7 +128,7 @@ let SourcePlugin = class SourcePlugin extends components_1.ConverterComponent {
             }
         }
         // Try to create a new repository
-        const repository = repository_1.Repository.tryCreateRepository(dirName, this.gitRevision, this.gitRemote);
+        const repository = repository_1.Repository.tryCreateRepository(dirName, this.sourceLinkTemplate, this.gitRevision, this.gitRemote, this.application.logger);
         if (repository) {
             this.repositories[repository.path.toLowerCase()] = repository;
             return repository;
@@ -149,6 +146,9 @@ __decorate([
 __decorate([
     (0, utils_1.BindOption)("gitRemote")
 ], SourcePlugin.prototype, "gitRemote", void 0);
+__decorate([
+    (0, utils_1.BindOption)("sourceLinkTemplate")
+], SourcePlugin.prototype, "sourceLinkTemplate", void 0);
 __decorate([
     (0, utils_1.BindOption)("basePath")
 ], SourcePlugin.prototype, "basePath", void 0);

package/dist/lib/converter/symbols.js

@@ -512,9 +512,12 @@ function convertAccessor(context, symbol, exportSymbol) {
 function isInherited(context, symbol) {
     const parentSymbol = context.project.getSymbolFromReflection(context.scope);
     assert(parentSymbol, `No parent symbol found for ${symbol.name} in ${context.scope.name}`);
-    return (parentSymbol
-        .getDeclarations()
-        ?.some((d) => symbol.getDeclarations()?.some((d2) => d2.parent === d)) === false);
+    const parents = parentSymbol.declarations?.slice() || [];
+    const constructorDecls = parents.flatMap((parent) => ts.isClassDeclaration(parent)
+        ? parent.members.filter(ts.isConstructorDeclaration)
+        : []);
+    parents.push(...constructorDecls);
+    return (parents.some((d) => symbol.getDeclarations()?.some((d2) => d2.parent === d)) === false);
 }
 function setModifiers(symbol, declaration, reflection) {
     if (!declaration) {

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

@@ -1,64 +1,32 @@
-import { RepositoryType } from "../../models";
+import type { Logger } from "../../utils";
 export declare const gitIsInstalled: boolean;
 /**
  * Stores data of a repository.
  */
 export declare class Repository {
     /**
-     * The root path of this repository.
+     * The path of this repository on disk.
      */
     path: string;
     /**
-     * The name of the branch this repository is on right now.
+     * All files tracked by the repository.
      */
-    branch: string;
-    /**
-     * A list of all files tracked by the repository.
-     */
-    files: string[];
-    /**
-     * The user/organization name of this repository on GitHub.
-     */
-    user?: string;
-    /**
-     * The project name of this repository on GitHub.
-     */
-    project?: string;
-    /**
-     * The hostname for this GitHub/Bitbucket/.etc project.
-     *
-     * Defaults to: `github.com` (for normal, public GitHub instance projects)
-     *
-     * 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, Bitbucket, or other type of repository.
-     */
-    type: RepositoryType;
-    private urlCache;
+    files: Set<string>;
+    urlTemplate: string;
+    gitRevision: string;
     /**
      * Create a new Repository instance.
      *
      * @param path  The root path of the repository.
      */
-    constructor(path: string, gitRevision: string, repoLinks: string[]);
-    /**
-     * Check whether the given file is tracked by this repository.
-     *
-     * @param fileName  The name of the file to test for.
-     * @returns TRUE when the file is part of the repository, otherwise FALSE.
-     */
-    contains(fileName: string): boolean;
+    constructor(path: string, gitRevision: string, urlTemplate: string);
     /**
      * Get the URL of the given file on GitHub or Bitbucket.
      *
      * @param fileName  The file whose URL should be determined.
      * @returns A URL pointing to the web preview of the given file or undefined.
      */
-    getURL(fileName: string): string | undefined;
-    getLineNumberAnchor(lineNumber: number): string;
+    getURL(fileName: string, line: number): string | undefined;
     /**
      * Try to create a new repository instance.
      *
@@ -68,5 +36,6 @@ export declare class Repository {
      * @param path  The potential repository root.
      * @returns A new instance of {@link Repository} or undefined.
      */
-    static tryCreateRepository(path: string, gitRevision: string, gitRemote: string): Repository | undefined;
+    static tryCreateRepository(path: string, sourceLinkTemplate: string, gitRevision: string, gitRemote: string, logger: Logger): Repository | undefined;
 }
+export declare function guessSourceUrlTemplate(remotes: string[]): string | undefined;

package/dist/lib/converter/utils/repository.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Repository = exports.gitIsInstalled = void 0;
+exports.guessSourceUrlTemplate = exports.Repository = exports.gitIsInstalled = void 0;
 const child_process_1 = require("child_process");
-const models_1 = require("../../models");
 const base_path_1 = require("../utils/base-path");
 const TEN_MEGABYTES = 1024 * 10000;
 function git(...args) {
@@ -22,89 +21,22 @@ class Repository {
      *
      * @param path  The root path of the repository.
      */
-    constructor(path, gitRevision, repoLinks) {
+    constructor(path, gitRevision, urlTemplate) {
         /**
-         * A list of all files tracked by the repository.
+         * All files tracked by the repository.
          */
-        this.files = [];
-        /**
-         * The hostname for this GitHub/Bitbucket/.etc project.
-         *
-         * Defaults to: `github.com` (for normal, public GitHub instance projects)
-         *
-         * 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, Bitbucket, or other type of repository.
-         */
-        this.type = models_1.RepositoryType.GitHub;
-        this.urlCache = new Map();
+        this.files = new Set();
         this.path = path;
-        this.branch = gitRevision || "master";
-        for (let i = 0, c = repoLinks.length; i < c; i++) {
-            let match = /(github(?!.us)(?:\.[a-z]+)*\.[a-z]{2,})[:/]([^/]+)\/(.*)/.exec(repoLinks[i]);
-            // Github Enterprise
-            if (!match) {
-                match = /(\w+\.githubprivate.com)[:/]([^/]+)\/(.*)/.exec(repoLinks[i]);
-            }
-            // Github Enterprise
-            if (!match) {
-                match = /(\w+\.ghe.com)[:/]([^/]+)\/(.*)/.exec(repoLinks[i]);
-            }
-            // Github Enterprise
-            if (!match) {
-                match = /(\w+\.github.us)[:/]([^/]+)\/(.*)/.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];
-                this.project = match[3];
-                if (this.project.endsWith(".git")) {
-                    this.project = this.project.slice(0, -4);
-                }
-                break;
-            }
-        }
-        if (this.hostname.includes("bitbucket.org")) {
-            this.type = models_1.RepositoryType.Bitbucket;
-        }
-        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");
+        this.gitRevision = gitRevision;
+        this.urlTemplate = urlTemplate;
+        const out = git("-C", path, "ls-files");
         if (out.status === 0) {
             out.stdout.split("\n").forEach((file) => {
                 if (file !== "") {
-                    this.files.push(base_path_1.BasePath.normalize(path + "/" + file));
+                    this.files.add(base_path_1.BasePath.normalize(path + "/" + file));
                 }
             });
         }
-        if (!gitRevision) {
-            out = git("-C", path, "rev-parse", "--short", "HEAD");
-            if (out.status === 0) {
-                this.branch = out.stdout.replace("\n", "");
-            }
-        }
-    }
-    /**
-     * Check whether the given file is tracked by this repository.
-     *
-     * @param fileName  The name of the file to test for.
-     * @returns TRUE when the file is part of the repository, otherwise FALSE.
-     */
-    contains(fileName) {
-        return this.files.includes(fileName);
     }
     /**
      * Get the URL of the given file on GitHub or Bitbucket.
@@ -112,36 +44,16 @@ class Repository {
      * @param fileName  The file whose URL should be determined.
      * @returns A URL pointing to the web preview of the given file or undefined.
      */
-    getURL(fileName) {
-        if (this.urlCache.has(fileName)) {
-            return this.urlCache.get(fileName);
-        }
-        if (!this.user || !this.project || !this.contains(fileName)) {
+    getURL(fileName, line) {
+        if (!this.files.has(fileName)) {
             return;
         }
-        const url = [
-            `https://${this.hostname}`,
-            this.user,
-            this.project,
-            this.type === models_1.RepositoryType.GitLab ? "-" : undefined,
-            this.type === models_1.RepositoryType.Bitbucket ? "src" : "blob",
-            this.branch,
-            fileName.substring(this.path.length + 1),
-        ]
-            .filter((s) => !!s)
-            .join("/");
-        this.urlCache.set(fileName, url);
-        return url;
-    }
-    getLineNumberAnchor(lineNumber) {
-        switch (this.type) {
-            default:
-            case models_1.RepositoryType.GitHub:
-            case models_1.RepositoryType.GitLab:
-                return "L" + lineNumber;
-            case models_1.RepositoryType.Bitbucket:
-                return "lines-" + lineNumber;
-        }
+        const replacements = {
+            gitRevision: this.gitRevision,
+            path: fileName.substring(this.path.length + 1),
+            line,
+        };
+        return this.urlTemplate.replace(/\{(gitRevision|path|line)\}/g, (_, key) => replacements[key]);
     }
     /**
      * Try to create a new repository instance.
@@ -152,13 +64,77 @@ class Repository {
      * @param path  The potential repository root.
      * @returns A new instance of {@link Repository} or undefined.
      */
-    static tryCreateRepository(path, gitRevision, gitRemote) {
-        const out = git("-C", path, "rev-parse", "--show-toplevel");
-        const remotesOutput = git("-C", path, "remote", "get-url", gitRemote);
-        if (out.status !== 0 || remotesOutput.status !== 0) {
+    static tryCreateRepository(path, sourceLinkTemplate, gitRevision, gitRemote, logger) {
+        const topLevel = git("-C", path, "rev-parse", "--show-toplevel");
+        if (topLevel.status !== 0)
             return;
+        gitRevision || (gitRevision = git("-C", path, "rev-parse", "--short", "HEAD").stdout.trim());
+        if (!gitRevision)
+            return; // Will only happen in a repo with no commits.
+        let urlTemplate;
+        if (sourceLinkTemplate) {
+            urlTemplate = sourceLinkTemplate;
+        }
+        else if (/^https?:\/\//.test(gitRemote)) {
+            logger.warn("Using a link as the gitRemote is deprecated and will be removed in 0.24.");
+            urlTemplate = `${gitRemote}/{gitRevision}`;
+        }
+        else {
+            const remotesOut = git("-C", path, "remote", "get-url", gitRemote);
+            if (remotesOut.status === 0) {
+                urlTemplate = guessSourceUrlTemplate(remotesOut.stdout.split("\n"));
+            }
+            else {
+                logger.warn(`The provided git remote "${gitRemote}" was not valid. Source links will be broken.`);
+            }
         }
-        return new Repository(base_path_1.BasePath.normalize(out.stdout.replace("\n", "")), gitRevision, remotesOutput.stdout.split("\n"));
+        if (!urlTemplate)
+            return;
+        return new Repository(base_path_1.BasePath.normalize(topLevel.stdout.replace("\n", "")), gitRevision, urlTemplate);
     }
 }
 exports.Repository = Repository;
+// Should have three capturing groups:
+// 1. hostname
+// 2. user
+// 3. project
+const repoExpressions = [
+    /(github(?!.us)(?:\.[a-z]+)*\.[a-z]{2,})[:/]([^/]+)\/(.*)/,
+    /(\w+\.githubprivate.com)[:/]([^/]+)\/(.*)/,
+    /(\w+\.ghe.com)[:/]([^/]+)\/(.*)/,
+    /(\w+\.github.us)[:/]([^/]+)\/(.*)/,
+    /(bitbucket.org)[:/]([^/]+)\/(.*)/,
+    /(gitlab.com)[:/]([^/]+)\/(.*)/,
+];
+function guessSourceUrlTemplate(remotes) {
+    let hostname = "";
+    let user = "";
+    let project = "";
+    outer: for (const repoLink of remotes) {
+        for (const regex of repoExpressions) {
+            const match = regex.exec(repoLink);
+            if (match) {
+                hostname = match[1];
+                user = match[2];
+                project = match[3];
+                break outer;
+            }
+        }
+    }
+    if (!hostname)
+        return;
+    if (project.endsWith(".git")) {
+        project = project.slice(0, -4);
+    }
+    let sourcePath = "blob";
+    let anchorPrefix = "L";
+    if (hostname.includes("gitlab")) {
+        sourcePath = "-/blob";
+    }
+    else if (hostname.includes("bitbucket")) {
+        sourcePath = "src";
+        anchorPrefix = "lines-";
+    }
+    return `https://${hostname}/${user}/${project}/${sourcePath}/{gitRevision}/{path}#${anchorPrefix}{line}`;
+}
+exports.guessSourceUrlTemplate = guessSourceUrlTemplate;

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

@@ -1,2 +1 @@
 export { SourceReference } from "./file";
-export { RepositoryType } from "./repository";

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

@@ -1,7 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RepositoryType = exports.SourceReference = void 0;
+exports.SourceReference = void 0;
 var file_1 = require("./file");
 Object.defineProperty(exports, "SourceReference", { enumerable: true, get: function () { return file_1.SourceReference; } });
-var repository_1 = require("./repository");
-Object.defineProperty(exports, "RepositoryType", { enumerable: true, get: function () { return repository_1.RepositoryType; } });

package/dist/lib/output/renderer.js

@@ -26,6 +26,7 @@ const utils_1 = require("../utils");
 const highlighter_1 = require("../utils/highlighter");
 const models_1 = require("../models");
 const icon_1 = require("./themes/default/partials/icon");
+const type_1 = require("./themes/default/partials/type");
 /**
  * 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
@@ -132,6 +133,7 @@ let Renderer = class Renderer extends component_1.ChildableComponent {
             output.urls.forEach((mapping) => {
                 (0, icon_1.clearSeenIconCache)();
                 this.renderDocument(output.createPageEvent(mapping));
+                (0, type_1.validateStateIsClean)(mapping.url);
             });
             this.trigger(events_1.RendererEvent.END, output);
         }

package/dist/lib/output/themes/default/DefaultThemeRenderContext.d.ts

@@ -44,6 +44,7 @@ export declare class DefaultThemeRenderContext {
     members: (props: import("../../../models").ContainerReflection) => import("../../../utils/jsx.elements").JsxElement;
     membersGroup: (group: import("../../../models").ReflectionGroup) => import("../../../utils/jsx.elements").JsxElement;
     navigation: (props: import("../..").PageEvent<Reflection>) => import("../../../utils/jsx.elements").JsxElement;
+    sidebarLinks: () => import("../../../utils/jsx.elements").JsxElement | null;
     settings: () => import("../../../utils/jsx.elements").JsxElement;
     primaryNavigation: (props: import("../..").PageEvent<Reflection>) => import("../../../utils/jsx.elements").JsxElement;
     secondaryNavigation: (props: import("../..").PageEvent<Reflection>) => import("../../../utils/jsx.elements").JsxElement | undefined;

package/dist/lib/output/themes/default/DefaultThemeRenderContext.js

@@ -77,6 +77,7 @@ class DefaultThemeRenderContext {
         this.members = bind(members_1.members, this);
         this.membersGroup = bind(members_group_1.membersGroup, this);
         this.navigation = bind(navigation_1.navigation, this);
+        this.sidebarLinks = bind(navigation_1.sidebarLinks, this);
         this.settings = bind(navigation_1.settings, this);
         this.primaryNavigation = bind(navigation_1.primaryNavigation, this);
         this.secondaryNavigation = bind(navigation_1.secondaryNavigation, this);

package/dist/lib/output/themes/default/partials/navigation.d.ts

@@ -3,6 +3,7 @@ import { JSX } from "../../../../utils";
 import type { PageEvent } from "../../../events";
 import type { DefaultThemeRenderContext } from "../DefaultThemeRenderContext";
 export declare function navigation(context: DefaultThemeRenderContext, props: PageEvent<Reflection>): JSX.Element;
+export declare function sidebarLinks(context: DefaultThemeRenderContext): JSX.Element | null;
 export declare function settings(context: DefaultThemeRenderContext): JSX.Element;
 export declare function primaryNavigation(context: DefaultThemeRenderContext, props: PageEvent<Reflection>): JSX.Element;
 export declare function secondaryNavigation(context: DefaultThemeRenderContext, props: PageEvent<Reflection>): JSX.Element | undefined;

package/dist/lib/output/themes/default/partials/navigation.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.secondaryNavigation = exports.primaryNavigation = exports.settings = exports.navigation = void 0;
+exports.secondaryNavigation = exports.primaryNavigation = exports.settings = exports.sidebarLinks = exports.navigation = void 0;
 const models_1 = require("../../../../models");
 const utils_1 = require("../../../../utils");
 const lib_1 = require("../../lib");
 function navigation(context, props) {
     return (utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
+        context.sidebarLinks(),
         context.settings(),
         context.primaryNavigation(props),
         context.secondaryNavigation(props)));
@@ -18,6 +19,13 @@ function buildFilterItem(context, name, displayName, defaultValue) {
             context.icons.checkbox(),
             utils_1.JSX.createElement("span", null, displayName))));
 }
+function sidebarLinks(context) {
+    const links = Object.entries(context.options.getValue("sidebarLinks"));
+    if (!links.length)
+        return null;
+    return (utils_1.JSX.createElement("nav", { id: "tsd-sidebar-links", class: "tsd-navigation" }, links.map(([label, url]) => (utils_1.JSX.createElement("a", { href: url, target: "_blank" }, label)))));
+}
+exports.sidebarLinks = sidebarLinks;
 function settings(context) {
     const defaultFilters = context.options.getValue("visibilityFilters");
     const visibilityOptions = [];

package/dist/lib/output/themes/default/partials/toolbar.js

@@ -6,12 +6,14 @@ const toolbar = (context, props) => (utils_1.JSX.createElement("header", { class
     utils_1.JSX.createElement("div", { class: "tsd-toolbar-contents container" },
         utils_1.JSX.createElement("div", { class: "table-cell", id: "tsd-search", "data-base": context.relativeURL("./") },
             utils_1.JSX.createElement("div", { class: "field" },
-                utils_1.JSX.createElement("label", { for: "tsd-search-field", class: "tsd-widget search no-caption" }, context.icons.search()),
+                utils_1.JSX.createElement("label", { for: "tsd-search-field", class: "tsd-widget tsd-toolbar-icon search no-caption" }, context.icons.search()),
                 utils_1.JSX.createElement("input", { type: "text", id: "tsd-search-field", "aria-label": "Search" })),
+            utils_1.JSX.createElement("div", { class: "field" },
+                utils_1.JSX.createElement("div", { id: "tsd-toolbar-links" }, Object.entries(context.options.getValue("navigationLinks")).map(([label, url]) => (utils_1.JSX.createElement("a", { href: url }, label))))),
             utils_1.JSX.createElement("ul", { class: "results" },
                 utils_1.JSX.createElement("li", { class: "state loading" }, "Preparing search index..."),
                 utils_1.JSX.createElement("li", { class: "state failure" }, "The search index is not available")),
-            utils_1.JSX.createElement("a", { href: context.relativeURL("index.html"), class: "title" }, props.project.name)),
+            utils_1.JSX.createElement("a", { href: context.options.getValue("titleLink") ?? context.relativeURL("index.html"), class: "title" }, props.project.name)),
         utils_1.JSX.createElement("div", { class: "table-cell", id: "tsd-widgets" },
-            utils_1.JSX.createElement("a", { href: "#", class: "tsd-widget menu no-caption", "data-toggle": "menu", "aria-label": "Menu" }, context.icons.menu())))));
+            utils_1.JSX.createElement("a", { href: "#", class: "tsd-widget tsd-toolbar-icon menu no-caption", "data-toggle": "menu", "aria-label": "Menu" }, context.icons.menu())))));
 exports.toolbar = toolbar;

package/dist/lib/output/themes/default/partials/type.d.ts

@@ -1,4 +1,5 @@
 import type { DefaultThemeRenderContext } from "../DefaultThemeRenderContext";
 import { Type } from "../../../../models";
 import { JSX } from "../../../../utils";
+export declare function validateStateIsClean(page: string): void;
 export declare function type(context: DefaultThemeRenderContext, type: Type | undefined): JSX.Element;

package/dist/lib/output/themes/default/partials/type.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.type = void 0;
+exports.type = exports.validateStateIsClean = void 0;
 const models_1 = require("../../../../models");
 const utils_1 = require("../../../../utils");
 const lib_1 = require("../../lib");
+const assert_1 = require("assert");
 const EXPORTABLE = models_1.ReflectionKind.Class |
     models_1.ReflectionKind.Interface |
     models_1.ReflectionKind.Enum |
@@ -51,6 +52,14 @@ function getNamespacedPath(reflection) {
 function renderUniquePath(context, reflection) {
     return (0, lib_1.join)(utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "."), getUniquePath(reflection), (item) => (utils_1.JSX.createElement("a", { href: context.urlTo(item), class: "tsd-signature-type", "data-tsd-kind": item.kindString }, item.name)));
 }
+let indentationDepth = 0;
+function includeIndentation() {
+    return indentationDepth > 0 ? utils_1.JSX.createElement("span", null, "\u00A0".repeat(indentationDepth * 4)) : utils_1.JSX.createElement(utils_1.JSX.Fragment, null);
+}
+function validateStateIsClean(page) {
+    (0, assert_1.ok)(indentationDepth === 0, `Rendering ${page}: Indentation depth increment/decrement not matched: ${indentationDepth}`);
+}
+exports.validateStateIsClean = validateStateIsClean;
 // The type helper accepts an optional needsParens parameter that is checked
 // if an inner type may result in invalid output without them. For example:
 // 1 | 2[] !== (1 | 2)[]
@@ -192,7 +201,9 @@ const typeRenderers = {
     },
     reflection(context, type) {
         const members = [];
-        for (const item of type.declaration.children || []) {
+        const children = type.declaration.children || [];
+        indentationDepth++;
+        for (const item of children) {
             if (item.getSignature && item.setSignature) {
                 members.push(utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
                     item.name,
@@ -237,6 +248,7 @@ const typeRenderers = {
                 renderType(context, index.type, models_1.TypeContext.none)));
         }
         if (!members.length && type.declaration.signatures?.length === 1) {
+            indentationDepth--;
             return (utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
                 utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "("),
                 context.memberSignatureTitle(type.declaration.signatures[0], {
@@ -249,17 +261,25 @@ const typeRenderers = {
             members.push(context.memberSignatureTitle(item, { hideName: true }));
         }
         if (members.length) {
-            const membersWithSeparators = members.flatMap((m) => [m, utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "; ")]);
+            const membersWithSeparators = members.flatMap((m) => [
+                includeIndentation(),
+                m,
+                utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "; "),
+                utils_1.JSX.createElement("br", null),
+            ]);
             membersWithSeparators.pop();
+            indentationDepth--;
             return (utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
                 utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" },
                     "{",
                     " "),
+                utils_1.JSX.createElement("br", null),
                 membersWithSeparators,
-                utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" },
-                    " ",
-                    "}")));
+                utils_1.JSX.createElement("br", null),
+                includeIndentation(),
+                utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "}")));
         }
+        indentationDepth--;
         return utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "{}");
     },
     rest(context, type) {

package/dist/lib/utils/entry-point.js

@@ -234,7 +234,7 @@ function getEntryPointsForPackages(logger, packageGlobPaths, options) {
         if (packageEntryPoint === package_manifest_1.ignorePackage) {
             continue;
         }
-        const tsconfigFile = ts.findConfigFile(packageEntryPoint, ts.sys.fileExists);
+        const tsconfigFile = ts.findConfigFile(packageEntryPoint, ts.sys.fileExists, typedocPackageConfig?.tsconfig);
         if (tsconfigFile === undefined) {
             logger.error(`Could not determine tsconfig.json for source file ${packageEntryPoint} (it must be on an ancestor path)`);
             return;
@@ -274,12 +274,24 @@ function getEntryPointsForPackages(logger, packageGlobPaths, options) {
             version: includeVersion
                 ? packageJson["version"]
                 : void 0,
-            readmeFile: typedocPackageConfig?.readmeFile
-                ? Path.resolve(Path.join(packageJsonPath, "..", typedocPackageConfig?.readmeFile))
-                : undefined,
+            readmeFile: discoverReadmeFile(logger, Path.join(packageJsonPath, ".."), typedocPackageConfig?.readmeFile),
             program,
             sourceFile,
         });
     }
     return results;
 }
+function discoverReadmeFile(logger, packageDir, userReadme) {
+    if (userReadme) {
+        if (!FS.existsSync(Path.join(packageDir, userReadme))) {
+            logger.warn(`Failed to find ${userReadme} in ${(0, paths_1.nicePath)(packageDir)}`);
+            return;
+        }
+        return Path.resolve(Path.join(packageDir, userReadme));
+    }
+    for (const file of FS.readdirSync(packageDir)) {
+        if (file.toLowerCase() === "readme.md") {
+            return Path.resolve(Path.join(packageDir, file));
+        }
+    }
+}

package/dist/lib/utils/options/declaration.d.ts

@@ -74,6 +74,7 @@ export interface TypeDocOptionMap {
     excludeTags: `@${string}`[];
     readme: string;
     cname: string;
+    sourceLinkTemplate: string;
     gitRevision: string;
     gitRemote: string;
     htmlLang: string;
@@ -82,6 +83,9 @@ export interface TypeDocOptionMap {
     hideGenerator: boolean;
     searchInComments: boolean;
     cleanOutputDir: boolean;
+    titleLink: string;
+    navigationLinks: ManuallyValidatedOption<Record<string, string>>;
+    sidebarLinks: ManuallyValidatedOption<Record<string, string>>;
     commentStyle: typeof CommentStyle;
     blockTags: `@${string}`[];
     inlineTags: `@${string}`[];

package/dist/lib/utils/options/sources/typedoc.js

@@ -235,6 +235,10 @@ function addTypeDocOptions(options) {
         name: "cname",
         help: "Set the CNAME file text, it's useful for custom domains on GitHub Pages.",
     });
+    options.addDeclaration({
+        name: "sourceLinkTemplate",
+        help: "Specify a link template to be used when generating source urls. If not set, will be automatically created using the git remote. Supports {path}, {line}, {gitRevision} placeholders.",
+    });
     options.addDeclaration({
         name: "gitRevision",
         help: "Use specified revision instead of the last revision for linking to GitHub/Bitbucket source files.",
@@ -276,6 +280,39 @@ function addTypeDocOptions(options) {
         type: declaration_1.ParameterType.Boolean,
         defaultValue: true,
     });
+    options.addDeclaration({
+        name: "titleLink",
+        help: "Set the link the title in the header points to. Defaults to the documentation homepage.",
+        type: declaration_1.ParameterType.String,
+    });
+    options.addDeclaration({
+        name: "navigationLinks",
+        help: "Defines links to be included in the header.",
+        type: declaration_1.ParameterType.Mixed,
+        defaultValue: {},
+        validate(value) {
+            if (!isObject(value)) {
+                throw new Error(`navigationLinks must be an object with string labels as keys and URL values.`);
+            }
+            if (Object.values(value).some((x) => typeof x !== "string")) {
+                throw new Error(`All values of navigationLinks must be string URLs.`);
+            }
+        },
+    });
+    options.addDeclaration({
+        name: "sidebarLinks",
+        help: "Defines links to be included in the sidebar.",
+        type: declaration_1.ParameterType.Mixed,
+        defaultValue: {},
+        validate(value) {
+            if (!isObject(value)) {
+                throw new Error(`sidebarLinks must be an object with string labels as keys and URL values.`);
+            }
+            if (Object.values(value).some((x) => typeof x !== "string")) {
+                throw new Error(`All values of sidebarLinks must be string URLs.`);
+            }
+        },
+    });
     ///////////////////////////
     ///// Comment Options /////
     ///////////////////////////

package/dist/lib/utils/package-manifest.d.ts

@@ -9,6 +9,7 @@ declare const typedocPackageManifestConfigSchema: {
     displayName: import("./validation").Optional<StringConstructor>;
     entryPoint: import("./validation").Optional<StringConstructor>;
     readmeFile: import("./validation").Optional<StringConstructor>;
+    tsconfig: import("./validation").Optional<StringConstructor>;
     [additionalProperties]: boolean;
 };
 export declare type TypedocPackageManifestConfig = Infer<typeof typedocPackageManifestConfigSchema>;

package/dist/lib/utils/package-manifest.js

@@ -32,6 +32,7 @@ const typedocPackageManifestConfigSchema = {
     displayName: (0, validation_1.optional)(String),
     entryPoint: (0, validation_1.optional)(String),
     readmeFile: (0, validation_1.optional)(String),
+    tsconfig: (0, validation_1.optional)(String),
     [validation_1.additionalProperties]: false,
 };
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "typedoc",
   "description": "Create api documentation for TypeScript projects.",
-  "version": "0.23.15",
+  "version": "0.23.17",
   "homepage": "https://typedoc.org",
   "main": "./dist/index.js",
   "exports": {

package/static/style.css

@@ -825,6 +825,15 @@ input[type="checkbox"]:checked ~ svg .tsd-checkbox-checkmark {
     padding-left: 5.5rem;
 }
 
+#tsd-sidebar-links a {
+    margin-top: 0;
+    margin-bottom: 0.5rem;
+    line-height: 1.25rem;
+}
+#tsd-sidebar-links a:last-of-type {
+    margin-bottom: 0;
+}
+
 a.tsd-index-link {
     margin: 0.25rem 0;
     font-size: 1rem;
@@ -978,7 +987,8 @@ a.tsd-index-link {
     right: -40px;
 }
 #tsd-search .field input,
-#tsd-search .title {
+#tsd-search .title,
+#tsd-toolbar-links a {
     transition: opacity 0.2s;
 }
 #tsd-search .results {
@@ -1022,7 +1032,8 @@ a.tsd-index-link {
     top: 0;
     opacity: 1;
 }
-#tsd-search.has-focus .title {
+#tsd-search.has-focus .title,
+#tsd-search.has-focus #tsd-toolbar-links a {
     z-index: 0;
     opacity: 0;
 }
@@ -1036,6 +1047,22 @@ a.tsd-index-link {
     display: block;
 }
 
+#tsd-toolbar-links {
+    position: absolute;
+    top: 0;
+    right: 2rem;
+    height: 100%;
+    display: flex;
+    align-items: center;
+    justify-content: flex-end;
+}
+#tsd-toolbar-links a {
+    margin-left: 1.5rem;
+}
+#tsd-toolbar-links a:hover {
+    text-decoration: underline;
+}
+
 .tsd-signature {
     margin: 0 0 1rem 0;
     padding: 1rem 0.5rem;
@@ -1134,6 +1161,11 @@ ul.tsd-type-parameter-list h5 {
 .tsd-page-toolbar .table-cell:first-child {
     width: 100%;
 }
+.tsd-page-toolbar .tsd-toolbar-icon {
+    box-sizing: border-box;
+    line-height: 0;
+    padding: 12px 0;
+}
 
 .tsd-page-toolbar--hide {
     transform: translateY(-100%);

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

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

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

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RepositoryType = void 0;
-var RepositoryType;
-(function (RepositoryType) {
-    RepositoryType["GitHub"] = "github";
-    RepositoryType["Bitbucket"] = "bitbucket";
-    RepositoryType["GitLab"] = "gitlab";
-})(RepositoryType = exports.RepositoryType || (exports.RepositoryType = {}));