typedoc 0.28.0-beta.0 → 0.28.0-beta.2

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

@@ -56,7 +56,8 @@ declare const _default: {
     failed_to_resolve_link_to_0_in_document_1_may_have_meant_2: "无法解析文档 {1} 中指向 “{0}” 的链接。您可能想要 “{2}”";
     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}";
+    invalid_intentionally_not_documented_names_0: "以下的限定反射名称被设定为刻意无文档说明，但它们要么未在文档中被引用，要么已有文档说明：\n\t{0}";
+    invalid_intentionally_not_exported_symbols_0: "以下符号被设定为刻意非导出，但它们要么未在文档中被引用，要么已为导出符号：\n{0}";
     reflection_0_has_unused_mergeModuleWith_tag: "{0} 中存在无法解析的 @mergeModuleWith 标签";
     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}";
@@ -179,6 +180,7 @@ declare const _default: {
     help_basePath: string;
     help_excludeTags: string;
     help_notRenderedTags: string;
+    help_cascadedModifierTags: string;
     help_readme: string;
     help_cname: string;
     help_favicon: string;
@@ -207,6 +209,7 @@ declare const _default: {
     help_searchGroupBoosts: string;
     help_useFirstParagraphOfCommentAsSummary: string;
     help_jsDocCompatibility: string;
+    help_suppressCommentWarningsInDeclarationFiles: string;
     help_commentStyle: string;
     help_useTsLinkResolution: string;
     help_preserveLinkText: string;
@@ -233,6 +236,8 @@ declare const _default: {
     help_treatValidationWarningsAsErrors: string;
     help_intentionallyNotExported: string;
     help_requiredToBeDocumented: string;
+    help_packagesRequiringDocumentation: string;
+    help_intentionallyNotDocumented: string;
     help_validation: string;
     unknown_option_0_you_may_have_meant_1: "未知选项“{0}” 你可能指的是：\n{1}";
     option_0_must_be_between_1_and_2: "{0} 必须介于 {1} 和 {2} 之间";

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

@@ -1,7 +1,7 @@
 import { Reflection, type TraverseCallback } from "./Reflection.js";
 import { ReflectionCategory } from "./ReflectionCategory.js";
 import { ReflectionGroup } from "./ReflectionGroup.js";
-import type { ReflectionKind } from "./kind.js";
+import { ReflectionKind } from "./kind.js";
 import type { Deserializer, JSONOutput, Serializer } from "#serialization";
 import type { DocumentReflection } from "./DocumentReflection.js";
 import type { DeclarationReflection } from "./DeclarationReflection.js";
@@ -47,7 +47,7 @@ export declare abstract class ContainerReflection extends Reflection {
      * @returns     An array containing all children with the desired kind.
      */
     getChildrenByKind(kind: ReflectionKind): DeclarationReflection[];
-    addChild(child: DeclarationReflection | DocumentReflection): void;
+    addChild(child: Reflection): void;
     removeChild(child: DeclarationReflection | DocumentReflection): void;
     traverse(callback: TraverseCallback): void;
     toObject(serializer: Serializer): JSONOutput.ContainerReflection;

package/dist/lib/models/ContainerReflection.js

@@ -1,7 +1,8 @@
 import { Reflection, TraverseProperty } from "./Reflection.js";
 import { ReflectionCategory } from "./ReflectionCategory.js";
 import { ReflectionGroup } from "./ReflectionGroup.js";
-import { removeIfPresent } from "#utils";
+import { ReflectionKind } from "./kind.js";
+import { assertNever, removeIfPresent } from "#utils";
 /**
  * @category Reflections
  */
@@ -50,13 +51,36 @@ export class ContainerReflection extends Reflection {
         if (child.isDeclaration()) {
             this.children ||= [];
             this.children.push(child);
+            this.childrenIncludingDocuments ||= [];
+            this.childrenIncludingDocuments.push(child);
         }
-        else {
+        else if (child.isDocument()) {
             this.documents ||= [];
             this.documents.push(child);
+            this.childrenIncludingDocuments ||= [];
+            this.childrenIncludingDocuments.push(child);
+        }
+        else if (this.isDeclaration() && child.isSignature()) {
+            switch (child.kind) {
+                case ReflectionKind.CallSignature:
+                case ReflectionKind.ConstructorSignature:
+                    this.signatures ||= [];
+                    this.signatures.push(child);
+                    break;
+                case ReflectionKind.IndexSignature:
+                    this.indexSignatures ||= [];
+                    this.indexSignatures.push(child);
+                    break;
+                case ReflectionKind.GetSignature:
+                case ReflectionKind.SetSignature:
+                    throw new Error("Unsupported child type: " + ReflectionKind[child.kind]);
+                default:
+                    assertNever(child.kind);
+            }
+        }
+        else {
+            throw new Error("Unsupported child type: " + ReflectionKind[child.kind]);
         }
-        this.childrenIncludingDocuments ||= [];
-        this.childrenIncludingDocuments.push(child);
     }
     removeChild(child) {
         if (child.isDeclaration()) {

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

@@ -82,7 +82,7 @@ export declare class ProjectReflection extends ContainerReflection {
      */
     removeReflection(reflection: Reflection): void;
     /** @internal */
-    mergeModules(source: DeclarationReflection, target: DeclarationReflection | ProjectReflection): void;
+    mergeReflections(source: DeclarationReflection, target: DeclarationReflection | ProjectReflection): void;
     /**
      * Remove a reflection without updating the parent reflection to remove references to the removed reflection.
      */

package/dist/lib/models/ProjectReflection.js

@@ -168,7 +168,7 @@ export class ProjectReflection extends ContainerReflection {
         });
     }
     /** @internal */
-    mergeModules(source, target) {
+    mergeReflections(source, target) {
         // First, tell the children about their new parent
         delete this.referenceGraph;
         const oldChildrenIds = this.reflectionChildren.getNoInsert(source.id) || [];

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

@@ -46,6 +46,16 @@ export declare class ReflectionSymbolId {
      * Note: This can only be non-NaN if {@link pos} is finite.
      */
     transientId: number;
+    /**
+     * Note: This is **not** serialized, only {@link packageName} and {@link packagePath} path
+     * information is preserved when serializing. This is set so that it is available to plugins
+     * when initially converting a project.
+     *
+     * @privateRemarks
+     * This is used by typedoc-plugin-dt-links to determine the path to read to get the source
+     * code of a definitely typed package.
+     */
+    fileName?: NormalizedPath;
     constructor(json: JSONOutput.ReflectionSymbolId);
     getStableKey(): ReflectionSymbolIdString;
     toDeclarationReference(): DeclarationReference;

package/dist/lib/models/ReflectionSymbolId.js

@@ -40,6 +40,16 @@ export class ReflectionSymbolId {
      * Note: This can only be non-NaN if {@link pos} is finite.
      */
     transientId = NaN;
+    /**
+     * Note: This is **not** serialized, only {@link packageName} and {@link packagePath} path
+     * information is preserved when serializing. This is set so that it is available to plugins
+     * when initially converting a project.
+     *
+     * @privateRemarks
+     * This is used by typedoc-plugin-dt-links to determine the path to read to get the source
+     * code of a definitely typed package.
+     */
+    fileName;
     constructor(json) {
         this.packageName = json.packageName;
         this.packagePath = json.packagePath;

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

@@ -70,6 +70,7 @@ export declare class FormattedCodeBuilder {
     reflection(reflection: DeclarationReflection, options: {
         topLevelLinks: boolean;
     }): FormatterNode;
+    typeAlias(item: DeclarationReflection): FormatterNode;
     interface(item: DeclarationReflection): FormatterNode;
     member(members: FormatterNode[], item: DeclarationReflection, options: {
         topLevelLinks: boolean;

package/dist/lib/output/formatter.js

@@ -515,6 +515,9 @@ export class FormattedCodeBuilder {
         }
         return simpleElement(JSX.createElement("span", { class: "tsd-signature-symbol" }, "{}"));
     }
+    typeAlias(item) {
+        return nodes(simpleElement(JSX.createElement("span", { class: "tsd-signature-keyword" }, "type")), space(), simpleElement(JSX.createElement("span", { class: getKindClass(item) }, item.name)), this.typeParameters(item), space(), simpleElement(JSX.createElement("span", { class: "tsd-signature-symbol" }, "=")), space(), this.reflection(item, { topLevelLinks: true }));
+    }
     interface(item) {
         return nodes(simpleElement(JSX.createElement("span", { class: "tsd-signature-keyword" }, "interface")), space(), simpleElement(JSX.createElement("span", { class: getKindClass(item) }, item.name)), this.typeParameters(item), space(), this.reflection(item, { topLevelLinks: true }));
     }

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

@@ -1,10 +1,8 @@
 export { IndexEvent, MarkdownEvent, PageEvent, type PageHeading, RendererEvent } from "./events.js";
-export { UrlMapping } from "./models/UrlMapping.js";
-export type { RenderTemplate } from "./models/UrlMapping.js";
 export { Renderer, type RendererEvents } from "./renderer.js";
 export type { RendererHooks } from "./renderer.js";
 export { Theme } from "./theme.js";
-export { DefaultTheme, type NavigationElement } from "./themes/default/DefaultTheme.js";
+export { DefaultTheme, type NavigationElement, type RenderTemplate } from "./themes/default/DefaultTheme.js";
 export { DefaultThemeRenderContext } from "./themes/default/DefaultThemeRenderContext.js";
 export type { Icons } from "./themes/default/partials/icon.js";
 export { Slugger } from "./themes/default/Slugger.js";

package/dist/lib/output/index.js

@@ -1,5 +1,4 @@
 export { IndexEvent, MarkdownEvent, PageEvent, RendererEvent } from "./events.js";
-export { UrlMapping } from "./models/UrlMapping.js";
 export { Renderer } from "./renderer.js";
 export { Theme } from "./theme.js";
 export { DefaultTheme } from "./themes/default/DefaultTheme.js";

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

@@ -139,6 +139,10 @@ let JavascriptIndexPlugin = (() => {
                     url: theme.router.getFullUrl(reflection),
                     classes: theme.getReflectionClasses(reflection),
                 };
+                const icon = theme.getReflectionIcon(reflection);
+                if (icon !== reflection.kind) {
+                    row.icon = icon;
+                }
                 if (parent) {
                     row.parent = parent.getFullName();
                 }

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

@@ -177,10 +177,6 @@ export declare class Renderer extends AbstractComponent<Application, RendererEve
     private accessor githubPages;
     /** @internal */
     accessor cacheBust: boolean;
-    private accessor lightTheme;
-    private accessor darkTheme;
-    private accessor highlightLanguages;
-    private accessor ignoredHighlightLanguages;
     private accessor pretty;
     renderStartTime: number;
     markedPlugin: MarkedPlugin;
@@ -207,7 +203,6 @@ export declare class Renderer extends AbstractComponent<Application, RendererEve
      */
     render(project: ProjectReflection, outputDirectory: string): Promise<void>;
     private runPreRenderJobs;
-    private loadHighlighter;
     /**
      * Render a single page.
      *

package/dist/lib/output/renderer.js

@@ -46,7 +46,6 @@ import { IndexEvent, PageEvent, RendererEvent } from "./events.js";
 import { writeFileSync } from "../utils/fs.js";
 import { DefaultTheme } from "./themes/default/DefaultTheme.js";
 import { AbstractComponent, Option } from "../utils/index.js";
-import { loadHighlighter } from "../utils/highlighter.js";
 import { EventHooks, i18n, JSX } from "#utils";
 import { AssetsPlugin, HierarchyPlugin, IconsPlugin, JavascriptIndexPlugin, MarkedPlugin, NavigationPlugin, SitemapPlugin, } from "./plugins/index.js";
 import { CategoryRouter, GroupRouter, KindDirRouter, KindRouter, StructureDirRouter, StructureRouter, } from "./router.js";
@@ -102,18 +101,6 @@ let Renderer = (() => {
     let _cacheBust_decorators;
     let _cacheBust_initializers = [];
     let _cacheBust_extraInitializers = [];
-    let _lightTheme_decorators;
-    let _lightTheme_initializers = [];
-    let _lightTheme_extraInitializers = [];
-    let _darkTheme_decorators;
-    let _darkTheme_initializers = [];
-    let _darkTheme_extraInitializers = [];
-    let _highlightLanguages_decorators;
-    let _highlightLanguages_initializers = [];
-    let _highlightLanguages_extraInitializers = [];
-    let _ignoredHighlightLanguages_decorators;
-    let _ignoredHighlightLanguages_initializers = [];
-    let _ignoredHighlightLanguages_extraInitializers = [];
     let _pretty_decorators;
     let _pretty_initializers = [];
     let _pretty_extraInitializers = [];
@@ -126,10 +113,6 @@ let Renderer = (() => {
             _cname_decorators = [Option("cname")];
             _githubPages_decorators = [Option("githubPages")];
             _cacheBust_decorators = [Option("cacheBust")];
-            _lightTheme_decorators = [Option("lightHighlightTheme")];
-            _darkTheme_decorators = [Option("darkHighlightTheme")];
-            _highlightLanguages_decorators = [Option("highlightLanguages")];
-            _ignoredHighlightLanguages_decorators = [Option("ignoredHighlightLanguages")];
             _pretty_decorators = [Option("pretty")];
             __esDecorate(this, null, _themeName_decorators, { kind: "accessor", name: "themeName", static: false, private: false, access: { has: obj => "themeName" in obj, get: obj => obj.themeName, set: (obj, value) => { obj.themeName = value; } }, metadata: _metadata }, _themeName_initializers, _themeName_extraInitializers);
             __esDecorate(this, null, _routerName_decorators, { kind: "accessor", name: "routerName", static: false, private: false, access: { has: obj => "routerName" in obj, get: obj => obj.routerName, set: (obj, value) => { obj.routerName = value; } }, metadata: _metadata }, _routerName_initializers, _routerName_extraInitializers);
@@ -137,10 +120,6 @@ let Renderer = (() => {
             __esDecorate(this, null, _cname_decorators, { kind: "accessor", name: "cname", static: false, private: false, access: { has: obj => "cname" in obj, get: obj => obj.cname, set: (obj, value) => { obj.cname = value; } }, metadata: _metadata }, _cname_initializers, _cname_extraInitializers);
             __esDecorate(this, null, _githubPages_decorators, { kind: "accessor", name: "githubPages", static: false, private: false, access: { has: obj => "githubPages" in obj, get: obj => obj.githubPages, set: (obj, value) => { obj.githubPages = value; } }, metadata: _metadata }, _githubPages_initializers, _githubPages_extraInitializers);
             __esDecorate(this, null, _cacheBust_decorators, { kind: "accessor", name: "cacheBust", static: false, private: false, access: { has: obj => "cacheBust" in obj, get: obj => obj.cacheBust, set: (obj, value) => { obj.cacheBust = value; } }, metadata: _metadata }, _cacheBust_initializers, _cacheBust_extraInitializers);
-            __esDecorate(this, null, _lightTheme_decorators, { kind: "accessor", name: "lightTheme", static: false, private: false, access: { has: obj => "lightTheme" in obj, get: obj => obj.lightTheme, set: (obj, value) => { obj.lightTheme = value; } }, metadata: _metadata }, _lightTheme_initializers, _lightTheme_extraInitializers);
-            __esDecorate(this, null, _darkTheme_decorators, { kind: "accessor", name: "darkTheme", static: false, private: false, access: { has: obj => "darkTheme" in obj, get: obj => obj.darkTheme, set: (obj, value) => { obj.darkTheme = value; } }, metadata: _metadata }, _darkTheme_initializers, _darkTheme_extraInitializers);
-            __esDecorate(this, null, _highlightLanguages_decorators, { kind: "accessor", name: "highlightLanguages", static: false, private: false, access: { has: obj => "highlightLanguages" in obj, get: obj => obj.highlightLanguages, set: (obj, value) => { obj.highlightLanguages = value; } }, metadata: _metadata }, _highlightLanguages_initializers, _highlightLanguages_extraInitializers);
-            __esDecorate(this, null, _ignoredHighlightLanguages_decorators, { kind: "accessor", name: "ignoredHighlightLanguages", static: false, private: false, access: { has: obj => "ignoredHighlightLanguages" in obj, get: obj => obj.ignoredHighlightLanguages, set: (obj, value) => { obj.ignoredHighlightLanguages = value; } }, metadata: _metadata }, _ignoredHighlightLanguages_initializers, _ignoredHighlightLanguages_extraInitializers);
             __esDecorate(this, null, _pretty_decorators, { kind: "accessor", name: "pretty", static: false, private: false, access: { has: obj => "pretty" in obj, get: obj => obj.pretty, set: (obj, value) => { obj.pretty = value; } }, metadata: _metadata }, _pretty_initializers, _pretty_extraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
@@ -224,19 +203,7 @@ let Renderer = (() => {
         /** @internal */
         get cacheBust() { return this.#cacheBust_accessor_storage; }
         set cacheBust(value) { this.#cacheBust_accessor_storage = value; }
-        #lightTheme_accessor_storage = (__runInitializers(this, _cacheBust_extraInitializers), __runInitializers(this, _lightTheme_initializers, void 0));
-        get lightTheme() { return this.#lightTheme_accessor_storage; }
-        set lightTheme(value) { this.#lightTheme_accessor_storage = value; }
-        #darkTheme_accessor_storage = (__runInitializers(this, _lightTheme_extraInitializers), __runInitializers(this, _darkTheme_initializers, void 0));
-        get darkTheme() { return this.#darkTheme_accessor_storage; }
-        set darkTheme(value) { this.#darkTheme_accessor_storage = value; }
-        #highlightLanguages_accessor_storage = (__runInitializers(this, _darkTheme_extraInitializers), __runInitializers(this, _highlightLanguages_initializers, void 0));
-        get highlightLanguages() { return this.#highlightLanguages_accessor_storage; }
-        set highlightLanguages(value) { this.#highlightLanguages_accessor_storage = value; }
-        #ignoredHighlightLanguages_accessor_storage = (__runInitializers(this, _highlightLanguages_extraInitializers), __runInitializers(this, _ignoredHighlightLanguages_initializers, void 0));
-        get ignoredHighlightLanguages() { return this.#ignoredHighlightLanguages_accessor_storage; }
-        set ignoredHighlightLanguages(value) { this.#ignoredHighlightLanguages_accessor_storage = value; }
-        #pretty_accessor_storage = (__runInitializers(this, _ignoredHighlightLanguages_extraInitializers), __runInitializers(this, _pretty_initializers, void 0));
+        #pretty_accessor_storage = (__runInitializers(this, _cacheBust_extraInitializers), __runInitializers(this, _pretty_initializers, void 0));
         get pretty() { return this.#pretty_accessor_storage; }
         set pretty(value) { this.#pretty_accessor_storage = value; }
         renderStartTime = (__runInitializers(this, _pretty_extraInitializers), -1);
@@ -298,6 +265,7 @@ let Renderer = (() => {
             for (const page of pages) {
                 this.renderDocument(outputDirectory, page);
             }
+            this.postRenderAsyncJobs.push(async (o) => await this.theme.postRender(o));
             await Promise.all(this.postRenderAsyncJobs.map((job) => job(output)));
             this.postRenderAsyncJobs = [];
             this.trigger(RendererEvent.END, output);
@@ -307,16 +275,11 @@ let Renderer = (() => {
         }
         async runPreRenderJobs(output) {
             const start = Date.now();
-            this.preRenderAsyncJobs.push(this.loadHighlighter.bind(this));
+            this.preRenderAsyncJobs.push(async (o) => await this.theme.preRender(o));
             await Promise.all(this.preRenderAsyncJobs.map((job) => job(output)));
             this.preRenderAsyncJobs = [];
             this.application.logger.verbose(`Pre render async jobs took ${Date.now() - start}ms`);
         }
-        async loadHighlighter() {
-            await loadHighlighter(this.lightTheme, this.darkTheme, 
-            // Checked in option validation
-            this.highlightLanguages, this.ignoredHighlightLanguages);
-        }
         /**
          * Render a single page.
          *

package/dist/lib/output/router.js

@@ -135,6 +135,9 @@ let BaseRouter = (() => {
             return Array.from(this.fullUrls.keys());
         }
         getAnchor(refl) {
+            if (!this.anchors.has(refl)) {
+                this.application.logger.verbose(`${refl.getFullName()} does not have an anchor but one was requested, this is a bug in the theme`);
+            }
             return this.anchors.get(refl);
         }
         hasOwnDocument(refl) {
@@ -161,6 +164,9 @@ let BaseRouter = (() => {
                 }
             }
             if (equal && !to.isProject()) {
+                if (fromUrl === toUrl) {
+                    return "";
+                }
                 return `#${this.getAnchor(to)}`;
             }
             return "../".repeat(slashes) + toUrl.substring(start);

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

@@ -1,5 +1,5 @@
 import { RendererComponent } from "./components.js";
-import type { PageEvent } from "./events.js";
+import type { PageEvent, RendererEvent } from "./events.js";
 import type { Reflection } from "../models/index.js";
 /**
  * Base class of all themes.
@@ -12,4 +12,12 @@ export declare abstract class Theme extends RendererComponent {
      * Renders the provided page to a string, which will be written to disk by the {@link Renderer}
      */
     abstract render(event: PageEvent<Reflection>): string;
+    /**
+     * Optional hook to call pre-render jobs
+     */
+    preRender(_event: RendererEvent): Promise<void>;
+    /**
+     * Optional hook to call post-render jobs
+     */
+    postRender(_event: RendererEvent): Promise<void>;
 }

package/dist/lib/output/theme.js

@@ -6,4 +6,12 @@ import { RendererComponent } from "./components.js";
  * class instance which is also created by the {@link Renderer} class.
  */
 export class Theme extends RendererComponent {
+    /**
+     * Optional hook to call pre-render jobs
+     */
+    async preRender(_event) { }
+    /**
+     * Optional hook to call post-render jobs
+     */
+    async postRender(_event) { }
 }

package/dist/lib/output/themes/MarkedPlugin.js

@@ -175,7 +175,7 @@ let MarkedPlugin = (() => {
                                         // If we don't have a URL the user probably linked to some deeply nested property
                                         // which doesn't get an assigned URL. We'll walk upwards until we find a reflection
                                         // which has a URL and link to that instead.
-                                        if (!url) {
+                                        if (typeof url === "undefined") {
                                             // Walk upwards to find something we can link to.
                                             let target = part.target.parent;
                                             while (!context.router.hasUrl(target)) {
@@ -227,7 +227,7 @@ let MarkedPlugin = (() => {
                                         url = context.relativeURL(`media/${fileName}`);
                                     }
                                 }
-                                if (url) {
+                                if (typeof url !== "undefined") {
                                     if (part.targetAnchor) {
                                         url += "#" + part.targetAnchor;
                                         if (typeof refl === "object") {
@@ -311,7 +311,7 @@ let MarkedPlugin = (() => {
                     text: content,
                     level,
                 });
-                return `<a id="${slug}" class="tsd-anchor"></a><${token.tag} class="tsd-anchor-link">`;
+                return `<${token.tag} id="${slug}" class="tsd-anchor-link">`;
             };
             this.parser.renderer.rules["heading_close"] = (tokens, idx) => {
                 return `${JSX.renderElement(anchorIcon(this.renderContext, this.lastHeaderSlug))}</${tokens[idx].tag}>`;

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

@@ -1,8 +1,7 @@
 import { Theme } from "../../theme.js";
 import type { Renderer } from "../../renderer.js";
 import { type ContainerReflection, type DocumentReflection, type ProjectReflection, type Reflection, ReflectionKind } from "../../../models/index.js";
-import { type RenderTemplate } from "../../models/UrlMapping.js";
-import type { PageEvent } from "../../events.js";
+import type { PageEvent, RendererEvent } from "../../events.js";
 import type { MarkedPlugin } from "../../plugins/index.js";
 import { DefaultThemeRenderContext } from "./DefaultThemeRenderContext.js";
 import { type Icons } from "./partials/icon.js";
@@ -14,7 +13,13 @@ export interface NavigationElement {
     kind?: ReflectionKind;
     class?: string;
     children?: NavigationElement[];
+    icon?: string | number;
 }
+/**
+ * @param data the reflection to render
+ * @returns either a string to be written to the file, or an element to be serialized and then written.
+ */
+export type RenderTemplate<T> = (data: T) => JSX.Element | string;
 export declare class DefaultTheme extends Theme {
     usedFileNames: Set<string>;
     /** @internal */
@@ -35,6 +40,10 @@ export declare class DefaultTheme extends Theme {
      */
     icons: Icons;
     ContextClass: typeof DefaultThemeRenderContext;
+    private accessor lightTheme;
+    private accessor darkTheme;
+    private accessor highlightLanguages;
+    private accessor ignoredHighlightLanguages;
     getRenderContext(pageEvent: PageEvent<Reflection>): DefaultThemeRenderContext;
     documentTemplate: (pageEvent: PageEvent<DocumentReflection>) => JSX.Element;
     reflectionTemplate: (pageEvent: PageEvent<ContainerReflection>) => JSX.Element;
@@ -42,17 +51,18 @@ export declare class DefaultTheme extends Theme {
     hierarchyTemplate: (pageEvent: PageEvent<ProjectReflection>) => JSX.Element;
     defaultLayoutTemplate: (pageEvent: PageEvent<Reflection>, template: RenderTemplate<PageEvent<Reflection>>) => JSX.Element;
     getReflectionClasses(reflection: Reflection): string;
+    /**
+     * This is used so that themes may define multiple icons for modified icons (e.g. method, and inherited method)
+     */
+    getReflectionIcon(reflection: Reflection): keyof this["icons"] & (string | number);
     /**
      * Create a new DefaultTheme instance.
      *
      * @param renderer  The renderer this theme is attached to.
      */
     constructor(renderer: Renderer);
-    /**
-     * @param reflection  The reflection the url should be generated for.
-     */
-    getFileName(reflection: Reflection): string;
     render(page: PageEvent<Reflection>): string;
+    preRender(_event: RendererEvent): Promise<void>;
     private _navigationCache;
     /**
      * If implementing a custom theme, it is recommended to override {@link buildNavigation} instead.