export interface ParsedFile {
    filename: string;
    extension: string;
    src: string;
    blocks: Array<{ global: any; local: any }>;
}

export interface DocOptions {
    excludeFilters?: string[] | undefined;
    includeFilters?: string[] | undefined;
    src?: string | undefined;
    dest?: string | undefined;
    template?: string | undefined;
    templateSingleFile?: string | undefined;
    config?: string | undefined;
    apiprivate?: boolean | undefined;
    verbose?: boolean | undefined;
    single?: boolean | undefined;
    debug?: boolean | undefined;
    colorize?: boolean | undefined;
    filters?: Record<string, string> | {
        [keys: string]: {
            postFilter: (parsedFiles: ParsedFile[], parsedFilenames: string[]) => void;
        };
    } | undefined;
    languages?: Record<string, string> | {
        [language: string]: {
            docBlocksRegExp: RegExp;
            inlineRegExp: RegExp;
        };
    } | undefined;
    parsers?: Record<string, string> | {
        parse: (content: string, source: string, messages: string) => {
            name: string;
            title: string;
            description: string;
        };
        path: string;
        getGroup?: (() => string) | undefined;
        markdownFields?: string[] | undefined;
        markdownRemovePTags?: string[] | undefined;
    } | undefined;
    workers?: Record<string, string> | {
        [keys: string]: any;
    } | undefined;
    silent?: boolean | undefined;
    dryRun?: boolean | undefined;
    markdown?: boolean | undefined;
    lineEnding?: string | undefined;
    encoding?: string | undefined;
    copyDefinitions?: boolean | undefined;
    filterBy?: string | string[] | undefined;
}

export function createDoc(
    options: DocOptions,
): boolean | { data: Array<Record<string, any>>; project: Record<string, any> };