/**
 * vapor-chamber-router — the single error taxonomy.
 *
 * Mirrors vapor-chamber's HttpError convention: a plain Error narrowed by
 * `name`, with a machine-readable snake_case `code` (same style as the
 * Laravel `{ ok: false, error, code }` responses), the target location, and
 * the original `cause`. Handlers switch on `code`, never message text.
 *
 * This is ALSO the navigation result: `navigate()` resolves to
 * `RouterError | null` — null means committed. Refusals that are normal flow
 * ('aborted' by a guard, 'cancelled' by a newer navigation) are returned to
 * the caller but NOT dispatched to onError.
 */
import type { RouteLocation } from './types';
export type RouterErrorCode = 'unmatched' | 'aborted' | 'cancelled' | 'not_ready' | 'unknown_route_name' | 'duplicate_route' | 'unknown_parent' | 'missing_param' | 'bad_menu_row' | 'invalid_path' | 'invalid_routes_payload' | 'routes_load_failed' | 'inline_routes_missing' | 'component_missing' | 'component_load_failed' | 'load_failed' | 'blade_unconfigured' | 'blade_fetch_failed';
export type RouterError = Error & {
    name: 'RouterError';
    code: RouterErrorCode;
    /** Target location of the navigation that failed, when applicable. */
    to?: RouteLocation;
};
export declare function routerError(code: RouterErrorCode, message: string, extra?: {
    to?: RouteLocation;
    cause?: unknown;
}): RouterError;
export declare function isRouterError(error: unknown, code?: RouterErrorCode): error is RouterError;
/** Codes where the server gets the last word: the default onError handler
 *  hard-navigates — an unmatched URL renders server-side, and a failed lazy
 *  chunk (stale hashes after a deploy) recovers via a full page load. */
export declare const HARD_NAV_CODES: ReadonlySet<RouterErrorCode>;
//# sourceMappingURL=errors.d.ts.map