realchart 1.3.13 → 1.3.15

package/gauge.js

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

package/gauge.mjs

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

package/heatmap.js

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

package/heatmap.mjs

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

package/index.d.ts

@@ -1594,21 +1594,6 @@ declare const _Shapes: {
      * @config
      */
     readonly RECTANGLE: "rectangle";
-    /**
-     * 수직선
-     * @config
-     */
-    readonly VLINE: "vline";
-    /**
-     * 수평선
-     * @config
-     */
-    readonly HLINE: "hline";
-    /**
-     * 직선
-     * @config
-     */
-    readonly LINE: "line";
 };
 /** @dummy */
 type Shape = typeof _Shapes[keyof typeof _Shapes];
@@ -2274,18 +2259,16 @@ interface SeriesMarkerOptions extends ChartItemOptions {
  */
 interface MarkerSeriesOptions extends ConnectableSeriesOptions {
     /**
-     * 명시적으로 지정하지 않으면 typeIndex에 따라 Shapes 중 하나로 돌아가면서 설정된다.
-     *
+     * 명시적으로 지정하지 않으면 typeIndex에 따라 Shapes 중 하나로 돌아가면서 설정된다.<br/>
+     * 'none'으로 지정하면 그리지 않는다.
      */
     shape?: Shape;
     /**
      * 데이터포인트 {@page shape 도형} 회전 각도.<br/>
-     *
      */
     rotation?: number;
     /**
      * 데이터포인트 별로 다른 색상으로 그린다.<br/>
-     *
      */
     colorByPoint?: boolean;
     /**
@@ -2458,7 +2441,7 @@ interface WidgetSeriesLabelOptions extends DataPointLabelOptions {
      *
      * @default true
      */
-    convergable?: boolean;
+    convergent?: boolean;
     /**
      * label과 pie 본체와의 기본 간격.<br/>
      */
@@ -4593,13 +4576,13 @@ interface SubtitleOptions extends TitleOptions {
  *
  * ```js
  * const config = {
- *      options: {
+ *      chart: {
  *          theme: 'dark',
  *      },
  * };
  * ```
  *
- * @config chart.options
+ * @config chart.chart
  */
 interface ChartOptionsOptions extends ChartItemOptions {
     /**
@@ -4657,7 +4640,7 @@ interface ChartOptionsOptions extends ChartItemOptions {
      */
     xStart?: number;
     /**
-     * x축 값이 설정되지 않은 데이터 point에 지정되는 x값의 간격.\
+     * x축 값이 설정되지 않은 데이터 point에 지정되는 x값의 간격.<br/>
      * 첫번째 값은 {@page xStart}로 설정한다.
      * time 축일 때, 정수 값 대신 시간 단위('y', 'm', 'd', 'h', 'n', 's')로 지정할 수 있다.
      * 시리즈의 {@page Series.xStep}이 설정되면 그 값이 사용된다.
@@ -4666,18 +4649,19 @@ interface ChartOptionsOptions extends ChartItemOptions {
      */
     xStep?: number | string;
     /**
-     * 복수 axis가 표시되는 경우 axis 사이의 간격
+     * 복수 axis가 표시되는 경우 axis 사이의 간격.<br/>
      *
      * @default 8
      */
     axisGap?: number;
     /**
-     * 크레딧 모델.
+     * @deprecated v1.3.15 이후로, {@page config.credits}으로 대신 설정한다.
      *
+     * 크레딧 모델.<br/>
      */
-    credits?: CreditsOptions;
+    credits?: CreditsOptions | boolean;
     /**
-     * 데이터포인트에 마우스가 올라가면 나머지 시리즈들을 반투명 처리해서 연결된 데이터포인터의 시리즈를 강조한다.
+     * 데이터포인트에 마우스가 올라가면 나머지 시리즈들을 반투명 처리해서 연결된 데이터포인터의 시리즈를 강조한다.<br/>
      *
      * @default false
      */
@@ -5817,6 +5801,19 @@ declare abstract class RcAnimation {
     protected abstract _doUpdate(rate: number): boolean;
 }
 
+/**
+ * legend 아이템들이 클릭 될 때 호출되는 콜백의 매개변수로 사용된다.
+ */
+interface LegendItemCallbackArgs {
+    /**
+     * RealChart의 공개 {@page api.Chart} 모델
+     */
+    chart: object;
+    /**
+     * legend 아이템에 연결된 시리즈 또는 데이터 포인트
+     */
+    source: object;
+}
 /**
  * @enum
  */
@@ -6035,6 +6032,11 @@ interface LegendOptions extends ChartItemOptions {
      * @default true
      */
     pointHovering?: boolean;
+    /**
+     * legend 아이템이 클릭 될 때 호출되는 이벤트 콜백<br/>
+     * 리턴 값이 false일 경우 아이템에 연결된 시리즈나 데이터 포인트의 visible 값이 변경되지 않는다.
+     */
+    onLegendItemClick?: (args: LegendItemCallbackArgs) => boolean | undefined;
 }
 
 /**
@@ -6673,6 +6675,7 @@ declare abstract class SeriesMarker<OP extends SeriesMarkerOptions = {}> extends
     private _args;
     constructor(series: Series);
     getMarkerStyle(p: DataPoint): any;
+    protected _doSetSimple(src: any): boolean;
 }
 declare class WidgetSeriesPoint extends DataPoint implements ILegendSource {
     _calcedColor: string;
@@ -7120,7 +7123,7 @@ interface IAxis {
     axisMax(): number;
     axisMin(): number;
     length(): number;
-    zoom(start: number, end: number): boolean;
+    zoom(start: number, end: number, minSize: number): boolean;
     /**
      * data point의 값을 축 상의 값으로 리턴한다.
      */
@@ -7368,7 +7371,7 @@ interface IAxisZoom {
     start: number;
     end: number;
 }
-declare class AxisZoom {
+declare class AxisZoom implements IAxisZoom {
     axis: Axis;
     min: number;
     max: number;
@@ -7378,6 +7381,7 @@ declare class AxisZoom {
     total(): number;
     length(): number;
     isFull(): boolean;
+    clamp(value: number, continuous?: boolean): number;
     resize(start: number, end: number, minSize: number): boolean;
 }
 /**
@@ -7540,7 +7544,23 @@ declare abstract class Axis<OP extends AxisOptions = AxisOptions> extends ChartI
     protected abstract _createTickModel(): AxisTick;
     protected abstract _createLabel(): AxisLabel;
     protected abstract _doPrepareRender(): void;
+    /**
+     *
+     * @param min
+     * @param max
+     * @param length 축의 갯수.
+     */
     protected abstract _doBuildTicks(min: number, max: number, length: number): IAxisTick[];
+    /**
+     *
+     * @param min
+     * @param max
+     * @param length 축의 갯수.
+     */
+    protected abstract _adjustMinMax(min: number, max: number, length: number): {
+        min: number;
+        max: number;
+    };
     value2Tooltip(value: number): any;
     isBased(): boolean;
     isBaseVisible(): boolean;
@@ -7554,6 +7574,10 @@ declare abstract class Axis<OP extends AxisOptions = AxisOptions> extends ChartI
     _prepare(): void;
     _prepareRender(): void;
     afterRender(): void;
+    /**
+     *
+     * @param length 축의 갯수.
+     */
     _buildTicks(length: number): void;
     _calcPoints(length: number, phase: number): void;
     /**
@@ -8662,7 +8686,7 @@ interface CategoryAxisOptions extends AxisOptions {
     /**
      * @override
      */
-    tick?: CategoryAxisTickOptions;
+    tick?: CategoryAxisTickOptions | boolean;
     /**
      * Category 목록을 수집하는 시리즈.<br/>
      * 지정하지 않으면 모든 시리즈에서 카테고리를 수집한다.
@@ -8897,11 +8921,11 @@ interface ContinuousAxisOptions extends AxisOptions {
     /**
      * @override
      */
-    tick?: ContinuousAxisTickOptions;
+    tick?: ContinuousAxisTickOptions | boolean;
     /**
      * @override
      */
-    grid?: ContinuousAxisGridOptions;
+    grid?: ContinuousAxisGridOptions | boolean;
     /**
      * @override
      */
@@ -8935,7 +8959,7 @@ interface LinearAxisOptions extends ContinuousAxisOptions {
     /**
      * @override
      */
-    label?: LinearAxisLabelOptions;
+    label?: LinearAxisLabelOptions | boolean;
 }
 /**
  * Log축 틱 설정 모델.<br/>
@@ -8963,7 +8987,7 @@ interface LogAxisOptions extends ContinuousAxisOptions {
     /**
      * @override
      */
-    tick?: LogAxisTickOptions;
+    tick?: LogAxisTickOptions | boolean;
 }
 /**
  * 시간축 label 설정 모델.<br/>
@@ -9002,7 +9026,7 @@ interface TimeAxisTickOptions extends ContinuousAxisTickOptions {
     /**
      * @override
      */
-    label?: TimeAxisLabelOptions;
+    label?: TimeAxisLabelOptions | boolean;
 }
 declare const TimeAxisType = "time";
 /**
@@ -9018,7 +9042,7 @@ interface TimeAxisOptions extends ContinuousAxisOptions {
     /**
      * @override
      */
-    label?: TimeAxisLabelOptions;
+    label?: TimeAxisLabelOptions | boolean;
     /**
      * @override
      * @default NaN
@@ -9027,7 +9051,7 @@ interface TimeAxisOptions extends ContinuousAxisOptions {
     /**
      * @override
      */
-    tick?: TimeAxisTickOptions;
+    tick?: TimeAxisTickOptions | boolean;
 }
 /** @dummy */
 type AxisOptionsType = CategoryAxisOptions | LinearAxisOptions | LogAxisOptions | TimeAxisOptions;
@@ -10242,6 +10266,12 @@ interface ChartConfiguration {
     /**
      * 차트 전체에 영향을 미치는 옵션들.<br/>
      */
+    chart?: ChartOptionsOptions;
+    /**
+     * @deprecated v1.3.15 이후로, {@page config.chart}로 대신 설정한다.
+     *
+     * 차트 전체에 영향을 미치는 옵션들.<br/>
+     */
     options?: ChartOptionsOptions;
     /**
      * Asset 목록.<br/>
@@ -10251,7 +10281,7 @@ interface ChartConfiguration {
     /**
      * 차트 타이틀.<br/>
      */
-    title?: TitleOptions | string;
+    title?: TitleOptions | string | boolean;
     /**
      * 차트 제목 주위에 표시되는 부제목.<br/>
      */
@@ -10261,6 +10291,10 @@ interface ChartConfiguration {
      * 시리즈나 데이터포인트 등의 이름과 심볼을 같이 표시할 수 있다.
      */
     legend?: LegendOptions | boolean;
+    /**
+     * 크레딧 설정 옵션.<br/>
+     */
+    credits?: CreditsOptions | boolean;
     /**
      * 데이터포인트 뷰에 마우스가 올라가면 표시되는 툴팁 상자.<br/>
      * {@page guide.tooltip 툴팁 개요} 페이지를 참조한다.
@@ -10896,6 +10930,7 @@ interface IChart {
 declare class Credits extends ChartItem<CreditsOptions> {
     static defaults: CreditsOptions;
     isFloating(): boolean;
+    protected _doSetSimple(src: any): boolean;
 }
 /**
  * 데이터포인트에 마우수가 올라갈 때 처리하는 방식 설정 모델.<br/>
@@ -10909,16 +10944,11 @@ declare class PointHovering extends ChartItem<PointHoveringOptions> {
  * 차트 전역 설정 모델.
  */
 declare class ChartOptions extends ChartItem<ChartOptionsOptions> {
-    private _credits;
     private _pointHovering;
     static defaults: ChartOptionsOptions;
     protected _doInitChildren(op: {
         [child: string]: ChartItemOptions;
     }): void;
-    /**
-     * 크레딧 모델.
-     */
-    get credits(): Credits;
     /**
      * 데이터포인트에 마우수가 올라갈 때 처리하는 방식.<br/>
      */
@@ -10963,6 +10993,7 @@ declare class ChartObject extends EventProvider<IChartEventListener> implements
     _title: Title<TitleOptions>;
     _subtitle: Subtitle;
     _legend: Legend;
+    _credits: Credits;
     _tooltip: Tooltip;
     private _series;
     private _xAxes;
@@ -11272,44 +11303,48 @@ declare class Chart {
      */
     get series(): Series;
     /**
-     * 첫번째 게이지.
+     * 첫번째 게이지.<br/>
      */
     get gauge(): Gauge;
     /**
-     * 차트 범례 모델.
+     * 차트 범례 모델.<br/>
      */
     get legend(): Legend;
     /**
-     * 툴팁 모델.
+     * 크레딧 모델.<br/>
+     */
+    get credits(): Credits;
+    /**
+     * 툴팁 모델.<br/>
      */
     get tooltip(): Tooltip;
     /**
-     * 첫번째 x 축.
+     * 첫번째 x 축.<br/>
      */
     get xAxis(): Axis;
     /**
-     * 첫번째 y 축.
+     * 첫번째 y 축.<br/>
      */
     get yAxis(): Axis;
     /**
-     * 차트 시리즈, 게이지, annotation들이 그려지는 plotting 영역 모델.
+     * 차트 시리즈, 게이지, annotation들이 그려지는 plotting 영역 모델.<br/>
      */
     get body(): Body;
     /**
-     * Split 설정 모델.
+     * Split 설정 모델.<br/>
      */
     get split(): ISplit | undefined;
     /**
-     * 시리즈 내비게이터 모델.
+     * 시리즈 내비게이터 모델.<br/>
      */
     get seriesNavigator(): SeriesNavigator;
     /**
-     * 차트 내보내기 관련 설정 모델.
+     * 차트 내보내기 관련 설정 모델.<br/>
      */
     get exporter(): Exporter;
     /**
      * name 매개변수가 문자열이면 지정한 이름의 x 축을,
-     * 숫자이면 해당 index에 위치하는 x 축을 리턴한다.
+     * 숫자이면 해당 index에 위치하는 x 축을 리턴한다.<br/>
      *
      * @param name 이름이나 index
      * @returns 축 객체
@@ -11317,14 +11352,14 @@ declare class Chart {
     getXAxis(name: string | number): Axis;
     /**
      * name 매개변수가 문자열이면 지정한 이름의 y 축을,
-     * 숫자이면 해당 index에 위치하는 y 축을 리턴한다.
+     * 숫자이면 해당 index에 위치하는 y 축을 리턴한다.<br/>
      *
      * @param name 이름이나 index
      * @returns 축 객체
      */
     getYAxis(name: string | number): Axis;
     /**
-     * 시리즈 이름에 해당하는 시리즈 객체를 리턴한다.
+     * 시리즈 이름에 해당하는 시리즈 객체를 리턴한다.<br/>
      *
      * @param name 시리즈 이름
      * @returns 시리즈 객체
@@ -11338,14 +11373,14 @@ declare class Chart {
      */
     seriesByType(type: string): Series | SeriesGroup;
     /**
-     * 게이지 이름에 해당하는 게이지 객체를 리턴한다.
+     * 게이지 이름에 해당하는 게이지 객체를 리턴한다.<br/>
      *
      * @param name 게이지 이름
      * @returns 게이지 객체
      */
     getGauge(name: string | number): GaugeBase;
     /**
-     * Annotation 이름에 해당하는 Annotation 객체를 리턴한다.
+     * Annotation 이름에 해당하는 Annotation 객체를 리턴한다.<br/>
      *
      * @param name Annotation 이름
      * @returns Annotation 객체
@@ -11367,7 +11402,7 @@ declare class Chart {
      */
     updateOptions(options: ChartConfiguration, render?: boolean): void;
     /**
-     * 현재 표시 중인 차트를 PNG, JPG 또는 SVG 벡터 이미지로 다운로드한다.
+     * 현재 표시 중인 차트를 PNG, JPG 또는 SVG 벡터 이미지로 다운로드한다.<br/>
      *
      * ```js
      * chart.export({
@@ -11391,7 +11426,7 @@ declare class Chart {
      */
     setParam(param: string, value: any, redraw?: boolean): void;
     /**
-     * 시리즈를 추가한다.
+     * 시리즈를 추가한다.<br/>
      *
      * @param source 시리즈 설정 json.
      * @param animate 애니메이션 실행 여부.
@@ -11399,7 +11434,7 @@ declare class Chart {
      */
     addSeries(source: any, animate?: boolean): Series;
     /**
-     * 기존 시리즈를 제거한다.
+     * 기존 시리즈를 제거한다.<br/>
      *
      * @param series 시리즈 이름이나 시리즈 객체.
      * @param animate 애니메이션 실행 여부.
@@ -11914,7 +11949,7 @@ declare abstract class ContinuousAxis<OP extends ContinuousAxisOptions = Continu
     getLabelLength(length: number, value: number): number;
     private _getStartFit;
     private _getEndFit;
-    protected _adjustMinMax(length: number, min: number, max: number): {
+    protected _adjustMinMax(min: number, max: number, length: number): {
         min: number;
         max: number;
     };
@@ -11948,7 +11983,7 @@ declare class LinearAxis extends ContinuousAxis<LinearAxisOptions> {
      */
     get label(): LinearAxisLabel;
     protected _createLabel(): ContinuousAxisLabel;
-    protected _adjustMinMax(length: number, min: number, max: number): {
+    protected _adjustMinMax(min: number, max: number, length: number): {
         min: number;
         max: number;
     };
@@ -12123,7 +12158,19 @@ declare class PointLabelContainer extends LayerElement {
     removePoint(p: DataPoint, delay: number): void;
     private $_checkIntersects;
     dedupe(views: PointLabelView[], lines: PointLabelLineContainer, mode: PointLabelDedupeMode): void;
-    arrangeVertical(views: PointLabelView[], lines: PointLabelLineContainer, height: number, converge: boolean, dedupeMode: PointLabelDedupeMode, overflow: PointLabelOverflow): 0 | 1;
+    /**
+     * for pie, funnel
+     * 라벨 정렬. 라벨이 겹치치 않도록 중앙과 가까운 라벨을 기준으로 밀어낸다.
+     * @param owner
+     * @param views
+     * @param lines
+     * @param _height
+     * @param convergent
+     * @param _dedupeMode
+     * @param overflow
+     * @returns
+     */
+    arrangeVertical(owner: SeriesView<Series>, views: PointLabelView[], lines: PointLabelLineContainer, _height: number, convergent: boolean, _dedupeMode: PointLabelDedupeMode, overflow: PointLabelOverflow): number;
 }
 declare class PointLabelLineView extends GroupElement {
     point: DataPoint;
@@ -12715,22 +12762,27 @@ declare class CategoryAxis extends Axis<CategoryAxisOptions> {
     private _map;
     private _catPad;
     private _catMin;
+    private _catMax;
     private _catLen;
     _pts: number[];
     _tstep: number;
     get tick(): CategoryAxisTick;
     xValueAt(pos: number): number;
-    getWdith(length: number, category: number): number;
     _type(): string;
     unitPad(): number;
     continuous(): boolean;
     polarOff(): number;
+    _prepareZoom(): AxisZoom;
     protected _createGrid(): CategoryAxisGrid;
     protected _createTickModel(): CategoryAxisTick;
     protected _createLabel(): CategoryAxisLabel;
     collectValues(): void;
     getStartAngle(): number;
     protected _doPrepareRender(): void;
+    protected _adjustMinMax(min: number, max: number, length: number): {
+        min: number;
+        max: number;
+    };
     protected _doBuildTicks(min: number, max: number, length: number): IAxisTick[];
     _calcPoints(length: number, phase: number): void;
     getPos(length: number, value: number): number;
@@ -13616,7 +13668,7 @@ declare class ShapeAnnotation extends Annotation<ShapeAnnotationOptions> {
         xRange: number[];
         yRange: number[];
     };
-    getShape(): Shape;
+    getShape(): ShapeAnnotationShape;
     protected _doSetSimple(src: any): boolean;
 }