import type { InferRoutes, RouterDefinition, Router as Handle, RoutesShape } from "../types";
/**
 * Creates a {@link RouterDefinition} — the per-app entrypoint that owns
 * the routes for an entire deployable.
 *
 * The urls type is inferred from each entry's `name`/`url` pair via a
 * `const` generic — no explicit `<Urls>` annotation needed. The returned
 * value carries:
 * - `routes.Router` — a pre-bound `<Router>` component (mount it directly,
 *   no `using` prop required)
 * - `routes.url.X(params)` — typed builders for every named route
 * - `routes.useContext()` — hook returning the typed navigation handle
 *
 * @example
 * ```tsx
 * // app/routes.ts
 * import { Router, route } from "react-wayfinder";
 *
 * export const routes = Router([
 *   route({ name: "home", url: "/", match: () => <Home /> }),
 *   route({
 *     name: "user",
 *     url: "/users/:id",
 *     async data({ params, signal }) {
 *       return fetchUser(params.id, { signal });
 *     },
 *     match({ status, params, data, error }) {
 *       if (status === "loading") return <Skeleton />;
 *       if (error) return <p>{error.message}</p>;
 *       if (data) return <User id={params.id} name={data.name} />;
 *       return null;
 *     },
 *   }),
 *   route({ name: "signOut", url: "/sign-out", redirect: "/" }),
 *   route({ url: "*", match: () => <NotFound /> }),
 * ]);
 *
 * // mount at root — no `using` prop, no children required
 * <routes.Router>{children}</routes.Router>;
 *
 * // anywhere inside — auto-typed
 * const router = routes.useContext();
 * <a href={router.url.user({ id: "42" })}>User 42</a>;
 * router.navigate.push(router.url.home());
 * ```
 */
export declare function Router<const Entries extends readonly unknown[]>(entries: Entries): RouterDefinition<InferRoutes<Entries>>;
export type Router<U extends RoutesShape = RoutesShape> = Handle<U>;