import type Map from "ol/Map"; import type { FitOptions } from "ol/View"; /** 지도 객체별 이동 요청과 검색바 초기화 revision을 보관한다. 다른 지도와 상태를 공유하지 않는다. */ type NavigationState = { generation: number; revision: number; listeners: Set<() => void>; }; const states = new WeakMap(); /** 부분 지도 인터페이스를 사용하는 기능도 동일한 인스턴스로 요청을 관리한다. */ type NavigationTarget = { getView?: () => unknown }; /** 지도 생명주기와 함께 회수되는 상태를 반환한다. */ function stateFor(map: object): NavigationState { let state = states.get(map); if (!state) { state = { generation: 0, revision: 0, listeners: new Set() }; states.set(map, state); } return state; } /** 빈/역전/비수치 범위를 이동 성공으로 취급하지 않는다. */ export function isNavigationExtent(extent: unknown): extent is number[] { return Array.isArray(extent) && extent.length === 4 && extent.every(Number.isFinite) && extent[0] <= extent[2] && extent[1] <= extent[3]; } /** 검색바 조작은 아직 완료되지 않은 목록 이동보다 우선한다. */ export function invalidateMapNavigation(map: object | null | undefined) { if (map) stateFor(map).generation += 1; } /** 검색바는 이미 발생한 초기화도 revision으로 읽어 늦은 마운트에서 유실하지 않는다. */ export function getMapSearchRevision(map: object | null | undefined) { return map ? stateFor(map).revision : 0; } /** 한 지도 검색바의 초기화만 구독한다. */ export function subscribeMapSearch(map: object | null | undefined, listener: () => void) { if (!map) return () => {}; const state = stateFor(map); state.listeners.add(listener); return () => { state.listeners.delete(listener); }; } /** 조회 시작에 발급하고 도형 확보 뒤 commit한다. 최신 요청만 한 번 검색바를 초기화한다. */ export function beginMapNavigation(map: NavigationTarget | null | undefined) { const state = map ? stateFor(map) : null; const generation = state ? ++state.generation : -1; let committed = false; const isCurrent = () => Boolean(state && state.generation === generation); return { isCurrent, commit(extent: unknown) { if (!isCurrent() || !map?.getView?.() || !isNavigationExtent(extent)) return false; if (!committed && state) { committed = true; state.revision += 1; state.listeners.forEach((listener) => listener()); } return true; }, }; } /** 도형이 이미 준비된 목록 선택은 기존 fit 옵션을 그대로 사용한다. */ export function fitMapSelection(map: Pick | null | undefined, extent: unknown, options: FitOptions & { constrainResolution?: boolean }) { if (!map?.getView?.()?.fit || !isNavigationExtent(extent)) return false; const navigation = beginMapNavigation(map); if (!navigation.commit(extent)) return false; map.getView().fit(extent, options); return true; } /** 공통 GeoJSON 검색의 비동기 로드 완료 시 호출할 선택적 계약이다. */ export function mapSearchNavigationOptions(map: NavigationTarget | null | undefined) { const navigation = beginMapNavigation(map); return { beforeFocus: (extent: unknown) => navigation.commit(extent) }; }