Aislo/A00_Common/map/map_toolbar.ts

/* =============================================================================
 * map_toolbar.ts
 * 공용 지도 도구줄 표(PLAN 624-2 · 634-2 · 요구 530 · 546) — 예정노선(D03) · B05 평면이 같이 씀.
 *   한 줄 = 요구 546 그룹2 표 한 줄 — 열쇠(`ui_template_map_tools` 단추 이름 · 아이콘) · 호버제목(`title`) · 할 일 · 보일 페이지.
 *   묶음 = 나눔선 · 차례 = 도구줄 차례 · 단추 아닌 칸(간격 고르기 · 추천 노선 보기 · 지형 칩)은 페이지가 만든 요소.
 *   마우스 글 = 이 표 `title` 하나(페이지 덮어쓰기 없음) · 막힘이면 페이지가 `mapToolTip(단추, 까닭)` → 「제목 — 까닭」.
 *   누름 동작은 페이지 몫 — 만든 요소를 `parts` 로 넘기면 그 자리에 · 안 넘긴 단추는 기본 단추(돌리기 둘 = 공용 돌림이 `data-act` 로 찾음).
 *   [?] 도움말 단추 = `createMapTools` 의 `hint`(맨 앞 · 글 = 이 표 첫 줄).
 *   쓰는 법 = `createMapTools({ label, hint, groups: mapToolGroups("d03", { undo: undoButton, terrain: chip.root }) })`.
 * ========================================================================== */

import { mapToolButton, mapToolTip, type MapToolAct } from "@ui/ui_template_map_tools";
import type { MapPage } from "./map_layer_list";

export type MapToolKey = MapToolAct | "hint-toggle" | "snap-step" | "recommend" | "terrain";

export interface MapToolRow {
  key: MapToolKey;
  /** 호버제목(요구 546 표). */
  title: string;
  does: string;
  pages: readonly MapPage[];
}

const BOTH: readonly MapPage[] = ["d03", "b05"];
const B05: readonly MapPage[] = ["b05"];

export const MAP_TOOLBAR: readonly (readonly MapToolRow[])[] = [
  [{ key: "hint-toggle", title: "도움말", does: "조작 도움말 펼치기 · 접기(`hint`)", pages: BOTH }],
  [
    { key: "undo", title: "되돌리기", does: "편집 한 걸음 되돌림(Ctrl+Z)", pages: BOTH },
    { key: "redo", title: "다시하기", does: "되돌린 걸음 다시(Ctrl+Y)", pages: BOTH },
  ],
  [
    { key: "view3d", title: "3D", does: "3D 큰 창(동작 = 페이지 몫)", pages: BOTH },
    { key: "rotate-ccw", title: "좌 회전", does: "지도 반시계로 돌림(Ctrl+휠도)", pages: BOTH },
    { key: "rotate-cw", title: "우 회전", does: "지도 시계로 돌림", pages: BOTH },
  ],
  [
    {
      key: "contour-minor",
      title: "등고선 1m",
      does: "라이다 1 m 등고선 켬끔(라이다일 때만 열림)",
      pages: B05,
    },
    { key: "stations", title: "측점", does: "측점 눈금 · 번호 켬끔", pages: BOTH },
    { key: "slopes", title: "길이·기울기", does: "구간 길이 · 기울기 글 켬끔", pages: BOTH },
    { key: "footprint", title: "절성토선", does: "도로 끝 · 비탈 끝 켬끔", pages: B05 },
    { key: "measure", title: "길이측정", does: "거리 재기(동작 = 페이지 몫 · A⑩)", pages: BOTH },
  ],
  [
    {
      key: "station-snap",
      title: "스냅",
      does: "곡선 가운데(MC)를 간격 배수에 맞춤",
      pages: B05,
    },
    { key: "snap-step", title: "스냅 간격", does: "스냅 간격 고르기(고르기 메뉴)", pages: B05 },
  ],
  [
    {
      key: "expected-draw",
      title: "예정노선 변경",
      does: "예정노선 변경 켬끔(626-3 · 걷음 = 635-3)",
      pages: B05,
    },
    {
      key: "expected-original",
      title: "예정노선 원본",
      does: "예정노선(원본) 옅은 점선 켬끔(626-3 · 걷음 = 635-3)",
      pages: B05,
    },
  ],
  [
    {
      key: "recommend",
      title: "추천노선",
      does: "노선 추천 저장본 선 하나만 보기 · 끔(626-1 · 예정노선 = 636-2)",
      pages: B05,
    },
  ],
  [{ key: "terrain", title: "수치지형도/라이다", does: "지형 원천 보기 · 고르기", pages: BOTH }],
];

const ROWS = MAP_TOOLBAR.flat();

/** 표 호버제목 — 페이지 칸(지형 칩 막힘 글 등)이 씀. */
export const mapToolTitle = (key: MapToolKey): string =>
  ROWS.find((row) => row.key === key)?.title ?? key;

const isAct = (key: MapToolKey): key is MapToolAct =>
  key !== "hint-toggle" && key !== "snap-step" && key !== "recommend" && key !== "terrain";

/** 그 페이지 도구줄 묶음 — 넘긴 요소 · 기본 단추(단추 열쇠만) · 마우스 글 = 표 · 빈 묶음 뺌. */
export function mapToolGroups(
  page: MapPage,
  parts: Partial<Record<MapToolKey, HTMLElement>> = {},
): HTMLElement[][] {
  return MAP_TOOLBAR.map((group) =>
    group
      .filter((row) => row.pages.includes(page))
      .flatMap((row): HTMLElement[] => {
        const made = parts[row.key] ?? (isAct(row.key) ? mapToolButton(row.key) : null);
        if (!made) return [];
        made.dataset.tip = row.title;
        mapToolTip(made);
        return [made];
      }),
  ).filter((group) => group.length);
}