82 lines
3.3 KiB
TypeScript
82 lines
3.3 KiB
TypeScript
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<object, NavigationState>();
|
|
/** 부분 지도 인터페이스를 사용하는 기능도 동일한 인스턴스로 요청을 관리한다. */
|
|
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<Map, "getView"> | 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) };
|
|
}
|