realchart 1.3.2 → 1.3.4

package/gauge.js

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

package/gauge.mjs

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

package/heatmap.js

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

package/heatmap.mjs

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

package/index.d.ts

@@ -580,7 +580,18 @@ interface IconedTextOptions extends ChartTextOptions {
      * @default 'default'
      */
     iconPosition?: IconPosition;
+    /**
+     * 아이콘에 사용할 이미지 목록<br/>
+     * assets에 지정한 이미지 목록을 id 값으로 불러와 사용한다.<br/>
+     * 이미지 목록이 없으면, 대신 iconRoot 속성 값을 사용하여 아이콘 경로를 설정한다.
+     * [미구현] imageList 설정만 하고, 사용처가 없음. #603
+     * @ignore
+     */
     imageList?: string;
+    /**
+     * 아이콘 이미지의 URL을 지정할 때 사용하는 기본 경로를 설정<br/>
+     * 아이콘 URL을 구성하는 데 필요한 루트 경로를 제공하며, 여러 아이콘의 상대 경로를 설정할 때 유용하다.
+     */
     iconRoot?: string;
     /**
      * 아이콘과 텍스트 사이의 간격.<br/>
@@ -718,9 +729,8 @@ interface AnnotationOptions extends ChartItemOptions {
      */
     backgroundStyle?: SVGStyleOrClass;
     /**
+     * body의 annotation으로 설정된 경우,
      * true로 지정하면 상위 영역을 벗어난 부분도 표시되게 한다.<br/>
-     * body에 포함된 경우 body 영역,
-     * chart에 포함되고 scope이 'chart'일 때 chart 영역.
      */
     noClip?: boolean;
     /**
@@ -893,7 +903,7 @@ interface TextAnnotationOptions extends AnnotationOptions {
      */
     timeFormat?: string;
     /**
-     * 타이틀을 가로 또는 세로로 배치할지 여부와 블록이 진행되는 방향을 지정한다.
+     * 텍스트를 가로 또는 세로로 배치할지 여부와 블록이 진행되는 방향을 지정한다.
      *
      * @config
      */
@@ -1175,6 +1185,7 @@ declare class RcElement extends RcObject {
     setData(data: string, value?: string): void;
     unsetData(data: string): void;
     setBoolData(data: string, value: boolean): void;
+    getData(data: string): string;
     hasData(data: string): boolean;
     removeLater(delay: number, callback?: (v: RcElement) => void): RcElement;
     hide(delay: number): RcElement;
@@ -2441,7 +2452,7 @@ interface SplineSeriesOptions extends LineSeriesOptions {
  * {@page op.SeriesOptions#type}은 'area'이다.<br/>
  * 대부분 {@page config.series.line} 시리즈와 동일하고 라인 아래 부분을 별도의 색상으로 채운다.
  *
- * *{@page data}는 아래 형식들로 전달할 수 있다.
+ * {@page data}는 아래 형식들로 전달할 수 있다.
  *
  * ###### 단일값 또는 단일값 배열
  * |형식|설명|
@@ -3800,7 +3811,7 @@ interface WordCloudSeriesOptions extends WidgetSeriesOptions {
     textHeight?: number | 'auto';
     /**
      * 가장 작은 빈도수 단어들에 설정되는 픽셀 단위의 폰트 크기.<br/>
-     * 값 범주: 8 ~ 15
+     * 값 범주: 8 ~ 15<br/>
      * 0 ~ 1 사이 값은 값 범주의 정규화된 값으로 처리한다.
      *
      * @default 0
@@ -3808,7 +3819,7 @@ interface WordCloudSeriesOptions extends WidgetSeriesOptions {
     minFontSize?: PercentSize;
     /**
      * 가장 큰 빈도수 단어들에 설정되는 픽셀 단위의 폰트 크기.<br/>
-     * 값 범주: '5%' ~ '15%'
+     * 값 범주: '5%' ~ '15%'<br/>
      * 0 ~ 1 사이 값은 값 범주의 정규화된 값으로 처리한다.
      *
      * @default 1
@@ -3842,6 +3853,10 @@ interface WordCloudSeriesOptions extends WidgetSeriesOptions {
      * 0 ~ 360 사이의 값으로 지정한다.
      */
     seed?: number;
+    /**
+     * 일부 텍스트를 수직으로 배치한다.<br/>
+     */
+    rotation?: boolean;
     /**
      * @ignore
      * 배치 알고리즘<br/>
@@ -5206,7 +5221,7 @@ declare abstract class ChartText<OP extends ChartTextOptions> extends ChartItem<
     prepareRich(text: string): void;
     protected _doSetSimple(src: any): boolean;
     protected _doApply(options: ChartTextOptions): void;
-    private $_getNumberText;
+    protected _getNumberText(value: any, useSymbols: boolean, forceSymbols: boolean): string;
     protected _getText(text: string, value: any, useSymbols: boolean, forceSymbols: boolean): string;
 }
 /**
@@ -5759,6 +5774,10 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     private _argsPoint;
     private _loaded;
     _pointsChanged: boolean;
+    /**
+     * palette color indices
+     */
+    _paletteColors: number[];
     _labelPos: PointLabelPosition;
     _labelPosCallback: (p: DataPointCallbackArgs) => PointLabelPosition;
     _labelOff: number;
@@ -6665,6 +6684,7 @@ declare abstract class AxisLabel<OP extends AxisLabelOptions = AxisLabelOptions>
     getIcon(tick: IAxisTick): string;
     getDefaultIconPos(): IconPosition;
     protected _doPrepareRender(chart: IChart): void;
+    protected _getText(text: string, value: any, useSymbols: boolean, forceSymbols: boolean): string;
 }
 interface IAxisTick {
     index: number;
@@ -7222,13 +7242,32 @@ interface AxisLabelOptions extends IconedTextOptions {
      * label 표시 간격.<br/>
      * 1이면 모든 tick 표시. 2이면 하나씩 건너 띄어서 표시.
      * 2 이상일 때 {@page startStep}으로 지정된 step부터 배치된다.
+     * ```js
+     * const config = {
+     *   xAxis: {
+     *       type: "linear",
+     *       tick: {
+     *           stepInterval: 1
+     *       },
+     *       label: {
+     *           startStep: 1,
+     *           step: 2,
+     *       }
+     *   },
+     *   series: [
+     *       {
+     *          data: [1, 2, 3, 4],
+     *       },
+     *   ],
+     * };
+     * ```
      *
      * @default 0
      */
     step?: number;
     /**
      * step이 2 이상이 될 때, 표시가 시작되는 label 위치.<br/>
-     * 0 ~ {@page step} - 1 사이의 값으로 지정한다.
+     * 0 ~ ({@page step} - 1) 사이의 값으로 지정한다.
      * 'category' 축에서 의미있게 사용할 수 있다.
      *
      * @default 0
@@ -7910,12 +7949,10 @@ interface CategoryAxisOptions extends AxisOptions {
     categories?: (string | object)[];
     /**
      * weigth 필드를 제공하는 시리즈.
-     * // TODO: 구현할 것!
      */
     weightSeries?: string;
     /**
      * weightSeries data에서 weight를 제공하는 필드.<br/>
-     * // TODO: 구현할 것! (시리즈가 아니라 여기서 지정한 게 맞나?)
      */
     weightField?: number | string;
     /**
@@ -8004,6 +8041,8 @@ type AxisFit = typeof _AxisFit[keyof typeof _AxisFit];
 interface ContinuousAxisLabelOptions extends AxisLabelOptions {
     /**
      * @override
+     *
+     * label에 표시될 숫자 값의 표시 형식.
      */
     numberFormat?: string;
 }
@@ -8055,7 +8094,6 @@ interface ContinuousAxisOptions extends AxisOptions {
     /**
      * {@page minPadding}, {@page maxPadding}이 설정되지 않았을 때 적용되는 기본값이다.
      *
-     * @default 0.04
      */
     padding?: number;
     /**
@@ -10152,7 +10190,7 @@ declare class ChartObject extends EventProvider<IChartEventListener> implements
     seriesByPoint(point: DataPoint): Series;
     gaugeByName(gauge: string): Gauge;
     gaugeAt(name: string | number): GaugeBase;
-    annotationByName(annotation: string): Annotation;
+    annotationByName(name: string): Annotation;
     axisByName(axis: string): Axis;
     containsAxis(axis: Axis): boolean;
     getXAxis(name: string | number): Axis;
@@ -10262,6 +10300,7 @@ declare abstract class Annotation<OP extends AnnotationOptions = AnnotationOptio
      * ```
      */
     get name(): string;
+    needClip(): boolean;
     getOffset(w: number, h: number): Point;
     getSize(wDomain: number, hDomain: number): Size;
     getPosition(inverted: boolean, left: number, top: number, wDomain: number, hDomain: number, width: number, height: number): Point;
@@ -10846,16 +10885,20 @@ declare abstract class AnnotationView<T extends Annotation = Annotation> extends
     static readonly CLASS_NAME: string;
     static register(...clses: [typeof Annotation<AnnotationOptions>, typeof AnnotationView<Annotation>][]): void;
     protected options: AnnotationOptions;
+    private _transform;
+    private _clip;
     constructor(doc: Document, styleName: string);
     update(owner: IAnnotationAnchorOwner, hintWidth: number, hintHeight: number): void;
+    addToTransform(child: RcElement): void;
     _layoutView(invertd: boolean, owner: IAnnotationAnchorOwner, x: number, y: number, w: number, h: number): void;
     private _posByAnchor;
+    resetClip(control: RcControl, width: number, height: number): void;
+    remove(): RcElement;
+    protected _updateTransform(): void;
     protected _marginable(): boolean;
     protected _resetBackBounds(): boolean;
     protected _setBackgroundStyle(back: RectElement): void;
     protected _doLayout(p: Point): void;
-    setRotation(originX: number, originY: number, rotation: number): RcElement;
-    protected _setRotation(originX: number, originY: number, rotation: number): void;
 }
 
 /**
@@ -12634,6 +12677,7 @@ declare class WaterfallSeriesPoint extends DataPoint {
 declare class WaterfallSeries extends RangedSeries<WaterfallSeriesOptions> {
     static readonly type = "waterfall";
     canCategorized(): boolean;
+    getBaseValue(axis: IAxis): number;
     protected _createPoint(source: any): DataPoint;
     protected _createLegendMarker(doc: Document, size: number): RcElement;
     protected _doPrepareRender(): void;
@@ -12954,6 +12998,12 @@ declare class Utils {
         symbol: string;
     };
     static jitter(v: number, amount: number): number;
+    /**
+     * 정수형 index로 random 유사값 생성
+     * @param i
+     * @returns
+     */
+    static randomLike(i: number): number;
 }
 
 declare const getVersion: typeof Globals.getVersion;