realchart 1.4.29 → 1.4.31

package/ie/pictogram.ie.js

@@ -1,6 +1,6 @@
 
 /** 
- * RealChart Pictogram v1.4.29
+ * RealChart Pictogram v1.4.31
  * Copyright (C) 2023-2026 WooriTech Inc.
  * All Rights Reserved. 
  */

package/ie/split.ie.js

@@ -1,6 +1,6 @@
 
 /** 
- * RealChart Split v1.4.29
+ * RealChart Split v1.4.31
  * Copyright (C) 2023-2026 WooriTech Inc.
  * All Rights Reserved. 
  */

package/ie/treemap.ie.js

@@ -1,6 +1,6 @@
 
 /** 
- * RealChart Treemap v1.4.29
+ * RealChart Treemap v1.4.31
  * Copyright (C) 2023-2026 WooriTech Inc.
  * All Rights Reserved. 
  */

package/ie/vector.ie.js

@@ -1,6 +1,6 @@
 
 /** 
- * RealChart Vector v1.4.29
+ * RealChart Vector v1.4.31
  * Copyright (C) 2023-2026 WooriTech Inc.
  * All Rights Reserved. 
  */

package/ie/wordcloud.ie.js

@@ -1,6 +1,6 @@
 
 /** 
- * RealChart Wordcloud v1.4.29
+ * RealChart Wordcloud v1.4.31
  * Copyright (C) 2023-2026 WooriTech Inc.
  * All Rights Reserved. 
  */

package/index.d.ts

@@ -1903,7 +1903,8 @@ interface SeriesOptions extends ChartItemOptions {
      */
     pointStyleCallback?: (args: DataPointCallbackArgs) => SVGStyleOrClass;
     /**
-     * 시리즈의 hover, focus, tooltip 상호작용 여부를 지정한다.
+     * 시리즈의 hover, focus, tooltip 상호작용 여부를 지정한다.<br/>
+     * 차트 {@link https://realchart.co.kr/config/config/general/interactive interactive}가 false이면 hover·focus·tooltip은 비활성화된다.
      *
      * @default true
      */
@@ -5488,7 +5489,7 @@ interface SubtitleOptions extends TitleOptions {
  * ```
  *
  */
-interface ChartOptionsOptions extends ChartItemOptions {
+interface ChartGeneralOptions extends ChartItemOptions {
     /**
      * @ignore
      */
@@ -5513,8 +5514,17 @@ interface ChartOptionsOptions extends ChartItemOptions {
      * 시리즈 옵션 colors가 지정되면 이 속성은 무시된다.
      */
     colors?: string[];
+    /**
+     * 차트 전체 수준의 상호작용 여부를 지정한다.<br/>
+     * false이면 `animatable`, `hoverable`, `clickable`을 모두 false로 지정한 것과 동일하게 동작한다.<br/>
+     * true이면 위 세 옵션 각각에서 false로 지정한 기능만 비활성화된다.<br/>
+     *
+     * @default true
+     */
+    interactive?: boolean;
     /**
      * false로 지정하면 차트 전체척으로 animation 효과를 실행하지 않는다.<br/>
+     * {@link https://realchart.co.kr/config/config/general/interactive interactive}가 false이면 이 옵션과 관계없이 animation은 실행되지 않는다.<br/>
      *
      * @default true
      */
@@ -5522,6 +5532,7 @@ interface ChartOptionsOptions extends ChartItemOptions {
     /**
      * false로 지정하면 차트 전체에서 마우스 hover 상호작용을 비활성화한다.<br/>
      * tooltip, pointHovering, seriesHovering, crosshair 등 hover 기반 기능이 모두 작동하지 않는다.<br/>
+     * {@link https://realchart.co.kr/config/config/general/interactive interactive}가 false이면 이 옵션과 관계없이 hover 상호작용은 비활성화된다.<br/>
      *
      * @default true
      */
@@ -5529,6 +5540,7 @@ interface ChartOptionsOptions extends ChartItemOptions {
     /**
      * false로 지정하면 차트 전체에서 마우스 click 상호작용을 비활성화한다.<br/>
      * onPointClick, 범례 클릭, annotation 클릭 등 클릭 기반 기능이 모두 작동하지 않는다.<br/>
+     * {@link https://realchart.co.kr/config/config/general/interactive interactive}가 false이면 이 옵션과 관계없이 click 상호작용은 비활성화된다.<br/>
      *
      * @default true
      */
@@ -5601,6 +5613,7 @@ interface ChartOptionsOptions extends ChartItemOptions {
      */
     resizeDelay?: number;
 }
+type ChartOptionsOptions = ChartGeneralOptions;
 /**
  * @css 'rct-body-image'
  */
@@ -8173,11 +8186,17 @@ interface ChartConfiguration {
      */
     templates?: ConfigObject;
     /**
+     * 차트 전체에 영향을 미치는 옵션들.<br/>
+     * #1651
+     */
+    general?: ChartGeneralOptions;
+    /**
+     * @deprecated {@link https://realchart.co.kr/config/config/general general}로 대신 설정한다.
      * 차트 전체에 영향을 미치는 옵션들.<br/>
      */
     chart?: ChartOptionsOptions;
     /**
-     * @deprecated v1.3.15 이후로, {@link https://realchart.co.kr/config/config/chart chart}로 대신 설정한다.
+     * @deprecated {@link https://realchart.co.kr/config/config/general general}로 대신 설정한다.
      *
      * 차트 전체에 영향을 미치는 옵션들.<br/>
      */
@@ -9254,7 +9273,7 @@ declare class CategoryAxisLabel extends AxisLabel<CategoryAxisLabelOptions> {
  * {@link options} 모델은 {@link https://realchart.co.kr/docs/api/options/AxisGridOptions AxisGridOptions}이다.
  */
 declare class CategoryAxisGrid extends AxisGrid<AxisGridOptions> {
-    getPositions(axis: CategoryAxis): number[];
+    getPositions(axis: CategoryAxis, length: number): number[];
 }
 /**
  * 카테고리 축 모델.<br/>
@@ -9294,6 +9313,10 @@ declare class CategoryAxis extends Axis<CategoryAxisOptions> {
     private _catLen;
     _pts: number[];
     _tstep: number;
+    /** 연속 정수 구간이 데이터 대비 과도할 때 linear 축처럼 수치 비율로 배치. */
+    private _numericScale;
+    private static readonly NUMERIC_SCALE_SPAN_THRESHOLD;
+    private static readonly NUMERIC_SCALE_SPAN_FACTOR;
     get tick(): CategoryAxisTick;
     /**
      * @append
@@ -9352,6 +9375,8 @@ declare class CategoryAxis extends Axis<CategoryAxisOptions> {
     getLabelX(length: number, pos: number): number;
     _type(): string;
     unitPad(): number;
+    /** numeric scale 모드 여부 (linear 배치). grid 등에서 사용. */
+    isNumericScale(): boolean;
     continuous(): boolean;
     _prepareZoom(): AxisZoom;
     protected _createGrid(): CategoryAxisGrid;
@@ -9367,6 +9392,8 @@ declare class CategoryAxis extends Axis<CategoryAxisOptions> {
     };
     protected _doBuildTicks(min: number, max: number, length: number, phase: number): IAxisTick[];
     _calcPoints(length: number, phase: number): void;
+    private $_scaleNumericPts;
+    private $_updateMarkPoints;
     getPos(length: number, value: number): number;
     valueAt(length: number, pos: number): number;
     getUnitLen(length: number, value: number): number;
@@ -9377,6 +9404,38 @@ declare class CategoryAxis extends Axis<CategoryAxisOptions> {
         min: number;
         max: number;
     };
+    private $_hasExplicitCategories;
+    /** minValue·maxValue로 tick 범위가 명시된 경우. */
+    private $_hasDefinedTickRange;
+    /**
+     * 데이터 범위에 minValue/maxValue를 반영한다.<br/>
+     * 슬롯 모드에서 둘 다 지정되면 카테고리 tick 범위로 hard clamp하고,
+     * numeric scale에서는 LinearAxis처럼 명시 범위를 확장만 한다.
+     * (hard clamp 시 maxValue보다 큰 데이터가 getPos NaN → 미표시/오류)
+     */
+    private $_applyRangeOptions;
+    /** 명시 categories에서 유효한 슬롯 인덱스인지. */
+    private $_isValidCategoryIndex;
+    /**
+     * explicit categories + 수치 data일 때 numeric scale 여부.<br/>
+     * 인덱스가 categories 개수를 넘는 것(6, 7…)은 슬롯 확장이고,
+     * 387749 같은 큰 수치만 linear 축으로 처리한다.
+     */
+    private $_needsNumericScaleForExplicitCategories;
+    private $_shouldUseNumericScale;
+    /**
+     * categories 미지정 + 수치 값만 있을 때 min~max 전체 정수 구간을 펼치면
+     * (예: -130~130000 → 13만 슬롯) 렌더 비용이 폭증한다.
+     * linear 축처럼 수치 비율로 위치를 계산한다.
+     * minValue/maxValue가 명시돼도 span이 크면 동일하게 numeric scale을 사용한다.
+     */
+    private $_resolveNumericScale;
+    private $_doBuildNumericTicks;
+    private $_buildNumericTickValues;
+    private $_getNumericPos;
+    private $_numericValueAt;
+    /** 데이터 값 → pts 배열 슬롯 인덱스(0 기준). 유효하지 않으면 -1. */
+    private $_slotIndex;
     private $_getSpanFromPts;
     private $_getDividerPosFromPts;
     private $_getCategoryEdgePos;
@@ -10056,6 +10115,8 @@ declare class PlottingItemCollection extends ChartItemCollection<PlottingItem> {
     connect(chart: IChart): void;
     prepareRender(): void;
     prepareAfter(): void;
+    updateOptions(source: any, render: boolean): void;
+    private $_rebuildSeriesList;
     private $_loadItem;
     private $_add;
 }
@@ -10308,7 +10369,8 @@ declare abstract class SeriesGroup<T extends Series = Series, OP extends SeriesG
     _getVisiblePoints(): DataPoint[];
     getLayoutMax(): number;
     protected _doInit(op: OP): void;
-    protected _doApply(op: OP): void;
+    protected _doLoad(op: OP, source: any): void;
+    updateOptions(source?: OP, render?: boolean): this;
     protected _doSaveArray(prop: string, value: any[]): any[];
     _prepareRender(): void;
     _connect(chart: IChart): void;
@@ -10317,7 +10379,7 @@ declare abstract class SeriesGroup<T extends Series = Series, OP extends SeriesG
     protected abstract _canContain(ser: Series): boolean;
     _setIndex(index: number): void;
     protected _doPrepareSeries(series: T[]): void;
-    private $_loadSeries;
+    private _syncChildren;
     private $_add;
     private $_collectValues;
     private $_collectPoints;
@@ -10659,7 +10721,7 @@ interface IChart {
     startOfWeek?: number;
     timeOffset?: number;
     _assets: AssetCollection;
-    chartOptions: ChartOptions;
+    general: ChartGeneral;
     first: IPlottingItem;
     firstSeries: Series;
     xAxis: IAxis;
@@ -10740,9 +10802,9 @@ declare class PointHovering extends ChartItem<PointHoveringOptions> {
 /**
  * 차트 전역 설정 모델.
  */
-declare class ChartOptions extends ChartItem<ChartOptionsOptions> {
+declare class ChartGeneral extends ChartItem<ChartOptionsOptions> {
     private _pointHovering;
-    static defaults: ChartOptionsOptions;
+    static defaults: ChartGeneralOptions;
     protected _doInit(op: {
         [child: string]: ChartItemOptions;
     }): void;
@@ -10752,6 +10814,7 @@ declare class ChartOptions extends ChartItem<ChartOptionsOptions> {
     get pointHovering(): PointHovering;
     getXStart(axis: IAxis): number | string;
 }
+type ChartOptions = ChartGeneral;
 interface IChartEventListener {
     onModelChanged?(chart: ChartObject, item: ChartItem, tag?: any): void;
     onVisibleChanged?(chart: ChartObject, item: ChartItem): void;
@@ -10784,7 +10847,7 @@ declare class ChartObject extends EventProvider<IChartEventListener> implements
         [key: string]: any;
     };
     _assets: AssetCollection;
-    _chartOptions: ChartOptions;
+    _general: ChartGeneral;
     _title: Title<TitleOptions>;
     _subtitle: Subtitle;
     _legend: Legend;
@@ -10816,18 +10879,20 @@ declare class ChartObject extends EventProvider<IChartEventListener> implements
     private _initOptions;
     get win(): Window & typeof globalThis;
     /**
-     * @deprecated
+     * @deprecated use {@link general} instead.
      */
     get options(): ChartConfiguration;
     /**
-     *
+     * @deprecated use {@link general} instead.
      */
-    get chartOptions(): ChartOptions;
+    get chartOptions(): ChartGeneral;
+    get general(): ChartGeneral;
     /**
      * 크레딧 모델.
      */
     get credits(): Credits;
     _createChart(config: any): IChart;
+    private _generalInteractive;
     animatable(): boolean;
     loadAnimatable(): boolean;
     hoverable(): boolean;
@@ -11199,6 +11264,8 @@ declare abstract class AxisTick<OP extends AxisTickOptions = AxisTickOptions> ex
     canUseNumSymbols(): boolean;
     _getLength(): number;
     _getGap(): number;
+    isShowLast(): boolean;
+    isShowFirst(): boolean;
     protected _doSetSimple(src: any): boolean;
     protected _doPrepareRender(chart: IChart): void;
 }
@@ -11807,6 +11874,29 @@ interface AxisTickOptions extends AxisItemOptions {
      * @default 3 픽셀
      */
     gap?: number;
+    /**
+     * true면 다른 설정과 상관없이 첫번째 tick은 항상 표시된다.<br/>
+     * category 축의 {@link https://realchart.co.kr/config/config/xAxis/category/tick#step tick step} 등으로 생략되더라도
+     * 첫 tick을 유지한다.<br/>
+     * linear, log, time 축에서는 `true`로 명시했을 때만
+     * 범위(trim) 계산 시 첫 tick을 제거하지 않는다.
+     *
+     * @default category 축 true. linear, log, time 축은 undefined.
+     */
+    showFirst?: boolean;
+    /**
+     * 마지막 tick 라벨 표시 여부.<br/>
+     * `true`이면 category 축의 {@link https://realchart.co.kr/config/config/xAxis/category/tick#step tick step} 등으로
+     * 생략되더라도 마지막 tick을 추가한다.<br/>
+     * `false`이면 step에 포함되어 있어도 마지막 tick을 표시하지 않는다.<br/>
+     * 미지정(undefined)이면 step 등 기존 규칙만 따른다.
+     * cartesian, polar 차트 모두 동일하게 적용된다.<br/>
+     * linear, log, time 축에서는 `true`로 명시했을 때만
+     * 범위(trim) 계산 시 마지막 tick을 제거하지 않는다.
+     *
+     * @default undefined
+     */
+    showLast?: boolean;
 }
 /**
  * major grid 사이 보조 격자선(minor grid line) 설정 옵션.<br/>
@@ -14415,9 +14505,13 @@ declare class Chart {
      */
     destroy(): void;
     /**
-     * @deprecated 차트 전역 설정은 {@link chartOptions}를 사용한다.
+     * @deprecated 차트 전역 설정은 {@link general}를 사용한다.
      */
     get options(): ChartConfiguration;
+    /**
+     * 차트 전역 설정 모델.<br/>
+     */
+    get general(): ChartGeneral;
     /**
      * 차트 데이터 셋.
      */
@@ -14462,6 +14556,7 @@ declare class Chart {
      */
     get assets(): AssetCollection;
     /**
+     * @deprecated {@link general}을 대신 사용한다.
      * 차트 전역 속성 모델.<br/>
      */
     get chartOptions(): ChartOptions;
@@ -16226,6 +16321,10 @@ declare class ChartView extends LayerElement implements IAnnotationAnchorOwner {
     bodyOf(elt: Element): BodyView;
     pointerMoved(x: number, y: number, target: EventTarget): void;
     pointerLeaved(x: number, y: number, target: EventTarget): void;
+    /**
+     * body crosshair 선과 축 flag를 모두 숨긴다.<br/>
+     * split에서는 축이 PaneContainer에 있으므로 $_clearSplitCrosshair로 flag까지 정리한다. (#850)
+     */
     private $_hideCrosshairs;
     /**
      * 하나의 축에 대해 crosshair flag(축 위 라벨) 표시 + 최근접 point 계산 후 onChange 콜백 호출.