typedoc 0.27.5 → 0.27.6

package/dist/lib/application.js

@@ -317,9 +317,6 @@ let Application = (() => {
          */
         async convert() {
             const start = Date.now();
-            // We freeze here rather than in the Converter class since TypeDoc's tests reuse the Application
-            // with a few different settings.
-            this.options.freeze();
             this.logger.verbose(`Using TypeScript ${this.getTypeScriptVersion()} from ${this.getTypeScriptPath()}`);
             if (this.entryPointStrategy === EntryPointStrategy.Merge) {
                 return this._merge();
@@ -356,7 +353,6 @@ let Application = (() => {
             return project;
         }
         convertAndWatch(success) {
-            this.options.freeze();
             if (!this.options.getValue("preserveWatchOutput") &&
                 this.logger instanceof ConsoleLogger) {
                 ts.sys.clearScreen?.();

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

@@ -27,7 +27,8 @@ export interface ComponentPath {
      * How to resolve the `path`
      * - `.` - Navigate via `exports` of symbol
      * - `#` - Navigate via `members` of symbol
-     * - `~` - Navigate via `locals` of symbol
+     * - `~` - Navigate via `locals` of symbol (note: TypeDoc does not support
+     *   locals, see the declaration reference docs)
      */
     navigation: "." | "#" | "~";
     path: string;

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

@@ -300,6 +300,7 @@ export function parseDeclarationReference(source, pos, end) {
     let moduleSource;
     let symbolReference;
     let resolutionStart = "local";
+    let topLevelLocalReference = false;
     const moduleSourceOrSymbolRef = parseModuleSource(source, pos, end);
     if (moduleSourceOrSymbolRef) {
         if (moduleSourceOrSymbolRef[1] < end &&
@@ -308,6 +309,11 @@ export function parseDeclarationReference(source, pos, end) {
             pos = moduleSourceOrSymbolRef[1] + 1;
             resolutionStart = "global";
             moduleSource = moduleSourceOrSymbolRef[0];
+            // We might be referencing a local of a module
+            if (source[pos] === "~") {
+                topLevelLocalReference = true;
+                pos++;
+            }
         }
     }
     else if (source[pos] === "!") {
@@ -317,6 +323,9 @@ export function parseDeclarationReference(source, pos, end) {
     const ref = parseSymbolReference(source, pos, end);
     if (ref) {
         symbolReference = ref[0];
+        if (topLevelLocalReference && symbolReference.path?.length) {
+            symbolReference.path[0].navigation = "~";
+        }
         pos = ref[1];
     }
     if (!moduleSource && !symbolReference)

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

@@ -2,6 +2,7 @@ import ts from "typescript";
 import { DeclarationReflection, Reflection, ReflectionKind, ReflectionSymbolId, } from "../../models/index.js";
 import { parseDeclarationReference, } from "./declarationReference.js";
 import { resolveDeclarationReference } from "./declarationReferenceResolver.js";
+import { maxElementByScore } from "../../utils/array.js";
 const urlPrefix = /^(http|ftp)s?:\/\//;
 export function resolveLinks(comment, reflection, externalResolver, options) {
     comment.summary = resolvePartLinks(reflection, comment.summary, externalResolver, options);
@@ -48,11 +49,25 @@ function resolveLinkTag(reflection, part, externalResolver, options) {
         const tsTargets = reflection.project.getReflectionsFromSymbolId(part.target);
         if (tsTargets.length) {
             // Find the target most likely to have a real url in the generated documentation
-            target =
-                tsTargets.find((r) => r.kindOf(ReflectionKind.SomeExport)) ||
-                    tsTargets.find((r) => r.kindOf(ReflectionKind.SomeMember) &&
-                        r.parent?.kindOf(ReflectionKind.SomeExport)) ||
-                    tsTargets[0];
+            // 1. A direct export (class, interface, variable)
+            // 2. A property of a direct export (class/interface property)
+            // 3. A property of a type of an export (property on type alias)
+            // 4. Whatever the first symbol found was
+            target = maxElementByScore(tsTargets, (r) => {
+                if (r.kindOf(ReflectionKind.SomeExport)) {
+                    return 4;
+                }
+                if (r.kindOf(ReflectionKind.SomeMember) &&
+                    r.parent?.kindOf(ReflectionKind.SomeExport)) {
+                    return 3;
+                }
+                if (r.kindOf(ReflectionKind.SomeMember) &&
+                    r.parent?.kindOf(ReflectionKind.TypeLiteral) &&
+                    r.parent.parent?.kindOf(ReflectionKind.TypeAlias | ReflectionKind.Variable)) {
+                    return 2;
+                }
+                return 1;
+            });
             pos = end;
             defaultDisplayText =
                 part.tsLinkText ||

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

@@ -10,6 +10,7 @@ import type { CommentStyle, ValidationOptions } from "../utils/options/declarati
 import { type ExternalSymbolResolver, type ExternalResolveResult } from "./comments/linkResolver.js";
 import { type DeclarationReference } from "./comments/declarationReference.js";
 import type { FileRegistry } from "../models/FileRegistry.js";
+import { IncludePlugin } from "./plugins/IncludePlugin.js";
 export interface ConverterEvents {
     begin: [Context];
     end: [Context];
@@ -144,6 +145,8 @@ export declare class Converter extends AbstractComponent<Application, ConverterE
      * @event
      */
     static readonly EVENT_RESOLVE_END: "resolveEnd";
+    /** @internal @hidden */
+    includePlugin: IncludePlugin;
     constructor(owner: Application);
     /**
      * Compile the given source files and create a project reflection for them.

package/dist/lib/converter/converter.js

@@ -255,6 +255,8 @@ let Converter = (() => {
          * @event
          */
         static EVENT_RESOLVE_END = ConverterEvents.RESOLVE_END;
+        /** @internal @hidden */
+        includePlugin;
         constructor(owner) {
             super(owner);
             const userConfiguredSymbolResolver = (ref, refl, _part, symbolId) => {
@@ -294,7 +296,7 @@ let Converter = (() => {
             new PackagePlugin(this);
             new SourcePlugin(this);
             new TypePlugin(this);
-            new IncludePlugin(this);
+            this.includePlugin = new IncludePlugin(this);
             new MergeModuleWithPlugin(this);
         }
         /**

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

@@ -1,4 +1,5 @@
 import { ConverterComponent } from "../components.js";
+import type { CommentDisplayPart, Reflection } from "../../models/index.js";
 import type { Converter } from "../converter.js";
 /**
  * Handles `@include` and `@includeCode` within comments/documents.
@@ -7,5 +8,5 @@ export declare class IncludePlugin extends ConverterComponent {
     get logger(): import("../../utils/loggers.js").Logger;
     constructor(owner: Converter);
     private onCreate;
-    private checkIncludeTagsParts;
+    checkIncludeTagsParts(refl: Reflection, relative: string, parts: CommentDisplayPart[], included?: string[]): void;
 }

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

@@ -155,6 +155,9 @@ let PackagePlugin = (() => {
             if (this.readmeFile && this.readmeContents) {
                 const { content } = this.application.converter.parseRawComment(new MinimalSourceFile(this.readmeContents, this.readmeFile), project.files);
                 project.readme = content;
+                // This isn't ideal, but seems better than figuring out the readme
+                // path over in the include plugin...
+                this.owner.includePlugin.checkIncludeTagsParts(project, Path.dirname(this.readmeFile), content);
             }
             if (this.packageJson) {
                 project.packageName = this.packageJson.name;

package/dist/lib/converter/symbols.js

@@ -501,7 +501,7 @@ function createAlias(target, context, symbol, exportSymbol) {
     if (context.converter.excludeReferences)
         return;
     // We already have this. Create a reference.
-    const ref = new ReferenceReflection(exportSymbol?.name ?? symbol.name, target, context.scope);
+    const ref = new ReferenceReflection(exportSymbol?.name ?? symbol.name, target.isReference() ? target.getTargetReflection() : target, context.scope);
     context.postReflectionCreation(ref, symbol, exportSymbol);
     context.finalizeDeclarationReflection(ref);
 }

package/dist/lib/converter/types.js

@@ -7,7 +7,7 @@ import { ConverterEvents } from "./converter-events.js";
 import { convertIndexSignatures } from "./factories/index-signature.js";
 import { convertParameterNodes, convertTypeParameterNodes, createSignature, } from "./factories/signature.js";
 import { convertSymbol } from "./symbols.js";
-import { isObjectType } from "./utils/nodes.js";
+import { isObjectType, isTypeReference } from "./utils/nodes.js";
 import { removeUndefined } from "./utils/reflections.js";
 const converters = new Map();
 export function loadConverters() {
@@ -490,9 +490,22 @@ const referenceConverter = {
             ];
         }
         else {
-            ref.typeArguments = (type.aliasSymbol
+            // Default type arguments are filled with a reference to the default
+            // type. As TS doesn't support specifying earlier defaults, we know
+            // that this will only filter out type arguments which aren't specified
+            // by the user.
+            let ignoredArgs;
+            if (isTypeReference(type)) {
+                ignoredArgs = type.target.typeParameters
+                    ?.map((p) => p.getDefault())
+                    .filter((x) => !!x);
+            }
+            const args = type.aliasSymbol
                 ? type.aliasTypeArguments
-                : type.typeArguments)?.map((ref) => convertType(context, ref));
+                : type.typeArguments;
+            ref.typeArguments = args
+                ?.filter((ref) => !ignoredArgs?.includes(ref))
+                .map((ref) => convertType(context, ref));
         }
         return ref;
     },

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

@@ -4,3 +4,4 @@ export declare function isNamedNode(node: unknown): node is {
 };
 export declare function getHeritageTypes(declarations: readonly (ts.ClassDeclaration | ts.InterfaceDeclaration)[], kind: ts.SyntaxKind.ImplementsKeyword | ts.SyntaxKind.ExtendsKeyword): ts.ExpressionWithTypeArguments[];
 export declare function isObjectType(type: ts.Type): type is ts.ObjectType;
+export declare function isTypeReference(type: ts.Type): type is ts.TypeReference;

package/dist/lib/converter/utils/nodes.js

@@ -20,3 +20,7 @@ export function getHeritageTypes(declarations, kind) {
 export function isObjectType(type) {
     return typeof type.objectFlags === "number";
 }
+export function isTypeReference(type) {
+    return (isObjectType(type) &&
+        (type.objectFlags & ts.ObjectFlags.Reference) !== 0);
+}

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

@@ -160,6 +160,7 @@ module.exports = {
     help_lightHighlightTheme: "Specify the code highlighting theme in light mode",
     help_darkHighlightTheme: "Specify the code highlighting theme in dark mode",
     help_highlightLanguages: "Specify the languages which will be loaded to highlight code when rendering",
+    help_ignoredHighlightLanguages: "Specify languages which will be accepted as valid highlight languages, but will not be highlighted at runtime",
     help_typePrintWidth: "Width at which to wrap code to a new line when rendering a type",
     help_customCss: "Path to a custom CSS file to for the theme to import",
     help_customJs: "Path to a custom JS file to import",

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

@@ -147,6 +147,7 @@ declare const _default: {
     readonly help_lightHighlightTheme: "Specify the code highlighting theme in light mode";
     readonly help_darkHighlightTheme: "Specify the code highlighting theme in dark mode";
     readonly help_highlightLanguages: "Specify the languages which will be loaded to highlight code when rendering";
+    readonly help_ignoredHighlightLanguages: "Specify languages which will be accepted as valid highlight languages, but will not be highlighted at runtime";
     readonly help_typePrintWidth: "Width at which to wrap code to a new line when rendering a type";
     readonly help_customCss: "Path to a custom CSS file to for the theme to import";
     readonly help_customJs: "Path to a custom JS file to import";

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

@@ -171,6 +171,7 @@ export declare class Renderer extends AbstractComponent<Application, RendererEve
     private accessor lightTheme;
     private accessor darkTheme;
     private accessor highlightLanguages;
+    private accessor ignoredHighlightLanguages;
     private accessor pretty;
     renderStartTime: number;
     markedPlugin: MarkedPlugin;

package/dist/lib/output/renderer.js

@@ -108,6 +108,9 @@ let Renderer = (() => {
     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 = [];
@@ -122,6 +125,7 @@ let Renderer = (() => {
             _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, _cleanOutputDir_decorators, { kind: "accessor", name: "cleanOutputDir", static: false, private: false, access: { has: obj => "cleanOutputDir" in obj, get: obj => obj.cleanOutputDir, set: (obj, value) => { obj.cleanOutputDir = value; } }, metadata: _metadata }, _cleanOutputDir_initializers, _cleanOutputDir_extraInitializers);
@@ -131,6 +135,7 @@ let Renderer = (() => {
             __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 });
         }
@@ -206,7 +211,10 @@ let Renderer = (() => {
         #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; }
-        #pretty_accessor_storage = (__runInitializers(this, _highlightLanguages_extraInitializers), __runInitializers(this, _pretty_initializers, void 0));
+        #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));
         get pretty() { return this.#pretty_accessor_storage; }
         set pretty(value) { this.#pretty_accessor_storage = value; }
         renderStartTime = (__runInitializers(this, _pretty_extraInitializers), -1);
@@ -272,7 +280,7 @@ let Renderer = (() => {
         async loadHighlighter() {
             await loadHighlighter(this.lightTheme, this.darkTheme, 
             // Checked in option validation
-            this.highlightLanguages);
+            this.highlightLanguages, this.ignoredHighlightLanguages);
         }
         /**
          * Render a single page.

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

@@ -54,3 +54,4 @@ export declare function filter<T>(array: readonly T[] | undefined, predicate: (v
 export declare function aggregate<T>(arr: T[], fn: (item: T) => number): number;
 export declare function aggregateWithJoiner<T>(arr: T[], fn: (item: T) => number, joiner: string): number;
 export declare function joinArray<T>(arr: readonly T[] | undefined, joiner: string, mapper: (item: T) => string): string;
+export declare function maxElementByScore<T>(arr: readonly T[], score: (a: T) => number): T | undefined;

package/dist/lib/utils/array.js

@@ -141,3 +141,18 @@ export function joinArray(arr, joiner, mapper) {
     }
     return "";
 }
+export function maxElementByScore(arr, score) {
+    if (arr.length === 0) {
+        return undefined;
+    }
+    let largest = arr[0];
+    let largestScore = score(arr[0]);
+    for (let i = 1; i < arr.length; ++i) {
+        const itemScore = score(arr[i]);
+        if (itemScore > largestScore) {
+            largest = arr[i];
+            largestScore = itemScore;
+        }
+    }
+    return largest;
+}

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

@@ -1,5 +1,5 @@
 import * as shiki from "@gerrit0/mini-shiki";
-export declare function loadHighlighter(lightTheme: shiki.BundledTheme, darkTheme: shiki.BundledTheme, langs: shiki.BundledLanguage[]): Promise<void>;
+export declare function loadHighlighter(lightTheme: shiki.BundledTheme, darkTheme: shiki.BundledTheme, langs: shiki.BundledLanguage[], ignoredLangs: string[] | undefined): Promise<void>;
 export declare function isSupportedLanguage(lang: string): boolean;
 export declare function getSupportedLanguages(): string[];
 export declare function getSupportedThemes(): string[];

package/dist/lib/utils/highlighter.js

@@ -92,9 +92,11 @@ class DoubleHighlighter {
 }
 let shikiEngine;
 let highlighter;
-export async function loadHighlighter(lightTheme, darkTheme, langs) {
+let ignoredLanguages;
+export async function loadHighlighter(lightTheme, darkTheme, langs, ignoredLangs) {
     if (highlighter)
         return;
+    ignoredLanguages = ignoredLangs;
     if (!shikiEngine) {
         await shiki.loadBuiltinWasm();
         shikiEngine = await shiki.createOnigurumaEngine();
@@ -107,7 +109,7 @@ export async function loadHighlighter(lightTheme, darkTheme, langs) {
     highlighter = new DoubleHighlighter(hl, lightTheme, darkTheme);
 }
 export function isSupportedLanguage(lang) {
-    return getSupportedLanguages().includes(lang);
+    return ignoredLanguages?.includes(lang) || getSupportedLanguages().includes(lang);
 }
 export function getSupportedLanguages() {
     return supportedLanguages;
@@ -116,11 +118,11 @@ export function getSupportedThemes() {
     return supportedThemes;
 }
 export function isLoadedLanguage(lang) {
-    return plaintextLanguages.includes(lang) || (highlighter?.supports(lang) ?? false);
+    return (plaintextLanguages.includes(lang) || ignoredLanguages?.includes(lang) || highlighter?.supports(lang) || false);
 }
 export function highlight(code, lang) {
     assert(highlighter, "Tried to highlight with an uninitialized highlighter");
-    if (plaintextLanguages.includes(lang)) {
+    if (plaintextLanguages.includes(lang) || ignoredLanguages?.includes(lang)) {
         return JSX.renderElement(JSX.createElement(JSX.Fragment, null, code));
     }
     return highlighter.highlight(code, aliases.get(lang) ?? lang);

package/dist/lib/utils/options/declaration.d.ts

@@ -105,6 +105,7 @@ export interface TypeDocOptionMap {
     lightHighlightTheme: ShikiTheme;
     darkHighlightTheme: ShikiTheme;
     highlightLanguages: string[];
+    ignoredHighlightLanguages: string[];
     typePrintWidth: number;
     customCss: string;
     customJs: string;

package/dist/lib/utils/options/defaults.d.ts

@@ -13,6 +13,7 @@ export declare const modifierTags: readonly `@${string}`[];
 export declare const cascadedModifierTags: readonly `@${string}`[];
 export declare const notRenderedTags: readonly `@${string}`[];
 export declare const highlightLanguages: readonly BundledLanguage[];
+export declare const ignoredHighlightLanguages: readonly string[];
 export declare const sort: readonly string[];
 export declare const kindSortOrder: readonly EnumKeys<typeof ReflectionKind>[];
 export declare const requiredToBeDocumented: readonly EnumKeys<typeof ReflectionKind>[];

package/dist/lib/utils/options/defaults.js

@@ -61,6 +61,7 @@ export const highlightLanguages = [
     "tsx",
     "typescript",
 ];
+export const ignoredHighlightLanguages = [];
 export const sort = [
     "kind",
     "instance-first",

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

@@ -82,14 +82,6 @@ export declare class Options {
      * Clones the options, intended for use in packages mode.
      */
     copyForPackage(packageDir: string): Options;
-    /**
-     * Marks the options as readonly, enables caching when fetching options, which improves performance.
-     */
-    freeze(): void;
-    /**
-     * Checks if the options object has been frozen, preventing future changes to option values.
-     */
-    isFrozen(): boolean;
     /**
      * Take a snapshot of option values now, used in tests only.
      * @internal

package/dist/lib/utils/options/options.js

@@ -60,18 +60,6 @@ export class Options {
         }
         return options;
     }
-    /**
-     * Marks the options as readonly, enables caching when fetching options, which improves performance.
-     */
-    freeze() {
-        Object.freeze(this._values);
-    }
-    /**
-     * Checks if the options object has been frozen, preventing future changes to option values.
-     */
-    isFrozen() {
-        return Object.isFrozen(this._values);
-    }
     /**
      * Take a snapshot of option values now, used in tests only.
      * @internal
@@ -168,9 +156,6 @@ export class Options {
         return this._values[declaration.name];
     }
     setValue(name, value, configPath) {
-        if (this.isFrozen()) {
-            throw new Error(`Tried to modify an option (${name}) value after options have been frozen.`);
-        }
         const declaration = this.getDeclaration(name);
         if (!declaration) {
             const nearNames = this.getSimilarOptions(name);
@@ -234,9 +219,6 @@ export class Options {
      * Sets the compiler options that will be used to get a TS program.
      */
     setCompilerOptions(fileNames, options, projectReferences) {
-        if (this.isFrozen()) {
-            throw new Error("Tried to modify compiler options after options have been frozen.");
-        }
         // We do this here instead of in the tsconfig reader so that API consumers which
         // supply a program to `Converter.convert` instead of letting TypeDoc create one
         // can just set the compiler options, and not need to know about this mapping.

package/dist/lib/utils/options/readers/typedoc.d.ts

@@ -3,9 +3,6 @@ import type { Logger } from "../../loggers.js";
 import type { Options } from "../options.js";
 /**
  * Obtains option values from typedoc.json
- *
- * Changes need to happen here at some point. I think we should follow ESLint's new config
- * system eventually: https://eslint.org/blog/2022/08/new-config-system-part-1/
  */
 export declare class TypeDocReader implements OptionsReader {
     /**

package/dist/lib/utils/options/readers/typedoc.js

@@ -8,10 +8,9 @@ import { createRequire } from "module";
 import { pathToFileURL } from "url";
 /**
  * Obtains option values from typedoc.json
- *
- * Changes need to happen here at some point. I think we should follow ESLint's new config
- * system eventually: https://eslint.org/blog/2022/08/new-config-system-part-1/
  */
+// Changes need to happen here at some point. I think we should follow ESLint's new config
+// system eventually: https://eslint.org/blog/2022/08/new-config-system-part-1/
 export class TypeDocReader {
     /**
      * Should run before the tsconfig reader so that it can specify a tsconfig file to read.

package/dist/lib/utils/options/sources/typedoc.js

@@ -305,6 +305,12 @@ export function addTypeDocOptions(options) {
             }
         },
     });
+    options.addDeclaration({
+        name: "ignoredHighlightLanguages",
+        help: (i18n) => i18n.help_ignoredHighlightLanguages(),
+        type: ParameterType.Array,
+        defaultValue: OptionDefaults.ignoredHighlightLanguages,
+    });
     options.addDeclaration({
         name: "typePrintWidth",
         help: (i18n) => i18n.help_typePrintWidth(),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "typedoc",
   "description": "Create api documentation for TypeScript projects.",
-  "version": "0.27.5",
+  "version": "0.27.6",
   "homepage": "https://typedoc.org",
   "type": "module",
   "exports": {