import type { Locator, Page } from "playwright";

export interface LocateOptions {
    
    ref?: string;
    
    selector?: string;
    
    text?: string;
    
    role?: string;
    
    name?: string;
    
    refFallback?: {
        role: string;
        name: string;
    };
}

export declare function validateSelector(selector: string): void;

export declare function locateElement(page: Page, options: LocateOptions): Promise<Locator>;