/**
 * Options for the convert function.
 */
interface ConvertOptions {
    /** Directory where output files are written. Default: input file directory */
    outputDir?: string;
    /** Password for encrypted PDF files */
    password?: string;
    /** Output formats (comma-separated). Values: json, text, html, pdf, markdown, markdown-with-html, markdown-with-images. Default: json */
    format?: string | string[];
    /** Suppress console logging output */
    quiet?: boolean;
    /** Disable content safety filters. Values: all, hidden-text, off-page, tiny, hidden-ocg */
    contentSafetyOff?: string | string[];
    /** Enable sensitive data sanitization. Replaces emails, phone numbers, IPs, credit cards, and URLs with placeholders */
    sanitize?: boolean;
    /** Preserve original line breaks in extracted text */
    keepLineBreaks?: boolean;
    /** Replacement character for invalid/unrecognized characters. Default: space */
    replaceInvalidChars?: string;
    /** Use PDF structure tree (tagged PDF) for reading order and semantic structure */
    useStructTree?: boolean;
    /** Table detection method. Values: default (border-based), cluster (border + cluster). Default: default */
    tableMethod?: string;
    /** Reading order algorithm. Values: off, xycut. Default: xycut */
    readingOrder?: string;
    /** Separator between pages in Markdown output. Use %page-number% for page numbers. Default: none */
    markdownPageSeparator?: string;
    /** Separator between pages in text output. Use %page-number% for page numbers. Default: none */
    textPageSeparator?: string;
    /** Separator between pages in HTML output. Use %page-number% for page numbers. Default: none */
    htmlPageSeparator?: string;
    /** Image output mode. Values: off (no images), embedded (Base64 data URIs), external (file references). Default: external */
    imageOutput?: string;
    /** Output format for extracted images. Values: png, jpeg. Default: png */
    imageFormat?: string;
    /** Directory for extracted images */
    imageDir?: string;
    /** Pages to extract (e.g., "1,3,5-7"). Default: all pages */
    pages?: string;
    /** Include page headers and footers in output */
    includeHeaderFooter?: boolean;
    /** Hybrid backend for AI processing. Values: off (default), docling-fast */
    hybrid?: string;
    /** Hybrid triage mode. Values: auto (default, dynamic triage), full (skip triage, all pages to backend) */
    hybridMode?: string;
    /** Hybrid backend server URL (overrides default) */
    hybridUrl?: string;
    /** Hybrid backend request timeout in milliseconds. Default: 30000 */
    hybridTimeout?: string;
    /** Opt in to Java fallback on hybrid backend error (default: disabled) */
    hybridFallback?: boolean;
}
/**
 * Build CLI arguments array from ConvertOptions.
 */
declare function buildArgs(options: ConvertOptions): string[];

declare function convert(inputPaths: string | string[], options?: ConvertOptions): Promise<string>;
/**
 * @deprecated Use `convert()` and `ConvertOptions` instead. This function will be removed in a future version.
 */
interface RunOptions {
    outputFolder?: string;
    password?: string;
    replaceInvalidChars?: string;
    generateMarkdown?: boolean;
    generateHtml?: boolean;
    generateAnnotatedPdf?: boolean;
    keepLineBreaks?: boolean;
    contentSafetyOff?: string;
    htmlInMarkdown?: boolean;
    addImageToMarkdown?: boolean;
    noJson?: boolean;
    debug?: boolean;
    useStructTree?: boolean;
}
/**
 * @deprecated Use `convert()` instead. This function will be removed in a future version.
 */
declare function run(inputPath: string, options?: RunOptions): Promise<string>;

export { type ConvertOptions, type RunOptions, buildArgs, convert, run };