Files
frontend/apps/sn/src/features/map-search/lib/map-navigation.ts
T

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) };
}