import type { AuthContextValue } from '../types/auth.types.js';
/**
 * Returns the current auth context value from the nearest {@link AuthProvider}.
 *
 * Provides access to authentication state, login/logout methods, and token
 * retrieval for making authenticated API requests.
 *
 * @throws {AuthError} When called outside of an `AuthProvider`.
 *
 * @example
 * ```tsx
 * function Profile() {
 *   const { user, logout, isAuthenticated } = useAuth();
 *   if (!isAuthenticated) return <div>Not logged in</div>;
 *   return <button onClick={logout}>{user?.profile.name}</button>;
 * }
 * ```
 */
export declare const useAuth: () => AuthContextValue;
//# sourceMappingURL=useAuth.d.ts.map