realchart 1.4.22 → 1.4.24

package/ie/pictogram.ie.js

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

package/ie/split.ie.js

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

package/ie/treemap.ie.js

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

package/ie/vector.ie.js

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

package/ie/wordcloud.ie.js

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

package/index.d.ts

@@ -1491,7 +1491,7 @@ interface TrendlineAreaOptions extends ChartItemOptions {
 /**
  * 추세선 라벨 옵션.<br/>
  */
-interface TrendlineLabelOptions extends IconedTextOptions {
+interface TrendlineLabelOptions extends Omit<IconedTextOptions, 'numberFormat' | 'numberSymbols'> {
     /**
      * @default false
      */
@@ -2692,12 +2692,14 @@ interface BarSeriesOptions extends BarSeriesBaseOptions {
     type?: BarSeriesTypes;
     /**
      * 지정한 반지름 크기로 데이터포인트 bar의 위쪽 모서리를 둥글게 표시한다.<br/>
-     * 최대값이 bar 폭으로 절반으로 제한되므로 아주 큰 값을 지정하면 반원으로 표시된다.
+     * 최대값이 bar 폭으로 절반으로 제한되므로 아주 큰 값을 지정하면 반원으로 표시된다.<br/>
+     * polar 차트에서는 동작하지 않는다.
      */
     topRadius?: number;
     /**
      * 지정한 반지름 크기로 데이터포인트 bar의 아래쪽 모서리를 둥글게 표시한다.<br/>
-     * 최대값이 bar 폭으로 절반으로 제한되므로 아주 큰 값을 지정하면 반원으로 표시된다.
+     * 최대값이 bar 폭으로 절반으로 제한되므로 아주 큰 값을 지정하면 반원으로 표시된다.<br/>
+     * polar 차트에서는 동작하지 않는다.
      */
     bottomRadius?: number;
     shape?: 'default' | 'cylinder';
@@ -2786,7 +2788,7 @@ type LineType = typeof _LineType[keyof typeof _LineType];
  * Line 시리즈의 마지막 데이터포인트 옆에 표시되는 아이콘과 텍스트 설정 모델.<br/>
  * 마지막 포인트와의 간격은 {@link offset} 속성으로 지정한다.
  */
-interface LineSeriesFlagOptions extends IconedTextOptions {
+interface LineSeriesFlagOptions extends Omit<IconedTextOptions, 'numberFormat' | 'numberSymbols'> {
     /**
      * @append
      *
@@ -4031,6 +4033,12 @@ interface PieSeriesDepthOptions extends ChartItemOptions {
      * @default 0.6
      */
     ratio?: number;
+    /**
+     * depth 면의 색상은 슬라이스 fill을 기반으로 자동 계산되므로 직접 지정할 수 없다.<br/>
+     * 색상을 변경하려면 슬라이스의 색상을 변경한다.
+     * @private
+     */
+    style?: never;
 }
 declare const PieSeriesType = "pie";
 /**
@@ -4777,12 +4785,14 @@ interface PictorialBarSeriesOptions extends BarSeriesBaseOptions {
     figureGap?: number;
     /**
      * 지정한 반지름 크기로 데이터포인트 bar의 위쪽 모서리를 둥글게 표시한다.<br/>
-     * 최대값이 bar 폭으로 절반으로 제한되므로 아주 큰 값을 지정하면 반원으로 표시된다.
+     * 최대값이 bar 폭으로 절반으로 제한되므로 아주 큰 값을 지정하면 반원으로 표시된다.<br/>
+     * polar 차트에서는 동작하지 않는다.
      */
     topRadius?: number;
     /**
      * 지정한 반지름 크기로 데이터포인트 bar의 아래쪽 모서리를 둥글게 표시한다.<br/>
-     * 최대값이 bar 폭으로 절반으로 제한되므로 아주 큰 값을 지정하면 반원으로 표시된다.
+     * 최대값이 bar 폭으로 절반으로 제한되므로 아주 큰 값을 지정하면 반원으로 표시된다.<br/>
+     * polar 차트에서는 동작하지 않는다.
      */
     bottomRadius?: number;
 }
@@ -7669,7 +7679,7 @@ type ClockGaugeLabelPosition = typeof _ClockGaugeLabelPosition[keyof typeof _Clo
 /**
  * Clock 게이지 내부에 표시되는 라벨 설정 모델.<br/>
  */
-interface ClockGaugeLabelOptions extends ChartTextOptions {
+interface ClockGaugeLabelOptions extends Omit<ChartTextOptions, 'numberFormat' | 'numberSymbols'> {
     /**
      * 라벨 표시 위치.
      *
@@ -9045,6 +9055,7 @@ declare class TrendlineLabel extends IconedText<TrendlineLabelOptions> {
     getVerticalAlignPolar(angle: number): VerticalAlign;
     getOffsetX(align: Align): number;
     getOffsetY(vAlign: VerticalAlign): number;
+    getText(): string;
     getDefaultIconPos(): IconPosition;
     protected _doApply(op: TrendlineLabelOptions): void;
 }
@@ -10672,6 +10683,8 @@ declare class AxisLine<OP extends AxisLineOptions = AxisLineOptions> extends Axi
 declare class AxisTitle extends AxisItem<AxisTitleOptions> {
     static defaults: AxisTitleOptions;
     private _rotation;
+    private _gap;
+    getGap(): number;
     getRotation(): number;
     getTextOrientation(): TextOrientation;
     protected _isVisible(): boolean;
@@ -11621,7 +11634,6 @@ interface AxisLabelOptions extends IconedTextOptions {
     /**
      * {@link autoArrange} {@link AxisLabelArrange.ROWS ROWS}로 자동 정렬되는 경우 최대 행 수.<br/>
      * 이 행 수 이상이 필요한 경우 label 간격을 두어 표시한다.
-     * // TODO: 구현할 것!
      *
      * @default 3
      */
@@ -11746,7 +11758,7 @@ type GuideLabelPosition = typeof _GuideLabelPosition[keyof typeof _GuideLabelPos
  * 축 가이드 label 설정 모델.
  *
  */
-interface AxisGuideLabelOptions extends IconedTextOptions {
+interface AxisGuideLabelOptions extends Omit<IconedTextOptions, 'numberFormat' | 'numberSymbols'> {
     /**
      * body 영역 기준, 표시 위치.
      *
@@ -12126,6 +12138,12 @@ type AxisType = 'category' | 'linear' | 'log' | 'time';
  *
  */
 interface AxisOptions extends ChartItemOptions {
+    /**
+     * @private
+     * 축 자체에는 스타일을 직접 지정할 수 없다.<br/>
+     * 각 하위 항목({@link title}, {@link line}, {@link tick}, {@link label}, {@link grid} 등)에서 스타일을 지정한다.
+     */
+    style?: never;
     /**
      * 값을 지정하지 않으면 연결된 시리즈가 있는 경우에 표시된다.<br/>
      * 명시적 boolean값을 지정하면 그 설정에 따라 표시 여부가 결정된다.
@@ -12338,13 +12356,15 @@ interface CategoryAxisTickOptions extends AxisTickOptions {
  */
 interface CategoryAxisLabelOptions extends AxisLabelOptions {
     /**
-     * {@link fillToCategory}가 true이고 수직 축 일 때 label의 수평 정렬.<br/>
+     * {@link fillToCategory}가 true일 때 카테고리 블록 내 label의 수평 정렬.<br/>
+     * 수직 축에서는 블록 높이 내 수평 위치, 수평 축에서는 블록 너비 내 수평 위치를 제어한다.
      *
      * @default 'center'
      */
     align?: Align;
     /**
-     * {@link fillToCategory}가 true이고 수직 축 일 때 label의 수직 정렬.<br/>
+     * {@link fillToCategory}가 true일 때 카테고리 블록 내 label의 수직 정렬.<br/>
+     * 수직 축에서는 블록 높이 내 수직 위치를 제어한다.
      *
      * @default 'middle'
      */
@@ -12498,7 +12518,7 @@ interface AxisBaseLineOptions extends AxisLineOptions {
 interface AxisBreakOptions extends AxisItemOptions {
     /**
      * break 적용 시작 값.<br/>
-     * 0보다 큰 값을 지정해야 한다.
+     * `to`보다 작은 값을 지정해야 하며, 음수도 허용된다.
      */
     from?: number;
     /**
@@ -12749,6 +12769,14 @@ interface LogAxisTickOptions extends ContinuousAxisTickOptions {
      * 
      */
     arrangeDecimals?: boolean;
+    /**
+     * 로그 축에는 소수점 tick 개념이 없으므로 이 속성은 사용할 수 없다.<br/>
+     * {@link ContinuousAxisTickOptions.enableDecimals enableDecimals}는 선형 축({@link LinearAxisTickOptions})에서만 유효하며,
+     * `LogAxisTick._getStepMultiples`는 `[1, 2, 5, 10]` 고정 배수를 반환하므로
+     * 이 속성을 설정해도 아무런 효과가 없다.
+     * @ignore
+     */
+    enableDecimals?: never;
 }
 declare const LogAxisType = "log";
 /**
@@ -12779,6 +12807,18 @@ interface LogAxisOptions extends ContinuousAxisOptions {
  * 시간축 label 설정 모델.<br/>
  */
 interface TimeAxisLabelOptions extends ContinuousAxisLabelOptions {
+    /**
+     * @private
+     * TimeAxis는 날짜/시간 형식을 사용하므로 숫자 형식은 지원하지 않는다.<br/>
+     * 날짜/시간 형식은 {@link timeFormat}, {@link timeFormats}을 사용한다.
+     */
+    numberFormat?: never;
+    /**
+     * @private
+     * TimeAxis는 날짜/시간 형식을 사용하므로 숫자 기호 설정은 지원하지 않는다.<br/>
+     * 날짜/시간 형식은 {@link timeFormat}, {@link timeFormats}을 사용한다.
+     */
+    numberSymbols?: never;
     /**
      * 현재 스케일의 시작일시에 상위 스케일의 포맷을 사용해서 표시한다.
      *
@@ -12804,6 +12844,14 @@ interface TimeAxisLabelOptions extends ContinuousAxisLabelOptions {
  * 시간 축 틱 설정 모델.<br/>
  */
 interface TimeAxisTickOptions extends ContinuousAxisTickOptions {
+    /**
+     * @private
+     * 시간 축에는 소수점 tick 개념이 없으므로 이 속성은 사용할 수 없다.<br/>
+     * {@link ContinuousAxisTickOptions.enableDecimals enableDecimals}는 선형 축({@link LinearAxisTickOptions})에서만 유효하며,
+     * `TimeAxisTick._getStepMultiples`는 시간 스케일(ms/초/분/시/일/주/월/년) 기반으로 동작하므로
+     * 이 속성을 설정해도 아무런 효과가 없다.
+     */
+    enableDecimals?: never;
     /**
      * @append
      * 단위가 지정된 문자열로 지정하는 경우 값이 -1 이하이거나 1 이상이어야 한다. // #141
@@ -12875,13 +12923,15 @@ interface ChartTextOptions extends ChartItemOptions {
      */
     effect?: ChartTextEffect;
     /**
-     * {@link autoContrast}가 true이고 밝게 표시할 때 적용되는
+     * {@link autoContrast}가 true이고 배경이 어두울 때 적용되는
      * {@link it.SVGStyles 스타일셋} 또는 css {@link https://developer.mozilla.org/ko/docs/Web/CSS/CSS_selectors selector}.<br/>
+     * 지정하지 않으면 'rct-label-light' 클래스 셀렉터가 기본 적용된다.
      */
     lightStyle?: SVGStyleOrClass;
     /**
-     * {@link autoContrast}가 true이고 어둡게 표시할 때 적용되는
+     * {@link autoContrast}가 true이고 배경이 밝을 때 적용되는
      * {@link it.SVGStyles 스타일셋} 또는 css {@link https://developer.mozilla.org/ko/docs/Web/CSS/CSS_selectors selector}.<br/>
+     * 지정하지 않으면 'rct-label-dark' 클래스 셀렉터가 기본 적용된다.
      */
     darkStyle?: SVGStyleOrClass;
     /**
@@ -12890,11 +12940,12 @@ interface ChartTextOptions extends ChartItemOptions {
      */
     backgroundStyle?: SVGStyleOrClass;
     /**
-     * 텍스트가 data point 내부에 표시되는 경우 포인트 배경 색상과 대조되도록 표시한다.<br/>
-     * 밝게 표시할 때는 {@link lightStyle}을 적용하고,
-     * 어둡게 표시할 때는 {@link darkStyle}이 적용된다.
-     * lightStyle이 지정되지 않으면 'rct-text-light' 클래스 셀렉터가,
-     * darkStyle이 지정되지 않으면 'rct-text-dark' 클래스 셀렉터가 기본 적용된다.
+     * 텍스트 색상을 배경 색상과 대조되도록 자동 조정한다.<br/>
+     * 배경이 어두우면 {@link lightStyle}을, 배경이 밝으면 {@link darkStyle}을 적용한다.<br/>
+     * 배경 기준 우선순위:<br/>
+     * 1. {@link effect}가 'background'인 경우 → {@link backgroundStyle}의 배경색 기준<br/>
+     * 2. 텍스트가 data point 내부에 표시되는 경우 → 포인트 배경색 기준<br/>
+     * 위 조건에 해당하지 않으면 적용되지 않는다.
      *
      * @default true
      */
@@ -13262,7 +13313,20 @@ interface ImageAnnotationOptions extends AnnotationOptions {
      */
     visible?: boolean;
     /**
-     * 이미지 경로.
+     * 이미지 경로.<br/>
+     * 일반 URL 경로나 `assetId::imageName` 형식의 asset 참조를 지정할 수 있다.<br/>
+     * asset에 등록된 이미지를 사용하려면 `asset.id::imageName` 또는 `asset.id::index` 형식으로 지정한다.<br/>
+     *
+     * ```js
+     * // 일반 URL 경로
+     * imageUrl: '/images/chart.png'
+     *
+     * // asset 참조 (이름)
+     * imageUrl: 'myImages::logo'
+     *
+     * // asset 참조 (인덱스)
+     * imageUrl: 'myImages::0'
+     * ```
      */
     imageUrl?: string;
 }
@@ -14411,10 +14475,10 @@ declare class ChartTextElement extends GroupElement {
     /** text */
     get text(): string;
     setText(s: string): ChartTextElement;
-    setModel(doc: Document, model: IconedText, icon: string, dynStyle: SVGStyleOrClass): ChartTextElement;
+    setModel<OP extends ChartTextOptions>(doc: Document, model: IconedText<OP>, icon: string, dynStyle: SVGStyleOrClass): ChartTextElement;
     setContrast(target: Element): ChartTextElement;
     layout(align: Align): ChartTextElement;
-    setOutline(model: IconedText): void;
+    setOutline<OP extends ChartTextOptions>(model: IconedText<OP>): void;
     getBBox(): IRect;
 }
 
@@ -15091,7 +15155,7 @@ declare class AxisView extends ChartElement<Axis> {
     prepareGuides(doc: Document, row: number, col: number, container: AxisGuideContainer, frontContainer: AxisGuideContainer): void;
     showCrosshair(pos: number, text: string): void;
     setMargins(edgeStart: number, start: number, end: number, edgeEnd: number): void;
-    hideCrosshiar(): void;
+    hideCrosshair(): void;
     scroll(pos: number): void;
     prepare(m: Axis): void;
     checkExtents(loaded: boolean): {
@@ -15342,6 +15406,8 @@ declare class TimeAxisTick extends ContinuousAxisTick<TimeAxisTickOptions> {
     protected _getStepMultiples(step: number): number[];
     protected _getStepsByPixels(length: number, pixels: number, base: number, min: number, max: number): number[];
     protected _getStepsByInterval(interval: any, base: number, min: number, max: number): number[];
+    protected _getStepsBySteps(min: number, max: number, args: any): number[];
+    buildSteps(axis: ContinuousAxis, length: number, base: number, min: number, max: number, broken?: boolean): number[];
 }
 /**
  * 시간축 라벨 모델.<br/>
@@ -15439,6 +15505,14 @@ declare class LogAxis extends ContinuousAxis<LogAxisOptions> {
      * 내부에서는 log 값들을 사용하고...
      */
     getPos(length: number, value: number): number;
+    /**
+     * _min/_max가 log 공간에 있으므로 data 값을 log 변환 후 비교한다.
+     */
+    contains(value: number): boolean;
+    /**
+     * _min/_max가 log 공간에 있으므로 log 변환 후 trim하여 다시 data 값으로 반환한다.
+     */
+    trimRange(from: number, to: number): [number, number];
     protected _checkValues(vals: number[]): number[];
     protected _doCalculateRange(values: number[]): {
         min: number;
@@ -16476,6 +16550,11 @@ declare class TextAnnotation extends Annotation<TextAnnotationOptions> {
  */
 declare class ImageAnnotation extends Annotation<ImageAnnotationOptions> {
     static readonly type: string;
+    /**
+     * `imageUrl`을 반환한다.<br/>
+     * `assetId::imageName` 형식의 asset 참조가 있으면 등록된 asset에서 실제 URL로 해석한다.
+     */
+    getImageUrl(): string;
     protected _isVisible(): boolean;
     protected _doSetSimple(src: any): boolean;
 }