import type { FuzzyMatchOptions, FuzzyMatchResult } from './types.js';
/**
 * String-overload: when `items` is an array of strings, the searchable text
 * is the string itself. No keyFn is required.
 */
export declare function fuzzyMatch<T extends string>(query: string, items: T[], options?: FuzzyMatchOptions): FuzzyMatchResult<T>[];
/**
 * Object-overload: caller provides a `keyFn` that extracts the searchable
 * text from each item. The keyFn is invoked once per item per call; the
 * caller is responsible for ensuring the result is stable (e.g., don't
 * concatenate mutable fields).
 */
export declare function fuzzyMatchWithKey<T>(query: string, items: T[], options: FuzzyMatchOptions & {
    keyFn: (item: T) => string;
}): FuzzyMatchResult<T>[];