typedoc 0.27.3 → 0.27.5

package/README.md

@@ -2,9 +2,6 @@
 
 Documentation generator for TypeScript projects.
 
-[![CI](https://github.com/TypeStrong/typedoc/workflows/CI/badge.svg)](https://github.com/TypeStrong/typedoc/actions)
-[![NPM Version](https://img.shields.io/npm/v/typedoc?color=33cd56&logo=npm)](https://www.npmjs.com/package/typedoc)
-
 ## Documentation
 
 For more detailed documentation, the changelog, and TypeDoc documentation rendered with TypeDoc, see https://typedoc.org.

package/dist/index.d.ts

@@ -1,5 +1,10 @@
 /**
  * @module TypeDoc API
+ *
+ * In addition to the members documented here, TypeDoc exports a `typedoc/debug`
+ * entry point which exports some functions which may be useful during plugin
+ * development or debugging. Exports from that entry point are **not stable**
+ * and may change or be removed at any time.
  */
 export { Application, type ApplicationEvents } from "./lib/application.js";
 export { EventDispatcher } from "./lib/utils/events.js";

package/dist/index.js

@@ -1,5 +1,10 @@
 /**
  * @module TypeDoc API
+ *
+ * In addition to the members documented here, TypeDoc exports a `typedoc/debug`
+ * entry point which exports some functions which may be useful during plugin
+ * development or debugging. Exports from that entry point are **not stable**
+ * and may change or be removed at any time.
  */
 export { Application } from "./lib/application.js";
 export { EventDispatcher } from "./lib/utils/events.js";

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

@@ -107,17 +107,29 @@ function* lexBlockComment2(file, pos, end, linkTags, checker) {
                 break;
             case "`": {
                 // Markdown's code rules are a royal pain. This could be one of several things.
-                // 1. Inline code: <1-n ticks><text><same number of ticks>
-                // 2. Code block: <3 ticks><language, no ticks>\n<text>\n<3 ticks>\n
+                // 1. Inline code: <1-n ticks><text without multiple consecutive newlines or ticks at start of line><same number of ticks>
+                // 2. Code block: <newline><3+ ticks><language, no ticks>\n<text>\n<3 ticks>\n
                 // 3. Unmatched tick(s), not code, but part of some text.
                 // We don't quite handle #2 correctly yet. PR welcome!
                 braceStartsType = false;
                 let tickCount = 1;
-                let lookahead = pos;
+                let lookahead = pos - 1;
+                let atNewline = true;
+                while (lookahead > 0 && file[lookahead] !== "\n") {
+                    if (/\S/.test(file[lookahead])) {
+                        if (!commentHasStars || file[lookahead] !== "*") {
+                            atNewline = false;
+                            break;
+                        }
+                    }
+                    --lookahead;
+                }
+                lookahead = pos;
                 while (lookahead + 1 < end && file[lookahead + 1] === "`") {
                     tickCount++;
                     lookahead++;
                 }
+                const isCodeBlock = atNewline && tickCount >= 3;
                 let lookaheadStart = pos;
                 const codeText = [];
                 lookahead++;
@@ -125,12 +137,18 @@ function* lexBlockComment2(file, pos, end, linkTags, checker) {
                     if (lookaheadExactlyNTicks(lookahead, tickCount)) {
                         lookahead += tickCount;
                         codeText.push(file.substring(lookaheadStart, lookahead));
-                        yield {
-                            kind: TokenSyntaxKind.Code,
-                            text: codeText.join(""),
-                            pos,
-                        };
-                        pos = lookahead;
+                        const codeTextStr = codeText.join("");
+                        if (isCodeBlock || !/\n\s*\n/.test(codeTextStr)) {
+                            yield {
+                                kind: TokenSyntaxKind.Code,
+                                text: codeTextStr,
+                                pos,
+                            };
+                            pos = lookahead;
+                        }
+                        else {
+                            yield makeToken(TokenSyntaxKind.Text, tickCount);
+                        }
                         break;
                     }
                     else if (file[lookahead] === "`") {
@@ -167,7 +185,7 @@ function* lexBlockComment2(file, pos, end, linkTags, checker) {
                     }
                 }
                 if (lookahead >= end && pos !== lookahead) {
-                    if (tickCount === 3 &&
+                    if (isCodeBlock &&
                         file.substring(pos, end).includes("\n")) {
                         codeText.push(file.substring(lookaheadStart, end));
                         yield {

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

@@ -174,8 +174,14 @@ function resolveKeyword(refl, kw) {
 function resolveSymbolReferencePart(refl, path) {
     let high = [];
     let low = [];
-    if (!(refl instanceof ContainerReflection) ||
-        !refl.childrenIncludingDocuments) {
+    let children;
+    if (refl instanceof ContainerReflection) {
+        children = refl.childrenIncludingDocuments;
+    }
+    if (!children && refl.isDeclaration() && refl.type?.type === "reflection") {
+        children = refl.type.declaration.childrenIncludingDocuments;
+    }
+    if (!children) {
         return { high, low };
     }
     switch (path.navigation) {
@@ -184,16 +190,16 @@ function resolveSymbolReferencePart(refl, path) {
         // so that resolution doesn't behave very poorly with projects using JSDoc style resolution.
         // Also is more consistent with how TypeScript resolves link tags.
         case ".":
-            high = refl.childrenIncludingDocuments.filter((r) => r.name === path.path &&
+            high = children.filter((r) => r.name === path.path &&
                 (r.kindOf(ReflectionKind.SomeExport) || r.flags.isStatic));
-            low = refl.childrenIncludingDocuments.filter((r) => r.name === path.path &&
+            low = children.filter((r) => r.name === path.path &&
                 (!r.kindOf(ReflectionKind.SomeExport) || !r.flags.isStatic));
             break;
         // Resolve via "members", interface children, class instance properties/accessors/methods,
         // enum members, type literal properties
         case "#":
             high =
-                refl.children?.filter((r) => {
+                children?.filter((r) => {
                     return (r.name === path.path &&
                         r.kindOf(ReflectionKind.SomeMember) &&
                         !r.flags.isStatic);
@@ -203,7 +209,7 @@ function resolveSymbolReferencePart(refl, path) {
         // module/namespace exports since TypeDoc doesn't support documenting locals.
         case "~":
             if (refl.kindOf(ReflectionKind.SomeModule | ReflectionKind.Project)) {
-                high = refl.children?.filter((r) => r.name === path.path) || [];
+                high = children?.filter((r) => r.name === path.path) || [];
             }
             break;
     }

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

@@ -65,11 +65,21 @@ function* lexLineComments2(file, pos, end) {
                 // We don't quite handle #2 correctly yet. PR welcome!
                 braceStartsType = false;
                 let tickCount = 1;
-                let lookahead = pos;
+                let lookahead = pos - 1;
+                let atNewline = true;
+                while (lookahead > 0 && file[lookahead] !== "\n") {
+                    if (/\S/.test(file[lookahead])) {
+                        atNewline = false;
+                        break;
+                    }
+                    --lookahead;
+                }
+                lookahead = pos;
                 while (lookahead + 1 < end && file[lookahead + 1] === "`") {
                     tickCount++;
                     lookahead++;
                 }
+                const isCodeBlock = atNewline && tickCount >= 3;
                 let lookaheadStart = pos;
                 const codeText = [];
                 lookahead++;
@@ -77,12 +87,18 @@ function* lexLineComments2(file, pos, end) {
                     if (lookaheadExactlyNTicks(lookahead, tickCount)) {
                         lookahead += tickCount;
                         codeText.push(file.substring(lookaheadStart, lookahead));
-                        yield {
-                            kind: TokenSyntaxKind.Code,
-                            text: codeText.join(""),
-                            pos,
-                        };
-                        pos = lookahead;
+                        const codeTextStr = codeText.join("");
+                        if (isCodeBlock || !/\n\s*\n/.test(codeTextStr)) {
+                            yield {
+                                kind: TokenSyntaxKind.Code,
+                                text: codeTextStr,
+                                pos,
+                            };
+                            pos = lookahead;
+                        }
+                        else {
+                            yield makeToken(TokenSyntaxKind.Text, tickCount);
+                        }
                         break;
                     }
                     else if (file[lookahead] === "`") {

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

@@ -1,5 +1,5 @@
 import ts from "typescript";
-import { DeclarationReflection, Reflection, ReflectionSymbolId, } from "../../models/index.js";
+import { DeclarationReflection, Reflection, ReflectionKind, ReflectionSymbolId, } from "../../models/index.js";
 import { parseDeclarationReference, } from "./declarationReference.js";
 import { resolveDeclarationReference } from "./declarationReferenceResolver.js";
 const urlPrefix = /^(http|ftp)s?:\/\//;
@@ -45,9 +45,14 @@ function resolveLinkTag(reflection, part, externalResolver, options) {
     const declRef = parseDeclarationReference(part.text, pos, end);
     // Might already know where it should go if useTsLinkResolution is turned on
     if (part.target instanceof ReflectionSymbolId) {
-        const tsTarget = reflection.project.getReflectionFromSymbolId(part.target);
-        if (tsTarget) {
-            target = tsTarget;
+        const tsTargets = reflection.project.getReflectionsFromSymbolId(part.target);
+        if (tsTargets.length) {
+            // Find the target most likely to have a real url in the generated documentation
+            target =
+                tsTargets.find((r) => r.kindOf(ReflectionKind.SomeExport)) ||
+                    tsTargets.find((r) => r.kindOf(ReflectionKind.SomeMember) &&
+                        r.parent?.kindOf(ReflectionKind.SomeExport)) ||
+                    tsTargets[0];
             pos = end;
             defaultDisplayText =
                 part.tsLinkText ||

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

@@ -43,19 +43,14 @@ function* lexCommentString2(file) {
     while (pos < end && /\s/.test(file[end - 1])) {
         end--;
     }
-    let lineStart = true;
     let expectingTag = false;
     for (;;) {
         if (pos >= end) {
             return;
         }
-        if (lineStart) {
-            lineStart = false;
-        }
         switch (file[pos]) {
             case "\n":
                 yield makeToken(TokenSyntaxKind.NewLine, 1);
-                lineStart = true;
                 expectingTag = false;
                 break;
             case "{":
@@ -68,16 +63,26 @@ function* lexCommentString2(file) {
                 break;
             case "`": {
                 // Markdown's code rules are a royal pain. This could be one of several things.
-                // 1. Inline code: <1-n ticks><text><same number of ticks>
-                // 2. Code block: <3 ticks><language, no ticks>\n<text>\n<3 ticks>\n
+                // 1. Inline code: <1-n ticks><text without multiple consecutive newlines or ticks at start of line><same number of ticks>
+                // 2. Code block: <newline><3+ ticks><language, no ticks>\n<text>\n<3 ticks>\n
                 // 3. Unmatched tick(s), not code, but part of some text.
                 // We don't quite handle #2 correctly yet. PR welcome!
                 let tickCount = 1;
-                let lookahead = pos;
+                let lookahead = pos - 1;
+                let atNewline = true;
+                while (lookahead > 0 && file[lookahead] !== "\n") {
+                    if (/\S/.test(file[lookahead])) {
+                        atNewline = false;
+                        break;
+                    }
+                    --lookahead;
+                }
+                lookahead = pos;
                 while (lookahead + 1 < end && file[lookahead + 1] === "`") {
                     tickCount++;
                     lookahead++;
                 }
+                const isCodeBlock = atNewline && tickCount >= 3;
                 let lookaheadStart = pos;
                 const codeText = [];
                 lookahead++;
@@ -85,13 +90,20 @@ function* lexCommentString2(file) {
                     if (lookaheadExactlyNTicks(lookahead, tickCount)) {
                         lookahead += tickCount;
                         codeText.push(file.substring(lookaheadStart, lookahead));
-                        yield {
-                            kind: TokenSyntaxKind.Code,
-                            text: codeText.join(""),
-                            pos,
-                        };
-                        expectingTag = false;
-                        pos = lookahead;
+                        const codeTextStr = codeText.join("");
+                        if (isCodeBlock || !/\n\s*\n/.test(codeTextStr)) {
+                            yield {
+                                kind: TokenSyntaxKind.Code,
+                                text: codeTextStr,
+                                pos,
+                            };
+                            expectingTag = false;
+                            pos = lookahead;
+                        }
+                        else {
+                            yield makeToken(TokenSyntaxKind.Text, tickCount);
+                            expectingTag = false;
+                        }
                         break;
                     }
                     else if (file[lookahead] === "`") {
@@ -114,7 +126,7 @@ function* lexCommentString2(file) {
                     }
                 }
                 if (lookahead >= end && pos !== lookahead) {
-                    if (tickCount === 3 &&
+                    if (isCodeBlock &&
                         file.substring(pos, end).includes("\n")) {
                         codeText.push(file.substring(lookaheadStart, end));
                         yield {

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

@@ -81,6 +81,7 @@ export function textContent(sourcePath, token, i18n, warning, outContent, files,
             addRef(tagLink);
             continue;
         }
+        data.atNewLine = token.text[data.pos] === "\n";
         ++data.pos;
     }
     if (lastPartEnd !== token.text.length) {

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

@@ -1,6 +1,7 @@
 export declare const ConverterEvents: {
     readonly BEGIN: "begin";
     readonly END: "end";
+    readonly CREATE_PROJECT: "createProject";
     readonly CREATE_DECLARATION: "createDeclaration";
     readonly CREATE_DOCUMENT: "createDocument";
     readonly CREATE_SIGNATURE: "createSignature";

package/dist/lib/converter/converter-events.js

@@ -1,6 +1,7 @@
 export const ConverterEvents = {
     BEGIN: "begin",
     END: "end",
+    CREATE_PROJECT: "createProject",
     CREATE_DECLARATION: "createDeclaration",
     CREATE_DOCUMENT: "createDocument",
     CREATE_SIGNATURE: "createSignature",

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

@@ -13,6 +13,7 @@ import type { FileRegistry } from "../models/FileRegistry.js";
 export interface ConverterEvents {
     begin: [Context];
     end: [Context];
+    createProject: [Context, ProjectReflection];
     createDeclaration: [Context, DeclarationReflection];
     createDocument: [undefined, DocumentReflection];
     createSignature: [
@@ -83,12 +84,25 @@ export declare class Converter extends AbstractComponent<Application, ConverterE
     /**
      * Factory events
      */
+    /**
+     * Triggered when the converter has created a project reflection.
+     * The listener will be given {@link Context} and a {@link Models.ProjectReflection}.
+     * @event
+     */
+    static readonly EVENT_CREATE_PROJECT: "createProject";
     /**
      * Triggered when the converter has created a declaration reflection.
      * The listener will be given {@link Context} and a {@link Models.DeclarationReflection}.
      * @event
      */
     static readonly EVENT_CREATE_DECLARATION: "createDeclaration";
+    /**
+     * Triggered when the converter has created a document reflection.
+     * The listener will be given `undefined` (for consistency with the
+     * other create events) and a {@link Models.DocumentReflection}.
+     * @event
+     */
+    static readonly EVENT_CREATE_DOCUMENT: "createDocument";
     /**
      * Triggered when the converter has created a signature reflection.
      * The listener will be given {@link Context}, {@link Models.SignatureReflection} | {@link Models.ProjectReflection} the declaration,

package/dist/lib/converter/converter.js

@@ -195,12 +195,25 @@ let Converter = (() => {
         /**
          * Factory events
          */
+        /**
+         * Triggered when the converter has created a project reflection.
+         * The listener will be given {@link Context} and a {@link Models.ProjectReflection}.
+         * @event
+         */
+        static EVENT_CREATE_PROJECT = ConverterEvents.CREATE_PROJECT;
         /**
          * Triggered when the converter has created a declaration reflection.
          * The listener will be given {@link Context} and a {@link Models.DeclarationReflection}.
          * @event
          */
         static EVENT_CREATE_DECLARATION = ConverterEvents.CREATE_DECLARATION;
+        /**
+         * Triggered when the converter has created a document reflection.
+         * The listener will be given `undefined` (for consistency with the
+         * other create events) and a {@link Models.DocumentReflection}.
+         * @event
+         */
+        static EVENT_CREATE_DOCUMENT = ConverterEvents.CREATE_DOCUMENT;
         /**
          * Triggered when the converter has created a signature reflection.
          * The listener will be given {@link Context}, {@link Models.SignatureReflection} | {@link Models.ProjectReflection} the declaration,
@@ -386,6 +399,9 @@ let Converter = (() => {
                     ? opts.getValue("alwaysCreateEntryPointModule")
                     : !!context.scope.documents;
             }
+            if (createModuleReflections) {
+                this.trigger(ConverterEvents.CREATE_PROJECT, context, context.project);
+            }
             entries.forEach((e) => {
                 context.setActiveProgram(e.entryPoint.program);
                 e.context = this.convertExports(context, e.entryPoint, createModuleReflections);
@@ -412,6 +428,7 @@ let Converter = (() => {
                     ? context.getComment(symbol, context.project.kind)
                     : context.getFileComment(node);
                 this.processDocumentTags(context.project, context.project);
+                this.trigger(ConverterEvents.CREATE_PROJECT, context, context.project);
                 moduleContext = context;
             }
             else {

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

@@ -432,7 +432,7 @@ let CommentPlugin = (() => {
                 }
                 // Any cascaded tags will show up twice, once on this and once on our signatures
                 // This is completely redundant, so remove them from the wrapping function.
-                if (sigs.length) {
+                if (sigs.length && reflection.type?.type !== "reflection") {
                     for (const mod of this.cascadedModifierTags) {
                         reflection.comment.modifierTags.delete(mod);
                     }
@@ -485,8 +485,9 @@ let CommentPlugin = (() => {
         }
         cascadeModifiers(reflection) {
             const parentComment = reflection.parent?.comment;
-            if (!parentComment)
+            if (!parentComment || reflection.kindOf(ReflectionKind.TypeLiteral)) {
                 return;
+            }
             const childMods = reflection.comment?.modifierTags ?? new Set();
             for (const mod of this.cascadedModifierTags) {
                 if (parentComment.hasModifier(mod)) {

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

@@ -14,6 +14,7 @@ export class IncludePlugin extends ConverterComponent {
     constructor(owner) {
         super(owner);
         const onCreate = this.onCreate.bind(this);
+        owner.on(ConverterEvents.CREATE_PROJECT, onCreate);
         owner.on(ConverterEvents.CREATE_DOCUMENT, onCreate);
         owner.on(ConverterEvents.CREATE_DECLARATION, onCreate);
         owner.on(ConverterEvents.CREATE_PARAMETER, onCreate);

package/dist/lib/debug/debugReflectionLifetimes.d.ts

@@ -0,0 +1,2 @@
+import type { Application } from "../application.js";
+export declare function debugReflectionLifetimes(app: Application): void;

package/dist/lib/debug/debugReflectionLifetimes.js

@@ -0,0 +1,19 @@
+import { ConverterEvents } from "../converter/converter-events.js";
+export function debugReflectionLifetimes(app) {
+    app.converter.on(ConverterEvents.CREATE_PROJECT, logCreate);
+    app.converter.on(ConverterEvents.CREATE_SIGNATURE, logCreate);
+    app.converter.on(ConverterEvents.CREATE_TYPE_PARAMETER, logCreate);
+    app.converter.on(ConverterEvents.CREATE_DECLARATION, logCreate);
+    app.converter.on(ConverterEvents.CREATE_DOCUMENT, logCreate);
+    app.converter.on(ConverterEvents.CREATE_PARAMETER, logCreate);
+    app.converter.on(ConverterEvents.CREATE_PROJECT, (_context, project) => {
+        const oldRemove = project["_removeReflection"];
+        project["_removeReflection"] = function (reflection) {
+            console.log("Remove", reflection.id, reflection.getFullName());
+            return oldRemove.call(this, reflection);
+        };
+    });
+}
+function logCreate(_context, refl) {
+    console.log("Create", refl.variant, refl.id, refl.getFullName());
+}

package/dist/lib/debug/debugRendererUrls.d.ts

@@ -0,0 +1,5 @@
+import type { Application } from "../application.js";
+export declare function debugRendererUrls(app: Application, { json, logs }?: {
+    logs?: true;
+    json?: boolean | undefined;
+}): void;

package/dist/lib/debug/debugRendererUrls.js

@@ -0,0 +1,59 @@
+/* eslint-disable no-console */
+import { join } from "node:path";
+import { Reflection, ReflectionKind, } from "../models/index.js";
+const serializer = {
+    priority: 0,
+    supports(x) {
+        return x instanceof Reflection;
+    },
+    toObject(item, obj) {
+        obj.url = item.url;
+        obj.hasOwnDocument = item.hasOwnDocument;
+        // obj.anchor = item.anchor;
+        delete obj.sources;
+        delete obj.groups;
+        delete obj.categories;
+        delete obj.readme;
+        delete obj.content;
+        obj.kind = ReflectionKind[obj.kind];
+        delete obj.flags;
+        delete obj.defaultValue;
+        delete obj.symbolIdMap;
+        delete obj.files;
+        delete obj.packageName;
+        delete obj.variant;
+        delete obj.extendedTypes;
+        delete obj.inheritedFrom;
+        if (!["reflection", "reference"].includes(obj.type?.type)) {
+            delete obj.type;
+        }
+        if (obj.comment) {
+            obj.comment.summary = obj.comment.summary.filter((part) => part.kind === "inline-tag");
+            obj.comment.blockTags = obj.comment.blockTags?.filter((tag) => {
+                tag.content = tag.content.filter((part) => part.kind === "inline-tag");
+                return tag.content.length;
+            });
+            if (!obj.comment.summary.length &&
+                !obj.comment.blockTags?.length &&
+                !obj.comment.modifierTags) {
+                delete obj.comment;
+            }
+        }
+        return obj;
+    },
+};
+export function debugRendererUrls(app, { json = false, logs = false } = { logs: true }) {
+    app.renderer.postRenderAsyncJobs.push(async (evt) => {
+        if (json) {
+            app.serializer.addSerializer(serializer);
+            await app.generateJson(evt.project, join(evt.outputDirectory, "url_debug.json"));
+            app.serializer.removeSerializer(serializer);
+        }
+        if (logs) {
+            for (const id in evt.project.reflections) {
+                const refl = evt.project.reflections[id];
+                console.log(refl.id, refl.getFullName(), refl.url, refl.hasOwnDocument);
+            }
+        }
+    });
+}

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

@@ -0,0 +1,2 @@
+export { debugRendererUrls } from "./debugRendererUrls.js";
+export { debugReflectionLifetimes } from "./debugReflectionLifetimes.js";

package/dist/lib/debug/index.js

@@ -0,0 +1,2 @@
+export { debugRendererUrls } from "./debugRendererUrls.js";
+export { debugReflectionLifetimes } from "./debugReflectionLifetimes.js";

package/dist/lib/internationalization/internationalization.d.ts

@@ -2,7 +2,6 @@ import type { Application } from "../application.js";
 import { ReflectionKind } from "../models/reflections/kind.js";
 import { ReflectionFlag } from "../models/index.js";
 import { type BuiltinTranslatableStringArgs } from "./translatable.js";
-import translatable from "./locales/en.cjs";
 /**
  * ### What is translatable?
  * TypeDoc includes a lot of literal strings. By convention, messages which are displayed
@@ -75,7 +74,7 @@ export declare class Internationalization {
      * Get the translation of the specified key, replacing placeholders
      * with the arguments specified.
      */
-    translate<T extends keyof typeof translatable>(key: T, ...args: TranslatableStrings[T]): TranslatedString;
+    translate<T extends keyof TranslatableStrings>(key: T, ...args: TranslatableStrings[T]): TranslatedString;
     kindSingularString(kind: ReflectionKind): TranslatedString;
     kindPluralString(kind: ReflectionKind): TranslatedString;
     flagString(flag: ReflectionFlag): TranslatedString;

package/dist/lib/internationalization/locales/en.cjs

@@ -61,6 +61,7 @@ module.exports = {
     reflection_0_kind_1_defined_in_2_does_not_have_any_documentation: `{0} ({1}), defined in {2}, does not have any documentation`,
     invalid_intentionally_not_exported_symbols_0: "The following symbols were marked as intentionally not exported, but were either not referenced in the documentation, or were exported:\n\t{0}",
     reflection_0_has_unused_mergeModuleWith_tag: "{0} has a @mergeModuleWith tag which could not be resolved",
+    reflection_0_links_to_1_with_text_2_but_resolved_to_3: `"{0}" links to "{1}" with text "{2}" which exists but does not have a link in the documentation, will link to "{3}" instead.`,
     // conversion plugins
     not_all_search_category_boosts_used_0: `Not all categories specified in searchCategoryBoosts were used in the documentation. The unused categories were:\n\t{0}`,
     not_all_search_group_boosts_used_0: `Not all groups specified in searchGroupBoosts were used in the documentation. The unused groups were:\n\t{0}`,

package/dist/lib/internationalization/locales/en.d.cts

@@ -56,6 +56,7 @@ declare const _default: {
     readonly reflection_0_kind_1_defined_in_2_does_not_have_any_documentation: "{0} ({1}), defined in {2}, does not have any documentation";
     readonly invalid_intentionally_not_exported_symbols_0: "The following symbols were marked as intentionally not exported, but were either not referenced in the documentation, or were exported:\n\t{0}";
     readonly reflection_0_has_unused_mergeModuleWith_tag: "{0} has a @mergeModuleWith tag which could not be resolved";
+    readonly reflection_0_links_to_1_with_text_2_but_resolved_to_3: "\"{0}\" links to \"{1}\" with text \"{2}\" which exists but does not have a link in the documentation, will link to \"{3}\" instead.";
     readonly not_all_search_category_boosts_used_0: "Not all categories specified in searchCategoryBoosts were used in the documentation. The unused categories were:\n\t{0}";
     readonly not_all_search_group_boosts_used_0: "Not all groups specified in searchGroupBoosts were used in the documentation. The unused groups were:\n\t{0}";
     readonly comment_for_0_includes_categoryDescription_for_1_but_no_child_in_group: "Comment for {0} includes @categoryDescription for \"{1}\", but no child is placed in that category";

package/dist/lib/models/ReflectionCategory.js

@@ -52,7 +52,7 @@ export class ReflectionCategory {
             de.defer((project) => {
                 for (const childId of obj.children || []) {
                     const child = project.getReflectionById(de.oldIdToNewId[childId] ?? -1);
-                    if (child?.isDeclaration()) {
+                    if (child?.isDeclaration() || child?.isDocument()) {
                         this.children.push(child);
                     }
                 }

package/dist/lib/models/ReflectionGroup.js

@@ -68,7 +68,7 @@ export class ReflectionGroup {
             de.defer((project) => {
                 for (const childId of obj.children || []) {
                     const child = project.getReflectionById(de.oldIdToNewId[childId] ?? -1);
-                    if (child?.isDeclaration()) {
+                    if (child?.isDeclaration() || child?.isDocument()) {
                         this.children.push(child);
                     }
                 }

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

@@ -294,6 +294,7 @@ export class ProjectReflection extends ContainerReflection {
     }
     /** @internal */
     registerSymbolId(reflection, id) {
+        this.removedSymbolIds.delete(id);
         this.reflectionIdToSymbolIdMap.set(reflection.id, id);
         const previous = this.symbolToReflectionIdMap.get(id);
         if (previous) {

package/dist/lib/models/types.js

@@ -690,7 +690,11 @@ export class ReferenceType extends Type {
             : ReflectionKind.TypeReferenceTarget;
         const resolved = resolvePotential.find((refl) => refl.kindOf(kind)) ||
             resolvePotential.find((refl) => refl.kindOf(~kind));
-        this._target = resolved.id;
+        // Do not mark the type as resolved at this point so that if it
+        // points to a member which is removed (e.g. by typedoc-plugin-zod)
+        // and then replaced it still ends up pointing at the right reflection.
+        // We will lock type reference resolution when serializing to JSON.
+        // this._target = resolved.id;
         return resolved;
     }
     /**
@@ -820,6 +824,9 @@ export class ReferenceType extends Type {
         else if (this._project?.symbolIdHasBeenRemoved(this._target)) {
             target = -1;
         }
+        else if (this.reflection) {
+            target = this.reflection.id;
+        }
         else {
             target = this._target.toObject(serializer);
         }
@@ -837,7 +844,7 @@ export class ReferenceType extends Type {
         if (this.refersToTypeParameter) {
             result.refersToTypeParameter = true;
         }
-        if (typeof this._target !== "number" && this.preferValues) {
+        if (typeof target !== "number" && this.preferValues) {
             result.preferValues = true;
         }
         if (this.highlightedProperties) {