import { Params } from "next/dist/server/request/params";
import { Infer } from "superstruct";
import { RouteInfo, Router, RouterOptions } from "./create-router";
import { QueryParams, RoutesDefinition } from "./types";
export interface TransitionOptions {
    shallow?: boolean;
    locale?: string | false;
    scroll?: boolean;
    unstable_skipClientCache?: boolean;
}
type QueryParamsResult<Nullable extends boolean, T extends keyof RouteList, Locales extends string[], RouteList extends RoutesDefinition<Locales>> = [
    Nullable extends true ? Infer<NonNullable<RouteList[T]["schema"]>> | null : Infer<NonNullable<RouteList[T]["schema"]>>,
    {
        push: (params: Infer<NonNullable<RouteList[T]["schema"]>>, options?: TransitionOptions) => Promise<boolean>;
        replace: (params: Infer<NonNullable<RouteList[T]["schema"]>>, options?: TransitionOptions) => Promise<boolean>;
    }
];
/**
 * The client router – a superset of `createRouter` (`@uxf/router`) that adds the React hooks.
 * Lives in a separate client-only module (`@uxf/router/client`) because it imports `next/navigation`
 * and `next/router`, which are not safe to pull into React Server Components.
 */
export type ClientRouter<Locales extends string[], RouteList extends RoutesDefinition<Locales>> = Router<Locales, RouteList> & {
    useRouteInfo: () => RouteInfo | null;
    /**
     * @deprecated use useQueryParamsStatic or useQueryParams instead
     */
    useQueryParamsDeprecated: <T extends keyof RouteList>() => QueryParams<RouteList, T>;
    /**
     * Returns path params merged with search params
     */
    usePageParams: () => Params | null;
    useQueryParams: <T extends keyof RouteList>(routeName: T) => QueryParamsResult<false, T, Locales, RouteList>;
    useQueryParamsStatic: <T extends keyof RouteList>(routeName: T) => QueryParamsResult<true, T, Locales, RouteList>;
};
/**
 * Creates the client router – everything `createRouter` returns plus the React hooks
 * (`useQueryParams`, `useQueryParamsStatic`, `usePageParams`, `useRouteInfo`).
 *
 * Use this in client components. For server-safe usage (including React Server Components) use
 * `createRouter` from `@uxf/router` instead.
 */
export declare function createClientRouter<Locales extends string[], RouteList extends RoutesDefinition<Locales>>(routes: RouteList, routerOptions: RouterOptions<Locales>): ClientRouter<Locales, RouteList>;
export {};