typedoc 0.23.7 → 0.23.10

package/dist/lib/converter/comments/discovery.js

@@ -39,6 +39,9 @@ const wantedKinds = {
     [models_1.ReflectionKind.Function]: [
         ts.SyntaxKind.FunctionDeclaration,
         ts.SyntaxKind.BindingElement,
+        ts.SyntaxKind.VariableDeclaration,
+        ts.SyntaxKind.ExportAssignment,
+        ts.SyntaxKind.PropertyAccessExpression,
     ],
     [models_1.ReflectionKind.Class]: [
         ts.SyntaxKind.ClassDeclaration,
@@ -51,6 +54,8 @@ const wantedKinds = {
         ts.SyntaxKind.PropertySignature,
         ts.SyntaxKind.BinaryExpression,
         ts.SyntaxKind.PropertyAssignment,
+        // class X { constructor(/** Comment */ readonly z: any) }
+        ts.SyntaxKind.Parameter,
     ],
     [models_1.ReflectionKind.Method]: [
         ts.SyntaxKind.FunctionDeclaration,
@@ -98,8 +103,12 @@ function discoverComment(symbol, kind, logger, commentStyle) {
             // However, we don't want to skip the node if it is a reference to something.
             // See the gh1770 test for an example.
             if (kind & models_1.ReflectionKind.ContainsCallSignatures &&
-                !node.body &&
-                node.kind !== ts.SyntaxKind.BindingElement) {
+                [
+                    ts.SyntaxKind.FunctionDeclaration,
+                    ts.SyntaxKind.MethodDeclaration,
+                    ts.SyntaxKind.Constructor,
+                ].includes(node.kind) &&
+                !node.body) {
                 continue;
             }
             const comments = collectCommentRanges(ts.getLeadingCommentRanges(text, node.pos));

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

@@ -8,6 +8,13 @@ const blockLexer_1 = require("./blockLexer");
 const discovery_1 = require("./discovery");
 const lineLexer_1 = require("./lineLexer");
 const parser_1 = require("./parser");
+const jsDocCommentKinds = [
+    ts.SyntaxKind.JSDocPropertyTag,
+    ts.SyntaxKind.JSDocCallbackTag,
+    ts.SyntaxKind.JSDocTypedefTag,
+    ts.SyntaxKind.JSDocTemplateTag,
+    ts.SyntaxKind.JSDocEnumTag,
+];
 const commentCache = new WeakMap();
 function getCommentWithCache(discovered, config, logger) {
     if (!discovered)
@@ -52,6 +59,11 @@ function getCommentImpl(commentSource, config, logger, moduleComment) {
     return comment;
 }
 function getComment(symbol, kind, config, logger, commentStyle) {
+    if (symbol
+        .getDeclarations()
+        ?.every((d) => jsDocCommentKinds.includes(d.kind))) {
+        return getJsDocComment(symbol.declarations[0], config, logger);
+    }
     return getCommentImpl((0, discovery_1.discoverComment)(symbol, kind, logger, commentStyle), config, logger, symbol.declarations?.some(ts.isSourceFile) || false);
 }
 exports.getComment = getComment;
@@ -106,7 +118,7 @@ function getJsDocComment(declaration, config, logger) {
         logger.error(`Failed to find JSDoc tag for ${name} after parsing comment, please file a bug report.`, declaration);
     }
     else {
-        return new models_1.Comment(tag.content.slice());
+        return new models_1.Comment(models_1.Comment.cloneDisplayParts(tag.content));
     }
 }
 exports.getJsDocComment = getJsDocComment;

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

@@ -0,0 +1,4 @@
+import { Comment, CommentDisplayPart, Reflection } from "../../models";
+import type { Logger, ValidationOptions } from "../../utils";
+export declare function resolveLinks(comment: Comment, reflection: Reflection, validation: ValidationOptions, logger: Logger): void;
+export declare function resolvePartLinks(reflection: Reflection, parts: readonly CommentDisplayPart[], warn: () => void, validation: ValidationOptions, logger: Logger): CommentDisplayPart[];

package/dist/lib/converter/comments/linkResolver.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePartLinks = exports.resolveLinks = void 0;
+const ts = require("typescript");
+const models_1 = require("../../models");
+const declarationReference_1 = require("./declarationReference");
+const declarationReferenceResolver_1 = require("./declarationReferenceResolver");
+const urlPrefix = /^(http|ftp)s?:\/\//;
+const brackets = /\[\[(?!include:)([^\]]+)\]\]/g;
+function resolveLinks(comment, reflection, validation, logger) {
+    let warned = false;
+    const warn = () => {
+        if (!warned) {
+            warned = true;
+            logger.warn(`${reflection.getFriendlyFullName()}: Comment [[target]] style links are deprecated and will be removed in 0.24`);
+        }
+    };
+    comment.summary = resolvePartLinks(reflection, comment.summary, warn, validation, logger);
+    for (const tag of comment.blockTags) {
+        tag.content = resolvePartLinks(reflection, tag.content, warn, validation, logger);
+    }
+    if (reflection instanceof models_1.DeclarationReflection && reflection.readme) {
+        reflection.readme = resolvePartLinks(reflection, reflection.readme, warn, validation, logger);
+    }
+}
+exports.resolveLinks = resolveLinks;
+function resolvePartLinks(reflection, parts, warn, validation, logger) {
+    return parts.flatMap((part) => processPart(reflection, part, warn, validation, logger));
+}
+exports.resolvePartLinks = resolvePartLinks;
+function processPart(reflection, part, warn, validation, logger) {
+    if (part.kind === "text" && brackets.test(part.text)) {
+        warn();
+        return replaceBrackets(reflection, part.text, validation, logger);
+    }
+    if (part.kind === "inline-tag") {
+        if (part.tag === "@link" ||
+            part.tag === "@linkcode" ||
+            part.tag === "@linkplain") {
+            return resolveLinkTag(reflection, part, (msg) => {
+                if (validation.invalidLink) {
+                    logger.warn(msg);
+                }
+            });
+        }
+    }
+    return part;
+}
+function resolveLinkTag(reflection, part, warn) {
+    let pos = 0;
+    const end = part.text.length;
+    while (pos < end && ts.isWhiteSpaceLike(part.text.charCodeAt(pos))) {
+        pos++;
+    }
+    const origText = part.text;
+    // Try to parse one
+    const declRef = (0, declarationReference_1.parseDeclarationReference)(part.text, pos, end);
+    let target;
+    if (declRef) {
+        // Got one, great! Try to resolve the link
+        target = (0, declarationReferenceResolver_1.resolveDeclarationReference)(reflection, declRef[0]);
+        pos = declRef[1];
+    }
+    if (!target) {
+        if (urlPrefix.test(part.text)) {
+            const wsIndex = part.text.search(/\s/);
+            target =
+                wsIndex === -1 ? part.text : part.text.substring(0, wsIndex);
+            pos = target.length;
+        }
+    }
+    // If resolution via a declaration reference failed, revert to the legacy "split and check"
+    // method... this should go away in 0.24, once people have had a chance to migrate any failing links.
+    if (!target) {
+        const resolved = legacyResolveLinkTag(reflection, part);
+        if (resolved) {
+            warn(`Failed to resolve {@link ${origText}} in ${reflection.getFriendlyFullName()} with declaration references. This link will break in v0.24.`);
+        }
+        return resolved;
+    }
+    // Remaining text after an optional pipe is the link text, so advance
+    // until that's consumed.
+    while (pos < end && ts.isWhiteSpaceLike(part.text.charCodeAt(pos))) {
+        pos++;
+    }
+    if (pos < end && part.text[pos] === "|") {
+        pos++;
+    }
+    part.target = target;
+    part.text =
+        part.text.substring(pos).trim() ||
+            (typeof target === "string" ? target : target.name);
+    return part;
+}
+function legacyResolveLinkTag(reflection, part) {
+    const { caption, target } = splitLinkText(part.text);
+    if (urlPrefix.test(target)) {
+        part.text = caption;
+        part.target = target;
+    }
+    else {
+        const targetRefl = reflection.findReflectionByName(target);
+        if (targetRefl) {
+            part.text = caption;
+            part.target = targetRefl;
+        }
+    }
+    return part;
+}
+function replaceBrackets(reflection, text, validation, logger) {
+    const parts = [];
+    let begin = 0;
+    brackets.lastIndex = 0;
+    for (const match of text.matchAll(brackets)) {
+        if (begin != match.index) {
+            parts.push({
+                kind: "text",
+                text: text.substring(begin, match.index),
+            });
+        }
+        begin = match.index + match[0].length;
+        const content = match[1];
+        const { target, caption } = splitLinkText(content);
+        if (urlPrefix.test(target)) {
+            parts.push({
+                kind: "inline-tag",
+                tag: "@link",
+                text: caption,
+                target,
+            });
+        }
+        else {
+            const targetRefl = reflection.findReflectionByName(target);
+            if (targetRefl) {
+                parts.push({
+                    kind: "inline-tag",
+                    tag: "@link",
+                    text: caption,
+                    target: targetRefl,
+                });
+            }
+            else {
+                if (validation.invalidLink) {
+                    logger.warn("Failed to find target: " + content);
+                }
+                parts.push({
+                    kind: "inline-tag",
+                    tag: "@link",
+                    text: content,
+                });
+            }
+        }
+    }
+    parts.push({
+        kind: "text",
+        text: text.substring(begin),
+    });
+    return parts;
+}
+/**
+ * Split the given link into text and target at first pipe or space.
+ *
+ * @param text  The source string that should be checked for a split character.
+ * @returns An object containing the link text and target.
+ */
+function splitLinkText(text) {
+    let splitIndex = text.indexOf("|");
+    if (splitIndex === -1) {
+        splitIndex = text.search(/\s/);
+    }
+    if (splitIndex !== -1) {
+        return {
+            caption: text
+                .substring(splitIndex + 1)
+                .replace(/\n+/, " ")
+                .trim(),
+            target: text.substring(0, splitIndex).trim(),
+        };
+    }
+    else {
+        return {
+            caption: text,
+            target: text,
+        };
+    }
+}

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

@@ -1,12 +1,13 @@
 import * as ts from "typescript";
 import type { Application } from "../application";
-import { ProjectReflection, SomeType } from "../models/index";
+import { Comment, CommentDisplayPart, ProjectReflection, Reflection, SomeType } from "../models/index";
 import { Context } from "./context";
 import { ConverterComponent } from "./components";
 import { ChildableComponent } from "../utils/component";
+import { MinimalSourceFile } from "../utils";
 import type { DocumentationEntryPoint } from "../utils/entry-point";
 import { CommentParserConfig } from "./comments";
-import type { CommentStyle } from "../utils/options/declaration";
+import type { CommentStyle, ValidationOptions } from "../utils/options/declaration";
 /**
  * Compiles source files using TypeScript and converts compiler symbols to reflections.
  */
@@ -23,6 +24,8 @@ export declare class Converter extends ChildableComponent<Application, Converter
     excludePrivate: boolean;
     excludeProtected: boolean;
     commentStyle: CommentStyle;
+    /** @internal */
+    validation: ValidationOptions;
     private _config?;
     get config(): CommentParserConfig;
     /**
@@ -51,7 +54,8 @@ export declare class Converter extends ChildableComponent<Application, Converter
     static readonly EVENT_CREATE_DECLARATION: "createDeclaration";
     /**
      * Triggered when the converter has created a signature reflection.
-     * The listener will be given {@link Context}, {@link SignatureReflection} | {@link ProjectReflection} and a `ts.Node?`
+     * The listener will be given {@link Context}, {@link SignatureReflection} | {@link ProjectReflection} and
+     * `ts.SignatureDeclaration | ts.IndexSignatureDeclaration | ts.JSDocSignature | undefined`
      * @event
      */
     static readonly EVENT_CREATE_SIGNATURE: "createSignature";
@@ -103,6 +107,12 @@ export declare class Converter extends ChildableComponent<Application, Converter
      * @internal
      */
     convertType(context: Context, node: ts.TypeNode | ts.Type | undefined): SomeType;
+    /**
+     * Parse the given file into a comment. Intended to be used with markdown files.
+     */
+    parseRawComment(file: MinimalSourceFile): Comment;
+    resolveLinks(comment: Comment, owner: Reflection): void;
+    resolveLinks(parts: readonly CommentDisplayPart[], owner: Reflection): CommentDisplayPart[];
     /**
      * Compile the files within the given context and convert the compiler symbols to reflections.
      *

package/dist/lib/converter/converter.js

@@ -22,6 +22,7 @@ const enum_1 = require("../utils/enum");
 const comments_1 = require("./comments");
 const parser_1 = require("./comments/parser");
 const rawLexer_1 = require("./comments/rawLexer");
+const linkResolver_1 = require("./comments/linkResolver");
 /**
  * Compiles source files using TypeScript and converts compiler symbols to reflections.
  */
@@ -60,6 +61,27 @@ let Converter = Converter_1 = class Converter extends component_1.ChildableCompo
     convertType(context, node) {
         return (0, types_1.convertType)(context, node);
     }
+    /**
+     * Parse the given file into a comment. Intended to be used with markdown files.
+     */
+    parseRawComment(file) {
+        return (0, parser_1.parseComment)((0, rawLexer_1.lexCommentString)(file.text), this.config, file, this.application.logger);
+    }
+    resolveLinks(comment, owner) {
+        if (comment instanceof index_1.Comment) {
+            (0, linkResolver_1.resolveLinks)(comment, owner, this.validation, this.owner.logger);
+        }
+        else {
+            let warned = false;
+            const warn = () => {
+                if (!warned) {
+                    warned = true;
+                    this.application.logger.warn(`${owner.name}: Comment [[target]] style links are deprecated and will be removed in 0.24`);
+                }
+            };
+            return (0, linkResolver_1.resolvePartLinks)(owner, comment, warn, this.validation, this.owner.logger);
+        }
+    }
     /**
      * Compile the files within the given context and convert the compiler symbols to reflections.
      *
@@ -91,11 +113,6 @@ let Converter = Converter_1 = class Converter extends component_1.ChildableCompo
         const entryName = entryPoint.displayName;
         const symbol = getSymbolForModuleLike(context, node);
         let moduleContext;
-        const allExports = getExports(context, node, symbol);
-        if (allExports.every((exp) => this.shouldIgnore(exp))) {
-            this.owner.logger.verbose(`All members of ${entryName} are excluded, ignoring entry point.`);
-            return;
-        }
         if (singleEntryPoint) {
             // Special case for when we're giving a single entry point, we don't need to
             // create modules for each entry. Register the project as this module.
@@ -110,7 +127,7 @@ let Converter = Converter_1 = class Converter extends component_1.ChildableCompo
             const reflection = context.createDeclarationReflection(index_1.ReflectionKind.Module, symbol, void 0, entryName);
             if (entryPoint.readmeFile) {
                 const readme = (0, utils_1.readFile)(entryPoint.readmeFile);
-                const comment = (0, parser_1.parseComment)((0, rawLexer_1.lexCommentString)(readme), context.converter.config, new utils_1.MinimalSourceFile(readme, entryPoint.readmeFile), context.logger);
+                const comment = this.parseRawComment(new utils_1.MinimalSourceFile(readme, entryPoint.readmeFile));
                 if (comment.blockTags.length || comment.modifierTags.size) {
                     const ignored = [
                         ...comment.blockTags.map((tag) => tag.tag),
@@ -124,6 +141,7 @@ let Converter = Converter_1 = class Converter extends component_1.ChildableCompo
             context.finalizeDeclarationReflection(reflection);
             moduleContext = context.withScope(reflection);
         }
+        const allExports = getExports(context, node, symbol);
         for (const exp of allExports.filter((exp) => isDirectExport(context.resolveAliasedSymbol(exp), node))) {
             (0, symbols_1.convertSymbol)(moduleContext, exp);
         }
@@ -206,7 +224,8 @@ Converter.EVENT_END = converter_events_1.ConverterEvents.END;
 Converter.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 SignatureReflection} | {@link ProjectReflection} and a `ts.Node?`
+ * The listener will be given {@link Context}, {@link SignatureReflection} | {@link ProjectReflection} and
+ * `ts.SignatureDeclaration | ts.IndexSignatureDeclaration | ts.JSDocSignature | undefined`
  * @event
  */
 Converter.EVENT_CREATE_SIGNATURE = converter_events_1.ConverterEvents.CREATE_SIGNATURE;
@@ -264,6 +283,9 @@ __decorate([
 __decorate([
     (0, utils_1.BindOption)("commentStyle")
 ], Converter.prototype, "commentStyle", void 0);
+__decorate([
+    (0, utils_1.BindOption)("validation")
+], Converter.prototype, "validation", void 0);
 Converter = Converter_1 = __decorate([
     (0, component_1.Component)({
         name: "converter",

package/dist/lib/converter/factories/signature.js

@@ -49,7 +49,7 @@ function createSignature(context, kind, signature, declaration) {
             context.scope.signatures.push(sigRef);
             break;
     }
-    context.trigger(converter_events_1.ConverterEvents.CREATE_SIGNATURE, sigRef);
+    context.trigger(converter_events_1.ConverterEvents.CREATE_SIGNATURE, sigRef, declaration);
 }
 exports.createSignature = createSignature;
 function convertParameters(context, sigRef, parameters, parameterNodes) {
@@ -62,6 +62,7 @@ function convertParameters(context, sigRef, parameters, parameterNodes) {
         if (declaration && ts.isJSDocParameterTag(declaration)) {
             paramRefl.comment = (0, comments_1.getJsDocComment)(declaration, context.converter.config, context.logger);
         }
+        paramRefl.comment || (paramRefl.comment = (0, comments_1.getComment)(param, paramRefl.kind, context.converter.config, context.logger, context.converter.commentStyle));
         context.registerReflection(paramRefl, param);
         context.trigger(converter_events_1.ConverterEvents.CREATE_PARAMETER, paramRefl);
         let type;

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

@@ -174,14 +174,16 @@ let CommentPlugin = class CommentPlugin extends components_1.ConverterComponent
         }
         hidden.forEach((reflection) => project.removeReflection(reflection));
         // remove functions with empty signatures after their signatures have been removed
-        const [allRemoved, someRemoved] = (0, utils_1.partition)((0, utils_1.filterMap)(hidden, (reflection) => reflection.parent?.kindOf(models_1.ReflectionKind.FunctionOrMethod | models_1.ReflectionKind.Constructor)
+        const [allRemoved, someRemoved] = (0, utils_1.partition)((0, utils_1.unique)((0, utils_1.filterMap)(hidden, (reflection) => reflection.parent?.kindOf(models_1.ReflectionKind.SignatureContainer)
             ? reflection.parent
-            : void 0), (method) => method.signatures?.length === 0);
+            : void 0)), (method) => method.getNonIndexSignatures().length === 0);
         allRemoved.forEach((reflection) => {
             project.removeReflection(reflection);
         });
         someRemoved.forEach((reflection) => {
-            reflection.sources = (0, utils_1.unique)(reflection.signatures.flatMap((s) => s.sources ?? []));
+            reflection.sources = reflection
+                .getNonIndexSignatures()
+                .flatMap((s) => s.sources ?? []);
         });
     }
     /**
@@ -282,8 +284,9 @@ let CommentPlugin = class CommentPlugin extends components_1.ConverterComponent
         }
         if (!comment) {
             if (this.excludeNotDocumented) {
-                // Only allow excludeNotDocumented to exclude root level reflections
-                if (!(reflection instanceof models_1.DeclarationReflection)) {
+                // Don't let excludeNotDocumented remove parameters.
+                if (!(reflection instanceof models_1.DeclarationReflection) &&
+                    !(reflection instanceof models_1.SignatureReflection)) {
                     return false;
                 }
                 // excludeNotDocumented should hide a module only if it has no visible children
@@ -297,14 +300,29 @@ let CommentPlugin = class CommentPlugin extends components_1.ConverterComponent
                 if (reflection.kind === models_1.ReflectionKind.EnumMember) {
                     return false;
                 }
+                // signature containers should only be hidden if all their signatures are hidden
+                if (reflection.kindOf(models_1.ReflectionKind.SignatureContainer)) {
+                    return reflection
+                        .getAllSignatures()
+                        .every((child) => this.isHidden(child));
+                }
                 // excludeNotDocumented should never hide parts of "type" reflections
                 return inTypeLiteral(reflection) === false;
             }
             return false;
         }
-        return (comment.hasModifier("@hidden") ||
+        const isHidden = comment.hasModifier("@hidden") ||
             comment.hasModifier("@ignore") ||
-            (comment.hasModifier("@internal") && this.excludeInternal));
+            (comment.hasModifier("@internal") && this.excludeInternal);
+        if (isHidden &&
+            reflection.kindOf(models_1.ReflectionKind.ContainsCallSignatures)) {
+            return reflection
+                .getNonIndexSignatures()
+                .every((sig) => {
+                return !sig.comment || this.isHidden(sig);
+            });
+        }
+        return isHidden;
     }
 };
 __decorate([

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

@@ -1,4 +1,3 @@
-import type { Reflection } from "../../models/reflections/abstract";
 import { ConverterComponent } from "../components";
 import type { Context } from "../../converter";
 import { ValidationOptions } from "../../utils";
@@ -11,25 +10,5 @@ export declare class LinkResolverPlugin extends ConverterComponent {
      * Create a new LinkResolverPlugin instance.
      */
     initialize(): void;
-    /**
-     * Find all old style double bracket references to symbols within the given text and transform them into a link.
-     *
-     * @param text  The text that should be parsed.
-     * @returns The text with symbol references replaced by links.
-     */
-    private replaceBrackets;
     onResolve(context: Context): void;
-    processReflection(reflection: Reflection): void;
-    private processParts;
-    private processPart;
-    /**
-     * Split the given link into text and target at first pipe or space.
-     *
-     * @param text  The source string that should be checked for a split character.
-     * @returns An object containing the link text and target.
-     */
-    static splitLinkText(text: string): {
-        caption: string;
-        target: string;
-    };
 }

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

@@ -5,22 +5,15 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var LinkResolverPlugin_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LinkResolverPlugin = void 0;
 const components_1 = require("../components");
 const converter_events_1 = require("../converter-events");
-const declarationReference_1 = require("../comments/declarationReference");
-const ts = require("typescript");
 const utils_1 = require("../../utils");
-const declarationReferenceResolver_1 = require("../comments/declarationReferenceResolver");
-const models_1 = require("../../models");
-const urlPrefix = /^(http|ftp)s?:\/\//;
-const brackets = /\[\[(?!include:)([^\]]+)\]\]/g;
 /**
  * A plugin that resolves `{@link Foo}` tags.
  */
-let LinkResolverPlugin = LinkResolverPlugin_1 = class LinkResolverPlugin extends components_1.ConverterComponent {
+let LinkResolverPlugin = class LinkResolverPlugin extends components_1.ConverterComponent {
     /**
      * Create a new LinkResolverPlugin instance.
      */
@@ -28,196 +21,21 @@ let LinkResolverPlugin = LinkResolverPlugin_1 = class LinkResolverPlugin extends
         super.initialize();
         this.owner.on(converter_events_1.ConverterEvents.RESOLVE_END, this.onResolve, this, -300);
     }
-    /**
-     * Find all old style double bracket references to symbols within the given text and transform them into a link.
-     *
-     * @param text  The text that should be parsed.
-     * @returns The text with symbol references replaced by links.
-     */
-    replaceBrackets(reflection, text) {
-        const parts = [];
-        let begin = 0;
-        brackets.lastIndex = 0;
-        for (const match of text.matchAll(brackets)) {
-            if (begin != match.index) {
-                parts.push({
-                    kind: "text",
-                    text: text.substring(begin, match.index),
-                });
-            }
-            begin = match.index + match[0].length;
-            const content = match[1];
-            const { target, caption } = LinkResolverPlugin_1.splitLinkText(content);
-            if (urlPrefix.test(target)) {
-                parts.push({
-                    kind: "inline-tag",
-                    tag: "@link",
-                    text: caption,
-                    target,
-                });
-            }
-            else {
-                const targetRefl = reflection.findReflectionByName(target);
-                if (targetRefl) {
-                    parts.push({
-                        kind: "inline-tag",
-                        tag: "@link",
-                        text: caption,
-                        target: targetRefl,
-                    });
-                }
-                else {
-                    if (this.validation.invalidLink) {
-                        this.application.logger.warn("Failed to find target: " + content);
-                    }
-                    parts.push({
-                        kind: "inline-tag",
-                        tag: "@link",
-                        text: content,
-                    });
-                }
-            }
-        }
-        parts.push({
-            kind: "text",
-            text: text.substring(begin),
-        });
-        return parts;
-    }
     onResolve(context) {
         for (const reflection of Object.values(context.project.reflections)) {
-            this.processReflection(reflection);
-        }
-        let warned = false;
-        const warn = () => {
-            if (!warned) {
-                warned = true;
-                this.application.logger.warn(`README: Comment [[target]] style links are deprecated and will be removed in 0.24`);
-            }
-        };
-        if (context.project.readme) {
-            context.project.readme = this.processParts(context.project, context.project.readme, warn);
-        }
-    }
-    processReflection(reflection) {
-        const comment = reflection.comment;
-        if (!comment)
-            return;
-        let warned = false;
-        const warn = () => {
-            if (!warned) {
-                warned = true;
-                this.application.logger.warn(`${reflection.getFriendlyFullName()}: Comment [[target]] style links are deprecated and will be removed in 0.24`);
-            }
-        };
-        comment.summary = this.processParts(reflection, comment.summary, warn);
-        for (const tag of comment.blockTags) {
-            tag.content = this.processParts(reflection, tag.content, warn);
-        }
-        if (reflection instanceof models_1.DeclarationReflection && reflection.readme) {
-            reflection.readme = this.processParts(reflection, reflection.readme, warn);
-        }
-    }
-    processParts(reflection, parts, warn) {
-        return parts.flatMap((part) => this.processPart(reflection, part, warn));
-    }
-    processPart(reflection, part, warn) {
-        if (part.kind === "text" && brackets.test(part.text)) {
-            warn();
-            return this.replaceBrackets(reflection, part.text);
-        }
-        if (part.kind === "inline-tag") {
-            if (part.tag === "@link" ||
-                part.tag === "@linkcode" ||
-                part.tag === "@linkplain") {
-                return resolveLinkTag(reflection, part, (msg) => {
-                    if (this.validation.invalidLink) {
-                        this.application.logger.warn(msg);
-                    }
-                });
+            if (reflection.comment) {
+                context.converter.resolveLinks(reflection.comment, reflection);
             }
         }
-        return part;
-    }
-    /**
-     * Split the given link into text and target at first pipe or space.
-     *
-     * @param text  The source string that should be checked for a split character.
-     * @returns An object containing the link text and target.
-     */
-    static splitLinkText(text) {
-        let splitIndex = text.indexOf("|");
-        if (splitIndex === -1) {
-            splitIndex = text.search(/\s/);
-        }
-        if (splitIndex !== -1) {
-            return {
-                caption: text
-                    .substring(splitIndex + 1)
-                    .replace(/\n+/, " ")
-                    .trim(),
-                target: text.substring(0, splitIndex).trim(),
-            };
-        }
-        else {
-            return {
-                caption: text,
-                target: text,
-            };
+        if (context.project.readme) {
+            context.project.readme = context.converter.resolveLinks(context.project.readme, context.project);
         }
     }
 };
 __decorate([
     (0, utils_1.BindOption)("validation")
 ], LinkResolverPlugin.prototype, "validation", void 0);
-LinkResolverPlugin = LinkResolverPlugin_1 = __decorate([
+LinkResolverPlugin = __decorate([
     (0, components_1.Component)({ name: "link-resolver" })
 ], LinkResolverPlugin);
 exports.LinkResolverPlugin = LinkResolverPlugin;
-function resolveLinkTag(reflection, part, warn) {
-    let pos = 0;
-    const end = part.text.length;
-    // Try to parse one
-    const declRef = (0, declarationReference_1.parseDeclarationReference)(part.text, pos, end);
-    let target;
-    if (declRef) {
-        // Got one, great! Try to resolve the link
-        target = (0, declarationReferenceResolver_1.resolveDeclarationReference)(reflection, declRef[0]);
-        pos = declRef[1];
-    }
-    // If resolution via a declaration reference failed, revert to the legacy "split and check"
-    // method... this should go away in 0.24, once people have had a chance to migrate any failing links.
-    if (!target) {
-        const resolved = legacyResolveLinkTag(reflection, part);
-        if (resolved) {
-            warn(`Failed to resolve {@link ${part.text}} in ${reflection.getFriendlyFullName()} with declaration references. This link will break in v0.24.`);
-        }
-        return resolved;
-    }
-    // Remaining text after an optional pipe is the link text, so advance
-    // until that's consumed.
-    while (pos < end && ts.isWhiteSpaceLike(part.text.charCodeAt(pos))) {
-        pos++;
-    }
-    if (pos < end && part.text[pos] === "|") {
-        pos++;
-    }
-    part.target = target;
-    part.text = part.text.substring(pos).trim() || target.name;
-    return part;
-}
-function legacyResolveLinkTag(reflection, part) {
-    const { caption, target } = LinkResolverPlugin.splitLinkText(part.text);
-    if (urlPrefix.test(target)) {
-        part.text = caption;
-        part.target = target;
-    }
-    else {
-        const targetRefl = reflection.findReflectionByName(target);
-        if (targetRefl) {
-            part.text = caption;
-            part.target = targetRefl;
-        }
-    }
-    return part;
-}

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

@@ -14,8 +14,6 @@ const converter_1 = require("../converter");
 const utils_1 = require("../../utils");
 const fs_1 = require("../../utils/fs");
 const paths_1 = require("../../utils/paths");
-const rawLexer_1 = require("../comments/rawLexer");
-const parser_1 = require("../comments/parser");
 const minimalSourceFile_1 = require("../../utils/minimalSourceFile");
 /**
  * A handler that tries to find the package.json and readme.md files of the
@@ -76,7 +74,7 @@ let PackagePlugin = class PackagePlugin extends components_1.ConverterComponent
         const project = context.project;
         if (this.readmeFile) {
             const readme = (0, utils_1.readFile)(this.readmeFile);
-            const comment = (0, parser_1.parseComment)((0, rawLexer_1.lexCommentString)(readme), context.converter.config, new minimalSourceFile_1.MinimalSourceFile(readme, this.readmeFile), context.logger);
+            const comment = context.converter.parseRawComment(new minimalSourceFile_1.MinimalSourceFile(readme, this.readmeFile));
             if (comment.blockTags.length || comment.modifierTags.size) {
                 const ignored = [
                     ...comment.blockTags.map((tag) => tag.tag),

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

@@ -33,6 +33,7 @@ export declare class SourcePlugin extends ConverterComponent {
      * @param reflection  The reflection that is currently processed.
      */
     private onDeclaration;
+    private onSignature;
     /**
      * Triggered when the converter begins resolving a project.
      *

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

@@ -42,7 +42,7 @@ let SourcePlugin = class SourcePlugin extends components_1.ConverterComponent {
         this.listenTo(this.owner, {
             [converter_1.Converter.EVENT_END]: this.onEnd,
             [converter_1.Converter.EVENT_CREATE_DECLARATION]: this.onDeclaration,
-            [converter_1.Converter.EVENT_CREATE_SIGNATURE]: this.onDeclaration,
+            [converter_1.Converter.EVENT_CREATE_SIGNATURE]: this.onSignature,
             [converter_1.Converter.EVENT_RESOLVE_BEGIN]: this.onBeginResolve,
         });
     }
@@ -77,6 +77,16 @@ let SourcePlugin = class SourcePlugin extends components_1.ConverterComponent {
             reflection.sources.push(new models_1.SourceReference(fileName, position.line + 1, position.character));
         }
     }
+    onSignature(_context, reflection, sig) {
+        if (this.disableSources || !sig)
+            return;
+        const sourceFile = sig.getSourceFile();
+        const fileName = sourceFile.fileName;
+        this.fileNames.add(fileName);
+        const position = ts.getLineAndCharacterOfPosition(sourceFile, sig.getStart());
+        reflection.sources || (reflection.sources = []);
+        reflection.sources.push(new models_1.SourceReference(fileName, position.line + 1, position.character));
+    }
     /**
      * Triggered when the converter begins resolving a project.
      *

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

@@ -44,11 +44,19 @@ class Repository {
         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]);
+            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]);
             }

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

@@ -284,19 +284,22 @@ class Reflection {
             if (alias === "") {
                 alias = "reflection-" + this.id;
             }
+            // NTFS/ExFAT use uppercase, so we will too. It probably won't matter
+            // in this case since names will generally be valid identifiers, but to be safe...
+            const upperAlias = alias.toUpperCase();
             let target = this;
             while (target.parent && !target.hasOwnDocument) {
                 target = target.parent;
             }
             target._aliases || (target._aliases = new Map());
             let suffix = "";
-            if (!target._aliases.has(alias)) {
-                target._aliases.set(alias, 1);
+            if (!target._aliases.has(upperAlias)) {
+                target._aliases.set(upperAlias, 1);
             }
             else {
-                const count = target._aliases.get(alias);
+                const count = target._aliases.get(upperAlias);
                 suffix = "-" + count.toString();
-                target._aliases.set(alias, count + 1);
+                target._aliases.set(upperAlias, count + 1);
             }
             alias += suffix;
             this._alias = alias;

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

@@ -45,4 +45,9 @@ export declare namespace ReflectionKind {
     const Inheritable: number;
     /** @internal */
     const ContainsCallSignatures: number;
+    /**
+     * Note: This does not include Class/Interface, even though they technically could contain index signatures
+     * @internal
+     */
+    const SignatureContainer: number;
 }

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

@@ -78,4 +78,9 @@ var ReflectionKind;
     ReflectionKind.ContainsCallSignatures = ReflectionKind.Constructor |
         ReflectionKind.Function |
         ReflectionKind.Method;
+    /**
+     * Note: This does not include Class/Interface, even though they technically could contain index signatures
+     * @internal
+     */
+    ReflectionKind.SignatureContainer = ReflectionKind.ContainsCallSignatures | ReflectionKind.Accessor;
 })(ReflectionKind = exports.ReflectionKind || (exports.ReflectionKind = {}));

package/dist/lib/models/types.js

@@ -671,7 +671,7 @@ class ReferenceType extends Type {
             .fileName.replace(/\\/g, "/");
         if (!symbolPath)
             return ref;
-        let startIndex = symbolPath.indexOf("node_modules/");
+        let startIndex = symbolPath.lastIndexOf("node_modules/");
         if (startIndex === -1)
             return ref;
         startIndex += "node_modules/".length;

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

@@ -1,6 +1,6 @@
 import type { RendererHooks } from "../..";
-import type { ReferenceType, Reflection } from "../../../models";
-import type { Options } from "../../../utils";
+import type { CommentDisplayPart, ReferenceType, Reflection } from "../../../models";
+import type { NeverIfInternal, Options } from "../../../utils";
 import type { DefaultTheme } from "./DefaultTheme";
 export declare class DefaultThemeRenderContext {
     private theme;
@@ -11,7 +11,7 @@ export declare class DefaultThemeRenderContext {
     /** Avoid this in favor of urlTo if possible */
     relativeURL: (url: string | undefined) => string | undefined;
     urlTo: (reflection: Reflection) => string | undefined;
-    markdown: (md: string | undefined) => string;
+    markdown: (md: readonly CommentDisplayPart[] | NeverIfInternal<string | undefined>) => string;
     attemptExternalResolution: (type: ReferenceType) => string | undefined;
     reflectionTemplate: (props: import("../..").PageEvent<import("../../../models").ContainerReflection>) => import("../../../utils/jsx.elements").JsxElement;
     indexTemplate: (props: import("../..").PageEvent<import("../../../models").ProjectReflection>) => import("../../../utils/jsx.elements").JsxElement;

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultThemeRenderContext = void 0;
+const lib_1 = require("../lib");
 const default_1 = require("./layouts/default");
 const partials_1 = require("./partials");
 const analytics_1 = require("./partials/analytics");
@@ -42,6 +43,9 @@ class DefaultThemeRenderContext {
         };
         this.urlTo = (reflection) => this.relativeURL(reflection.url);
         this.markdown = (md) => {
+            if (md instanceof Array) {
+                return this.theme.markedPlugin.parseMarkdown((0, lib_1.displayPartsToMarkdown)(md, this.urlTo));
+            }
             return md ? this.theme.markedPlugin.parseMarkdown(md) : "";
         };
         this.attemptExternalResolution = (type) => {

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

@@ -1,4 +1,4 @@
 import type { DefaultThemeRenderContext } from "../DefaultThemeRenderContext";
 import { JSX } from "../../../../utils";
 import type { Reflection } from "../../../../models";
-export declare function comment({ markdown, urlTo }: DefaultThemeRenderContext, props: Reflection): JSX.Element | undefined;
+export declare function comment({ markdown }: DefaultThemeRenderContext, props: Reflection): JSX.Element | undefined;

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

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.comment = void 0;
 const utils_1 = require("../../../../utils");
 const lib_1 = require("../../lib");
-function comment({ markdown, urlTo }, props) {
+function comment({ markdown }, props) {
     if (!props.comment?.hasVisibleComponent())
         return;
     // Note: Comment modifiers are handled in `renderFlags`
     return (utils_1.JSX.createElement("div", { class: "tsd-comment tsd-typography" },
-        utils_1.JSX.createElement(utils_1.Raw, { html: markdown((0, lib_1.displayPartsToMarkdown)(props.comment.summary, urlTo)) }),
+        utils_1.JSX.createElement(utils_1.Raw, { html: markdown(props.comment.summary) }),
         props.comment.blockTags.map((item) => (utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
             utils_1.JSX.createElement("h3", null, (0, lib_1.camelToTitleCase)(item.tag.substring(1))),
-            utils_1.JSX.createElement(utils_1.Raw, { html: markdown((0, lib_1.displayPartsToMarkdown)(item.content, urlTo)) }))))));
+            utils_1.JSX.createElement(utils_1.Raw, { html: markdown(item.content) }))))));
 }
 exports.comment = comment;

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

@@ -10,7 +10,7 @@ function renderCategory({ urlTo, icons }, item, prependName = "") {
         utils_1.JSX.createElement("div", { class: "tsd-index-list" }, item.children.map((item) => (utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
             utils_1.JSX.createElement("a", { href: urlTo(item), class: (0, lib_1.classNames)({ "tsd-index-link": true, deprecated: item.isDeprecated() }, item.cssClasses) },
                 icons[item.kind](),
-                utils_1.JSX.createElement("span", null, item.name ? (0, lib_1.wbr)(item.name) : utils_1.JSX.createElement("em", null, (0, lib_1.wbr)(item.kindString)))),
+                utils_1.JSX.createElement("span", null, (0, lib_1.renderName)(item))),
             "\n"))))));
 }
 function index(context, props) {
@@ -42,7 +42,7 @@ function index(context, props) {
             props.kind === models_1.ReflectionKind.Module &&
             props.readme?.length !== 0 && (utils_1.JSX.createElement("section", { class: "tsd-panel-group" },
             utils_1.JSX.createElement("section", { class: "tsd-panel tsd-typography" },
-                utils_1.JSX.createElement(utils_1.Raw, { html: context.markdown((0, lib_1.displayPartsToMarkdown)(props.readme || [], context.urlTo)) })))),
+                utils_1.JSX.createElement(utils_1.Raw, { html: context.markdown(props.readme || []) })))),
         utils_1.JSX.createElement("section", { class: "tsd-panel-group tsd-index-group" },
             utils_1.JSX.createElement("section", { class: "tsd-panel tsd-index-panel" }, content))));
 }

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

@@ -103,7 +103,7 @@ function secondaryNavigation(context, props) {
         return (utils_1.JSX.createElement("li", { class: (0, lib_1.classNames)({ deprecated: child.isDeprecated(), current: props.model === child }, child.cssClasses) },
             utils_1.JSX.createElement("a", { href: context.urlTo(child), class: "tsd-index-link" },
                 context.icons[child.kind](),
-                (0, lib_1.wbr)(child.name))));
+                (0, lib_1.renderName)(child))));
     });
     if (effectivePageParent.kindOf(models_1.ReflectionKind.SomeModule | models_1.ReflectionKind.Project)) {
         return (utils_1.JSX.createElement("nav", { class: "tsd-navigation secondary menu-sticky" }, !!pageNavigation.length && utils_1.JSX.createElement("ul", null, pageNavigation)));
@@ -116,7 +116,7 @@ function secondaryNavigation(context, props) {
                 }, effectivePageParent.cssClasses) },
                 utils_1.JSX.createElement("a", { href: context.urlTo(effectivePageParent), class: "tsd-index-link" },
                     context.icons[effectivePageParent.kind](),
-                    utils_1.JSX.createElement("span", null, (0, lib_1.wbr)(effectivePageParent.name))),
+                    utils_1.JSX.createElement("span", null, (0, lib_1.renderName)(effectivePageParent))),
                 !!pageNavigation.length && utils_1.JSX.createElement("ul", null, pageNavigation)))));
 }
 exports.secondaryNavigation = secondaryNavigation;

package/dist/lib/output/themes/default/templates/index.d.ts

@@ -2,4 +2,4 @@ import type { DefaultThemeRenderContext } from "../DefaultThemeRenderContext";
 import type { ProjectReflection } from "../../../../models";
 import type { PageEvent } from "../../../events";
 import { JSX } from "../../../../utils";
-export declare const indexTemplate: ({ markdown, urlTo }: DefaultThemeRenderContext, props: PageEvent<ProjectReflection>) => JSX.Element;
+export declare const indexTemplate: ({ markdown }: DefaultThemeRenderContext, props: PageEvent<ProjectReflection>) => JSX.Element;

package/dist/lib/output/themes/default/templates/index.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.indexTemplate = void 0;
 const utils_1 = require("../../../../utils");
-const lib_1 = require("../../lib");
-const indexTemplate = ({ markdown, urlTo }, props) => (utils_1.JSX.createElement("div", { class: "tsd-panel tsd-typography" },
-    utils_1.JSX.createElement(utils_1.Raw, { html: markdown((0, lib_1.displayPartsToMarkdown)(props.model.readme || [], urlTo)) })));
+const indexTemplate = ({ markdown }, props) => (utils_1.JSX.createElement("div", { class: "tsd-panel tsd-typography" },
+    utils_1.JSX.createElement(utils_1.Raw, { html: markdown(props.model.readme || []) })));
 exports.indexTemplate = indexTemplate;

package/dist/lib/output/themes/default/templates/reflection.js

@@ -36,7 +36,8 @@ function reflectionTemplate(context, props) {
                     context.type(props.model.indexSignature.type)),
                 context.comment(props.model.indexSignature),
                 props.model.indexSignature?.type instanceof models_1.ReflectionType &&
-                    context.parameter(props.model.indexSignature.type.declaration))))),
+                    context.parameter(props.model.indexSignature.type.declaration))),
+            !props.model.signatures && context.memberSources(props.model))),
         !!props.model.children?.length && context.index(props.model),
         context.members(props.model)));
 }

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

@@ -19,4 +19,8 @@ export declare function hasTypeParameters(reflection: Reflection): reflection is
 };
 export declare function renderTypeParametersSignature(typeParameters: readonly TypeParameterReflection[] | undefined): JSX.Element;
 export declare function camelToTitleCase(text: string): string;
-export declare function displayPartsToMarkdown(parts: CommentDisplayPart[], urlTo: DefaultThemeRenderContext["urlTo"]): string;
+export declare function displayPartsToMarkdown(parts: readonly CommentDisplayPart[], urlTo: DefaultThemeRenderContext["urlTo"]): string;
+/**
+ * Renders the reflection name with an additional `?` if optional.
+ */
+export declare function renderName(refl: Reflection): JSX.Element | (string | JSX.Element)[];

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.displayPartsToMarkdown = exports.camelToTitleCase = exports.renderTypeParametersSignature = exports.hasTypeParameters = exports.classNames = exports.renderFlags = exports.join = exports.wbr = exports.stringify = void 0;
+exports.renderName = exports.displayPartsToMarkdown = exports.camelToTitleCase = exports.renderTypeParametersSignature = exports.hasTypeParameters = exports.classNames = exports.renderFlags = exports.join = exports.wbr = exports.stringify = void 0;
 const models_1 = require("../../models");
 const utils_1 = require("../../utils");
 function stringify(data) {
@@ -122,3 +122,18 @@ function displayPartsToMarkdown(parts, urlTo) {
     return result.join("");
 }
 exports.displayPartsToMarkdown = displayPartsToMarkdown;
+/**
+ * Renders the reflection name with an additional `?` if optional.
+ */
+function renderName(refl) {
+    if (!refl.name) {
+        return utils_1.JSX.createElement("em", null, wbr(refl.kindString));
+    }
+    if (refl.flags.isOptional) {
+        return utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
+            wbr(refl.name),
+            "?");
+    }
+    return wbr(refl.name);
+}
+exports.renderName = renderName;

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

@@ -261,7 +261,9 @@ function getEntryPointsForPackages(logger, packageGlobPaths, options) {
         results.push({
             displayName: typedocPackageConfig?.displayName ??
                 packageJson["name"],
-            version: packageJson["version"],
+            version: includeVersion
+                ? packageJson["version"]
+                : void 0,
             readmeFile: typedocPackageConfig?.readmeFile
                 ? Path.resolve(Path.join(packageJsonPath, "..", typedocPackageConfig?.readmeFile))
                 : undefined,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "typedoc",
   "description": "Create api documentation for TypeScript projects.",
-  "version": "0.23.7",
+  "version": "0.23.10",
   "homepage": "https://typedoc.org",
   "main": "./dist/index.js",
   "exports": {
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "lunr": "^2.3.9",
-    "marked": "^4.0.16",
+    "marked": "^4.0.18",
     "minimatch": "^5.1.0",
     "shiki": "^0.10.1"
   },
@@ -37,22 +37,21 @@
     "@types/marked": "^4.0.3",
     "@types/minimatch": "3.0.5",
     "@types/mocha": "^9.1.1",
-    "@types/node": "^17.0.35",
-    "@typescript-eslint/eslint-plugin": "^5.26.0",
-    "@typescript-eslint/parser": "^5.26.0",
+    "@types/node": "^18.6.3",
+    "@typescript-eslint/eslint-plugin": "^5.31.0",
+    "@typescript-eslint/parser": "^5.31.0",
     "@typestrong/fs-fixture-builder": "github:TypeStrong/fs-fixture-builder#b88cd06fe814614a0d924af9d10d04ff95a551de",
-    "c8": "^7.11.3",
+    "c8": "^7.12.0",
     "esbuild": "^0.14.39",
-    "eslint": "^8.16.0",
-    "mocha": "^9.2.1",
-    "prettier": "2.6.2",
+    "eslint": "^8.20.0",
+    "mocha": "^10.0.0",
+    "prettier": "2.7.1",
     "puppeteer": "^13.5.2",
-    "reg-notify-github-plugin": "^0.11.1",
-    "reg-suit": "^0.11.1",
-    "reg-suit-core": "^0.11.1",
-    "reg-suit-interface": "^0.11.0",
-    "ts-node": "^10.8.0",
-    "typescript": "^4.7.2"
+    "reg-suit": "^0.12.1",
+    "reg-suit-core": "^0.12.1",
+    "reg-suit-interface": "^0.12.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^4.7.4"
   },
   "files": [
     "/bin",
@@ -66,7 +65,8 @@
     "/tsdoc.json"
   ],
   "scripts": {
-    "test": "c8 mocha -r ts-node/register --config .config/mocha.fast.json",
+    "test": "mocha -r ts-node/register --config .config/mocha.fast.json",
+    "test:cov": "c8 mocha -r ts-node/register --config .config/mocha.fast.json",
     "build:c2": "node bin/typedoc --tsconfig src/test/converter2/tsconfig.json",
     "test:full": "c8 mocha -r ts-node/register --config .config/mocha.full.json",
     "test:visual": "node ./dist/test/capture-screenshots.js && reg-suit -c .config/regconfig.json compare",

package/static/style.css

@@ -942,7 +942,7 @@ a.tsd-index-link {
     margin: 2rem 0;
 }
 .tsd-panel-group.tsd-index-group details {
-    margin: 4rem 0;
+    margin: 2rem 0;
 }
 
 #tsd-search {

package/tsdoc.json

@@ -1,5 +1,5 @@
 {
-    "$schema": "https://developer.microsoft.com/en-us/json-schemas/tsdoc/v0/tsdoc.schema.json",
+    "$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
     "noStandardTags": false,
     "tagDefinitions": [
         {