import type { CustomQueryHandler, default as PuppeteerInstance } from "puppeteer-core";
/** Root node Puppeteer passes to a custom query handler (the document for page-level queries). */
type QueryNode = Parameters<NonNullable<CustomQueryHandler["queryAll"]>>[0];
/**
 * `label/` handler: controls whose `<label>` text, `aria-label`, or `aria-labelledby` text contains the
 * query (case-insensitive).
 */
export declare function queryByLabel(node: QueryNode, selector: string): Element[];
/** `placeholder/` handler: elements whose `placeholder` contains the query (case-insensitive). */
export declare function queryByPlaceholder(node: QueryNode, selector: string): Element[];
/** `testid/` handler: elements whose `data-testid` equals the trimmed query. */
export declare function queryByTestId(node: QueryNode, selector: string): Element[];
/** `alt/` handler: elements whose `alt` contains the query (case-insensitive). */
export declare function queryByAlt(node: QueryNode, selector: string): Element[];
/** `title/` handler: elements whose `title` contains the query (case-insensitive). */
export declare function queryByTitle(node: QueryNode, selector: string): Element[];
/** The Tern kit's role and accessible-name rules, from {@link roleRules}. */
export interface RoleRules {
    /** The element's explicit role (its first token; `presentation` as `none`), else its implicit one. */
    role(element: Element): string | null;
    /** The element's accessible name. */
    name(element: Element): string;
    /** The text of the elements its `aria-describedby` names. */
    description(element: Element): string;
    /** The `role/` handler: `role[name="…" exact]` below `node`, open shadow roots included. */
    query(node: QueryNode, selector: string): Element[];
}
/**
 * Role and accessible-name rules computed by hand, for the Tern kit, whose WebKit page offers no accessibility tree
 * to ask; Chromium asks Chrome instead ({@link registerSemanticQueryHandlers}). The kit's `observe()` and its `role/`
 * selector both use them, so a name `observe()` reports selects the same element again. Serialized whole into the kit,
 * so it MUST stay self-contained. Each instance caches roles, so take a fresh one per pass over the page.
 *
 * The `role/` handler refuses anything else in the selector (a chained `>> role/…`, another attribute) rather than
 * ignoring it, since ignoring it would match the outer element; the grammar is {@link parseRoleSelector}'s, repeated
 * here because this function is serialized whole.
 */
export declare function roleRules(): RoleRules;
/** Semantic selector prefixes (`label/`, …) and their self-contained `queryAll` handlers; `role/` is separate. */
export declare const SEMANTIC_QUERY_HANDLERS: {
    readonly label: typeof queryByLabel;
    readonly placeholder: typeof queryByPlaceholder;
    readonly testid: typeof queryByTestId;
    readonly alt: typeof queryByAlt;
    readonly title: typeof queryByTitle;
};
/** A parsed `role/` selector; the name filter is whitespace-collapsed and lower-cased, as names are compared. */
export interface RoleQuery {
    role: string;
    name?: string;
    exact: boolean;
}
/** Parse a `role/` selector body with the grammar {@link roleRules} reads in the Tern kit, refusing what it refuses. */
export declare function parseRoleSelector(selector: string): RoleQuery;
/**
 * Register the browser tool's semantic selector prefixes on a worker-local Puppeteer instance. `role/` resolves in
 * Node through Chrome's accessibility tree ({@link queryRoleInAXTree}); {@link roleRules} serves only the Tern kit.
 */
export declare function registerSemanticQueryHandlers(puppeteer: typeof PuppeteerInstance): void;
export {};