import type { ApiRoute, PageRoute } from "../router/route-scanner.js";
export interface MatchResult {
    route: PageRoute;
    params: Record<string, string | string[]>;
    searchParams: URLSearchParams;
}
/**
 * Match a request pathname against a list of page routes.
 *
 * Routes are sorted by specificity (static > dynamic > catch-all) before
 * matching, so `/about` wins over `/:slug` even if the catch-all appears first.
 *
 * URL segments are safely decoded (plan §11.1, runtime-security §10).
 */
export declare function matchRoute(pathname: string, routes: PageRoute[]): MatchResult | undefined;
export interface ApiMatchResult<T = ApiRoute> {
    route: T;
    params: Record<string, string | string[]>;
}
/**
 * Match a request pathname against a list of API routes.
 */
export declare function matchApiRoute<T extends {
    path: string;
}>(pathname: string, routes: T[]): ApiMatchResult<T> | undefined;