Aislo/ui_template/ui_template_elements_chart.ts

/* =============================================================================
 * ui_template_elements_chart.ts
 * 공통 라인 차트 — 대시보드 리소스 그래프에 쓰는 SVG 꺾은선.
 *
 * `ui_template_elements.ts` 가 700줄을 넘어 떼어냈다(2026-09-04). 본체가 그대로
 * 다시 내보내므로 호출부의 import 경로는 바뀌지 않는다.
 * ========================================================================== */

import { el } from "./ui_template_elements_base";

export interface LineChartSeries {
  /** 범례에 표시할 이름 (i18n 결과 문자열) */
  name: string;
  /** y 값 배열 (x는 인덱스 순서, null은 결측으로 선 끊김) */
  values: (number | null)[];
  /** 선 색상 클래스 접미사: 0~3 (theme.css의 --color-chart-N 참조) */
  colorIndex?: 0 | 1 | 2 | 3;
}

export interface LineChartOptions {
  series: LineChartSeries[];
  /** x축 라벨 (values와 같은 길이 권장, 일부만 자동 선택 표기) */
  xLabels?: string[];
  /** y축 최대값 (기본: 100 = 퍼센트) */
  yMax?: number;
  /** y축 단위 접미사 (기본: "%") */
  yUnit?: string;
  /** 접근성 설명 */
  ariaLabel?: string;
  /** 커스텀 가상 가로폭 (기본: CHART_W = 640) */
  width?: number;
  /** 커스텀 가상 세로폭 (기본: CHART_H = 200) */
  height?: number;
}

const CHART_W = 640;
const CHART_H = 200;
const CHART_PAD = { top: 12, right: 12, bottom: 26, left: 36 };
const X_TICK_STEP = 3; // x축 라벨 표기 간격 (3개마다 1개 표시)

/** 유효 점들을 Catmull-Rom → 3차 베지어로 변환한 스플라인 path 데이터를 만든다. */
function splinePath(points: { x: number; y: number }[]): string {
  if (points.length === 0) return "";
  if (points.length === 1) return `M${points[0].x},${points[0].y}`;
  let d = `M${points[0].x.toFixed(1)},${points[0].y.toFixed(1)}`;
  for (let i = 0; i < points.length - 1; i += 1) {
    const p0 = points[i - 1] ?? points[i];
    const p1 = points[i];
    const p2 = points[i + 1];
    const p3 = points[i + 2] ?? p2;
    // Catmull-Rom (tension 1/6) → cubic Bézier 제어점
    const c1x = p1.x + (p2.x - p0.x) / 6;
    const c1y = p1.y + (p2.y - p0.y) / 6;
    const c2x = p2.x - (p3.x - p1.x) / 6;
    const c2y = p2.y - (p3.y - p1.y) / 6;
    d +=
      ` C${c1x.toFixed(1)},${c1y.toFixed(1)} ` +
      `${c2x.toFixed(1)},${c2y.toFixed(1)} ` +
      `${p2.x.toFixed(1)},${p2.y.toFixed(1)}`;
  }
  return d;
}

/** 시계열 스플라인 차트를 반환. 데이터가 없으면 안내 문구를 담은 빈 상태를 반환. */
export function createLineChart(opts: LineChartOptions): HTMLDivElement {
  const w = opts.width ?? CHART_W;
  const h = opts.height ?? CHART_H;
  const yMax = opts.yMax ?? 100;
  const yUnit = opts.yUnit ?? "%";
  const wrap = el("div", { className: "ui-chart" });

  const pointCount = Math.max(0, ...opts.series.map((s) => s.values.length));
  if (pointCount < 2) {
    wrap.append(el("div", { className: "ui-chart__empty", text: "—" }));
    wrap.setAttribute("data-empty", "true");
    return wrap;
  }

  const plotW = w - CHART_PAD.left - CHART_PAD.right;
  const plotH = h - CHART_PAD.top - CHART_PAD.bottom;
  const xAt = (i: number) => CHART_PAD.left + (plotW * i) / (pointCount - 1);
  const yAt = (v: number) => CHART_PAD.top + plotH * (1 - Math.min(v, yMax) / yMax);

  const svgNs = "http://www.w3.org/2000/svg";
  const svg = document.createElementNS(svgNs, "svg");
  svg.setAttribute("class", "ui-chart__svg");
  svg.setAttribute("viewBox", `0 0 ${w} ${h}`);
  svg.setAttribute("role", "img");
  svg.setAttribute("width", "100%");
  svg.setAttribute("height", "100%");
  svg.setAttribute("preserveAspectRatio", "none");
  if (opts.ariaLabel) svg.setAttribute("aria-label", opts.ariaLabel);

  // y축 그리드 + 라벨 (0, 25, 50, 75, 100%)
  for (let g = 0; g <= 4; g += 1) {
    const v = (yMax / 4) * g;
    const y = yAt(v);
    const line = document.createElementNS(svgNs, "line");
    line.setAttribute("class", "ui-chart__grid");
    line.setAttribute("x1", String(CHART_PAD.left));
    line.setAttribute("x2", String(w - CHART_PAD.right));
    line.setAttribute("y1", String(y));
    line.setAttribute("y2", String(y));
    svg.append(line);
    const tick = document.createElementNS(svgNs, "text");
    tick.setAttribute("class", "ui-chart__tick");
    tick.setAttribute("x", String(CHART_PAD.left - 6));
    tick.setAttribute("y", String(y + 4));
    tick.setAttribute("text-anchor", "end");
    tick.textContent = `${Math.round(v)}${yUnit}`;
    svg.append(tick);
  }

  // x축 라벨 (데이터 포인트 개수만큼, X_TICK_STEP 간격으로 표기) + 수직 점선 그리드
  if (opts.xLabels && opts.xLabels.length > 0) {
    const labels = opts.xLabels;
    const baseY = CHART_PAD.top + plotH;
    for (let idx = 0; idx < pointCount; idx += X_TICK_STEP) {
      const label = labels[idx];
      const x = xAt(idx);
      if (label !== undefined && label !== "") {
        // 수직 점선 그리드
        const vline = document.createElementNS(svgNs, "line");
        vline.setAttribute("class", "ui-chart__grid ui-chart__grid--vertical");
        vline.setAttribute("x1", String(x));
        vline.setAttribute("x2", String(x));
        vline.setAttribute("y1", String(CHART_PAD.top));
        vline.setAttribute("y2", String(baseY));
        svg.append(vline);
        // x축 라벨
        const tick = document.createElementNS(svgNs, "text");
        tick.setAttribute("class", "ui-chart__tick ui-chart__tick--x");
        tick.setAttribute("x", String(x));
        tick.setAttribute("y", String(baseY + 16));
        tick.setAttribute("text-anchor", "middle");
        tick.textContent = label;
        svg.append(tick);
      }
    }
  }

  // 시리즈별 스플라인 (null 구간은 연속 세그먼트로 나눠 각각 곡선 처리)
  for (const s of opts.series) {
    let segment: { x: number; y: number }[] = [];
    let d = "";
    const flush = () => {
      if (segment.length > 0) d += `${splinePath(segment)} `;
      segment = [];
    };
    s.values.forEach((v, i) => {
      if (v === null || v === undefined) {
        flush();
        return;
      }
      segment.push({ x: xAt(i), y: yAt(v) });
    });
    flush();
    const path = document.createElementNS(svgNs, "path");
    path.setAttribute("class", `ui-chart__line ui-chart__line--c${s.colorIndex ?? 0}`);
    path.setAttribute("d", d.trim());
    svg.append(path);
  }

  // 범례 (그래프 영역 우상단 오버레이)
  const legend = el("div", { className: "ui-chart__legend" });
  opts.series.forEach((s) => {
    legend.append(
      el("span", {
        className: `ui-chart__legend-item ui-chart__legend-item--c${s.colorIndex ?? 0}`,
        text: s.name,
      }),
    );
  });

  const plot = el("div", { className: "ui-chart__plot" });
  plot.append(svg, legend);
  wrap.append(plot);
  return wrap;
}

/* =============================================================================
 * 8. 기본 컴포넌트 스타일 주입 (injectBaseStyles)
 *    theme.css 변수만 참조. 앱 진입 시 1회 호출.
 * ========================================================================== */