typedoc 0.26.0-beta.1 → 0.26.0-beta.3

package/dist/lib/models/types.js

@@ -30,6 +30,7 @@ const tsutils_1 = require("../utils/tsutils");
 const ReflectionSymbolId_1 = require("./reflections/ReflectionSymbolId");
 const fs_1 = require("../utils/fs");
 const kind_1 = require("./reflections/kind");
+const comments_1 = require("./comments");
 /**
  * Base class of all type definitions.
  * @category Types
@@ -748,7 +749,7 @@ class ReferenceType extends Type {
     static createSymbolReference(symbol, context, name) {
         const ref = new ReferenceType(name ?? symbol.name, new ReflectionSymbolId_1.ReflectionSymbolId(symbol), context.project, (0, tsutils_1.getQualifiedName)(symbol, name ?? symbol.name));
         ref.refersToTypeParameter = !!(symbol.flags & ts.SymbolFlags.TypeParameter);
-        const symbolPath = symbol?.declarations?.[0]
+        const symbolPath = symbol.declarations?.[0]
             ?.getSourceFile()
             .fileName.replace(/\\/g, "/");
         if (!symbolPath)
@@ -826,7 +827,7 @@ class ReferenceType extends Type {
                     this._target = target.id;
                 }
                 else {
-                    de.logger.warn(de.application.i18n.serialized_project_referenced_0_not_part_of_project(obj.target.toString()));
+                    de.logger.warn(de.application.i18n.serialized_project_referenced_0_not_part_of_project(JSON.stringify(obj.target)));
                 }
             });
         }
@@ -1092,7 +1093,6 @@ class UnionType extends Type {
         super();
         this.types = types;
         this.type = "union";
-        this.normalize();
     }
     getTypeString() {
         return this.types
@@ -1127,29 +1127,16 @@ class UnionType extends Type {
         };
         return map[context];
     }
-    normalize() {
-        let trueIndex = -1;
-        let falseIndex = -1;
-        for (let i = 0; i < this.types.length && (trueIndex === -1 || falseIndex === -1); i++) {
-            const t = this.types[i];
-            if (t instanceof LiteralType) {
-                if (t.value === true) {
-                    trueIndex = i;
-                }
-                if (t.value === false) {
-                    falseIndex = i;
-                }
-            }
-        }
-        if (trueIndex !== -1 && falseIndex !== -1) {
-            this.types.splice(Math.max(trueIndex, falseIndex), 1);
-            this.types.splice(Math.min(trueIndex, falseIndex), 1, new IntrinsicType("boolean"));
+    fromObject(de, obj) {
+        if (obj.elementSummaries) {
+            this.elementSummaries = obj.elementSummaries.map((parts) => comments_1.Comment.deserializeDisplayParts(de, parts));
         }
     }
     toObject(serializer) {
         return {
             type: this.type,
             types: this.types.map((t) => serializer.toObject(t)),
+            elementSummaries: this.elementSummaries?.map((parts) => comments_1.Comment.serializeDisplayParts(serializer, parts)),
         };
     }
 }

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

@@ -28,6 +28,8 @@ export declare abstract class ContextAwareRendererComponent extends RendererComp
      * Regular expression to test if a string looks like an external url.
      */
     protected urlPrefix: RegExp;
+    private get hostedBaseUrl();
+    private accessor useHostedBaseUrlForAbsoluteLinks;
     /**
      * Create a new ContextAwareRendererPlugin instance.
      *

package/dist/lib/output/components.js

@@ -15,6 +15,40 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
 var __importStar = (this && this.__importStar) || function (mod) {
     if (mod && mod.__esModule) return mod;
     var result = {};
@@ -22,82 +56,121 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ContextAwareRendererComponent = exports.RendererComponent = exports.Component = void 0;
 const Path = __importStar(require("path"));
 const component_1 = require("../utils/component");
 Object.defineProperty(exports, "Component", { enumerable: true, get: function () { return component_1.Component; } });
 const events_1 = require("./events");
+const utils_1 = require("../utils");
 class RendererComponent extends component_1.AbstractComponent {
 }
 exports.RendererComponent = RendererComponent;
 /**
  * A plugin for the renderer that reads the current render context.
  */
-class ContextAwareRendererComponent extends RendererComponent {
-    constructor() {
-        super(...arguments);
-        /**
-         * The url of the document that is being currently generated.
-         * Set when a page begins rendering.
-         *
-         * Defaulted to '.' so that tests don't have to set up events.
-         */
-        this.location = ".";
-        /**
-         * Regular expression to test if a string looks like an external url.
-         */
-        this.urlPrefix = /^(http|ftp)s?:\/\//;
-        this.absoluteToRelativePathMap = new Map();
-    }
-    /**
-     * Create a new ContextAwareRendererPlugin instance.
-     *
-     * @param renderer  The renderer this plugin should be attached to.
-     */
-    initialize() {
-        this.listenTo(this.owner, {
-            [events_1.RendererEvent.BEGIN]: this.onBeginRenderer,
-            [events_1.PageEvent.BEGIN]: this.onBeginPage,
-            [events_1.RendererEvent.END]: () => this.absoluteToRelativePathMap.clear(),
-        });
-    }
-    /**
-     * Transform the given absolute path into a relative path.
-     *
-     * @param absolute  The absolute path to transform.
-     * @returns A path relative to the document currently processed.
-     */
-    getRelativeUrl(absolute) {
-        if (this.urlPrefix.test(absolute)) {
-            return absolute;
-        }
-        else {
-            const key = `${this.location}:${absolute}`;
-            let path = this.absoluteToRelativePathMap.get(key);
-            if (path)
-                return path;
-            path = Path.posix.relative(this.location, absolute) || ".";
-            this.absoluteToRelativePathMap.set(key, path);
-            return path;
-        }
-    }
-    /**
-     * Triggered before the renderer starts rendering a project.
-     *
-     * @param event  An event object describing the current render operation.
-     */
-    onBeginRenderer(event) {
-        this.project = event.project;
-    }
-    /**
-     * Triggered before a document will be rendered.
-     *
-     * @param page  An event object describing the current render operation.
-     */
-    onBeginPage(page) {
-        this.location = Path.posix.dirname(page.url);
-        this.page = page;
-    }
-}
+let ContextAwareRendererComponent = (() => {
+    var _a, _ContextAwareRendererComponent_useHostedBaseUrlForAbsoluteLinks_accessor_storage;
+    let _classSuper = RendererComponent;
+    let _useHostedBaseUrlForAbsoluteLinks_decorators;
+    let _useHostedBaseUrlForAbsoluteLinks_initializers = [];
+    let _useHostedBaseUrlForAbsoluteLinks_extraInitializers = [];
+    return _a = class ContextAwareRendererComponent extends _classSuper {
+            constructor() {
+                super(...arguments);
+                /**
+                 * The url of the document that is being currently generated.
+                 * Set when a page begins rendering.
+                 *
+                 * Defaulted to '.' so that tests don't have to set up events.
+                 */
+                this.location = ".";
+                /**
+                 * Regular expression to test if a string looks like an external url.
+                 */
+                this.urlPrefix = /^(http|ftp)s?:\/\//;
+                _ContextAwareRendererComponent_useHostedBaseUrlForAbsoluteLinks_accessor_storage.set(this, __runInitializers(this, _useHostedBaseUrlForAbsoluteLinks_initializers, void 0));
+                this.absoluteToRelativePathMap = (__runInitializers(this, _useHostedBaseUrlForAbsoluteLinks_extraInitializers), new Map());
+            }
+            get hostedBaseUrl() {
+                const url = this.application.options.getValue("hostedBaseUrl");
+                return !url || url.endsWith("/") ? url : url + "/";
+            }
+            get useHostedBaseUrlForAbsoluteLinks() { return __classPrivateFieldGet(this, _ContextAwareRendererComponent_useHostedBaseUrlForAbsoluteLinks_accessor_storage, "f"); }
+            set useHostedBaseUrlForAbsoluteLinks(value) { __classPrivateFieldSet(this, _ContextAwareRendererComponent_useHostedBaseUrlForAbsoluteLinks_accessor_storage, value, "f"); }
+            /**
+             * Create a new ContextAwareRendererPlugin instance.
+             *
+             * @param renderer  The renderer this plugin should be attached to.
+             */
+            initialize() {
+                this.listenTo(this.owner, {
+                    [events_1.RendererEvent.BEGIN]: this.onBeginRenderer,
+                    [events_1.PageEvent.BEGIN]: this.onBeginPage,
+                    [events_1.RendererEvent.END]: () => this.absoluteToRelativePathMap.clear(),
+                });
+            }
+            /**
+             * Transform the given absolute path into a relative path.
+             *
+             * @param absolute  The absolute path to transform.
+             * @returns A path relative to the document currently processed.
+             */
+            getRelativeUrl(absolute) {
+                if (this.urlPrefix.test(absolute)) {
+                    return absolute;
+                }
+                else {
+                    const key = `${this.location}:${absolute}`;
+                    let path = this.absoluteToRelativePathMap.get(key);
+                    if (path)
+                        return path;
+                    if (this.useHostedBaseUrlForAbsoluteLinks) {
+                        path = new URL(absolute, this.hostedBaseUrl).toString();
+                    }
+                    else {
+                        path = Path.posix.relative(this.location, absolute) || ".";
+                    }
+                    this.absoluteToRelativePathMap.set(key, path);
+                    return path;
+                }
+            }
+            /**
+             * Triggered before the renderer starts rendering a project.
+             *
+             * @param event  An event object describing the current render operation.
+             */
+            onBeginRenderer(event) {
+                this.project = event.project;
+            }
+            /**
+             * Triggered before a document will be rendered.
+             *
+             * @param page  An event object describing the current render operation.
+             */
+            onBeginPage(page) {
+                this.location = Path.posix.dirname(page.url);
+                this.page = page;
+            }
+        },
+        _ContextAwareRendererComponent_useHostedBaseUrlForAbsoluteLinks_accessor_storage = new WeakMap(),
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _useHostedBaseUrlForAbsoluteLinks_decorators = [(0, utils_1.Option)("useHostedBaseUrlForAbsoluteLinks")];
+            __esDecorate(_a, null, _useHostedBaseUrlForAbsoluteLinks_decorators, { kind: "accessor", name: "useHostedBaseUrlForAbsoluteLinks", static: false, private: false, access: { has: obj => "useHostedBaseUrlForAbsoluteLinks" in obj, get: obj => obj.useHostedBaseUrlForAbsoluteLinks, set: (obj, value) => { obj.useHostedBaseUrlForAbsoluteLinks = value; } }, metadata: _metadata }, _useHostedBaseUrlForAbsoluteLinks_initializers, _useHostedBaseUrlForAbsoluteLinks_extraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        })(),
+        _a;
+})();
 exports.ContextAwareRendererComponent = ContextAwareRendererComponent;

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

@@ -6,4 +6,8 @@ export declare class UrlMapping<Model = any> {
     template: RenderTemplate<PageEvent<Model>>;
     constructor(url: string, model: Model, template: RenderTemplate<PageEvent<Model>>);
 }
+/**
+ * @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;

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

@@ -107,6 +107,11 @@ let AssetsPlugin = (() => {
                 const dest = (0, path_1.join)(event.outputDirectory, "assets");
                 (0, fs_1.copySync)(src, dest);
                 (0, fs_1.writeFileSync)((0, path_1.join)(dest, "highlight.css"), (0, highlighter_1.getStyles)());
+                const media = (0, path_1.join)(event.outputDirectory, "media");
+                const toCopy = event.project.files.getNameToAbsoluteMap();
+                for (const [fileName, absolute] of toCopy.entries()) {
+                    (0, fs_1.copySync)(absolute, (0, path_1.join)(media, fileName));
+                }
             }
         }
         constructor() {

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

@@ -121,7 +121,7 @@ let JavascriptIndexPlugin = (() => {
             if (!(this.owner.theme instanceof DefaultTheme_1.DefaultTheme)) {
                 return;
             }
-            if (event.isDefaultPrevented) {
+            if (event.isDefaultPrevented()) {
                 return;
             }
             this.owner.preRenderAsyncJobs.push((event) => this.buildSearchIndex(event));
@@ -138,7 +138,7 @@ let JavascriptIndexPlugin = (() => {
             });
             const indexEvent = new events_1.IndexEvent(events_1.IndexEvent.PREPARE_INDEX, initialSearchResults);
             this.owner.trigger(indexEvent);
-            if (indexEvent.isDefaultPrevented) {
+            if (indexEvent.isDefaultPrevented()) {
                 return;
             }
             const builder = new lunr_1.Builder();

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

@@ -84,7 +84,7 @@ let NavigationPlugin = (() => {
             if (!(this.owner.theme instanceof DefaultTheme_1.DefaultTheme)) {
                 return;
             }
-            if (event.isDefaultPrevented) {
+            if (event.isDefaultPrevented()) {
                 return;
             }
             this.owner.preRenderAsyncJobs.push((event) => this.buildNavigationIndex(event));

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

@@ -67,7 +67,7 @@ let SitemapPlugin = (() => {
             if (!(this.owner.theme instanceof DefaultTheme_1.DefaultTheme)) {
                 return;
             }
-            if (event.isDefaultPrevented || !this.hostedBaseUrl) {
+            if (event.isDefaultPrevented() || !this.hostedBaseUrl) {
                 return;
             }
             this.owner.hooks.on("head.begin", (context) => {

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

@@ -5,7 +5,7 @@ import type { ProjectReflection } from "../models/reflections/project";
 import { RendererComponent } from "./components";
 import { ChildableComponent } from "../utils/component";
 import { EventHooks } from "../utils";
-import type { BundledTheme as ShikiTheme } from "shiki" with { "resolution-mode": "import" };
+import { type Comment, Reflection } from "../models";
 import type { JsxElement } from "../utils/jsx.elements";
 import type { DefaultThemeRenderContext } from "./themes/default/DefaultThemeRenderContext";
 /**
@@ -61,6 +61,21 @@ export interface RendererHooks {
      * Applied immediately after the "Generated by TypeDoc" link in the footer.
      */
     "footer.end": [DefaultThemeRenderContext];
+    /**
+     * Applied immediately before a comment's tags are rendered.
+     *
+     * This may be used to set {@link CommentTag.skipRendering} on any tags which
+     * should not be rendered.
+     */
+    "comment.beforeTags": [DefaultThemeRenderContext, Comment, Reflection];
+    /**
+     * Applied immediately after a comment's tags are rendered.
+     *
+     * This may be used to set {@link CommentTag.skipRendering} on any tags which
+     * should not be rendered as this hook is called before the tags are actually
+     * rendered.
+     */
+    "comment.afterTags": [DefaultThemeRenderContext, Comment, Reflection];
 }
 /**
  * The renderer processes a {@link ProjectReflection} using a {@link Theme} instance and writes
@@ -142,21 +157,16 @@ export declare class Renderer extends ChildableComponent<Application, RendererCo
      */
     hooks: EventHooks<RendererHooks, JsxElement>;
     /** @internal */
-    accessor themeName: string;
-    /** @internal */
-    accessor cleanOutputDir: boolean;
-    /** @internal */
-    accessor cname: string;
-    /** @internal */
-    accessor githubPages: boolean;
+    private accessor themeName;
+    private accessor cleanOutputDir;
+    private accessor cname;
+    private accessor githubPages;
     /** @internal */
     accessor cacheBust: boolean;
-    /** @internal */
-    accessor lightTheme: ShikiTheme;
-    /** @internal */
-    accessor darkTheme: ShikiTheme;
-    /** @internal */
-    accessor pretty: boolean;
+    private accessor lightTheme;
+    private accessor darkTheme;
+    private accessor highlightLanguages;
+    private accessor pretty;
     renderStartTime: number;
     /**
      * Define a new theme that can be used to render output.

package/dist/lib/output/renderer.js

@@ -128,7 +128,7 @@ const jsx_1 = require("../utils/jsx");
  * @document ../../../internal-docs/custom-themes.md
  */
 let Renderer = (() => {
-    var _Renderer_themeName_accessor_storage, _Renderer_cleanOutputDir_accessor_storage, _Renderer_cname_accessor_storage, _Renderer_githubPages_accessor_storage, _Renderer_cacheBust_accessor_storage, _Renderer_lightTheme_accessor_storage, _Renderer_darkTheme_accessor_storage, _Renderer_pretty_accessor_storage;
+    var _Renderer_themeName_accessor_storage, _Renderer_cleanOutputDir_accessor_storage, _Renderer_cname_accessor_storage, _Renderer_githubPages_accessor_storage, _Renderer_cacheBust_accessor_storage, _Renderer_lightTheme_accessor_storage, _Renderer_darkTheme_accessor_storage, _Renderer_highlightLanguages_accessor_storage, _Renderer_pretty_accessor_storage;
     let _classDecorators = [(0, component_1.Component)({ name: "renderer", internal: true, childClass: components_1.RendererComponent })];
     let _classDescriptor;
     let _classExtraInitializers = [];
@@ -155,6 +155,9 @@ let Renderer = (() => {
     let _darkTheme_decorators;
     let _darkTheme_initializers = [];
     let _darkTheme_extraInitializers = [];
+    let _highlightLanguages_decorators;
+    let _highlightLanguages_initializers = [];
+    let _highlightLanguages_extraInitializers = [];
     let _pretty_decorators;
     let _pretty_initializers = [];
     let _pretty_extraInitializers = [];
@@ -200,31 +203,28 @@ let Renderer = (() => {
             _Renderer_cacheBust_accessor_storage.set(this, (__runInitializers(this, _githubPages_extraInitializers), __runInitializers(this, _cacheBust_initializers, void 0)));
             _Renderer_lightTheme_accessor_storage.set(this, (__runInitializers(this, _cacheBust_extraInitializers), __runInitializers(this, _lightTheme_initializers, void 0)));
             _Renderer_darkTheme_accessor_storage.set(this, (__runInitializers(this, _lightTheme_extraInitializers), __runInitializers(this, _darkTheme_initializers, void 0)));
-            _Renderer_pretty_accessor_storage.set(this, (__runInitializers(this, _darkTheme_extraInitializers), __runInitializers(this, _pretty_initializers, void 0)));
+            _Renderer_highlightLanguages_accessor_storage.set(this, (__runInitializers(this, _darkTheme_extraInitializers), __runInitializers(this, _highlightLanguages_initializers, void 0)));
+            _Renderer_pretty_accessor_storage.set(this, (__runInitializers(this, _highlightLanguages_extraInitializers), __runInitializers(this, _pretty_initializers, void 0)));
             this.renderStartTime = (__runInitializers(this, _pretty_extraInitializers), -1);
         }
         /** @internal */
         get themeName() { return __classPrivateFieldGet(this, _Renderer_themeName_accessor_storage, "f"); }
         set themeName(value) { __classPrivateFieldSet(this, _Renderer_themeName_accessor_storage, value, "f"); }
-        /** @internal */
         get cleanOutputDir() { return __classPrivateFieldGet(this, _Renderer_cleanOutputDir_accessor_storage, "f"); }
         set cleanOutputDir(value) { __classPrivateFieldSet(this, _Renderer_cleanOutputDir_accessor_storage, value, "f"); }
-        /** @internal */
         get cname() { return __classPrivateFieldGet(this, _Renderer_cname_accessor_storage, "f"); }
         set cname(value) { __classPrivateFieldSet(this, _Renderer_cname_accessor_storage, value, "f"); }
-        /** @internal */
         get githubPages() { return __classPrivateFieldGet(this, _Renderer_githubPages_accessor_storage, "f"); }
         set githubPages(value) { __classPrivateFieldSet(this, _Renderer_githubPages_accessor_storage, value, "f"); }
         /** @internal */
         get cacheBust() { return __classPrivateFieldGet(this, _Renderer_cacheBust_accessor_storage, "f"); }
         set cacheBust(value) { __classPrivateFieldSet(this, _Renderer_cacheBust_accessor_storage, value, "f"); }
-        /** @internal */
         get lightTheme() { return __classPrivateFieldGet(this, _Renderer_lightTheme_accessor_storage, "f"); }
         set lightTheme(value) { __classPrivateFieldSet(this, _Renderer_lightTheme_accessor_storage, value, "f"); }
-        /** @internal */
         get darkTheme() { return __classPrivateFieldGet(this, _Renderer_darkTheme_accessor_storage, "f"); }
         set darkTheme(value) { __classPrivateFieldSet(this, _Renderer_darkTheme_accessor_storage, value, "f"); }
-        /** @internal */
+        get highlightLanguages() { return __classPrivateFieldGet(this, _Renderer_highlightLanguages_accessor_storage, "f"); }
+        set highlightLanguages(value) { __classPrivateFieldSet(this, _Renderer_highlightLanguages_accessor_storage, value, "f"); }
         get pretty() { return __classPrivateFieldGet(this, _Renderer_pretty_accessor_storage, "f"); }
         set pretty(value) { __classPrivateFieldSet(this, _Renderer_pretty_accessor_storage, value, "f"); }
         /**
@@ -258,7 +258,7 @@ let Renderer = (() => {
             output.urls = this.theme.getUrls(project);
             this.trigger(output);
             await this.runPreRenderJobs(output);
-            if (!output.isDefaultPrevented) {
+            if (!output.isDefaultPrevented()) {
                 this.application.logger.verbose(`There are ${output.urls.length} pages to write.`);
                 output.urls.forEach((mapping) => {
                     this.renderDocument(...output.createPageEvent(mapping));
@@ -279,7 +279,9 @@ let Renderer = (() => {
             this.application.logger.verbose(`Pre render async jobs took ${Date.now() - start}ms`);
         }
         async loadHighlighter() {
-            await (0, highlighter_1.loadHighlighter)(this.lightTheme, this.darkTheme);
+            await (0, highlighter_1.loadHighlighter)(this.lightTheme, this.darkTheme, 
+            // Checked in option validation
+            this.highlightLanguages);
         }
         /**
          * Render a single page.
@@ -290,7 +292,7 @@ let Renderer = (() => {
         renderDocument(template, page) {
             const momento = this.hooks.saveMomento();
             this.trigger(events_1.PageEvent.BEGIN, page);
-            if (page.isDefaultPrevented) {
+            if (page.isDefaultPrevented()) {
                 this.hooks.restoreMomento(momento);
                 return false;
             }
@@ -302,7 +304,7 @@ let Renderer = (() => {
             }
             this.trigger(events_1.PageEvent.END, page);
             this.hooks.restoreMomento(momento);
-            if (page.isDefaultPrevented) {
+            if (page.isDefaultPrevented()) {
                 return false;
             }
             try {
@@ -385,6 +387,7 @@ let Renderer = (() => {
     _Renderer_cacheBust_accessor_storage = new WeakMap();
     _Renderer_lightTheme_accessor_storage = new WeakMap();
     _Renderer_darkTheme_accessor_storage = new WeakMap();
+    _Renderer_highlightLanguages_accessor_storage = new WeakMap();
     _Renderer_pretty_accessor_storage = new WeakMap();
     __setFunctionName(_classThis, "Renderer");
     (() => {
@@ -396,6 +399,7 @@ let Renderer = (() => {
         _cacheBust_decorators = [(0, utils_1.Option)("cacheBust")];
         _lightTheme_decorators = [(0, utils_1.Option)("lightHighlightTheme")];
         _darkTheme_decorators = [(0, utils_1.Option)("darkHighlightTheme")];
+        _highlightLanguages_decorators = [(0, utils_1.Option)("highlightLanguages")];
         _pretty_decorators = [(0, utils_1.Option)("pretty")];
         __esDecorate(_classThis, 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(_classThis, 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);
@@ -404,6 +408,7 @@ let Renderer = (() => {
         __esDecorate(_classThis, 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(_classThis, 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(_classThis, 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(_classThis, 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(_classThis, 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);
         __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
         Renderer = _classThis = _classDescriptor.value;

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

@@ -1,4 +1,3 @@
-import type { Renderer } from "./renderer";
 import type { ProjectReflection } from "../models/reflections/project";
 import type { RenderTemplate, UrlMapping } from "./models/UrlMapping";
 import { RendererComponent } from "./components";
@@ -13,12 +12,6 @@ import type { Reflection } from "../models";
  * {@link Renderer} to control and manipulate the output process.
  */
 export declare abstract class Theme extends RendererComponent {
-    /**
-     * Create a new BaseTheme instance.
-     *
-     * @param renderer  The renderer this theme is attached to.
-     */
-    constructor(renderer: Renderer);
     /**
      * Map the models of the given project to the desired output files.
      * It is assumed that with the project structure:

package/dist/lib/output/theme.js

@@ -56,14 +56,6 @@ let Theme = (() => {
     let _classThis;
     let _classSuper = components_1.RendererComponent;
     var Theme = _classThis = class extends _classSuper {
-        /**
-         * Create a new BaseTheme instance.
-         *
-         * @param renderer  The renderer this theme is attached to.
-         */
-        constructor(renderer) {
-            super(renderer);
-        }
     };
     __setFunctionName(_classThis, "Theme");
     (() => {

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

@@ -37,6 +37,7 @@ export declare class MarkedPlugin extends ContextAwareRendererComponent {
      * @returns The resulting html string.
      */
     parseMarkdown(input: string | readonly CommentDisplayPart[], page: PageEvent<any>, context: DefaultThemeRenderContext): string;
+    private displayPartsToMarkdown;
     /**
      * Triggered before the renderer starts rendering a project.
      *