import { type LatLngLike } from "../geo.js";
export interface SearchResult {
    name: string;
    center: LatLngLike;
    description?: string;
    bbox?: unknown;
    properties?: Record<string, unknown>;
}
export interface SearchContext {
    limit?: number;
    signal?: AbortSignal;
    center?: LatLngLike;
    [key: string]: unknown;
}
export interface SearchAdapter<TResult extends SearchResult = SearchResult> {
    search(query: string, context: SearchContext): Promise<TResult[] | null | undefined> | TResult[] | null | undefined;
    geocode?(query: string, context: SearchContext): Promise<TResult | null | undefined> | TResult | null | undefined;
    reverse?(center: LatLngLike, context: SearchContext): Promise<TResult | null | undefined> | TResult | null | undefined;
}
/**
 * What `reverse()` should do when the adapter implements no reverse geocoding.
 * `"none"` (default) reports the missing capability as `null`. `"coordinates"` restores the
 * older behaviour: a synthetic result whose `name` is the formatted latitude/longitude, which
 * is useful for a UI field but is not a reverse-geocoded place.
 */
export type ReverseFallback = "none" | "coordinates";
export interface SearchProviderConfig {
    limit?: number;
    fallbackReverse?: ReverseFallback;
}
export declare class SearchProvider<TResult extends SearchResult = SearchResult> {
    readonly adapter: SearchAdapter<TResult>;
    readonly limit: number;
    readonly fallbackReverse: ReverseFallback;
    constructor(adapter: SearchAdapter<TResult>, options?: SearchProviderConfig);
    search(query: string, context?: SearchContext): Promise<TResult[]>;
    geocode(query: string, context?: SearchContext): Promise<TResult | null>;
    /**
     * `null` means "no reverse-geocoded place" — including the case where the adapter has no
     * `reverse()` at all. An unsupported capability stays observable instead of being dressed up
     * as a successful lookup; opt into the coordinate placeholder with `fallbackReverse`.
     */
    reverse(center: LatLngLike, context?: SearchContext): Promise<TResult | null>;
}
export declare function createSearchProvider<TResult extends SearchResult>(adapter: SearchAdapter<TResult>, options?: SearchProviderConfig): SearchProvider<TResult>;
export declare function createArraySearchProvider<TResult extends SearchResult>(items: TResult[], options?: SearchProviderConfig & {
    text?: (item: TResult) => string;
}): SearchProvider<TResult>;
export type SearchProviderSource<TResult extends SearchResult> = SearchAdapter<TResult> | TResult[];
export type SearchProviderOptions<TResult extends SearchResult> = SearchProviderConfig & {
    text?: (item: TResult) => string;
};
export declare function searchProvider<TResult extends SearchResult>(source: TResult[], options?: SearchProviderOptions<TResult>): SearchProvider<TResult>;
export declare function searchProvider<TResult extends SearchResult>(source: SearchAdapter<TResult>, options?: SearchProviderConfig): SearchProvider<TResult>;
//# sourceMappingURL=search.d.ts.map