/**
 * Mocks the `@tanstack/react-router` library for testing environments.
 *
 * Replaces `useNavigate` with a no-op so components that call the
 * navigation function during a test do not throw outside a router context.
 *
 * Opt-in: the mock is registered via `vi.doMock` so it is
 * NOT hoisted and only takes effect once `setupTanstackReactRouter()` is
 * called from a test setup file. Tests that need the real `useNavigate`
 * (or their own mock) are unaffected unless they explicitly call this.
 *
 * @example
 * // In your vitest setup file
 * import { setupTanstackReactRouter } from '@trackunit/react-vite-test-setup';
 *
 * setupTanstackReactRouter();
 */
export declare const setupTanstackReactRouter: () => void;