import type { CitationOccurrence } from './types.js';
export type HighlightSegment = {
    text: string;
    /** 1-based occurrence number when this segment is a highlighted match. */
    occurrence?: number;
};
export declare function escapeCitationMarkup(text: string, tagName: string, context: 'document' | 'highlight'): string;
/**
 * Fallback when the host provides no `locate` callback. Plain case-insensitive matching:
 * accent variants won't match, which degrades to "term not found" rather than breaking.
 */
export declare function locateTermClientSide(content: string, term: string): CitationOccurrence[];
/** Occurrence ranges are host data: invalid, out-of-bounds and overlapping ranges are dropped. */
export declare function splitContentByOccurrences(content: string, occurrences: CitationOccurrence[]): HighlightSegment[];