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

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

@@ -6,6 +6,8 @@ declare const _default: {
     solution_not_supported_in_watch_mode: string;
     strategy_not_supported_in_watch_mode: string;
     found_0_errors_and_1_warnings: "发现 {0} 个错误和 {1} 个警告";
+    output_0_could_not_be_generated: "由于以上错误无法生成 {0} 输出";
+    output_0_generated_at_1: "已生成 {0} 输出，位于 {1}";
     no_entry_points_for_packages: string;
     failed_to_find_packages: string;
     nested_packages_unsupported_0: "位于 {0} 的项目已将 entryPointStrategy 设置为包，但不支持嵌套包";
@@ -53,6 +55,7 @@ declare const _default: {
     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，但该类别中没有子项";
@@ -69,6 +72,9 @@ declare const _default: {
     disable_git_set_but_not_source_link_template: string;
     disable_git_set_and_git_revision_used: string;
     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} 的注释中高亮";
@@ -78,11 +84,13 @@ declare const _default: {
     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: string;
     unable_to_find_any_entry_points: string;
     watch_does_not_support_packages_mode: string;
     watch_does_not_support_merge_mode: string;
     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: string;
     glob_0_did_not_match_any_files: "glob {0} 与任何文件均不匹配";
     entry_point_0_did_not_match_any_files_after_exclude: "应用排除模式后，glob {0} 没有匹配任何文件";
@@ -130,6 +138,7 @@ declare const _default: {
     help_excludeReferences: string;
     help_externalSymbolLinkMappings: string;
     help_out: string;
+    help_html: string;
     help_json: string;
     help_pretty: string;
     help_emit: string;
@@ -137,6 +146,7 @@ declare const _default: {
     help_lightHighlightTheme: string;
     help_darkHighlightTheme: string;
     help_highlightLanguages: string;
+    help_typePrintWidth: string;
     help_customCss: string;
     help_customJs: string;
     help_markdownItOptions: string;
@@ -151,8 +161,10 @@ declare const _default: {
     help_disableGit: string;
     help_basePath: string;
     help_excludeTags: string;
+    help_notRenderedTags: string;
     help_readme: string;
     help_cname: string;
+    help_favicon: string;
     help_sourceLinkExternal: string;
     help_markdownLinkExternal: string;
     help_githubPages: string;
@@ -169,11 +181,13 @@ declare const _default: {
     help_navigationLinks: string;
     help_sidebarLinks: string;
     help_navigationLeaves: string;
-    help_navigation: string;
     help_headings: string;
+    help_sluggerConfiguration: string;
+    help_navigation: string;
     help_visibilityFilters: string;
     help_searchCategoryBoosts: string;
     help_searchGroupBoosts: string;
+    help_useFirstParagraphOfCommentAsSummary: string;
     help_jsDocCompatibility: string;
     help_commentStyle: string;
     help_useTsLinkResolution: string;
@@ -182,6 +196,7 @@ declare const _default: {
     help_inlineTags: string;
     help_modifierTags: string;
     help_categorizeByGroup: string;
+    help_groupReferencesByType: string;
     help_defaultCategory: string;
     help_categoryOrder: string;
     help_groupOrder: string;
@@ -216,6 +231,7 @@ declare const _default: {
     highlightLanguages_contains_invalid_languages_0: "highlightLanguages 包含无效语言：{0}，运行 typedoc --help 获取受支持语言的列表";
     hostedBaseUrl_must_start_with_http: string;
     useHostedBaseUrlForAbsoluteLinks_requires_hostedBaseUrl: string;
+    favicon_must_be_ico_or_svg: string;
     option_0_must_be_an_object: "“{0}”选项必须是非数组对象";
     option_0_must_be_a_function: "‘{0}’ 选项必须是一个函数";
     option_0_must_be_object_with_urls: "{0} 必须是具有字符串标签作为键和 URL 值的对象";
@@ -224,6 +240,13 @@ declare const _default: {
     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: string;
+    specified_output_0_has_not_been_defined: "指定的输出类型 {0} 未被定义。";
+    alert_note: string;
+    alert_tip: string;
+    alert_important: string;
+    alert_warning: string;
+    alert_caution: string;
     kind_project: string;
     kind_module: string;
     kind_namespace: string;
@@ -272,23 +295,22 @@ declare const _default: {
     kind_plural_type_alias: string;
     kind_plural_reference: string;
     kind_plural_document: string;
-    flag_protected: string;
     flag_private: string;
-    flag_external: string;
-    flag_inherited: string;
+    flag_protected: string;
     flag_public: string;
     flag_static: string;
+    flag_external: string;
     flag_optional: string;
     flag_rest: string;
     flag_abstract: string;
     flag_const: string;
     flag_readonly: string;
+    flag_inherited: string;
     theme_implements: string;
     theme_indexable: string;
     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;
@@ -298,6 +320,7 @@ declare const _default: {
     theme_generated_using_typedoc: string;
     theme_preparing_search_index: string;
     theme_search_index_not_available: string;
+    theme_loading: string;
     theme_settings: string;
     theme_member_visibility: string;
     theme_theme: string;
@@ -311,8 +334,6 @@ declare const _default: {
     theme_copy: string;
     theme_copied: string;
     theme_normally_hidden: string;
-    theme_class_hierarchy_title: string;
-    theme_loading: string;
     tag_defaultValue: string;
     tag_deprecated: string;
     tag_example: string;
@@ -339,6 +360,7 @@ declare const _default: {
     tag_jsx: string;
     tag_license: string;
     tag_module: string;
+    tag_mergeModuleWith: string;
     tag_prop: string;
     tag_property: string;
     tag_return: string;
@@ -347,10 +369,13 @@ declare const _default: {
     tag_template: string;
     tag_type: string;
     tag_typedef: string;
+    tag_summary: string;
     tag_link: string;
     tag_label: string;
     tag_linkcode: string;
     tag_linkplain: string;
+    tag_include: string;
+    tag_includeCode: string;
     tag_alpha: string;
     tag_beta: string;
     tag_eventProperty: string;
@@ -366,11 +391,13 @@ declare const _default: {
     tag_class: string;
     tag_enum: string;
     tag_event: string;
+    tag_expand: string;
     tag_hidden: string;
     tag_hideCategories: string;
     tag_hideconstructor: string;
     tag_hideGroups: string;
     tag_ignore: string;
+    tag_inline: string;
     tag_interface: string;
     tag_namespace: string;
     tag_overload: string;
@@ -378,5 +405,6 @@ declare const _default: {
     tag_protected: string;
     tag_showCategories: string;
     tag_showGroups: string;
+    tag_useDeclaredType: string;
 };
 export = _default;

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

@@ -233,11 +233,11 @@ export declare class MappedType extends Type {
     parameter: string;
     parameterType: SomeType;
     templateType: SomeType;
-    readonlyModifier?: ("+" | "-") | undefined;
-    optionalModifier?: ("+" | "-") | undefined;
+    readonlyModifier?: "+" | "-" | undefined;
+    optionalModifier?: "+" | "-" | undefined;
     nameType?: SomeType | undefined;
     readonly type = "mapped";
-    constructor(parameter: string, parameterType: SomeType, templateType: SomeType, readonlyModifier?: ("+" | "-") | undefined, optionalModifier?: ("+" | "-") | undefined, nameType?: SomeType | undefined);
+    constructor(parameter: string, parameterType: SomeType, templateType: SomeType, readonlyModifier?: "+" | "-" | undefined, optionalModifier?: "+" | "-" | undefined, nameType?: SomeType | undefined);
     protected getTypeString(): string;
     needsParenthesis(): boolean;
     toObject(serializer: Serializer): JSONOutput.MappedType;

package/dist/lib/output/formatter.js

@@ -451,7 +451,12 @@ export class FormattedCodeBuilder {
         }
         if (reflection.indexSignatures) {
             for (const index of reflection.indexSignatures) {
-                members.push(nodes(simpleElement(JSX.createElement("span", { class: "tsd-signature-symbol" }, "[")), simpleElement(JSX.createElement("span", { class: getKindClass(index) }, index.parameters[0].name)), simpleElement(JSX.createElement("span", { class: "tsd-signature-symbol" }, ":")), space(), this.type(index.parameters[0].type, TypeContext.none), simpleElement(JSX.createElement("span", { class: "tsd-signature-symbol" }, "]:")), space(), this.type(index.type, TypeContext.none)));
+                members.push(nodes(...(index.flags.isReadonly
+                    ? [
+                        simpleElement(JSX.createElement("span", { class: "tsd-signature-keyword" }, "readonly")),
+                        space(),
+                    ]
+                    : []), simpleElement(JSX.createElement("span", { class: "tsd-signature-symbol" }, "[")), simpleElement(JSX.createElement("span", { class: getKindClass(index) }, index.parameters[0].name)), simpleElement(JSX.createElement("span", { class: "tsd-signature-symbol" }, ":")), space(), this.type(index.parameters[0].type, TypeContext.none), simpleElement(JSX.createElement("span", { class: "tsd-signature-symbol" }, "]:")), space(), this.type(index.type, TypeContext.none)));
             }
         }
         if (!members.length && reflection.signatures?.length === 1) {

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

@@ -7,7 +7,8 @@ export declare class Outputs {
     private defaultOutput;
     constructor(application: Application);
     addOutput(name: string, output: (path: string, project: ProjectReflection) => Promise<void>): void;
-    setDefaultOutput(retriever: () => OutputSpecification): void;
+    setDefaultOutputName(name: string): void;
+    getOutputSpecs(): OutputSpecification[];
     writeOutputs(project: ProjectReflection): Promise<void>;
     writeOutput(output: OutputSpecification, project: ProjectReflection): Promise<void>;
 }

package/dist/lib/output/output.js

@@ -3,12 +3,7 @@ import { nicePath } from "../utils/paths.js";
 export class Outputs {
     application;
     outputs = new Map();
-    defaultOutput = () => {
-        return {
-            name: "html",
-            path: this.application.options.getValue("out"),
-        };
-    };
+    defaultOutput = "html";
     constructor(application) {
         this.application = application;
     }
@@ -18,15 +13,24 @@ export class Outputs {
         }
         this.outputs.set(name, output);
     }
-    setDefaultOutput(retriever) {
-        this.defaultOutput = retriever;
+    setDefaultOutputName(name) {
+        this.defaultOutput = name;
     }
-    async writeOutputs(project) {
+    getOutputSpecs() {
         const options = this.application.options;
         let outputs = [];
         const outputShortcuts = options
             .getDeclarations()
             .filter((decl) => decl.type === ParameterType.Path && decl.outputShortcut);
+        // --out is a special case. It isn't marked as a shortcut as what it is
+        // a shortcut for may be modified by plugins. However, it is effectively
+        // treated as an output shortcut, so check it here.
+        if (options.isSet("out")) {
+            outputs.push({
+                name: this.defaultOutput,
+                path: options.getValue("out"),
+            });
+        }
         for (const shortcut of outputShortcuts) {
             if (options.isSet(shortcut.name)) {
                 outputs.push({
@@ -35,12 +39,21 @@ export class Outputs {
                 });
             }
         }
+        // If no shortcuts have been defined, use the dedicated outputs option
         if (outputs.length === 0) {
             outputs = options.getValue("outputs") || [];
         }
+        // If no outputs have been defined, just write the default output.
         if (!outputs.length) {
-            outputs.push(this.defaultOutput.call(null));
+            outputs.push({
+                name: this.defaultOutput,
+                path: options.getValue("out"),
+            });
         }
+        return outputs;
+    }
+    async writeOutputs(project) {
+        const outputs = this.getOutputSpecs();
         for (const output of outputs) {
             await this.writeOutput(output, project);
         }
@@ -59,7 +72,13 @@ export class Outputs {
         }
         const preErrors = this.application.logger.errorCount;
         const start = Date.now();
-        await writer(output.path, project);
+        try {
+            await writer(output.path, project);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.application.logger.error(message);
+        }
         if (this.application.logger.errorCount === preErrors) {
             this.application.logger.info(this.application.i18n.output_0_generated_at_1(output.name, nicePath(output.path)));
         }

package/dist/lib/output/plugins/AssetsPlugin.d.ts

@@ -13,6 +13,8 @@ export declare class AssetsPlugin extends RendererComponent {
         copy: import("../../internationalization/internationalization.js").TranslatedString;
         copied: import("../../internationalization/internationalization.js").TranslatedString;
         normally_hidden: import("../../internationalization/internationalization.js").TranslatedString;
+        hierarchy_expand: import("../../internationalization/internationalization.js").TranslatedString;
+        hierarchy_collapse: import("../../internationalization/internationalization.js").TranslatedString;
     };
     private onRenderBegin;
     /**

package/dist/lib/output/plugins/AssetsPlugin.js

@@ -87,6 +87,8 @@ let AssetsPlugin = (() => {
                 copy: this.application.i18n.theme_copy(),
                 copied: this.application.i18n.theme_copied(),
                 normally_hidden: this.application.i18n.theme_normally_hidden(),
+                hierarchy_expand: this.application.i18n.theme_hierarchy_expand(),
+                hierarchy_collapse: this.application.i18n.theme_hierarchy_collapse(),
             };
         }
         onRenderBegin(event) {

package/dist/lib/output/plugins/HierarchyPlugin.d.ts

@@ -0,0 +1,7 @@
+import { RendererComponent } from "../components.js";
+import type { Renderer } from "../index.js";
+export declare class HierarchyPlugin extends RendererComponent {
+    constructor(renderer: Renderer);
+    private onRendererBegin;
+    private buildHierarchy;
+}

package/dist/lib/output/plugins/HierarchyPlugin.js

@@ -0,0 +1,67 @@
+import * as Path from "path";
+import { RendererComponent } from "../components.js";
+import { RendererEvent } from "../events.js";
+import { writeFile } from "../../utils/index.js";
+import { DefaultTheme } from "../themes/default/DefaultTheme.js";
+import { gzip } from "zlib";
+import { promisify } from "util";
+import { getHierarchyRoots, getKindClass, getUniquePath, } from "../themes/lib.js";
+const gzipP = promisify(gzip);
+export class HierarchyPlugin extends RendererComponent {
+    constructor(renderer) {
+        super(renderer);
+        this.owner.on(RendererEvent.BEGIN, this.onRendererBegin.bind(this));
+    }
+    onRendererBegin(_event) {
+        if (!(this.owner.theme instanceof DefaultTheme)) {
+            return;
+        }
+        this.owner.preRenderAsyncJobs.push((event) => this.buildHierarchy(event));
+    }
+    async buildHierarchy(event) {
+        const project = event.project;
+        const hierarchy = {
+            roots: getHierarchyRoots(project).map((refl) => refl.id),
+            reflections: {},
+        };
+        const queue = [...hierarchy.roots];
+        while (queue.length) {
+            const id = queue.pop();
+            const refl = project.getReflectionById(id);
+            if (id in hierarchy.reflections)
+                continue;
+            if (!refl.url)
+                continue;
+            const jsonRecord = {
+                name: refl.name,
+                kind: refl.kind,
+                url: refl.url,
+                class: getKindClass(refl),
+            };
+            const path = getUniquePath(refl);
+            if (path.length > 1) {
+                jsonRecord.uniqueNameParents = path
+                    .slice(0, -1)
+                    .map((r) => r.id);
+                queue.push(...jsonRecord.uniqueNameParents);
+            }
+            const children = [
+                ...(refl.implementedBy || []),
+                ...(refl.extendedBy || []),
+            ];
+            for (const child of children) {
+                if (child.reflection) {
+                    jsonRecord.children ||= [];
+                    jsonRecord.children.push(child.reflection.id);
+                }
+            }
+            if (jsonRecord.children) {
+                queue.push(...jsonRecord.children);
+            }
+            hierarchy.reflections[id] = jsonRecord;
+        }
+        const hierarchyJs = Path.join(event.outputDirectory, "assets", "hierarchy.js");
+        const gz = await gzipP(Buffer.from(JSON.stringify(hierarchy)));
+        await writeFile(hierarchyJs, `window.hierarchyData = "data:application/octet-stream;base64,${gz.toString("base64")}"`);
+    }
+}

package/dist/lib/output/plugins/index.d.ts

@@ -1,5 +1,6 @@
 export { MarkedPlugin } from "../themes/MarkedPlugin.js";
 export { AssetsPlugin } from "./AssetsPlugin.js";
+export { HierarchyPlugin } from "./HierarchyPlugin.js";
 export { IconsPlugin } from "./IconsPlugin.js";
 export { JavascriptIndexPlugin } from "./JavascriptIndexPlugin.js";
 export { NavigationPlugin } from "./NavigationPlugin.js";

package/dist/lib/output/plugins/index.js

@@ -1,5 +1,6 @@
 export { MarkedPlugin } from "../themes/MarkedPlugin.js";
 export { AssetsPlugin } from "./AssetsPlugin.js";
+export { HierarchyPlugin } from "./HierarchyPlugin.js";
 export { IconsPlugin } from "./IconsPlugin.js";
 export { JavascriptIndexPlugin } from "./JavascriptIndexPlugin.js";
 export { NavigationPlugin } from "./NavigationPlugin.js";

package/dist/lib/output/renderer.js

@@ -49,7 +49,7 @@ import { Option, EventHooks, AbstractComponent } from "../utils/index.js";
 import { loadHighlighter } from "../utils/highlighter.js";
 import { Reflection } from "../models/index.js";
 import { setRenderSettings } from "../utils/jsx.js";
-import { AssetsPlugin, IconsPlugin, JavascriptIndexPlugin, MarkedPlugin, NavigationPlugin, SitemapPlugin, } from "./plugins/index.js";
+import { AssetsPlugin, HierarchyPlugin, IconsPlugin, JavascriptIndexPlugin, MarkedPlugin, NavigationPlugin, SitemapPlugin, } from "./plugins/index.js";
 /**
  * The renderer processes a {@link ProjectReflection} using a {@link Theme} instance and writes
  * the emitted html documents to a output directory. You can specify which theme should be used
@@ -216,6 +216,7 @@ let Renderer = (() => {
             this.markedPlugin = new MarkedPlugin(this);
             new AssetsPlugin(this);
             new IconsPlugin(this);
+            new HierarchyPlugin(this);
             new JavascriptIndexPlugin(this);
             new NavigationPlugin(this);
             new SitemapPlugin(this);

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

@@ -1,6 +1,6 @@
 import { ContextAwareRendererComponent } from "../components.js";
 import { MarkdownEvent, RendererEvent, type PageEvent } from "../events.js";
-import type { BundledTheme } from "shiki" with { "resolution-mode": "import" };
+import type { BundledTheme } from "@gerrit0/mini-shiki";
 import type { DefaultThemeRenderContext, Renderer } from "../index.js";
 import { type CommentDisplayPart } from "../../models/index.js";
 /**

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

@@ -172,7 +172,7 @@ let DefaultTheme = (() => {
                 urls.push(new UrlMapping("modules.html", project, this.reflectionTemplate));
                 urls.push(new UrlMapping("index.html", project, this.indexTemplate));
             }
-            if (getHierarchyRoots(project).length) {
+            if (this.application.options.getValue("includeHierarchySummary") && getHierarchyRoots(project).length) {
                 urls.push(new UrlMapping("hierarchy.html", project, this.hierarchyTemplate));
             }
             project.childrenIncludingDocuments?.forEach((child) => this.buildUrls(child, urls));

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

@@ -65,7 +65,7 @@ export declare class DefaultThemeRenderContext {
     reflectionFlags: (props: Reflection) => import("../../../utils/jsx.elements.js").JsxElement;
     footer: () => import("../../../utils/jsx.elements.js").JsxElement;
     header: (props: PageEvent<Reflection>) => import("../../../utils/jsx.elements.js").JsxElement;
-    hierarchy: (props: import("../../../models/index.js").DeclarationHierarchy | undefined) => import("../../../utils/jsx.elements.js").JsxElement | undefined;
+    hierarchy: (typeHierarchy: import("../../../models/index.js").DeclarationHierarchy | undefined) => import("../../../utils/jsx.elements.js").JsxElement | undefined;
     index: (props: import("../../../models/index.js").ContainerReflection) => import("../../../utils/jsx.elements.js").JsxElement;
     member: (props: DeclarationReflection | DocumentReflection) => import("../../../utils/jsx.elements.js").JsxElement;
     moduleReflection: (mod: DeclarationReflection | import("../../../models/index.js").ProjectReflection) => import("../../../utils/jsx.elements.js").JsxElement;

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

@@ -1,5 +1,5 @@
 import { JSX, Raw } from "../../../../utils/index.js";
-import { getDisplayName } from "../../lib.js";
+import { getDisplayName, getHierarchyRoots } from "../../lib.js";
 import { extname } from "path";
 function favicon(context) {
     const fav = context.options.getValue("favicon");
@@ -35,7 +35,7 @@ function buildSiteMetadata(context) {
         return null;
     }
 }
-export const defaultLayout = (context, template, props) => (JSX.createElement("html", { class: "default", lang: context.options.getValue("lang") },
+export const defaultLayout = (context, template, props) => (JSX.createElement("html", { class: "default", lang: context.options.getValue("lang"), "data-base": context.relativeURL("./") },
     JSX.createElement("head", null,
         JSX.createElement("meta", { charset: "utf-8" }),
         context.hook("head.begin", context),
@@ -55,6 +55,7 @@ export const defaultLayout = (context, template, props) => (JSX.createElement("h
         JSX.createElement("script", { async: true, src: context.relativeURL("assets/icons.js", true), id: "tsd-icons-script" }),
         JSX.createElement("script", { async: true, src: context.relativeURL("assets/search.js", true), id: "tsd-search-script" }),
         JSX.createElement("script", { async: true, src: context.relativeURL("assets/navigation.js", true), id: "tsd-nav-script" }),
+        !!getHierarchyRoots(props.project).length && (JSX.createElement("script", { async: true, src: context.relativeURL("assets/hierarchy.js", true), id: "tsd-hierarchy-script" })),
         context.hook("head.end", context)),
     JSX.createElement("body", null,
         context.hook("body.begin", context),

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

@@ -53,7 +53,7 @@ export function commentTags(context, props) {
                 : context.internationalization.translateTagName(item.tag);
             const anchor = context.slugger.slug(name);
             return (JSX.createElement(JSX.Fragment, null,
-                JSX.createElement("div", { class: `tsd-tag-${name}` },
+                JSX.createElement("div", { class: `tsd-tag-${item.tag.substring(1)}` },
                     JSX.createElement("h4", { class: "tsd-anchor-link" },
                         JSX.createElement("a", { id: anchor, class: "tsd-anchor" }),
                         name,

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

@@ -1,4 +1,4 @@
 import type { DefaultThemeRenderContext } from "../DefaultThemeRenderContext.js";
 import { JSX } from "../../../../utils/index.js";
 import type { DeclarationHierarchy } from "../../../../models/index.js";
-export declare function hierarchy(context: DefaultThemeRenderContext, props: DeclarationHierarchy | undefined): JSX.Element | undefined;
+export declare function hierarchy(context: DefaultThemeRenderContext, typeHierarchy: DeclarationHierarchy | undefined): JSX.Element | undefined;

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

@@ -9,22 +9,22 @@ function hasAnyLinkedReferenceType(h) {
         return true;
     return hasAnyLinkedReferenceType(h.next);
 }
-export function hierarchy(context, props) {
-    if (!props)
+export function hierarchy(context, typeHierarchy) {
+    if (!typeHierarchy)
         return;
-    const fullLink = hasAnyLinkedReferenceType(props) ? (JSX.createElement(JSX.Fragment, null,
+    const summaryLink = context.options.getValue("includeHierarchySummary") && hasAnyLinkedReferenceType(typeHierarchy) ? (JSX.createElement(JSX.Fragment, null,
         " ",
         "(",
-        JSX.createElement("a", { href: context.relativeURL("hierarchy.html") + "#" + context.page.model.getFullName() }, context.i18n.theme_hierarchy_view_full()),
+        JSX.createElement("a", { href: context.relativeURL("hierarchy.html") + "#" + context.page.model.getFullName() }, context.i18n.theme_hierarchy_view_summary()),
         ")")) : (JSX.createElement(JSX.Fragment, null));
-    return (JSX.createElement("section", { class: "tsd-panel tsd-hierarchy" },
+    return (JSX.createElement("section", { class: "tsd-panel tsd-hierarchy", "data-refl": context.page.model.id },
         JSX.createElement("h4", null,
             context.i18n.theme_hierarchy(),
-            fullLink),
-        hierarchyList(context, props)));
+            summaryLink),
+        hierarchyList(context, typeHierarchy)));
 }
 function hierarchyList(context, props) {
-    return (JSX.createElement("ul", { class: "tsd-hierarchy" }, props.types.map((item, i, l) => (JSX.createElement("li", null,
-        props.isTarget ? JSX.createElement("span", { class: "target" }, item.toString()) : context.type(item),
+    return (JSX.createElement("ul", { class: "tsd-hierarchy" }, props.types.map((item, i, l) => (JSX.createElement("li", { class: "tsd-hierarchy-item" },
+        props.isTarget ? JSX.createElement("span", { class: "tsd-hierarchy-target" }, item.toString()) : context.type(item),
         i === l.length - 1 && !!props.next && hierarchyList(context, props.next))))));
 }

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

@@ -67,7 +67,7 @@ export function settings(context) {
 export const navigation = function navigation(context, props) {
     return (JSX.createElement("nav", { class: "tsd-navigation" },
         JSX.createElement("a", { href: context.urlTo(props.project), class: classNames({ current: props.project === props.model }) }, getDisplayName(props.project)),
-        JSX.createElement("ul", { class: "tsd-small-nested-navigation", id: "tsd-nav-container", "data-base": context.relativeURL("./") },
+        JSX.createElement("ul", { class: "tsd-small-nested-navigation", id: "tsd-nav-container" },
             JSX.createElement("li", null, context.i18n.theme_loading()))));
 };
 export function pageSidebar(context, props) {

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

@@ -2,7 +2,7 @@ import { JSX } from "../../../../utils/index.js";
 import { getDisplayName } from "../../lib.js";
 export const toolbar = (context, props) => (JSX.createElement("header", { class: "tsd-page-toolbar" },
     JSX.createElement("div", { class: "tsd-toolbar-contents container" },
-        JSX.createElement("div", { class: "table-cell", id: "tsd-search", "data-base": context.relativeURL("./") },
+        JSX.createElement("div", { class: "table-cell", id: "tsd-search" },
             JSX.createElement("div", { class: "field" },
                 JSX.createElement("label", { for: "tsd-search-field", class: "tsd-widget tsd-toolbar-icon search no-caption" }, context.icons.search()),
                 JSX.createElement("input", { type: "text", id: "tsd-search-field", "aria-label": context.i18n.theme_search() })),

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

@@ -192,6 +192,7 @@ function renderChild(context, child, renderAnchors, highlight) {
 function renderIndexSignature(context, index) {
     return (JSX.createElement("li", { class: "tsd-parameter-index-signature" },
         JSX.createElement("h5", null,
+            index.flags.isReadonly && JSX.createElement("span", { class: "tsd-signature-keyword" }, "readonly "),
             JSX.createElement("span", { class: "tsd-signature-symbol" }, "["),
             index.parameters.map((item) => (JSX.createElement(JSX.Fragment, null,
                 JSX.createElement("span", { class: getKindClass(item) }, item.name),

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

@@ -1,27 +1,32 @@
 import { JSX } from "../../../../utils/index.js";
 import { getHierarchyRoots } from "../../lib.js";
-function fullHierarchy(context, root, seen = new Set()) {
-    if (seen.has(root))
-        return;
+function fullHierarchy(context, root, seen) {
+    if (seen.has(root)) {
+        return (JSX.createElement("li", { "data-refl": root.id },
+            JSX.createElement("a", { href: context.urlTo(root) },
+                context.icons[root.kind](),
+                root.name)));
+    }
     seen.add(root);
+    const children = [];
+    for (const child of [...(root.implementedBy || []), ...(root.extendedBy || [])]) {
+        if (child.reflection) {
+            children.push(fullHierarchy(context, child.reflection, seen));
+        }
+    }
     // Note: We don't use root.anchor for the anchor, because those are built on a per page basis.
     // And classes/interfaces get their own page, so all the anchors will be empty anyways.
     // Full name should be safe here, since this list only includes classes/interfaces.
-    return (JSX.createElement("li", null,
+    return (JSX.createElement("li", { "data-refl": root.id },
         JSX.createElement("a", { id: root.getFullName(), class: "tsd-anchor" }),
         JSX.createElement("a", { href: context.urlTo(root) },
             context.icons[root.kind](),
             root.name),
-        JSX.createElement("ul", null,
-            root.implementedBy?.map((child) => {
-                return child.reflection && fullHierarchy(context, child.reflection, seen);
-            }),
-            root.extendedBy?.map((child) => {
-                return child.reflection && fullHierarchy(context, child.reflection, seen);
-            }))));
+        children.length && JSX.createElement("ul", null, children)));
 }
 export function hierarchyTemplate(context, props) {
+    const seen = new Set();
     return (JSX.createElement(JSX.Fragment, null,
-        JSX.createElement("h2", null, context.i18n.theme_class_hierarchy_title()),
-        getHierarchyRoots(props.project).map((root) => (JSX.createElement("ul", { class: "tsd-full-hierarchy" }, fullHierarchy(context, root))))));
+        JSX.createElement("h2", null, context.i18n.theme_hierarchy_summary()),
+        getHierarchyRoots(props.project).map((root) => (JSX.createElement("ul", { class: "tsd-full-hierarchy" }, fullHierarchy(context, root, seen))))));
 }

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

@@ -38,6 +38,7 @@ export function reflectionTemplate(context, props) {
 function renderIndexSignature(context, index) {
     return (JSX.createElement("li", { class: "tsd-index-signature" },
         JSX.createElement("div", { class: "tsd-signature" },
+            index.flags.isReadonly && JSX.createElement("span", { class: "tsd-signature-keyword" }, "readonly "),
             JSX.createElement("span", { class: "tsd-signature-symbol" }, "["),
             index.parameters.map((item) => (JSX.createElement(JSX.Fragment, null,
                 JSX.createElement("span", { class: getKindClass(item) }, item.name),