/* ============================================================================= * 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"; // 차트·기본 스타일 조각은 파일이 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"; /** 요소 생성 + 속성/클래스/자식 일괄 설정 헬퍼 */ /* ----------------------------------------------------------------------------- * 1. 버튼 — 부품 「단추」 · 「아이콘 단추」는 `ui_template_button.ts`(552-2) · 부르는 길은 그대로 * -------------------------------------------------------------------------- */ /* ----------------------------------------------------------------------------- * 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; /** 좁은 자리(표 칸·좌측 패널)용 작은 크기 — 작은 고르기칸(compact)과 높이가 같음 */ compact?: boolean; } 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: opts.compact ? "ui-input ui-input--sm" : "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; /** 좁은 자리(표 칸·좌측 패널)용 작은 여백 */ compact?: boolean; /** 라벨이 없을 때 보조기기용 이름 */ ariaLabel?: string; } export interface SelectFieldHandle { root: HTMLDivElement; select: HTMLSelectElement; /** 선택지를 다시 채움 — value 가 목록에 없으면 첫 항목 */ setOptions: (options: { value: string; text: string }[], value?: string) => void; } 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: opts.compact ? "ui-select ui-select--sm" : "ui-select", attrs: opts.ariaLabel ? { "aria-label": opts.ariaLabel } : {}, }); const setOptions: SelectFieldHandle["setOptions"] = (options, value) => { select.replaceChildren( ...options.map((opt) => el("option", { attrs: { value: opt.value }, text: opt.text })), ); if (value !== undefined && options.some((opt) => opt.value === value)) select.value = value; }; setOptions(opts.options, opts.value); if (opts.disabled) select.disabled = true; if (opts.onChange) { select.addEventListener("change", () => opts.onChange!(select.value)); } root.append(select); return { root, select, setOptions }; } /* ----------------------------------------------------------------------------- * 3. 카드 / 패널 (Card) — design.md: white surface, 8px radius, shadow * -------------------------------------------------------------------------- */ // 부품 「카드」(552-3) = ui_template_card.ts — 부름 꼴 그대로 export { createCard, setCardSelected, type CardOptions } from "./ui_template_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로 참조 카운트 관리. * -------------------------------------------------------------------------- */ // 부품 「알림」(552-3) = ui_template_toast.ts — 부름 꼴 그대로 export { hideLoadingOverlay, setLoadingOverlayProgress, showLoadingOverlay, showToast, type ToastKind, } from "./ui_template_toast"; /* ----------------------------------------------------------------------------- * 6-1. 확인 대화상자 (Confirm) — window.confirm 대체 * * 공용 헤드 브라우저(playwright 연결)는 네이티브 confirm/alert를 자동 취소해 * 버려 [초기화] 같은 버튼이 죽은 것처럼 보였다(2026-08-19 진단). 화면 안 모달로 * 확인을 받아 어느 실행 환경에서도 같은 동작을 보장한다. * -------------------------------------------------------------------------- */ /** 확인/취소 모달 — 확인이면 true. 네이티브 confirm 대신 반드시 이것을 쓴다. */ export function showConfirmDialog( message: string, confirmLabel = "확인", cancelLabel = "취소", ): Promise { 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 변수 참조. * -------------------------------------------------------------------------- */