import type { Ref } from 'react';
import type { EventHandlerProps, GroundOverlayEvent } from './types/overlay-events.js';
/**
 * 이미지를 지도 위에 오버레이한다.
 *
 * ## url/bounds 변경 시 인스턴스 재생성
 *
 * 네이버맵 API에 setBounds()가 없다.
 * setUrl()은 존재하지만 내부적으로 KVO set("url")을 호출하지 않아
 * getUrl()과 불일치가 발생하는 불완전한 구현이다.
 *
 * 따라서 url/bounds 모두 변경 시 인스턴스를 재생성한다.
 * useLayoutEffect의 의존성 배열 [url, bounds]로 제어하며,
 * cleanup에서 이전 인스턴스를 확실히 정리한다.
 *
 * ## useOverlay를 쓰지 않는 이유
 *
 * useOverlay는 의존성 배열이 []로 고정(마운트 1회)이다.
 * url/bounds 변경에 의한 재생성이 필요하므로 직접 useLayoutEffect를 사용한다.
 */
export interface GroundOverlayProps extends EventHandlerProps<GroundOverlayEvent> {
    ref?: Ref<naver.maps.GroundOverlay>;
    url: string;
    bounds: naver.maps.LatLngBounds | naver.maps.LatLngBoundsLiteral;
    opacity?: number;
    clickable?: boolean;
}
export declare function GroundOverlay({ ref, ...props }: GroundOverlayProps): import("react/jsx-runtime").JSX.Element | null;
//# sourceMappingURL=ground-overlay.d.ts.map