TypeDoc API - v0.28.2

    Interface TypeDocOptionValues

    Describes all TypeDoc specific options as returned by Options.getValue, this is slightly more restrictive than the TypeDocOptions since it does not allow both keys and values for mapped option types, and does not allow partials of flag values. It also does not mark keys as optional.

    interface TypeDocOptionValues {
        alwaysCreateEntryPointModule: boolean;
        basePath: NormalizedPath;
        blockTags: `@${string}`[];
        cacheBust: boolean;
        cascadedModifierTags: `@${string}`[];
        categorizeByGroup: boolean;
        categoryOrder: string[];
        cleanOutputDir: boolean;
        cname: string;
        commentStyle: "jsdoc" | "block" | "line" | "all";
        compilerOptions: unknown;
        customCss: NormalizedPath;
        customFooterHtml: string;
        customFooterHtmlDisableWrapper: boolean;
        customJs: NormalizedPath;
        darkHighlightTheme: BundledTheme;
        defaultCategory: string;
        disableGit: boolean;
        disableSources: boolean;
        emit: "none" | "both" | "docs";
        entryPoints: GlobString[];
        entryPointStrategy: "expand" | "resolve" | "packages" | "merge";
        exclude: GlobString[];
        excludeCategories: string[];
        excludeExternals: boolean;
        excludeInternal: boolean;
        excludeNotDocumented: boolean;
        excludeNotDocumentedKinds: KindString[];
        excludePrivate: boolean;
        excludeProtected: boolean;
        excludeReferences: boolean;
        excludeTags: `@${string}`[];
        externalPattern: GlobString[];
        externalSymbolLinkMappings: Record<string>;
        favicon: NormalizedPath;
        githubPages: boolean;
        gitRemote: string;
        gitRevision: string;
        groupOrder: string[];
        groupReferencesByType: boolean;
        headings: { document: boolean; readme: boolean };
        help: boolean;
        hideGenerator: boolean;
        highlightLanguages: string[];
        hostedBaseUrl: string;
        html: NormalizedPath;
        ignoredHighlightLanguages: string[];
        includeHierarchySummary: boolean;
        includeVersion: boolean;
        inlineTags: `@${string}`[];
        intentionallyNotDocumented: string[];
        intentionallyNotExported: string[];
        jsDocCompatibility: Configuration.JsDocCompatibility;
        json: NormalizedPath;
        kindSortOrder: KindString[];
        lang: string;
        lightHighlightTheme: BundledTheme;
        locales: Record<string>;
        logLevel: LogLevel;
        markdownItLoader: (parser: any) => void;
        markdownItOptions: Record<string>;
        markdownLinkExternal: boolean;
        maxTypeConversionDepth: number;
        modifierTags: `@${string}`[];
        name: string;
        navigation: {
            compactFolders: boolean;
            excludeReferences: boolean;
            includeCategories: boolean;
            includeFolders: boolean;
            includeGroups: boolean;
        };
        navigationLeaves: string[];
        navigationLinks: Record<string>;
        notRenderedTags: `@${string}`[];
        options: NormalizedPath;
        out: NormalizedPath;
        outputs: Configuration.OutputSpecification[];
        packageOptions: TypeDocPackageOptions;
        packagesRequiringDocumentation: string[];
        plugin: NormalizedPathOrModule[];
        preserveLinkText: boolean;
        preserveWatchOutput: boolean;
        pretty: boolean;
        projectDocuments: GlobString[];
        readme: string;
        requiredToBeDocumented: KindString[];
        router: string;
        searchCategoryBoosts: Record<string>;
        searchGroupBoosts: Record<string>;
        searchInComments: boolean;
        searchInDocuments: boolean;
        showConfig: boolean;
        sidebarLinks: Record<string>;
        skipErrorChecking: boolean;
        sluggerConfiguration: { lowercase: boolean };
        sort: (
            | "kind"
            | "source-order"
            | "alphabetical"
            | "alphabetical-ignoring-documents"
            | "enum-value-ascending"
            | "enum-value-descending"
            | "enum-member-source-order"
            | "static-first"
            | "instance-first"
            | "visibility"
            | "required-first"
            | "external-last"
            | "documents-first"
            | "documents-last"
        )[];
        sortEntryPoints: boolean;
        sourceLinkExternal: boolean;
        sourceLinkTemplate: string;
        suppressCommentWarningsInDeclarationFiles: boolean;
        theme: string;
        titleLink: string;
        treatValidationWarningsAsErrors: boolean;
        treatWarningsAsErrors: boolean;
        tsconfig: NormalizedPath;
        typePrintWidth: number;
        useFirstParagraphOfCommentAsSummary: boolean;
        useHostedBaseUrlForAbsoluteLinks: boolean;
        useTsLinkResolution: boolean;
        validation: Configuration.ValidationOptions;
        version: boolean;
        visibilityFilters: {
            external?: boolean;
            inherited?: boolean;
            private?: boolean;
            protected?: boolean;
            [tag: `@${string}`]: boolean;
        };
        watch: boolean;
    }
    Index

    Properties

    alwaysCreateEntryPointModule basePath blockTags cacheBust cascadedModifierTags categorizeByGroup categoryOrder cleanOutputDir cname commentStyle compilerOptions customCss customFooterHtml customFooterHtmlDisableWrapper customJs darkHighlightTheme defaultCategory disableGit disableSources emit entryPoints entryPointStrategy exclude excludeCategories excludeExternals excludeInternal excludeNotDocumented excludeNotDocumentedKinds excludePrivate excludeProtected excludeReferences excludeTags externalPattern externalSymbolLinkMappings favicon githubPages gitRemote gitRevision groupOrder groupReferencesByType headings help hideGenerator highlightLanguages hostedBaseUrl html ignoredHighlightLanguages includeHierarchySummary includeVersion inlineTags intentionallyNotDocumented intentionallyNotExported jsDocCompatibility json kindSortOrder lang lightHighlightTheme locales logLevel markdownItLoader markdownItOptions markdownLinkExternal maxTypeConversionDepth modifierTags name navigation navigationLeaves navigationLinks notRenderedTags options out outputs packageOptions packagesRequiringDocumentation plugin preserveLinkText preserveWatchOutput pretty projectDocuments readme requiredToBeDocumented router searchCategoryBoosts searchGroupBoosts searchInComments searchInDocuments showConfig sidebarLinks skipErrorChecking sluggerConfiguration sort sortEntryPoints sourceLinkExternal sourceLinkTemplate suppressCommentWarningsInDeclarationFiles theme titleLink treatValidationWarningsAsErrors treatWarningsAsErrors tsconfig typePrintWidth useFirstParagraphOfCommentAsSummary useHostedBaseUrlForAbsoluteLinks useTsLinkResolution validation version visibilityFilters watch

    Properties

    alwaysCreateEntryPointModule: boolean
    basePath: NormalizedPath
    blockTags: `@${string}`[]
    cacheBust: boolean
    cascadedModifierTags: `@${string}`[]
    categorizeByGroup: boolean
    categoryOrder: string[]
    cleanOutputDir: boolean
    cname: string
    commentStyle: "jsdoc" | "block" | "line" | "all"
    compilerOptions: unknown
    customCss: NormalizedPath
    customFooterHtml: string
    customFooterHtmlDisableWrapper: boolean
    customJs: NormalizedPath
    darkHighlightTheme: BundledTheme
    defaultCategory: string
    disableGit: boolean
    disableSources: boolean
    emit: "none" | "both" | "docs"
    entryPoints: GlobString[]
    entryPointStrategy: "expand" | "resolve" | "packages" | "merge"
    exclude: GlobString[]
    excludeCategories: string[]
    excludeExternals: boolean
    excludeInternal: boolean
    excludeNotDocumented: boolean
    excludeNotDocumentedKinds: KindString[]
    excludePrivate: boolean
    excludeProtected: boolean
    excludeReferences: boolean
    excludeTags: `@${string}`[]
    externalPattern: GlobString[]
    externalSymbolLinkMappings: Record<string>
    githubPages: boolean
    gitRemote: string
    gitRevision: string
    groupOrder: string[]
    groupReferencesByType: boolean
    headings: { document: boolean; readme: boolean }
    help: boolean
    hideGenerator: boolean
    highlightLanguages: string[]
    hostedBaseUrl: string
    ignoredHighlightLanguages: string[]
    includeHierarchySummary: boolean
    includeVersion: boolean
    inlineTags: `@${string}`[]
    intentionallyNotDocumented: string[]
    intentionallyNotExported: string[]
    jsDocCompatibility: Configuration.JsDocCompatibility
    kindSortOrder: KindString[]
    lang: string
    lightHighlightTheme: BundledTheme
    locales: Record<string>
    logLevel: LogLevel
    markdownItLoader: (parser: any) => void

    Will be called when TypeDoc is setting up the markdown parser to use to render markdown. Can be used to add markdown-it plugins to the parser with code like this:

    // typedoc.config.mjs
    import iterator from "markdown-it-for-inline";
    export default {
    /** @param {MarkdownIt} parser */
    markdownItLoader(parser) {
    parser.use(iterator, "foo_replace", "text", function(tokens, idx) {
    tokens[idx].content = tokens[idx].content.replace(/foo/g, 'bar');
    });
    }
    }

    Note: Unfortunately, markdown-it doesn't ship its own types, so parser isn't strictly typed here.

    markdownItOptions: Record<string>
    markdownLinkExternal: boolean
    maxTypeConversionDepth: number
    modifierTags: `@${string}`[]
    name: string
    navigation: {
        compactFolders: boolean;
        excludeReferences: boolean;
        includeCategories: boolean;
        includeFolders: boolean;
        includeGroups: boolean;
    }
    navigationLeaves: string[]
    navigationLinks: Record<string>
    notRenderedTags: `@${string}`[]
    packageOptions: TypeDocPackageOptions
    packagesRequiringDocumentation: string[]
    preserveLinkText: boolean
    preserveWatchOutput: boolean
    pretty: boolean
    projectDocuments: GlobString[]
    readme: string
    requiredToBeDocumented: KindString[]
    router: string
    searchCategoryBoosts: Record<string>
    searchGroupBoosts: Record<string>
    searchInComments: boolean
    searchInDocuments: boolean
    showConfig: boolean
    sidebarLinks: Record<string>
    skipErrorChecking: boolean
    sluggerConfiguration: { lowercase: boolean }
    sort: (
        | "kind"
        | "source-order"
        | "alphabetical"
        | "alphabetical-ignoring-documents"
        | "enum-value-ascending"
        | "enum-value-descending"
        | "enum-member-source-order"
        | "static-first"
        | "instance-first"
        | "visibility"
        | "required-first"
        | "external-last"
        | "documents-first"
        | "documents-last"
    )[]
    sortEntryPoints: boolean
    sourceLinkExternal: boolean
    sourceLinkTemplate: string
    suppressCommentWarningsInDeclarationFiles: boolean
    theme: string
    titleLink: string
    treatValidationWarningsAsErrors: boolean
    treatWarningsAsErrors: boolean
    tsconfig: NormalizedPath
    typePrintWidth: number
    useFirstParagraphOfCommentAsSummary: boolean
    useHostedBaseUrlForAbsoluteLinks: boolean
    useTsLinkResolution: boolean
    version: boolean
    visibilityFilters: {
        external?: boolean;
        inherited?: boolean;
        private?: boolean;
        protected?: boolean;
        [tag: `@${string}`]: boolean;
    }
    watch: boolean
    MMNEPVFCICPMFPCPTTAAATR