import { useDeviceInfo } from '../useDeviceInfo';
export interface UseOverlayModeOptions {
    /** Force modal presentation regardless of platform */
    forceModal?: boolean;
    /** Force anchored overlay/portal regardless of platform */
    forceOverlay?: boolean;
}
export interface UseOverlayModeResult {
    /** Raw device info reference (forwarded for convenience) */
    deviceInfo: ReturnType<typeof useDeviceInfo>;
    /** True when running on React Native Web */
    isWeb: boolean;
    /** Consolidated mobile experience flag (native or narrow web) */
    isMobileExperience: boolean;
    /** Inverse of mobile experience flag */
    isDesktopExperience: boolean;
    /** Prefer fullscreen/modal surfaces (native + mobile web) */
    shouldUseModal: boolean;
    /** Prefer anchored overlays/portals (desktop web) */
    shouldUseOverlay: boolean;
    /** Alias for shouldUseOverlay for popover/portal driven surfaces */
    shouldUsePortal: boolean;
}
/**
 * Normalises how components decide between fullscreen modals and anchored overlays
 * by combining platform + device heuristics from useDeviceInfo.
 */
export declare function useOverlayMode(options?: UseOverlayModeOptions): UseOverlayModeResult;
export default useOverlayMode;