산점도 차트

산점도 — 두 변수의 상관관계 시각화. `groupKey`로 데이터를 자동 그룹핑해 시리즈별 다른 색 점으로 렌더.

API

Property	Type	기본값	설명
xKey	string	필수	X 좌표 키
yKey	string	필수	Y 좌표 키
groupKey	string	-	시리즈 그룹 키. 같은 값끼리 한 시리즈(같은 색)로 묶임
labels	Record<string, string>	-	groupKey 값 → 표시명 매핑
pointRadius	number	5	점 반지름 (px)
pointStyle	ScatterPointStyle \| ScatterPointStyle[]	'circle'	점 모양. 단일 값 또는 시리즈별 배열. 'circle' \| 'triangle' \| 'rect' \| 'rectRot' \| 'star' \| 'cross' \| 'crossRot' \| 'rectRounded' \| 'dash' \| 'line'
xUnit	string	-	X축 ticks suffix (예: "cm")
yUnit	string	-	Y축 ticks suffix (예: "kg")

Property	Type	기본값	설명
data	Record<string, unknown>[]	필수	차트 데이터 배열
height	number	300	차트 높이(px). 너비는 부모 100%
colors	readonly string[]	DEFAULT_COLORS	시리즈 컬러 팔레트 (navy/teal 기반 10색)
showGrid	boolean	true	그리드 표시 (Pie/Doughnut에는 무시)
showLegend	boolean	true	범례 표시
showTooltip	boolean	true	툴팁 표시
emptyState	ReactNode	-	빈 데이터일 때 표시
className	string	-	외부 wrapper className
valueFormat	'plain' \| 'comma' \| 'korean' \| (n: number) => string	'plain'	숫자 포맷 (tooltip / 라벨 / y축 tick 일관 적용). `korean` → 125만/1.2억, `comma` → 1,250,000, 함수로 단위 suffix 가능
a11yTable	boolean	true	접근성용 sr-only 데이터 테이블 자동 렌더 (스크린리더가 canvas 차트 데이터를 읽을 수 있게 함)
a11yCaption	string	-	sr-only 테이블 caption (스크린리더가 먼저 읽음)