From ee8bb13209037a789acc444ad57e0b70b7142dd5 Mon Sep 17 00:00:00 2001 From: kric_jspark Date: Thu, 26 Mar 2026 10:52:31 +0900 Subject: [PATCH] =?UTF-8?q?260326=5F02=5FENH:=20=ED=85=8C=EC=9D=B4?= =?UTF-8?q?=EB=B8=94=204=EC=A2=85=20=ED=86=B5=ED=95=A9=20=EB=B0=8F=20BaseT?= =?UTF-8?q?able=20=EC=83=9D=EC=84=B1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../lge-dashboard/combo/LeftChartTable.tsx | 264 ++-------------- .../lge-dashboard/combo/TopChartTable.tsx | 206 +++++-------- .../lge-dashboard/table/BaseDataTable.tsx | 152 ++++++++++ .../lge-dashboard/table/DataTable.tsx | 279 ++--------------- .../lge-dashboard/table/GaugeTable.tsx | 286 ++++++------------ .../table/core/BaseTableHeader.tsx | 31 ++ .../table/core/BaseTableRenderer.tsx | 90 ++++++ .../table/core/table-core.helpers.tsx | 247 +++++++++++++++ src/components/lge-dashboard/types.ts | 2 + 9 files changed, 760 insertions(+), 797 deletions(-) create mode 100644 src/components/lge-dashboard/table/BaseDataTable.tsx create mode 100644 src/components/lge-dashboard/table/core/BaseTableHeader.tsx create mode 100644 src/components/lge-dashboard/table/core/BaseTableRenderer.tsx create mode 100644 src/components/lge-dashboard/table/core/table-core.helpers.tsx diff --git a/src/components/lge-dashboard/combo/LeftChartTable.tsx b/src/components/lge-dashboard/combo/LeftChartTable.tsx index e3ab65f..c0b3e43 100644 --- a/src/components/lge-dashboard/combo/LeftChartTable.tsx +++ b/src/components/lge-dashboard/combo/LeftChartTable.tsx @@ -1,21 +1,15 @@ "use client"; -import React, { useMemo } from "react"; -import { cn, parseNumber } from "@/lib/utils"; -import type { DataColumn, SignStyle } from "../types"; -import SectionTitle from "../SectionTitle"; +import type React from "react"; import { TABLE_DIMENSIONS } from "@/components/lge-dashboard/chart/chart.config"; -import {isSampleRow, roundNumber} from "@/lib/lg-dashboard"; -import {SAMPLE_SIZE_NOTICE, UNIT_TEXT, VIEW_DECIMAL_POINT} from "@/const/lg-common.const"; +import { UNIT_TEXT } from "@/const/lg-common.const"; +import type { DataColumn, SignStyle } from "../types"; +import BaseDataTable from "../table/BaseDataTable"; type MergedChartCell = { - /** 차트를 삽입할 컬럼 key(해당 컬럼 td는 startRow에서만 렌더되고 rowSpan 적용) */ key: keyof T; - /** rowSpan 시작 row index (기본 0) */ startRowIndex?: number; - /** rowSpan 수 (기본: rows.length - startRowIndex) */ rowSpan?: number; - /** chart td 클래스 (예: lg-table__sep-r) */ className?: string; }; @@ -23,42 +17,17 @@ type Props> = { title?: string; columns: DataColumn[]; rows: T[]; - /** 머지된 셀 안에 렌더할 차트 */ chart: React.ReactNode; - /** 어떤 컬럼을 머지-차트 셀로 교체할지 */ chartCell: MergedChartCell; - - /** +/-/0 표기/색상 옵션(선택) */ signStyle?: SignStyle; - wrapperClassName?: string; tableClassName?: string; minWidthPx?: number; + minWidth?: number; starUnder30Sample?: boolean; unitText?: string; }; -// toNumber는 utils.ts의 parseNumber로 통합됨 - -function renderSigned( - n: number, - opts: { - display: "number" | "arrow"; - showPlus: boolean; - arrowWithNumber: boolean; - zeroText: string; - } -) { - if (n === 0) return opts.zeroText; - if (opts.display === "arrow") { - const arrow = n > 0 ? "▲" : "▼"; - const num = Math.abs(n); - return opts.arrowWithNumber ? `${arrow} ${num}` : arrow; - } - if (n > 0) return opts.showPlus ? `+${n}` : `${n}`; - return `${n}`; -} - export default function LeftChartTable>({ title, columns, @@ -69,207 +38,34 @@ export default function LeftChartTable>({ wrapperClassName, tableClassName, minWidthPx = TABLE_DIMENSIONS.MIN_WIDTH.COMPACT, + minWidth, starUnder30Sample = true, unitText = UNIT_TEXT, }: Props) { - const hasGroupHeader = useMemo( - () => columns.some((c) => c.group) || columns.some((c) => c.headRowSpan === 2), - [columns] - ); - - const groupCells = useMemo(() => { - if (!hasGroupHeader) return [] as Array< - | { kind: "rowspan"; label: string; colSpan: 1; rowSpan: 2; className?: string } - | { kind: "group"; label: string; colSpan: number; rowSpan: 1; className?: string } - | { kind: "blank"; label: string; colSpan: 1; rowSpan: 1; className?: string } - >; - - type Cell = - | { kind: "rowspan"; label: string; colSpan: 1; rowSpan: 2; className?: string } - | { kind: "group"; label: string; colSpan: number; rowSpan: 1; className?: string } - | { kind: "blank"; label: string; colSpan: 1; rowSpan: 1; className?: string }; - - const out: Cell[] = []; - let i = 0; - while (i < columns.length) { - const c = columns[i]; - if (c.headRowSpan === 2) { - out.push({ - kind: "rowspan", - label: c.header, - colSpan: 1, - rowSpan: 2, - className: c.headerClassName, - }); - i += 1; - continue; - } - - const g = c.group ?? ""; - if (!g) { - out.push({ kind: "blank", label: "", colSpan: 1, rowSpan: 1, className: c.headerClassName }); - i += 1; - continue; - } - - let span = 1; - while ( - i + span < columns.length && - (columns[i + span].headRowSpan ?? 1) !== 2 && - (columns[i + span].group ?? "") === g - ) { - span += 1; - } - - out.push({ kind: "group", label: g, colSpan: span, rowSpan: 1, className: columns[i + span -1].headerClassName }); - i += span; - } - return out; - }, [columns, hasGroupHeader]); - - const display = signStyle?.display ?? "number"; - const arrowWithNumber = signStyle?.arrowWithNumber ?? true; - const showPlus = signStyle?.showPlus ?? true; - const zeroText = signStyle?.zeroText ?? "-"; - const posCls = signStyle?.positiveTextClassName ?? "lg-num-pos"; - const negCls = signStyle?.negativeTextClassName ?? "lg-num-neg"; - const zeroCls = signStyle?.zeroTextClassName ?? ""; - - const start = chartCell.startRowIndex ?? 0; - const rowSpan = chartCell.rowSpan ?? Math.max(0, rows.length - start); - return ( -
-
- { title && } - { - (unitText || starUnder30Sample) && -
- {unitText} - {starUnder30Sample && <>
{SAMPLE_SIZE_NOTICE}} -
- } -
- -
- - - {hasGroupHeader ? ( - - {groupCells.map((g, idx) => ( - - ))} - - ) : null} - - - {columns - .filter((c) => (c.headRowSpan ?? 1) !== 2) - .map((c) => ( - - ))} - - - - - {rows.map((row, ri) => { - const sampleRow = isSampleRow(row.rowLabel as string ?? ""); - const isSignRow = signStyle?.rowSelector ? signStyle.rowSelector(row, ri) : false; - - return ( - - {columns.map((c) => { - // 머지-차트 셀 - if (c.key === chartCell.key && ri >= start) { - if (ri > start) return null; - return ( - - ); - } - - // 일반 셀 - const raw = c.key in row ? row[c.key] : undefined; - const content = c.render - ? c.render(row) - : raw === null || raw === undefined - ? "" - : typeof raw === "string" || typeof raw === "number" - ? raw - : String(raw); - - - const shouldSign = isSignRow && (signStyle?.keys ? signStyle.keys.includes(c.key) : !!c.numeric); - - if (c.rowHead) { - return ( - - ); - } - - if (!shouldSign) { - const numContent = c.numeric ? parseNumber(content) ?? 0 : 0; - const isStar = starUnder30Sample && sampleRow && numContent < 30; - - return ( - - ); - } - - const n = c.numeric ? roundNumber(parseNumber(raw)) : null; - // sign row: 값이 없으면 "-" 유지 - if (n === null) { - return ( - - ); - } - - - const cls = n > 0 ? posCls : n < 0 ? negCls : zeroCls; - const txt = renderSigned(n, { display, showPlus, arrowWithNumber, zeroText }); - - return ( - - ); - })} - - ); - })} - -
- {g.label} -
- {c.header} -
- {chart} - - {content} - - {isStar?`${content}*`: roundNumber(parseNumber(content))} - - - - - {txt} -
-
-
+ ); } diff --git a/src/components/lge-dashboard/combo/TopChartTable.tsx b/src/components/lge-dashboard/combo/TopChartTable.tsx index 1054597..767f141 100644 --- a/src/components/lge-dashboard/combo/TopChartTable.tsx +++ b/src/components/lge-dashboard/combo/TopChartTable.tsx @@ -3,172 +3,134 @@ import React, { useMemo } from "react"; import { cn, parseNumber } from "@/lib/utils"; import type { ChartData, SignStyle, TopChartTableRow } from "../types"; -import SectionTitle from "../SectionTitle"; import { CHART_HEIGHTS, TABLE_DIMENSIONS } from "@/components/lge-dashboard/chart/chart.config"; -import {UNIT_TEXT} from "@/const/lg-common.const"; -import {isCagrRow, roundNumber} from "@/lib/lg-dashboard"; +import { UNIT_TEXT } from "@/const/lg-common.const"; +import { isCagrRow } from "@/lib/lg-dashboard"; +import BaseTableHeader from "../table/core/BaseTableHeader"; +import { formatSignedValue, getSignTextClass, resolveSignStyle, toRoundedNumber } from "../table/core/table-core.helpers"; export type TopChartTableProps = { title?: string; categories: string[]; rows: TopChartTableRow[]; - /** 테이블 상단(헤더 1행) 콜스팬 셀 내부에 렌더될 차트 */ chart?: - | React.ReactNode - | ((ctx: { - /** 테이블 컬럼(=x축) 기준으로 구성된 ChartData */ - chartData: ChartData; - }) => React.ReactNode); - /** chart 셀 높이(px) */ - chartHeight?: number; - /** 가로 스크롤 min-width */ + | React.ReactNode + | ((ctx: { + chartData: ChartData; + }) => React.ReactNode); + chartHeight?: number | string; minWidthPx?: number; + minWidth?: number; tableClassName?: string; wrapperClassName?: string; - /** +/-/0 색상/표기 옵션(선택) */ signStyle?: SignStyle; fillCAGR?: boolean; unitText?: string; }; -// toNumber는 utils.ts의 parseNumber로 통합됨 -function formatSignedNumber(n: number, zeroText: string, showPlus: boolean) { - if (n === 0) return zeroText; - if (n > 0) return showPlus ? `+${n}` : `${n}`; - return `${n}`; -} +export default function TopChartTable({ + title, + rows, + categories, + chart, + chartHeight = CHART_HEIGHTS.DEFAULT, + minWidthPx = TABLE_DIMENSIONS.MIN_WIDTH.STANDARD, + minWidth, + tableClassName, + wrapperClassName, + signStyle, + fillCAGR = false, + unitText = UNIT_TEXT, +}: TopChartTableProps) { + const resolvedSignStyle = resolveSignStyle(signStyle, { + positiveTextClassName: "lg-num-pos", + negativeTextClassName: "lg-num-neg", + zeroTextClassName: "", + arrowWithNumber: true, + }); -type CellValue = TopChartTableRow["values"][number]; -function toCellValue(v: unknown): CellValue { - if (v === null || v === undefined) return v; - if (typeof v === "number" || typeof v === "string") return v; - return String(v); -} - -export default function TopChartTable(props: TopChartTableProps) { - const { - title, - rows, - categories, - chart, - chartHeight = CHART_HEIGHTS.DEFAULT, - minWidthPx = TABLE_DIMENSIONS.MIN_WIDTH.STANDARD, - tableClassName, - wrapperClassName, - signStyle, - fillCAGR = false, - unitText = UNIT_TEXT - } = props; - - const display = signStyle?.display ?? "number"; - const arrowWithNumber = signStyle?.arrowWithNumber ?? true; - const showPlus = signStyle?.showPlus ?? true; - const posCls = signStyle?.positiveTextClassName ?? "lg-num-pos"; - const negCls = signStyle?.negativeTextClassName ?? "lg-num-neg"; - const zeroText = signStyle?.zeroText ?? "-"; - - // 테이블 컬럼(=categories)을 x축으로 사용하는 chartData를 항상 제공 const chartData: ChartData = useMemo( - () => ({ - categories, - series: rows.map((r) => ({ - name: r.label, - data: r.values.map((v) => parseNumber(v) ?? null), - })), - }), - [categories, rows] + () => ({ + categories, + series: rows.map((row) => ({ + name: row.label, + data: row.values.map((value) => parseNumber(value) ?? null), + })), + }), + [categories, rows] ); const chartNode = useMemo(() => { - if (!chart) return null; + if (!chart) { + return null; + } return typeof chart === "function" ? chart({ chartData }) : chart; - }, [chart, chartData, categories, rows]); + }, [chart, chartData]); return ( -
-
- {title ? :
} - {unitText ?
{unitText}
: null} -
+
+ -
- - +
+
+ - {/* 좌상단: rowhead 헤더(필요 시 표시). HTML과 동일하게 2행 rowspan */} - + - {categories.map((c) => ( - + {categories.map((category) => ( + ))} - + - - {rows.map((r, ri) => { - const isSignRow = !!(signStyle?.rowSelector && signStyle.rowSelector(r, ri)); - const cagrRow = isCagrRow(r.label as string ?? ""); - const total = parseNumber(r.total); + + {rows.map((row, rowIndex) => { + const signRow = !!signStyle?.rowSelector?.(row, rowIndex); + const cagrRow = isCagrRow(row.label ?? ""); + const rowTotal = parseNumber(row.total); return ( - - + + - {categories.map((_, ci) => { - const raw = r.values?.[ci]; - const n = roundNumber(parseNumber(raw)); + {categories.map((_, categoryIndex) => { + const rawValue = row.values?.[categoryIndex]; + const roundedValue = toRoundedNumber(rawValue); - // 일반 행 - if (!isSignRow) { - if (n === null) return ; - - const isFill = fillCAGR && cagrRow && total && n > total + 5; - const txt = n.toLocaleString(); - - return ; + if (!signRow) { + if (roundedValue === null) { + return ; } - // sign row - if (n === null) return ; - if (n === 0) return ; + const shouldFillCell = fillCAGR && cagrRow && rowTotal !== null && roundedValue > rowTotal + 5; + return ; + } - const cls = n > 0 ? posCls : negCls; + if (roundedValue === null) { + return ; + } - if (display === "arrow") { - const arrow = n > 0 ? "▲" : "▼"; - const num = Math.abs(n); - return ( - - ); - } - - return ( - - ); - })} - + return ( + + ); + })} + ); })} - -
- - {chartNode ?
{chartNode}
: null}
{c} + {category} +
- {r.label} -
+ {row.label} + -{txt}--{zeroText}{roundedValue.toLocaleString()}- - {arrow} - {arrowWithNumber ? ` ${num}` : ""} - - {formatSignedNumber(n, zeroText, showPlus)} -
+ {formatSignedValue(roundedValue, resolvedSignStyle)} +
-
+ +
+
); } diff --git a/src/components/lge-dashboard/table/BaseDataTable.tsx b/src/components/lge-dashboard/table/BaseDataTable.tsx new file mode 100644 index 0000000..84ea332 --- /dev/null +++ b/src/components/lge-dashboard/table/BaseDataTable.tsx @@ -0,0 +1,152 @@ +"use client"; + +import type React from "react"; +import { cn, parseNumber } from "@/lib/utils"; +import { isSampleRow } from "@/lib/lg-dashboard"; +import type { DataColumn, SignStyle } from "../types"; +import BaseTableRenderer from "./core/BaseTableRenderer"; +import { + appendCellMarker, + formatSignedValue, + getColumnAlign, + getSignCellBackground, + getSignTextClass, + resolveSignStyle, + shouldApplySignToColumn, + toRoundedNumber, + toTableCellContent, + type ResolvedSignStyle, +} from "./core/table-core.helpers"; + +export type MergedTableCell = { + key: keyof T; + content: React.ReactNode; + startRowIndex?: number; + rowSpan?: number; + className?: string; +}; + +type Props> = { + columns: DataColumn[]; + rows: T[]; + title?: string; + wrapperClassName?: string; + tableClassName?: string; + minWidth?: number; + signStyle?: SignStyle; + signStyleFallback?: Partial; + fillGreaterThan5?: boolean; + starUnder30Sample?: boolean; + unitText?: string; + mergedCell?: MergedTableCell; +}; + +export default function BaseDataTable>({ + columns, + rows, + title, + wrapperClassName, + tableClassName, + minWidth, + signStyle, + signStyleFallback, + fillGreaterThan5 = false, + starUnder30Sample = false, + unitText, + mergedCell, +}: Props) { + const resolvedSignStyle = resolveSignStyle(signStyle, signStyleFallback); + const mergedCellStart = mergedCell?.startRowIndex ?? 0; + const mergedCellSpan = mergedCell?.rowSpan ?? Math.max(0, rows.length - mergedCellStart); + + return ( + + {rows.map((row, rowIndex) => { + const sampleRow = isSampleRow((row.rowLabel as string) ?? ""); + const signRow = !!signStyle?.rowSelector?.(row, rowIndex); + const rowTotal = parseNumber(row.total); + + return ( + + {columns.map((column) => { + if (mergedCell && column.key === mergedCell.key && rowIndex >= mergedCellStart) { + if (rowIndex > mergedCellStart) { + return null; + } + + return ( + + {mergedCell.content} + + ); + } + + const rawValue = row[column.key]; + const align = getColumnAlign(column); + const defaultContent = column.render ? column.render(row) : toTableCellContent(rawValue); + const numericValue = column.numeric ? parseNumber(rawValue ?? defaultContent) ?? 0 : 0; + const applySign = signRow && shouldApplySignToColumn(column, signStyle); + + if (column.rowHead) { + return ( + + {defaultContent} + + ); + } + + if (applySign) { + const roundedValue = toRoundedNumber(rawValue); + const displayText = roundedValue === null ? "-" : formatSignedValue(roundedValue, resolvedSignStyle); + const cellStyle: React.CSSProperties = + resolvedSignStyle.paint === "cell" + ? { textAlign: align, background: getSignCellBackground(roundedValue ?? 0, resolvedSignStyle) } + : { textAlign: align }; + + return ( + + + {displayText} + + + ); + } + + const shouldFillCell = fillGreaterThan5 && rowTotal !== null && numericValue > rowTotal + 5; + const shouldMarkSample = starUnder30Sample && sampleRow && numericValue < 30; + const displayContent = shouldMarkSample ? appendCellMarker(defaultContent, "*") : defaultContent; + + return ( + + {displayContent} + + ); + })} + + ); + })} + + ); +} diff --git a/src/components/lge-dashboard/table/DataTable.tsx b/src/components/lge-dashboard/table/DataTable.tsx index 9881604..3313b01 100644 --- a/src/components/lge-dashboard/table/DataTable.tsx +++ b/src/components/lge-dashboard/table/DataTable.tsx @@ -1,18 +1,15 @@ "use client"; -import { useMemo } from "react"; -import type React from "react"; -import { cn, parseNumber } from "@/lib/utils"; -import type { DataColumn, SignDisplayMode, SignStyle } from "../types"; -import SectionTitle from "../SectionTitle"; -import {isCagrRow, isSampleRow, roundNumber} from "@/lib/lg-dashboard"; -import {SAMPLE_SIZE_NOTICE, UNIT_TEXT} from "@/const/lg-common.const"; +import type { DataColumn, SignStyle } from "../types"; +import { UNIT_TEXT } from "@/const/lg-common.const"; +import BaseDataTable from "./BaseDataTable"; type Props> = { columns: DataColumn[]; rows: T[]; title?: string; className?: string; + tableClassName?: string; wrapperClassName?: string; signStyle?: SignStyle; fillGreaterThan5?: boolean; @@ -20,253 +17,31 @@ type Props> = { unitText?: string; }; -// parseSignedNumber는 utils.ts의 parseNumber로 통합됨 - -const defaultFmt = (v: number) => - Number.isInteger(v) ? String(roundNumber(v)) : v.toLocaleString(); - -const signText = ( - v: number, - display: SignDisplayMode, - showPlus: boolean, - arrowWithNumber: boolean, - fmt: (n: number) => string, - zeroText: string -) => { - if (display === "arrow") { - if (v > 0) return arrowWithNumber ? `▲ ${fmt(Math.abs(v))}` : "▲"; - if (v < 0) return arrowWithNumber ? `▼ ${fmt(Math.abs(v))}` : "▼"; - return zeroText; - } - - // number - if (v > 0) return showPlus ? `+${fmt(v)}` : fmt(v); - if (v < 0) return fmt(v); // 음수는 기본적으로 - 포함 - return zeroText; -}; - -const toCellContent = (raw: unknown): React.ReactNode => { - if (raw == null) return ""; - if (typeof raw === "string"){ - const trimmed = raw.trim(); - if (trimmed === "") return raw; - - const num = Number(trimmed); - return Number.isNaN(num) ? raw : roundNumber(num); - } - if (typeof raw === "number") return String(roundNumber(raw)); - return String(raw); -}; - const DataTable = >({ - columns, - rows, - title, - className, - wrapperClassName, - signStyle, - fillGreaterThan5 = false, - starUnder30Sample = false, - unitText = UNIT_TEXT, - }: Props) => { - const hasGroup = columns.some((c) => !!c.group) || columns.some((c) => c.headRowSpan === 2); - - // group header(1행): rowspan=2 컬럼(th) + group label(colspan) - const groupCells = useMemo(() => { - type GroupCell = - | { kind: "rowspan"; label: string; colSpan: 1; rowSpan: 2; className?: string } - | { kind: "group"; label: string; colSpan: number; rowSpan: 1; className?: string } - | { kind: "blank"; label: string; colSpan: 1; rowSpan: 1; className?: string }; - - if (!hasGroup) return [] as GroupCell[]; - - const res: GroupCell[] = []; - let i = 0; - - while (i < columns.length) { - const c = columns[i]; - - if (c.headRowSpan === 2) { - res.push({ kind: "rowspan", label: c.header, colSpan: 1, rowSpan: 2, className: c.headerClassName }); - i++; - continue; - } - - const g = c.group; - if (!g) { - // group 미지정: 1칸짜리 blank group 셀 - res.push({ kind: "blank", label: "", colSpan: 1, rowSpan: 1, className: c.headerClassName }); - i++; - continue; - } - - // 같은 group 연속 구간 colSpan - let span = 1; - let j = i + 1; - while (j < columns.length && columns[j].headRowSpan !== 2 && columns[j].group === g) { - span++; - j++; - } - res.push({ kind: "group", label: g, colSpan: span, rowSpan: 1, className: c.headerClassName }); - i = j; - } - - return res; - }, [columns, hasGroup]); - - const { - rowSelector, - keys, - paint = "text", - display = "number", - showPlus = true, - arrowWithNumber = false, - zeroText = "-", - valueFormatter, - positiveTextClassName = "text-primary font-semibold", - negativeTextClassName = "text-info font-semibold", - zeroTextClassName = "text-gray-600", - positiveCellBg = "hsl(var(--primary) / 0.08)", - negativeCellBg = "hsl(var(--info) / 0.08)", - zeroCellBg = "hsl(var(--lg-gray-200) / 0.6)", - } = signStyle ?? ({} as SignStyle); - - const fmt = valueFormatter ?? defaultFmt; - - const isSignRow = (row: T, rowIndex: number) => - !!signStyle && !!rowSelector?.(row, rowIndex); - - const isTargetKey = (k: keyof T) => { - if (!signStyle) return false; - if (keys && keys.length) return keys.includes(k); - // keys.ts 미지정이면 numeric 컬럼 전체 - const col = columns.find((c) => c.key === k); - return !!col?.numeric; - }; - - const signClass = (v: number) => { - if (v > 0) return positiveTextClassName; - if (v < 0) return negativeTextClassName; - return zeroTextClassName; - }; - - const signBg = (v: number) => { - if (v > 0) return positiveCellBg; - if (v < 0) return negativeCellBg; - return zeroCellBg; - }; - + columns, + rows, + title, + className, + tableClassName, + wrapperClassName, + signStyle, + fillGreaterThan5 = false, + starUnder30Sample = false, + unitText = UNIT_TEXT, +}: Props) => { return ( -
-
- { title && } - { - (unitText || starUnder30Sample) && -
- {unitText} - {starUnder30Sample && <>
{SAMPLE_SIZE_NOTICE}} -
- } -
- - - {hasGroup && ( - - {groupCells.map((g, idx) => ( - - ))} - - )} - - {columns - .filter((c) => c.headRowSpan !== 2) - .map((c) => ( - - ))} - - - - - {rows.map((row, rIdx) => { - const sampleRow = isSampleRow(row.rowLabel as string ?? ""); - const signRow = isSignRow(row, rIdx); - const total = parseNumber(row.total); - - return ( - - {columns.map((c) => { - const raw: unknown = c.key ? (row[c.key] as unknown) : undefined; - const align = c.align ?? (c.numeric ? "right" : "center"); - - // headRowSpan=2 컬럼은 thead 2행에서 제외되므로, tbody는 항상 렌더 - - // sign row + target column이면 색상/표기 적용 - const applySign = signRow && isTargetKey(c.key) && !c.rowHead; - - if (applySign) { - const n = roundNumber(parseNumber(raw)); - const displayText = - n === null ? "-" : signText(n, display, showPlus, arrowWithNumber, fmt, zeroText); - - const style: React.CSSProperties = - paint === "cell" - ? { textAlign: align, background: signBg(n ?? 0) } - : { textAlign: align }; - - return ( - - ); - } - - // 일반 셀 - const content: React.ReactNode = c.render - ? c.render(row) - : toCellContent(raw); - - if (c.rowHead) { - return ( - - ); - } - - const numContent = c.numeric ? parseNumber(content) ?? 0 : 0; - const isFill = fillGreaterThan5 && total && numContent > total + 5; - const isStar = starUnder30Sample && sampleRow && numContent < 30; - - return ( - - ); - })} - - ); - })} - -
- {g.label} -
- {c.header} -
- - {displayText} - - - {content} - - {isStar?`${content}*`:content} -
-
+ ); -} +}; export default DataTable; diff --git a/src/components/lge-dashboard/table/GaugeTable.tsx b/src/components/lge-dashboard/table/GaugeTable.tsx index 37f267f..bebec97 100644 --- a/src/components/lge-dashboard/table/GaugeTable.tsx +++ b/src/components/lge-dashboard/table/GaugeTable.tsx @@ -1,205 +1,113 @@ "use client"; -import React, { useMemo } from "react"; import { cn, parseNumber } from "@/lib/utils"; -import {GaugeColumn} from "../types"; -import {roundNumber} from "@/lib/lg-dashboard"; +import { roundNumber } from "@/lib/lg-dashboard"; +import type { GaugeColumn } from "../types"; +import BaseTableRenderer from "./core/BaseTableRenderer"; +import { getColumnAlign, toTableCellContent } from "./core/table-core.helpers"; type Props> = { columns: GaugeColumn[]; rows: T[]; className?: string; + tableClassName?: string; wrapperClassName?: string; - - /** value가 0~100이 아니라 0~1이면 scale=100 */ - scale?: number; // 기본 1 - - /** 색상(기본: primary 채움 + gray 트랙) */ - fillColor?: string; // ex) "hsl(var(--primary) / 0.9)" - trackColor?: string; // ex) "hsl(var(--lg-gray-200) / 0.9)" - - /** 셀 높이 */ - cellHeight?: number; // 기본 26 - - /** 숫자 표시 여부/포맷 */ - valueFormatter?: (v: number) => string; + scale?: number; + fillColor?: string; + trackColor?: string; + cellHeight?: number; + valueFormatter?: (value: number) => string; }; -// num은 utils.ts의 parseNumber로 통합됨 - const GaugeTable = >({ - columns, - rows, - className, - wrapperClassName, - scale = 1, - fillColor = "hsl(var(--lg-gray-200) / 0.85)", - trackColor = "hsl(var(--lg-pink-300) / 0.2)", - cellHeight = 26, - valueFormatter, - }: Props) => { - const hasGroup = columns.some((c) => !!c.group) || columns.some((c) => c.headRowSpan === 2); - - const groupCells = useMemo(() => { - type GroupCell = - | { kind: "rowspan"; label: string; colSpan: 1; rowSpan: 2; className?: string } - | { kind: "group"; label: string; colSpan: number; rowSpan: 1; className?: string } - | { kind: "blank"; label: string; colSpan: 1; rowSpan: 1; className?: string }; - - if (!hasGroup) return [] as GroupCell[]; - - const res: GroupCell[] = []; - let i = 0; - - while (i < columns.length) { - const c = columns[i]; - - if (c.headRowSpan === 2) { - res.push({ kind: "rowspan", label: c.header, colSpan: 1, rowSpan: 2 }); - i++; - continue; - } - - const g = c.group; - if (!g) { - // group 미지정: 1칸짜리 blank group 셀 - res.push({ kind: "blank", label: "", colSpan: 1, rowSpan: 1 }); - i++; - continue; - } - - // 같은 group 연속 구간 colSpan - let span = 1; - let j = i + 1; - while (j < columns.length && columns[j].headRowSpan !== 2 && columns[j].group === g) { - span++; - j++; - } - res.push({ kind: "group", label: g, colSpan: span, rowSpan: 1 }); - i = j; - } - - return res; - }, [columns, hasGroup]); - - const fmt = valueFormatter ?? ((v: number) => String(roundNumber(v))); - - const clamp01 = (n: number) => Math.max(0, Math.min(1, n)); + columns, + rows, + className, + tableClassName, + wrapperClassName, + scale = 1, + fillColor = "hsl(var(--lg-gray-200) / 0.85)", + trackColor = "hsl(var(--lg-pink-300) / 0.2)", + cellHeight = 26, + valueFormatter, +}: Props) => { + const formatValue = valueFormatter ?? ((value: number) => String(roundNumber(value))); + const clampRatio = (value: number) => Math.max(0, Math.min(1, value)); return ( -
- - - {columns.map((c, i) => ( - - ))} - - - {hasGroup && ( - - {groupCells.map((g, idx) => ( - - ))} - - )} - - {columns.filter((c) => c.headRowSpan !== 2).map((c) => ( - - ))} - - - - - {rows.map((row, rIdx) => ( - - {columns.map((c) => { - const align = c.align ?? (c.rowHead ? "left" : "center"); - const cellType = c.cellType ?? "gauge"; - - if (c.rowHead) { - const raw = row[c.key]; - const label = c.render - ? c.render(row) - : raw === null || raw === undefined - ? "" - : typeof raw === "string" || typeof raw === "number" - ? raw - : String(raw); - return ( - - ); - } - - const raw = row[c.key]; - const v = parseNumber(raw); - const max = c.max ?? 100; - const ratio = v === null ? 0 : clamp01((v * scale) / max); - const pct = ratio * 100; - - const fill = fillColor; - const track = trackColor; - - const cellBg = - v === null - ? undefined - : `linear-gradient(to right, ${fill} ${pct}%, ${track} 0%)`; - - if (cellType === "number") { - return ( - - ); - } - - return ( - - ); - })} - + + {columns.map((column, index) => ( + ))} - -
- {g.label} -
- {c.header} -
- {label} - - {v === null ? "-" : fmt(v)} - - {v === null ? "-" : fmt(v)} -
-
- ); -} + + } + > + {rows.map((row, rowIndex) => ( + + {columns.map((column) => { + const align = getColumnAlign(column); -export default GaugeTable; \ No newline at end of file + if (column.rowHead) { + const content = column.render ? column.render(row) : toTableCellContent(row[column.key]); + return ( + + {content} + + ); + } + + const rawValue = row[column.key]; + const numericValue = parseNumber(rawValue); + const max = column.max ?? 100; + const ratio = numericValue === null ? 0 : clampRatio((numericValue * scale) / max); + const percentage = ratio * 100; + const background = + numericValue === null ? undefined : `linear-gradient(to right, ${fillColor} ${percentage}%, ${trackColor} 0%)`; + + if ((column.cellType ?? "gauge") === "number") { + return ( + + {numericValue === null ? "-" : formatValue(numericValue)} + + ); + } + + return ( + + {numericValue === null ? "-" : formatValue(numericValue)} + + ); + })} + + ))} + + ); +}; + +export default GaugeTable; diff --git a/src/components/lge-dashboard/table/core/BaseTableHeader.tsx b/src/components/lge-dashboard/table/core/BaseTableHeader.tsx new file mode 100644 index 0000000..8d9d793 --- /dev/null +++ b/src/components/lge-dashboard/table/core/BaseTableHeader.tsx @@ -0,0 +1,31 @@ +import SectionTitle from "../../SectionTitle"; +import { SAMPLE_SIZE_NOTICE } from "@/const/lg-common.const"; + +type Props = { + title?: string; + unitText?: string; + showSampleNotice?: boolean; +}; + +export default function BaseTableHeader({ title, unitText, showSampleNotice = false }: Props) { + if (!title && !unitText && !showSampleNotice) { + return null; + } + + return ( +
+ {title ? :
} + {unitText || showSampleNotice ? ( +
+ {unitText} + {showSampleNotice ? ( + <> +
+ {SAMPLE_SIZE_NOTICE} + + ) : null} +
+ ) : null} +
+ ); +} diff --git a/src/components/lge-dashboard/table/core/BaseTableRenderer.tsx b/src/components/lge-dashboard/table/core/BaseTableRenderer.tsx new file mode 100644 index 0000000..5497719 --- /dev/null +++ b/src/components/lge-dashboard/table/core/BaseTableRenderer.tsx @@ -0,0 +1,90 @@ +"use client"; + +import type React from "react"; +import { cn } from "@/lib/utils"; +import BaseTableHeader from "./BaseTableHeader"; +import { buildGroupHeaderCells, hasGroupedHeader } from "./table-core.helpers"; + +type BaseColumn = { + key: keyof T; + header: string; + width?: number | string; + group?: string; + headRowSpan?: 1 | 2; + headerClassName?: string; +}; + +type Props = { + columns: BaseColumn[]; + title?: string; + unitText?: string; + showSampleNotice?: boolean; + wrapperClassName?: string; + tableClassName?: string; + minWidth?: number | string; + colgroup?: React.ReactNode; + renderHeaderPrefix?: React.ReactNode; + children: React.ReactNode; +}; + +export default function BaseTableRenderer({ + columns, + title, + unitText, + showSampleNotice = false, + wrapperClassName, + tableClassName, + minWidth, + colgroup, + renderHeaderPrefix, + children, +}: Props) { + const groupedHeader = hasGroupedHeader(columns); + const groupHeaderCells = buildGroupHeaderCells(columns); + + return ( +
+ + +
+ + {colgroup} + + {renderHeaderPrefix} + {groupedHeader ? ( + + {groupHeaderCells.map((cell, index) => ( + + ))} + + ) : null} + + {columns + .filter((column) => column.headRowSpan !== 2) + .map((column) => ( + + ))} + + + {children} +
+ {cell.label} +
+ {column.header} +
+
+
+ ); +} diff --git a/src/components/lge-dashboard/table/core/table-core.helpers.tsx b/src/components/lge-dashboard/table/core/table-core.helpers.tsx new file mode 100644 index 0000000..3ed0c38 --- /dev/null +++ b/src/components/lge-dashboard/table/core/table-core.helpers.tsx @@ -0,0 +1,247 @@ +import type React from "react"; +import { parseNumber } from "@/lib/utils"; +import { roundNumber } from "@/lib/lg-dashboard"; +import type { SignDisplayMode, SignStyle, ValueFormatter } from "../../types"; + +type BaseTableColumn = { + key: keyof T; + header: string; + width?: number | string; + align?: "left" | "center" | "right"; + group?: string; + headRowSpan?: 1 | 2; + rowHead?: boolean; + numeric?: boolean; + headerClassName?: string; + cellClassName?: string; +}; + +export type GroupHeaderCell = { + kind: "rowspan" | "group" | "blank"; + label: string; + colSpan: number; + rowSpan: number; + className?: string; +}; + +export type ResolvedSignStyle = { + paint: "text" | "cell"; + display: SignDisplayMode; + showPlus: boolean; + arrowWithNumber: boolean; + zeroText: string; + valueFormatter: ValueFormatter; + positiveTextClassName: string; + negativeTextClassName: string; + zeroTextClassName: string; + positiveCellBg: string; + negativeCellBg: string; + zeroCellBg: string; +}; + +const defaultValueFormatter: ValueFormatter = (value) => + Number.isInteger(value) ? String(roundNumber(value)) : value.toLocaleString(); + +const defaultSignStyle: ResolvedSignStyle = { + paint: "text", + display: "number", + showPlus: true, + arrowWithNumber: false, + zeroText: "-", + valueFormatter: defaultValueFormatter, + positiveTextClassName: "text-primary font-semibold", + negativeTextClassName: "text-info font-semibold", + zeroTextClassName: "text-gray-600", + positiveCellBg: "hsl(var(--primary) / 0.08)", + negativeCellBg: "hsl(var(--info) / 0.08)", + zeroCellBg: "hsl(var(--lg-gray-200) / 0.6)", +}; + +export function hasGroupedHeader(columns: BaseTableColumn[]) { + return columns.some((column) => column.group) || columns.some((column) => column.headRowSpan === 2); +} + +export function buildGroupHeaderCells(columns: BaseTableColumn[]) { + if (!hasGroupedHeader(columns)) { + return [] as GroupHeaderCell[]; + } + + const cells: GroupHeaderCell[] = []; + let index = 0; + + while (index < columns.length) { + const column = columns[index]; + + if (column.headRowSpan === 2) { + cells.push({ + kind: "rowspan", + label: column.header, + colSpan: 1, + rowSpan: 2, + className: column.headerClassName, + }); + index += 1; + continue; + } + + if (!column.group) { + cells.push({ + kind: "blank", + label: "", + colSpan: 1, + rowSpan: 1, + className: column.headerClassName, + }); + index += 1; + continue; + } + + let span = 1; + let cursor = index + 1; + while (cursor < columns.length && columns[cursor].headRowSpan !== 2 && columns[cursor].group === column.group) { + span += 1; + cursor += 1; + } + + cells.push({ + kind: "group", + label: column.group, + colSpan: span, + rowSpan: 1, + className: column.headerClassName, + }); + index = cursor; + } + + return cells; +} + +export function getColumnAlign(column: BaseTableColumn, fallback: "left" | "center" | "right" = "center") { + if (column.align) { + return column.align; + } + + if (column.numeric) { + return "right"; + } + + if (column.rowHead) { + return "left"; + } + + return fallback; +} + +export function toTableCellContent(raw: unknown): React.ReactNode { + if (raw == null) { + return ""; + } + + if (typeof raw === "string") { + const trimmed = raw.trim(); + if (!trimmed) { + return raw; + } + + const parsed = Number(trimmed); + return Number.isNaN(parsed) ? raw : roundNumber(parsed); + } + + if (typeof raw === "number") { + return String(roundNumber(raw)); + } + + return String(raw); +} + +export function toRoundedNumber(raw: unknown) { + const parsed = parseNumber(raw); + return parsed === null ? null : roundNumber(parsed); +} + +export function appendCellMarker(content: React.ReactNode, marker: string) { + if (!marker) { + return content; + } + + if (typeof content === "string" || typeof content === "number") { + return `${content}${marker}`; + } + + return ( + <> + {content} + {marker} + + ); +} + +export function resolveSignStyle(signStyle?: SignStyle, fallback?: Partial) { + return { + ...defaultSignStyle, + ...fallback, + ...signStyle, + valueFormatter: signStyle?.valueFormatter ?? fallback?.valueFormatter ?? defaultSignStyle.valueFormatter, + }; +} + +export function shouldApplySignToColumn(column: BaseTableColumn, signStyle?: SignStyle) { + if (!signStyle || column.rowHead) { + return false; + } + + if (signStyle.keys?.length) { + return signStyle.keys.includes(column.key); + } + + return !!column.numeric; +} + +export function formatSignedValue( + value: number, + options: Pick +) { + if (options.display === "arrow") { + if (value > 0) { + return options.arrowWithNumber ? `▲ ${options.valueFormatter(Math.abs(value))}` : "▲"; + } + if (value < 0) { + return options.arrowWithNumber ? `▼ ${options.valueFormatter(Math.abs(value))}` : "▼"; + } + return options.zeroText; + } + + if (value > 0) { + return options.showPlus ? `+${options.valueFormatter(value)}` : options.valueFormatter(value); + } + if (value < 0) { + return options.valueFormatter(value); + } + return options.zeroText; +} + +export function getSignTextClass( + value: number, + options: Pick +) { + if (value > 0) { + return options.positiveTextClassName; + } + if (value < 0) { + return options.negativeTextClassName; + } + return options.zeroTextClassName; +} + +export function getSignCellBackground( + value: number, + options: Pick +) { + if (value > 0) { + return options.positiveCellBg; + } + if (value < 0) { + return options.negativeCellBg; + } + return options.zeroCellBg; +} diff --git a/src/components/lge-dashboard/types.ts b/src/components/lge-dashboard/types.ts index 845ea14..aefe79c 100644 --- a/src/components/lge-dashboard/types.ts +++ b/src/components/lge-dashboard/types.ts @@ -86,6 +86,8 @@ export type GaugeColumn = { max?: number; render?: (row: T) => React.ReactNode; // rowHead에 쓰기 좋음 cellType?: "gauge" | "number"; // default: "gauge" + headerClassName?: string; + cellClassName?: string; }; export type SignDisplayMode = "number" | "arrow";