import type { SharedState } from "./shared-state.js";
export type RouteMethod = "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "*";
export interface RouteContext<TState = SharedState, TReq = unknown, TRes = unknown> {
    req: TReq;
    res: TRes;
    path: string;
    query: URLSearchParams;
    body: unknown;
    state: TState;
}
export type RouteHandler<TState = SharedState, TReq = unknown, TRes = unknown> = (ctx: RouteContext<TState, TReq, TRes>) => Promise<void> | void;
export interface RouteDefinition<TState = SharedState, TReq = unknown, TRes = unknown> {
    method: RouteMethod;
    pattern: string;
    handler: RouteHandler<TState, TReq, TRes>;
    description?: string;
}
export interface Router<TState = SharedState, TReq = unknown, TRes = unknown> {
    add: (method: RouteMethod, pattern: string, handler: RouteHandler<TState, TReq, TRes>, description?: string) => void;
    match: (method: string, path: string) => RouteDefinition<TState, TReq, TRes> | undefined;
    routes: () => readonly RouteDefinition<TState, TReq, TRes>[];
}
export declare function createRouter<TState = SharedState, TReq = unknown, TRes = unknown>(): Router<TState, TReq, TRes>;