/* =============================================================================
 * common_util_summary_item.ts
 * 구조물 집계표 항목 참조(PLAN 21-1) — 구조물 · 관 지점이 「어느 집계표 항목」인지 가리키는 값.
 *
 *   summary_item: { layer: "system"|"company"|"personal", owner: null|"{회사}"|"{회사}/{사용자}",
 *                   key: "SS000004", name: "돌기슭막이 메쌓기 1.2m" }
 *
 * 없으면 null(= 미지정 · 집계표에 안 들어감). 옵션(options) 밖의 칸이다.
 * import 없음 — 시험이 이 파일만 옮겨 돌림.
 * ========================================================================== */

export type SummaryLayer = "system" | "company" | "personal";

export interface SummaryItem {
  layer: SummaryLayer;
  owner: string | null;
  key: string;
  name: string;
}

const LAYERS: readonly string[] = ["system", "company", "personal"];

/** 참조 모양이 맞는가 — 서버 응답 · 세션 초안을 읽을 때 걸러 쓴다. */
export function isSummaryItem(value: unknown): value is SummaryItem {
  if (!value || typeof value !== "object") return false;
  const item = value as Record<string, unknown>;
  return (
    typeof item.layer === "string" &&
    LAYERS.includes(item.layer) &&
    (item.owner === null || typeof item.owner === "string") &&
    typeof item.key === "string" &&
    item.key !== "" &&
    typeof item.name === "string"
  );
}

/** 같은 항목인가 — 층 · 주인 · 키가 같으면 같음(이름은 바뀔 수 있어 안 봄). */
export function sameSummaryItem(left: SummaryItem | null, right: SummaryItem | null): boolean {
  if (!left || !right) return left === right;
  return left.layer === right.layer && left.owner === right.owner && left.key === right.key;
}

/** 서버 · 세션에서 온 값을 참조 또는 null 로 — 모양이 틀리면 null(미지정). */
export function readSummaryItem(value: unknown): SummaryItem | null {
  return isSummaryItem(value) ? value : null;
}

/** 표시 글 — 이름(없으면 「미지정」). 키는 앞에 내세우지 않는다(PLAN 21-0). */
export function summaryLabel(item: SummaryItem | null): string {
  return item ? item.name || item.key : "미지정";
}

/** 툴팁 — 이름 + 어느 그룹 것인지 · 키는 작은 글로만. */
export function summaryTooltip(item: SummaryItem | null): string {
  if (!item) return "집계 항목 미지정 — 집계표에 안 들어감";
  const group = { system: "마스터", company: "회사용", personal: "개인용" }[item.layer];
  return `${item.name} · ${group} · ${item.key}`;
}