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";

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

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


/* -----------------------------------------------------------------------------
 * 1. 버튼 (Button) — design.md: Filled Brand / Ghost Outlined / Pill Nav
 * -------------------------------------------------------------------------- */

export type ButtonVariant = "filled" | "ghost" | "pill" | "danger" | "glass";

export interface ButtonOptions {
  /** 표시 텍스트 (i18n 결과 문자열을 전달) */
  label: string;
  variant?: ButtonVariant;
  /** 이벤트 핸들러 (frontend.md §4: on[페이지]_[기능]_[액션] 명명) */
  onClick?: (ev: MouseEvent) => void;
  disabled?: boolean;
  type?: "button" | "submit" | "reset";
  /** 앞쪽 아이콘 요소 (선택) */
  iconStart?: HTMLElement;
}

export function createButton(opts: ButtonOptions): HTMLButtonElement {
  const variant = opts.variant ?? "filled";
  const btn = el("button", {
    className: `ui-btn ui-btn--${variant}`,
    attrs: { type: opts.type ?? "button" },
  });
  if (opts.iconStart) {
    opts.iconStart.classList.add("ui-btn__icon");
    btn.append(opts.iconStart);
  }
  btn.append(el("span", { className: "ui-btn__label", text: opts.label }));
  if (opts.disabled) btn.disabled = true;
  if (opts.onClick) btn.addEventListener("click", opts.onClick);
  return btn;
}

/* -----------------------------------------------------------------------------
 * 2. 입력 필드 (Input Field) — design.md: 1px mist border, 8px radius, focus ring
 * -------------------------------------------------------------------------- */

export interface InputFieldOptions {
  /** 라벨 텍스트 (i18n 결과) */
  label?: string;
  /** placeholder (i18n 결과) */
  placeholder?: string;
  type?: "text" | "password" | "email" | "number" | "search" | "tel" | "date";
  value?: string;
  required?: boolean;
  /** number 타입 범위 (1차 유효성 검사용, frontend.md §4) */
  min?: number;
  max?: number;
  onInput?: (value: string) => void;
}

export interface InputFieldHandle {
  /** 필드 컨테이너 (라벨 + 입력 + 에러 슬롯) */
  root: HTMLDivElement;
  input: HTMLInputElement;
  /** 에러 메시지 표시/해제. msg가 없으면 에러 해제. */
  setError: (msg?: string) => void;
}

export function createInputField(opts: InputFieldOptions): InputFieldHandle {
  const root = el("div", { className: "ui-field" });

  if (opts.label) {
    root.append(el("label", { className: "ui-field__label", text: opts.label }));
  }

  const input = el("input", {
    className: "ui-input",
    attrs: {
      type: opts.type ?? "text",
      ...(opts.placeholder ? { placeholder: opts.placeholder } : {}),
      ...(opts.required ? { required: "true" } : {}),
      ...(opts.min !== undefined ? { min: String(opts.min) } : {}),
      ...(opts.max !== undefined ? { max: String(opts.max) } : {}),
    },
  });
  if (opts.value !== undefined) input.value = opts.value;
  if (opts.onInput) {
    input.addEventListener("input", () => opts.onInput!(input.value));
  }

  // 에러 메시지 슬롯 (입력창 하단 표기, frontend.md §4)
  const errorSlot = el("span", { className: "ui-field__error", attrs: { role: "alert" } });

  root.append(input, errorSlot);

  const setError = (msg?: string): void => {
    if (msg) {
      input.classList.add("ui-input--error");
      errorSlot.textContent = msg;
      errorSlot.classList.add("is-visible");
    } else {
      input.classList.remove("ui-input--error");
      errorSlot.textContent = "";
      errorSlot.classList.remove("is-visible");
    }
  };

  return { root, input, setError };
}

/* -----------------------------------------------------------------------------
 * 2-1. 드롭다운 필드 (Select Field) — design.md: input과 조화되는 8px radius, focus
 * -------------------------------------------------------------------------- */

export interface SelectFieldOptions {
  /** 라벨 텍스트 */
  label?: string;
  /** 옵션 항목 목록 */
  options: { value: string; text: string }[];
  /** 초기 선택값 */
  value?: string;
  onChange?: (value: string) => void;
  disabled?: boolean;
}

export interface SelectFieldHandle {
  root: HTMLDivElement;
  select: HTMLSelectElement;
}

export function createSelectField(opts: SelectFieldOptions): SelectFieldHandle {
  const root = el("div", { className: "ui-field" });

  if (opts.label) {
    root.append(el("label", { className: "ui-field__label", text: opts.label }));
  }

  const select = el("select", {
    className: "ui-select",
  });

  for (const opt of opts.options) {
    const optEl = el("option", {
      attrs: { value: opt.value },
      text: opt.text,
    });
    if (opts.value !== undefined && opt.value === opts.value) {
      optEl.selected = true;
    }
    select.append(optEl);
  }

  if (opts.disabled) select.disabled = true;

  if (opts.onChange) {
    select.addEventListener("change", () => opts.onChange!(select.value));
  }

  root.append(select);

  return { root, select };
}

/* -----------------------------------------------------------------------------
 * 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;

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

/* -----------------------------------------------------------------------------
 * 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 = "확인"): 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 done = (result: boolean): void => {
      overlay.remove();
      resolve(result);
    };
    actions.append(
      createButton({ label: "취소", variant: "ghost", onClick: () => done(false) }),
      createButton({ label: confirmLabel, variant: "danger", onClick: () => done(true) }),
    );
    panel.append(text, actions);
    overlay.append(panel);
    document.body.append(overlay);
  });
}

/* -----------------------------------------------------------------------------
 * 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 변수 참조.
 * -------------------------------------------------------------------------- */