Aislo/ui_template/ui_template_elements_chart.ts

/* =============================================================================
 * ui_template_elements_chart.ts
 * 부품 「작은 그래프」(552-3 · 목록 31) — 막대 · 원(도넛) · 선.
 *   꼴   = 가로 막대(`createBarChart` · 이름 · 막대 · 값) · 원(`createDonut` · 가운데 합 · 옆 범례) · 선(`createLineChart` · 아래)
 *   크기 = 막대 줄 22 · 원 지름 96 · 선 640 × 200 가상 폭(폭 100 %)
 *   상태 = 기본 · 빈 값이면 「자료 없음」(`.ui-chart__empty`)
 *   색   = 갈래 0~3 = `--color-chart-N` · 그 밖 색은 부르는 쪽이 CSS 값 글(`var(--…)`)로 줌
 *   쓰는 법 = `createBarChart([{ label: "산림설계", value: 12 }])` · `createDonut([{ label: "임도", value: 5, color: "var(--color-chart-1)" }])`
 *   대신하는 옛 변종 = B01 `.b01-home__bars` · `__donut` · `.b01-sys-chart` · `.b01-home__thumb`
 *
 * 공통 라인 차트 — 대시보드 리소스 그래프에 쓰는 SVG 꺾은선.
 *
 * `ui_template_elements.ts` 가 700줄을 넘어 떼어냈다(2026-09-04). 본체가 그대로
 * 다시 내보내므로 호출부의 import 경로는 바뀌지 않는다.
 * ========================================================================== */

import { el } from "./ui_template_elements_base";
import { createLegend } from "./ui_template_flow_legend";
import "./ui_template_elements_chart.css";

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회 호출.
 * ========================================================================== */

const SVG_NS_CHART = "http://www.w3.org/2000/svg";

function svgNode<K extends keyof SVGElementTagNameMap>(
  tag: K,
  attrs: Record<string, string | number>,
): SVGElementTagNameMap[K] {
  const n = document.createElementNS(SVG_NS_CHART, tag);
  for (const [k, v] of Object.entries(attrs)) n.setAttribute(k, String(v));
  return n;
}

export interface ChartItem {
  label: string;
  value: number;
  /** CSS 색 값 글(`var(--color-chart-2)`) — 없으면 갈래 차례(--color-chart-N) */
  color?: string;
}

const chartColor = (item: ChartItem, i: number): string =>
  item.color ?? `var(--color-chart-${i % 4})`;

const emptyChart = (): HTMLDivElement =>
  el("div", {
    className: "ui-chart ui-chart--mini",
    children: [el("div", { className: "ui-chart__empty", text: "자료 없음" })],
  });

/** 가로 막대 — 이름 · 막대 · 값 · 줄 22 */
export function createBarChart(items: ChartItem[], color?: string): HTMLDivElement {
  if (!items.length) return emptyChart();
  const max = Math.max(1, ...items.map((r) => r.value));
  const rowH = 22;
  const svg = svgNode("svg", {
    class: "ui-mini-bars",
    viewBox: `0 0 320 ${items.length * rowH}`,
    width: "100%",
    preserveAspectRatio: "xMinYMin meet",
    role: "img",
  });
  items.forEach((r, i) => {
    const y = i * rowH;
    const width = (r.value / max) * 180;
    const name = svgNode("text", { x: 0, y: y + 14 });
    name.textContent = r.label.length > 9 ? `${r.label.slice(0, 9)}…` : r.label;
    const count = svgNode("text", { x: 96 + width, y: y + 14 });
    count.textContent = String(r.value);
    const bar = svgNode("rect", { x: 90, y: y + 4, width, height: 12, rx: 3 });
    bar.style.fill = r.color ?? color ?? "var(--color-accent)";
    svg.append(name, bar, count);
  });
  return el("div", {
    className: "ui-chart ui-chart--mini",
    children: [svg as unknown as HTMLElement],
  });
}

/** 원(도넛) — 가운데 = 합 · 옆 = 범례 */
export function createDonut(items: ChartItem[]): HTMLDivElement {
  const total = items.reduce((a, r) => a + Math.max(0, r.value), 0);
  if (!total) return emptyChart();
  const svg = svgNode("svg", {
    class: "ui-mini-donut",
    viewBox: "0 0 42 42",
    width: 96,
    height: 96,
  });
  svg.append(svgNode("circle", { cx: 21, cy: 21, r: 15.9155, class: "ui-mini-donut__track" }));
  let start = 0;
  items.forEach((r, i) => {
    const pct = (Math.max(0, r.value) / total) * 100;
    const arc = svgNode("circle", {
      cx: 21,
      cy: 21,
      r: 15.9155,
      "stroke-dasharray": `${pct} ${100 - pct}`,
      "stroke-dashoffset": 25 - start,
    });
    arc.style.stroke = chartColor(r, i);
    svg.append(arc);
    start += pct;
  });
  const sum = svgNode("text", { x: 21, y: 24, "text-anchor": "middle" });
  sum.textContent = String(total);
  svg.append(sum);
  const legend = createLegend(
    items.map((r, i) => ({ label: `${r.label} ${r.value}`, color: chartColor(r, i) })),
    {
      vertical: true,
    },
  );
  return el("div", {
    className: "ui-chart ui-chart--mini ui-mini-donut-row",
    children: [svg as unknown as HTMLElement, legend],
  });
}