realchart 1.3.16 → 1.3.18

package/gauge.js

@@ -1,6 +1,6 @@
 
 /** 
- * RealChart Gauge v1.3.16
+ * RealChart Gauge v1.3.18
  * Copyright (C) 2023-2025 WooriTech Inc.
  * All Rights Reserved. 
  */

package/gauge.mjs

@@ -1,6 +1,6 @@
 
 /** 
- * RealChart Gauge v1.3.16
+ * RealChart Gauge v1.3.18
  * Copyright (C) 2023-2025 WooriTech Inc.
  * All Rights Reserved. 
  */

package/heatmap.js

@@ -1,6 +1,6 @@
 
 /** 
- * RealChart Heatmap v1.3.16
+ * RealChart Heatmap v1.3.18
  * Copyright (C) 2023-2025 WooriTech Inc.
  * All Rights Reserved. 
  */

package/heatmap.mjs

@@ -1,6 +1,6 @@
 
 /** 
- * RealChart Heatmap v1.3.16
+ * RealChart Heatmap v1.3.18
  * Copyright (C) 2023-2025 WooriTech Inc.
  * All Rights Reserved. 
  */

package/index.d.ts

@@ -1672,7 +1672,7 @@ interface DataPointLabelOptions extends IconedTextOptions {
      *
      * @default 5
      */
-    offset?: number | ((point: any) => number);
+    offset?: number | ((args: DataPointCallbackArgs) => number);
     /**
      * 계산되는 기본 text 대신, data point label로 표시될 field.<br/>
      * {@page textCallback}이 설정되고 콜백에서 null이나 undefined를 리턴하지 않으면 이 속성은 무시된다.
@@ -1688,16 +1688,16 @@ interface DataPointLabelOptions extends IconedTextOptions {
      * 빈 문자열 등 정상적인 문자열을 리턴하면 그 문자열대로 표시된다.
      * {@page prefix}나 포맷 속성 등은 적용되지 않는다.
      */
-    textCallback?: (point: any) => string;
+    textCallback?: (args: DataPointCallbackArgs) => string;
     /**
      * 데이터 포인트별 label 표시 여부를 리턴하는 콜백.<br/>
      *
      */
-    visibleCallback?: (point: any) => boolean;
+    visibleCallback?: (args: DataPointCallbackArgs) => boolean;
     /**
      * 데이터 포인트별로 추가 적용되는 스타일을 리턴한다.<br/>
      */
-    styleCallback?: (point: any) => SVGStyleOrClass;
+    styleCallback?: (args: DataPointCallbackArgs) => SVGStyleOrClass;
 }
 /**
  * 추세선(trendline) 유형.<br/>
@@ -1931,7 +1931,7 @@ interface SeriesOptions extends ChartItemOptions {
     tooltipText?: string;
     /**
      */
-    tooltipCallback?: (args: any) => string;
+    tooltipCallback?: (args: DataPointCallbackArgs) => string;
     /**
      * 차트 설정 로드 시 실행되는 animation 종류.
      */
@@ -2060,33 +2060,33 @@ declare const _SeriesGroupLayout: {
     /**
      * 시리즈 종류에 따른 기본 표시 방식.
      * <br>
-     * bar 종류의 시리즈인 경우 포인트들을 순서대로 옆으로 배치하고,
-     * line 종류인 경우 {@page OVERLAP}과 동일하게 순서대로 표시된다.
+     * bar 종류의 시리즈인 경우 데이터포인트들을 순서대로 옆으로 배치하고,
+     * line 종류인 경우 `overlap`과 동일하게 순서대로 표시된다.
      * <br>
      * 기본 값이다.
      * @config
      */
     readonly DEFAULT: "default";
     /**
-     * 포인트들을 순서대로 겹쳐서 표시한다.
+     * 데이터포인트들을 순서대로 겹쳐서 표시한다.
      * <br>
      * bar 종류의 시리즈이고,
-     * 마지막 시리즈의 포인트 값이 큰 경우 이전 포인트들은 보이지 않을 수 있다.
+     * 마지막 시리즈의 포인트 값이 큰 경우 이전 데이터포인트들은 보이지 않을 수 있다.
      * @config
      */
     readonly OVERLAP: "overlap";
     /**
-     * 포인트 그룹 내에서 각 포인트들을 순서대로 쌓아서 표시한다.
+     * 데이터포인트 그룹 내에서 각 데이터포인트들을 순서대로 쌓아서 표시한다.
      * @config
      */
     readonly STACK: "stack";
     /**
-     * 포인트 그룹 내에서 각 포인트의 비율을 표시한다.
+     * 데이터포인트 그룹 내에서 각 데이터포인트의 비율을 표시한다.
      * <br>
-     * 그룹 합은 SeriesGroup.max로 지정한다.
-     * 각 포인트들은 STACK과 마찬가지로 순서대로 쌓여서 표시된다.
-     * SeriesGroup.baseValue 보다 값이 큰 point는 baseValue 위쪽에 작은 값을 가진
-     * 포인트들은 baseValue 아래쪽에 표시된다.
+     * 그룹 합의 상대적 최댓값은 {@page layoutMax}로 지정한다.
+     * 각 데이터포인트들은 {@page layout stack}과 마찬가지로 순서대로 쌓여서 표시된다.
+     * {@page baseValue}보다 값이 큰 데이터포인트는 `baseValue` 위쪽에 작은 값을 가진
+     * 데이터포인트들은 `baseValue` 아래쪽에 표시된다.
      * @config
      */
     readonly FILL: "fill";
@@ -2115,7 +2115,7 @@ interface SeriesGroupOptions<T extends SeriesOptions = SeriesOptions> extends Ch
      */
     layout?: SeriesGroupLayout;
     /**
-     * {@page layout}이 {@page SeriesGroupLayout.FILL}일 때 상대적 최대값.
+     * {@page layout}이 {@page layout 'fill'}일 때 상대적 최대값.
      * <br>
      *
      * @default 100
@@ -2964,7 +2964,7 @@ declare const BoxPlotSeriesType = "boxplot";
  * |y|단일 숫자면 low, y값. x 값은 순서에 따라 자동 결정.|
  * |[]|빈 배열이면 null. x 값은 순서에 따라 자동 결정.|
  * |[min, low, mid, high, y]|형식 설명 순서대로 값 결정. x 값은 데이터포인트 순서에 따라 자동 결정.|
- * |[x, min, low, mid, high, y]|형깃 설명 순서대로 값 결정.<br/> 또는 {@page xField} 속성이 숫자이면 x값, {@page minField}는 min값,<br/> {@page lowField}는 low값, {@page midField}는 mid값,<br/> {@page highField}는 high값, {@page yField}는 y값의 index.|
+ * |[x, min, low, mid, high, y]|형식 설명 순서대로 값 결정.<br/> 또는 {@page xField} 속성이 숫자이면 x값, {@page minField}는 min값,<br/> {@page lowField}는 low값, {@page midField}는 mid값,<br/> {@page highField}는 high값, {@page yField}는 y값의 index.|
  *
  * ###### json 배열
  * |Series 속성|설명|
@@ -3117,7 +3117,7 @@ interface BumpSeriesGroupOptions extends SeriesGroupOptions<LineSeriesMarkerOpti
  * |y|단일 숫자면 low, y값. x 값은 순서에 따라 자동 결정.|
  * |[]|빈 배열이면 null. x 값은 순서에 따라 자동 결정.|
  * |[min, low, mid, high | y]|형식 설명 순서대로 값 결정. x 값은 데이터포인트 순서에 따라 자동 결정.|
- * |[x, min, low, mid, high | y]|형깃 설명 순서대로 값 결정.<br/> 또는 {@page xField} 속성이 숫자이면 x값, {@page minField}는 min값,<br/> {@page lowField}는 low값, {@page midField}는 mid값,<br/> {@page highField}는 high값, {@page yField}는 y값의 index.|
+ * |[x, min, low, mid, high | y]|형식 설명 순서대로 값 결정.<br/> 또는 {@page xField} 속성이 숫자이면 x값, {@page minField}는 min값,<br/> {@page lowField}는 low값, {@page midField}는 mid값,<br/> {@page highField}는 high값, {@page yField}는 y값의 index.|
  *
  * ###### json 배열
  * |Series 속성|설명|
@@ -3583,6 +3583,18 @@ interface LollipopSeriesMarkerOptions extends SeriesMarkerOptions {
      * @default 4
      */
     radius: number;
+    /**
+     * {@page config.series.lollipop.radiusField}값에 따라 상대적으로 적용되는 radius의 최대 크기<br/>
+     *
+     * @default 8
+     */
+    maxRadius?: number;
+    /**
+     * {@page config.series.lollipop.radiusField}값에 따라 상대적으로 적용되는 radius의 최소 크기<br/>
+     *
+     * @default 2
+     */
+    minRadius?: number;
     /**
      * @override
      * @default 'circle'
@@ -3614,6 +3626,7 @@ declare const LollipopSeriesType = "lollipop";
  * |{@page yField}|속성 값, 또는 'y', 'value' 속성들 중 순서대로 값이 설정된 것이 y 값이 된다.|
  * |{@page colorField}|속성 값, 또는 'color' 속성 값으로 데이터포인트의 개별 색상으로 지정된다.|
  * |{@page iconField}|속성 값, 또는 'icon' 속성 값으로 데이터포인트의 개별 이미지가 지정된다.|
+ * |{@page radiusField}|속성 값, 또는 'radius' 속성 값으로 데이터포인트의 radius 크기가 지정된다.|
  *
  * @config chart.series[type=lollipop]
  */
@@ -3624,6 +3637,10 @@ interface LollipopSeriesOptions extends BasedSeriesOptions {
     /**
      */
     marker?: LollipopSeriesMarkerOptions;
+    /**
+     * undefined이면, data point의 값이 객체일 때 'radius'.<br/>
+     */
+    radiusField?: string;
 }
 declare const OhlcSeriesType = "ohlc";
 /**
@@ -3642,7 +3659,7 @@ declare const OhlcSeriesType = "ohlc";
  * |y|단일 숫자면 low, y값. x 값은 순서에 따라 자동 결정.|
  * |[]|빈 배열이면 null. x 값은 순서에 따라 자동 결정.|
  * |[min, low, mid, high | y]|형식 설명 순서대로 값 결정. x 값은 데이터포인트 순서에 따라 자동 결정.|
- * |[x, min, low, mid, high | y]|형깃 설명 순서대로 값 결정.<br/> 또는 {@page xField} 속성이 숫자이면 x값, {@page minField}는 min값,<br/> {@page lowField}는 low값, {@page midField}는 mid값,<br/> {@page highField}는 high값, {@page yField}는 y값의 index.|
+ * |[x, min, low, mid, high | y]|형식 설명 순서대로 값 결정.<br/> 또는 {@page xField} 속성이 숫자이면 x값, {@page minField}는 min값,<br/> {@page lowField}는 low값, {@page midField}는 mid값,<br/> {@page highField}는 high값, {@page yField}는 y값의 index.|
  *
  * ###### json 배열
  * |Series 속성|설명|
@@ -4042,7 +4059,7 @@ declare const TreemapSeriesType = "treemap";
  * |y|단일 숫자면 low, y값. x 값은 순서에 따라 자동 결정.|
  * |[]|빈 배열이면 null. x 값은 순서에 따라 자동 결정.|
  * |[y, id, grup]|형식 설명 순서대로 값 결정. x 값은 데이터포인트 순서에 따라 자동 결정.|
- * |[x, y, id, group]|형깃 설명 순서대로 값 결정.<br/> 또는 {@page xField} 속성이 숫자이면 x값, {@page yField}는 y값,<br/> {@page idField}는 id값, {@page groupField}는 group값,<br/>.|
+ * |[x, y, id, group]|형식 설명 순서대로 값 결정.<br/> 또는 {@page xField} 속성이 숫자이면 x값, {@page yField}는 y값,<br/> {@page idField}는 id값, {@page groupField}는 group값,<br/>.|
  *
  * ###### json 배열
  * |Series 속성|설명|
@@ -4212,7 +4229,7 @@ declare const VectorSeriesType = "vector";
  * |y|단일 숫자면 low, y값. x 값은 순서에 따라 자동 결정.|
  * |[]|빈 배열이면 null. x 값은 순서에 따라 자동 결정.|
  * |[y, length, angle]|형식 설명 순서대로 값 결정. x 값은 데이터포인트 순서에 따라 자동 결정.|
- * |[x, y, length, angle]|형깃 설명 순서대로 값 결정.<br/> 또는 {@page xField} 속성이 숫자이면 x값, {@page yField}는 y값,<br/> {@page lengthField}는 length값, {@page angleField}는 angle값,<br/>.|
+ * |[x, y, length, angle]|형식 설명 순서대로 값 결정.<br/> 또는 {@page xField} 속성이 숫자이면 x값, {@page yField}는 y값,<br/> {@page lengthField}는 length값, {@page angleField}는 angle값,<br/>.|
  *
  * ###### json 배열
  * |Series 속성|설명|
@@ -4424,7 +4441,7 @@ declare const LineSeriesTypes: {
 /** @dummy */
 type LineSeriesOptionsType = typeof LineSeriesTypes[keyof typeof LineSeriesTypes];
 /** @dummy */
-type SeriesOptionsType = SeriesOptions | SeriesGroupOptions | BarRangeSeriesOptions | BarSeriesOptions | BarSeriesGroupOptions | BellCurveSeriesOptions | BoxPlotSeriesOptions | BubbleSeriesOptions | BumpSeriesGroupOptions | CandlestickSeriesOptions | CircleBarSeriesOptions | DumbbellSeriesOptions | EqualizerSeriesOptions | ErrorBarSeriesOptions | FunnelSeriesOptions | HistogramSeriesOptions | AreaRangeSeriesOptions | AreaSeriesOptions | LineSeriesOptions | LineSeriesGroupOptions | SplineSeriesOptions | LollipopSeriesOptions | OhlcSeriesOptions | ParetoSeriesOptions | PieSeriesOptions | PieSeriesGroupOptions | ScatterSeriesOptions | WaterfallSeriesOptions | TreemapSeriesOptions | HeatmapSeriesOptions | VectorSeriesOptions;
+type SeriesOptionsType = SeriesOptions | SeriesGroupOptions | BarRangeSeriesOptions | BarSeriesOptions | BarSeriesGroupOptions | BellCurveSeriesOptions | BoxPlotSeriesOptions | BubbleSeriesOptions | BumpSeriesGroupOptions | CandlestickSeriesOptions | CircleBarSeriesOptions | DumbbellSeriesOptions | EqualizerSeriesOptions | ErrorBarSeriesOptions | FunnelSeriesOptions | HistogramSeriesOptions | AreaRangeSeriesOptions | AreaSeriesOptions | AreaSeriesGroupOptions | LineSeriesOptions | LineSeriesGroupOptions | SplineSeriesOptions | LollipopSeriesOptions | OhlcSeriesOptions | ParetoSeriesOptions | PieSeriesOptions | PieSeriesGroupOptions | ScatterSeriesOptions | WaterfallSeriesOptions | TreemapSeriesOptions | HeatmapSeriesOptions | VectorSeriesOptions;
 
 /**
  * 차트 제목(title) 설정 옵션.<br/>
@@ -4494,6 +4511,12 @@ interface TitleOptions extends ChartItemOptions {
      * @default 10
      */
     gap?: number;
+    /**
+     * 설정에 따라 정해진 표시 위치에서 떨어진 수평 간격.<br/>
+     *
+     * @default 0
+     */
+    offset?: number;
 }
 /**
  * 부제목 표시 위치.
@@ -4507,17 +4530,29 @@ declare const _SubtitlePosition: {
      */
     readonly BOTTOM: "bottom";
     /**
-     * 주제목 오른쪽에 표시.
+     * 주제목 오른쪽 공간에 표시.
      *
      * @config
      */
     readonly RIGHT: "right";
     /**
-     * 주제목 왼쪽에 표시.
+     * align 속성과 subtitle.offset 속성을 무시하고 주제목 오른쪽에 표시된다.
+     *
+     * @config
+     */
+    readonly RIGHT_SIDE: "rightSide";
+    /**
+     * 주제목 왼쪽 공간에 표시.
      *
      * @config
      */
     readonly LEFT: "left";
+    /**
+     * align 속성과 subtitle.offset 속성을 무시하고 주제목 왼쪽에 표시된다.
+     *
+     * @config
+     */
+    readonly LEFT_SIDE: "leftSide";
     /**
      * 주제목 위쪽에 표시.
      *
@@ -4570,6 +4605,14 @@ interface SubtitleOptions extends TitleOptions {
      * @default ''
      */
     text?: string;
+    /**
+     * @override
+     *
+     * {@page position}가 'leftSide' 이거나 'rightSide'인 경우 해당 속성은 무시된다.
+     *
+     * @default 0
+     */
+    offset?: number;
 }
 /**
  * 차트 전체에 영향을 미치는 옵션들.<br/>
@@ -4954,7 +4997,7 @@ interface SeriesNavigatorOptions extends ChartItemOptions {
  *
  * ```js
  *  const config = {
- *      options: {
+ *      chart: {
  *          credits: {
  *              text: 'UN Data',
  *              url: 'https://data.un.org'
@@ -7840,7 +7883,7 @@ interface ContinuousAxisTickOptions extends AxisTickOptions {
     /**
      * tick 개수를 맞춰야 하는 대상 axis.<br/>
      * base의 strictMin, strictMax가 설정되지 않아야 한다.
-     * base의 startFit, endFilt의 {@page AxisFit.TICK}으로 설정되어야 한다.
+     * base의 startFit, endFit의 {@page config.base.axis.startFit tick}으로 설정되어야 한다.
      *
      */
     baseAxis?: number | string;
@@ -7914,6 +7957,10 @@ type AxisLabelOverflow = typeof _AxisLabelOverflow[keyof typeof _AxisLabelOverfl
  * {@page config.base.axis.label#styleCallback 스타일}을 동적으로 리턴하는 콜백 등의 매개변수로 사용된다.<br/>
  */
 interface AxisLabelArgs {
+    /**
+     * RealChart의 공개 {@page api.Chart} 모델
+     */
+    chart: object;
     /**
      * 축 객체.
      */
@@ -8386,25 +8433,25 @@ declare const _AxisPosition: {
     readonly AUTO: "auto";
     /**
      * X축은 아래쪽에 수평으로, Y축은 왼쪽에 수직으로 표시된다.<br/>
-     * {@page Chart.inverted}이면 Y축이 아래쪽에 수평으로, X축은 왼쪽에 수직으로 표시된다.
+     * {@page op.ChartConfiguration#inverted}이면 Y축이 아래쪽에 수평으로, X축은 왼쪽에 수직으로 표시된다.
      *
      * @config
      */
     readonly NORMAL: "normal";
     /**
      * X축은 위쪽에 수평으로, Y축은 오른쪽에 수직으로 표시된다.<br/>
-     * {@page Chart.inverted}이면 Y축이 위쪽에 수평으로, X축은 오른쪽에 수직으로 표시된다.
+     * {@page op.ChartConfiguration#inverted}이면 Y축이 위쪽에 수평으로, X축은 오른쪽에 수직으로 표시된다.
      *
      * @config
      */
     readonly OPPOSITE: "opposite";
     /**
      * 상대 축의 baseValue 지점에 표시된다.<br/>
-     * [주의]
-     * 1. 축에 연결된 시리즈들이 BarSeries 계열일 때만 가능하다.
-     * 2. 차트의 X축 하나에만 적용할 수 있다. 두번째로 지정된 축의 속성은 {@page NORMAL}로 적용된다.
-     * 3. 상대 축이 **linear** 가 아니거나 {@page LinearAxis.baseValue}가 min 보다 작거나 max보다 크면 이 값은 무시되고,
-     *    {@page NORMAL}로 적용된다.
+     * [주의] <br/>
+     * 1. 축에 연결된 시리즈들이 BarSeries 계열일 때만 가능하다.<br/>
+     * 2. 차트의 X축 하나에만 적용할 수 있다. 두번째로 지정된 축의 속성은 'normal'로 적용된다.<br/>
+     * 3. 상대 축이 **linear** 가 아니거나 {@page rc.LinearAxis.baseValue}가 min 보다 작거나 max보다 크면 이 값은 무시되고,
+     *    'normal'로 적용된다.
      *
      * @config
      */
@@ -8884,7 +8931,7 @@ interface ContinuousAxisOptions extends AxisOptions {
     /**
      * 마지막 tick 뒤쪽에 추가되는 최소 여백을 축 길이에 대한 상대값으로 지정한다.
      * 이 값을 지정하지 않으면 {@page padding}에 지정된 값을 따른다.
-     * {@page endFit}이 {@page AxitFit.TICK}일 때,
+     * {@page endFit}이 {@page endFit tick}일 때,
      * data point의 최대값과 마지막 tick 사이에 이미 그 이상의 간격이 존재한다면 이 속성은 무시된다.
      * {@page strictMax}가 지정되거나, {@page maxValue}가 계산된 최대값보다 큰 경우에도 이 속성은 무시된다.
      *
@@ -8906,14 +8953,14 @@ interface ContinuousAxisOptions extends AxisOptions {
     strictMax?: number;
     /**
      * 축 시작 위치에 tick 표시 여부.
-     * {@page strictMin}이 설정되면 {@page AxisFit.VALUE}로 적용된다.
+     * {@page strictMin}이 설정되면 'value'로 적용된다.
      *
      * @default 'default'
      */
     startFit?: AxisFit;
     /**
      * 축 끝 위치에 tick 표시 여부.
-     * {@page strictMax}가 설정되면 무시되고 {@page AxisFit.VALUE}로 적용된다.
+     * {@page strictMax}가 설정되면 무시되고 'value'로 적용된다.
      *
      * @default 'default'
      */
@@ -13458,6 +13505,7 @@ declare class LollipopSeries extends BasedSeries<LollipopSeriesOptions> {
         [child: string]: ChartItemOptions;
     }): void;
     get marker(): LollipopSeriesMarker;
+    protected _getFielderProps(): string[];
     canCategorized(): boolean;
     getLabelOff(off: number): number;
     protected _createPoint(source: any): DataPoint;