typedoc 0.27.0-beta.0 → 0.27.0-beta.2

package/dist/lib/application.d.ts

@@ -125,7 +125,7 @@ export declare class Application extends AbstractComponent<Application, Applicat
      */
     getTypeScriptPath(): string;
     getTypeScriptVersion(): string;
-    getEntryPoints(): Promise<DocumentationEntryPoint[] | undefined>;
+    getEntryPoints(): DocumentationEntryPoint[] | undefined;
     /**
      * Gets the entry points to be documented according to the current `entryPoints` and `entryPointStrategy` options.
      * May return undefined if entry points fail to be expanded.

package/dist/lib/application.js

@@ -52,7 +52,6 @@ import { findTsConfigFile } from "./utils/tsconfig.js";
 import { deriveRootDir, glob, readFile } from "./utils/fs.js";
 import { addInferredDeclarationMapPaths } from "./models/reflections/ReflectionSymbolId.js";
 import { Internationalization, } from "./internationalization/internationalization.js";
-import { loadShikiMetadata } from "./utils/highlighter.js";
 import { ValidatingFileRegistry, FileRegistry } from "./models/FileRegistry.js";
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
@@ -215,7 +214,6 @@ let Application = (() => {
          * Initialize TypeDoc, loading plugins if applicable.
          */
         static async bootstrapWithPlugins(options = {}, readers = DEFAULT_READERS) {
-            await loadShikiMetadata();
             const app = new Application(DETECTOR);
             readers.forEach((r) => app.options.addReader(r));
             app.options.reset();
@@ -239,7 +237,6 @@ let Application = (() => {
          * @param readers Option readers to use to discover options from config files.
          */
         static async bootstrap(options = {}, readers = DEFAULT_READERS) {
-            await loadShikiMetadata();
             const app = new Application(DETECTOR);
             readers.forEach((r) => app.options.addReader(r));
             await app._bootstrap(options);
@@ -300,7 +297,7 @@ let Application = (() => {
         getTypeScriptVersion() {
             return ts.version;
         }
-        async getEntryPoints() {
+        getEntryPoints() {
             if (this.options.isSet("entryPoints")) {
                 return this.getDefinedEntryPoints();
             }
@@ -333,7 +330,7 @@ let Application = (() => {
             if (!supportedVersionMajorMinor.some((version) => version == ts.versionMajorMinor)) {
                 this.logger.warn(this.i18n.unsupported_ts_version_0(supportedVersionMajorMinor.join(", ")));
             }
-            const entryPoints = await this.getEntryPoints();
+            const entryPoints = this.getEntryPoints();
             if (!entryPoints) {
                 // Fatal error already reported.
                 return;

package/dist/lib/converter/converter.js

@@ -605,7 +605,8 @@ function getExports(context, node, symbol) {
                 if (globalSymbol) {
                     result = context.checker
                         .getExportsOfModule(globalSymbol)
-                        .filter((exp) => exp.declarations?.some((d) => d.getSourceFile() === node));
+                        .filter((exp) => exp.declarations?.some((d) => d.getSourceFile() === node))
+                        .map((s) => context.checker.getMergedSymbol(s));
                 }
             }
         }

package/dist/lib/converter/factories/index-signature.d.ts

@@ -1,3 +1,3 @@
-import ts from "typescript";
+import type ts from "typescript";
 import type { Context } from "../context.js";
-export declare function convertIndexSignatures(context: Context, symbol: ts.Symbol): void;
+export declare function convertIndexSignatures(context: Context, type: ts.Type): void;

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

@@ -1,26 +1,49 @@
 import assert from "assert";
-import ts from "typescript";
-import { DeclarationReflection, ParameterReflection, ReflectionKind, SignatureReflection, } from "../../models/index.js";
+import { DeclarationReflection, ParameterReflection, ReflectionFlag, ReflectionKind, SignatureReflection, UnionType, } from "../../models/index.js";
 import { ConverterEvents } from "../converter-events.js";
-export function convertIndexSignatures(context, symbol) {
+export function convertIndexSignatures(context, type) {
     assert(context.scope instanceof DeclarationReflection);
-    const indexSymbol = symbol.members?.get("__index");
-    if (!indexSymbol)
-        return;
-    for (const indexDeclaration of indexSymbol.getDeclarations() || []) {
-        assert(ts.isIndexSignatureDeclaration(indexDeclaration));
-        const param = indexDeclaration.parameters[0];
-        assert(param && ts.isParameter(param));
+    // Each declaration should have one SignatureReflection
+    // If we don't have a declaration, the index signature was inferred by TS
+    // and we should make a separate SignatureReflection for each index signature.
+    const seenByDeclaration = new Map();
+    const createdSignatures = [];
+    for (const indexInfo of context.checker.getIndexInfosOfType(type)) {
+        // Check if we've already created an index signature for this type
+        if (indexInfo.declaration &&
+            seenByDeclaration.has(indexInfo.declaration)) {
+            const createdSig = seenByDeclaration.get(indexInfo.declaration);
+            if (createdSig.parameters[0].type?.type !== "union") {
+                createdSig.parameters[0].type = new UnionType([
+                    createdSig.parameters[0].type,
+                ]);
+            }
+            createdSig.parameters[0].type.types.push(context.converter.convertType(context.withScope(createdSig), indexInfo.keyType));
+            // No need to update the return type as it will be the same for all members.
+            continue;
+        }
+        // Otherwise create a new one
         const index = new SignatureReflection("__index", ReflectionKind.IndexSignature, context.scope);
-        index.comment = context.getNodeComment(indexDeclaration, false);
+        if (indexInfo.isReadonly) {
+            index.setFlag(ReflectionFlag.Readonly);
+        }
+        createdSignatures.push([indexInfo.declaration, index]);
+        if (indexInfo.declaration) {
+            seenByDeclaration.set(indexInfo.declaration, index);
+            index.comment = context.getNodeComment(indexInfo.declaration, 
+            /* moduleComment */ false);
+        }
         index.parameters = [
-            new ParameterReflection(param.name.getText(), ReflectionKind.Parameter, index),
+            new ParameterReflection(indexInfo.declaration?.parameters[0].name.getText() ?? "key", ReflectionKind.Parameter, index),
         ];
-        index.parameters[0].type = context.converter.convertType(context.withScope(index.parameters[0]), param.type);
-        index.type = context.converter.convertType(context.withScope(index), indexDeclaration.type);
-        context.registerReflection(index, indexSymbol);
+        index.parameters[0].type = context.converter.convertType(context.withScope(index.parameters[0]), indexInfo.keyType);
+        index.type = context.converter.convertType(context.withScope(index), indexInfo.type);
+        context.registerReflection(index, indexInfo.declaration?.symbol);
         context.scope.indexSignatures ||= [];
         context.scope.indexSignatures.push(index);
-        context.converter.trigger(ConverterEvents.CREATE_SIGNATURE, context, index, indexDeclaration);
+    }
+    // Now that we've created everything, trigger events for them.
+    for (const [declaration, index] of createdSignatures) {
+        context.converter.trigger(ConverterEvents.CREATE_SIGNATURE, context, index, declaration);
     }
 }

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

@@ -41,7 +41,7 @@ export class MergeModuleWithPlugin extends ConverterComponent {
             if (tempRefl === target) {
                 this.application.logger.warn(this.application.i18n.reflection_0_tried_to_merge_into_child_1(refl.getFriendlyFullName(), target.getFriendlyFullName()));
             }
-            tempRefl = refl.parent;
+            tempRefl = tempRefl.parent;
         }
         this.application.logger.verbose(`Merging ${refl.getFullName()} into ${target.getFullName()}`);
         project.mergeModules(refl, target);

package/dist/lib/converter/symbols.js

@@ -169,7 +169,15 @@ function convertNamespace(context, symbol, exportSymbol) {
         reflection = existingReflection;
     }
     else {
-        reflection = context.createDeclarationReflection(ReflectionKind.Namespace, symbol, exportSymbol);
+        let kind = ReflectionKind.Namespace;
+        let nameOverride;
+        // #2778 - always treat declare module "foo" as a module, not a namespace
+        const declareModule = symbol.declarations?.find((mod) => ts.isModuleDeclaration(mod) && ts.isStringLiteral(mod.name));
+        if (declareModule) {
+            kind = ReflectionKind.Module;
+            nameOverride = declareModule.name.text;
+        }
+        reflection = context.createDeclarationReflection(kind, symbol, exportSymbol, nameOverride);
         context.finalizeDeclarationReflection(reflection);
     }
     convertSymbols(context.withScope(reflection), context.checker
@@ -258,7 +266,7 @@ function convertTypeAliasAsInterface(context, symbol, exportSymbol, declaration)
     // And maybe constructor signatures
     convertConstructSignatures(rc, symbol);
     // And finally, index signatures
-    convertIndexSignatures(rc, symbol);
+    convertIndexSignatures(rc, type);
 }
 function convertFunctionOrMethod(context, symbol, exportSymbol) {
     // Can't just check method flag because this might be called for properties as well
@@ -375,7 +383,7 @@ function convertClassOrInterface(context, symbol, exportSymbol) {
     // but nobody has complained yet.
     convertConstructSignatures(reflectionContext, symbol);
     // And finally, index signatures
-    convertIndexSignatures(reflectionContext, symbol);
+    convertIndexSignatures(reflectionContext, instanceType);
     // Normally this shouldn't matter, unless someone did something with skipLibCheck on.
     return ts.SymbolFlags.Alias;
 }

package/dist/lib/converter/types.js

@@ -231,8 +231,7 @@ const importType = {
     kind: [ts.SyntaxKind.ImportType],
     convert(context, node) {
         const name = node.qualifier?.getText() ?? "__module";
-        const symbol = context.checker.getSymbolAtLocation(node);
-        assert(symbol, "Missing symbol when converting import type node");
+        const symbol = context.expectSymbolAtLocation(node.qualifier || node);
         return ReferenceType.createSymbolReference(context.resolveAliasedSymbol(symbol), context, name);
     },
     convertType(context, type) {
@@ -373,7 +372,7 @@ const typeLiteralConverter = {
         for (const signature of type.getConstructSignatures()) {
             createSignature(rc, ReflectionKind.ConstructorSignature, signature, symbol);
         }
-        convertIndexSignatures(rc, symbol);
+        convertIndexSignatures(rc, type);
         return new ReflectionType(reflection);
     },
     convertType(context, type) {
@@ -391,7 +390,7 @@ const typeLiteralConverter = {
             createSignature(context.withScope(reflection), ReflectionKind.ConstructorSignature, signature, symbol);
         }
         if (symbol) {
-            convertIndexSignatures(context.withScope(reflection), symbol);
+            convertIndexSignatures(context.withScope(reflection), type);
         }
         return new ReflectionType(reflection);
     },

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

@@ -150,7 +150,8 @@ module.exports = {
     help_excludeProtected: "Ignore protected variables and methods",
     help_excludeReferences: "If a symbol is exported multiple times, ignore all but the first export",
     help_externalSymbolLinkMappings: "Define custom links for symbols not included in the documentation",
-    help_out: "Specify the location the documentation should be written to",
+    help_out: "Specify the location the documentation for the default output should be written to. The default output type may be changed by plugins.",
+    help_html: "Specify the location where html documentation should be written to.",
     help_json: "Specify the location and filename a JSON file describing the project is written to",
     help_pretty: "Specify whether the output JSON should be formatted with tabs",
     help_emit: "Specify what TypeDoc should emit, 'docs', 'both', or 'none'",
@@ -196,6 +197,7 @@ module.exports = {
     help_headings: "Determines which optional headings are rendered",
     help_sluggerConfiguration: "Determines how anchors within rendered HTML are determined.",
     help_navigation: "Determines how the navigation sidebar is organized",
+    help_includeHierarchySummary: "If set, a reflections hierarchy summary will be rendered to a summary page. Defaults to `true`",
     help_visibilityFilters: "Specify the default visibility for builtin filters and additional filters according to modifier tags",
     help_searchCategoryBoosts: "Configure search to give a relevance boost to selected categories",
     help_searchGroupBoosts: 'Configure search to give a relevance boost to selected kinds (eg "class")',
@@ -334,7 +336,8 @@ module.exports = {
     theme_type_declaration: "Type declaration",
     theme_index: "Index",
     theme_hierarchy: "Hierarchy",
-    theme_hierarchy_view_full: "view full",
+    theme_hierarchy_summary: "Hierarchy Summary",
+    theme_hierarchy_view_summary: "View Summary",
     theme_implemented_by: "Implemented by",
     theme_defined_in: "Defined in",
     theme_implementation_of: "Implementation of",
@@ -342,7 +345,6 @@ module.exports = {
     theme_overrides: "Overrides",
     theme_returns: "Returns",
     theme_generated_using_typedoc: "Generated using TypeDoc", // If this includes "TypeDoc", theme will insert a link at that location.
-    theme_class_hierarchy_title: "Class Hierarchy",
     // Search
     theme_preparing_search_index: "Preparing search index...",
     theme_search_index_not_available: "The search index is not available",
@@ -361,7 +363,11 @@ module.exports = {
     theme_menu: "Menu",
     theme_permalink: "Permalink",
     // Used by the frontend JS
+    // For the English translations only, these should also be added to
+    // src/lib/output/themes/default/assets/typedoc/Application.ts
     theme_copy: "Copy",
     theme_copied: "Copied!",
     theme_normally_hidden: "This member is normally hidden due to your filter settings.",
+    theme_hierarchy_expand: "Expand",
+    theme_hierarchy_collapse: "Collapse",
 };

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

@@ -137,7 +137,8 @@ declare const _default: {
     readonly help_excludeProtected: "Ignore protected variables and methods";
     readonly help_excludeReferences: "If a symbol is exported multiple times, ignore all but the first export";
     readonly help_externalSymbolLinkMappings: "Define custom links for symbols not included in the documentation";
-    readonly help_out: "Specify the location the documentation should be written to";
+    readonly help_out: "Specify the location the documentation for the default output should be written to. The default output type may be changed by plugins.";
+    readonly help_html: "Specify the location where html documentation should be written to.";
     readonly help_json: "Specify the location and filename a JSON file describing the project is written to";
     readonly help_pretty: "Specify whether the output JSON should be formatted with tabs";
     readonly help_emit: "Specify what TypeDoc should emit, 'docs', 'both', or 'none'";
@@ -183,6 +184,7 @@ declare const _default: {
     readonly help_headings: "Determines which optional headings are rendered";
     readonly help_sluggerConfiguration: "Determines how anchors within rendered HTML are determined.";
     readonly help_navigation: "Determines how the navigation sidebar is organized";
+    readonly help_includeHierarchySummary: "If set, a reflections hierarchy summary will be rendered to a summary page. Defaults to `true`";
     readonly help_visibilityFilters: "Specify the default visibility for builtin filters and additional filters according to modifier tags";
     readonly help_searchCategoryBoosts: "Configure search to give a relevance boost to selected categories";
     readonly help_searchGroupBoosts: "Configure search to give a relevance boost to selected kinds (eg \"class\")";
@@ -310,7 +312,8 @@ declare const _default: {
     readonly theme_type_declaration: "Type declaration";
     readonly theme_index: "Index";
     readonly theme_hierarchy: "Hierarchy";
-    readonly theme_hierarchy_view_full: "view full";
+    readonly theme_hierarchy_summary: "Hierarchy Summary";
+    readonly theme_hierarchy_view_summary: "View Summary";
     readonly theme_implemented_by: "Implemented by";
     readonly theme_defined_in: "Defined in";
     readonly theme_implementation_of: "Implementation of";
@@ -318,7 +321,6 @@ declare const _default: {
     readonly theme_overrides: "Overrides";
     readonly theme_returns: "Returns";
     readonly theme_generated_using_typedoc: "Generated using TypeDoc";
-    readonly theme_class_hierarchy_title: "Class Hierarchy";
     readonly theme_preparing_search_index: "Preparing search index...";
     readonly theme_search_index_not_available: "The search index is not available";
     readonly theme_loading: "Loading...";
@@ -335,5 +337,7 @@ declare const _default: {
     readonly theme_copy: "Copy";
     readonly theme_copied: "Copied!";
     readonly theme_normally_hidden: "This member is normally hidden due to your filter settings.";
+    readonly theme_hierarchy_expand: "Expand";
+    readonly theme_hierarchy_collapse: "Collapse";
 };
 export = _default;

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

@@ -1,4 +1,7 @@
 "use strict";
+// Please DO NOT include machine generated translations here.
+// If adding a new key, leave it commented out for a native speaker
+// to update.
 const localeUtils = require("../locale-utils.cjs");
 module.exports = localeUtils.buildIncompleteTranslation({
     loaded_multiple_times_0: "TypeDoc が複数回読み込まれました。これは通常、TypeDoc を独自にインストールしたプラグインによって発生します。読み込まれたパスは次のとおりです:\n{0}",
@@ -130,7 +133,8 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_excludeProtected: "保護された変数とメソッドを無視する",
     help_excludeReferences: "シンボルが複数回エクスポートされた場合、最初のエクスポート以外はすべて無視されます。",
     help_externalSymbolLinkMappings: "ドキュメントに含まれていないシンボルのカスタムリンクを定義する",
-    help_out: "ドキュメントを書き込む場所を指定します",
+    // help_out
+    // help_html
     help_json: "プロジェクトを説明するJSONファイルが書き込まれる場所とファイル名を指定します",
     help_pretty: "出力JSONをタブでフォーマットするかどうかを指定します",
     help_emit: "TypeDoc が発行する内容を指定します (「docs」、「both」、または「none」)",
@@ -288,7 +292,6 @@ module.exports = localeUtils.buildIncompleteTranslation({
     theme_type_declaration: "型宣言",
     theme_index: "インデックス",
     theme_hierarchy: "階層",
-    theme_hierarchy_view_full: "完全な階層を表示",
     theme_implemented_by: "実装者",
     theme_defined_in: "定義",
     theme_implementation_of: "の実装",
@@ -314,6 +317,5 @@ module.exports = localeUtils.buildIncompleteTranslation({
     theme_copy: "コピー",
     theme_copied: "コピー完了！",
     theme_normally_hidden: "このメンバーは、フィルター設定のため、通常は非表示になっています。",
-    theme_class_hierarchy_title: "クラス継承図",
     theme_loading: "読み込み中...",
 });

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

@@ -123,7 +123,6 @@ declare const _default: {
     help_excludeProtected: string;
     help_excludeReferences: string;
     help_externalSymbolLinkMappings: string;
-    help_out: string;
     help_json: string;
     help_pretty: string;
     help_emit: string;
@@ -279,7 +278,6 @@ declare const _default: {
     theme_type_declaration: string;
     theme_index: string;
     theme_hierarchy: string;
-    theme_hierarchy_view_full: string;
     theme_implemented_by: string;
     theme_defined_in: string;
     theme_implementation_of: string;
@@ -305,7 +303,6 @@ declare const _default: {
     theme_copy: string;
     theme_copied: string;
     theme_normally_hidden: string;
-    theme_class_hierarchy_title: string;
     theme_loading: string;
 };
 export = _default;

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

@@ -1,4 +1,7 @@
 "use strict";
+// Please DO NOT include machine generated translations here.
+// If adding a new key, leave it commented out for a native speaker
+// to update.
 const localeUtils = require("../locale-utils.cjs");
 module.exports = localeUtils.buildIncompleteTranslation({
     // output_0_could_not_be_generated
@@ -48,7 +51,8 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_excludeProtected: "보호된 변수와 메서드를 무시합니다",
     help_excludeReferences: "심볼이 여러 번 내보내진 경우 첫 번째 내보내기를 제외하고 모두 무시합니다",
     help_externalSymbolLinkMappings: "문서에 포함되지 않은 심볼에 대한 사용자 정의 링크를 정의합니다",
-    help_out: "문서가 쓰여질 위치를 지정합니다",
+    // help_out
+    // help_html
     help_json: "프로젝트를 설명하는 JSON 파일의 위치와 파일 이름을 지정합니다",
     help_pretty: "출력 JSON을 탭으로 포맷팅할 지 여부를 지정합니다",
     help_emit: "TypeDoc이 생성할 내용을 지정합니다. 'docs', 'both', 'none' 중 하나를 선택합니다",
@@ -208,7 +212,6 @@ module.exports = localeUtils.buildIncompleteTranslation({
     theme_type_declaration: "타입 선언",
     theme_index: "둘러보기",
     theme_hierarchy: "계층",
-    theme_hierarchy_view_full: "전체 보기",
     theme_implemented_by: "구현",
     theme_defined_in: "정의 위치:",
     theme_implementation_of: "구현하는 타입:",

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

@@ -43,7 +43,6 @@ declare const _default: {
     help_excludeProtected: string;
     help_excludeReferences: string;
     help_externalSymbolLinkMappings: string;
-    help_out: string;
     help_json: string;
     help_pretty: string;
     help_emit: string;
@@ -200,7 +199,6 @@ declare const _default: {
     theme_type_declaration: string;
     theme_index: string;
     theme_hierarchy: string;
-    theme_hierarchy_view_full: string;
     theme_implemented_by: string;
     theme_defined_in: string;
     theme_implementation_of: string;

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

@@ -1,4 +1,7 @@
 "use strict";
+// Please DO NOT include machine generated translations here.
+// If adding a new key, leave it commented out for a native speaker
+// to update.
 const localeUtils = require("../locale-utils.cjs");
 module.exports = localeUtils.buildIncompleteTranslation({
     loaded_multiple_times_0: "TypeDoc 已加载多次。这通常是由具有自己的 TypeDoc 安装的插件引起的。加载的路径为：\n{0}",
@@ -8,8 +11,8 @@ module.exports = localeUtils.buildIncompleteTranslation({
     solution_not_supported_in_watch_mode: "提供的 tsconfig 文件看起来像解决方案样式的 tsconfig，在监视模式下不受支持",
     strategy_not_supported_in_watch_mode: "对于监视模式，entryPointStrategy 必须设置为 resolve 或 expand",
     found_0_errors_and_1_warnings: "发现 {0} 个错误和 {1} 个警告",
-    // output_0_could_not_be_generated
-    // output_0_generated_at_1
+    output_0_could_not_be_generated: "由于以上错误无法生成 {0} 输出",
+    output_0_generated_at_1: "已生成 {0} 输出，位于 {1}",
     no_entry_points_for_packages: "没有为包模式提供入口点，无法生成文档",
     failed_to_find_packages: "找不到任何软件包，请确保您至少提供了一个包含 package.json 的目录作为入口点",
     nested_packages_unsupported_0: "位于 {0} 的项目已将 entryPointStrategy 设置为包，但不支持嵌套包",
@@ -57,6 +60,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     type_0_defined_in_1_is_referenced_by_2_but_not_included_in_docs: "{0} 在 {1} 中定义，被 {2} 引用，但未包含在文档中",
     reflection_0_kind_1_defined_in_2_does_not_have_any_documentation: "{0} ({1})，在 {2} 中定义，没有任何文档",
     invalid_intentionally_not_exported_symbols_0: "以下符号被标记为有意不导出，但未在文档中引用，或已被导出：\n{0}",
+    reflection_0_has_unused_mergeModuleWith_tag: "{0} 中存在无法解析的 @mergeModuleWith 标签",
     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，但该类别中没有子项",
@@ -73,6 +77,9 @@ module.exports = localeUtils.buildIncompleteTranslation({
     disable_git_set_but_not_source_link_template: "已设置 disableGit，但未设置 sourceLinkTemplate，因此无法生成源代码链接。设置 sourceLinkTemplate 或 disableSources 以停用源代码跟踪",
     disable_git_set_and_git_revision_used: "disableGit 已设置，并且 sourceLinkTemplate 包含 {gitRevision}，由于未提供修订，因此将替换为空字符串",
     git_remote_0_not_valid: "提供的 git 远程“{0}”无效。源链接将失效",
+    reflection_0_tried_to_merge_into_child_1: "反射 {0} 尝试使用 @mergeModuleWith 合并到其子项之一：{1}",
+    include_0_in_1_specified_2_resolved_to_3_does_not_exist: "{1} 的注释中 {0} 标签指定了包含 “{2}”，解析为 “{3}”，该文件并不存在或并非文件。",
+    include_0_in_1_specified_2_circular_include_3: "{1} 的注释中 {0} 标签指定了包含 “{2}”，导致了循环包含：\n\t{3}",
     custom_css_file_0_does_not_exist: "{0} 处的自定义 CSS 文件不存在",
     custom_js_file_0_does_not_exist: "{0} 处的自定义 JavaScript 文件不存在",
     unsupported_highlight_language_0_not_highlighted_in_comment_for_1: "不支持的高亮语言 {0} 将不会在 {1} 的注释中高亮",
@@ -82,11 +89,13 @@ module.exports = localeUtils.buildIncompleteTranslation({
     could_not_empty_output_directory_0: "无法清空输出目录 {0}",
     could_not_create_output_directory_0: "无法创建输出目录 {0}",
     theme_0_is_not_defined_available_are_1: "主题“{0}”未定义。可用主题为：{1}",
+    reflection_0_links_to_1_but_anchor_does_not_exist_try_2: "{0} 链接至 {1}，但对应锚点不存在。你是否是指：\n\t{2}",
     no_entry_points_provided: "没有提供入口点，这可能是配置错误",
     unable_to_find_any_entry_points: "无法找到任何入口点。请参阅先前的警告",
     watch_does_not_support_packages_mode: "监视模式不支持“包”样式的入口点",
     watch_does_not_support_merge_mode: "监视模式不支持“合并”样式的入口点",
     entry_point_0_not_in_program: "入口点 {0} 未被 tsconfig 中的“files”或“include”选项引用",
+    failed_to_resolve_0_to_ts_path: "无法将 package.json 中的入口点 {0} 解析至 TypeScript 源文件",
     use_expand_or_glob_for_files_in_dir: "如果要包含此目录中的文件，请设置 --entryPointStrategy 以展开或指定 glob",
     glob_0_did_not_match_any_files: "glob {0} 与任何文件均不匹配",
     entry_point_0_did_not_match_any_files_after_exclude: "应用排除模式后，glob {0} 没有匹配任何文件",
@@ -133,7 +142,8 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_excludeProtected: "忽略受保护的变量和方法",
     help_excludeReferences: "如果一个符号被导出多次，则忽略除第一次导出之外的所有导出",
     help_externalSymbolLinkMappings: "为文档中未包含的符号定义自定义链接",
-    help_out: "指定文档应写入的位置",
+    help_out: "指定默认类型输出的文档写入的位置。插件可能会改变默认的输出类型。",
+    help_html: "指定 HTML 文档写入的位置",
     help_json: "指定描述项目的 JSON 文件写入的位置和文件名",
     help_pretty: "指定输出 JSON 是否应使用制表符进行格式化",
     help_emit: "指定 TypeDoc 应发出的内容，“docs”、“both”或“none”",
@@ -141,6 +151,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_lightHighlightTheme: "指定浅色模式下的代码高亮主题",
     help_darkHighlightTheme: "指定暗黑模式下的代码高亮主题",
     help_highlightLanguages: "指定渲染时将加载哪些语言来高亮代码",
+    help_typePrintWidth: "渲染类型时触发自动换行的代码宽度",
     help_customCss: "要导入主题的自定义 CSS 文件的路径",
     help_customJs: "要导入的自定义 JS 文件的路径",
     help_markdownItOptions: "指定传递给 markdown-it（TypeDoc 使用的 Markdown 解析器）的选项",
@@ -155,9 +166,10 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_disableGit: "假设所有内容都可以通过 sourceLinkTemplate 进行链接，如果启用此功能，则必须设置 sourceLinkTemplate。{path} 将以 basePath 为根",
     help_basePath: "指定显示文件路径时使用的基本路径",
     help_excludeTags: "从文档注释中删除列出的块级/修饰符标签",
-    // help_notRenderedTags
+    help_notRenderedTags: "保留在文档注释中但在创建输出时不渲染的标签",
     help_readme: "应显示在索引页上的自述文件路径。传递“none”以禁用索引页并在全局页上启动文档",
     help_cname: "设置 CNAME 文件文本，这对于 GitHub Pages 上的自定义域很有用",
+    help_favicon: "作为站点图标包含的 favicon.ico 或 favicon.svg 的路径",
     help_sourceLinkExternal: "指定哪些源代码链接应被视为外部链接，并在新选项卡中打开",
     help_markdownLinkExternal: "指定注释与 Markdown 文件中哪些 http[s]:// 链接应被视为外部链接，并在新选项卡中打开",
     help_githubPages: "生成 .nojekyll 文件以防止 GitHub Pages 中出现 404 错误。默认为“true”",
@@ -166,7 +178,6 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_hideGenerator: "不要打印页面末尾的 TypeDoc 链接",
     help_customFooterHtml: "TypeDoc 链接后的自定义页脚",
     help_customFooterHtmlDisableWrapper: "如果设置，则禁用 customFooterHtml 的包装元素",
-    // help_hideTypesInSignatureTitle
     help_cacheBust: "在静态资产链接中包含生成时间",
     help_searchInComments: "如果设置，搜索索引还将包括注释。这将大大增加搜索索引的大小",
     help_searchInDocuments: "如果设置，搜索索引还将包含文档。这将大大增加搜索索引的大小",
@@ -175,11 +186,13 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_navigationLinks: "定义要包含在标题中的链接",
     help_sidebarLinks: "定义要包含在侧边栏中的链接",
     help_navigationLeaves: "导航树中不应扩展的分支",
-    help_navigation: "确定导航侧边栏的组织方式",
     help_headings: "确定标题是否需要被渲染",
+    help_sluggerConfiguration: "确定渲染的 HTML 中锚点的确定方式",
+    help_navigation: "确定导航侧边栏的组织方式",
     help_visibilityFilters: "根据修饰符标签指定内置过滤器和附加过滤器的默认可见性",
     help_searchCategoryBoosts: "配置搜索以提高所选类别的相关性",
     help_searchGroupBoosts: "配置搜索以增强所选种类（例如“类别”）的相关性",
+    help_useFirstParagraphOfCommentAsSummary: "如果设置，且没有指定 @summary 标签，TypeDoc 会使用注释的第一行作为在模块/命名空间一览里的概述",
     help_jsDocCompatibility: "设置注释解析的兼容性选项，以增加与 JSDoc 注释的相似度",
     help_commentStyle: "确定 TypeDoc 如何搜索注释",
     help_useTsLinkResolution: "使用 TypeScript 的链接解析来确定 @link 标签指向的位置。这仅适用于 JSDoc 样式注释",
@@ -188,6 +201,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_inlineTags: "TypeDoc 在解析注释时应该识别的内联标签",
     help_modifierTags: "TypeDoc 在解析注释时应该识别的修饰符标签",
     help_categorizeByGroup: "指定是否在组级别进行分类",
+    help_groupReferencesByType: "如果设置，引用将按照它们的类型进行分类，而非直接分在“引用”类型中",
     help_defaultCategory: "为没有类别的反射指定默认类别",
     help_categoryOrder: "指定类别出现的顺序。* 表示不在列表中的类别的相对顺序",
     help_groupOrder: "指定组的显示顺序。* 表示不在列表中的组的相对顺序",
@@ -222,6 +236,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     highlightLanguages_contains_invalid_languages_0: "highlightLanguages 包含无效语言：{0}，运行 typedoc --help 获取受支持语言的列表",
     hostedBaseUrl_must_start_with_http: "hostingBaseUrl 必须以 http:// 或 https:// 开头",
     useHostedBaseUrlForAbsoluteLinks_requires_hostedBaseUrl: "useHostedBaseUrlForAbsoluteLinks 选项要求设置 hostingBaseUrl",
+    favicon_must_be_ico_or_svg: "Favicon 文件必须是一个 .ico 或 .svg 文件",
     option_0_must_be_an_object: "“{0}”选项必须是非数组对象",
     option_0_must_be_a_function: "‘{0}’ 选项必须是一个函数",
     option_0_must_be_object_with_urls: "{0} 必须是具有字符串标签作为键和 URL 值的对象",
@@ -230,6 +245,13 @@ module.exports = localeUtils.buildIncompleteTranslation({
     option_0_values_must_be_numbers: "{0} 的所有值都必须是数字",
     option_0_values_must_be_array_of_tags: "{0} 必须是有效标签名称的数组",
     option_0_specified_1_but_only_2_is_valid: "{0} 只能指定已知值，并且提供了无效值 ({1})。有效的排序策略为：\n{2}",
+    option_outputs_must_be_array: "“outputs” 选项必须为一个数组，其成员均为 { name: string, path: string, options?: TypeDocOptions }。",
+    specified_output_0_has_not_been_defined: "指定的输出类型 {0} 未被定义。",
+    alert_note: "注意",
+    alert_tip: "提示",
+    alert_important: "重要",
+    alert_warning: "警告",
+    alert_caution: "小心",
     kind_project: "项目",
     kind_module: "模块",
     kind_namespace: "命名空间",
@@ -245,7 +267,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     kind_call_signature: "调用签名",
     kind_index_signature: "索引签名",
     kind_constructor_signature: "构造函数签名",
-    kind_parameter: "范围",
+    kind_parameter: "参数",
     kind_type_literal: "类型字面量",
     kind_type_parameter: "类型参数",
     kind_accessor: "访问器",
@@ -278,23 +300,22 @@ module.exports = localeUtils.buildIncompleteTranslation({
     kind_plural_type_alias: "类型别名",
     kind_plural_reference: "参考",
     kind_plural_document: "文档",
-    flag_protected: "受保护",
     flag_private: "私有",
-    flag_external: "外部",
-    flag_inherited: "继承",
+    flag_protected: "受保护",
     flag_public: "公开",
     flag_static: "静态",
+    flag_external: "外部",
     flag_optional: "可选",
     flag_rest: "动态参数",
     flag_abstract: "抽象",
     flag_const: "常量",
     flag_readonly: "只读",
+    flag_inherited: "继承",
     theme_implements: "实现",
     theme_indexable: "可索引",
     theme_type_declaration: "类型声明",
     theme_index: "索引",
     theme_hierarchy: "层级",
-    theme_hierarchy_view_full: "查看完整内容",
     theme_implemented_by: "实现于",
     theme_defined_in: "定义于",
     theme_implementation_of: "实现了",
@@ -304,6 +325,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     theme_generated_using_typedoc: "使用 TypeDoc 生成",
     theme_preparing_search_index: "正在准备搜索索引...",
     theme_search_index_not_available: "搜索索引不可用",
+    theme_loading: "加载中……",
     theme_settings: "显示设置",
     theme_member_visibility: "成员可见性",
     theme_theme: "配色",
@@ -317,8 +339,6 @@ module.exports = localeUtils.buildIncompleteTranslation({
     theme_copy: "复制",
     theme_copied: "已复制！",
     theme_normally_hidden: "由于您的过滤器设置，该成员已被隐藏。",
-    theme_class_hierarchy_title: "类继承图表",
-    theme_loading: "加载中……",
     tag_defaultValue: "默认值",
     tag_deprecated: "已被弃用",
     tag_example: "示例",
@@ -345,6 +365,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     tag_jsx: "JSX",
     tag_license: "许可协议",
     tag_module: "模块",
+    tag_mergeModuleWith: "合并模块至",
     tag_prop: "属性",
     tag_property: "属性",
     tag_return: "返回",
@@ -353,10 +374,13 @@ module.exports = localeUtils.buildIncompleteTranslation({
     tag_template: "类型参数",
     tag_type: "类型",
     tag_typedef: "类型定义",
+    tag_summary: "概述",
     tag_link: "链接",
     tag_label: "标记",
     tag_linkcode: "链接",
     tag_linkplain: "链接",
+    tag_include: "包含",
+    tag_includeCode: "包含",
     tag_alpha: "alpha",
     tag_beta: "beta",
     tag_eventProperty: "事件属性",
@@ -372,11 +396,13 @@ module.exports = localeUtils.buildIncompleteTranslation({
     tag_class: "类",
     tag_enum: "枚举",
     tag_event: "事件",
+    tag_expand: "展开",
     tag_hidden: "隐藏",
     tag_hideCategories: "在类别中隐藏",
     tag_hideconstructor: "隐藏构造器",
     tag_hideGroups: "在分组中隐藏",
     tag_ignore: "隐藏",
+    tag_inline: "内联",
     tag_interface: "接口",
     tag_namespace: "命名空间",
     tag_overload: "重载",
@@ -384,4 +410,5 @@ module.exports = localeUtils.buildIncompleteTranslation({
     tag_protected: "受保护成员",
     tag_showCategories: "在类别中显示",
     tag_showGroups: "在分组中显示",
+    tag_useDeclaredType: "使用声明类型",
 });