typedoc 0.24.0 → 0.24.2

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 export { Application } from "./lib/application";
 export { EventDispatcher, Event } from "./lib/utils/events";
 export { resetReflectionID } from "./lib/models/reflections/abstract";
-export { normalizePath } from "./lib/utils/fs";
 /**
  * All symbols documented under the Models namespace are also available in the root import.
  */
@@ -10,8 +9,8 @@ export * from "./lib/models";
 export { Converter, Context, type CommentParserConfig, type DeclarationReference, type SymbolReference, type ComponentPath, type Meaning, type MeaningKeyword, type ExternalResolveResult, type ExternalSymbolResolver, } from "./lib/converter";
 export { Renderer, DefaultTheme, DefaultThemeRenderContext, UrlMapping, Theme, PageEvent, RendererEvent, MarkdownEvent, IndexEvent, } from "./lib/output";
 export type { RenderTemplate, RendererHooks } from "./lib/output";
-export { ArgumentsReader, BindOption, CommentStyle, JSX, LogLevel, Logger, Options, PackageJsonReader, ParameterHint, ParameterType, TSConfigReader, TypeDocReader, EntryPointStrategy, EventHooks, MinimalSourceFile, } from "./lib/utils";
-export type { OptionsReader, TypeDocOptions, TypeDocOptionMap, ValidationOptions, TypeDocOptionValues, KeyToDeclaration, DeclarationOption, DeclarationOptionBase, StringDeclarationOption, NumberDeclarationOption, BooleanDeclarationOption, ArrayDeclarationOption, MixedDeclarationOption, ObjectDeclarationOption, MapDeclarationOption, FlagsDeclarationOption, DeclarationOptionToOptionType, SortStrategy, ParameterTypeToOptionTypeMap, DocumentationEntryPoint, ManuallyValidatedOption, EnumKeys, } from "./lib/utils";
+export { ArgumentsReader, BindOption, CommentStyle, JSX, LogLevel, Logger, Options, PackageJsonReader, ParameterHint, ParameterType, TSConfigReader, TypeDocReader, EntryPointStrategy, EventHooks, MinimalSourceFile, normalizePath, } from "./lib/utils";
+export type { OptionsReader, TypeDocOptions, TypeDocOptionMap, ValidationOptions, TypeDocOptionValues, KeyToDeclaration, DeclarationOption, DeclarationOptionBase, StringDeclarationOption, NumberDeclarationOption, BooleanDeclarationOption, ArrayDeclarationOption, MixedDeclarationOption, ObjectDeclarationOption, MapDeclarationOption, FlagsDeclarationOption, DeclarationOptionToOptionType, SortStrategy, ParameterTypeToOptionTypeMap, DocumentationEntryPoint, ManuallyValidatedOption, EnumKeys, JsDocCompatibility, } from "./lib/utils";
 export type { EventMap, EventCallback } from "./lib/utils/events";
 export { JSONOutput, Serializer, Deserializer, type Deserializable, type DeserializerComponent, type SerializerComponent, SerializeEvent, } from "./lib/serialization";
 import TypeScript from "typescript";

package/dist/index.js

@@ -29,7 +29,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TypeScript = exports.SerializeEvent = exports.Deserializer = exports.Serializer = exports.JSONOutput = exports.MinimalSourceFile = exports.EventHooks = exports.EntryPointStrategy = exports.TypeDocReader = exports.TSConfigReader = exports.ParameterType = exports.ParameterHint = exports.PackageJsonReader = exports.Options = exports.Logger = exports.LogLevel = exports.JSX = exports.CommentStyle = exports.BindOption = exports.ArgumentsReader = exports.IndexEvent = exports.MarkdownEvent = exports.RendererEvent = exports.PageEvent = exports.Theme = exports.UrlMapping = exports.DefaultThemeRenderContext = exports.DefaultTheme = exports.Renderer = exports.Context = exports.Converter = exports.Models = exports.normalizePath = exports.resetReflectionID = exports.Event = exports.EventDispatcher = exports.Application = void 0;
+exports.TypeScript = exports.SerializeEvent = exports.Deserializer = exports.Serializer = exports.JSONOutput = exports.normalizePath = exports.MinimalSourceFile = exports.EventHooks = exports.EntryPointStrategy = exports.TypeDocReader = exports.TSConfigReader = exports.ParameterType = exports.ParameterHint = exports.PackageJsonReader = exports.Options = exports.Logger = exports.LogLevel = exports.JSX = exports.CommentStyle = exports.BindOption = exports.ArgumentsReader = exports.IndexEvent = exports.MarkdownEvent = exports.RendererEvent = exports.PageEvent = exports.Theme = exports.UrlMapping = exports.DefaultThemeRenderContext = exports.DefaultTheme = exports.Renderer = exports.Context = exports.Converter = exports.Models = 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");
@@ -37,8 +37,6 @@ Object.defineProperty(exports, "EventDispatcher", { enumerable: true, get: funct
 Object.defineProperty(exports, "Event", { enumerable: true, get: function () { return events_1.Event; } });
 var abstract_1 = require("./lib/models/reflections/abstract");
 Object.defineProperty(exports, "resetReflectionID", { enumerable: true, get: function () { return abstract_1.resetReflectionID; } });
-var fs_1 = require("./lib/utils/fs");
-Object.defineProperty(exports, "normalizePath", { enumerable: true, get: function () { return fs_1.normalizePath; } });
 /**
  * All symbols documented under the Models namespace are also available in the root import.
  */
@@ -73,6 +71,7 @@ Object.defineProperty(exports, "TypeDocReader", { enumerable: true, get: functio
 Object.defineProperty(exports, "EntryPointStrategy", { enumerable: true, get: function () { return utils_1.EntryPointStrategy; } });
 Object.defineProperty(exports, "EventHooks", { enumerable: true, get: function () { return utils_1.EventHooks; } });
 Object.defineProperty(exports, "MinimalSourceFile", { enumerable: true, get: function () { return utils_1.MinimalSourceFile; } });
+Object.defineProperty(exports, "normalizePath", { enumerable: true, get: function () { return utils_1.normalizePath; } });
 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

@@ -355,6 +355,7 @@ let Application = Application_1 = class Application extends component_1.Childabl
             this.options = opts;
             const project = this.convert();
             if (project) {
+                this.validate(project);
                 projects.push(this.serializer.projectToObject(project, process.cwd()));
             }
             (0, abstract_1.resetReflectionID)();
@@ -371,7 +372,7 @@ let Application = Application_1 = class Application extends component_1.Childabl
     }
     _merge() {
         const start = Date.now();
-        const rootDir = (0, fs_1.getCommonDirectory)(this.entryPoints);
+        const rootDir = (0, fs_1.deriveRootDir)(this.entryPoints);
         const entryPoints = this.entryPoints.flatMap((entry) => (0, fs_1.glob)(entry, rootDir));
         this.logger.verbose(`Merging entry points:\n\t${entryPoints.map(paths_1.nicePath).join("\n\t")}`);
         if (entryPoints.length < 1) {

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

@@ -174,7 +174,7 @@ function exampleBlockContent(comment, lexer, config, warning) {
     const content = blockContent(comment, lexer, config, () => { });
     const end = lexer.done() || lexer.peek();
     lexer.release();
-    if (content.some((part) => part.kind === "code")) {
+    if (content.some((part) => part.kind === "code" && part.text.startsWith("```"))) {
         return blockContent(comment, lexer, config, warning);
     }
     const tokens = [];

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

@@ -17,6 +17,7 @@ const types_1 = require("../../models/types");
 const array_1 = require("../../utils/array");
 const components_1 = require("../components");
 const converter_1 = require("../converter");
+const utils_1 = require("../../utils");
 /**
  * A plugin that detects interface implementations of functions and
  * properties on classes and links them.
@@ -52,13 +53,22 @@ let ImplementsPlugin = class ImplementsPlugin extends components_1.ConverterComp
             const interfaceMemberName = interfaceReflection.name + "." + interfaceMember.name;
             classMember.implementationOf =
                 types_1.ReferenceType.createResolvedReference(interfaceMemberName, interfaceMember, project);
-            if (interfaceMember.kindOf(index_1.ReflectionKind.FunctionOrMethod) &&
-                interfaceMember.signatures &&
-                classMember.signatures) {
-                for (const [clsSig, intSig] of (0, array_1.zip)(classMember.signatures, interfaceMember.signatures)) {
+            const intSigs = interfaceMember.signatures ||
+                interfaceMember.type?.visit({
+                    reflection: (r) => r.declaration.signatures,
+                });
+            const clsSigs = classMember.signatures ||
+                classMember.type?.visit({
+                    reflection: (r) => r.declaration.signatures,
+                });
+            if (intSigs && clsSigs) {
+                for (const [clsSig, intSig] of (0, array_1.zip)(clsSigs, intSigs)) {
                     if (clsSig.implementationOf) {
+                        const target = intSig.parent.kindOf(index_1.ReflectionKind.FunctionOrMethod)
+                            ? intSig
+                            : intSig.parent.parent;
                         clsSig.implementationOf =
-                            types_1.ReferenceType.createResolvedReference(clsSig.implementationOf.name, intSig, project);
+                            types_1.ReferenceType.createResolvedReference(clsSig.implementationOf.name, target, project);
                     }
                 }
             }
@@ -238,7 +248,7 @@ function findProperty(reflection, parent) {
 }
 function createLink(context, reflection, clause, expr, symbol, isOverwrite) {
     const project = context.project;
-    const name = `${expr.expression.getText()}.${symbol.name}`;
+    const name = `${expr.expression.getText()}.${(0, utils_1.getHumanName)(symbol.name)}`;
     link(reflection);
     link(reflection.getSignature);
     link(reflection.setSignature);

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

@@ -72,7 +72,7 @@ let PackagePlugin = class PackagePlugin extends components_1.ConverterComponent
         const entryFiles = this.entryPointStrategy === utils_1.EntryPointStrategy.Packages
             ? this.entryPoints.map((d) => (0, path_1.join)(d, "package.json"))
             : this.entryPoints;
-        const dirName = Path.resolve((0, fs_1.getCommonDirectory)(entryFiles));
+        const dirName = Path.resolve((0, fs_1.deriveRootDir)(entryFiles));
         this.application.logger.verbose(`Begin readme.md/package.json search at ${(0, paths_1.nicePath)(dirName)}`);
         this.packageJson = (0, fs_1.discoverPackageJson)(dirName)?.content;
         // Path will be resolved already. This is kind of ugly, but...

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

@@ -16,7 +16,6 @@ const components_1 = require("../components");
 const converter_1 = require("../converter");
 const utils_1 = require("../../utils");
 const nodes_1 = require("../utils/nodes");
-const fs_1 = require("../../utils/fs");
 const path_1 = require("path");
 const models_1 = require("../../models");
 const repository_1 = require("../utils/repository");
@@ -103,7 +102,7 @@ let SourcePlugin = class SourcePlugin extends components_1.ConverterComponent {
     onBeginResolve(context) {
         if (this.disableSources)
             return;
-        const basePath = this.basePath || (0, fs_1.getCommonDirectory)([...this.fileNames]);
+        const basePath = this.basePath || (0, utils_1.getCommonDirectory)([...this.fileNames]);
         for (const refl of Object.values(context.project.reflections)) {
             if (!(refl instanceof index_1.DeclarationReflection ||
                 refl instanceof index_1.SignatureReflection)) {
@@ -114,7 +113,7 @@ let SourcePlugin = class SourcePlugin extends components_1.ConverterComponent {
                     const repo = this.getRepository(source.fullFileName);
                     source.url = repo?.getURL(source.fullFileName, source.line);
                 }
-                source.fileName = (0, fs_1.normalizePath)((0, path_1.relative)(basePath, source.fullFileName));
+                source.fileName = (0, utils_1.normalizePath)((0, path_1.relative)(basePath, source.fullFileName));
             }
         }
     }

package/dist/lib/converter/types.js

@@ -416,7 +416,9 @@ const referenceConverter = {
         if (!symbol) {
             // This happens when we get a reference to a type parameter
             // created within a mapped type, `K` in: `{ [K in T]: string }`
-            return models_1.ReferenceType.createBrokenReference(context.checker.typeToString(type), context.project);
+            const ref = models_1.ReferenceType.createBrokenReference(context.checker.typeToString(type), context.project);
+            ref.refersToTypeParameter = true;
+            return ref;
         }
         const ref = models_1.ReferenceType.createSymbolReference(context.resolveAliasedSymbol(symbol), context);
         if (type.flags & typescript_1.default.TypeFlags.StringMapping) {

package/dist/lib/models/comments/comment.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Comment = exports.CommentTag = void 0;
 const utils_1 = require("../../utils");
+const kind_1 = require("../reflections/kind");
 const ReflectionSymbolId_1 = require("../reflections/ReflectionSymbolId");
 /**
  * A model that represents a single TypeDoc comment tag.
@@ -88,6 +89,7 @@ class Comment {
                         case "@linkplain": {
                             if (part.target) {
                                 let url;
+                                let kindClass;
                                 if (typeof part.target === "string") {
                                     url = part.target;
                                 }
@@ -95,12 +97,15 @@ class Comment {
                                     // No point in trying to resolve a ReflectionSymbolId at this point, we've already
                                     // tried and failed during the resolution step.
                                     url = urlTo(part.target);
+                                    kindClass = kind_1.ReflectionKind.classString(part.target.kind);
                                 }
                                 const text = part.tag === "@linkcode"
                                     ? `<code>${part.text}</code>`
                                     : part.text;
                                 result.push(url
-                                    ? `<a href="${url}">${text}</a>`
+                                    ? `<a href="${url}"${kindClass
+                                        ? ` class="${kindClass}"`
+                                        : ""}>${text}</a>`
                                     : part.text);
                             }
                             else {

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

@@ -204,14 +204,17 @@ export declare abstract class Reflection {
      */
     isDeprecated(): boolean;
     /**
-     * Traverse all potential child reflections of this reflection.
+     * Traverse most potential child reflections of this reflection.
+     *
+     * Note: This may not necessarily traverse child reflections contained within the `type` property
+     * of the reflection, and should not be relied on for this. Support for checking object types will likely be removed in v0.25.
      *
      * The given callback will be invoked for all children, signatures and type parameters
      * attached to this reflection.
      *
      * @param callback  The callback function that should be applied for each child reflection.
      */
-    traverse(_callback: TraverseCallback): void;
+    abstract traverse(callback: TraverseCallback): void;
     /**
      * Return a string representation of this reflection.
      */

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

@@ -358,17 +358,6 @@ class Reflection {
         }
         return this.parent?.isDeprecated() ?? false;
     }
-    /**
-     * Traverse all potential child reflections of this reflection.
-     *
-     * The given callback will be invoked for all children, signatures and type parameters
-     * attached to this reflection.
-     *
-     * @param callback  The callback function that should be applied for each child reflection.
-     */
-    traverse(_callback) {
-        // do nothing here, overridden by child classes
-    }
     /**
      * Return a string representation of this reflection.
      */

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

@@ -24,14 +24,6 @@ export declare abstract class ContainerReflection extends Reflection {
      * @returns     An array containing all children with the desired kind.
      */
     getChildrenByKind(kind: ReflectionKind): DeclarationReflection[];
-    /**
-     * Traverse all potential child reflections of this reflection.
-     *
-     * The given callback will be invoked for all children, signatures and type parameters
-     * attached to this reflection.
-     *
-     * @param callback  The callback function that should be applied for each child reflection.
-     */
     traverse(callback: TraverseCallback): void;
     toObject(serializer: Serializer): JSONOutput.ContainerReflection;
     fromObject(de: Deserializer, obj: JSONOutput.ContainerReflection): void;

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

@@ -14,14 +14,6 @@ class ContainerReflection extends abstract_1.Reflection {
     getChildrenByKind(kind) {
         return (this.children || []).filter((child) => child.kindOf(kind));
     }
-    /**
-     * Traverse all potential child reflections of this reflection.
-     *
-     * The given callback will be invoked for all children, signatures and type parameters
-     * attached to this reflection.
-     *
-     * @param callback  The callback function that should be applied for each child reflection.
-     */
     traverse(callback) {
         for (const child of this.children?.slice() || []) {
             if (callback(child, abstract_1.TraverseProperty.Children) === false) {

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

@@ -148,14 +148,6 @@ export declare class DeclarationReflection extends ContainerReflection {
     getAllSignatures(): SignatureReflection[];
     /** @internal */
     getNonIndexSignatures(): SignatureReflection[];
-    /**
-     * Traverse all potential child reflections of this reflection.
-     *
-     * The given callback will be invoked for all children, signatures and type parameters
-     * attached to this reflection.
-     *
-     * @param callback  The callback function that should be applied for each child reflection.
-     */
     traverse(callback: TraverseCallback): void;
     /**
      * Return a string representation of this reflection.

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

@@ -58,14 +58,6 @@ class DeclarationReflection extends container_1.ContainerReflection {
     getNonIndexSignatures() {
         return [].concat(this.signatures ?? [], this.setSignature ?? [], this.getSignature ?? []);
     }
-    /**
-     * Traverse all potential child reflections of this reflection.
-     *
-     * The given callback will be invoked for all children, signatures and type parameters
-     * attached to this reflection.
-     *
-     * @param callback  The callback function that should be applied for each child reflection.
-     */
     traverse(callback) {
         for (const parameter of this.typeParameters?.slice() || []) {
             if (callback(parameter, abstract_1.TraverseProperty.TypeParameter) === false) {

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

@@ -24,6 +24,7 @@ export declare enum ReflectionKind {
     Accessor = 262144,
     GetSignature = 524288,
     SetSignature = 1048576,
+    /** @deprecated will be removed in v0.25, not used */
     ObjectLiteral = 2097152,
     TypeAlias = 4194304,
     Reference = 8388608
@@ -64,4 +65,5 @@ export declare namespace ReflectionKind {
     const SignatureContainer: number;
     function singularString(kind: ReflectionKind): string;
     function pluralString(kind: ReflectionKind): string;
+    function classString(kind: ReflectionKind): string;
 }

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

@@ -27,6 +27,7 @@ var ReflectionKind;
     ReflectionKind[ReflectionKind["Accessor"] = 262144] = "Accessor";
     ReflectionKind[ReflectionKind["GetSignature"] = 524288] = "GetSignature";
     ReflectionKind[ReflectionKind["SetSignature"] = 1048576] = "SetSignature";
+    /** @deprecated will be removed in v0.25, not used */
     ReflectionKind[ReflectionKind["ObjectLiteral"] = 2097152] = "ObjectLiteral";
     ReflectionKind[ReflectionKind["TypeAlias"] = 4194304] = "TypeAlias";
     ReflectionKind[ReflectionKind["Reference"] = 8388608] = "Reference";
@@ -122,6 +123,10 @@ var ReflectionKind;
         }
     }
     ReflectionKind.pluralString = pluralString;
+    function classString(kind) {
+        return `tsd-kind-${ReflectionKind[kind].replace(/(.)([A-Z])/g, (_m, a, b) => `${a}-${b}`.toLowerCase())}`;
+    }
+    ReflectionKind.classString = classString;
 })(ReflectionKind = exports.ReflectionKind || (exports.ReflectionKind = {}));
 function getKindString(kind) {
     return ReflectionKind[kind].replace(/(.)([A-Z])/g, (_m, a, b) => a + " " + b.toLowerCase());

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

@@ -7,14 +7,6 @@ export declare class ParameterReflection extends Reflection {
     parent?: SignatureReflection;
     defaultValue?: string;
     type?: SomeType;
-    /**
-     * Traverse all potential child reflections of this reflection.
-     *
-     * The given callback will be invoked for all children, signatures and type parameters
-     * attached to this reflection.
-     *
-     * @param callback  The callback function that should be applied for each child reflection.
-     */
     traverse(callback: TraverseCallback): void;
     /**
      * Return a string representation of this reflection.

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

@@ -8,21 +8,12 @@ class ParameterReflection extends abstract_1.Reflection {
         super(...arguments);
         this.variant = "param";
     }
-    /**
-     * Traverse all potential child reflections of this reflection.
-     *
-     * The given callback will be invoked for all children, signatures and type parameters
-     * attached to this reflection.
-     *
-     * @param callback  The callback function that should be applied for each child reflection.
-     */
     traverse(callback) {
         if (this.type instanceof types_1.ReflectionType) {
             if (callback(this.type.declaration, abstract_1.TraverseProperty.TypeLiteral) === false) {
                 return;
             }
         }
-        super.traverse(callback);
     }
     /**
      * Return a string representation of this reflection.

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

@@ -18,6 +18,7 @@ export declare class ProjectReflection extends ContainerReflection {
     private reflectionIdToSymbolIdMap;
     private reflectionIdToSymbolMap;
     private referenceGraph?;
+    private reflectionChildren;
     /**
      * A list of all reflections within the project. DO NOT MUTATE THIS OBJECT.
      * All mutation should be done via {@link registerReflection} and {@link removeReflection}
@@ -63,6 +64,10 @@ export declare class ProjectReflection extends ContainerReflection {
      * project.
      */
     removeReflection(reflection: Reflection): void;
+    /**
+     * Remove a reflection without updating the parent reflection to remove references to the removed reflection.
+     */
+    private _removeReflection;
     /**
      * Gets the reflection registered for the given reflection ID, or undefined if it is not present
      * in the project.

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

@@ -24,6 +24,8 @@ class ProjectReflection extends container_1.ContainerReflection {
         this.symbolToReflectionIdMap = new map_1.StableKeyMap();
         this.reflectionIdToSymbolIdMap = new Map();
         this.reflectionIdToSymbolMap = new Map();
+        // Maps a reflection ID to all reflections with it as their parent.
+        this.reflectionChildren = new map_1.DefaultMap(() => []);
         /**
          * A list of all reflections within the project. DO NOT MUTATE THIS OBJECT.
          * All mutation should be done via {@link registerReflection} and {@link removeReflection}
@@ -55,6 +57,11 @@ class ProjectReflection extends container_1.ContainerReflection {
      */
     registerReflection(reflection, symbol) {
         this.referenceGraph = undefined;
+        if (reflection.parent) {
+            this.reflectionChildren
+                .get(reflection.parent.id)
+                .push(reflection.id);
+        }
         this.reflections[reflection.id] = reflection;
         if (symbol) {
             const id = new ReflectionSymbolId_1.ReflectionSymbolId(symbol);
@@ -69,15 +76,13 @@ class ProjectReflection extends container_1.ContainerReflection {
      * project.
      */
     removeReflection(reflection) {
-        // Remove references
-        for (const id of this.getReferenceGraph().get(reflection.id) ?? []) {
-            const ref = this.getReflectionById(id);
-            if (ref) {
-                this.removeReflection(ref);
-            }
-        }
-        this.getReferenceGraph().delete(reflection.id);
-        reflection.traverse((child) => (this.removeReflection(child), true));
+        // Remove the reflection...
+        this._removeReflection(reflection);
+        // And now try to remove references to it in the parent reflection.
+        // This might not find anything if someone called removeReflection on a member of a union
+        // but I think that could only be caused by a plugin doing something weird, not by a regular
+        // user... so this is probably good enough for now. Reflections that live on types are
+        // kind of half-real anyways.
         const parent = reflection.parent;
         parent?.traverse((child, property) => {
             if (child !== reflection) {
@@ -109,6 +114,32 @@ class ProjectReflection extends container_1.ContainerReflection {
             }
             return false; // Stop iteration
         });
+    }
+    /**
+     * Remove a reflection without updating the parent reflection to remove references to the removed reflection.
+     */
+    _removeReflection(reflection) {
+        // Remove references pointing to this reflection
+        const graph = this.getReferenceGraph();
+        for (const id of graph.get(reflection.id) ?? []) {
+            const ref = this.getReflectionById(id);
+            if (ref) {
+                this.removeReflection(ref);
+            }
+        }
+        graph.delete(reflection.id);
+        // Remove children of this reflection
+        for (const childId of this.reflectionChildren.getNoInsert(reflection.id) || []) {
+            const child = this.getReflectionById(childId);
+            // Only remove if the child's parent is still actually this reflection.
+            // This might not be the case if a plugin has moved this reflection to another parent.
+            // (typedoc-plugin-merge-modules)
+            if (child?.parent === reflection) {
+                this._removeReflection(child);
+            }
+        }
+        this.reflectionChildren.delete(reflection.id);
+        // Remove references from the TS symbol to this reflection.
         const symbol = this.reflectionIdToSymbolMap.get(reflection.id);
         if (symbol) {
             const id = new ReflectionSymbolId_1.ReflectionSymbolId(symbol);

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

@@ -36,14 +36,6 @@ export declare class SignatureReflection extends Reflection {
      * Applies to class members.
      */
     implementationOf?: ReferenceType;
-    /**
-     * Traverse all potential child reflections of this reflection.
-     *
-     * The given callback will be invoked for all children, signatures and type parameters
-     * attached to this reflection.
-     *
-     * @param callback  The callback function that should be applied for each child reflection.
-     */
     traverse(callback: TraverseCallback): void;
     /**
      * Return a string representation of this reflection.

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

@@ -9,14 +9,6 @@ class SignatureReflection extends abstract_1.Reflection {
         super(name, kind, parent);
         this.variant = "signature";
     }
-    /**
-     * Traverse all potential child reflections of this reflection.
-     *
-     * The given callback will be invoked for all children, signatures and type parameters
-     * attached to this reflection.
-     *
-     * @param callback  The callback function that should be applied for each child reflection.
-     */
     traverse(callback) {
         if (this.type instanceof types_1.ReflectionType) {
             if (callback(this.type.declaration, abstract_1.TraverseProperty.TypeLiteral) === false) {
@@ -33,7 +25,6 @@ class SignatureReflection extends abstract_1.Reflection {
                 return;
             }
         }
-        super.traverse(callback);
     }
     /**
      * Return a string representation of this reflection.

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

@@ -1,5 +1,5 @@
 import type { SomeType } from "../types";
-import { Reflection } from "./abstract";
+import { Reflection, TraverseCallback } from "./abstract";
 import type { DeclarationReflection } from "./declaration";
 import type { Serializer, JSONOutput, Deserializer } from "../../serialization";
 import type { SignatureReflection } from "./signature";
@@ -22,4 +22,5 @@ export declare class TypeParameterReflection extends Reflection {
     constructor(name: string, parent: Reflection, varianceModifier: VarianceModifier | undefined);
     toObject(serializer: Serializer): JSONOutput.TypeParameterReflection;
     fromObject(de: Deserializer, obj: JSONOutput.TypeParameterReflection): void;
+    traverse(_callback: TraverseCallback): void;
 }

package/dist/lib/models/reflections/type-parameter.js

@@ -33,5 +33,8 @@ class TypeParameterReflection extends abstract_1.Reflection {
         this.default = de.reviveType(obj.default);
         this.varianceModifier = obj.varianceModifier;
     }
+    traverse(_callback) {
+        // do nothing, no child reflections.
+    }
 }
 exports.TypeParameterReflection = TypeParameterReflection;

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

@@ -216,11 +216,11 @@ export declare class MappedType extends Type {
     parameter: string;
     parameterType: SomeType;
     templateType: SomeType;
-    readonlyModifier?: "-" | "+" | undefined;
-    optionalModifier?: "-" | "+" | undefined;
+    readonlyModifier?: "+" | "-" | undefined;
+    optionalModifier?: "+" | "-" | undefined;
     nameType?: SomeType | undefined;
     readonly type = "mapped";
-    constructor(parameter: string, parameterType: SomeType, templateType: SomeType, readonlyModifier?: "-" | "+" | undefined, optionalModifier?: "-" | "+" | undefined, nameType?: SomeType | undefined);
+    constructor(parameter: string, parameterType: SomeType, templateType: SomeType, readonlyModifier?: "+" | "-" | undefined, optionalModifier?: "+" | "-" | undefined, nameType?: SomeType | undefined);
     protected getTypeString(): string;
     needsParenthesis(): boolean;
     toObject(serializer: Serializer): JSONOutput.MappedType;
@@ -343,12 +343,23 @@ export declare class ReferenceType extends Type {
      * points to the url that this type should be linked to.
      */
     externalUrl?: string;
+    /**
+     * If set, no warnings about something not being exported should be created
+     * since this may be referring to a type created with `infer X` which will not
+     * be registered on the project.
+     */
+    refersToTypeParameter: boolean;
     private _target;
     private _project;
     private constructor();
     static createResolvedReference(name: string, target: Reflection | number, project: ProjectReflection | null): ReferenceType;
     static createSymbolReference(symbol: ts.Symbol, context: Context, name?: string): ReferenceType;
-    /** @internal this is used for type parameters, which don't actually point to something */
+    /**
+     * This is used for type parameters, which don't actually point to something,
+     * and also for temporary references which will be cleaned up with real references
+     * later during conversion.
+     * @internal
+     */
     static createBrokenReference(name: string, project: ProjectReflection): ReferenceType;
     protected getTypeString(): string;
     needsParenthesis(): boolean;