typedoc 0.28.8 → 0.28.10

package/dist/lib/application.js

@@ -59,7 +59,6 @@ import { Outputs } from "./output/output.js";
 import { validateMergeModuleWith } from "./validation/unusedMergeModuleWith.js";
 import { diagnostic, diagnostics } from "./utils/loggers.js";
 import { ValidatingFileRegistry } from "./utils/ValidatingFileRegistry.js";
-import { addInferredDeclarationMapPaths } from "./converter/factories/symbol-id.js";
 import { Internationalization } from "./internationalization/internationalization.js";
 const packageInfo = JSON.parse(readFileSync(Path.join(fileURLToPath(import.meta.url), "../../../package.json"), "utf8"));
 const supportedVersionMajorMinor = packageInfo.peerDependencies.typescript
@@ -626,7 +625,6 @@ let Application = (() => {
                     this.logger.error(i18n.nested_packages_unsupported_0(nicePath(dir)));
                     continue;
                 }
-                addInferredDeclarationMapPaths(opts.getCompilerOptions(), opts.getFileNames());
                 projectsToConvert.push({ dir, options: opts });
             }
             for (const { dir, options } of projectsToConvert) {

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

@@ -195,7 +195,13 @@ function checkReference(data) {
         while (/[ \t]/.test(token.text[lookahead])) {
             ++lookahead;
         }
-        if (token.text[lookahead] === "[") {
+        // #2991, we check that this reference also doesn't look like a footnote reference
+        // as it is unlikely that someone uses that syntax without intending for footnote behavior.
+        // This introduces a problem if someone has an [^ref] and doesn't intend for that to
+        // be interpreted as a footnote, but as a reference, but we can't have it both ways,
+        // and having people rename their reference to not be confused with a footnote isn't a
+        // horrible workaround.
+        if (token.text[lookahead] === "[" && token.text[lookahead + 1] !== "^") {
             while (lookahead < token.text.length &&
                 /[^\n\]]/.test(token.text[lookahead])) {
                 ++lookahead;

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

@@ -5,7 +5,7 @@ import { Context } from "./context.js";
 import { AbstractComponent } from "../utils/component.js";
 import { type GlobString, MinimalSourceFile } from "#utils";
 import type { DocumentationEntryPoint } from "../utils/entry-point.js";
-import type { CommentParserConfig } from "./comments/index.js";
+import { type CommentParserConfig } from "./comments/index.js";
 import type { CommentStyle, ValidationOptions } from "../utils/options/declaration.js";
 import { type ExternalResolveResult, type ExternalSymbolResolver } from "./comments/linkResolver.js";
 import { type DeclarationReference } from "#utils";

package/dist/lib/converter/converter.js

@@ -43,6 +43,7 @@ import { ConverterEvents } from "./converter-events.js";
 import { convertSymbol } from "./symbols.js";
 import { MinimatchSet, nicePath, normalizePath } from "../utils/paths.js";
 import { hasAllFlags, hasAnyFlag, i18n, MinimalSourceFile, NormalizedPathUtils, partition, unique, } from "#utils";
+import { clearCommentCache } from "./comments/index.js";
 import { parseCommentString } from "./comments/parser.js";
 import { lexCommentString } from "./comments/rawLexer.js";
 import { resolveLinks, resolvePartLinks, } from "./comments/linkResolver.js";
@@ -320,6 +321,9 @@ let Converter = (() => {
             delete this._config;
             delete this.excludeCache;
             delete this.externalPatternCache;
+            // Also clear the comment cache so if we convert this ts.Program again
+            // later we will re-parse comments.
+            clearCommentCache();
             return project;
         }
         /** @internal */

package/dist/lib/converter/factories/symbol-id.d.ts

@@ -1,4 +1,3 @@
 import { ReflectionSymbolId } from "#models";
 import ts from "typescript";
 export declare function createSymbolIdImpl(symbol: ts.Symbol, declaration?: ts.Declaration): ReflectionSymbolId;
-export declare function addInferredDeclarationMapPaths(opts: ts.CompilerOptions, files: readonly string[]): void;

package/dist/lib/converter/factories/symbol-id.js

@@ -1,10 +1,8 @@
 import { ReflectionSymbolId } from "#models";
-import { findPackageForPath, getCommonDirectory, getQualifiedName, normalizePath, readFile } from "#node-utils";
-import { Validation } from "#utils";
-import { existsSync } from "fs";
-import { join, relative, resolve } from "node:path";
+import { findPackageForPath, getQualifiedName, normalizePath, resolveDeclarationMaps } from "#node-utils";
+import {} from "#utils";
+import { relative } from "node:path";
 import ts from "typescript";
-const declarationMapCache = new Map();
 let transientCount = 0;
 const transientIds = new WeakMap();
 // Don't use this directly, use Context.createSymbolId instead.
@@ -47,48 +45,3 @@ export function createSymbolIdImpl(symbol, declaration) {
     id.fileName = normalizePath(sourceFileName);
     return id;
 }
-function resolveDeclarationMaps(file) {
-    if (!/\.d\.[cm]?ts$/.test(file))
-        return file;
-    if (declarationMapCache.has(file))
-        return declarationMapCache.get(file);
-    const mapFile = file + ".map";
-    if (!existsSync(mapFile))
-        return file;
-    let sourceMap;
-    try {
-        sourceMap = JSON.parse(readFile(mapFile));
-    }
-    catch {
-        return file;
-    }
-    if (Validation.validate({
-        file: String,
-        sourceRoot: Validation.optional(String),
-        sources: [Array, String],
-    }, sourceMap)) {
-        // There's a pretty large assumption in here that we only have
-        // 1 source file per js file. This is a pretty standard typescript approach,
-        // but people might do interesting things with transpilation that could break this.
-        let source = sourceMap.sources[0];
-        // If we have a sourceRoot, trim any leading slash from the source, and join them
-        // Similar to how it's done at https://github.com/mozilla/source-map/blob/58819f09018d56ef84dc41ba9c93f554e0645169/lib/util.js#L412
-        if (sourceMap.sourceRoot !== undefined) {
-            source = source.replace(/^\//, "");
-            source = join(sourceMap.sourceRoot, source);
-        }
-        const result = resolve(mapFile, "..", source);
-        declarationMapCache.set(file, result);
-        return result;
-    }
-    return file;
-}
-// See also: inferEntryPoints in entry-point.ts
-export function addInferredDeclarationMapPaths(opts, files) {
-    const rootDir = opts.rootDir || getCommonDirectory(files);
-    const declDir = opts.declarationDir || opts.outDir || rootDir;
-    for (const file of files) {
-        const mapFile = normalizePath(resolve(declDir, relative(rootDir, file)).replace(/\.([cm]?[tj]s)x?$/, ".d.$1"));
-        declarationMapCache.set(mapFile, file);
-    }
-}

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

@@ -95,18 +95,21 @@ export class ImplementsPlugin extends ConverterComponent {
         // serialization/deserialization, might point to an unexpected location. (See the mixin
         // converter tests, I suspect this might actually be an indication of something else slightly
         // broken there, but don't want to spend more time with this right now.)
+        // #2982, even more unfortunately, we only want to keep the link if it is pointing to a reflection
+        // which will receive a link during rendering.
+        const isValidRef = (ref) => ref.reflection && !ref.reflection.parent?.kindOf(ReflectionKind.TypeLiteral);
         for (const child of reflection.children || []) {
-            if (child.inheritedFrom && !child.inheritedFrom.reflection) {
+            if (child.inheritedFrom && !isValidRef(child.inheritedFrom)) {
                 child.inheritedFrom = ReferenceType.createBrokenReference(child.inheritedFrom.name, project);
             }
-            if (child.overwrites && !child.overwrites.reflection) {
+            if (child.overwrites && !isValidRef(child.overwrites)) {
                 child.overwrites = ReferenceType.createBrokenReference(child.overwrites.name, project);
             }
             for (const childSig of child.getAllSignatures()) {
-                if (childSig.inheritedFrom && !childSig.inheritedFrom.reflection) {
+                if (childSig.inheritedFrom && !isValidRef(childSig.inheritedFrom)) {
                     childSig.inheritedFrom = ReferenceType.createBrokenReference(childSig.inheritedFrom.name, project);
                 }
-                if (childSig.overwrites && !childSig.overwrites.reflection) {
+                if (childSig.overwrites && !isValidRef(childSig.overwrites)) {
                     childSig.overwrites = ReferenceType.createBrokenReference(childSig.overwrites.name, project);
                 }
             }

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

@@ -37,7 +37,7 @@ import { ConverterComponent } from "../components.js";
 import { ApplicationEvents } from "../../application-events.js";
 import { ConverterEvents } from "../converter-events.js";
 import { i18n, MinimalSourceFile, NormalizedPathUtils } from "#utils";
-import { discoverPackageJson, getCommonDirectory, nicePath, normalizePath, Option, readFile, } from "#node-utils";
+import { deriveRootDir, discoverPackageJson, nicePath, normalizePath, Option, readFile, } from "#node-utils";
 import { existsSync } from "fs";
 /**
  * A handler that tries to find the package.json and readme.md files of the
@@ -117,7 +117,7 @@ let PackagePlugin = (() => {
             this.readmeContents = undefined;
             this.packageJson = undefined;
             const dirName = this.application.options.packageDir ??
-                Path.resolve(getCommonDirectory(this.entryPoints.map(g => `${g}/`)));
+                Path.resolve(deriveRootDir(this.entryPoints));
             this.application.logger.verbose(`Begin package.json search at ${nicePath(dirName)}`);
             const packageJson = discoverPackageJson(dirName);
             this.packageJson = packageJson?.content;

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

@@ -56,6 +56,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     open_brace_within_inline_tag: "在内联标签中遇到左括号，这可能是一个错误",
     inline_tag_not_closed: "内联标签未关闭",
     // validation
+    comment_for_0_links_to_1_not_included_in_docs_use_external_link_2: `{0} 注释中指向 “{1}” 的已解析的链接不会被包含在文档中。请将 {2} 导出或添加至 externalSymbolLinkMappings 选项以修复该警告`,
     failed_to_resolve_link_to_0_in_comment_for_1: "无法解析 {1} 注释中指向 “{0}” 的链接",
     failed_to_resolve_link_to_0_in_comment_for_1_may_have_meant_2: "无法解析 {1} 的注释中指向 “{0}” 的链接。您可能想要 “{2}”",
     failed_to_resolve_link_to_0_in_readme_for_1: "无法解析 {1} 的自述文件中指向 “{0}” 的链接",
@@ -71,8 +72,9 @@ module.exports = localeUtils.buildIncompleteTranslation({
     // conversion plugins
     not_all_search_category_boosts_used_0: "文档中并未使用 searchCategoryBoosts 中指定的所有类别。未使用的类别包括：\n{0}",
     not_all_search_group_boosts_used_0: "文档中并未使用 searchGroupBoosts 中指定的所有组。未使用的组为：\n{0}",
-    comment_for_0_includes_categoryDescription_for_1_but_no_child_in_group: "{0} 的评论包含“{1}”的 @categoryDescription，但该类别中没有子项",
-    comment_for_0_includes_groupDescription_for_1_but_no_child_in_group: "{0} 的注释包含“{1}”的 @groupDescription，但该组中没有子项",
+    comment_for_0_includes_categoryDescription_for_1_but_no_child_in_group: "{0} 的注释中包含了 “{1}” 的 @categoryDescription，但该类别中没有子项",
+    comment_for_0_includes_groupDescription_for_1_but_no_child_in_group: "{0} 的注释中包含了 “{1}” 的 @groupDescription，但该分组中没有子项",
+    comment_for_0_specifies_1_as_sort_strategy_but_only_2_is_valid: `{0} 的注释中指定的 “{1}” 的 @sortStrategy 无效，以下是有效的选项：\n\t{2}`,
     label_0_for_1_cannot_be_referenced: "无法使用声明引用来引用 {1} 的标签“{0}”。标签只能包含 A-Z、0-9 和 _，并且不能以数字开头",
     modifier_tag_0_is_mutually_exclusive_with_1_in_comment_for_2: "修饰符标签 {0} 与 {2} 注释中的 {1} 互斥",
     signature_0_has_unused_param_with_name_1: "签名 {0} 有一个名为“{1}”的 @param，但未被使用",
@@ -130,6 +132,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     // options
     circular_reference_extends_0: "{0} 的“extends”字段出现循环引用",
     failed_resolve_0_to_file_in_1: "无法将 {0} 解析为 {1} 中的文件",
+    glob_0_should_use_posix_slash: `该 glob “{0}” 中转义了不是特殊字符的字符。输入 TypeDoc 的 glob 可能不会使用 Windows 路径分隔符（\\），请尝试将其替换为 POSIX 路径分隔符（/）`,
     option_0_can_only_be_specified_by_config_file: "“{0}”选项只能通过配置文件指定",
     option_0_expected_a_value_but_none_provided: "--{0} 需要一个值，但没有给出任何参数",
     unknown_option_0_may_have_meant_1: "未知选项：{0}，你可能指的是：\n\t{1}",
@@ -274,6 +277,8 @@ module.exports = localeUtils.buildIncompleteTranslation({
     useHostedBaseUrlForAbsoluteLinks_requires_hostedBaseUrl: "useHostedBaseUrlForAbsoluteLinks 选项要求设置 hostingBaseUrl",
     favicon_must_have_one_of_the_following_extensions_0: "favicon 的后缀名必须是下列之一：{0}",
     option_0_must_be_an_object: "“{0}”选项必须是非数组对象",
+    option_0_must_be_an_array_of_string: "“{0}”选项必须是字符串数组",
+    option_0_must_be_an_array_of_string_or_functions: "“{0}”选项必须是由字符串或函数构成的数组",
     option_0_must_be_a_function: "‘{0}’ 选项必须是一个函数",
     option_0_must_be_object_with_urls: "{0} 必须是具有字符串标签作为键和 URL 值的对象",
     visibility_filters_only_include_0: "visibilityFilters 只能包含以下非@键：{0}",
@@ -431,6 +436,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     tag_return: "返回",
     tag_satisfies: "满足",
     tag_since: "添加于",
+    tag_sortStrategy: "排序策略",
     tag_template: "类型参数",
     tag_type: "类型",
     tag_typedef: "类型定义",
@@ -460,6 +466,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     tag_virtual: "虚函数",
     tag_abstract: "抽象类",
     tag_class: "类",
+    tag_disableGroups: "禁用分组",
     tag_enum: "枚举",
     tag_event: "事件",
     tag_expand: "展开",

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

@@ -49,6 +49,7 @@ declare const _default: {
     unknown_inline_tag_0: "遇到未知的内联标签 {0}";
     open_brace_within_inline_tag: string;
     inline_tag_not_closed: string;
+    comment_for_0_links_to_1_not_included_in_docs_use_external_link_2: "{0} 注释中指向 “{1}” 的已解析的链接不会被包含在文档中。请将 {2} 导出或添加至 externalSymbolLinkMappings 选项以修复该警告";
     failed_to_resolve_link_to_0_in_comment_for_1: "无法解析 {1} 注释中指向 “{0}” 的链接";
     failed_to_resolve_link_to_0_in_comment_for_1_may_have_meant_2: "无法解析 {1} 的注释中指向 “{0}” 的链接。您可能想要 “{2}”";
     failed_to_resolve_link_to_0_in_readme_for_1: "无法解析 {1} 的自述文件中指向 “{0}” 的链接";
@@ -63,8 +64,9 @@ declare const _default: {
     reflection_0_links_to_1_with_text_2_but_resolved_to_3: "“{0}”中的链接“{2}”指向“{1}”，目标虽然存在但并没有直接的链接，因此将改为链接至“{3}”。";
     not_all_search_category_boosts_used_0: "文档中并未使用 searchCategoryBoosts 中指定的所有类别。未使用的类别包括：\n{0}";
     not_all_search_group_boosts_used_0: "文档中并未使用 searchGroupBoosts 中指定的所有组。未使用的组为：\n{0}";
-    comment_for_0_includes_categoryDescription_for_1_but_no_child_in_group: "{0} 的评论包含“{1}”的 @categoryDescription，但该类别中没有子项";
-    comment_for_0_includes_groupDescription_for_1_but_no_child_in_group: "{0} 的注释包含“{1}”的 @groupDescription，但该组中没有子项";
+    comment_for_0_includes_categoryDescription_for_1_but_no_child_in_group: "{0} 的注释中包含了 “{1}” 的 @categoryDescription，但该类别中没有子项";
+    comment_for_0_includes_groupDescription_for_1_but_no_child_in_group: "{0} 的注释中包含了 “{1}” 的 @groupDescription，但该分组中没有子项";
+    comment_for_0_specifies_1_as_sort_strategy_but_only_2_is_valid: "{0} 的注释中指定的 “{1}” 的 @sortStrategy 无效，以下是有效的选项：\n\t{2}";
     label_0_for_1_cannot_be_referenced: "无法使用声明引用来引用 {1} 的标签“{0}”。标签只能包含 A-Z、0-9 和 _，并且不能以数字开头";
     modifier_tag_0_is_mutually_exclusive_with_1_in_comment_for_2: "修饰符标签 {0} 与 {2} 注释中的 {1} 互斥";
     signature_0_has_unused_param_with_name_1: "签名 {0} 有一个名为“{1}”的 @param，但未被使用";
@@ -117,6 +119,7 @@ declare const _default: {
     saved_relative_path_0_resolved_from_1_does_not_exist: "序列化项目引用的 {0} 不存在或无法在 {1} 下找到";
     circular_reference_extends_0: "{0} 的“extends”字段出现循环引用";
     failed_resolve_0_to_file_in_1: "无法将 {0} 解析为 {1} 中的文件";
+    glob_0_should_use_posix_slash: "该 glob “{0}” 中转义了不是特殊字符的字符。输入 TypeDoc 的 glob 可能不会使用 Windows 路径分隔符（\\），请尝试将其替换为 POSIX 路径分隔符（/）";
     option_0_can_only_be_specified_by_config_file: "“{0}”选项只能通过配置文件指定";
     option_0_expected_a_value_but_none_provided: "--{0} 需要一个值，但没有给出任何参数";
     unknown_option_0_may_have_meant_1: "未知选项：{0}，你可能指的是：\n\t{1}";
@@ -256,6 +259,8 @@ declare const _default: {
     useHostedBaseUrlForAbsoluteLinks_requires_hostedBaseUrl: string;
     favicon_must_have_one_of_the_following_extensions_0: "favicon 的后缀名必须是下列之一：{0}";
     option_0_must_be_an_object: "“{0}”选项必须是非数组对象";
+    option_0_must_be_an_array_of_string: "“{0}”选项必须是字符串数组";
+    option_0_must_be_an_array_of_string_or_functions: "“{0}”选项必须是由字符串或函数构成的数组";
     option_0_must_be_a_function: "‘{0}’ 选项必须是一个函数";
     option_0_must_be_object_with_urls: "{0} 必须是具有字符串标签作为键和 URL 值的对象";
     visibility_filters_only_include_0: "visibilityFilters 只能包含以下非@键：{0}";
@@ -396,6 +401,7 @@ declare const _default: {
     tag_return: string;
     tag_satisfies: string;
     tag_since: string;
+    tag_sortStrategy: string;
     tag_template: string;
     tag_type: string;
     tag_typedef: string;
@@ -423,6 +429,7 @@ declare const _default: {
     tag_virtual: string;
     tag_abstract: string;
     tag_class: string;
+    tag_disableGroups: string;
     tag_enum: string;
     tag_event: string;
     tag_expand: string;

package/dist/lib/models/ProjectReflection.js

@@ -1,3 +1,37 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
 import { TraverseProperty } from "./Reflection.js";
 import { ContainerReflection } from "./ContainerReflection.js";
 import { ReferenceReflection } from "./ReferenceReflection.js";
@@ -5,7 +39,7 @@ import { IntrinsicType, makeRecursiveVisitor } from "./types.js";
 import { ReflectionKind } from "./kind.js";
 import { Comment } from "./Comment.js";
 import { ReflectionSymbolId } from "./ReflectionSymbolId.js";
-import { assertNever, DefaultMap, i18n, removeIfPresent, StableKeyMap } from "#utils";
+import { assertNever, DefaultMap, i18n, NonEnumerable, removeIfPresent, StableKeyMap, } from "#utils";
 // Keep this in sync with JSONOutput.SCHEMA_VERSION
 export const JSON_SCHEMA_VERSION = "2.0";
 /**
@@ -15,331 +49,369 @@ export const JSON_SCHEMA_VERSION = "2.0";
  * and source files of the processed project through this reflection.
  * @category Reflections
  */
-export class ProjectReflection extends ContainerReflection {
-    variant = "project";
-    // Used to resolve references.
-    symbolToReflectionIdMap = new StableKeyMap();
-    reflectionIdToSymbolIdMap = new Map();
-    removedSymbolIds = new StableKeyMap();
-    // Maps a reflection ID to all references eventually referring to it.
-    referenceGraph;
-    // Maps a reflection ID to all reflections with it as their parent.
-    reflectionChildren = new 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}
-     * to ensure that links to reflections remain valid.
-     *
-     * This may be replaced with a `Map<number, Reflection>` someday.
-     */
-    reflections = {};
-    /**
-     * The name of the package that this reflection documents according to package.json.
-     */
-    packageName;
-    /**
-     * The version of the package that this reflection documents according to package.json.
-     */
-    packageVersion;
-    /**
-     * The contents of the readme.md file of the project when found.
-     */
-    readme;
-    /**
-     * Object which describes where to find content for relative links.
-     */
-    files;
-    constructor(name, registry) {
-        super(name, ReflectionKind.Project);
-        this.reflections[this.id] = this;
-        this.files = registry;
-    }
-    /**
-     * Return whether this reflection is the root / project reflection.
-     */
-    isProject() {
-        return true;
-    }
-    /**
-     * Return a list of all reflections in this project of a certain kind.
-     *
-     * @param kind  The desired kind of reflection.
-     * @returns     An array containing all reflections with the desired kind.
-     */
-    getReflectionsByKind(kind) {
-        return Object.values(this.reflections).filter((reflection) => reflection.kindOf(kind));
-    }
-    /**
-     * Registers the given reflection so that it can be quickly looked up by helper methods.
-     * Should be called for *every* reflection added to the project.
-     *
-     * Note: During conversion, `Context.registerReflection` should be used instead so
-     * that symbols can be saved for later use.
-     */
-    registerReflection(reflection, id, filePath) {
-        this.referenceGraph = undefined;
-        if (reflection.parent) {
-            this.reflectionChildren
-                .get(reflection.parent.id)
-                .push(reflection.id);
+let ProjectReflection = (() => {
+    let _classSuper = ContainerReflection;
+    let _symbolToReflectionIdMap_decorators;
+    let _symbolToReflectionIdMap_initializers = [];
+    let _symbolToReflectionIdMap_extraInitializers = [];
+    let _reflectionIdToSymbolIdMap_decorators;
+    let _reflectionIdToSymbolIdMap_initializers = [];
+    let _reflectionIdToSymbolIdMap_extraInitializers = [];
+    let _removedSymbolIds_decorators;
+    let _removedSymbolIds_initializers = [];
+    let _removedSymbolIds_extraInitializers = [];
+    let _referenceGraph_decorators;
+    let _referenceGraph_initializers = [];
+    let _referenceGraph_extraInitializers = [];
+    let _reflectionChildren_decorators;
+    let _reflectionChildren_initializers = [];
+    let _reflectionChildren_extraInitializers = [];
+    let _reflections_decorators;
+    let _reflections_initializers = [];
+    let _reflections_extraInitializers = [];
+    return class ProjectReflection extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _symbolToReflectionIdMap_decorators = [NonEnumerable];
+            _reflectionIdToSymbolIdMap_decorators = [NonEnumerable];
+            _removedSymbolIds_decorators = [NonEnumerable];
+            _referenceGraph_decorators = [NonEnumerable];
+            _reflectionChildren_decorators = [NonEnumerable];
+            _reflections_decorators = [NonEnumerable];
+            __esDecorate(null, null, _symbolToReflectionIdMap_decorators, { kind: "field", name: "symbolToReflectionIdMap", static: false, private: false, access: { has: obj => "symbolToReflectionIdMap" in obj, get: obj => obj.symbolToReflectionIdMap, set: (obj, value) => { obj.symbolToReflectionIdMap = value; } }, metadata: _metadata }, _symbolToReflectionIdMap_initializers, _symbolToReflectionIdMap_extraInitializers);
+            __esDecorate(null, null, _reflectionIdToSymbolIdMap_decorators, { kind: "field", name: "reflectionIdToSymbolIdMap", static: false, private: false, access: { has: obj => "reflectionIdToSymbolIdMap" in obj, get: obj => obj.reflectionIdToSymbolIdMap, set: (obj, value) => { obj.reflectionIdToSymbolIdMap = value; } }, metadata: _metadata }, _reflectionIdToSymbolIdMap_initializers, _reflectionIdToSymbolIdMap_extraInitializers);
+            __esDecorate(null, null, _removedSymbolIds_decorators, { kind: "field", name: "removedSymbolIds", static: false, private: false, access: { has: obj => "removedSymbolIds" in obj, get: obj => obj.removedSymbolIds, set: (obj, value) => { obj.removedSymbolIds = value; } }, metadata: _metadata }, _removedSymbolIds_initializers, _removedSymbolIds_extraInitializers);
+            __esDecorate(null, null, _referenceGraph_decorators, { kind: "field", name: "referenceGraph", static: false, private: false, access: { has: obj => "referenceGraph" in obj, get: obj => obj.referenceGraph, set: (obj, value) => { obj.referenceGraph = value; } }, metadata: _metadata }, _referenceGraph_initializers, _referenceGraph_extraInitializers);
+            __esDecorate(null, null, _reflectionChildren_decorators, { kind: "field", name: "reflectionChildren", static: false, private: false, access: { has: obj => "reflectionChildren" in obj, get: obj => obj.reflectionChildren, set: (obj, value) => { obj.reflectionChildren = value; } }, metadata: _metadata }, _reflectionChildren_initializers, _reflectionChildren_extraInitializers);
+            __esDecorate(null, null, _reflections_decorators, { kind: "field", name: "reflections", static: false, private: false, access: { has: obj => "reflections" in obj, get: obj => obj.reflections, set: (obj, value) => { obj.reflections = value; } }, metadata: _metadata }, _reflections_initializers, _reflections_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
-        this.reflections[reflection.id] = reflection;
-        if (id) {
-            this.registerSymbolId(reflection, id);
+        variant = "project";
+        // Used to resolve references.
+        symbolToReflectionIdMap = __runInitializers(this, _symbolToReflectionIdMap_initializers, new StableKeyMap());
+        reflectionIdToSymbolIdMap = (__runInitializers(this, _symbolToReflectionIdMap_extraInitializers), __runInitializers(this, _reflectionIdToSymbolIdMap_initializers, new Map()));
+        removedSymbolIds = (__runInitializers(this, _reflectionIdToSymbolIdMap_extraInitializers), __runInitializers(this, _removedSymbolIds_initializers, new StableKeyMap()));
+        // Maps a reflection ID to all references eventually referring to it.
+        referenceGraph = (__runInitializers(this, _removedSymbolIds_extraInitializers), __runInitializers(this, _referenceGraph_initializers, void 0));
+        // Maps a reflection ID to all reflections with it as their parent.
+        reflectionChildren = (__runInitializers(this, _referenceGraph_extraInitializers), __runInitializers(this, _reflectionChildren_initializers, new 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}
+         * to ensure that links to reflections remain valid.
+         *
+         * This may be replaced with a `Map<number, Reflection>` someday.
+         */
+        reflections = (__runInitializers(this, _reflectionChildren_extraInitializers), __runInitializers(this, _reflections_initializers, {}));
+        /**
+         * The name of the package that this reflection documents according to package.json.
+         */
+        packageName = __runInitializers(this, _reflections_extraInitializers);
+        /**
+         * The version of the package that this reflection documents according to package.json.
+         */
+        packageVersion;
+        /**
+         * The contents of the readme.md file of the project when found.
+         */
+        readme;
+        /**
+         * Object which describes where to find content for relative links.
+         */
+        files;
+        constructor(name, registry) {
+            super(name, ReflectionKind.Project);
+            this.reflections[this.id] = this;
+            this.files = registry;
         }
-        if (filePath) {
-            this.files.registerReflection(filePath, reflection);
+        /**
+         * Return whether this reflection is the root / project reflection.
+         */
+        isProject() {
+            return true;
         }
-    }
-    /**
-     * Removes references to reflections contained within the provided type.
-     * Plugins which overwrite types on reflections should pass the type to this
-     * method before overwriting the property.
-     * @since 0.26.6
-     */
-    removeTypeReflections(type) {
-        type?.visit(makeRecursiveVisitor({
-            reflection: (type) => {
-                this.removeReflection(type.declaration);
-            },
-        }));
-    }
-    /**
-     * Removes a reflection from the documentation. Can be used by plugins to filter reflections
-     * out of the generated documentation. Has no effect if the reflection is not present in the
-     * project.
-     */
-    removeReflection(reflection) {
-        // 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) {
-                return true; // Continue iteration
+        /**
+         * Return a list of all reflections in this project of a certain kind.
+         *
+         * @param kind  The desired kind of reflection.
+         * @returns     An array containing all reflections with the desired kind.
+         */
+        getReflectionsByKind(kind) {
+            return Object.values(this.reflections).filter((reflection) => reflection.kindOf(kind));
+        }
+        /**
+         * Registers the given reflection so that it can be quickly looked up by helper methods.
+         * Should be called for *every* reflection added to the project.
+         *
+         * Note: During conversion, `Context.registerReflection` should be used instead so
+         * that symbols can be saved for later use.
+         */
+        registerReflection(reflection, id, filePath) {
+            this.referenceGraph = undefined;
+            if (reflection.parent) {
+                this.reflectionChildren
+                    .get(reflection.parent.id)
+                    .push(reflection.id);
             }
-            switch (property) {
-                case TraverseProperty.Children:
-                case TraverseProperty.Documents:
-                    parent.removeChild(reflection);
-                    break;
-                case TraverseProperty.GetSignature:
-                    delete parent.getSignature;
-                    break;
-                case TraverseProperty.IndexSignature:
-                    removeIfPresent(parent.indexSignatures, reflection);
-                    if (!parent.indexSignatures?.length) {
-                        delete parent.indexSignatures;
-                    }
-                    break;
-                case TraverseProperty.Parameters:
-                    removeIfPresent(reflection.parent.parameters, reflection);
-                    if (!reflection.parent.parameters
-                        ?.length) {
-                        delete reflection.parent
-                            .parameters;
-                    }
-                    break;
-                case TraverseProperty.SetSignature:
-                    delete parent.setSignature;
-                    break;
-                case TraverseProperty.Signatures:
-                    removeIfPresent(parent.signatures, reflection);
-                    if (!parent.signatures?.length) {
-                        delete parent.signatures;
-                    }
-                    break;
-                case TraverseProperty.TypeLiteral:
-                    parent.type = new IntrinsicType("Object");
-                    break;
-                case TraverseProperty.TypeParameter:
-                    removeIfPresent(parent.typeParameters, reflection);
-                    if (!parent.typeParameters?.length) {
-                        delete parent.typeParameters;
-                    }
-                    break;
-                default:
-                    assertNever(property);
+            this.reflections[reflection.id] = reflection;
+            if (id) {
+                this.registerSymbolId(reflection, id);
             }
-            return false; // Stop iteration
-        });
-    }
-    /** @internal */
-    mergeReflections(source, target) {
-        // First, tell the children about their new parent
-        delete this.referenceGraph;
-        const oldChildrenIds = this.reflectionChildren.getNoInsert(source.id) || [];
-        const newChildren = this.reflectionChildren.get(target.id);
-        for (const childId of oldChildrenIds) {
-            const childRefl = this.getReflectionById(childId);
-            // To avoid conflicting with some plugins which do this surgery somewhat incorrectly
-            // (typedoc-plugin-merge-modules and likely others I'm not aware of) only move children
-            // which are still children
-            if (childRefl?.parent === source) {
-                childRefl.parent = target;
-                newChildren.push(childId);
-                target.addChild(childRefl);
+            if (filePath) {
+                this.files.registerReflection(filePath, reflection);
             }
         }
-        // Then remove the now-empty parent
-        this.reflectionChildren.delete(source.id);
-        this.removeReflection(source);
-        // And remove any outdated collections of children on the new parent.
-        // So long as this is used before REVIVE(-100) or EVENT_BEGIN_RESOLVE(-100)
-        // this will make the appropriate plugin rebuild the lists.
-        delete target.groups;
-        delete target.categories;
-    }
-    /**
-     * Remove a reflection without updating the parent reflection to remove references to the removed reflection.
-     */
-    _removeReflection(reflection) {
-        this.files.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);
-            }
+        /**
+         * Removes references to reflections contained within the provided type.
+         * Plugins which overwrite types on reflections should pass the type to this
+         * method before overwriting the property.
+         * @since 0.26.6
+         */
+        removeTypeReflections(type) {
+            type?.visit(makeRecursiveVisitor({
+                reflection: (type) => {
+                    this.removeReflection(type.declaration);
+                },
+            }));
+        }
+        /**
+         * Removes a reflection from the documentation. Can be used by plugins to filter reflections
+         * out of the generated documentation. Has no effect if the reflection is not present in the
+         * project.
+         */
+        removeReflection(reflection) {
+            // 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) {
+                    return true; // Continue iteration
+                }
+                switch (property) {
+                    case TraverseProperty.Children:
+                    case TraverseProperty.Documents:
+                        parent.removeChild(reflection);
+                        break;
+                    case TraverseProperty.GetSignature:
+                        delete parent.getSignature;
+                        break;
+                    case TraverseProperty.IndexSignature:
+                        removeIfPresent(parent.indexSignatures, reflection);
+                        if (!parent.indexSignatures?.length) {
+                            delete parent.indexSignatures;
+                        }
+                        break;
+                    case TraverseProperty.Parameters:
+                        removeIfPresent(reflection.parent.parameters, reflection);
+                        if (!reflection.parent.parameters
+                            ?.length) {
+                            delete reflection.parent
+                                .parameters;
+                        }
+                        break;
+                    case TraverseProperty.SetSignature:
+                        delete parent.setSignature;
+                        break;
+                    case TraverseProperty.Signatures:
+                        removeIfPresent(parent.signatures, reflection);
+                        if (!parent.signatures?.length) {
+                            delete parent.signatures;
+                        }
+                        break;
+                    case TraverseProperty.TypeLiteral:
+                        parent.type = new IntrinsicType("Object");
+                        break;
+                    case TraverseProperty.TypeParameter:
+                        removeIfPresent(parent.typeParameters, reflection);
+                        if (!parent.typeParameters?.length) {
+                            delete parent.typeParameters;
+                        }
+                        break;
+                    default:
+                        assertNever(property);
+                }
+                return false; // Stop iteration
+            });
         }
-        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);
+        /** @internal */
+        mergeReflections(source, target) {
+            // First, tell the children about their new parent
+            delete this.referenceGraph;
+            const oldChildrenIds = this.reflectionChildren.getNoInsert(source.id) || [];
+            const newChildren = this.reflectionChildren.get(target.id);
+            for (const childId of oldChildrenIds) {
+                const childRefl = this.getReflectionById(childId);
+                // To avoid conflicting with some plugins which do this surgery somewhat incorrectly
+                // (typedoc-plugin-merge-modules and likely others I'm not aware of) only move children
+                // which are still children
+                if (childRefl?.parent === source) {
+                    childRefl.parent = target;
+                    newChildren.push(childId);
+                    target.addChild(childRefl);
+                }
             }
+            // Then remove the now-empty parent
+            this.reflectionChildren.delete(source.id);
+            this.removeReflection(source);
+            // And remove any outdated collections of children on the new parent.
+            // So long as this is used before REVIVE(-100) or EVENT_BEGIN_RESOLVE(-100)
+            // this will make the appropriate plugin rebuild the lists.
+            delete target.groups;
+            delete target.categories;
         }
-        this.reflectionChildren.delete(reflection.id);
-        // Remove references from the TS symbol to this reflection.
-        const symbolId = this.reflectionIdToSymbolIdMap.get(reflection.id);
-        if (symbolId) {
-            const saved = this.symbolToReflectionIdMap.get(symbolId);
-            if (saved === reflection.id) {
-                this.symbolToReflectionIdMap.delete(symbolId);
-                this.removedSymbolIds.set(symbolId, true);
+        /**
+         * Remove a reflection without updating the parent reflection to remove references to the removed reflection.
+         */
+        _removeReflection(reflection) {
+            this.files.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);
+                }
             }
-            else if (typeof saved === "object") {
-                removeIfPresent(saved, reflection.id);
-                if (saved.length === 0) {
+            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 symbolId = this.reflectionIdToSymbolIdMap.get(reflection.id);
+            if (symbolId) {
+                const saved = this.symbolToReflectionIdMap.get(symbolId);
+                if (saved === reflection.id) {
+                    this.symbolToReflectionIdMap.delete(symbolId);
                     this.removedSymbolIds.set(symbolId, true);
                 }
+                else if (typeof saved === "object") {
+                    removeIfPresent(saved, reflection.id);
+                    if (saved.length === 0) {
+                        this.removedSymbolIds.set(symbolId, true);
+                    }
+                }
             }
+            this.reflectionIdToSymbolIdMap.delete(reflection.id);
+            delete this.reflections[reflection.id];
         }
-        this.reflectionIdToSymbolIdMap.delete(reflection.id);
-        delete this.reflections[reflection.id];
-    }
-    /**
-     * Gets the reflection registered for the given reflection ID, or undefined if it is not present
-     * in the project.
-     */
-    getReflectionById(id) {
-        return this.reflections[id];
-    }
-    /**
-     * Gets the reflection associated with the given symbol id, if it exists.
-     * If there are multiple reflections associated with this symbol, gets the first one.
-     * @internal
-     */
-    getReflectionFromSymbolId(symbolId) {
-        return this.getReflectionsFromSymbolId(symbolId)[0];
-    }
-    /** @internal */
-    getReflectionsFromSymbolId(symbolId) {
-        const id = this.symbolToReflectionIdMap.get(symbolId);
-        if (typeof id === "number") {
-            return [this.getReflectionById(id)];
+        /**
+         * Gets the reflection registered for the given reflection ID, or undefined if it is not present
+         * in the project.
+         */
+        getReflectionById(id) {
+            return this.reflections[id];
         }
-        else if (typeof id === "object") {
-            return id.map((id) => this.getReflectionById(id));
+        /**
+         * Gets the reflection associated with the given symbol id, if it exists.
+         * If there are multiple reflections associated with this symbol, gets the first one.
+         * @internal
+         */
+        getReflectionFromSymbolId(symbolId) {
+            return this.getReflectionsFromSymbolId(symbolId)[0];
         }
-        return [];
-    }
-    /** @internal */
-    getSymbolIdFromReflection(reflection) {
-        return this.reflectionIdToSymbolIdMap.get(reflection.id);
-    }
-    /** @internal */
-    registerSymbolId(reflection, id) {
-        this.removedSymbolIds.delete(id);
-        this.reflectionIdToSymbolIdMap.set(reflection.id, id);
-        const previous = this.symbolToReflectionIdMap.get(id);
-        if (previous) {
-            if (typeof previous === "number") {
-                this.symbolToReflectionIdMap.set(id, [previous, reflection.id]);
+        /** @internal */
+        getReflectionsFromSymbolId(symbolId) {
+            const id = this.symbolToReflectionIdMap.get(symbolId);
+            if (typeof id === "number") {
+                return [this.getReflectionById(id)];
+            }
+            else if (typeof id === "object") {
+                return id.map((id) => this.getReflectionById(id));
+            }
+            return [];
+        }
+        /** @internal */
+        getSymbolIdFromReflection(reflection) {
+            return this.reflectionIdToSymbolIdMap.get(reflection.id);
+        }
+        /** @internal */
+        registerSymbolId(reflection, id) {
+            this.removedSymbolIds.delete(id);
+            this.reflectionIdToSymbolIdMap.set(reflection.id, id);
+            const previous = this.symbolToReflectionIdMap.get(id);
+            if (previous) {
+                if (typeof previous === "number") {
+                    this.symbolToReflectionIdMap.set(id, [previous, reflection.id]);
+                }
+                else {
+                    previous.push(reflection.id);
+                }
             }
             else {
-                previous.push(reflection.id);
+                this.symbolToReflectionIdMap.set(id, reflection.id);
             }
         }
-        else {
-            this.symbolToReflectionIdMap.set(id, reflection.id);
+        symbolIdHasBeenRemoved(id) {
+            return this.removedSymbolIds.has(id);
         }
-    }
-    symbolIdHasBeenRemoved(id) {
-        return this.removedSymbolIds.has(id);
-    }
-    getReferenceGraph() {
-        if (!this.referenceGraph) {
-            this.referenceGraph = new Map();
-            for (const id in this.reflections) {
-                const ref = this.reflections[id];
-                if (ref instanceof ReferenceReflection) {
-                    const target = ref.tryGetTargetReflection();
-                    if (target) {
-                        const refs = this.referenceGraph.get(target.id) ?? [];
-                        refs.push(ref.id);
-                        this.referenceGraph.set(target.id, refs);
+        getReferenceGraph() {
+            if (!this.referenceGraph) {
+                this.referenceGraph = new Map();
+                for (const id in this.reflections) {
+                    const ref = this.reflections[id];
+                    if (ref instanceof ReferenceReflection) {
+                        const target = ref.tryGetTargetReflection();
+                        if (target) {
+                            const refs = this.referenceGraph.get(target.id) ?? [];
+                            refs.push(ref.id);
+                            this.referenceGraph.set(target.id, refs);
+                        }
                     }
                 }
             }
+            return this.referenceGraph;
         }
-        return this.referenceGraph;
-    }
-    toObject(serializer) {
-        const symbolIdMap = {};
-        this.reflectionIdToSymbolIdMap.forEach((sid, id) => {
-            symbolIdMap[id] = sid.toObject();
-        });
-        return {
-            schemaVersion: JSON_SCHEMA_VERSION,
-            ...super.toObject(serializer),
-            variant: this.variant,
-            packageName: this.packageName,
-            packageVersion: this.packageVersion,
-            readme: Comment.serializeDisplayParts(this.readme),
-            symbolIdMap,
-            files: serializer.toObject(this.files),
-        };
-    }
-    fromObject(de, obj) {
-        super.fromObject(de, obj);
-        // If updating this, also check the block in DeclarationReflection.fromObject.
-        this.packageName = obj.packageName;
-        this.packageVersion = obj.packageVersion;
-        if (obj.readme) {
-            this.readme = Comment.deserializeDisplayParts(de, obj.readme);
+        toObject(serializer) {
+            const symbolIdMap = {};
+            this.reflectionIdToSymbolIdMap.forEach((sid, id) => {
+                symbolIdMap[id] = sid.toObject();
+            });
+            return {
+                schemaVersion: JSON_SCHEMA_VERSION,
+                ...super.toObject(serializer),
+                variant: this.variant,
+                packageName: this.packageName,
+                packageVersion: this.packageVersion,
+                readme: Comment.serializeDisplayParts(this.readme),
+                symbolIdMap,
+                files: serializer.toObject(this.files),
+            };
         }
-        this.files.fromObject(de, obj.files || {});
-        de.defer(() => {
-            // Unnecessary conditional in release
-            for (const [id, sid] of Object.entries(obj.symbolIdMap || {})) {
-                const refl = this.getReflectionById(de.oldIdToNewId[+id] ?? -1);
-                if (refl) {
-                    this.registerSymbolId(refl, new ReflectionSymbolId(sid));
-                }
-                else {
-                    de.logger.warn(i18n.serialized_project_referenced_0_not_part_of_project(id.toString()));
-                }
+        fromObject(de, obj) {
+            super.fromObject(de, obj);
+            // If updating this, also check the block in DeclarationReflection.fromObject.
+            this.packageName = obj.packageName;
+            this.packageVersion = obj.packageVersion;
+            if (obj.readme) {
+                this.readme = Comment.deserializeDisplayParts(de, obj.readme);
             }
-        });
-    }
-}
+            this.files.fromObject(de, obj.files || {});
+            de.defer(() => {
+                // Unnecessary conditional in release
+                for (const [id, sid] of Object.entries(obj.symbolIdMap || {})) {
+                    const refl = this.getReflectionById(de.oldIdToNewId[+id] ?? -1);
+                    if (refl) {
+                        this.registerSymbolId(refl, new ReflectionSymbolId(sid));
+                    }
+                    else {
+                        de.logger.warn(i18n.serialized_project_referenced_0_not_part_of_project(id.toString()));
+                    }
+                }
+            });
+        }
+    };
+})();
+export { ProjectReflection };

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

@@ -29,7 +29,7 @@ export function moduleReflection(context, mod) {
         })));
 }
 export function moduleMemberSummary(context, member) {
-    const id = context.slugger.slug(member.name);
+    const id = member.isReference() ? context.getAnchor(member) : context.slugger.slug(member.name);
     context.page.pageHeadings.push({
         link: `#${id}`,
         text: getDisplayName(member),

package/dist/lib/utils/declaration-maps.d.ts

@@ -0,0 +1,3 @@
+import type ts from "typescript";
+export declare function resolveDeclarationMaps(file: string): string;
+export declare function addInferredDeclarationMapPaths(opts: ts.CompilerOptions, files: readonly string[]): void;

package/dist/lib/utils/declaration-maps.js

@@ -0,0 +1,51 @@
+import { existsSync } from "fs";
+import { readFile } from "./fs.js";
+import { Validation } from "#utils";
+import { join, relative, resolve } from "path";
+import { getCommonDirectory, normalizePath } from "./paths.js";
+const declarationMapCache = new Map();
+export function resolveDeclarationMaps(file) {
+    if (!/\.d\.[cm]?ts$/.test(file))
+        return file;
+    if (declarationMapCache.has(file))
+        return declarationMapCache.get(file);
+    const mapFile = file + ".map";
+    if (!existsSync(mapFile))
+        return file;
+    let sourceMap;
+    try {
+        sourceMap = JSON.parse(readFile(mapFile));
+    }
+    catch {
+        return file;
+    }
+    if (Validation.validate({
+        file: String,
+        sourceRoot: Validation.optional(String),
+        sources: [Array, String],
+    }, sourceMap)) {
+        // There's a pretty large assumption in here that we only have
+        // 1 source file per js file. This is a pretty standard typescript approach,
+        // but people might do interesting things with transpilation that could break this.
+        let source = sourceMap.sources[0];
+        // If we have a sourceRoot, trim any leading slash from the source, and join them
+        // Similar to how it's done at https://github.com/mozilla/source-map/blob/58819f09018d56ef84dc41ba9c93f554e0645169/lib/util.js#L412
+        if (sourceMap.sourceRoot !== undefined) {
+            source = source.replace(/^\//, "");
+            source = join(sourceMap.sourceRoot, source);
+        }
+        const result = resolve(mapFile, "..", source);
+        declarationMapCache.set(file, result);
+        return result;
+    }
+    return file;
+}
+// See also: inferEntryPoints in entry-point.ts
+export function addInferredDeclarationMapPaths(opts, files) {
+    const rootDir = opts.rootDir || getCommonDirectory(files);
+    const declDir = opts.declarationDir || opts.outDir || rootDir;
+    for (const file of files) {
+        const mapFile = normalizePath(resolve(declDir, relative(rootDir, file)).replace(/\.([cm]?[tj]s)x?$/, ".d.$1"));
+        declarationMapCache.set(mapFile, file);
+    }
+}

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

@@ -5,6 +5,7 @@ import { expandPackages } from "./package-manifest.js";
 import { deriveRootDir, getCommonDirectory, MinimatchSet, nicePath, normalizePath } from "./paths.js";
 import { discoverPackageJson, glob, inferPackageEntryPointPaths, isDir } from "./fs.js";
 import { assertNever, i18n } from "#utils";
+import { addInferredDeclarationMapPaths, resolveDeclarationMaps } from "./declaration-maps.js";
 /**
  * Defines how entry points are interpreted.
  * @enum
@@ -39,7 +40,7 @@ export function inferEntryPoints(logger, options, programs) {
     const pathEntries = inferPackageEntryPointPaths(packageJson.file);
     const entryPoints = [];
     programs ||= getEntryPrograms(pathEntries.map((p) => p[1]), logger, options);
-    // See also: addInferredDeclarationMapPaths in ReflectionSymbolId
+    // See also: addInferredDeclarationMapPaths in symbol-id factory
     const jsToTsSource = new Map();
     for (const program of programs) {
         const opts = program.getCompilerOptions();
@@ -53,7 +54,7 @@ export function inferEntryPoints(logger, options, programs) {
     for (const [name, path] of pathEntries) {
         // Strip leading ./ from the display name
         const displayName = name.replace(/^\.\/?/, "");
-        const targetPath = jsToTsSource.get(path) || path;
+        const targetPath = jsToTsSource.get(path) || resolveDeclarationMaps(path) || path;
         const program = programs.find((p) => p.getSourceFile(targetPath));
         if (program) {
             entryPoints.push({
@@ -70,6 +71,7 @@ export function inferEntryPoints(logger, options, programs) {
         logger.warn(i18n.no_entry_points_provided());
         return [];
     }
+    logger.verbose(`Inferred entry points to be:\n\t${entryPoints.map(e => nicePath(e.sourceFile.fileName)).join("\n\t")}`);
     return entryPoints;
 }
 export function getEntryPoints(logger, options) {
@@ -257,6 +259,7 @@ function getEntryPrograms(inputFiles, logger, options) {
             options: options.getCompilerOptions(),
             projectReferences: options.getProjectReferences(),
         });
+    addInferredDeclarationMapPaths(options.getCompilerOptions(), options.getFileNames());
     const programs = [rootProgram];
     // This might be a solution style tsconfig, in which case we need to add a program for each
     // reference so that the converter can look through each of these.
@@ -271,6 +274,7 @@ function getEntryPrograms(inputFiles, logger, options) {
                 rootNames: ref.commandLine.fileNames,
                 projectReferences: ref.commandLine.projectReferences,
             }));
+            addInferredDeclarationMapPaths(ref.commandLine.options, ref.commandLine.fileNames);
         }
     }
     return programs;

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

@@ -9,6 +9,7 @@ export { loadPlugins } from "./plugins.js";
 export { getSortFunction } from "./sort.js";
 export type { SortStrategy } from "./sort.js";
 export * from "./entry-point.js";
+export * from "./declaration-maps.js";
 export * from "./highlighter.js";
 export * from "./html.js";
 export * from "./tsconfig.js";

package/dist/lib/utils/index.js

@@ -7,6 +7,7 @@ export * from "./paths.js";
 export { loadPlugins } from "./plugins.js";
 export { getSortFunction } from "./sort.js";
 export * from "./entry-point.js";
+export * from "./declaration-maps.js";
 export * from "./highlighter.js";
 export * from "./html.js";
 export * from "./tsconfig.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "typedoc",
   "description": "Create api documentation for TypeScript projects.",
-  "version": "0.28.8",
+  "version": "0.28.10",
   "homepage": "https://typedoc.org",
   "type": "module",
   "exports": {
@@ -31,32 +31,32 @@
     "pnpm": ">= 10"
   },
   "dependencies": {
-    "@gerrit0/mini-shiki": "^3.7.0",
+    "@gerrit0/mini-shiki": "^3.9.0",
     "lunr": "^2.3.9",
     "markdown-it": "^14.1.0",
     "minimatch": "^9.0.5",
     "yaml": "^2.8.0"
   },
   "peerDependencies": {
-    "typescript": "5.0.x || 5.1.x || 5.2.x || 5.3.x || 5.4.x || 5.5.x || 5.6.x || 5.7.x || 5.8.x"
+    "typescript": "5.0.x || 5.1.x || 5.2.x || 5.3.x || 5.4.x || 5.5.x || 5.6.x || 5.7.x || 5.8.x || 5.9.x"
   },
   "devDependencies": {
-    "@eslint/js": "^9.30.0",
+    "@eslint/js": "^9.32.0",
     "@types/lunr": "^2.3.7",
     "@types/markdown-it": "^14.1.2",
     "@types/mocha": "^10.0.10",
     "@types/node": "18",
     "@typestrong/fs-fixture-builder": "github:TypeStrong/fs-fixture-builder#34113409e3a171e68ce5e2b55461ef5c35591cfe",
     "c8": "^10.1.3",
-    "dprint": "^0.50.0",
-    "esbuild": "^0.25.5",
-    "eslint": "^9.30.0",
+    "dprint": "^0.50.1",
+    "esbuild": "^0.25.8",
+    "eslint": "^9.32.0",
     "mocha": "^11.7.1",
     "puppeteer": "^24.11.1",
     "semver": "^7.7.2",
     "tsx": "^4.20.3",
-    "typescript": "5.8.3",
-    "typescript-eslint": "^8.35.0"
+    "typescript": "5.9.2",
+    "typescript-eslint": "^8.38.0"
   },
   "files": [
     "/bin",