typedoc-plugin-markdown/dist/types/markdown-renderer.d.ts

import { MarkdownPageEvent, MarkdownRendererEvent } from '../events/index.js';
import { MarkdownTheme } from '../theme/index.js';
import { EventHooks, Options, Renderer } from 'typedoc';
import { MarkdownRendererHooks } from './markdown-renderer-hooks.js';
/**
 * The MarkdownRenderer extends TypeDoc's {@link typedoc!Renderer Renderer} instance with custom hooks and async jobs.
 */
export interface MarkdownRenderer extends Renderer {
    /**
     * @param event - Triggered before or after a document will be rendered.
     * @param callback - Receives the {@link MarkdownPageEvent} object as an argument.
     *
     * @example
     *
     * ```ts
     * app.renderer.on(MarkdownPageEvent.BEGIN, (renderer) => {});
     * ```
     */
    on(event: typeof MarkdownPageEvent.BEGIN | typeof MarkdownPageEvent.END, callback: (page: MarkdownPageEvent) => void): void;
    /**
     * @param event - Triggered before or after rendering the project.
     * @param callback - Receives the {@link MarkdownRendererEvent} object as an argument.
     *
     * @example
     *
     * ```ts
     * app.renderer.on(MarkdownRendererEvent.BEGIN, (renderer) => {});
     * ```
     */
    on(event: typeof MarkdownRendererEvent.BEGIN | typeof MarkdownRendererEvent.END, callback: (page: MarkdownRendererEvent) => void): void;
    /**
     * Define a new theme that can be used to render output.
     *
     * @param name - The name of the theme.
     * @param theme - The theme class to use.
     */
    defineTheme: (name: string, theme: new (renderer: Renderer) => MarkdownTheme) => void;
    markdownHooks: EventHooks<MarkdownRendererHooks, string>;
    /**
     * A list of async jobs which must be completed before rendering output.
     *
     * Note: This array is cleared after calling the contained functions on each call.
     */
    preRenderAsyncJobs: Array<(output: MarkdownRendererEvent) => Promise<void>>;
    /**
     * A list of async jobs which must be completed after rendering output files but before generation is considered successful.
     * These functions will be called after all documents have been written to the filesystem.
     *
     * Note: This array is cleared after calling the contained functions on each call.
     */
    postRenderAsyncJobs: Array<(output: MarkdownRendererEvent) => Promise<void>>;
    /** @internal */
    packagesMeta: Record<string, {
        description: string;
        options: Options;
    }>;
}