csat-chart.js 1.2.0

package/dist/csat-chart.d.cts

@@ -0,0 +1,914 @@
+interface EnsureFontsOptions {
+    /**
+     * 글꼴 CSS 주소. 기본은 Google Fonts. 사내망·오프라인이면 바꾼다.
+     *
+     * `families` 와 짝이다. 한쪽만 바꾸면 어긋난다 — 예컨대 `families` 만
+     * 바꾸면 기본 구글 스타일시트가 그 글꼴을 제공하지 않는데도 `true` 가
+     * 나온다(아래 반환값 설명 참고).
+     */
+    href?: string;
+    /** 확인할 글꼴 이름. 기본은 Noto Serif KR, Noto Sans KR. `href` 와 함께 바꾼다. */
+    families?: string[];
+    /** 이 시간(ms) 안에 준비되지 않으면 false 를 돌려주고 넘어간다. 기본 5000 */
+    timeoutMs?: number;
+}
+/**
+ * 시험지 양식에 쓰이는 글꼴을 확보한다.
+ *
+ * 브라우저에서만 일한다. 준비되면 `true`, 시간 안에 못 받거나 Node 이거나
+ * 브라우저가 `document.fonts` 를 모르면 `false` 를 돌려준다. **던지지 않는다** —
+ * 글꼴이 없어도 그림은 대체 글꼴로 그려져야 하기 때문이다.
+ *
+ * ⚠️ `true` 가 «그 글꼴로 그려진다» 를 보장하지는 않는다. `document.fonts.load`
+ * 는 페이지에 `@font-face` 가 없는 이름에 대해 거부하지 않고 **빈 배열로
+ * 이행한다**. 그래서 `href` 없이 `families` 만 바꾸면 없는 글꼴에도 `true` 가
+ * 나온다. 둘은 함께 바꾼다.
+ *
+ * ⚠️ 여러 번 불러도 실제 작업은 한 번만 하는데, **나중 호출의 옵션은 조용히
+ * 버려진다.** 앞선 호출이 이미 시작했으면 그 약속을 그대로 돌려준다. 사내망
+ * 주소를 쓸 것이라면 **가장 먼저** 그 옵션으로 부른다.
+ *
+ * ⚠️ «한 번만» 은 이 모듈 한 벌 기준이다. 한 페이지에 ESM 판과 CDN 판이 함께
+ * 올라오면 각자 한 번씩 한다. `<link>` 는 id 로 걸러지므로 두 번 들어가지는
+ * 않는다.
+ */
+declare function ensureFonts(options?: EnsureFontsOptions): Promise<boolean>;
+
+type LegendPosition = 'bottom' | 'right';
+/** 플롯 안쪽 범례를 놓을 모서리 */
+type InsideLegendCorner = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+interface GraphOptions {
+    title: string;
+    source: string;
+    /**
+     * 출처 줄 **왼쪽**에 함께 적는 글 (예: 자료 연도 `(2024)`).
+     *
+     * 주면 출처 줄이 각주 **아래**로 내려가고 왼쪽·오른쪽에 나눠 적힌다.
+     * 미지정이면 기존대로 출처가 각주 위에 오른쪽 정렬로만 놓인다.
+     */
+    sourceLeft?: string;
+    /**
+     * 출처를 **마지막 각주와 같은 줄** 오른쪽 끝에 적는다 (각주는 왼쪽 끝).
+     *
+     * 시험지 관습이다 — 원본은 `* 1991~2020년의 평년값임.` 과 `(기상청)` 이
+     * 한 줄에 좌우로 놓인다. 미지정이면 기존대로 출처가 각주 **위** 줄에 놓인다.
+     * 각주가 없으면 아무 차이가 없다.
+     */
+    sourceInline?: boolean;
+    footnotes: string[];
+    fontFamily: 'serif' | 'sans' | 'custom';
+    customFont: string;
+    fontSize: {
+        title: number;
+        axisLabel: number;
+        tick: number;
+        dataLabel: number;
+    };
+    showDataLabels: boolean;
+    showLegend: boolean;
+    legendPosition: LegendPosition;
+    legendLabel1: string;
+    legendLabel2: string;
+}
+declare function createDefaultGraphOptions(): GraphOptions;
+
+interface ClimateMonthData {
+    temp: number;
+    precip: number;
+}
+type MonthInterval = 12 | 4 | 2;
+interface ClimateGraphData {
+    months: ClimateMonthData[];
+    monthInterval: MonthInterval;
+    tempLabel: string;
+    precipLabel: string;
+    tempRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+        step?: number;
+    };
+    precipRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+        step?: number;
+    };
+}
+type ClimateMode = 'normal' | 'deviationA' | 'deviationB';
+interface DeviationAData {
+    baseMonths: ClimateMonthData[];
+    months: ClimateMonthData[];
+    monthInterval: MonthInterval;
+    tempLabel: string;
+    precipLabel: string;
+    /** step 을 주면 눈금 간격을 그 값으로 고정한다. 미지정이면 기존대로 자동 계산 */
+    tempRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+        step?: number;
+    };
+    precipRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+        step?: number;
+    };
+    /**
+     * 막대 채움을 하나로 고정한다. 미지정이면 기존대로 양수는 진회색,
+     * 음수는 연회색으로 나뉜다. 시험지는 부호와 무관하게 한 색이다.
+     */
+    barFill?: string;
+    /** 막대 테두리색 — 미지정이면 `#444` */
+    barStroke?: string;
+    /** 꺾은선의 점 모양 — 미지정이면 원. 시험지는 검은 정사각형을 쓴다. */
+    markerShape?: 'circle' | 'square';
+    /**
+     * 좌·우 축 이름. 주면 눈금 숫자 바깥에 **한 글자씩 세로로** 쌓아 그린다.
+     * 미지정이면 단위 표기(tempLabel·precipLabel)만 축 위에 놓는다.
+     */
+    tempAxisName?: string;
+    precipAxisName?: string;
+    /** 범례를 플롯 안쪽 모서리 상자에 둔다. 자료를 덮는 모서리는 피한다. */
+    insideLegend?: InsideLegendCorner;
+    /** 위·오른쪽까지 이어 사각 테두리로 감싼다. 미지정이면 ㄷ자 축선만 그린다. */
+    showFrame?: boolean;
+}
+interface DeviationBRegion {
+    label: string;
+    precip: number;
+    temp: number;
+}
+interface DeviationBData {
+    baseTemp: number;
+    basePrecip: number;
+    regions: DeviationBRegion[];
+    precipDiffLabel: string;
+    tempDiffLabel: string;
+    precipUnit: string;
+    tempUnit: string;
+    precipRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+    };
+    tempRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+    };
+}
+declare function createDefaultDeviationAData(): DeviationAData;
+declare function createDefaultDeviationBData(): DeviationBData;
+declare function createDefaultClimateData(): ClimateGraphData;
+
+interface PyramidAgeData {
+    male: number;
+    female: number;
+}
+type PyramidUnit = 'count' | 'percent';
+type AgeLabelSide = 'left' | 'right' | 'center';
+interface PyramidGraphData {
+    ages: PyramidAgeData[];
+    unit: PyramidUnit;
+    maleLabel: string;
+    femaleLabel: string;
+    axisLabel: string;
+    range: {
+        max: number;
+        auto: boolean;
+    };
+    ageLabelSide: AgeLabelSide;
+    /**
+     * 세로축을 연령대 이름(0-4, 5-9…) 대신 **나이 수치 눈금**으로 그린다.
+     * 시험지 피라미드가 이 방식이다 — 왼쪽에 (세) 0/20/40/60/80.
+     * 미지정이면 기존대로 연령대 이름을 쓴다.
+     */
+    numericAgeAxis?: boolean;
+    /** 나이 축 단위 표기 (numericAgeAxis 일 때만). 예: '(세)' */
+    ageUnit?: string;
+    /**
+     * 가로축 단위 표기를 눈금 **숫자와 같은 줄** 오른쪽 끝에 둔다.
+     * 시험지 피라미드가 이 배치다. 미지정이면 기존대로 숫자 아랫줄에 적는다.
+     */
+    axisLabelInline?: boolean;
+    /**
+     * 남·여 막대 채움색 [남, 여]. 미지정이면 기존 색(진회색/연회색).
+     * 시험지는 둘 다 같은 연회색에 검정 테두리다.
+     */
+    sexFills?: [string, string];
+}
+declare function createDefaultPyramidData(): PyramidGraphData;
+
+interface TernaryPoint {
+    a: number;
+    b: number;
+    c: number;
+    label: string;
+}
+type TernaryGridInterval = 10 | 20 | 25;
+interface TernaryGraphData {
+    points: TernaryPoint[];
+    axisLabels: [string, string, string];
+    gridInterval: TernaryGridInterval;
+}
+declare function createDefaultTernaryData(): TernaryGraphData;
+
+type StackedDisplayMode = 'bar' | 'pie';
+type StackedBarDirection = 'vertical' | 'horizontal';
+interface StackedCategory {
+    label: string;
+    values: number[];
+    /**
+     * 이 막대에서 세그먼트를 쌓을 순서 (아래→위). 계열 번호를 늘어놓는다.
+     *
+     * 시험지 누적 막대는 막대마다 **자기 값 순서로** 쌓는다(큰 값이 아래,
+     * '기타'가 맨 위). 계열 순서는 모든 막대가 공유하므로 그것만으로는
+     * 재현할 수 없다. 미지정이면 기존대로 계열 번호 순으로 쌓는다.
+     */
+    segmentOrder?: number[];
+}
+interface StackedGraphData {
+    displayMode: StackedDisplayMode;
+    barDirection: StackedBarDirection;
+    categories: StackedCategory[];
+    seriesLabels: string[];
+    unit: string;
+    /**
+     * 계열별 채움 직접 지정. `'pattern:diagonal'` 처럼 적으면 패턴을 쓴다.
+     * 미지정이면 기존 팔레트(getStackedFill).
+     */
+    seriesFills?: string[];
+    /**
+     * 값 대신 **계열 이름**을 세그먼트 안에 적는다.
+     *
+     * 시험지 누적 막대는 범례 없이 칸마다 이름을 적는 경우가 많다.
+     * 패턴 위에서도 읽히도록 글자에 흰 테두리를 두르고, 어두운 채움 위에서는
+     * 흰 글자로 쓴다. 미지정이면 기존대로 `showDataLabels` 에 따라 값을 적는다.
+     */
+    labelInSegment?: boolean;
+    /**
+     * 계열 이름이 기호(A·B)인지 실제 이름인지. 시험지는 기호를 명조,
+     * 지명을 고딕으로 쓴다. 미지정이면 전부 본문 글꼴.
+     */
+    seriesIsSymbol?: boolean[];
+    /** 가로 격자선 색 — 미지정이면 `#ddd`. 시험지는 더 진하다. */
+    gridColor?: string;
+    pieRotation?: number;
+    pieScale?: number;
+    axisStep?: number;
+}
+declare function createDefaultStackedData(): StackedGraphData;
+
+type AbsBarDirection = 'vertical' | 'horizontal';
+interface AbsBarCategory {
+    label: string;
+    values: number[];
+}
+interface AbsBarGraphData {
+    barDirection: AbsBarDirection;
+    stacked: boolean;
+    categories: AbsBarCategory[];
+    seriesLabels: string[];
+    unit: string;
+    yRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+        step?: number;
+    };
+    fitMax?: boolean;
+    /**
+     * 계열별 채움색 직접 지정. 미지정이면 기존 팔레트(getStackedFill)를 쓴다.
+     * 원본 시험지를 재현할 때 기본 팔레트와 색이 다른 경우에 쓴다.
+     */
+    seriesFills?: string[];
+    /**
+     * 0을 기준으로 막대를 그린다. 음수는 0에서 아래로 내려가고 0 위치에 실선을 긋는다.
+     *
+     * 미지정이면 기존대로 축 바닥에서 막대가 자란다. 축이 음수까지 내려가는
+     * 편차 그래프에서는 그 방식이 막대를 허공에 띄운 것처럼 보이게 한다.
+     */
+    zeroBaseline?: boolean;
+    /**
+     * 범주 라벨을 0선 바로 아래에 놓는다. 미지정이면 플롯 아래(축 바깥)에 놓는다.
+     *
+     * 시험지마다 다르다 — 2026 수능 한국지리 6번은 0선 아래, 2025 수능
+     * 세계지리 19번은 플롯 아래다. 그래서 zeroBaseline 과 따로 둔다.
+     */
+    categoryLabelAtBaseline?: boolean;
+    /**
+     * 범주를 묶어 2단 라벨로 만든다 (가로 막대 전용).
+     *
+     * 시험지에서 흔한 형태다 — 바깥 라벨이 A·B·C, 안쪽 라벨이 1990년·2020년.
+     * `span` 은 그 그룹에 속한 범주 개수이고, 합이 categories 길이와 같아야 한다.
+     * 그룹 안 막대는 서로 붙고 그룹 사이는 벌어진다.
+     *
+     * 미지정이면 기존대로 범주마다 라벨 하나를 고르게 배치한다.
+     */
+    groups?: {
+        label: string;
+        span: number;
+    }[];
+    /**
+     * 범례를 플롯 안쪽 모서리에 작은 상자로 둔다.
+     *
+     * 미지정이면 기존대로 options.legendPosition 을 따라 플롯 바깥에 그린다.
+     */
+    insideLegend?: 'top-right' | 'top-left';
+    /**
+     * 단위를 마지막 눈금 숫자 바로 옆에 붙인다 (가로 막대 전용).
+     *
+     * 원본 시험지는 축 끝이 `100(EJ)` 처럼 붙어 있다.
+     * 미지정이면 기존대로 축 오른쪽에 조금 떨어뜨려 그린다.
+     */
+    unitAdjacent?: boolean;
+}
+declare function createDefaultAbsBarData(): AbsBarGraphData;
+
+type ScatterMode = 'normal' | 'deviation';
+interface ScatterPoint {
+    x: number;
+    y: number;
+    size: number;
+    label: string;
+    /**
+     * 이 점(버블)의 채움색. 미지정이면 기존 회색을 쓴다.
+     * 크기와 별개인 두 번째 값(예: 1인당 GDP 구간)을 색으로 나타낼 때 쓴다.
+     */
+    fill?: string;
+}
+/**
+ * 버블 범례 자리.
+ *
+ * `outside-right` 는 플롯 **바깥** 오른쪽 여백에 세로로 쌓는다. 자료를 아예
+ * 덮지 않으므로 점이 많을 때 가장 안전하다. 나머지는 플롯 안쪽 모서리이고,
+ * 버블을 덜 덮는 쪽으로 알아서 옮겨 간다.
+ */
+type BubbleLegendPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'outside-right';
+interface ScatterGraphData {
+    mode: ScatterMode;
+    points: ScatterPoint[];
+    bubbleLegendPosition: BubbleLegendPosition;
+    xLabel: string;
+    yLabel: string;
+    xUnit: string;
+    yUnit: string;
+    /** step 을 주면 눈금 간격을 그 값으로 고정한다. 미지정이면 기존대로 자동 계산 */
+    xRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+        step?: number;
+    };
+    yRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+        step?: number;
+    };
+    showBubble: boolean;
+    bubbleScale: number;
+    /**
+     * 바깥 사각 테두리를 그린다. 미지정이면 그린다(기존 동작).
+     * 시험지 편차 그래프는 테두리 없이 교차하는 두 축만 둔다.
+     *
+     * **편차 모드 전용이다.** 일반 모드의 틀은 `examFrame` 이 정한다.
+     */
+    showFrame?: boolean;
+    /**
+     * 일반 모드의 틀을 시험지 모양으로 바꾼다. 세 가지가 함께 간다 —
+     * 시험지 산점도에서 늘 같이 나타나므로 하나로 묶었다.
+     *
+     * 1. 플롯을 사각 테두리로 감싼다 (기본은 왼쪽·아래 축선만)
+     * 2. 격자를 진한 점선으로 (기본은 아주 연한 회색)
+     * 3. x축 단위를 **마지막 눈금 옆**에 둔다 — 원본은 `4(℃)` 꼴이다
+     *    (기본은 축 이름과 같은 줄 오른쪽 끝)
+     *
+     * 미지정이면 기존 동작 그대로다.
+     */
+    examFrame?: boolean;
+    /**
+     * 축 이름을 상자에 넣어 y는 그래프 위, x는 그래프 오른쪽에 세운다.
+     * 시험지 편차 그래프 관습이다. 미지정이면 기존대로 축 옆에 쓴다.
+     * 편차 모드에서만 쓴다.
+     */
+    boxedAxisLabels?: boolean;
+    /**
+     * 눈금과 눈금 숫자를 가운데 십자선 축에 붙인다. 미지정이면 플롯 가장자리에 붙인다.
+     * 테두리를 끄면(showFrame: false) 가장자리에 붙은 눈금이 허공에 뜨므로 함께 쓴다.
+     * 편차 모드에서만 쓴다.
+     */
+    ticksOnAxis?: boolean;
+    /**
+     * 채움색이 무엇을 뜻하는지 알려주는 범례. 버블 크기 범례 아래에 놓인다.
+     * 미지정이면 그리지 않는다.
+     */
+    fillLegend?: {
+        title: string;
+        items: {
+            label: string;
+            fill: string;
+        }[];
+    };
+    /**
+     * 버블 크기 범례에 쓸 항목을 직접 지정한다.
+     * 미지정이면 최댓값에서 자동으로 세 단계를 잡고 숫자를 그대로 쓴다 —
+     * 인구처럼 자릿수가 큰 값은 그대로 두면 읽을 수 없으므로 여기서 정해 준다.
+     */
+    bubbleLegendItems?: {
+        size: number;
+        label: string;
+    }[];
+    quadrantLabels: [string, string, string, string];
+}
+declare function createDefaultScatterData(): ScatterGraphData;
+
+type HythergraphMode = 'loop' | 'points' | 'both';
+type MonthLabelStyle = 'number' | 'english';
+interface HythergraphSeries {
+    label: string;
+    months: ClimateMonthData[];
+}
+interface HythergraphData {
+    series: HythergraphSeries[];
+    mode: HythergraphMode;
+    monthLabelStyle: MonthLabelStyle;
+    xUnit: string;
+    yUnit: string;
+    xRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+    };
+    yRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+    };
+}
+declare function createDefaultHythergraphData(): HythergraphData;
+
+interface CubePoint {
+    x: number;
+    y: number;
+    z: number;
+    label: string;
+    labelDx: number;
+    labelDy: number;
+}
+interface LabelOffset {
+    x: number;
+    y: number;
+}
+interface CubeAxisConfig {
+    name: string;
+    lowLabel: string;
+    highLabel: string;
+    lowOffset: LabelOffset;
+    highOffset: LabelOffset;
+}
+interface CubeGraphData {
+    points: CubePoint[];
+    xAxis: CubeAxisConfig;
+    yAxis: CubeAxisConfig;
+    zAxis: CubeAxisConfig;
+}
+declare function createDefaultCubeData(): CubeGraphData;
+
+interface RadarSeries {
+    label: string;
+    values: number[];
+}
+interface RadarGraphData {
+    axisLabels: string[];
+    series: RadarSeries[];
+    maxValue: number;
+    autoMax: boolean;
+    gridSteps: number;
+    showFill: boolean;
+}
+declare function createDefaultRadarData(): RadarGraphData;
+
+/** 계열 구분은 색이 아니라 기호 모양으로 한다 (흑백 인쇄 관습) */
+type DotMarker = 'circle' | 'square' | 'triangle' | 'diamond';
+interface CategoryDotCategory {
+    label: string;
+    /** 계열별 값. 계열이 하나면 길이 1. */
+    values: number[];
+}
+interface CategoryDotGraphData {
+    categories: CategoryDotCategory[];
+    seriesLabels: string[];
+    /** 계열별 기호. 미지정이면 DOT_MARKER_ORDER 순서를 쓴다. */
+    seriesMarkers?: DotMarker[];
+    /** y축 단위 — 축 위쪽에 붙는다 (예: '(°C)') */
+    unit: string;
+    /** 점 반지름(px) */
+    dotRadius: number;
+    yRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+        step?: number;
+    };
+    /**
+     * 0 위치에 실선을 긋는다. 편차 그래프에서 기준선을 보이게 하려고 쓴다.
+     * 점 자체는 값 위치에 찍히므로 막대와 달리 기준선이 그리기에 영향을 주지 않는다.
+     */
+    zeroBaseline?: boolean;
+}
+declare function createDefaultCategoryDotData(): CategoryDotGraphData;
+
+/** 선 종류 — 흑백 인쇄에서 계열을 구분하는 수단 */
+type LineStyle = 'solid' | 'dashed' | 'dotted' | 'dashdot';
+/** 꼭짓점 기호 — 선 종류만으로 부족할 때 함께 쓴다 */
+type LineMarker = 'circle' | 'square' | 'triangle' | 'diamond';
+interface LineSeries {
+    label: string;
+    /** xLabels 와 같은 길이. 빠진 값은 null 로 둔다 (선이 끊긴다). */
+    values: (number | null)[];
+    lineStyle?: LineStyle;
+    marker?: LineMarker;
+    /** 기호 속을 비운다 (흰색 채움 + 검정 테두리) */
+    hollowMarker?: boolean;
+    /**
+     * 면적 채움색. 주면 이 계열의 선 아래를 채운다.
+     * `stacked` 와 함께 쓰면 아래 계열의 경계까지만 채워 누적 면적이 된다.
+     */
+    areaFill?: string;
+}
+/** 계열 이름을 어디에 쓸지 */
+type LineLabelPlacement = 'lineEnd' | 'legend';
+interface LineGraphData {
+    series: LineSeries[];
+    /** x축 눈금 이름 (예: 1~12월) */
+    xLabels: string[];
+    /** x축 끝에 붙는 단위 (예: '(월)') */
+    xUnit: string;
+    /** y축 위에 붙는 단위 (예: '(°C)') */
+    yUnit: string;
+    yRange: {
+        min: number;
+        max: number;
+        auto: boolean;
+        step?: number;
+    };
+    /** 기본은 시험지 관습대로 선 끝 */
+    labelPlacement: LineLabelPlacement;
+    showMarkers: boolean;
+    /** 0 위치에 점선 기준선을 긋는다 (편차 그래프) */
+    zeroBaseline?: boolean;
+    /**
+     * 계열을 아래에서부터 쌓아 올린다 (누적 면적 그래프).
+     * 각 계열의 선은 "그때까지의 합"을 나타낸다.
+     */
+    stacked?: boolean;
+    /**
+     * 범례를 플롯 안쪽 왼쪽 위에 작은 상자로 둔다.
+     * 시험지 누적 면적 그래프가 이 방식이다. `labelPlacement:'legend'` 와 함께 쓴다.
+     */
+    insideLegend?: boolean;
+}
+declare function createDefaultLineData(): LineGraphData;
+
+interface MatrixTableData {
+    /**
+     * 대각선 칸에 들어갈 이름. 문제에서 가릴 이름은 이미 (가)·(나)로
+     * 바꿔서 넘긴다 — 렌더러는 무엇을 가렸는지 모른다.
+     */
+    names: string[];
+    /**
+     * 짝별 값. `values[i][j]`(j < i)만 쓴다 — 위 삼각형과 대각선은 무시한다.
+     * 정사각 행렬을 그대로 넘겨도 된다.
+     */
+    values: number[][];
+    /**
+     * 이름이 기호인지((가)·A) 실제 지명인지.
+     *
+     * 시험지는 **기호를 명조, 지명을 고딕**으로 쓴다. 미지정이면 전부
+     * 본문 글꼴(`options.fontFamily`)을 쓴다.
+     */
+    nameIsSymbol?: boolean[];
+    /** 오른쪽 위에 붙는 단위 표기. 예: `'(단위 : km)'` */
+    unit: string;
+    /** 이름 칸 채움색 — 미지정이면 연회색 */
+    nameFill?: string;
+    /** 천 단위 쉼표 — 미지정이면 붙인다 (원본이 `2,648` 꼴이다) */
+    groupThousands?: boolean;
+}
+declare function createDefaultMatrixTableData(): MatrixTableData;
+
+interface DataTableRow {
+    /** 항목 이름. 예: `'기온의 연교차'` */
+    label: string;
+    /** 이름 뒤에 붙는 괄호 단위. 원본은 이름보다 조금 작게 쓴다. 예: `'(℃)'` */
+    unit?: string;
+    /** 머리글 순서대로 놓이는 값 */
+    values: number[];
+    /** 소수점 자릿수. 미지정이면 1자리 — 시험지 표는 대개 소수 한 자리다. */
+    decimals?: number;
+}
+interface DataTableData {
+    /** 왼쪽 위 모서리 칸. 원본은 `'구분'` */
+    cornerLabel: string;
+    /**
+     * 머리글. 시험지는 지역을 (가)~(라) 처럼 기호로 가린다.
+     * 문제에서 가릴 이름은 이미 바꿔서 넘긴다 — 렌더러는 무엇을 가렸는지 모른다.
+     */
+    columns: string[];
+    rows: DataTableRow[];
+    /**
+     * 머리글이 기호인지((가)·A) 실제 지명인지.
+     *
+     * 시험지는 **기호를 명조, 지명을 고딕**으로 쓴다. 미지정이면 전부
+     * 본문 글꼴(`options.fontFamily`)을 쓴다.
+     */
+    columnIsSymbol?: boolean[];
+    /** 머리글 행 채움색 — 미지정이면 연회색 */
+    headerFill?: string;
+    /** 천 단위 쉼표 — 미지정이면 붙인다 */
+    groupThousands?: boolean;
+}
+declare function createDefaultDataTableData(): DataTableData;
+
+interface TreemapCell {
+    label: string;
+    /** 넓이의 근거가 되는 값. 렌더러가 합으로 나눠 비율을 낸다. */
+    value: number;
+}
+interface TreemapGraphData {
+    /**
+     * 순서는 배치 결과에만 영향을 준다 — 넓이는 값 비율대로 나뉘므로 어느
+     * 순서든 정확하다. 다만 내림차순이라야 칸이 정사각형에 가깝게 나온다.
+     * '기타'는 값이 더 크더라도 시험지 관행대로 맨 뒤에 둔다.
+     */
+    cells: TreemapCell[];
+    /** 칸 라벨 글자 크기. 미지정이면 options.fontSize.tick 을 쓴다. */
+    labelFontSize?: number;
+    /**
+     * 라벨을 적을 최소 칸 너비(px). 이보다 좁으면 글자를 생략한다.
+     * 좁은 칸에 억지로 넣으면 글자가 테두리를 넘어 옆 칸을 밟는다.
+     */
+    minLabelWidth?: number;
+    /**
+     * 출처가 없어도 출처 한 줄만큼 아래를 비워 둔다.
+     *
+     * 패널을 여러 장 나란히 놓을 때 쓴다 — 출처를 마지막 패널에만 적으면
+     * 그 패널만 상자가 짧아져 줄이 안 맞는다. 모두 같은 자리를 비우면
+     * 상자 높이가 같아지고 출처는 상자 **아래**에 놓인다.
+     */
+    reserveSourceSpace?: boolean;
+}
+declare function createDefaultTreemapData(): TreemapGraphData;
+
+declare function renderAbsBarGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: AbsBarGraphData, options: GraphOptions): void;
+
+declare function renderCategoryDotGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: CategoryDotGraphData, options: GraphOptions): void;
+
+declare function renderLineGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: LineGraphData, options: GraphOptions): void;
+
+declare function renderMatrixTable(ctx: CanvasRenderingContext2D, w: number, h: number, data: MatrixTableData, options: GraphOptions): void;
+
+declare function renderDataTable(ctx: CanvasRenderingContext2D, w: number, h: number, data: DataTableData, options: GraphOptions): void;
+
+declare function renderTreemapGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: TreemapGraphData, options: GraphOptions): void;
+
+declare function renderClimateGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: ClimateGraphData, options: GraphOptions): void;
+
+declare function renderCubeGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: CubeGraphData, options: GraphOptions): void;
+
+declare function renderDeviationAGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: DeviationAData, options: GraphOptions): void;
+
+declare function renderDeviationBGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: DeviationBData, options: GraphOptions): void;
+
+declare function renderHythergraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: HythergraphData, options: GraphOptions): void;
+
+declare function renderPyramidGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: PyramidGraphData, options: GraphOptions): void;
+
+declare function renderRadarChart(ctx: CanvasRenderingContext2D, w: number, h: number, data: RadarGraphData, options: GraphOptions): void;
+
+declare function renderScatterGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: ScatterGraphData, options: GraphOptions): void;
+
+declare function renderStackedGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: StackedGraphData, options: GraphOptions): void;
+
+declare function renderTernaryGraph(ctx: CanvasRenderingContext2D, w: number, h: number, data: TernaryGraphData, options: GraphOptions): void;
+
+/** 적절한 눈금 간격을 자동 계산 */
+declare function niceStep(range: number, maxTicks?: number): number;
+/** 자동 축 범위 계산 (min, max, step) */
+declare function autoRange(values: number[], maxTicks?: number): {
+    min: number;
+    max: number;
+    step: number;
+};
+
+interface ChartDataMap {
+    absbar: AbsBarGraphData;
+    'category-dot': CategoryDotGraphData;
+    climate: ClimateGraphData;
+    cube: CubeGraphData;
+    'data-table': DataTableData;
+    'deviation-a': DeviationAData;
+    'deviation-b': DeviationBData;
+    hythergraph: HythergraphData;
+    line: LineGraphData;
+    'matrix-table': MatrixTableData;
+    pyramid: PyramidGraphData;
+    radar: RadarGraphData;
+    scatter: ScatterGraphData;
+    stacked: StackedGraphData;
+    ternary: TernaryGraphData;
+    treemap: TreemapGraphData;
+}
+/** 그릴 수 있는 그래프 종류. 여러 낱말은 kebab-case, 한 낱말은 그대로. */
+type CsatChartType = keyof ChartDataMap;
+/**
+ * 부분 지정을 허용하는 옵션.
+ *
+ * `Partial` 은 맨 위 칸만 선택으로 만든다. 그래서 `fontSize` 는 넷을 다 적어야
+ * 했다 — 런타임은 하나만 줘도 받는데 타입이 막는, 거꾸로 된 어긋남이다.
+ * 한 겹 더 풀어 준다.
+ */
+type PartialGraphOptions = Omit<Partial<GraphOptions>, 'fontSize'> & {
+    fontSize?: Partial<GraphOptions['fontSize']>;
+};
+/** 한 종류의 설정. `type` 을 적으면 `data` 가 그 종류로 좁혀진다. */
+interface ConfigFor<T extends CsatChartType> {
+    type: T;
+    data: ChartDataMap[T];
+    options?: PartialGraphOptions;
+}
+/** 16종을 모은 판별 유니온. */
+type CsatChartConfig = {
+    [K in CsatChartType]: ConfigFor<K>;
+}[CsatChartType];
+/** 한 종류의 부분 갱신. 준 것만 덮는다. */
+interface UpdateFor<T extends CsatChartType> {
+    data?: ChartDataMap[T];
+    options?: PartialGraphOptions;
+}
+
+/**
+ * 브라우저의 `HTMLCanvasElement` 와 Node 캔버스 구현체가 함께 만족하는 최소 모양.
+ * 라이브러리는 이 이상을 요구하지 않는다.
+ */
+interface CanvasLike {
+    width: number;
+    height: number;
+    getContext(id: '2d'): unknown;
+    toDataURL?(type?: string): string;
+}
+/**
+ * 종류 하나를 붙들고 사는 차트.
+ *
+ * `T` 는 생성자의 `config.type` 에서 추론된다. 그래서 `update()` 의 `data` 도
+ * 같은 종류로 좁혀지고, 다른 종류의 데이터를 넣으면 컴파일 시점에 걸린다.
+ */
+declare class CsatChart<T extends CsatChartType = CsatChartType> {
+    /**
+     * 시험지 글꼴을 확보한다. 자세한 것은 `ensureFonts` 참고.
+     *
+     * 필드가 아니라 **메서드**로 둔다. `static readonly ensureFonts = ensureFonts`
+     * 로 적으면 ES2020 로 낮출 때 클래스 «뒤» 의 대입문이 되는데, 그것은 지울 수
+     * 없는 부수효과라 이 클래스와 레지스트리와 렌더러 16종이 모든 번들에 박힌다.
+     * 메서드는 클래스 본문의 일부라 어느 목표에서도 그런 일이 없다 — 실제로
+     * 겪은 문제이고, `test/bundle.test.ts` 가 이걸 회귀로 잡지는 않으니 여기
+     * 적어 둔다.
+     */
+    static ensureFonts(options?: EnsureFontsOptions): Promise<boolean>;
+    readonly canvas: CanvasLike;
+    private readonly ctx;
+    private readonly type;
+    private data;
+    private options;
+    private destroyed;
+    constructor(target: CanvasLike | string, config: ConfigFor<T>);
+    /** `data`·`options` 중 준 것만 덮고 다시 그린다. 어긋나면 던지고 이전 상태를 지킨다. */
+    update(next: UpdateFor<T>): this;
+    resize(width: number, height: number): this;
+    /**
+     * PNG data URL 을 돌려준다.
+     *
+     * `scale` 은 **글자·선까지 함께 키우는** 배율이다. 캔버스만 키우는
+     * `resize(1600, 1200)` 과 다르다 — 이 라이브러리의 글꼴 크기와 여백은 절대
+     * 픽셀이라, 캔버스를 두 배로 하면 «두 배로 선명한 같은 그림» 이 아니라
+     * «글자가 절반으로 작아진 다른 그림» 이 나온다. 인쇄용으로 뽑으려면 이쪽을 쓴다.
+     */
+    toDataURL(options?: {
+        scale?: number;
+    }): string;
+    /** 브라우저 전용. Node 에서는 `toDataURL()` 이나 캔버스의 버퍼를 쓴다. */
+    download(filename?: string, options?: {
+        scale?: number;
+    }): void;
+    destroy(): void;
+    /**
+     * 글꼴이 늦게 도착하면 한 번 다시 그린다.
+     *
+     * `await CsatChart.ensureFonts()` 를 빠뜨리는 실수가 이 라이브러리에서 가장
+     * 흔할 실패다. 그런데 증상이 조용하고 영구적이다 — 대체 글꼴로 «멀쩡히»
+     * 그려지고, 잠시 뒤 글꼴이 도착해도 아무도 다시 그리지 않는다. 시험지 서체를
+     * 모르는 사람은 무엇이 잘못됐는지조차 알 수 없다. 빌드 도구도 타입 검사도
+     * 없는 사용자에게 그 책임을 문서로만 지울 수는 없다.
+     *
+     * ⚠️ 만능이 아니다. `document.fonts.ready` 는 **부르는 시점에** 로딩 중인
+     * 것이 끝나면 이행한다. 그래서 차트를 먼저 만들고 `ensureFonts()` 를 나중에
+     * 부르면 이 약속은 이미 이행된 뒤라 도움이 안 된다. 순서를 지켜 부르거나,
+     * 그냥 `await` 하는 것이 여전히 옳다.
+     */
+    private redrawWhenFontsArrive;
+    private draw;
+    /**
+     * 논리 크기는 `width`×`height` 로 두고 픽셀만 `scale` 배로 그린다.
+     *
+     * 렌더러들은 변환 행렬을 전혀 건드리지 않으므로(`grep setTransform src/core` →
+     * 없음) 여기서 한 번 걸어 두면 그림 전체가 그대로 확대된다.
+     */
+    private drawScaled;
+    private assertAlive;
+}
+
+/**
+ * 사전순으로 정렬된 전체 종류 목록. 오류 메시지와 데모가 이 순서를 쓴다.
+ *
+ * `Object.freeze` 를 쓰는 까닭: `readonly` 는 타입에만 있고 런타임에는 없다.
+ * 이 패키지는 타입 검사를 받지 않는 CDN 사용자를 겨냥하므로, 얼려 두지 않으면
+ * `CsatChart.CHART_TYPES.reverse()` 한 번에 오류 메시지가 조용히 망가진다.
+ *
+ * 인자 없는 `sort()` 는 로캘을 보지 않고 UTF-16 코드 단위로 비교한다(명세).
+ * 리눅스 CI 의 small-icu 빌드에서도 같은 순서가 나온다.
+ *
+ * 아래 세 PURE 주석을 지우지 말 것. `Object.freeze`·`.sort()`·`Object.keys`
+ * 모두 이 모듈 맨 위에서 실행되는 함수 호출이다 — 번들러는 함수 호출에
+ * 부작용이 있을 수 있다고 보수적으로 가정하므로, 표시가 없으면 `CHART_TYPES`
+ * 를 아무도 안 써도 이 문장을 지우지 못하고, 그 문장이 붙들고 있는
+ * `REGISTRY`(=16종 렌더러 전부)까지 함께 남는다. **셋 중 하나라도 빠지면**
+ * 나머지 호출이 여전히 `REGISTRY` 를 읽으므로 소용이 없다 — 실제로 겪은
+ * 문제다(`Object.freeze` 하나만 표시했을 때는 번들이 전혀 줄지 않았다).
+ * 표시를 지우면 저수준 렌더러 하나만 가져와도 번들이 줄지 않는 문제가
+ * 조용히 되돌아온다.
+ */
+declare const CHART_TYPES: readonly CsatChartType[];
+/**
+ * 아는 키인지 본다.
+ *
+ * **`v in REGISTRY` 로 바꾸지 말 것.** REGISTRY 는 객체 리터럴이라 프로토타입을
+ * 물고 있어서 `'constructor'`·`'__proto__'`·`'toString'` 이 전부 통과하고,
+ * 곧이어 `REGISTRY['constructor'].render` 에서 터진다.
+ */
+declare function isCsatChartType(v: unknown): v is CsatChartType;
+
+declare class CsatChartError extends Error {
+    constructor(message: string);
+}
+
+/**
+ * `CanvasRenderingContext2D.prototype.roundRect` 가 없으면 심는다.
+ *
+ * - 브라우저가 아닌 곳(Node 등)에서는 아무 일도 하지 않는다 —
+ *   `typeof CanvasRenderingContext2D === 'undefined'` 로 가려낸다.
+ * - 이미 있으면(Chrome 99·Firefox 112·Safari 16.4 이상, 또는 이미 폴리필이
+ *   설치된 두 번째 호출) 아무 일도 하지 않는다 — 네이티브 구현을 밀어내지 않는다.
+ * - 그 아래에서만 심는다.
+ *
+ * `CsatChart` 생성자가 첫 렌더 전에 이 함수를 부르므로 파사드 사용자는 따로
+ * 부를 필요가 없다. 저수준 렌더러(`renderClimateGraph` 등)를 파사드 없이 직접
+ * 부르는 사람은 그리기 전에 `installRoundRectPolyfill()` 을 한 번 불러야
+ * 한다 — 파사드를 거치지 않으므로 이 라이브러리가 대신 불러 줄 자리가 없다.
+ *
+ * @returns 실제로 심었으면 `true`. 심을 필요가 없었으면(Node 이거나 이미
+ * 있음) `false`.
+ */
+declare function installRoundRectPolyfill(): boolean;
+
+/**
+ * 상수는 얼려서 내보낸다.
+ *
+ * 여기서 내보내는 것은 렌더러가 기본값으로 읽는 **바로 그 객체**다. 얼리지 않으면
+ * `CsatChart.DOT_MARKER_ORDER.reverse()` 한 번에 이후 모든 그림의 기호 배정이
+ * 조용히 어긋난다. 타입 검사를 받지 않는 CDN 사용자를 겨냥한 패키지라 특히 그렇다.
+ * `CHART_TYPES` 를 얼린 것과 같은 이유다.
+ *
+ * 각 `Object.freeze` 앞의 PURE 주석을 지우지 말 것. 함수 호출은 번들러가
+ * 부작용이 있을 수 있다고 보수적으로 가정하는 대상이라, 표시가 없으면 이
+ * 상수들을 아무도 안 써도 문장 자체가 안 지워진다 — 여기서는 값이 각각
+ * `core` 배열 하나씩만 가리키므로 결과가 이 파일 안에서 끝나 심각하지 않지만,
+ * `registry.ts` 의 `CHART_TYPES` 는 같은 문제가 16종 렌더러 전체를 붙드는
+ * 문제로 번진다. 그 사례를 따라 여기도 표시해 둔다.
+ */
+declare const AGE_GROUPS: readonly string[];
+declare const DOT_MARKER_ORDER: readonly DotMarker[];
+declare const LINE_MARKER_ORDER: readonly LineMarker[];
+declare const LINE_STYLE_ORDER: readonly LineStyle[];
+declare const MONTH_LABELS_EN: readonly string[];
+declare const MONTH_LABELS_NUM: readonly string[];
+declare const LINE_DASH: Readonly<{
+    solid: readonly number[];
+    dashed: readonly number[];
+    dotted: readonly number[];
+    dashdot: readonly number[];
+}>;
+
+export { AGE_GROUPS, type AbsBarCategory, type AbsBarDirection, type AbsBarGraphData, type AgeLabelSide, type BubbleLegendPosition, CHART_TYPES, type CanvasLike, type CategoryDotCategory, type CategoryDotGraphData, type ChartDataMap, type ClimateGraphData, type ClimateMode, type ClimateMonthData, type ConfigFor, CsatChart, type CsatChartConfig, CsatChartError, type CsatChartType, type CubeAxisConfig, type CubeGraphData, type CubePoint, DOT_MARKER_ORDER, type DataTableData, type DataTableRow, type DeviationAData, type DeviationBData, type DeviationBRegion, type DotMarker, type EnsureFontsOptions, type GraphOptions, type HythergraphData, type HythergraphMode, type HythergraphSeries, type InsideLegendCorner, LINE_DASH, LINE_MARKER_ORDER, LINE_STYLE_ORDER, type LabelOffset, type LegendPosition, type LineGraphData, type LineLabelPlacement, type LineMarker, type LineSeries, type LineStyle, MONTH_LABELS_EN, MONTH_LABELS_NUM, type MatrixTableData, type MonthInterval, type MonthLabelStyle, type PartialGraphOptions, type PyramidAgeData, type PyramidGraphData, type PyramidUnit, type RadarGraphData, type RadarSeries, type ScatterGraphData, type ScatterMode, type ScatterPoint, type StackedBarDirection, type StackedCategory, type StackedDisplayMode, type StackedGraphData, type TernaryGraphData, type TernaryGridInterval, type TernaryPoint, type TreemapCell, type TreemapGraphData, type UpdateFor, autoRange, createDefaultAbsBarData, createDefaultCategoryDotData, createDefaultClimateData, createDefaultCubeData, createDefaultDataTableData, createDefaultDeviationAData, createDefaultDeviationBData, createDefaultGraphOptions, createDefaultHythergraphData, createDefaultLineData, createDefaultMatrixTableData, createDefaultPyramidData, createDefaultRadarData, createDefaultScatterData, createDefaultStackedData, createDefaultTernaryData, createDefaultTreemapData, ensureFonts, installRoundRectPolyfill, isCsatChartType, niceStep, renderAbsBarGraph, renderCategoryDotGraph, renderClimateGraph, renderCubeGraph, renderDataTable, renderDeviationAGraph, renderDeviationBGraph, renderHythergraph, renderLineGraph, renderMatrixTable, renderPyramidGraph, renderRadarChart, renderScatterGraph, renderStackedGraph, renderTernaryGraph, renderTreemapGraph };