export interface RouterResponseLike {
    writeHead: (statusCode: number, headers?: Record<string, string>) => unknown;
    end: (chunk?: unknown) => unknown;
}
export type RouteHandler<TReq, TRes extends RouterResponseLike> = (req: TReq, res: TRes, next: (err?: Error) => void) => void | Promise<void>;
export type MiddlewareHandler<TReq, TRes extends RouterResponseLike> = RouteHandler<TReq, TRes>;
export interface RouteMatch<TReq, TRes extends RouterResponseLike> {
    handler: RouteHandler<TReq, TRes>;
    params: Record<string, string>;
    query: Record<string, string | string[]>;
    pattern: string;
}
interface RouterRouteEntry<TReq, TRes extends RouterResponseLike> {
    method: string;
    pattern: string;
    regex: RegExp;
    paramNames: string[];
    handler: RouteHandler<TReq, TRes>;
    isWildcard: boolean;
    literalCount: number;
    totalSegments: number;
}
/**
 * Simple pattern-matching HTTP router.
 * P11: Includes a route matching cache.
 */
export declare class Router<TReq, TRes extends RouterResponseLike = RouterResponseLike> {
    routes: Map<string, RouterRouteEntry<TReq, TRes>[]>;
    middleware: MiddlewareHandler<TReq, TRes>[];
    _cache: Map<string, RouteMatch<TReq, TRes>>;
    constructor();
    use(fn: MiddlewareHandler<TReq, TRes>): void;
    get(pattern: string, handler: RouteHandler<TReq, TRes>): void;
    post(pattern: string, handler: RouteHandler<TReq, TRes>): void;
    put(pattern: string, handler: RouteHandler<TReq, TRes>): void;
    patch(pattern: string, handler: RouteHandler<TReq, TRes>): void;
    delete(pattern: string, handler: RouteHandler<TReq, TRes>): void;
    _add(method: string, pattern: string, handler: RouteHandler<TReq, TRes>): void;
    _parseQuery(searchParams: URLSearchParams): Record<string, string | string[]>;
    _autoOptions(normalized: string, query: Record<string, string | string[]>): RouteMatch<TReq, TRes> | null;
    match(method: string, url: string): RouteMatch<TReq, TRes> | null;
    _matchUncached(method: string, url: string): RouteMatch<TReq, TRes> | null;
}
export {};
//# sourceMappingURL=Router.d.ts.map