import { type EngineLevel, type PatternRule } from '../patterns/types.js';
export interface Candidate {
    /** Offset of the match in the source text. */
    start: number;
    /** Offset one past the last character of the match. */
    end: number;
    text: string;
    entityType: string;
    score: number;
    ruleId: string;
    /** Which variant of the rule produced this match. */
    variant: string;
    /** Whether a context word was found nearby. */
    contextHit: boolean;
    /** Checksum outcome: true/false when the rule has one, null when it does not. */
    checksum: boolean | null;
}
export interface RecognizeOptions {
    level?: EngineLevel;
    /** Drop matches whose checksum fails, instead of keeping them at base score. */
    strictValidation?: boolean;
}
/**
 * Find every entity in `text` that clears the sensitivity threshold,
 * with overlaps already resolved. Returned in document order.
 */
export declare function findCandidates(text: string, rules: PatternRule[], options?: RecognizeOptions): Candidate[];
//# sourceMappingURL=recognizer.d.ts.map