Files
Aislo/ui_template/ui_template_elements.ts
T

144 lines
6.7 KiB
TypeScript

/* =============================================================================
* 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";
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
* -------------------------------------------------------------------------- */
// 부품 「카드」(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<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 변수 참조.
* -------------------------------------------------------------------------- */