@moda-chart/core 0.1.2

package/dist/types.d.ts

@@ -0,0 +1,1881 @@
+/**
+ * @moda-chart/core 타입 정의.
+ *
+ * 코어는 옵션(데이터 + 설정)을 받아 불변 스냅샷(렌더 모델)을 발행한다.
+ * 어댑터는 스냅샷을 같은 DOM 계약(mc-* 클래스)으로 그리기만 한다.
+ */
+/** 차트 타입 — 시리즈별 override 가능 */
+export type ChartType = "radar" | "radar-area" | "range-bar" | "range-area" | "candlestick" | "ohlc" | "boxplot" | "histogram" | "line" | "step" | "spline" | "area" | "bar" | "stacked-bar" | "percent-stacked-bar" | "waterfall" | "pie" | "donut" | "funnel" | "cone-funnel" | "pyramid" | "scatter" | "bubble" | "heatmap" | "wordcloud" | "map" | "sunburst" | "treemap" | "organization" | "sankey" | "chord" | "nightingale" | "radial-bar" | "radial-column" | "gauge" | "linear-gauge" | "pictogram" | "population-pyramid";
+/** 스케일 종류 — x는 band/linear/time, y는 linear/log */
+export type ScaleKind = "linear" | "log" | "time" | "band";
+export type AxisPosition = "left" | "right" | "bottom" | "top";
+export type LegendPosition = "top" | "bottom" | "left" | "right" | "none";
+export type TooltipMode = "point" | "shared" | "none";
+export type ChartTheme = "light" | "dark";
+/** 내장 문구 로케일 — ko면 emptyText/툴바 버튼이 한국어 */
+export type ChartLocale = "ko" | "en";
+export type ChartDirection = "vertical" | "horizontal";
+/**
+ * x축 카테고리 값 — 문자열은 band, number는 linear, Date는 time.
+ * 배열이면 그룹 카테고리(AG Charts grouped category axis 해당) —
+ * 마지막 요소가 리프 라벨, 앞 요소는 그룹 라벨로 두 번째 틱 행에 표시된다.
+ */
+export type CategoryValue = string | number | Date | readonly (string | number | Date)[];
+/** 산점도/시계열용 명시 포인트 */
+export interface ChartPointInput {
+    x: number | string | Date;
+    y: number | null;
+    /** 버블 차트 크기 값 — 반지름은 전체 버블의 최대 z 대비 sqrt로 스케일된다 */
+    z?: number;
+    /** 포인트 고정 색 — IBChart pointColor 해당. itemStyle보다 우선순위 낮음 */
+    color?: string;
+    /** 포인트 이름 — 툴팁/라벨/aria에 카테고리 라벨 대신 표시 (pointName 해당) */
+    name?: string;
+    /**
+     * 포인트 부가 데이터 — IBChart etcData 해당. 툴팁 컨텍스트와
+     * pointSelect 이벤트에 그대로 전달된다 (코드표/원문 키 등).
+     */
+    etcData?: unknown;
+}
+/** boxplot 입력 — 카테고리별 [최소, Q1, 중앙값, Q3, 최대] */
+export type ChartBoxInput = readonly [
+    min: number,
+    q1: number,
+    median: number,
+    q3: number,
+    max: number
+];
+/**
+ * 포인트 스타일 콜백 결과 — AG Charts itemStyler 해당.
+ * color는 시리즈 색을 덮는 포인트 고정색, name은 라벨 대체 이름이다.
+ */
+export interface ItemStyle {
+    color?: string;
+    name?: string;
+}
+/** itemStyle 콜백 입력 — 렌더되는 포인트/슬라이스 단위 */
+export interface ItemStyleContext {
+    seriesId: string;
+    /** 데이터 인덱스 — 슬라이스 타입은 카테고리 인덱스 */
+    index: number;
+    value: number | null;
+    /** 기본 라벨 (카테고리/포인트 이름) */
+    label: string;
+}
+/** 지도 마커 — 경도/위도 포인트 레이어 (AG Charts map-marker 해당) */
+export interface ChartMapPoint {
+    /** 경도 (degree) */
+    lon: number;
+    /** 위도 (degree) */
+    lat: number;
+    /** 버블 크기 값 — 있으면 전체 마커의 최대 대비 sqrt 스케일 */
+    value?: number;
+    /** 툴팁/라벨 이름 — 기본 "lon, lat" */
+    label?: string;
+    /** 마커 고정 색 */
+    color?: string;
+    /**
+     * 아바타 이미지 URL — 있으면 원형 클립 이미지 마커(.mc-map-avatar)로
+     * 렌더된다. 사용자 지도(프로필 핀) 용도. data URI도 허용.
+     */
+    image?: string;
+    /**
+     * 내 위치 표시 — 마커 주위에 펄스 링(.mc-map-pulse)을 애니메이션한다.
+     */
+    pulse?: boolean;
+}
+/** 지도 라인 — 두 좌표를 잇는 연결선 (AG Charts map-line 해당) */
+export interface ChartMapLine {
+    from: readonly [lon: number, lat: number];
+    to: readonly [lon: number, lat: number];
+    label?: string;
+}
+/** 입력 시리즈 — values는 categories와 인덱스 정렬, points는 명시 좌표 */
+export interface ChartSeriesInput {
+    name?: string;
+    /** 고정 색. 없으면 팔레트(--chart-palette-N) 순환 */
+    color?: string;
+    /** 차트 타입 override (혼합 차트) */
+    type?: ChartType;
+    /** 다중 축 — yAxis 항목의 id. 기본 첫 번째 축 */
+    axis?: string;
+    values?: readonly (number | null)[];
+    points?: readonly ChartPointInput[];
+    /** range-bar/range-area — 카테고리별 [최소, 최대] */
+    ranges?: readonly (readonly [number, number])[];
+    /** candlestick/ohlc — 카테고리별 [시가, 고가, 저가, 종가] */
+    ohlc?: readonly (readonly [number, number, number, number])[];
+    /** boxplot — 카테고리별 [최소, Q1, 중앙값, Q3, 최대] */
+    box?: readonly ChartBoxInput[];
+    /**
+     * 포인트 스타일 콜백 — AG Charts itemStyler 해당.
+     * 포인트/바/슬라이스/마커마다 호출돼 color/name을 덮어쓴다.
+     * 포인트의 명시 color/name 필드보다 우선한다.
+     */
+    itemStyle?: (item: ItemStyleContext) => ItemStyle | null | undefined;
+    /** 에러바 — 포인트별 [하한 편차, 상한 편차]. line/bar/scatter에 적용 */
+    errors?: readonly (readonly [number, number])[];
+    /** 추세선 오버레이 — "linear"(최소제곱) | "movingAverage" */
+    trend?: {
+        type: "linear" | "movingAverage";
+        period?: number;
+    };
+    /** map 타입 — 지역 코드별 값. 코드는 피처 id/iso 코드/name과 조인된다 */
+    mapData?: readonly ChartMapDatum[];
+    /** map 타입 — 위성 마커 레이어 (도시 포인트/버블) */
+    mapPoints?: readonly ChartMapPoint[];
+    /** map 타입 — 연결선 레이어 (출발→도착) */
+    mapLines?: readonly ChartMapLine[];
+    /**
+     * 계층 차트(sunburst/treemap) — 트리 노드 배열.
+     * 노드의 value 생략 시 children 합계로 계산된다.
+     */
+    tree?: readonly ChartTreeNode[];
+    /**
+     * sankey — 노드 간 플로우. 노드 목록은 source/target 이름에서
+     * 유도되고 열은 최장 경로 깊이로 배정된다.
+     */
+    links?: readonly ChartFlowLink[];
+    /**
+     * 시리즈 부가 데이터 — IBChart etcData 해당. 툴팁 컨텍스트와
+     * pointSelect 이벤트에 전달되며 chart.getEtcData로 조회할 수 있다.
+     */
+    etcData?: unknown;
+}
+/** 계층 차트 트리 노드 — sunburst/treemap의 재귀 입력 */
+export interface ChartTreeNode {
+    name: string;
+    /** 값 — 생략 시 children 합계로 계산된다 */
+    value?: number;
+    children?: readonly ChartTreeNode[];
+}
+/** sankey 플로우 — source 노드 → target 노드 방향 유량 */
+export interface ChartFlowLink {
+    source: string;
+    target: string;
+    value: number;
+}
+/** sankey 레이아웃 옵션 */
+export interface ChartSankeyOptions {
+    /** 노드 두께 px (기본 12) */
+    nodeWidth?: number;
+    /** 같은 열 노드 사이 간격 px (기본 12) */
+    nodeGap?: number;
+}
+/**
+ * chord 데이터 — n×n 유향 플로우 행렬.
+ * matrix[i][j]는 그룹 i → 그룹 j의 유량, (i,j)와 (j,i)는 같은 리본의
+ * 양끝 두께가 된다.
+ */
+export interface ChartChordOptions {
+    matrix: readonly (readonly number[])[];
+    /** 그룹 라벨 — 기본 G0..Gn-1 */
+    labels?: readonly string[];
+}
+/** gauge 옵션 — type:"gauge"의 단일 값 다이얼 범위 */
+export interface ChartGaugeOptions {
+    /** 최소값 (기본 0) */
+    min?: number;
+    /** 최대값 (기본 100) */
+    max?: number;
+    /** 목표값 — 있으면 트랙 위에 .mc-gauge-target 눈금을 그린다 */
+    target?: number;
+}
+/** 지도 값 레코드 — 지역 코드 → 값 (choropleth) */
+export interface ChartMapDatum {
+    /**
+     * 지역 코드 — topology 피처의 id, ISO 코드(iso_a2/iso_a3),
+     * name과 대소문자 무관하게 조인된다 (world-atlas는 ISO numeric id).
+     */
+    code: string;
+    value: number;
+}
+/** 지도 투영 — mercator는 위도 ±85°로 클램프 */
+export type MapProjection = "equirectangular" | "mercator";
+/** 지도 옵션 — topology는 TopoJSON 또는 GeoJSON */
+export interface ChartMapOptions {
+    /**
+     * 지형 데이터 — TopoJSON Topology 또는 GeoJSON FeatureCollection.
+     * `WORLD_TOPOLOGY`(내장 세계 지도)를 넘기거나 사용자 지형을 주입한다.
+     * 없으면 지역이 렌더되지 않는다(빈 상태).
+     */
+    topology?: unknown;
+    /** TopoJSON objects의 오브젝트명 — 기본 첫 오브젝트 */
+    object?: string;
+    /** 투영 — 기본 "equirectangular" */
+    projection?: MapProjection;
+    /**
+     * 피처 → 조인 키 추출 — 기본은 id + iso_a2/iso_a3/name 후보 전부.
+     * 반환값이 조인의 1순위 키가 된다.
+     */
+    featureKey?: (f: {
+        id?: string | number;
+        properties?: Record<string, unknown>;
+    }) => string | number | undefined;
+    /**
+     * 렌더에서 제외할 피처 코드 — 기본 남극 제외
+     * (남극이 들어가면 면적 대비 표시 영역이 크게 줄어든다).
+     */
+    excludeCodes?: readonly string[];
+    /**
+     * 렌더에 포함할 피처 코드 — 지정 시 이 목록에 맞는 피처만 쓴다.
+     * `["410"]`이면 WORLD_TOPOLOGY에서 한국만 플롯에 맞춘다
+     * (사용자 지도처럼 한 지역만 확대해 쓸 때).
+     */
+    includeCodes?: readonly string[];
+    /**
+     * 마커 클러스터링 — 가까운 마커를 카운트 버블(.mc-map-cluster)로 묶는다.
+     * true면 켜고 { size }는 화면 px 셀 크기(기본 48). 클러스터 클릭은
+     * clusterSelect 이벤트로 묶인 포인트를 전달한다.
+     */
+    cluster?: boolean | {
+        size?: number;
+    };
+    /**
+     * 지도 팬/줌 — 플롯 중심 변환으로 휠 줌·드래그 팬·핀치를 지원한다.
+     * 축 기반 zoom 옵션과 별개로 지도 레이어만 변환된다.
+     */
+    panZoom?: boolean;
+    /** 색상 스케일 저값 색 (기본 --chart-map-from) */
+    from?: string;
+    /** 색상 스케일 고값 색 (기본 --chart-map-to) */
+    to?: string;
+}
+export interface TooltipFormatContext {
+    seriesId: string;
+    name: string;
+    index: number;
+    /** 카테고리/슬라이스 라벨 */
+    label: string;
+    /** 전체 대비 비율 (파이) */
+    percent?: number;
+    /** 포인트/시리즈 부가 데이터 (etcData) */
+    etcData?: unknown;
+}
+export interface ChartAxisOptions {
+    id?: string;
+    position?: AxisPosition;
+    scale?: ScaleKind;
+    min?: number;
+    max?: number;
+    tickCount?: number;
+    label?: string;
+    grid?: boolean;
+    format?: (value: number) => string;
+}
+export interface ChartPadding {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export interface ChartLegendOptions {
+    position?: LegendPosition;
+    /**
+     * 범례 항목 앞에 체크박스 — IBChart series showCheckbox 해당.
+     * 체크 상태 = 시리즈/슬라이스 가시성, 클릭 시 legendCheck 이벤트 발행.
+     */
+    checkboxes?: boolean;
+    /**
+     * 페이지네이션 — 항목이 pageSize를 넘으면 잘라 보여주고
+     * .mc-legend-prev/.mc-legend-next 버튼으로 넘긴다 (AG legend pagination 해당).
+     * true면 페이지당 8개, 숫자면 페이지 크기.
+     */
+    pagination?: boolean | number;
+}
+/** 툴팁 HTML 렌더 컨텍스트 — tooltip.render 콜백 입력 */
+export interface TooltipRenderContext {
+    /** 툴팁 제목 (카테고리/포인트 라벨) */
+    title: string;
+    rows: TooltipRowView[];
+}
+export interface ChartTooltipOptions {
+    mode?: TooltipMode;
+    /** 값 → 툴팁 문자열 포맷터 */
+    format?: (value: number | null, ctx: TooltipFormatContext) => string;
+    /**
+     * 툴팁 전체 HTML 렌더러 — 반환 문자열이 .mc-tooltip의 innerHTML이 된다
+     * (AG Charts tooltip.renderer / IBChart tooltip formatter 해당).
+     * 반환값은 escape 없이 삽입되므로 신뢰된 마크업만 반환할 것.
+     */
+    render?: (ctx: TooltipRenderContext) => string;
+}
+export interface ChartZoomOptions {
+    wheel?: boolean;
+    pan?: boolean;
+    /** 도메인 단위 최소 창 크기 (band: 카테고리 수) */
+    minSpan?: number;
+    /**
+     * 줌이 적용되는 도메인 축 — "x"(기본, 카테고리/x 도메인)만.
+     * "y" 또는 "xy"면 값 축 도메인(첫 y축)도 wheel/pan 대상이 된다.
+     */
+    axes?: "x" | "y" | "xy";
+    /**
+     * Shift+드래그로 영역 줌 — brush와 동시에 켜면 brush가 우선한다.
+     * axes가 적용된 방향의 범위로 줌된다 (.mc-selection rect 재사용).
+     */
+    select?: boolean;
+}
+/**
+ * setZoomWindow 입력 — DomainWindow이면 x 창으로 해석하고,
+ * { x, y } 객체면 축별로 지정한다. null은 전체 리셋.
+ */
+export type ZoomWindowInput = DomainWindow | {
+    x?: DomainWindow | null;
+    y?: DomainWindow | null;
+} | null;
+export interface ChartAnimationOptions {
+    duration?: number;
+    /**
+     * 데이터 갱신 전환 — setData/실시간 API/updateDelta로 데이터가 바뀐
+     * 뒤 첫 렌더에 .mc-updating이 붙어 mc-update 키프레임이 재생된다.
+     * 기본 true. false면 갱신 전환을 끄고 진입 애니메이션만 남긴다.
+     */
+    updates?: boolean;
+}
+/** 데이터 라벨 — 포인트/바/슬라이스 위의 값 텍스트 */
+export interface ChartDataLabelOptions {
+    /** 값 → 라벨 문자열 포맷터 (기본 formatNumber) */
+    format?: (value: number | null, ctx: TooltipFormatContext) => string;
+}
+/** 값 축 기준선 — 임계값/평균선 등 */
+export interface MarkLineInput {
+    /** 값 축 도메인 값 */
+    value: number;
+    label?: string;
+    color?: string;
+    /** 다중 축 — yAxis 항목의 id. 기본 첫 번째 축 */
+    axis?: string;
+}
+/** 값 축 기준 영역 — 경고/정상 구간 음영 (IBChart plotBand 해당) */
+export interface MarkBandInput {
+    /** 값 축 도메인 구간 시작 */
+    from: number;
+    /** 값 축 도메인 구간 끝 */
+    to: number;
+    label?: string;
+    color?: string;
+    /** 다중 축 — yAxis 항목의 id. 기본 첫 번째 축 */
+    axis?: string;
+}
+/** 히트맵 색상 스케일 — 저값→고값 그래디언트 */
+export interface ChartHeatmapOptions {
+    /** 최소값 색 (기본 --chart-heat-from) */
+    from?: string;
+    /** 최대값 색 (기본 --chart-heat-to) */
+    to?: string;
+}
+/**
+ * 인라인 주석 — 데이터 좌표에 텍스트/이미지를 띄운다 (IBChart annotation 해당).
+ * x는 카테고리(band면 라벨, linear/time이면 값), y는 값 축 좌표.
+ * y 생략 시 플롯 상단에 배치된다.
+ */
+export interface AnnotationInput {
+    x: CategoryValue;
+    y?: number;
+    /** 텍스트 주석 — label/image 중 하나는 필요 */
+    label?: string;
+    /** 이미지 주석 — url. width/height로 크기 지정 (기본 24×24) */
+    image?: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * 드릴다운 레벨 — 포인트/슬라이스 클릭 시 교체될 데이터.
+ * `drilldown` 옵션 맵의 키는 포인트 라벨(카테고리 문자열)이다.
+ */
+export interface DrilldownLevel {
+    series: readonly ChartSeriesInput[];
+    categories?: readonly CategoryValue[];
+    /** 드릴된 상태에서 .mc-title에 표시할 제목 */
+    title?: string;
+}
+/** histogram 빈 옵션 — binWidth 우선, 아니면 bins(기본 Sturges 개수) */
+export interface ChartHistogramOptions {
+    bins?: number;
+    /** 고정 구간 폭 — 지정 시 bins보다 우선한다 (AG binCount 대비 binInterval 해당) */
+    binWidth?: number;
+}
+/** 컨텍스트 메뉴 커스텀 항목 — 내장(reset/export) 뒤에 붙는다 */
+export interface ChartMenuItem {
+    /** menuAction 이벤트의 식별자 — 기본 "custom:{i}" */
+    id?: string;
+    label: string;
+}
+/**
+ * 컨텍스트 메뉴 — 플롯 우클릭 시 메뉴 (.mc-menu).
+ * true면 내장 항목(줌 리셋/SVG/PNG 저장)만, 객체면 items를 추가한다.
+ */
+export interface ChartContextMenuOptions {
+    items?: readonly ChartMenuItem[];
+}
+/**
+ * 주석 그리기 도구 — setDrawMode로 활성 도구를 고르면 플롯 드래그가
+ * 주석 생성이 된다 (AG Charts annotations 그리기 도구 해당).
+ * - channel — 드래그한 추세선에 평행선+음영 밴드를 붙인 가격 채널
+ * - fibonacci — 드래그 구간의 피보나치 되돌림 레벨 (0~100%)
+ * - measure — 드래그 구간의 Δx/Δy를 라벨로 표시하는 측정 도구
+ */
+export type DrawTool = "line" | "hline" | "vline" | "rect" | "channel" | "fibonacci" | "measure";
+/** 그린 주석 입력 — 데이터 좌표(band x는 연속 인덱스 0..n) */
+export interface DrawingInput {
+    tool: DrawTool;
+    /** 시작점 — x 도메인 값, y 값 축 값 */
+    x1: number;
+    y1: number;
+    /** 끝점 — hline은 y만, vline은 x만 쓴다 */
+    x2?: number;
+    y2?: number;
+    color?: string;
+    label?: string;
+    /** channel 도구의 평행선 오프셋 px — 기본 drawing.channelWidth */
+    width?: number;
+}
+export interface ChartDrawingOptions {
+    /** 그린 주석 선/영역 색 — 기본 --chart-draw-color */
+    color?: string;
+    /** channel 도구의 기본 채널 폭 px (기본 16) */
+    channelWidth?: number;
+}
+/**
+ * 외부 데이터 로딩 — IBChart search 네임스페이스 해당.
+ * load()가 url을 GET해 응답을 setData에 주입한다.
+ */
+export interface ChartSearchOptions {
+    /** 데이터 URL — 응답은 {series, categories?} 형태의 JSON */
+    url?: string;
+    /** fetch RequestInit (headers/method 등) */
+    request?: RequestInit;
+    /** 응답 → 차트 데이터 변환기 — 없으면 응답을 그대로 해석한다 */
+    transform?: (raw: unknown) => {
+        series: ChartSeriesInput[];
+        categories?: CategoryValue[];
+    };
+    /** 차트 생성 시 자동 로드 */
+    auto?: boolean;
+    /** fetch 주입점 — 테스트/SSR에서 교체 */
+    fetcher?: (url: string, init?: RequestInit) => Promise<unknown>;
+}
+/** search.load()의 호출 인자 — 옵션을 덮어쓴다 */
+export interface SearchLoadArgs {
+    url?: string;
+    request?: RequestInit;
+    transform?: (raw: unknown) => {
+        series: ChartSeriesInput[];
+        categories?: CategoryValue[];
+    };
+}
+/**
+ * 픽토그램 — type:"pictogram"의 아이콘 배치 옵션 (ISOTYPE 스타일).
+ * 카테고리별 행에 사람 아이콘을 값 비례로 채운다 — 아이콘 1개 = unit 값.
+ */
+export interface ChartPictogramOptions {
+    /**
+     * 아이콘 1개가 나타내는 값 — 생략하면 행 최대 합계를
+     * maxPerRow로 나눈 nice 단위로 자동 계산한다.
+     */
+    unit?: number;
+    /** unit 자동 계산 기준 행당 아이콘 수 (기본 12) */
+    maxPerRow?: number;
+}
+/**
+ * 인구 피라미드 — type:"population-pyramid"의 옵션.
+ * 첫 시리즈는 좌측, 나머지 시리즈는 우측으로 그려지는 대칭 수평 막대.
+ * 값 축 도메인은 ±대칭이고 틱 라벨은 절대값으로 표시된다.
+ */
+export interface ChartPyramidPopOptions {
+    /** 좌측으로 그릴 시리즈 수 (기본 1 — 첫 시리즈만 좌측) */
+    leftSeries?: number;
+}
+/** 코어 생성 옵션 */
+export interface ChartCoreOptions {
+    type?: ChartType;
+    /** 차트 제목 — .mc-title */
+    title?: string;
+    /** 부제목 — .mc-subtitle */
+    subtitle?: string;
+    series?: readonly ChartSeriesInput[];
+    categories?: readonly CategoryValue[];
+    width?: number;
+    height?: number;
+    padding?: Partial<ChartPadding>;
+    /** bar 타입의 방향 — horizontal이면 값 축이 x로 간다 */
+    direction?: ChartDirection;
+    xAxis?: ChartAxisOptions;
+    /** 배열이면 다중 축 — position left/right 순서대로 배치 */
+    yAxis?: ChartAxisOptions | readonly ChartAxisOptions[];
+    palette?: readonly string[];
+    theme?: ChartTheme;
+    legend?: boolean | ChartLegendOptions;
+    tooltip?: TooltipMode | ChartTooltipOptions;
+    /** wheel 줌 + drag 팬. true면 둘 다 활성 */
+    zoom?: boolean | ChartZoomOptions;
+    /** drag로 x 범위 선택 */
+    brush?: boolean;
+    /**
+     * 네비게이터(미니맵) — 플롯 아래 전체 도메인 개요 + 드래그로
+     * 줌 창 제어. 직교 차트에서만 렌더된다 (AG Charts navigator 해당).
+     */
+    navigator?: boolean | {
+        height?: number;
+    };
+    /**
+     * 스크롤바 — 미니 시리즈 없는 얇은 줌 스트립 (.mc-scrollbar).
+     * 네비게이터가 켜져 있으면 네비게이터가 우선한다.
+     */
+    scrollbar?: boolean | {
+        height?: number;
+    };
+    /**
+     * 컨텍스트 메뉴 — 플롯 우클릭 시 열림 (AG Charts contextMenu 해당).
+     * 내장 항목: 줌 리셋/SVG 저장/PNG 저장 + items로 커스텀 추가.
+     * 커스텀 항목 선택은 menuAction 이벤트로 전달된다.
+     */
+    contextMenu?: boolean | ChartContextMenuOptions;
+    /**
+     * 차트 동기화 그룹 id — 같은 키를 가진 차트끼리 호버와
+     * 줌 창을 공유한다 (AG Charts sync 해당).
+     */
+    sync?: string;
+    /**
+     * 주석 그리기 도구 — chart.setDrawMode("line"|"hline"|"vline"|"rect")로
+     * 활성화하면 플롯 드래그가 주석을 만든다 (AG annotations 도구 해당).
+     * 그린 주석은 drawings 상태에 쌓이고 getState/setState로 왕복된다.
+     */
+    drawing?: boolean | ChartDrawingOptions;
+    /**
+     * 외부 데이터 로딩 — chart.search.load()로 url을 GET해
+     * setData에 주입한다. 로딩 중 loading 오버레이, 완료 시 searchEnd,
+     * 실패 시 searchError 이벤트 (IBChart search 해당).
+     */
+    search?: ChartSearchOptions;
+    /** histogram 빈 개수 — type:"histogram"의 원시 values를 구간화 */
+    histogram?: ChartHistogramOptions;
+    /**
+     * 픽토그램 — type:"pictogram"에서 아이콘 1개가 나타내는 값 등
+     * (인구/설문 통계의 ISOTYPE 스타일 사람 아이콘 차트)
+     */
+    pictogram?: ChartPictogramOptions;
+    /**
+     * 인구 피라미드 — type:"population-pyramid"의 좌측 시리즈 수.
+     * 첫 시리즈(기본)를 좌측으로 그리는 대칭 수평 막대 차트.
+     */
+    pyramidPop?: ChartPyramidPopOptions;
+    animation?: boolean | ChartAnimationOptions;
+    /** 값 라벨 표시 — true면 기본 포맷 */
+    dataLabels?: boolean | ChartDataLabelOptions;
+    /** 값 축 기준선 — 수평 차트에서는 x 축 기준 */
+    markLines?: readonly MarkLineInput[];
+    /** 값 축 기준 영역 — 경고/정상 구간 음영 */
+    markBands?: readonly MarkBandInput[];
+    /** 접근성 패턴 채우기 — 색 외에 무늬로도 시리즈를 구분한다 */
+    patterns?: boolean;
+    /** 히트맵 색상 스케일 */
+    heatmap?: ChartHeatmapOptions;
+    /**
+     * 지도 — type:"map"일 때 지형 데이터와 투영 설정.
+     * `map: { topology: WORLD_TOPOLOGY }`로 내장 세계 지도를 켠다
+     * (AG Charts topology 해당 — 축 없이 국가 경계 path로 렌더).
+     */
+    map?: ChartMapOptions;
+    /**
+     * 드릴다운 — 키(포인트 라벨)별 하위 데이터 맵.
+     * 해당 라벨의 포인트/슬라이스 클릭 시 하위 레벨로 내려가고
+     * .mc-drillup 버튼 또는 chart.drillUp()으로 복귀한다.
+     */
+    drilldown?: Record<string, DrilldownLevel>;
+    /**
+     * 인라인 주석 — 데이터 좌표에 텍스트/이미지 (.mc-annotation).
+     * 직교 좌표 차트에서만 렌더된다.
+     */
+    annotations?: readonly AnnotationInput[];
+    /** sankey 레이아웃 튜닝 — 노드 두께/간격 */
+    sankey?: ChartSankeyOptions;
+    /**
+     * chord 데이터 — type:"chord"에서 행렬과 그룹 라벨.
+     * (AG Charts chord 해당 — 시리즈 대신 옵션으로 행렬을 받는다)
+     */
+    chord?: ChartChordOptions;
+    /**
+     * gauge 범위 — type:"gauge"의 최소/최대/목표값.
+     * 값은 첫 시리즈의 첫 포인트(values[0])에서 읽는다.
+     */
+    gauge?: ChartGaugeOptions;
+    /**
+     * 포인트 클릭으로 선택/해제 (IBChart allowPointSelect 해당).
+     * 선택된 요소는 .mc-selected, pointSelect/pointUnselect 이벤트 발행.
+     */
+    allowPointSelect?: boolean;
+    /** 내장 문구 로케일 — emptyText/툴바 버튼 등 (기본 "en") */
+    locale?: ChartLocale;
+    /** 데이터 없음 텍스트 (기본 "No data") */
+    emptyText?: string;
+    /** 로딩 오버레이 초기 상태 — setLoading으로 제어 */
+    loading?: boolean;
+    /** ResizeObserver로 컨테이너 너비 추적 (렌더러가 처리) */
+    responsive?: boolean;
+    ariaLabel?: string;
+    /** 시리즈 고유 ID — 렌더 키·이벤트 식별자 (기본: name ?? series-N) */
+    getSeriesId?: (series: ChartSeriesInput, index: number) => string;
+    /** 이벤트 핸들러 — on()과 같은 이름 */
+    events?: ChartEventHandlers;
+}
+export interface DomainWindow {
+    min: number;
+    max: number;
+}
+export interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** 해석된 시리즈 — color가 null이면 렌더러가 var(--chart-palette-N)을 쓴다 */
+export interface SeriesView {
+    id: string;
+    name: string;
+    color: string | null;
+    colorIndex: number;
+    type: ChartType;
+    axisId: string;
+    visible: boolean;
+}
+/** 데이터 포인트 — px 좌표 + 라벨 */
+export interface PointView {
+    /** 렌더 키 (seriesId:index) — keyed each에서 고유 */
+    key: string;
+    seriesId: string;
+    index: number;
+    x: number;
+    y: number;
+    value: number | null;
+    label: string;
+    /** 버블 반지름 px — bubble 타입에서만 설정 */
+    r?: number;
+    /** 포인트 고정 색 — points[].color 또는 itemStyle이 지정한 경우 */
+    color?: string | null;
+    focused: boolean;
+    dimmed: boolean;
+    /** allowPointSelect로 선택된 포인트 — .mc-selected */
+    selected?: boolean;
+}
+export interface BarView {
+    key: string;
+    seriesId: string;
+    index: number;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    value: number;
+    label: string;
+    /** 포인트 고정 색 — itemStyle/points color override */
+    color?: string | null;
+    /** waterfall 증감 방향 / percent-stacked-bar 카테고리 점유율(0..1) */
+    tone?: "up" | "down";
+    share?: number;
+    /**
+     * population-pyramid 미러링 — -1이면 중앙축 기준 좌측(음수 방향) 막대.
+     * 수평 막대의 라벨/툴팁 배치가 이 값을 참조한다.
+     */
+    dir?: 1 | -1;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+export interface SliceView {
+    key: string;
+    index: number;
+    path: string;
+    color: string | null;
+    colorIndex: number;
+    value: number;
+    label: string;
+    /** 툴팁/라벨 앵커 — 조각 중심각 위의 점 (svg 좌표) */
+    mx: number;
+    my: number;
+    focused: boolean;
+    dimmed: boolean;
+    /** allowPointSelect로 선택된 슬라이스 — .mc-selected */
+    selected?: boolean;
+}
+/** 워드클라우드 단어 — .mc-word text */
+export interface WordView {
+    /** 렌더 키 (slice-i) */
+    key: string;
+    /** 카테고리 인덱스 */
+    index: number;
+    text: string;
+    /** svg 좌표 — 텍스트 기준점(text-anchor middle, dominant-baseline middle) */
+    x: number;
+    y: number;
+    /** 충돌 박스 — hitTest/레이아웃 공용 */
+    w: number;
+    h: number;
+    /** font-size px */
+    size: number;
+    color: string | null;
+    colorIndex: number;
+    value: number;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** 그린 주석 뷰 — svg 좌표로 해석된 선/영역 */
+export interface DrawingView {
+    key: string;
+    tool: DrawTool;
+    /** svg 좌표 — hline은 y1만, vline은 x1만 의미 있다 */
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    color: string | null;
+    colorIndex: number;
+    label?: string;
+    /** channel 도구 — 평행선 오프셋 px (해석된 값) */
+    width?: number;
+    /** 드래그 진행 중 미리보기 — .mc-draw-draft로 렌더된다 */
+    draft?: boolean;
+}
+/** 인라인 주석 뷰 — .mc-annotation */
+export interface AnnotationView {
+    key: string;
+    /** svg 좌표 — 주석 앵커 */
+    x: number;
+    y: number;
+    label?: string;
+    image?: string;
+    w: number;
+    h: number;
+}
+/** 히트맵 셀 — .mc-heat-cell rect */
+export interface HeatCellView {
+    /** 렌더 키 (seriesId:index) */
+    key: string;
+    /** 행 시리즈 id */
+    seriesId: string;
+    /** 열 인덱스 (카테고리) */
+    index: number;
+    /** 행 인덱스 (시리즈) */
+    row: number;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    value: number;
+    /** 열 라벨 (카테고리) */
+    label: string;
+    /** 정규화된 값 0..1 — 색상 스케일 위치 */
+    t: number;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** range-bar 막대 — 카테고리별 [low, high] 구간 (.mc-range-bar) */
+export interface RangeBarView {
+    seriesId: string;
+    index: number;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    low: number;
+    high: number;
+    label: string;
+    /** 포인트 고정 색 — itemStyle override */
+    color?: string | null;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/**
+ * boxplot 상자 — 카테고리별 5수치 요약 (.mc-box).
+ * 수직 전용 — box rect(Q1~Q3) + 중앙값 선 + 수염(whisker) + 끝 캡.
+ */
+export interface BoxPlotView {
+    seriesId: string;
+    index: number;
+    /** 상자 중심 x */
+    cx: number;
+    /** 상자 rect (Q1~Q3) */
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** 수염 끝 (svg y) — highY가 위쪽 */
+    lowY: number;
+    highY: number;
+    /** 중앙값 y */
+    medY: number;
+    min: number;
+    q1: number;
+    median: number;
+    q3: number;
+    max: number;
+    label: string;
+    /** 포인트 고정 색 — itemStyle override */
+    color?: string | null;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** candlestick 캔들 — 시가/고가/저가/종가 (.mc-candle) */
+export interface CandleView {
+    seriesId: string;
+    index: number;
+    /** 몸통 중심 x */
+    cx: number;
+    /** 몸통 rect */
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** 심지(고가/저가) 선분 */
+    highY: number;
+    lowY: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    label: string;
+    /** 종가>시가면 up */
+    tone: "up" | "down";
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** 에러바 세그먼트 — 포인트 위 ±오차 (.mc-error) */
+export interface ErrorBarView {
+    seriesId: string;
+    index: number;
+    /** 포인트 앵커 (svg 좌표) */
+    x: number;
+    y: number;
+    /** 오차 상/하 끝 */
+    yLo: number;
+    yHi: number;
+}
+/** 추세선 — svg 좌표 폴리라인 path (.mc-trendline). linear는 2점, movingAverage는 다점 */
+export interface TrendLineView {
+    seriesId: string;
+    path: string;
+    color: string | null;
+    colorIndex: number;
+    type: "linear" | "movingAverage";
+}
+/** 지도 지역 — .mc-map-region path (choropleth 채움) */
+export interface MapRegionView {
+    /** 렌더 키 (map:<code>) */
+    key: string;
+    /** 피처 조인 키 (피처 id 또는 featureKey 결과) */
+    code: string;
+    /** 피처 표시 이름 — properties.name */
+    name: string;
+    /** series.mapData 인덱스 — 데이터 없는 지역은 -1 (상호작용 비활성) */
+    index: number;
+    /** 피처 폴리곤 path (svg 좌표) */
+    path: string;
+    /** 툴팁/포커스 앵커 — 최대 면적 링의 도형 중심 */
+    cx: number;
+    cy: number;
+    /** mapData 값 — null이면 데이터 없음(.mc-map-no-data) */
+    value: number | null;
+    /** 정규화된 값 0..1 — 색상 스케일 위치 */
+    t: number;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** 지도 값 범례 — .mc-map-scale 그라데이션 바의 min/max */
+export interface MapScaleView {
+    min: number;
+    max: number;
+    /** 커스텀 색상 — null이면 --chart-map-from/to 변수 사용 */
+    from: string | null;
+    to: string | null;
+}
+/** treemap 리프 노드 — .mc-treemap-node rect */
+export interface TreemapNodeView {
+    /** 렌더 키 — 노드 경로 (root>child>…) */
+    key: string;
+    /** DFS 플랫 인덱스 — 포커스/선택 식별자 */
+    index: number;
+    name: string;
+    value: number;
+    depth: number;
+    /** 최상위 조상 인덱스 — 색/범례 그룹 */
+    root: number;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    color: string | null;
+    colorIndex: number;
+    /** rect가 충분히 크면 이름 라벨 표시용 (dataLabels) */
+    label?: string;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** sunburst 노드 — .mc-sunburst-node 환형 섹터 path */
+export interface SunburstNodeView {
+    /** 렌더 키 — 노드 경로 */
+    key: string;
+    /** DFS 플랫 인덱스 */
+    index: number;
+    name: string;
+    value: number;
+    depth: number;
+    /** 최상위 조상 인덱스 — 색/범례 그룹 */
+    root: number;
+    /** 각도 범위 (rad, -π/2가 12시) — hitTest용 */
+    a0: number;
+    a1: number;
+    /** 반지름 범위 (svg px) — hitTest용 */
+    r0: number;
+    r1: number;
+    /** 중심 좌표 (svg) — hitTest용 */
+    cx0: number;
+    cy0: number;
+    /** 환형 섹터 path */
+    path: string;
+    /** 라벨/툴팁 앵커 — 중간 각도·반지름 위의 점 */
+    cx: number;
+    cy: number;
+    color: string | null;
+    colorIndex: number;
+    /** 섹터가 충분히 크면 이름 라벨 표시용 (dataLabels) */
+    label?: string;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** sankey 노드 — .mc-sankey-node 세로 rect */
+export interface SankeyNodeView {
+    /** 렌더 키 — 노드 이름 */
+    key: string;
+    /** 노드 인덱스 (입력 등장 순서) */
+    index: number;
+    name: string;
+    /** 노드 유량 — max(유입 합, 유출 합) */
+    value: number;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    color: string | null;
+    colorIndex: number;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** sankey 링크 — .mc-sankey-link 베지어 리본 path */
+export interface SankeyLinkView {
+    key: string;
+    /** links 입력 인덱스 */
+    index: number;
+    sourceIndex: number;
+    targetIndex: number;
+    source: string;
+    target: string;
+    value: number;
+    /** 리본 path — 상/하 곡선 두께가 value에 비례 */
+    path: string;
+    /** 소스 노드 색 계승 */
+    colorIndex: number;
+}
+/** chord 그룹 — .mc-chord-group 외곽 아크 */
+export interface ChordGroupView {
+    /** 렌더 키 (group-i) */
+    key: string;
+    /** 행렬 인덱스 */
+    index: number;
+    name: string;
+    /** 그룹 총 유량 — 행 합계 */
+    value: number;
+    /** 아크 각도 범위 (rad) — hitTest용 */
+    a0: number;
+    a1: number;
+    /** 환형 아크 path */
+    path: string;
+    /** 라벨 앵커 — 아크 바깥 */
+    lx: number;
+    ly: number;
+    color: string | null;
+    colorIndex: number;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** chord 리본 — .mc-chord-ribbon (그룹 쌍을 잇는 내부 곡면) */
+export interface ChordRibbonView {
+    key: string;
+    /** 무방향 그룹 쌍 인덱스 */
+    index: number;
+    sourceIndex: number;
+    targetIndex: number;
+    /** source → target 유량 (소스 측 두께) */
+    value: number;
+    /** target → source 유량 (타겟 측 두께) */
+    valueBack: number;
+    path: string;
+    colorIndex: number;
+}
+/**
+ * 극좌표 환형 섹터 — nightingale/radial-bar의 노드.
+ * nightingale은 각도=등분·반지름=값, radial-bar는 반지름=카테고리·각도=값.
+ */
+export interface PolarSectorView {
+    /** 렌더 키 */
+    key: string;
+    /** 카테고리 인덱스 */
+    index: number;
+    seriesId: string;
+    /** 카테고리 라벨 */
+    name: string;
+    value: number;
+    /** 각도 범위 (rad, -π/2가 12시) — hitTest용 */
+    a0: number;
+    a1: number;
+    /** 반지름 범위 (svg px) — hitTest용 */
+    r0: number;
+    r1: number;
+    /** 중심 좌표 (svg) — hitTest용 */
+    cx0: number;
+    cy0: number;
+    /** 환형 섹터 path */
+    path: string;
+    /** 라벨/툴팁 앵커 — 섹터 중간각·중간반지름 위의 점 */
+    cx: number;
+    cy: number;
+    color: string | null;
+    colorIndex: number;
+    /** 섹터가 충분히 크면 이름 라벨 표시용 (dataLabels) */
+    label?: string;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** 지도 마커 뷰 — mapPoints의 투영된 원 (.mc-map-marker) */
+export interface MapMarkerView {
+    /** 렌더 키 (marker-i) */
+    key: string;
+    /** mapPoints 인덱스 */
+    index: number;
+    /** svg 좌표 — 투영 + panZoom 변환 후 위치 */
+    x: number;
+    y: number;
+    /** 반지름 — value가 있으면 sqrt 스케일. 이미지 마커는 최소 10px */
+    r: number;
+    value: number | null;
+    label: string;
+    /** 고정 색 — 없으면 시리즈 색 */
+    color?: string | null;
+    /** 아바타 이미지 URL — 있으면 .mc-map-avatar로 렌더 */
+    image?: string | null;
+    /** 내 위치 펄스 링 표시 */
+    pulse?: boolean;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** 지도 클러스터 뷰 — 같은 셀에 묶인 마커의 카운트 버블 (.mc-map-cluster) */
+export interface MapClusterView {
+    /** 렌더 키 (cluster-i) */
+    key: string;
+    /** svg 좌표 — 묶인 마커들의 무게중심 */
+    x: number;
+    y: number;
+    r: number;
+    /** 묶인 마커 수 */
+    count: number;
+    /** 묶인 mapPoints 인덱스 */
+    members: number[];
+}
+/** 지도 연결선 뷰 — mapLines의 투영된 선분 (.mc-map-line) */
+export interface MapLineView {
+    key: string;
+    index: number;
+    /** svg path — M x1 y1 L x2 y2 (곡률 없는 직선) */
+    path: string;
+    label?: string;
+}
+/** linear-gauge 뷰 — 수평 바 게이지 (.mc-lg-*) */
+export interface LinearGaugeView {
+    value: number;
+    min: number;
+    max: number;
+    /** 배경 트랙 rect (.mc-lg-track) */
+    track: Rect;
+    /** 값 채움 rect (.mc-lg-value) */
+    bar: Rect;
+    /** 목표값 눈금 — 수직 선분 */
+    target?: {
+        x: number;
+        y0: number;
+        y1: number;
+    };
+    /** 값 라벨 — 트랙 중심 위 */
+    label: {
+        x: number;
+        y: number;
+        text: string;
+    };
+    /** min/max 눈금 라벨 — 트랙 양끝 아래 */
+    ticks: {
+        x: number;
+        y: number;
+        text: string;
+    }[];
+    /** 시리즈 색 — 값 채움 fill */
+    color: string | null;
+    colorIndex: number;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** organization 노드 — top-down 트리의 박스 (.mc-org-node) */
+export interface OrgNodeView {
+    /** 렌더 키 — 노드 경로 */
+    key: string;
+    /** DFS 플랫 인덱스 */
+    index: number;
+    name: string;
+    value: number;
+    /** 최상위 조상 인덱스 — 색/범례 그룹 */
+    root: number;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** 노드 중심 — 툴팁/포커스 앵커 */
+    cx: number;
+    cy: number;
+    color: string | null;
+    colorIndex: number;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** organization 연결선 — 부모 하단 → 자식 상단 엘보 커넥터 (.mc-org-link) */
+export interface OrgLinkView {
+    key: string;
+    path: string;
+}
+/** 픽토그램 아이콘 — 카테고리 행 안의 사람 모양 심볼 (.mc-picto) */
+export interface PictoIconView {
+    key: string;
+    /** 채움 아이콘의 시리즈 — 빈 아이콘은 null */
+    seriesId: string | null;
+    /** 카테고리 인덱스 */
+    index: number;
+    /** svg 좌표 — 아이콘 rect (24×24 박스를 size로 스케일) */
+    x: number;
+    y: number;
+    size: number;
+    /** 값만큼 채워진 아이콘 여부 — false면 잔여 빈 아이콘 */
+    filled: boolean;
+    colorIndex: number;
+    /** 호버 시 툴팁 값 — 채움 아이콘의 시리즈 값 */
+    value: number | null;
+    label: string;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** 픽토그램 행 — 카테고리별 아이콘 묶음 + 행 라벨 */
+export interface PictoRowView {
+    /** 카테고리 인덱스 */
+    index: number;
+    label: string;
+    /** 행 라벨 위치 (svg 좌표, text-anchor=end 기준점) */
+    labelX: number;
+    labelY: number;
+    /** 행 밴드 — hitTest 범위 */
+    y: number;
+    h: number;
+    icons: PictoIconView[];
+}
+/** gauge 뷰 — type:"gauge"의 단일 다이얼 (.mc-gauge-*) */
+export interface GaugeView {
+    /** 값 (첫 시리즈 첫 포인트) */
+    value: number;
+    min: number;
+    max: number;
+    /** 배경 트랙 아크 path (.mc-gauge-track) */
+    trackPath: string;
+    /** 값 아크 path (.mc-gauge-value) */
+    valuePath: string;
+    /** 바늘 — 중심에서 끝점까지 선분 */
+    needle: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    /** 중앙 값 라벨 위치 */
+    label: {
+        x: number;
+        y: number;
+        text: string;
+    };
+    /** min/max 눈금 라벨 — 양끝 아래 */
+    ticks: {
+        x: number;
+        y: number;
+        text: string;
+    }[];
+    /** 목표값 눈금 — 있으면 트랙 위의 .mc-gauge-target 선분 */
+    target?: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    /** hitTest용 — 값 아크 각도/반지름 */
+    cx: number;
+    cy: number;
+    r0: number;
+    r1: number;
+    a0: number;
+    a1: number;
+    /** 시리즈 색 — 값 아크 fill */
+    color: string | null;
+    colorIndex: number;
+    focused: boolean;
+    dimmed: boolean;
+    selected?: boolean;
+}
+/** 레이더 축 그리드 — 동심원 링 + 방사 스포크 */
+export interface RadarGridView {
+    cx: number;
+    cy: number;
+    r: number;
+    /** 각 링의 반지름 비율(0..1) + 도메인 값 라벨 */
+    rings: {
+        r: number;
+        label: string;
+    }[];
+    /** 스포크 — 카테고리 방향 선분 + 라벨 좌표 */
+    spokes: {
+        x2: number;
+        y2: number;
+        lx: number;
+        ly: number;
+        label: string;
+    }[];
+}
+/** 네비게이터(미니맵) 뷰 — .mc-navigator */
+export interface NavigatorView {
+    /** 스트립 높이 px */
+    h: number;
+    /** 스트립 상단 y (svg 좌표) */
+    y: number;
+    /** 미니 시리즈 라인 — 전체 x 도메인 */
+    tracks: {
+        seriesId: string;
+        color: string | null;
+        colorIndex: number;
+        path: string;
+    }[];
+    /** 현재 줌 창 rect — 없으면 전체 */
+    window: {
+        x: number;
+        w: number;
+    };
+    /** 스트립 좌우 (svg 좌표) — 드래그 px→도메인 변환 기준 */
+    left: number;
+    right: number;
+}
+export type GeometryView = {
+    kind: "line";
+    seriesId: string;
+    path: string;
+    /** 선 보간 방식 — step/spline이면 .mc-step/.mc-spline 클래스 추가 */
+    shape?: "linear" | "step" | "spline";
+    points: PointView[];
+} | {
+    kind: "area";
+    seriesId: string;
+    path: string;
+    linePath: string;
+    points: PointView[];
+} | {
+    kind: "bar";
+    seriesId: string;
+    horizontal: boolean;
+    bars: BarView[];
+    /** waterfall 막대 사이 연결선 path — waterfall 타입에서만 설정 */
+    connectorPath?: string;
+} | {
+    kind: "scatter";
+    seriesId: string;
+    points: PointView[];
+} | {
+    kind: "bubble";
+    seriesId: string;
+    points: PointView[];
+} | {
+    kind: "pie";
+    seriesId: string;
+    donut: boolean;
+    slices: SliceView[];
+} | {
+    kind: "funnel";
+    seriesId: string;
+    slices: SliceView[];
+} | {
+    /**
+     * cone-funnel — 단계 높이가 값에 비례하고 외곽이 꼭짓점으로
+     * 수렴하는 퍼널 (AG Charts cone-funnel 해당)
+     */
+    kind: "cone-funnel";
+    seriesId: string;
+    slices: SliceView[];
+    /** 슬라이스별 y 범위 — 균등 분할이 아니므로 hitTest가 참조 */
+    bands: {
+        y0: number;
+        y1: number;
+    }[];
+} | {
+    kind: "pyramid";
+    seriesId: string;
+    slices: SliceView[];
+} | {
+    kind: "heatmap";
+    /** 첫 행 시리즈 id — 그룹 식별용 (셀은 자기 seriesId를 갖는다) */
+    seriesId: string;
+    /** 커스텀 색상 — null이면 --chart-heat-from/to 변수 사용 */
+    from: string | null;
+    to: string | null;
+    cells: HeatCellView[];
+} | {
+    kind: "wordcloud";
+    seriesId: string;
+    words: WordView[];
+} | {
+    /** 레이더 — 폐합 다각형. area=true면 채움(radar-area) */
+    kind: "radar";
+    seriesId: string;
+    path: string;
+    area: boolean;
+    points: PointView[];
+} | {
+    kind: "range-bar";
+    seriesId: string;
+    horizontal: boolean;
+    bars: RangeBarView[];
+} | {
+    /** range-area — 상/하한 사이 채움 밴드 */
+    kind: "range-area";
+    seriesId: string;
+    bandPath: string;
+    points: PointView[];
+} | {
+    kind: "candlestick";
+    seriesId: string;
+    candles: CandleView[];
+} | {
+    /** ohlc — 캔들 대신 시가/종가 틱 선분 (.mc-ohlc-*) */
+    kind: "ohlc";
+    seriesId: string;
+    candles: CandleView[];
+} | {
+    /** boxplot — 카테고리별 5수치 상자 (.mc-box) */
+    kind: "boxplot";
+    seriesId: string;
+    boxes: BoxPlotView[];
+} | {
+    /** 지도 — 국가/지역 폴리곤. 첫 map 시리즈의 mapData로 채움 */
+    kind: "map";
+    seriesId: string;
+    /** 커스텀 색상 — null이면 --chart-map-from/to 변수 사용 */
+    from: string | null;
+    to: string | null;
+    regions: MapRegionView[];
+    /** 마커 레이어 — series.mapPoints (클러스터에 묶인 것 제외) */
+    markers: MapMarkerView[];
+    /** 클러스터 버블 — map.cluster가 켜지고 2개 이상 뭉칠 때 */
+    clusters: MapClusterView[];
+    /** 연결선 레이어 — series.mapLines */
+    lines: MapLineView[];
+    /** panZoom 변환 — 지역/라인 그룹에 적용할 svg transform 문자열 */
+    transform: string | null;
+} | {
+    /** sunburst — 계층 환형 섹터. 깊이별 링 */
+    kind: "sunburst";
+    seriesId: string;
+    nodes: SunburstNodeView[];
+} | {
+    /** treemap — squarified 사각형 분할. 리프만 렌더 */
+    kind: "treemap";
+    seriesId: string;
+    nodes: TreemapNodeView[];
+} | {
+    /** sankey — 노드 열 + 유량 리본 */
+    kind: "sankey";
+    seriesId: string;
+    nodes: SankeyNodeView[];
+    links: SankeyLinkView[];
+} | {
+    /** chord — 행렬 플로우의 원호 그룹 + 리본 */
+    kind: "chord";
+    seriesId: string;
+    /** 중심/반지름 — hitTest용 (ri는 그룹 링의 안쪽 반지름) */
+    cx: number;
+    cy: number;
+    r: number;
+    ri: number;
+    groups: ChordGroupView[];
+    ribbons: ChordRibbonView[];
+} | {
+    /** nightingale — 극좌표 면적. 각도=등분 카테고리, 반지름=값 */
+    kind: "nightingale";
+    seriesId: string;
+    sectors: PolarSectorView[];
+} | {
+    /** radial-bar — 극좌표 막대. 반지름=카테고리 링, 각도=값 */
+    kind: "radial-bar";
+    seriesId: string;
+    sectors: PolarSectorView[];
+} | {
+    /** radial-column — 극좌표 컬럼. 각도=카테고리 방향, 반지름=값 */
+    kind: "radial-column";
+    seriesId: string;
+    sectors: PolarSectorView[];
+} | {
+    /** gauge — 단일 값 다이얼 */
+    kind: "gauge";
+    seriesId: string;
+    gauge: GaugeView;
+} | {
+    /** linear-gauge — 수평 바 게이지 (AG Charts linear-gauge 해당) */
+    kind: "linear-gauge";
+    seriesId: string;
+    gauge: LinearGaugeView;
+} | {
+    /** organization — top-down 조직도 트리 */
+    kind: "organization";
+    seriesId: string;
+    nodes: OrgNodeView[];
+    links: OrgLinkView[];
+} | {
+    /**
+     * pictogram — 카테고리별 행에 사람 아이콘을 값 비례로 채움.
+     * 아이콘 1개 = unit 값 (ISOTYPE 스타일).
+     */
+    kind: "pictogram";
+    seriesId: string;
+    /** 아이콘 1개가 나타내는 값 */
+    unit: number;
+    rows: PictoRowView[];
+};
+export interface TickView {
+    value: number;
+    label: string;
+    /** 축 방향 px 좌표 */
+    pos: number;
+}
+/** 그룹 카테고리 축의 상위 레벨 틱 — 연속 같은 그룹의 범위 + 라벨 */
+export interface GroupTickView {
+    label: string;
+    /** 라벨 위치 — 그룹 범위 중심 (축 방향 px) */
+    pos: number;
+    /** 그룹 시작/끝 경계 (px) — 구분선 위치 */
+    x0: number;
+    x1: number;
+}
+export interface AxisView {
+    id: string;
+    /** 렌더 축 방향 — "x"면 수평, "y"면 수직 */
+    kind: "x" | "y";
+    position: AxisPosition;
+    scale: ScaleKind;
+    ticks: TickView[];
+    /**
+     * 그룹 카테고리의 상위 레벨 틱 — categories 항목이 배열일 때
+     * (.mc-tick-group). 두 번째 틱 행으로 렌더된다.
+     */
+    groups?: GroupTickView[];
+    label?: string;
+    grid: boolean;
+}
+export interface LegendItemView {
+    /** series id 또는 "slice:N" */
+    id: string;
+    label: string;
+    color: string | null;
+    colorIndex: number;
+    visible: boolean;
+    kind: "series" | "slice";
+}
+export interface TooltipRowView {
+    seriesId: string;
+    name: string;
+    color: string | null;
+    colorIndex: number;
+    value: string;
+    /** 포인트/시리즈 부가 데이터 (etcData) — tooltip.render에서 접근 */
+    etcData?: unknown;
+}
+export interface TooltipView {
+    /** .mc-viewport 기준 px 앵커 */
+    x: number;
+    y: number;
+    title: string;
+    rows: TooltipRowView[];
+    /**
+     * tooltip.render의 커스텀 HTML — 있으면 기본 행 마크업 대신
+     * .mc-tooltip의 내용으로 삽입된다
+     */
+    html?: string;
+}
+/** 컨텍스트 메뉴 항목 뷰 — .mc-menu-item */
+export interface MenuItemView {
+    id: string;
+    label: string;
+    /** 내장 항목 여부 — reset-zoom/export-svg/export-png */
+    builtin?: boolean;
+}
+/** 컨텍스트 메뉴 뷰 — .mc-menu (우클릭으로 열림) */
+export interface MenuView {
+    /** .mc-viewport 기준 px 위치 */
+    x: number;
+    y: number;
+    items: MenuItemView[];
+}
+/**
+ * getState/setState의 가시성·준 스냅 — AG Charts state 저장/복원 해당.
+ * 데이터 자체는 포함하지 않는다 (시리즈/카테고리는 setData로).
+ */
+export interface ChartState {
+    type?: ChartType;
+    theme?: ChartTheme;
+    /** x 줌 창 — null이면 미줌 */
+    window?: DomainWindow | null;
+    /** 값 축 줌 창 (axes:"y"|"xy") */
+    yWindow?: DomainWindow | null;
+    /** 숨겨진 범례 id — 시리즈 id 또는 "slice:N" */
+    hidden?: string[];
+    /** 선택된 포인트 */
+    selected?: FocusPoint | null;
+    /** 그린 주석 — 데이터 좌표 그대로 왕복된다 */
+    drawings?: DrawingInput[];
+    /** 범례 페이지 — pagination 켜진 경우 */
+    legendPage?: number;
+}
+/** sparkline 마운트 옵션 — 축/범례 없는 미니 라인·영역·막대 */
+export interface SparklineOptions {
+    /** 기본 "line" */
+    type?: "line" | "area" | "bar";
+    values: readonly (number | null)[];
+    /** 선/채움 색 — 기본 --chart-palette-1 */
+    color?: string;
+    width?: number;
+    height?: number;
+    /** 값 도메인 override — 없으면 데이터 min/max */
+    min?: number;
+    max?: number;
+    /** area 채움 불투명도 (기본 0.2) */
+    fillOpacity?: number;
+}
+export interface SelectionView {
+    /** .mc-viewport 기준 px */
+    x: number;
+    w: number;
+    min: number;
+    max: number;
+    /**
+     * y 범위 선택(영역 줌)일 때만 설정 — rect의 y/h.
+     * 없으면 플롯 전체 높이로 렌더된다.
+     */
+    y?: number;
+    h?: number;
+    minY?: number;
+    maxY?: number;
+    /** 선택 범위에 포함되는 카테고리 인덱스 */
+    indices: number[];
+}
+export interface HoverInfo {
+    seriesId: string;
+    index: number;
+    value: number | null;
+    label: string;
+    /** 클러스터 히트 — 묶인 mapPoints 인덱스 (지도 클러스터만) */
+    members?: readonly number[];
+}
+export interface FocusPoint {
+    seriesId: string;
+    index: number;
+}
+/** 값 라벨 뷰 — .mc-data-label text */
+export interface DataLabelView {
+    key: string;
+    /** svg 좌표 */
+    x: number;
+    y: number;
+    text: string;
+    /** 텍스트 기준점 — css로 translate/anchor 결정 */
+    anchor: "middle" | "start" | "end";
+}
+/** 값 축 기준선 뷰 — .mc-mark-line */
+export interface MarkLineView {
+    key: string;
+    /** svg 좌표 — plot 안 수평/수직 선 */
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    label?: string;
+    /** 라벨 앵커 좌표 */
+    lx: number;
+    ly: number;
+    color: string | null;
+}
+/** 값 축 기준 영역 뷰 — .mc-mark-band rect */
+export interface MarkBandView {
+    key: string;
+    /** svg 좌표 — plot 안에 clamp된 rect */
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    label?: string;
+    /** 라벨 앵커 좌표 */
+    lx: number;
+    ly: number;
+    color: string | null;
+}
+/** 구독자에게 전달되는 읽기 전용 스냅샷 — 어댑터는 이것만 렌더한다 */
+export interface ChartSnapshot {
+    type: ChartType;
+    width: number;
+    height: number;
+    /** 플롯 영역 (svg 좌표계) */
+    plot: Rect;
+    theme: ChartTheme;
+    animate: boolean;
+    animationDuration: number;
+    /**
+     * 직전 무효화가 데이터 변경( setData/실시간 API/updateDelta )으로
+     * 발생했는지 — animation.updates가 켜져 있으면 루트에 .mc-updating이
+     * 붙어 갱신 전환이 재생된다. 다음 스냅샷에서 해제된다.
+     */
+    updating: boolean;
+    ariaLabel: string;
+    /** 인스턴스 고유 id — clipPath id 충돌 방지 */
+    clipId: string;
+    /** 데이터 없음 — .mc-empty 렌더 */
+    empty: boolean;
+    /** 데이터 없음 텍스트 */
+    emptyText: string;
+    /** 제목/부제목 — null이면 .mc-title/.mc-subtitle 숨김 */
+    title: string | null;
+    subtitle: string | null;
+    /** 로딩 오버레이 상태 */
+    loading: boolean;
+    /** 값 라벨 (.mc-data-label) */
+    dataLabels: DataLabelView[];
+    /** 값 축 기준선 (.mc-mark-line) */
+    markLines: MarkLineView[];
+    /** 값 축 기준 영역 (.mc-mark-band) */
+    markBands: MarkBandView[];
+    /** 접근성 패턴 채우기 활성 여부 — defs에 .mc-pattern 생성 */
+    patterns: boolean;
+    /** 드릴다운 깊이 — 0보다 크면 .mc-drillup 버튼 표시 */
+    drillDepth: number;
+    /** 인라인 주석 (.mc-annotation) */
+    annotations: AnnotationView[];
+    /** 그린 주석 (.mc-drawings 안 .mc-draw-*) — draft 포함 */
+    drawings: DrawingView[];
+    /** 활성 그리기 도구 — null이면 드래그는 줌/선택 */
+    drawMode: DrawTool | null;
+    /** 범례 페이지네이션 — null이면 단일 페이지 */
+    legendPage: {
+        page: number;
+        pages: number;
+        size: number;
+    } | null;
+    /** 에러바 오버레이 — series.errors가 있는 시리즈의 포인트별 오차 */
+    errors: ErrorBarView[];
+    /** 추세선 오버레이 — series.trend가 있는 시리즈 */
+    trendLines: TrendLineView[];
+    /** 레이더 축 그리드 — radar/radar-area 타입에서만 */
+    radar: RadarGridView | null;
+    /** 네비게이터 미니맵 — navigator 옵션이고 직교 차트일 때 */
+    navigator: NavigatorView | null;
+    /** 스크롤바 스트립 — scrollbar 옵션이고 네비게이터가 없을 때 */
+    scrollbar: NavigatorView | null;
+    /** 범례 체크박스 — legend.checkboxes이면 .mc-legend-check 렌더 */
+    legendChecks: boolean;
+    /** 열린 컨텍스트 메뉴 — null이면 닫힘 */
+    menu: MenuView | null;
+    /** 지도 값 범례 — map 타입이고 mapData가 있을 때 (.mc-map-scale) */
+    mapScale: MapScaleView | null;
+    /** 선택된 포인트 (allowPointSelect) — 없으면 null */
+    selected: FocusPoint | null;
+    /** 로케일이 적용된 툴바 문구 */
+    labels: {
+        /** .mc-drillup 버튼 텍스트 */
+        drillUp: string;
+        /** .mc-zoom-reset 버튼 텍스트 */
+        reset: string;
+    };
+    series: SeriesView[];
+    geometry: GeometryView[];
+    /** 렌더 순서 무관 — kind/position으로 배치 */
+    axes: AxisView[];
+    legend: LegendItemView[];
+    legendPosition: LegendPosition;
+    tooltip: TooltipView | null;
+    /** 공유 툴팁의 세로 가이드선 (plot 상대 x) */
+    crosshair: number | null;
+    selection: SelectionView | null;
+    zoomed: boolean;
+    focused: FocusPoint | null;
+    /** aria-live로 읽을 포커스/호버 설명 */
+    a11yText: string;
+}
+export type ChartEventType = "ready" | "seriesClick" | "pointDblClick" | "chartClick" | "legendToggle" | "legendHover" | "zoomChange" | "selectionChange" | "hoverChange" | "focusChange" | "visibilityChange" | "dataChange" | "themeChange" | "typeChange" | "loadingChange" | "drilldown" | "drillup" | "drillupall" | "legendCheck" | "menuAction" | "pointSelect" | "pointUnselect" | "beforePrint" | "afterPrint" | "pointUpdate" | "redraw" | "resize" | "export" | "drawEnd" | "searchEnd" | "searchError" | "clusterSelect";
+export interface ChartEventMap {
+    ready: {
+        snapshot: ChartSnapshot;
+    };
+    /** 플롯 클릭 — point는 히트 결과 (빈 영역이면 null) */
+    chartClick: {
+        point: HoverInfo | null;
+    };
+    seriesClick: {
+        seriesId: string;
+        index: number;
+        value: number | null;
+    };
+    pointDblClick: {
+        seriesId: string;
+        index: number;
+        value: number | null;
+    };
+    legendToggle: {
+        id: string;
+        visible: boolean;
+    };
+    /** 범례 항목 hover — id 또는 해제 시 null. 다른 시리즈가 dim된다 */
+    legendHover: {
+        id: string | null;
+    };
+    visibilityChange: {
+        seriesId: string;
+        visible: boolean;
+    };
+    zoomChange: {
+        window: DomainWindow | null;
+        /** axes:"y"|"xy" 줌의 값 축 창 — 없으면 null */
+        yWindow: DomainWindow | null;
+    };
+    selectionChange: {
+        range: DomainWindow | null;
+        indices: number[];
+    };
+    hoverChange: {
+        point: HoverInfo | null;
+    };
+    focusChange: {
+        point: FocusPoint | null;
+    };
+    /** setData 적용 시 */
+    dataChange: {
+        seriesCount: number;
+        categoryCount: number;
+    };
+    themeChange: {
+        theme: ChartTheme;
+    };
+    typeChange: {
+        type: ChartType;
+    };
+    loadingChange: {
+        loading: boolean;
+    };
+    /** 컨테이너 크기 변경 시 (setSize 경유) */
+    resize: {
+        width: number;
+        height: number;
+    };
+    /** 드릴다운 진입 — key는 drilldown 옵션 맵의 키(포인트 라벨) */
+    drilldown: {
+        key: string;
+        depth: number;
+    };
+    /** 한 레벨 위로 복귀 */
+    drillup: {
+        depth: number;
+    };
+    /** 최상위 레벨로 일괄 복귀 — drillUpAll() (IBChart drillupall 해당) */
+    drillupall: {
+        depth: number;
+    };
+    /** 범례 체크박스 클릭 — checked는 새 가시성 (IBChart seriesCheckBoxClick 해당) */
+    legendCheck: {
+        id: string;
+        checked: boolean;
+    };
+    /** 컨텍스트 메뉴 커스텀 항목 선택 — 내장 항목은 코어가 직접 처리 */
+    menuAction: {
+        id: string;
+    };
+    /** allowPointSelect 클릭/API로 포인트 선택 */
+    pointSelect: {
+        seriesId: string;
+        index: number;
+        value: number | null;
+        /** 포인트/시리즈 부가 데이터 (etcData) */
+        etcData?: unknown;
+    };
+    /** 선택 해제 — 재클릭/Escape/데이터 리셋 */
+    pointUnselect: {
+        seriesId: string;
+        index: number;
+    };
+    /** window beforeprint/afterprint 전달 (IBChart 동명 이벤트 해당) */
+    beforePrint: Record<string, never>;
+    afterPrint: Record<string, never>;
+    /** updatePoint/API로 포인트 값 변경 (IBChart pointUpdate 해당) */
+    pointUpdate: {
+        seriesId: string;
+        index: number;
+        value: number | null;
+    };
+    /** redraw() 호출 등 재렌더 요청 시 */
+    redraw: Record<string, never>;
+    export: {
+        format: "svg" | "png";
+    };
+    /** 주석 그리기 완료 — 드래그 종료로 drawings에 추가될 때 */
+    drawEnd: {
+        drawing: DrawingInput;
+    };
+    /** search.load 완료 — setData가 적용된 뒤 발행 (IBChart searchEnd 해당) */
+    searchEnd: {
+        seriesCount: number;
+        categoryCount: number;
+    };
+    /** search.load 실패 — 네트워크/변환 오류 */
+    searchError: {
+        message: string;
+    };
+    /**
+     * 지도 클러스터 클릭 — map.cluster로 묶인 마커 버블.
+     * members는 mapPoints 인덱스, points는 해당 입력 레코드.
+     */
+    clusterSelect: {
+        seriesId: string;
+        members: readonly number[];
+        points: readonly ChartMapPoint[];
+    };
+}
+/** 이벤트 핸들러 맵 — 옵션/구독 양쪽에서 사용 */
+export type ChartEventHandlers = {
+    [K in ChartEventType]?: (e: ChartEventMap[K]) => void;
+};
+//# sourceMappingURL=types.d.ts.map