import type { RouteDefinition, MatchedRoute } from './types.js';
/**
 * LIFO stack for storing route definitions in the Node Playwright process.
 * Evaluates route patterns, HTTP methods, headers, and query parameters.
 */
export declare class RouteStore {
    private routes;
    /**
     * Total number of active routes currently in the store.
     */
    get count(): number;
    /**
     * Returns true if there is at least one active route registered.
     */
    hasRoutes(): boolean;
    /**
     * Adds a route to the top of the stack (LIFO).
     *
     * @param route The RouteDefinition to register.
     */
    add(route: RouteDefinition): void;
    /**
     * Yields all matching routes for a request, allowing fallback support.
     *
     * @param url The full URL of the intercepted request.
     * @param method The HTTP method of the request.
     * @param headers Request headers dictionary.
     * @returns Generator yielding matched routes alongside their URLPattern match results.
     */
    findMatches(url: string, method: string, headers: Record<string, string>): Generator<MatchedRoute>;
    /**
     * Removes a route by its ID.
     *
     * @param id The unique identifier of the route to remove.
     */
    removeById(id: number): void;
    /**
     * Clears all routes from the store.
     */
    reset(): void;
    /**
     * Checks if request headers match required headers.
     */
    private headersMatch;
    /**
     * Verifies if request query parameters satisfy required route query criteria.
     *
     * Scalar expected values act as subset filters allowing extra query parameters on the request URL.
     * Array expected values enforce exact set equality for that key across all values.
     */
    private queryMatches;
}