Aislo/ui_template/ui_template_elements.ts

/* =============================================================================
 * ui_template_elements.ts
 * 공통 컴포넌트 및 그룹 템플릿 정의
 *
 * 원칙:
 *   - 모든 컴포넌트는 임의 스타일링 금지, 여기 규격을 최우선 상속/참조 (frontend.md §2).
 *   - 색상/간격은 CSS 클래스 + theme.css 변수로만 처리, JS 내 인라인 색상 금지.
 *   - 팩토리 함수는 HTMLElement를 반환하는 vanilla TS 패턴.
 *   - 스타일 규칙은 injectBaseStyles()로 1회 주입 (design.md 컴포넌트 명세 기반).
 * ========================================================================== */

import { el } from "./ui_template_elements_base";
import { createButton } from "./ui_template_button";
import { createProgressCircle, type ProgressCircleHandle } from "./ui_template_progress";

// 차트·기본 스타일 조각은 파일이 700줄을 넘어 떼어냈다(2026-09-04).
// 여기서 그대로 다시 내보내 호출부의 import 경로는 불변이다.
export * from "./ui_template_elements_chart";
export * from "./ui_template_elements_styles";
export { el } from "./ui_template_elements_base";
export * from "./ui_template_button";
export * from "./ui_template_input";

/** 요소 생성 + 속성/클래스/자식 일괄 설정 헬퍼 */

/* -----------------------------------------------------------------------------
 * 1. 버튼 — 부품 「단추」 · 「아이콘 단추」는 `ui_template_button.ts`(552-2) · 부르는 길은 그대로
 * -------------------------------------------------------------------------- */

/* -----------------------------------------------------------------------------
 * 2. 입력 · 고르기 — 부품 「입력」 · 「고르기」 · 「슬라이더」는 `ui_template_input.ts`(552-2) · 부르는 길은 그대로
 * -------------------------------------------------------------------------- */

/* -----------------------------------------------------------------------------
 * 3. 카드 / 패널 (Card) — design.md: white surface, 8px radius, shadow
 * -------------------------------------------------------------------------- */

export interface CardOptions {
  title?: string;
  /** 본문 자식 요소들 */
  body?: (HTMLElement | string)[];
  /** 그림자 강조 여부 (shadow-lg 사용) */
  raised?: boolean;
}

export function createCard(opts: CardOptions): HTMLDivElement {
  const card = el("div", {
    className: `ui-card${opts.raised ? " ui-card--raised" : ""}`,
  });
  if (opts.title) {
    card.append(el("h3", { className: "ui-card__title", text: opts.title }));
  }
  if (opts.body) {
    card.append(el("div", { className: "ui-card__body", children: opts.body }));
  }
  return card;
}

/* -----------------------------------------------------------------------------
 * 4. 태그 / 배지 (Tag / Pill) — design.md: 1440px radius pill
 * -------------------------------------------------------------------------- */

export type TagVariant = "accent" | "neutral" | "success" | "warning" | "danger";

export function createTag(label: string, variant: TagVariant = "neutral"): HTMLSpanElement {
  return el("span", { className: `ui-tag ui-tag--${variant}`, text: label });
}

/* -----------------------------------------------------------------------------
 * 5. 로딩 오버레이 (Loading Overlay) — frontend.md §4: API 호출 시 필수
 *    싱글턴 오버레이. show/hide로 참조 카운트 관리.
 * -------------------------------------------------------------------------- */

let overlayEl: HTMLDivElement | null = null;
let overlayCount = 0;
let overlayProgress: ProgressCircleHandle | null = null;

function ensureOverlay(): HTMLDivElement {
  if (overlayEl) return overlayEl;
  const spinner = el("div", { className: "ui-spinner", attrs: { "aria-hidden": "true" } });
  overlayEl = el("div", {
    className: "ui-overlay",
    attrs: { role: "status", "aria-live": "polite" },
    children: [spinner],
  });
  document.body.append(overlayEl);
  return overlayEl;
}

/** 로딩 스피너 오버레이 표시 (중첩 호출 안전) */
export function showLoadingOverlay(): void {
  overlayCount += 1;
  ensureOverlay().classList.add("is-active");
}

/** 로딩 스피너 오버레이 해제 (모든 참조 종료 시 실제 숨김) */
export function hideLoadingOverlay(): void {
  overlayCount = Math.max(0, overlayCount - 1);
  if (overlayCount === 0 && overlayEl) {
    overlayEl.classList.remove("is-active", "ui-overlay--progress");
    overlayProgress?.remove();
    overlayProgress = null;
  }
}

/** 띄운 잠금판에 진행 원 · 글(520-3) — 스피너 자리 · 모든 참조가 풀리면 함께 걷힘.
 *  ratio null = 진행률 미상(회전만). 잠금판이 안 떠 있으면 아무것도 안 함. */
export function setLoadingOverlayProgress(ratio: number | null, label?: string): void {
  if (overlayCount === 0) return;
  const overlay = ensureOverlay();
  if (!overlayProgress) {
    overlayProgress = createProgressCircle();
    overlay.append(overlayProgress.root);
    overlay.classList.add("ui-overlay--progress");
  }
  overlayProgress.set(ratio, label);
}

/* -----------------------------------------------------------------------------
 * 6. 토스트 알림 (Toast) — 성공/에러 배너
 * -------------------------------------------------------------------------- */

export type ToastKind = "success" | "error" | "info" | "warning";

let toastContainer: HTMLDivElement | null = null;

function ensureToastContainer(): HTMLDivElement {
  if (toastContainer) return toastContainer;
  toastContainer = el("div", { className: "ui-toast-container" });
  document.body.append(toastContainer);
  return toastContainer;
}

/** 직전에 띄운 문구와 그 소멸 시각 — 같은 문구가 연달아 오면 무시한다. */
let lastToast: { key: string; until: number } | null = null;

/**
 * 토스트 표시. durationMs 후 자동 소멸.
 *
 * **같은 문구 연속 무시**(2026-08-30 사용자 지시 2) — 한계 절삭 안내처럼 한 조작에서
 * 여러 번 나오는 경고가 화면을 덮었다. 앞 토스트가 아직 떠 있는 동안 온 같은 문구는
 * 버린다. 문구가 다르거나 앞 토스트가 사라진 뒤라면 정상적으로 다시 뜬다.
 */
export function showToast(
  message: string,
  kind: ToastKind = "info",
  durationMs = 3000,
  /** 누르면 실행할 동작 — 지정하면 토스트가 클릭 대상이 된다(CAD 백업 되살리기 등). */
  onClick?: () => void,
): void {
  const key = `${kind}::${message}`;
  const now = Date.now();
  if (lastToast && lastToast.key === key && now < lastToast.until) return;
  lastToast = { key, until: now + durationMs };
  const toast = el("div", { className: `ui-toast ui-toast--${kind}`, text: message });
  if (onClick) {
    toast.style.cursor = "pointer";
    toast.addEventListener("click", () => {
      onClick();
      toast.remove();
    });
  }
  ensureToastContainer().append(toast);
  // 진입 애니메이션 트리거
  requestAnimationFrame(() => toast.classList.add("is-visible"));
  window.setTimeout(() => {
    toast.classList.remove("is-visible");
    window.setTimeout(() => toast.remove(), 200);
  }, durationMs);
}

/* -----------------------------------------------------------------------------
 * 6-1. 확인 대화상자 (Confirm) — window.confirm 대체
 *
 * 공용 헤드 브라우저(playwright 연결)는 네이티브 confirm/alert를 자동 취소해
 * 버려 [초기화] 같은 버튼이 죽은 것처럼 보였다(2026-08-19 진단). 화면 안 모달로
 * 확인을 받아 어느 실행 환경에서도 같은 동작을 보장한다.
 * -------------------------------------------------------------------------- */

/** 확인/취소 모달 — 확인이면 true. 네이티브 confirm 대신 반드시 이것을 쓴다. */
export function showConfirmDialog(
  message: string,
  confirmLabel = "확인",
  cancelLabel = "취소",
): Promise<boolean> {
  return new Promise((resolve) => {
    const overlay = el("div", { className: "ui-confirm" });
    const panel = el("div", { className: "ui-confirm__panel" });
    const text = el("p", { className: "ui-confirm__message", text: message });
    const actions = el("div", { className: "ui-confirm__actions" });
    const back = document.activeElement as HTMLElement | null; // 닫힐 때 초점을 돌려놓을 자리
    const done = (result: boolean): void => {
      overlay.remove();
      if (back?.isConnected && back !== document.body) back.focus({ preventScroll: true });
      resolve(result);
    };
    const cancel = createButton({
      label: cancelLabel,
      variant: "ghost",
      onClick: () => done(false),
    });
    actions.append(
      cancel,
      createButton({ label: confirmLabel, variant: "danger", onClick: () => done(true) }),
    );
    overlay.addEventListener("keydown", (ev) => {
      if (ev.key !== "Escape") return;
      ev.stopPropagation(); // 뒤 창 · 페이지 Esc 까지 닫지 않음
      done(false);
    });
    panel.append(text, actions);
    overlay.append(panel);
    document.body.append(overlay);
    cancel.focus(); // 창에 초점 — 뒤 칸에 글이 들어가지 않고 Esc 가 먹음
  });
}

/* -----------------------------------------------------------------------------
 * 7. 워크플로우 3단 레이아웃 셸 (frontend.md §2)
 *    상단 헤더 + 좌측 고정 패널 + 우측 뷰어 영역.
 * -------------------------------------------------------------------------- */

export interface WorkflowShellOptions {
  /** 상단 페이지 타이틀 (i18n 결과) */
  title: string;
}

export interface WorkflowShellHandle {
  root: HTMLDivElement;
  /** 좌측 입력 폼/설정 영역 (너비 고정) */
  leftPanel: HTMLDivElement;
  /** 우측 WebCAD 뷰어 / 결과 그리드 영역 */
  rightArea: HTMLDivElement;
}

export function createWorkflowShell(opts: WorkflowShellOptions): WorkflowShellHandle {
  // 상단 헤더
  const titleEl = el("h2", { className: "ui-wf__title", text: opts.title });
  const header = el("header", { className: "ui-wf__header", children: [titleEl] });
  const leftPanel = el("div", { className: "ui-wf__left" });
  const rightArea = el("div", { className: "ui-wf__right" });
  const bodyRow = el("div", { className: "ui-wf__body", children: [leftPanel, rightArea] });

  const root = el("div", { className: "ui-wf", children: [header, bodyRow] });
  return { root, leftPanel, rightArea };
}

/* -----------------------------------------------------------------------------
 * 7-1. 라인 차트 (Line Chart) — 시계열 데이터 SVG 렌더링
 *    외부 라이브러리 없이 인라인 SVG. 색상은 CSS 클래스 + theme.css 변수 참조.
 * -------------------------------------------------------------------------- */