import { type CitationRef } from '../citations/citation-links.js';
import { type VaultHashParams } from './vault-links.js';
export type DetectedFile = {
    type: 'vault' | 'url';
    reference: string;
    name: string;
    mimeType: string;
    hashParams?: VaultHashParams;
};
export type ContentSegment = {
    type: 'text';
    content: string;
} | {
    type: 'file';
    file: DetectedFile;
} | {
    type: 'citation';
    citation: CitationRef;
};
export type ParseContentOptions = {
    /** Detect bare `cite://` tokens as citation segments. Off by default: only hosts that configured citations opt in. */
    detectCitations?: boolean;
    /** Keep Markdown links in text so the Markdown renderer can preserve enclosing structures such as tables and lists. */
    preserveMarkdownLinks?: boolean;
};
export declare function detectFilesInText(text: string): DetectedFile[];
export declare function parseContentWithFiles(text: string, options?: ParseContentOptions): ContentSegment[];
export declare function detectFileFromUrl(url: string): DetectedFile | null;