realchart 1.4.33 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import * as _realgrid_common from '@realgrid/common';
2
2
  import { RObject, Align, PercentSize, IPercentSize, ISides, IRect, VerticalAlign, TextFormatter, ROptionable, TextOrientation, ROptions } from '@realgrid/common';
3
- export { Align, IPercentSize, IRect, ORG_ANGLE, PI_2, PercentSize, RAD_DEG, RObject, RObject as RcObject, absv, assignObj, calcPercent, copyObj, cos, createRect, incv, isArray, isEmptyRect, isNumber, isObject, isString, maxv, minv, pickNum, pickProp, pickProp3, pixel, rectToSize, sin } from '@realgrid/common';
3
+ export { Align, IPercentSize, IRect, ORG_ANGLE, PI_2, PercentSize, RAD_DEG, RObject, RObject as RcObject, TextOrientation, VerticalAlign, absv, assignObj, calcPercent, copyObj, cos, createRect, incv, isArray, isEmptyRect, isNumber, isObject, isString, maxv, minv, pickNum, pickProp, pickProp3, pixel, rectToSize, sin } from '@realgrid/common';
4
4
 
5
5
  /**
6
6
  * @private
@@ -188,7 +188,7 @@ interface SVGStyles {
188
188
  fontStyle?: string;
189
189
  /**
190
190
  * SVG에 적용되는 css {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/rx rx} 스타일 속성.<br/>
191
- * {@link https://realchart.co.kr/config/config/seires/bar bar} 시리즈의 데이터포인트 bar의 모서리를 지정하는 데 사용된다.
191
+ * {@link https://realchart.co.kr/config/config/series/bar bar} 시리즈의 데이터포인트 bar의 모서리를 지정하는 데 사용된다.
192
192
  */
193
193
  rx?: string;
194
194
  /**
@@ -414,6 +414,7 @@ declare const _AssetType: {
414
414
  /** @dummy */
415
415
  type AssetType = typeof _AssetType[keyof typeof _AssetType];
416
416
  /**
417
+ * assets에 등록하는 에셋 항목의 공통 속성이다. gradient/pattern/image가 이 인터페이스를 확장한다.<br/>
417
418
  */
418
419
  interface AssetItemOptions {
419
420
  /** @dummy */
@@ -427,6 +428,7 @@ interface AssetItemOptions {
427
428
  id: string;
428
429
  }
429
430
  /**
431
+ * 그라데이션 에셋을 정의한다. 시리즈·band 등에서 이름 또는 인라인으로 참조한다.<br/>
430
432
  */
431
433
  interface GradientOptions extends AssetItemOptions {
432
434
  /**
@@ -504,6 +506,7 @@ interface PatternOptions extends AssetItemOptions {
504
506
  backgroundStyle?: SVGStyles;
505
507
  }
506
508
  /**
509
+ * 단일 이미지 에셋을 정의한다. annotation·pictorial 등에서 참조한다.<br/>
507
510
  */
508
511
  interface ImageOptions {
509
512
  /**
@@ -514,7 +517,7 @@ interface ImageOptions {
514
517
  url: string;
515
518
  }
516
519
  /**
517
- * @dummy
520
+ * 이미지 목록 에셋을 정의한다. pictorial 등에서 여러 이미지를 묶을 때 사용한다.<br/>
518
521
  */
519
522
  interface ImageListOptions extends AssetItemOptions {
520
523
  /** @dummy */
@@ -570,16 +573,52 @@ interface IAssetOwner {
570
573
  removeDef(element: string): void;
571
574
  }
572
575
  /**
573
- * 종류 구분없이 id는 유일하게 반드시 지정해야 한다.
576
+ * 차트에 등록된 asset들을 보관하는 컬렉션.<br/>
577
+ * gradient, pattern 등 SVG def로 등록되는 항목과 이미지처럼 def 없이 참조되는 항목을 함께 담는다.<br/>
578
+ * 종류 구분없이 id는 유일하게 반드시 지정해야 한다.<br/>
579
+ * {@link https://realchart.co.kr/docs/api/options/ChartConfiguration#asset asset}으로 설정하고, {@link Chart#assets}로 접근한다.
574
580
  */
575
581
  declare class AssetCollection {
576
582
  private _items;
577
583
  private _map;
584
+ /**
585
+ * asset 설정을 읽어 컬렉션을 다시 구성한다.<br/>
586
+ * 기존 항목은 모두 버려진다.
587
+ *
588
+ * @param source asset 설정 하나 또는 배열.
589
+ * @returns 읽어들인 설정. source가 배열이면 배열로 반환한다.
590
+ */
578
591
  load(source: any): AssetOptionsType | AssetOptionsType[];
592
+ /**
593
+ * asset 설정을 갱신한다.
594
+ *
595
+ * @param source 새 asset 설정.
596
+ * @param render true면 갱신 후 다시 그린다.
597
+ */
579
598
  updateOptions(source: any, render: boolean): void;
599
+ /**
600
+ * def가 필요한 asset들의 SVG 요소를 만들어 owner에 등록한다.
601
+ *
602
+ * @param doc SVG 요소를 생성할 document.
603
+ * @param owner 생성된 def를 담을 대상.
604
+ */
580
605
  register(doc: Document, owner: IAssetOwner): void;
606
+ /**
607
+ * {@link register}로 등록했던 def들을 owner에서 제거한다.
608
+ *
609
+ * @param owner def를 제거할 대상.
610
+ */
581
611
  unregister(owner: IAssetOwner): void;
612
+ /**
613
+ * id로 asset 항목을 찾아 반환한다.
614
+ *
615
+ * @param id 찾을 asset의 id.
616
+ * @returns 해당 asset 항목. 없으면 undefined.
617
+ */
582
618
  get(id: string): AssetItem<AssetOptionsType>;
619
+ /**
620
+ * 렌더링 전에 모든 asset 항목을 준비시킨다.
621
+ */
583
622
  prepareRender(): void;
584
623
  get options(): AssetOptionsType[];
585
624
  private $_loadItem;
@@ -616,9 +655,13 @@ interface IPointerHandler {
616
655
  handleUp(ev: PointerEvent): void;
617
656
  handleMove(ev: PointerEvent): void;
618
657
  handleLeave(ev: PointerEvent): void;
658
+ handleCancel(ev: PointerEvent): void;
619
659
  handleClick(ev: PointerEvent): void;
620
660
  handleDblClick(ev: PointerEvent): void;
621
661
  handleWheel(ev: WheelEvent): void;
662
+ dispose?(): void;
663
+ /** 페이지 스크롤을 막기 위해 touchmove preventDefault가 필요한지 (탭은 false). */
664
+ shouldPreventTouchMove?(ev?: TouchEvent): boolean;
622
665
  }
623
666
  /**
624
667
  * @private
@@ -638,6 +681,8 @@ declare abstract class RcControl extends RObject implements IAssetOwner {
638
681
  private _defs;
639
682
  private _root;
640
683
  private _pointerHandler;
684
+ /** 제스처 중 덮어쓴 사용자 container의 원래 inline touch-action */
685
+ private _containerTouchAction;
641
686
  private _inited;
642
687
  private _testing;
643
688
  private _dirty;
@@ -730,6 +775,11 @@ declare abstract class RcControl extends RObject implements IAssetOwner {
730
775
  toOffset(event: any): any;
731
776
  setPointerCapture(ev: PointerEvent): void;
732
777
  releasePointerCapture(ev: PointerEvent): void;
778
+ /**
779
+ * falsy이면 control은 `pan-y`, 사용자 container는 제스처 전 inline 값으로 복원한다.
780
+ */
781
+ setTouchAction(value?: string): void;
782
+ isTouchScrollBlocked(): boolean;
733
783
  private _clickHandler;
734
784
  private _dblClickHandler;
735
785
  private _touchMoveHandler;
@@ -1035,7 +1085,7 @@ declare const _Shapes: {
1035
1085
  };
1036
1086
  /** @dummy */
1037
1087
  type Shape = typeof _Shapes[keyof typeof _Shapes];
1038
- /** tooltip listMarkerShape: {@link Shape} 또는 마커 없음 */
1088
+ /** tooltip listMarkerShape: `Shape` 또는 마커 없음 */
1039
1089
  type TooltipMarkerShape = Shape | 'none';
1040
1090
  declare class SvgShapes {
1041
1091
  private static _createDrawers;
@@ -1157,7 +1207,8 @@ interface DataPointLabelOptions extends IconedTextOptions {
1157
1207
  position?: PointLabelPosition;
1158
1208
  /**
1159
1209
  * label과 point view 혹은 connector 사이의 기본 간격.<br/>
1160
- * 숫자 대신 콜백을 설정해서 데이터포인트별 값을 지정할 수 있다.
1210
+ * 숫자 대신 콜백을 설정해서 데이터포인트별 값을 지정할 수 있다.<br/>
1211
+ * 콜백 반환값은 최종 간격으로 사용되며 시리즈별 보정(마커 반지름 등)은 적용되지 않는다.<br/>
1161
1212
  * 콜백에서 타당한 값을 리턴하지 않으면 기본값이 사용된다.
1162
1213
  *
1163
1214
  * @default 4 pixel
@@ -1405,7 +1456,7 @@ interface TrendlineLabelOptions extends Omit<IconedTextOptions, 'numberFormat' |
1405
1456
  * 0보다 큰 값이면 원래 표시 위치에서 수평으로 멀어지고, 음수면 가까워진다.<br/>
1406
1457
  *
1407
1458
  * @default {@link align}이 'left'나 'right'일 때는 4, 아니면 0
1408
- } */
1459
+ */
1409
1460
  offsetX?: number;
1410
1461
  /**
1411
1462
  * 0보다 큰 값이면 원래 표시 위치에서 수직으로 멀어지고, 음수면 가까워진다.<br/>
@@ -1414,7 +1465,9 @@ interface TrendlineLabelOptions extends Omit<IconedTextOptions, 'numberFormat' |
1414
1465
  */
1415
1466
  offsetY?: number;
1416
1467
  }
1417
- /** @dummy */
1468
+ /**
1469
+ * 추세선 끝점 마커 표시를 제어한다.<br/>
1470
+ */
1418
1471
  interface TrendlineMarkerOptions extends ChartItemOptions {
1419
1472
  /**
1420
1473
  * @default false
@@ -1516,12 +1569,16 @@ interface TrendlineOptions extends ChartItemOptions {
1516
1569
  * 추세선을 앞으로(데이터의 X축 증가 방향) 얼마만큼 연장(예측)할지 지정한다.<br/>
1517
1570
  * 숫자는 X축 단위(예: 시간 단위 또는 X 값 자체)로 해석된다.
1518
1571
  * 0보다 큰 값으로 지정해야 한다.
1572
+ *
1573
+ * @default 0
1519
1574
  */
1520
1575
  forward?: number;
1521
1576
  /**
1522
1577
  * 추세선을 뒤로(데이터의 X축 감소 방향) 얼마만큼 연장할지 지정한다.<br/>
1523
1578
  * 숫자는 X축 단위로 해석된다.
1524
1579
  * 0보다 큰 값으로 지정해야 한다.
1580
+ *
1581
+ * @default 0
1525
1582
  */
1526
1583
  backward?: number;
1527
1584
  /**
@@ -1731,7 +1788,6 @@ interface SeriesOptions extends ChartItemOptions {
1731
1788
  */
1732
1789
  tooltipText?: string;
1733
1790
  /**
1734
- * #1386
1735
1791
  * 축이나 시리즈그룹의 툴팁으로 표시될 때,
1736
1792
  * 시리즈 키(주로 이름) 다음에 표시되는 상세 정보(주로 값) 템플릿.<br/>
1737
1793
  * {@link tooltipDetailCallback}이 설정되고 콜백에서 undefined를 리턴하지 않으면 이 속성은 무시된다.<br/>
@@ -1772,7 +1828,7 @@ interface SeriesOptions extends ChartItemOptions {
1772
1828
  pointStyleCallback?: (args: DataPointCallbackArgs) => SVGStyleOrClass;
1773
1829
  /**
1774
1830
  * 시리즈의 hover, focus, tooltip 상호작용 여부를 지정한다.<br/>
1775
- * 차트 {@link https://realchart.co.kr/config/config/general/interactive interactive}가 false이면 hover·focus·tooltip은 비활성화된다.
1831
+ * 차트 {@link https://realchart.co.kr/config/config/general#interactive interactive}가 false이면 hover·focus·tooltip은 비활성화된다.
1776
1832
  *
1777
1833
  * @default true
1778
1834
  */
@@ -1800,6 +1856,7 @@ interface SeriesOptions extends ChartItemOptions {
1800
1856
  onPointHover?: (args: DataPointCallbackArgs) => void;
1801
1857
  }
1802
1858
  /**
1859
+ * 포인트를 선으로 연결하는 시리즈(line/area 등)의 공통 옵션이다.<br/>
1803
1860
  */
1804
1861
  interface ConnectableSeriesOptions extends SeriesOptions {
1805
1862
  /**
@@ -1808,11 +1865,12 @@ interface ConnectableSeriesOptions extends SeriesOptions {
1808
1865
  trendline?: TrendlineOptions;
1809
1866
  }
1810
1867
  /**
1868
+ * 클러스터(묶음) 배치가 가능한 시리즈 옵션이다.<br/>
1811
1869
  */
1812
1870
  interface ClusterableSeriesOptions extends ConnectableSeriesOptions {
1813
1871
  /**
1814
1872
  * 시리즈가 그룹에 포함되지 않거나,
1815
- * 포함된 그룹의 layout이 {@link SeriesGroupLayout.DEFAULT DEFAULT}이거나 특별히 설정되지 않아서,
1873
+ * 포함된 그룹의 layout이 `'default'`이거나 특별히 설정되지 않아서,
1816
1874
  * 그룹에 포함된 시리즈들의 data point가 옆으로 나열되어 표시될 때,
1817
1875
  * 포인트 표시 영역 내에서 이 시리즈의 포인트가 차지하는 영역의 상대 크기.<br/>
1818
1876
  * 예를 들어 이 시리즈의 속성값이 1이고 다른 시리즈의 값이 2이면 다른 시리즈의 data point가 두 배 두껍게 표시된다.
@@ -1850,7 +1908,9 @@ interface ClusterableSeriesOptions extends ConnectableSeriesOptions {
1850
1908
  */
1851
1909
  clusterable?: boolean;
1852
1910
  }
1853
- /** */
1911
+ /**
1912
+ * 기준값(base)을 갖는 시리즈의 포인트 라벨을 제어한다.<br/>
1913
+ */
1854
1914
  interface BasedSeriesLabelOptions extends DataPointLabelOptions {
1855
1915
  /**
1856
1916
  * 데이터포인트 라벨의 수평 정렬 방식.<br/>
@@ -1908,7 +1968,7 @@ interface BasedSeriesOptions extends ClusterableSeriesOptions {
1908
1968
  */
1909
1969
  nullAsBase?: boolean;
1910
1970
  /**
1911
- * {@link baseValue} 또는 y축의 {@link https://realchart.co.kr/config/config/yAxis#baseValue baseValue}로 지정되는
1971
+ * {@link baseValue} 또는 y축의 {@link https://realchart.co.kr/config/config/yAxis/linear#baseValue baseValue}로 지정되는
1912
1972
  * 기준값 보다 작은 쪽의 point들에 적용되는 스타일.<br/>
1913
1973
  */
1914
1974
  belowStyle?: SVGStyleOrClass;
@@ -1931,6 +1991,7 @@ interface BasedSeriesOptions extends ClusterableSeriesOptions {
1931
1991
  distance?: number;
1932
1992
  }
1933
1993
  /**
1994
+ * 막대 계열(bar/circlebar 등) 시리즈가 공유하는 공통 옵션이다.<br/>
1934
1995
  */
1935
1996
  interface BarSeriesBaseOptions extends BasedSeriesOptions {
1936
1997
  /**
@@ -2021,7 +2082,6 @@ interface SeriesGroupOptions<T extends SeriesOptions = SeriesOptions> extends Ch
2021
2082
  */
2022
2083
  visibleInLegend?: boolean;
2023
2084
  /**
2024
- * // #1151
2025
2085
  * true로 지정하면 legend에 시리즈들을 반대 순서로 배치한다.<br/>
2026
2086
  */
2027
2087
  reversedInLegend?: boolean;
@@ -2131,6 +2191,7 @@ interface AreaSeriesGroupOptions extends SeriesGroupOptions<AreaSeriesOptions> {
2131
2191
  baseValue?: number;
2132
2192
  }
2133
2193
  /**
2194
+ * 클러스터(묶음) 배치가 가능한 시리즈 그룹 옵션이다.<br/>
2134
2195
  */
2135
2196
  interface ClusterableSeriesGroupOptions<T extends SeriesOptions = SeriesOptions> extends SeriesGroupOptions<T> {
2136
2197
  /**
@@ -2153,6 +2214,7 @@ interface ClusterableSeriesGroupOptions<T extends SeriesOptions = SeriesOptions>
2153
2214
  clusterable?: boolean;
2154
2215
  }
2155
2216
  /**
2217
+ * 막대 계열 그룹이 공유하는 레이아웃·스택 관련 옵션이다.<br/>
2156
2218
  */
2157
2219
  interface BarSeriesGroupBaseOptions<T extends BarSeriesBaseOptions> extends ClusterableSeriesGroupOptions<T> {
2158
2220
  /**
@@ -2202,6 +2264,7 @@ interface SeriesMarkerOptions extends ChartItemOptions {
2202
2264
  styleCallback?: (args: DataPointCallbackArgs) => SVGStyleOrClass;
2203
2265
  }
2204
2266
  /**
2267
+ * 마커로 포인트를 그리는 시리즈(scatter/bubble 등)의 공통 옵션이다.<br/>
2205
2268
  */
2206
2269
  interface MarkerSeriesOptions extends ConnectableSeriesOptions {
2207
2270
  /**
@@ -2619,7 +2682,7 @@ interface PieSeriesGroupOptions extends SeriesGroupOptions<PieSeriesOptions> {
2619
2682
  * 픽셀 크기나 차지할 수 있는 전체 크기에 대한 상대적 크기로 지정할 수 있다.
2620
2683
  * <br>
2621
2684
  * Pie 시리즈들의 그룹이고,
2622
- * {@link layout}이 {@link SeriesGroupLayout.FILL FILL}이나 {@link SeriesGroupLayout.STACK STACK}인 경우
2685
+ * {@link layout}이 `'fill'`이나 `'stack'`인 경우
2623
2686
  * 개별 시리즈의 size 대신 이 속성값으로 표시되고,
2624
2687
  * 각 시리즈의 size는 상대 크기로 적용된다.
2625
2688
  *
@@ -2628,7 +2691,7 @@ interface PieSeriesGroupOptions extends SeriesGroupOptions<PieSeriesOptions> {
2628
2691
  polarSize?: PercentSize;
2629
2692
  /**
2630
2693
  * Pie 시리즈들의 그룹이고,
2631
- * {@link layout}이 {@link SeriesGroupLayout.FILL FILL}이나 {@link SeriesGroupLayout.STACK STACK}인 경우,
2694
+ * {@link layout}이 `'fill'`이나 `'stack'`인 경우,
2632
2695
  * 경우 0보다 큰 값을 지정해서 도넛 형태로 표시할 수 있다.
2633
2696
  * <br>
2634
2697
  * 포함된 pie 시리즈들의 innerSize는 무시된다.
@@ -2638,6 +2701,7 @@ interface PieSeriesGroupOptions extends SeriesGroupOptions<PieSeriesOptions> {
2638
2701
  innerSize?: PercentSize;
2639
2702
  }
2640
2703
  /**
2704
+ * 라인 시리즈 포인트 라벨 표시를 제어한다.<br/>
2641
2705
  */
2642
2706
  interface LinePointLabelOptions extends DataPointLabelOptions {
2643
2707
  /**
@@ -3357,6 +3421,7 @@ interface CandlestickSeriesOptions extends LowRangedSeriesOptions {
3357
3421
  tooltipDetail?: string;
3358
3422
  }
3359
3423
  /**
3424
+ * 원형 막대 포인트 라벨 표시를 제어한다.<br/>
3360
3425
  */
3361
3426
  interface CircleBarPointLabelOptions extends DataPointLabelOptions {
3362
3427
  /**
@@ -3410,7 +3475,9 @@ interface CircleBarSeriesGroupOptions extends BarSeriesGroupBaseOptions<CircleBa
3410
3475
  */
3411
3476
  type?: typeof CircleBarSeriesGroupType;
3412
3477
  }
3413
- /** */
3478
+ /**
3479
+ * 덤벨 시리즈 양끝 마커 모양을 제어한다.<br/>
3480
+ */
3414
3481
  interface DumbbellSeriesMarkerOptions extends SeriesMarkerOptions {
3415
3482
  /**
3416
3483
  * @append
@@ -3544,6 +3611,7 @@ interface EqualizerSeriesOptions extends BasedSeriesOptions {
3544
3611
  segmented?: boolean;
3545
3612
  }
3546
3613
  /**
3614
+ * low~high 범위 값을 갖는 시리즈(barrange 등)의 공통 옵션이다.<br/>
3547
3615
  */
3548
3616
  interface LowRangedSeriesOptions extends RangedSeriesOptions {
3549
3617
  /**
@@ -3799,6 +3867,7 @@ interface AreaRangeSeriesOptions extends LineSeriesBaseOptions {
3799
3867
  tooltipDetail?: string;
3800
3868
  }
3801
3869
  /**
3870
+ * 롤리팝 시리즈 마커 모양을 제어한다.<br/>
3802
3871
  */
3803
3872
  interface LollipopSeriesMarkerOptions extends SeriesMarkerOptions {
3804
3873
  /**
@@ -3808,13 +3877,13 @@ interface LollipopSeriesMarkerOptions extends SeriesMarkerOptions {
3808
3877
  */
3809
3878
  radius?: number;
3810
3879
  /**
3811
- * {@link https://realchart.co.kr/config/config/series/lollipop/radiusField radiusField}값에 따라 상대적으로 적용되는 radius의 최대 크기<br/>
3880
+ * {@link https://realchart.co.kr/config/config/series/lollipop#radiusField radiusField}값에 따라 상대적으로 적용되는 radius의 최대 크기<br/>
3812
3881
  *
3813
3882
  * @default 8
3814
3883
  */
3815
3884
  maxRadius?: number;
3816
3885
  /**
3817
- * {@link https://realchart.co.kr/config/config/series/lollipop/radiusField radiusField}값에 따라 상대적으로 적용되는 radius의 최소 크기<br/>
3886
+ * {@link https://realchart.co.kr/config/config/series/lollipop#radiusField radiusField}값에 따라 상대적으로 적용되는 radius의 최소 크기<br/>
3818
3887
  *
3819
3888
  * @default 2
3820
3889
  */
@@ -3990,6 +4059,7 @@ interface RadialSeriesOptions extends WidgetSeriesOptions {
3990
4059
  clockwise?: boolean;
3991
4060
  }
3992
4061
  /**
4062
+ * 파이 슬라이스·센터 텍스트 표시를 제어한다.<br/>
3993
4063
  */
3994
4064
  interface PieSeriesTextOptions extends IconedTextOptions {
3995
4065
  }
@@ -4132,9 +4202,9 @@ interface PieSeriesOptions extends RadialSeriesOptions {
4132
4202
  innerText?: PieSeriesTextOptions;
4133
4203
  /**
4134
4204
  * 깊이 설정 옵션.<br/>
4135
- * 0보다 큰 숫자로 지정하면 {@link https://realchart.co.kr/docs/api/options/AxisDepthOptions/visible visible}을 true로 설정하고,
4136
- * {@link https://realchart.co.kr/docs/api/options/PieSeriesDepthOptions/length length}를 지정하는 것과 동일하다.<br/>
4137
- * [주의] 이 값이 지정되면 {@link https://realchart.co.kr/docs/api/options/AxisTickOptions/length length} 설정은 무시된다.<br/>
4205
+ * 0보다 큰 숫자로 지정하면 {@link https://realchart.co.kr/docs/api/options/BodyDepthOptions#visible visible}을 true로 설정하고,
4206
+ * {@link https://realchart.co.kr/docs/api/options/PieSeriesDepthOptions#length length}를 지정하는 것과 동일하다.<br/>
4207
+ * [주의] 이 값이 지정되면 {@link https://realchart.co.kr/docs/api/options/AxisTickOptions#length length} 설정은 무시된다.<br/>
4138
4208
  */
4139
4209
  depth?: PieSeriesDepthOptions | number | boolean;
4140
4210
  }
@@ -4200,6 +4270,7 @@ interface ScatterSeriesOptions extends MarkerSeriesOptions {
4200
4270
  hoverScale?: number;
4201
4271
  }
4202
4272
  /**
4273
+ * 범위(min~max 등) 값을 표현하는 시리즈의 공통 옵션이다. barrange·arearange 계열이 확장한다.<br/>
4203
4274
  */
4204
4275
  interface RangedSeriesOptions extends ClusterableSeriesOptions {
4205
4276
  }
@@ -4285,6 +4356,7 @@ declare const _TreemapAlgorithm: {
4285
4356
  /** @dummy */
4286
4357
  type TreemapAlgorithm = typeof _TreemapAlgorithm[keyof typeof _TreemapAlgorithm];
4287
4358
  /**
4359
+ * 트리맵 등 트리 그룹 헤드(부모 노드) 표시를 제어한다.<br/>
4288
4360
  */
4289
4361
  interface TreeGroupHeadOptions extends ChartItemOptions {
4290
4362
  /**
@@ -4574,6 +4646,8 @@ declare const WordCloudSeriesType = "wordcloud";
4574
4646
  * @modules wordcloud
4575
4647
  */
4576
4648
  interface WordCloudSeriesOptions extends WidgetSeriesOptions {
4649
+ /** @dummy */
4650
+ type?: typeof WordCloudSeriesType;
4577
4651
  /**
4578
4652
  * 표시할 단어들이 포함된 전체 텍스트.<br/>
4579
4653
  * 이 속성에 비어 있지 않은 문자열이 설정되면 {@link data}는 무시된다.
@@ -4684,11 +4758,12 @@ interface WordCloudSeriesOptions extends WidgetSeriesOptions {
4684
4758
  }
4685
4759
  declare const PictogramSeriesType = "pictogram";
4686
4760
  /**
4687
- * @private
4688
- *
4689
- * pictogram 시리즈 모델.<br/>
4761
+ * Pictogram 시리즈.<br/>
4690
4762
  * {@link https://realchart.co.kr/docs/api/options/SeriesOptions#type type}은 'pictogram'이다.<br/>
4691
- * 지정한 이미지 아이콘을 반복한다.
4763
+ * 지정한 이미지 아이콘을 값에 비례해 반복 표시한다.<br/>
4764
+ *
4765
+ * @css 'rct-pictogram-series'
4766
+ * @modules pictogram
4692
4767
  */
4693
4768
  interface PictogramSeriesOptions extends BasedSeriesOptions {
4694
4769
  /** @dummy */
@@ -4867,15 +4942,15 @@ interface PictorialSeriesOptions extends WidgetSeriesOptions {
4867
4942
  */
4868
4943
  size?: PercentSize;
4869
4944
  /**
4870
- * {@link Pictorial} 표시 너비를 pixel이나 body 너비에 대한 비율(%)로 지정한다.<br/>
4945
+ * {@link https://realchart.co.kr/config/config/series/pictorial pictorial} 표시 너비를 pixel이나 body 너비에 대한 비율(%)로 지정한다.<br/>
4871
4946
  * 이 크기를 지정하지 않으면 {@link size} 설정에 맞게 자동으로 적용된다.
4872
- * {@link size}도 지정되지 않았다면 {@link Pictorial}에 지정된 svg 크기대로 표시된다.
4947
+ * {@link size}도 지정되지 않았다면 {@link https://realchart.co.kr/config/config/series/pictorial pictorial}에 지정된 svg 크기대로 표시된다.
4873
4948
  */
4874
4949
  width?: PercentSize;
4875
4950
  /**
4876
- * {@link Pictorial} 표시 너비를 pixel이나 body 높이에 대한 비율(%)로 지정한다.<br/>
4951
+ * {@link https://realchart.co.kr/config/config/series/pictorial pictorial} 표시 너비를 pixel이나 body 높이에 대한 비율(%)로 지정한다.<br/>
4877
4952
  * 이 크기를 지정하지 않으면 {@link size} 설정에 맞게 자동으로 적용된다.
4878
- * {@link size}도 지정되지 않았다면 {@link Pictorial}에 지정된 svg 크기대로 표시된다.
4953
+ * {@link size}도 지정되지 않았다면 {@link https://realchart.co.kr/config/config/series/pictorial pictorial}에 지정된 svg 크기대로 표시된다.
4879
4954
  */
4880
4955
  height?: PercentSize;
4881
4956
  /**
@@ -5399,7 +5474,7 @@ interface ChartGeneralOptions extends ChartItemOptions {
5399
5474
  interactive?: boolean;
5400
5475
  /**
5401
5476
  * false로 지정하면 차트 전체척으로 animation 효과를 실행하지 않는다.<br/>
5402
- * {@link https://realchart.co.kr/config/config/general/interactive interactive}가 false이면 이 옵션과 관계없이 animation은 실행되지 않는다.<br/>
5477
+ * {@link https://realchart.co.kr/config/config/general#interactive interactive}가 false이면 이 옵션과 관계없이 animation은 실행되지 않는다.<br/>
5403
5478
  *
5404
5479
  * @default true
5405
5480
  */
@@ -5407,7 +5482,7 @@ interface ChartGeneralOptions extends ChartItemOptions {
5407
5482
  /**
5408
5483
  * false로 지정하면 차트 전체에서 마우스 hover 상호작용을 비활성화한다.<br/>
5409
5484
  * tooltip, pointHovering, seriesHovering, crosshair 등 hover 기반 기능이 모두 작동하지 않는다.<br/>
5410
- * {@link https://realchart.co.kr/config/config/general/interactive interactive}가 false이면 이 옵션과 관계없이 hover 상호작용은 비활성화된다.<br/>
5485
+ * {@link https://realchart.co.kr/config/config/general#interactive interactive}가 false이면 이 옵션과 관계없이 hover 상호작용은 비활성화된다.<br/>
5411
5486
  *
5412
5487
  * @default true
5413
5488
  */
@@ -5415,7 +5490,7 @@ interface ChartGeneralOptions extends ChartItemOptions {
5415
5490
  /**
5416
5491
  * false로 지정하면 차트 전체에서 마우스 click 상호작용을 비활성화한다.<br/>
5417
5492
  * onPointClick, 범례 클릭, annotation 클릭 등 클릭 기반 기능이 모두 작동하지 않는다.<br/>
5418
- * {@link https://realchart.co.kr/config/config/general/interactive interactive}가 false이면 이 옵션과 관계없이 click 상호작용은 비활성화된다.<br/>
5493
+ * {@link https://realchart.co.kr/config/config/general#interactive interactive}가 false이면 이 옵션과 관계없이 click 상호작용은 비활성화된다.<br/>
5419
5494
  *
5420
5495
  * @default true
5421
5496
  */
@@ -5445,7 +5520,7 @@ interface ChartGeneralOptions extends ChartItemOptions {
5445
5520
  * x축 값이 설정되지 않은 시리즈 첫번째 데이터 point에 설정되는 x값.<br/>
5446
5521
  * 이 후에는 {@link xStep}씩 증가시키면서 설정한다.
5447
5522
  * 시리즈의 {@link Series.xStart xStart}가 설정되면 그 값이 사용된다.
5448
- * 값이 지정되지 않으면 'log' 축일 때 1, 아니면 0으로 계산된다. // #528
5523
+ * 값이 지정되지 않으면 'log' 축일 때 1, 아니면 0으로 계산된다.
5449
5524
  */
5450
5525
  xStart?: number;
5451
5526
  /**
@@ -5490,6 +5565,8 @@ interface ChartGeneralOptions extends ChartItemOptions {
5490
5565
  }
5491
5566
  type ChartOptionsOptions = ChartGeneralOptions;
5492
5567
  /**
5568
+ * body 배경 이미지를 지정한다. 플롯 영역 뒤에 표시된다.<br/>
5569
+ *
5493
5570
  * @css 'rct-body-image'
5494
5571
  */
5495
5572
  interface BackgroundImageOptions extends ChartItemOptions {
@@ -5515,6 +5592,8 @@ declare const _ZoomType: {
5515
5592
  /** @dummy */
5516
5593
  type ZoomType = typeof _ZoomType[keyof typeof _ZoomType];
5517
5594
  /**
5595
+ * 줌 리셋 버튼의 표시와 스타일을 제어한다.<br/>
5596
+ *
5518
5597
  * @css 'rct-reset-zoom'
5519
5598
  */
5520
5599
  interface ZoomButtonOptions extends ChartItemOptions {
@@ -5535,6 +5614,8 @@ interface ZoomButtonOptions extends ChartItemOptions {
5535
5614
  interface PolarInnerTextOptions extends IconedTextOptions {
5536
5615
  }
5537
5616
  /**
5617
+ * 데이터가 없을 때 표시할 안내 텍스트·스타일을 지정한다.<br/>
5618
+ *
5538
5619
  * @css 'rct-empty-view'
5539
5620
  */
5540
5621
  interface EmptyViewOptions extends ChartTextOptions {
@@ -5609,7 +5690,7 @@ interface ZoomCallbackArgs {
5609
5690
  }
5610
5691
  /**
5611
5692
  * {@link BodyDepth.depth depth}가 지정된 body 영역의 양 축 방향에 표시되는
5612
- * {@link https://realchart.co.kr/config/config/body#xSide side} panel의 경계선 설정 옵션.<br/>
5693
+ * {@link https://realchart.co.kr/config/config/body/depth#xSide side} panel의 경계선 설정 옵션.<br/>
5613
5694
  */
5614
5695
  interface BodyDepthLineOptions extends ChartItemOptions {
5615
5696
  /**
@@ -5651,7 +5732,7 @@ interface BodyDepthOptions extends ChartItemOptions {
5651
5732
  /**
5652
5733
  * 픽셀 단위의 body 깊이.<br/>
5653
5734
  *
5654
- * @default 24
5735
+ * @default 32
5655
5736
  */
5656
5737
  length?: number;
5657
5738
  /**
@@ -5740,7 +5821,14 @@ interface BodyOptions extends ChartItemOptions {
5740
5821
  */
5741
5822
  emptyView?: EmptyViewOptions | boolean;
5742
5823
  /**
5743
- * plot 영역 마우스 드래깅을 통한 zooming 방식.
5824
+ * plot 영역 zooming 방식.<br/>
5825
+ * 마우스에서는 plot을 드래그해 사각형으로 zoom한다.<br/>
5826
+ * 터치에서는 pinch zoom에 쓰이며, 사각형 드래그 zoom은 하지 않는다.<br/>
5827
+ * {@link https://realchart.co.kr/config/config/#polar polar} 차트에서는 pinch/pan이 적용되지 않는다.<br/>
5828
+ * {@link https://realchart.co.kr/config/config/tooltip#followTouch followTouch}가 true(기본)이면 1손가락은 툴팁이 가져가 pinch/pan은 두 손가락으로 한다.
5829
+ * false이고 이미 zoom된 상태에서는 1손가락 pan이 된다.<br/>
5830
+ * `'none'`이어도 navigator 등으로 이미 zoom된 상태이면 두 손가락 pan은 가능하다.<br/>
5831
+ * {@link https://realchart.co.kr/guide/zoom 줌} 페이지를 참조한다.
5744
5832
  *
5745
5833
  * @default 'none'
5746
5834
  */
@@ -5763,18 +5851,22 @@ interface BodyOptions extends ChartItemOptions {
5763
5851
  zoomCallback?: (series: ZoomCallbackArgs) => void;
5764
5852
  /**
5765
5853
  * 깊이 설정 옵션.<br/>
5766
- * 0보다 큰 숫자로 지정하면 {@link https://realchart.co.kr/docs/api/options/AxisDepthOptions/visible visible}을 true로 설정하고,
5767
- * {@link https://realchart.co.kr/docs/api/options/BodyDepthOptions/length length}를 지정하는 것과 동일하다.<br/>
5768
- * [주의] 이 값이 지정되면 {@link https://realchart.co.kr/docs/api/options/AxisTickOptions/length length} 설정은 무시된다.<br/>
5854
+ * 0보다 큰 숫자로 지정하면 {@link https://realchart.co.kr/docs/api/options/BodyDepthOptions#visible visible}을 true로 설정하고,
5855
+ * {@link https://realchart.co.kr/docs/api/options/BodyDepthOptions#length length}를 지정하는 것과 동일하다.<br/>
5856
+ * [주의] 이 값이 지정되면 {@link https://realchart.co.kr/docs/api/options/AxisTickOptions#length length} 설정은 무시된다.<br/>
5769
5857
  */
5770
5858
  depth?: BodyDepthOptions | number | boolean;
5771
5859
  }
5772
5860
  /**
5861
+ * 시리즈 내비게이터 드래그 핸들의 모양을 제어한다.<br/>
5862
+ *
5773
5863
  * @css 'rct-navigator-handle'
5774
5864
  */
5775
5865
  interface NavigiatorHandleOptions extends ChartItemOptions {
5776
5866
  }
5777
5867
  /**
5868
+ * 내비게이터에서 선택 구간 밖을 가리는 마스크 스타일을 지정한다.<br/>
5869
+ *
5778
5870
  * @css 'rct-navigator-mask'
5779
5871
  */
5780
5872
  interface NavigiatorMaskOptions extends ChartItemOptions {
@@ -5805,7 +5897,6 @@ interface SeriesNavigatorOptions extends ChartItemOptions {
5805
5897
  * true로 지정하면 {@link source}로 지정한 원본 시리즈로부터 내비게이터 시리즈의 데이터포인트들을 생성할 때,
5806
5898
  * 원본 시리즈의 data로 지정된 값들을 사용하고, 내비게이터 시리즈의 yField를 원본과 다르게 지정할 수도 있다.<br/>
5807
5899
  * 기본값 false일 때는 이미 생성된 원본 데이터포인트의 x, y 값을 사용한다.
5808
- * // #431
5809
5900
  *
5810
5901
  * @default false
5811
5902
  */
@@ -6033,7 +6124,8 @@ declare const _TooltipScope: {
6033
6124
  type TooltipScope = typeof _TooltipScope[keyof typeof _TooltipScope];
6034
6125
  /**
6035
6126
  * 데이터포인트 뷰에 마우스가 올라가면 표시되는 툴팁 상자 옵션.<br/>
6036
- * {@link https://realchart.co.kr/guide/tooltip 툴팁 개요} 페이지를 참조한다.
6127
+ * 터치에서 포인트를 따라가는 동작은 {@link followTouch}를 사용한다.<br/>
6128
+ * {@link https://realchart.co.kr/guide/tooltip 툴팁 개요} · {@link https://realchart.co.kr/guide/zoom 줌} 페이지를 참조한다.
6037
6129
  *
6038
6130
  * @css 'rct-tooltip'
6039
6131
  */
@@ -6093,13 +6185,25 @@ interface TooltipOptions extends ChartItemOptions {
6093
6185
  */
6094
6186
  minHeight?: number;
6095
6187
  /**
6096
- * true이면 툴팁 상자가 마우스 포인터를 따라 다닌다.
6097
- * <br/>
6188
+ * true이면 툴팁 상자가 마우스 포인터를 따라 다닌다.<br/>
6189
+ * 터치에서 포인트를 따라가는 동작은 {@link followTouch}가 담당한다.<br/>
6098
6190
  * false, true를 명시적으로 지정하지 않으면 시리즈 종류에 따라 자동 설정된다.
6099
6191
  * ex) pie 시리즈는 true, bar 시리즈는 false가 된다.
6100
- *
6101
6192
  */
6102
6193
  followPointer?: boolean;
6194
+ /**
6195
+ * 터치 디바이스에서 손가락을 움직일 때 툴팁·crosshair를 갱신할지 지정한다.<br/>
6196
+ * true(기본)이면 1손가락 터치를 툴팁이 가져가므로 pinch zoom·pan은 두 손가락이 필요하다.<br/>
6197
+ * {@link followPointer}는 툴팁 상자 위치만 정하고, 이 옵션은 스와이프 중 어느 포인트를 따라갈지를 정한다.<br/>
6198
+ * {@link visible}이 false이면 follow하지 않는다. 비줌 plot은 세로 페이지 스크롤이 된다.<br/>
6199
+ * false이면 탭으로 툴팁을 표시·유지하고(바깥/빈 영역·같은 포인트 재탭 시 닫힘), 이동 시에는 따라가지 않는다.
6200
+ * 이미 {@link https://realchart.co.kr/config/config/body#zoomType zoom}된 상태에서는 1손가락 pan, 아니면 plot 세로 페이지 스크롤이 된다.<br/>
6201
+ * 마우스 호버에는 영향을 주지 않는다. 터치 sticky 중 합성 mouse leave/move로는 닫지 않는다.<br/>
6202
+ * {@link https://realchart.co.kr/guide/tooltip 툴팁} · {@link https://realchart.co.kr/guide/zoom 줌} 페이지를 참조한다.
6203
+ *
6204
+ * @default true
6205
+ */
6206
+ followTouch?: boolean;
6103
6207
  /**
6104
6208
  * 툴팁 텍스트 속 숫자 값이 NaN일 때 대신 표시되는 텍스트.<br/>
6105
6209
  *
@@ -6168,7 +6272,7 @@ interface TooltipOptions extends ChartItemOptions {
6168
6272
  /**
6169
6273
  * 리스트 모드로 표시될 때, 마커 크기.<br/>
6170
6274
  *
6171
- * @default 8
6275
+ * @default 7
6172
6276
  */
6173
6277
  listMarkerSize?: number;
6174
6278
  /**
@@ -6924,6 +7028,7 @@ interface ValueGaugeOptions extends GaugeOptions {
6924
7028
  label?: GaugeLabelOptions | boolean;
6925
7029
  }
6926
7030
  /**
7031
+ * 게이지 스케일 틱(눈금선) 표시를 제어한다.<br/>
6927
7032
  */
6928
7033
  interface GaugeScaleTickOptions extends ChartItemOptions {
6929
7034
  /**
@@ -6934,6 +7039,7 @@ interface GaugeScaleTickOptions extends ChartItemOptions {
6934
7039
  length?: number;
6935
7040
  }
6936
7041
  /**
7042
+ * 선형 게이지 라벨 위치·서식을 제어한다.<br/>
6937
7043
  */
6938
7044
  interface LinearGaugeLabelOptions extends GaugeLabelOptions {
6939
7045
  /**
@@ -6974,6 +7080,7 @@ interface LinearGaugeLabelOptions extends GaugeLabelOptions {
6974
7080
  gap?: PercentSize;
6975
7081
  }
6976
7082
  /**
7083
+ * 선형 게이지 스케일 표시를 제어한다.<br/>
6977
7084
  */
6978
7085
  interface LinearGaugeScaleOptions extends GaugeScaleOptions {
6979
7086
  }
@@ -7004,6 +7111,7 @@ interface LinearGaugeBaseOptions extends ValueGaugeOptions {
7004
7111
  scale?: LinearGaugeScaleOptions | boolean;
7005
7112
  }
7006
7113
  /**
7114
+ * 선형 게이지 그룹 자식별 라벨을 제어한다.<br/>
7007
7115
  */
7008
7116
  interface LinearGaugeChildLabelOptions extends ChartItemOptions {
7009
7117
  /**
@@ -7022,6 +7130,7 @@ interface LinearGaugeChildLabelOptions extends ChartItemOptions {
7022
7130
  gap?: number;
7023
7131
  }
7024
7132
  /**
7133
+ * 선형 게이지 그룹 라벨을 제어한다.<br/>
7025
7134
  */
7026
7135
  interface LinearGaugeGroupLabelOptions extends LinearGaugeLabelOptions {
7027
7136
  /**
@@ -7030,6 +7139,7 @@ interface LinearGaugeGroupLabelOptions extends LinearGaugeLabelOptions {
7030
7139
  gap?: number;
7031
7140
  }
7032
7141
  /**
7142
+ * 선형 게이지 그룹의 공통 배치·스케일을 지정한다.<br/>
7033
7143
  */
7034
7144
  interface LinearGaugeGroupBaseOptions<T extends LinearGaugeBaseOptions> extends GaugeGroupOptions<T> {
7035
7145
  /**
@@ -7067,6 +7177,7 @@ interface LinearGaugeGroupBaseOptions<T extends LinearGaugeBaseOptions> extends
7067
7177
  itemGap?: number;
7068
7178
  }
7069
7179
  /**
7180
+ * 불릿 게이지 성능 구간(band)의 범위·색을 지정한다.<br/>
7070
7181
  */
7071
7182
  interface BulletGaugeBandOptions extends ChartItemOptions {
7072
7183
  /**
@@ -7133,6 +7244,7 @@ interface BulletBarLabelOptions extends GaugeLabelOptions {
7133
7244
  offset?: number;
7134
7245
  }
7135
7246
  /**
7247
+ * 불릿 게이지 목표값 막대 표시를 제어한다.<br/>
7136
7248
  */
7137
7249
  interface BulletTargetBarOptions extends ChartItemOptions {
7138
7250
  /**
@@ -7158,6 +7270,7 @@ interface LinearValueBarOptions extends ChartItemOptions {
7158
7270
  styleCallback?: (args: any) => SVGStyleOrClass;
7159
7271
  }
7160
7272
  /**
7273
+ * 불릿 게이지 현재값 막대 표시를 제어한다.<br/>
7161
7274
  */
7162
7275
  interface BulletValueBarOptions extends LinearValueBarOptions {
7163
7276
  /**
@@ -7245,6 +7358,7 @@ interface BulletGaugeGroupOptions extends LinearGaugeGroupBaseOptions<BulletGaug
7245
7358
  rangeInclusive?: boolean;
7246
7359
  }
7247
7360
  /**
7361
+ * 게이지 라벨의 공통 텍스트·정렬을 제어한다.<br/>
7248
7362
  */
7249
7363
  interface GaugeLabelOptions extends ChartTextOptions {
7250
7364
  /**
@@ -7255,6 +7369,7 @@ interface GaugeLabelOptions extends ChartTextOptions {
7255
7369
  animatable?: boolean;
7256
7370
  }
7257
7371
  /**
7372
+ * 원형 게이지 라벨 위치·서식을 제어한다.<br/>
7258
7373
  */
7259
7374
  interface CircularGaugeLabelOptions extends GaugeLabelOptions {
7260
7375
  /**
@@ -7352,6 +7467,7 @@ interface CircularGaugeOptions extends ValueGaugeOptions {
7352
7467
  innerStyle?: SVGStyleOrClass;
7353
7468
  }
7354
7469
  /**
7470
+ * 여러 원형 게이지를 묶을 때 공통 레이아웃·스타일을 지정한다.<br/>
7355
7471
  */
7356
7472
  interface CircularGaugeGroupOptions extends GaugeGroupOptions<CircleGaugeOptions> {
7357
7473
  /**
@@ -7411,7 +7527,7 @@ interface CircularGaugeGroupOptions extends GaugeGroupOptions<CircleGaugeOptions
7411
7527
  /**
7412
7528
  * true면 시계 방향으로 회전한다.
7413
7529
  *
7414
- * @default false
7530
+ * @default true
7415
7531
  */
7416
7532
  clockwise?: boolean;
7417
7533
  /**
@@ -7438,6 +7554,7 @@ interface CircularGaugeGroupOptions extends GaugeGroupOptions<CircleGaugeOptions
7438
7554
  labelGap?: number;
7439
7555
  }
7440
7556
  /**
7557
+ * 게이지 범위(band) 라벨 표시를 제어한다.<br/>
7441
7558
  */
7442
7559
  interface GaugeRangeLabelOptions extends ChartItemOptions {
7443
7560
  /**
@@ -7503,6 +7620,7 @@ interface GaugeRangeBandOptions extends ChartItemOptions {
7503
7620
  tickLabel?: ChartItemOptions;
7504
7621
  }
7505
7622
  /**
7623
+ * 게이지 스케일 눈금 라벨 표시를 제어한다.<br/>
7506
7624
  */
7507
7625
  interface GaugeScaleLabelOptions extends IconedTextOptions {
7508
7626
  }
@@ -7572,6 +7690,7 @@ interface GaugeScaleOptions extends ChartItemOptions {
7572
7690
  gap?: number;
7573
7691
  }
7574
7692
  /**
7693
+ * 원형 게이지 스케일(눈금) 표시를 제어한다.<br/>
7575
7694
  */
7576
7695
  interface CircleGaugeScaleOptions extends GaugeScaleOptions {
7577
7696
  /**
@@ -7582,6 +7701,7 @@ interface CircleGaugeScaleOptions extends GaugeScaleOptions {
7582
7701
  stepPixels?: number;
7583
7702
  }
7584
7703
  /**
7704
+ * 원형 게이지 림(테두리) 공통 속성을 제공한다.<br/>
7585
7705
  */
7586
7706
  interface CircleGaugeRimBaseOptions extends ChartItemOptions {
7587
7707
  /**
@@ -7632,6 +7752,7 @@ interface CircleGaugeValueRimOptions extends CircleGaugeRimBaseOptions {
7632
7752
  stroked?: boolean;
7633
7753
  }
7634
7754
  /**
7755
+ * 원형 게이지 값 위치 마커 표시를 제어한다.<br/>
7635
7756
  */
7636
7757
  interface CircleGaugeValueMarkerOptions extends ChartItemOptions {
7637
7758
  /**
@@ -7642,6 +7763,7 @@ interface CircleGaugeValueMarkerOptions extends ChartItemOptions {
7642
7763
  visible?: boolean;
7643
7764
  }
7644
7765
  /**
7766
+ * 원형 게이지 바늘(핸드)의 모양·길이를 제어한다.<br/>
7645
7767
  */
7646
7768
  interface CircleGaugeHandOptions extends ChartItemOptions {
7647
7769
  /**
@@ -7673,6 +7795,7 @@ interface CircleGaugeHandOptions extends ChartItemOptions {
7673
7795
  offset?: PercentSize;
7674
7796
  }
7675
7797
  /**
7798
+ * 원형 게이지 중심 핀 표시를 제어한다.<br/>
7676
7799
  */
7677
7800
  interface CircleGaugePinOptions extends ChartItemOptions {
7678
7801
  /**
@@ -8042,6 +8165,7 @@ interface ChartConfiguration {
8042
8165
  * 2. axis.position 속성은 무시된다.
8043
8166
  * 3. chart, series의 inverted 속성이 무시된다.
8044
8167
  * 4. 극좌표계에 표시할 수 없는 series들은 표시되지 않는다.
8168
+ * 5. pinch zoom 및 두 손가락 pan은 적용되지 않는다.
8045
8169
  *
8046
8170
  * [주의] 차트 로딩 후 변경할 수 없다.
8047
8171
  *
@@ -8062,7 +8186,6 @@ interface ChartConfiguration {
8062
8186
  templates?: ConfigObject;
8063
8187
  /**
8064
8188
  * 차트 전체에 영향을 미치는 옵션들.<br/>
8065
- * #1651
8066
8189
  */
8067
8190
  general?: ChartGeneralOptions;
8068
8191
  /**
@@ -8170,7 +8293,7 @@ declare const extend: <O extends ChartItemOptions>(base: any, source: O) => O;
8170
8293
  * {@link Series 시리즈}, {@link rc.Axis 축}, {@link rc.Legend legend} 등, 차트 구성 요소 모델들의 기반 클래스.<br/>
8171
8294
  * {@link updateOptions}등의 공통 메소드들이 구현되어 있다.
8172
8295
  *
8173
- * {@link ROptionable} 상속(realmap과 동일 규약):
8296
+ * `ROptionable` 상속(realmap과 동일 규약):
8174
8297
  * - `_op` = **delta**(명시 설정만). defaults/자식은 포함하지 않는다.
8175
8298
  * - 효과 값 읽기: `prop()` / `num()` / `bool()`
8176
8299
  * - 자식은 `_addChild`로 `_children`에만 등록(부모 `_op` 비마운트)
@@ -8230,7 +8353,7 @@ declare class ChartItem<OP extends ChartItemOptions = ChartItemOptions> extends
8230
8353
  set visible(value: boolean);
8231
8354
  protected _isVisible(): boolean;
8232
8355
  /** 숫자 옵션 효과 값. 문자열(`'30px'`)은 parseFloat 결과를 반환한다. */
8233
- num<K extends keyof OP>(prop: K, def?: number): number;
8356
+ num<K extends keyof OP>(prop: K): number;
8234
8357
  /**
8235
8358
  * @private
8236
8359
  * 차트 내부 load 진입점. ROptionable `$_load`와 동일하되,
@@ -8319,8 +8442,6 @@ declare class ChartItem<OP extends ChartItemOptions = ChartItemOptions> extends
8319
8442
  * ROptionable `(op, src)` 시그니처. (realmap과 동일)
8320
8443
  */
8321
8444
  protected _doSetSimple(op: OP, src: any): boolean;
8322
- /** @private */
8323
- protected _doLoadProp(prop: string, value: any): boolean;
8324
8445
  /** @private style 등에서 _doApply + visible 통지 */
8325
8446
  private $_applyOptions;
8326
8447
  /** @private */
@@ -8469,7 +8590,7 @@ declare abstract class GaugeGroup<T extends ValueGauge = ValueGauge, OP extends
8469
8590
  getVisible(index: number): T;
8470
8591
  calcedMinMax(): IMinMax;
8471
8592
  protected _doApply(options: OP): void;
8472
- protected _doSaveArray(prop: string, value: any[]): any[];
8593
+ saveOptions(props?: any, recursive?: boolean, includeDefs?: boolean, force?: boolean): Partial<OP>;
8473
8594
  _prepareRender(): void;
8474
8595
  private $_loadGauges;
8475
8596
  private $_add;
@@ -9294,7 +9415,7 @@ declare class TrendlineLabel extends IconedText<TrendlineLabelOptions> {
9294
9415
  getText(): string;
9295
9416
  getDefaultIconPos(): IconPosition;
9296
9417
  protected _doApply(op: TrendlineLabelOptions): void;
9297
- prop<K extends keyof TrendlineLabelOptions>(prop: K, def?: any): TrendlineLabelOptions[K];
9418
+ prop<K extends keyof TrendlineLabelOptions>(prop: K): TrendlineLabelOptions[K];
9298
9419
  }
9299
9420
  declare class TrendlineMarker extends ChartItem<TrendlineMarkerOptions> {
9300
9421
  static defaults: TrendlineMarkerOptions;
@@ -9309,7 +9430,7 @@ interface ITrendlineOwner {
9309
9430
  /**
9310
9431
  * 시리즈 {@link https://en.wikipedia.org/wiki/Trend_line_(technical_analysis) 추세선} 모델.<br/>
9311
9432
  * 설정 {@link options} 모델은 {@link https://realchart.co.kr/docs/api/options/TrendlineOptions TrendlineOptions}이고,
9312
- * {@link https://realchart.co.kr/config/config/base/series/trendline trendline} 항목으로 설정한다.
9433
+ * {@link https://realchart.co.kr/config/config/series/line/trendline trendline} 항목으로 설정한다.
9313
9434
  * ```js
9314
9435
  * const config = {
9315
9436
  * series: {
@@ -10210,7 +10331,7 @@ declare abstract class SeriesGroup<T extends Series = Series, OP extends SeriesG
10210
10331
  protected _doInit(op: OP): void;
10211
10332
  protected _doLoad(op: OP, source: any): void;
10212
10333
  updateOptions(source?: OP, render?: boolean): this;
10213
- protected _doSaveArray(prop: string, value: any[]): any[];
10334
+ saveOptions(props?: any, recursive?: boolean, includeDefs?: boolean, force?: boolean): Partial<OP>;
10214
10335
  _prepareRender(): void;
10215
10336
  _connect(chart: IChart): void;
10216
10337
  protected _doPrepareRender(chart: IChart): void;
@@ -10312,7 +10433,7 @@ declare class BodyDepth extends ChartItem<BodyDepthOptions> {
10312
10433
  protected _isVisible(): boolean;
10313
10434
  protected _doSetSimple(op: any, src: any): boolean;
10314
10435
  protected _doApply(op: BodyDepthOptions): void;
10315
- prop<K extends keyof BodyDepthOptions>(prop: K, def?: any): BodyDepthOptions[K];
10436
+ prop<K extends keyof BodyDepthOptions>(prop: K): BodyDepthOptions[K];
10316
10437
  }
10317
10438
  /**
10318
10439
  * @private
@@ -10421,11 +10542,11 @@ declare class NavigatorMask extends ChartItem<NavigiatorMaskOptions> {
10421
10542
  * y축은 항상 **'linear'**로 생성된다.
10422
10543
  */
10423
10544
  declare class SeriesNavigator extends ChartItem<SeriesNavigatorOptions> {
10424
- /** 핸들 원의 반지름 (px). {@link HANDLE_TRACK_HEIGHT} 기준으로 적정 크기로 고정. */
10545
+ /** 핸들 원의 반지름 (px). `HANDLE_TRACK_HEIGHT` 기준으로 적정 크기로 고정. */
10425
10546
  static readonly HANDLE_RADIUS = 9.75;
10426
10547
  /** 스크롤 track 높이 (px). */
10427
10548
  static readonly HANDLE_TRACK_HEIGHT = 6;
10428
- /** thickness 하단에서 track 중심까지의 거리 (px). {@link HANDLE_TRACK_HEIGHT} / 2 */
10549
+ /** thickness 하단에서 track 중심까지의 거리 (px). `HANDLE_TRACK_HEIGHT` / 2 */
10429
10550
  static readonly HANDLE_TRACK_OFFSET: number;
10430
10551
  static defaults: SeriesNavigatorOptions;
10431
10552
  private _handle;
@@ -10530,7 +10651,7 @@ declare class Title<OP extends TitleOptions = TitleOptions> extends ChartItem<OP
10530
10651
  * const title = chart.title;
10531
10652
  * legend.text = 'Sub-Title';
10532
10653
  * ```
10533
- * {@link https://realchart.co.kr/guide/subtitle 부제목 개요} 페이지를 참조한다.
10654
+ * {@link https://realchart.co.kr/config/config/subtitle 부제목 개요} 페이지를 참조한다.
10534
10655
  */
10535
10656
  declare class Subtitle extends Title<SubtitleOptions> {
10536
10657
  static defaults: SubtitleOptions;
@@ -10939,7 +11060,7 @@ interface IAxis {
10939
11060
  isAnimating(): boolean;
10940
11061
  }
10941
11062
  /**
10942
- * 축 {@link AxisTitle 타이틀}, {@link AxisLink line}, {@link AxisTick tick} 등,
11063
+ * 축 {@link AxisTitle 타이틀}, {@link AxisLine line}, {@link AxisTick tick} 등,
10943
11064
  * {@link Axis 축} 구성 요소 모델들의 기반(base) 클래스.<br/>
10944
11065
  */
10945
11066
  declare abstract class AxisItem<OP extends AxisItemOptions> extends ChartItem<OP> {
@@ -11107,7 +11228,6 @@ declare class AxisRangeGuide extends AxisGuide<AxisRangeGuideOptions> {
11107
11228
  * ```
11108
11229
  */
11109
11230
  declare abstract class AxisTick<OP extends AxisTickOptions = AxisTickOptions> extends AxisItem<OP> {
11110
- private static readonly DEF_LENGTH;
11111
11231
  static defaults: AxisTickOptions;
11112
11232
  private _length;
11113
11233
  private _gap;
@@ -11137,7 +11257,7 @@ declare class AxisMinorTick extends AxisItem<AxisMinorTickOptions> {
11137
11257
  /**
11138
11258
  * major grid 사이 보조 격자선(minor grid line) 모델.<br/>
11139
11259
  * {@link options 옵션} 모델은 {@link https://realchart.co.kr/docs/api/options/AxisMinorGridOptions AxisMinorGridOptions}이고,
11140
- * {@link https://realchart.co.kr/config/config/base/axis/grid#minorGrid grid.minorGrid} 항목으로 설정한다.
11260
+ * {@link https://realchart.co.kr/config/config/xAxis/linear/grid#minorGrid grid.minorGrid} 항목으로 설정한다.
11141
11261
  */
11142
11262
  declare class AxisMinorGrid extends AxisItem<AxisMinorGridOptions> {
11143
11263
  static defaults: AxisMinorGridOptions;
@@ -11602,6 +11722,8 @@ interface AxisTitleOptions extends AxisItemOptions {
11602
11722
  * 텍스트 문자 방향을 지정한다.
11603
11723
  * {@link writingMode 세로 모드}의 텍스트에만 적용된다.
11604
11724
  * 특히, 영문을 한글처럼 세워서 표시하려 할 때 'upright'로 설정한다.
11725
+ *
11726
+ * @default 'upright'
11605
11727
  */
11606
11728
  textOrientation?: TextOrientation;
11607
11729
  }
@@ -11705,7 +11827,7 @@ interface AxisTickOptions extends AxisItemOptions {
11705
11827
  * 'inside'이면 축선 안쪽(플롯 방향), 'default'이면 바깥쪽으로 tick이 그려진다.<br/>
11706
11828
  * {@link https://realchart.co.kr/config/config/base/axis/label#location label.location}과 독립적으로 동작한다.
11707
11829
  * label이 'inside'여도 tick.location이 'inside'가 아니면 tick은 바깥쪽에 표시된다.<br/>
11708
- * category 축은 {@link https://realchart.co.kr/config/config/base/axis/tick#position position}이 point/edge용이므로 inside/default는 이 속성으로 지정한다.
11830
+ * category 축은 {@link https://realchart.co.kr/config/config/xAxis/category/tick#position position}이 point/edge용이므로 inside/default는 이 속성으로 지정한다.
11709
11831
  *
11710
11832
  * @default 'default'
11711
11833
  */
@@ -11718,6 +11840,8 @@ interface AxisTickOptions extends AxisItemOptions {
11718
11840
  * axis tick line length.<br/>
11719
11841
  * 지정하지 않거나 잘못 지정하면 7 픽셀로 적용된다.<br/>
11720
11842
  * 또, {@link visible}이 false이어도 이 설정만큼 공간을 차지한다.
11843
+ *
11844
+ * @default 7
11721
11845
  */
11722
11846
  length?: number;
11723
11847
  /**
@@ -11776,7 +11900,7 @@ interface AxisMinorGridOptions extends AxisItemOptions {
11776
11900
  * time 축은 major tick 타임스탬프 사이를 선형 보간하여 minor 위치를 계산한다
11777
11901
  * (달력 단위가 아닌 픽셀 균등 배치).<br/>
11778
11902
  * log 축은 major tick 값이 0보다 클 때 log 공간에서 보간한다.<br/>
11779
- * {@link count}는 {@link https://realchart.co.kr/config/config/base/axis/grid#minorGrid minor grid} 위치 계산에도 사용된다
11903
+ * {@link count}는 {@link https://realchart.co.kr/config/config/xAxis/linear/grid#minorGrid minor grid} 위치 계산에도 사용된다
11780
11904
  * (visible이 false여도 grid만 표시할 수 있다).<br/>
11781
11905
  * major tick이 2개 미만이면 minor tick·grid가 생성되지 않는다.<br/>
11782
11906
  * axis break 경계 tick이 있는 major 구간에는 minor tick이 생성되지 않는다.<br/>
@@ -11792,7 +11916,7 @@ interface AxisMinorTickOptions extends AxisItemOptions {
11792
11916
  /**
11793
11917
  * major tick 한 구간 사이에 표시할 minor tick 개수.<br/>
11794
11918
  * 1 미만이거나 소수인 값은 내림하여 1 이상의 정수로 적용된다.<br/>
11795
- * {@link https://realchart.co.kr/config/config/base/axis/grid#minorGrid minor grid} 위치에도 동일하게 적용된다.
11919
+ * {@link https://realchart.co.kr/config/config/xAxis/linear/grid#minorGrid minor grid} 위치에도 동일하게 적용된다.
11796
11920
  *
11797
11921
  * @default 4
11798
11922
  */
@@ -11912,7 +12036,7 @@ interface ContinuousAxisTickOptions extends AxisTickOptions {
11912
12036
  /**
11913
12037
  * tick 개수를 맞춰야 하는 대상 axis.<br/>
11914
12038
  * base의 strictMin, strictMax가 설정되지 않아야 한다.
11915
- * base의 startFit, endFit의 {@link https://realchart.co.kr/config/config/base/axis/startFit tick}으로 설정되어야 한다.
12039
+ * base의 startFit, endFit의 {@link https://realchart.co.kr/config/config/xAxis/linear#startFit tick}으로 설정되어야 한다.
11916
12040
  *
11917
12041
  */
11918
12042
  baseAxis?: number | string;
@@ -11925,6 +12049,7 @@ interface ContinuousAxisTickOptions extends AxisTickOptions {
11925
12049
  baseRange?: boolean;
11926
12050
  }
11927
12051
  /**
12052
+ * 연속형 축(linear/log/time) 그리드 선 표시를 제어한다.<br/>
11928
12053
  */
11929
12054
  interface ContinuousAxisGridOptions extends AxisGridOptions {
11930
12055
  /**
@@ -11975,7 +12100,10 @@ declare const _AxisLabelArrange: {
11975
12100
  */
11976
12101
  readonly ROWS: "rows";
11977
12102
  };
11978
- /** @dummy */
12103
+ /**
12104
+ * 축 라벨 자동 배치 방식.<br/>
12105
+ * @dummy
12106
+ */
11979
12107
  type AxisLabelArrange = typeof _AxisLabelArrange[keyof typeof _AxisLabelArrange];
11980
12108
  /**
11981
12109
  * label 배치 후 텍스트가 차지하는 공간을 넘치는 경우 처리 방식.
@@ -12095,7 +12223,7 @@ interface AxisLabelOptions extends IconedTextOptions {
12095
12223
  */
12096
12224
  rows?: number;
12097
12225
  /**
12098
- * {@link autoArrange} {@link AxisLabelArrange.ROWS ROWS}로 자동 정렬되는 경우 최대 행 수.<br/>
12226
+ * {@link autoArrange}가 `'rows'`로 자동 정렬되는 경우 최대 행 수.<br/>
12099
12227
  * 이 행 수 이상이 필요한 경우 label 간격을 두어 표시한다.
12100
12228
  *
12101
12229
  * @default 3
@@ -12105,7 +12233,7 @@ interface AxisLabelOptions extends IconedTextOptions {
12105
12233
  * {@link chart.polar polar}가 아닌 수평 축일 때, tick label 표시 회전 각도.<br/>
12106
12234
  * -90 ~ 90 사이의 각도로 지정할 수 있다.<br/>
12107
12235
  * **'auto'**이면 polar일때는 label위치에 따라 각도가 자동으로 계산되고,
12108
- * polar가 아닐때는 {@link AxisLabelArrange}속성에 따라 결정된다.
12236
+ * polar가 아닐때는 {@link autoArrange} 속성에 따라 결정된다.
12109
12237
  */
12110
12238
  rotation?: number | 'auto';
12111
12239
  /**
@@ -12588,14 +12716,14 @@ interface AxisScrollBarOptions extends AxisItemOptions {
12588
12716
  minThumbSize?: number;
12589
12717
  /**
12590
12718
  * 스크롤바와 차트 본체 방향 사이의 간격.<br/>
12591
- * 0 이상의 값이어야 한다. // #529
12719
+ * 0 이상의 값이어야 한다.
12592
12720
  *
12593
12721
  * @default 3 픽셀
12594
12722
  */
12595
12723
  gap?: number;
12596
12724
  /**
12597
12725
  * 스크롤바와 차트 본체 반대 방향 사이의 간격.<br/>
12598
- * 0 이상의 값이어야 한다. // #529
12726
+ * 0 이상의 값이어야 한다.
12599
12727
  *
12600
12728
  * @default 3 픽셀
12601
12729
  */
@@ -12769,7 +12897,7 @@ interface AxisOptions extends ChartItemOptions {
12769
12897
  tooltipHeader?: string;
12770
12898
  /**
12771
12899
  * 축에 포함된 각 시리즈별 표시되는 포인트 툴팁 텍스트 템플릿.<br/>
12772
- * '${detail}'은 시리즈의 {@link https://realchart.co.kr/config/config/base/series#tooltipDetail tooltipDetail} 속성값으로 대체된다. // #1386
12900
+ * '${detail}'은 시리즈의 {@link https://realchart.co.kr/config/config/base/series#tooltipDetail tooltipDetail} 속성값으로 대체된다.
12773
12901
  *
12774
12902
  * @default '${series}: ${detail}'
12775
12903
  */
@@ -12778,7 +12906,7 @@ interface AxisOptions extends ChartItemOptions {
12778
12906
  * 축에 포함된 시리즈가 둘 이상일 때,
12779
12907
  * 각 시리즈별 표시되는 포인트 툴팁 텍스트 템플릿.<br/>
12780
12908
  * 이 속성을 빈 값으로 지정하면 {@link tooltipRow} 속성을 이용해서 표시된다.<br/>
12781
- * '${detail}'은 시리즈의 {@link https://realchart.co.kr/config/config/base/series#tooltipDetail tooltipDetail} 속성값으로 대체된다. // #1386
12909
+ * '${detail}'은 시리즈의 {@link https://realchart.co.kr/config/config/base/series#tooltipDetail tooltipDetail} 속성값으로 대체된다.
12782
12910
  *
12783
12911
  * @default `['${series}', '${detail}']`
12784
12912
  */
@@ -13218,7 +13346,7 @@ interface AxisBreakOptions extends AxisItemOptions {
13218
13346
  */
13219
13347
  declare const _AxisFit: {
13220
13348
  /**
13221
- * x축이면 {@link VALUE}, y축이면 {@link TICK}.
13349
+ * x축이면 `'value'`, y축이면 `'tick'`.
13222
13350
  */
13223
13351
  readonly DEFAULT: "default";
13224
13352
  /**
@@ -13301,7 +13429,7 @@ interface ContinuousAxisOptions extends AxisOptions {
13301
13429
  * 첫번째 tick 앞쪽에 추가되는 최소 여백을 전체 값 범위에 대한 비율로 지정한다.<br/>
13302
13430
  * 또는 'px'로 끝나는 문자열인 경우, 해당 픽셀 정도의 여백이 생길 수 있도록 조정된다.<br/>
13303
13431
  * 이 값을 지정하지 않으면 {@link padding}에 지정된 값을 따른다.
13304
- * {@link startFit}이 {@link AxitFit.TICK TICK}일 때,
13432
+ * {@link startFit}이 `'tick'`일 때,
13305
13433
  * data point의 최소값과 첫번째 tick 사이에 이미 그 이상의 간격이 존재한다면 이 속성은 무시된다.
13306
13434
  * {@link strictMin}가 지정되거나, {@link minValue}가 계산된 최소값보다 작은 경우에도 이 속성은 무시된다.<br/>
13307
13435
  * 속성값을 지정하는 방식은 {@link padding}을 참조한다.
@@ -13318,7 +13446,6 @@ interface ContinuousAxisOptions extends AxisOptions {
13318
13446
  */
13319
13447
  maxPadding?: number | [number, number][] | string;
13320
13448
  /**
13321
- * #1375
13322
13449
  * x축일 때, 양 끝 데이터포인트에 추가하는 여백을 데이터포인트 하나가 차지하는 평균 폭에 대한 비율로 지정한다.<br/>
13323
13450
  * 기본값 0.5이면 계산된 크기대로 적용되고, 0이면 여백이 추가되지 않는다.<br/>
13324
13451
  * polar 축일 때는 {@link polarMargin}이 설정데 따라 축 끝(max) 쪽에만 적용된다.<br/>
@@ -13428,7 +13555,7 @@ interface LogAxisTickOptions extends ContinuousAxisTickOptions {
13428
13555
  /**
13429
13556
  * @append
13430
13557
  *
13431
- * 로그를 적용한 값으로 설정한다. // #141
13558
+ * 로그를 적용한 값으로 설정한다.
13432
13559
  */
13433
13560
  stepInterval?: number;
13434
13561
  /**
@@ -13470,6 +13597,15 @@ interface LogAxisOptions extends ContinuousAxisOptions {
13470
13597
  */
13471
13598
  logBase?: number;
13472
13599
  /**
13600
+ * 로그 눈금 간격이 이 값보다 크면 10의 배수로 반올림한다.<br/>
13601
+ *
13602
+ * @default 500
13603
+ */
13604
+ roundThreshold?: number;
13605
+ /**
13606
+ * {@link roundThreshold}의 이전 철자. 호환을 위해 유지한다.<br/>
13607
+ *
13608
+ * @deprecated {@link roundThreshold}를 사용한다.
13473
13609
  * @default 500
13474
13610
  */
13475
13611
  roundThrrehold?: number;
@@ -13497,7 +13633,7 @@ interface TimeAxisLabelOptions extends ContinuousAxisLabelOptions {
13497
13633
  /**
13498
13634
  * 현재 스케일의 시작일시에 상위 스케일의 포맷을 사용해서 표시한다.
13499
13635
  *
13500
- * @default false
13636
+ * @default true
13501
13637
  */
13502
13638
  useBeginningFormat?: boolean;
13503
13639
  /**
@@ -13529,7 +13665,7 @@ interface TimeAxisTickOptions extends ContinuousAxisTickOptions {
13529
13665
  enableDecimals?: never;
13530
13666
  /**
13531
13667
  * @append
13532
- * 단위가 지정된 문자열로 지정하는 경우 값이 -1 이하이거나 1 이상이어야 한다. // #141
13668
+ * 단위가 지정된 문자열로 지정하는 경우 값이 -1 이하이거나 1 이상이어야 한다.
13533
13669
  */
13534
13670
  stepInterval?: number;
13535
13671
  /**
@@ -13568,6 +13704,7 @@ interface TimeAxisOptions extends ContinuousAxisOptions {
13568
13704
  type AxisOptionsType = CategoryAxisOptions | LinearAxisOptions | LogAxisOptions | TimeAxisOptions;
13569
13705
 
13570
13706
  /**
13707
+ * 임의 키를 허용하는 설정 객체이다. 확장 필드를 받을 때 사용한다.<br/>
13571
13708
  */
13572
13709
  interface ConfigObject {
13573
13710
  /**
@@ -13575,6 +13712,7 @@ interface ConfigObject {
13575
13712
  [key: string]: any;
13576
13713
  }
13577
13714
  /**
13715
+ * 모든 차트 아이템(시리즈·축·범례 등)이 공유하는 공통 옵션이다.<br/>
13578
13716
  */
13579
13717
  interface ChartItemOptions extends ROptions {
13580
13718
  /**
@@ -13589,6 +13727,7 @@ interface ChartItemOptions extends ROptions {
13589
13727
  style?: SVGStyleOrClass;
13590
13728
  }
13591
13729
  /**
13730
+ * 텍스트를 그리는 차트 아이템의 글꼴·정렬·효과를 지정한다.<br/>
13592
13731
  */
13593
13732
  interface ChartTextOptions extends ChartItemOptions {
13594
13733
  /**
@@ -13681,6 +13820,7 @@ declare const _IconPosition: {
13681
13820
  /** @dummy */
13682
13821
  type IconPosition = typeof _IconPosition[keyof typeof _IconPosition];
13683
13822
  /**
13823
+ * 아이콘과 텍스트를 함께 표시할 때 아이콘 위치·간격을 제어한다.<br/>
13684
13824
  */
13685
13825
  interface IconedTextOptions extends ChartTextOptions {
13686
13826
  /**
@@ -14215,6 +14355,8 @@ interface TextAnnotationOptions extends AnnotationOptions {
14215
14355
  * 텍스트 문자 방향을 지정한다.
14216
14356
  * {@link writingMode 세로 모드}의 텍스트에만 적용된다.
14217
14357
  * 특히, 영문을 한글처럼 세워서 표시하려 할 때 'upright'로 설정한다.
14358
+ *
14359
+ * @default 'upright'
14218
14360
  */
14219
14361
  textOrientation?: TextOrientation;
14220
14362
  }
@@ -14408,6 +14550,11 @@ declare class Chart {
14408
14550
  */
14409
14551
  get polar(): boolean;
14410
14552
  /**
14553
+ * 차트에 등록된 asset 컬렉션.<br/>
14554
+ * gradient, pattern, 이미지 등을 id로 조회한다.<br/>
14555
+ * asset은 {@link https://realchart.co.kr/docs/api/options/ChartConfiguration#asset asset}으로 설정한다.
14556
+ *
14557
+ * @readonly
14411
14558
  */
14412
14559
  get assets(): AssetCollection;
14413
14560
  /**
@@ -14815,6 +14962,25 @@ declare class Globals {
14815
14962
  static createData(options?: ChartDataOptions, rows?: any[]): ChartData;
14816
14963
  }
14817
14964
 
14965
+ /**
14966
+ * 모바일/터치 이벤트 명세
14967
+ *
14968
+ * | 제스처 | followTouch=true (default) | followTouch=false |
14969
+ * |---|---|---|
14970
+ * | tap (body) | tooltip·crosshair sticky | 동일 |
14971
+ * | 1손가락 move (body) | tooltip·crosshair 추적 (페이지 스크롤 차단) | sticky 해제, zoom 시 1손가락 pan (스크롤 차단) / 아니면 세로 페이지 스크롤 |
14972
+ * | 2손가락 pinch/pan (중점이 body) | zoomType 축 zoom + pan (polar 제외) | 동일 |
14973
+ * | body 밖 (title/legend) | 세로 페이지 스크롤 허용 (`touch-action: pan-y`) | 동일 |
14974
+ * | 바깥/빈 영역 tap·같은 포인트 재탭 | tooltip 닫기 | 동일 |
14975
+ * | navigator / axis scroll thumb | 기존 1손가락 드래그 | 동일 |
14976
+ * | body drag-rect zoom | 터치에서 비활성 (마우스만) | 동일 |
14977
+ *
14978
+ * tooltip.visible이 false이면 followTouch가 true여도 1손가락 follow를 하지 않는다
14979
+ * (비줌이면 세로 스크롤, 줌이면 1손가락 pan. pinch는 zoomType을 따른다).
14980
+ * leave(touch)로는 tooltip을 닫지 않는다.
14981
+ * 터치 sticky 중 합성 mouse leave/move로는 닫지 않는다.
14982
+ */
14983
+
14818
14984
  declare class ChartPointerHandler implements IPointerHandler {
14819
14985
  private _chart;
14820
14986
  private _clickElement;
@@ -14823,19 +14989,82 @@ declare class ChartPointerHandler implements IPointerHandler {
14823
14989
  private _clickY;
14824
14990
  private _prevX;
14825
14991
  private _prevY;
14992
+ private _isTouchPointer;
14993
+ /** leave로 닫지 않는 터치 sticky */
14994
+ private _touchSticky;
14995
+ private _touchMoved;
14996
+ /** TAP_SLOP을 넘김. follow 갱신·touchmove preventDefault */
14997
+ private _touchPastSlop;
14998
+ /** 합성 mouse hover 무시. touch 세션 종료 또는 mouse down에서 해제 */
14999
+ private _suppressMouseHover;
15000
+ private _tapPrevFocus;
15001
+ private _docDismissBound;
15002
+ private _touchInBody;
15003
+ private _touchPointers;
15004
+ private _pinchActive;
15005
+ private _pinchLastDist;
15006
+ private _pinchLastMidX;
15007
+ private _pinchLastMidY;
15008
+ private _pinchBody;
14826
15009
  constructor(chart: ChartControl);
14827
15010
  handleDown(ev: PointerEvent): void;
14828
15011
  handleUp(ev: PointerEvent): void;
14829
15012
  handleMove(ev: PointerEvent): void;
14830
15013
  handleLeave(ev: PointerEvent): void;
15014
+ handleCancel(ev: PointerEvent): void;
14831
15015
  handleClick(ev: PointerEvent): void;
14832
15016
  handleDblClick(ev: PointerEvent): void;
14833
15017
  handleWheel(ev: WheelEvent): void;
15018
+ dispose(): void;
14834
15019
  get dragTracker(): DragTracker;
14835
15020
  setDragTracker(value: DragTracker): void;
14836
15021
  isDragging(): boolean;
15022
+ shouldPreventTouchMove(ev?: TouchEvent): boolean;
14837
15023
  protected _stopEvent(ev: Event): void;
15024
+ private $_isTouch;
15025
+ private $_clearTouchSessionFlags;
15026
+ private $_followTouch;
15027
+ private $_showAtPointer;
15028
+ /**
15029
+ * 터치는 setPointerCapture를 안 해도 브라우저가 암묵 캡처를 건다.
15030
+ * `ev.target`이 처음 누른 포인트로 고정되므로, 손가락 아래 요소는 좌표로 다시 찾는다.
15031
+ */
15032
+ private $_hitTarget;
15033
+ private $_isTooltipDom;
15034
+ /**
15035
+ * `handleClick`이 클릭을 전달할 대상이 elt에 있는지 여부.
15036
+ *
15037
+ * clickable()이 false면 아래 클릭 블록 자체가 실행되지 않아 전달할 대상이 없다.
15038
+ * 이때 true를 반환하면 dismiss도 클릭 처리도 하지 않게 되므로 false로 둔다.
15039
+ *
15040
+ * series는 제외한다. series 탭은 focus point 비교로 판정하며,
15041
+ * 같은 포인트 재탭은 dismiss가 정상 동작이다.
15042
+ */
15043
+ private $_hasClickTarget;
15044
+ private $_beginTouchSticky;
15045
+ private $_endTouchSticky;
15046
+ private $_bindDocDismiss;
15047
+ private $_unbindDocDismiss;
15048
+ private $_docPointerDown;
15049
+ private $_isBodyZoomTarget;
15050
+ private $_canPinch;
15051
+ private $_canOneFingerPan;
15052
+ /**
15053
+ * follow는 capture하면 pointermove target이 root로 고정되어 bar/pie 히트가 실패한다.
15054
+ * 스크롤 차단은 touch-action으로 하고, capture는 pan/navigator 등 좌표 드래그만 한다.
15055
+ */
15056
+ private $_plotTouchLock;
15057
+ private $_lockTouchGesture;
15058
+ private $_isTouchCaptureTarget;
15059
+ private $_isInBody;
15060
+ private $_bodyAt;
15061
+ private $_clientToPoint;
14838
15062
  private $_pointerToPoint;
15063
+ private $_markTouchPastSlopFromTouch;
15064
+ private $_pinchPoints;
15065
+ private $_beginPinch;
15066
+ private $_updatePinch;
15067
+ private $_endPinch;
14839
15068
  protected _getDragTracker(elt: Element, dx: number, dy: number): any;
14840
15069
  private $_doDrag;
14841
15070
  private $_startMove;
@@ -15071,7 +15300,7 @@ declare class AxisBreak extends AxisItem<AxisBreakOptions> {
15071
15300
  _sect: IAxisBreakSect;
15072
15301
  getSize(domain: number): number;
15073
15302
  protected _doApply(options: ChartItemOptions): void;
15074
- prop<K extends keyof AxisBreakOptions>(prop: K, def?: any): AxisBreakOptions[K];
15303
+ prop<K extends keyof AxisBreakOptions>(prop: K): AxisBreakOptions[K];
15075
15304
  }
15076
15305
  interface IAxisBreakSect {
15077
15306
  from: number;
@@ -15082,7 +15311,7 @@ interface IAxisBreakSect {
15082
15311
  /**
15083
15312
  * 연속 축의 {@link https://realchart.co.kr/config/config/yAxis/linear#baseValue baseValue} 위치에 표시되는 선(line) 모델.<br/>
15084
15313
  * {@link options 옵션} 모델은 {@link https://realchart.co.kr/docs/api/options/AxisBaseLineOptions AxisBaseLineOptions}이다.<br/>
15085
- * 축의 최소값이 {@link https://realchart.co.kr/config/config/axis/linear#baseValue baseValue}보다 작을 때만 표시된다.
15314
+ * 축의 최소값이 {@link https://realchart.co.kr/config/config/yAxis/linear#baseValue baseValue}보다 작을 때만 표시된다.
15086
15315
  * 기본적으로 표시되지 않는다.
15087
15316
  */
15088
15317
  declare class AxisBaseLine extends AxisLine {
@@ -15827,12 +16056,19 @@ declare class BodyView extends ChartElement<Body> implements IAnnotationAnchorOw
15827
16056
  prepareRender(doc: Document, model: Body, polar: boolean): void;
15828
16057
  prepareGuideContainers(): void;
15829
16058
  checkDepth(chart: IChart, width: number, height: number): IBodyDepthExtents;
15830
- pointerMoved(p: Point, target: EventTarget): boolean;
16059
+ pointerMoved(p: Point, target: EventTarget, persistFocus?: boolean): boolean;
15831
16060
  hoverSeries(series: Series): void;
16061
+ /** persistFocus 시 마지막 포인트에 crosshair를 고정한다 (손가락 좌표와 tooltip이 어긋나지 않게). */
16062
+ private $_layoutPersistedCrosshair;
15832
16063
  private $_setFocused;
15833
16064
  private $_focusSeries;
15834
16065
  private $_hoverSeries;
15835
16066
  hoverPoint(pt: DataPoint): void;
16067
+ /**
16068
+ * 포인트 hover/focus 시각 효과만 해제한다.<br/>
16069
+ * 툴팁 hide 콜백에서 호출되므로 hideTooltip은 하지 않는다.
16070
+ */
16071
+ clearPointFocus(): void;
15836
16072
  clearHover(): void;
15837
16073
  seriesByDom(elt: Element): SeriesView;
15838
16074
  annotationByDom(elt: Element): AnnotationView;
@@ -15852,6 +16088,20 @@ declare class BodyView extends ChartElement<Body> implements IAnnotationAnchorOw
15852
16088
  buttonClicked(button: ButtonElement): void;
15853
16089
  addFeedback(view: RcElement): void;
15854
16090
  setZoom(x1: number, y1: number, x2: number, y2: number): void;
16091
+ /** split에서 chart-global `Body.isZoomed()` 대신 이 pane 연결 축을 본다. */
16092
+ isAxisZoomed(): boolean;
16093
+ /**
16094
+ * 좌표는 chart(SVG) 공간이며 ZoomTracker와 같이 body local로 변환한다.<br/>
16095
+ * split에서는 이 pane에 연결된 축만 대상으로 한다.<br/>
16096
+ * @param scale 이전 거리 대비 비율 (&gt;1 손가락 벌림 = zoom in)
16097
+ */
16098
+ pinchZoom(cx: number, cy: number, scale: number, panDx: number, panDy: number): boolean;
16099
+ /** split에서는 이 pane에 연결된 zoom 축만 pan한다. */
16100
+ panBy(dx: number, dy: number): boolean;
16101
+ /** 연결된 축이 있으면 그것만, 없으면 chart first 축. */
16102
+ private $_zoomAxes;
16103
+ private $_pinchAxis;
16104
+ private $_panAxis;
15855
16105
  getTooltipPos(): Point;
15856
16106
  getFocusPointView(): IPointView;
15857
16107
  getSeries(series: ISeries): SeriesView;
@@ -16167,6 +16417,7 @@ declare class ChartView extends LayerElement implements IAnnotationAnchorOwner {
16167
16417
  * 드래깅 등 사용자 인터랙션 중 툴팁을 지연 없이 숨길 때 사용한다.
16168
16418
  */
16169
16419
  forceHideTooltip(): void;
16420
+ private $_clearPointFocus;
16170
16421
  getSeriesView(series: ISeries): SeriesView;
16171
16422
  createAxisView(doc: Document): AxisView;
16172
16423
  legendByDom(dom: Element): LegendItem;
@@ -16176,7 +16427,16 @@ declare class ChartView extends LayerElement implements IAnnotationAnchorOwner {
16176
16427
  findSeriesView(series: Series): SeriesView;
16177
16428
  creditByDom(dom: Element): CreditView;
16178
16429
  bodyOf(elt: Element): BodyView;
16179
- pointerMoved(x: number, y: number, target: EventTarget): void;
16430
+ /** split이면 pane bodies, 아니면 단일 body */
16431
+ plotBodies(): BodyView[];
16432
+ /** SVG 좌표로 plot hit. split에서 숨겨진 bodyView() fallback 대신 쓴다. */
16433
+ bodyAtPoint(x: number, y: number): BodyView;
16434
+ /** DOM 또는 좌표로 body 해석. split에서 bodyOf 실패 시 좌표 hit. */
16435
+ resolveBody(elt: Element, x?: number, y?: number): BodyView;
16436
+ getFocusPointView(): IPointView;
16437
+ private $_pointInBody;
16438
+ private $_bodyAtContainerPoint;
16439
+ pointerMoved(x: number, y: number, target: EventTarget, persistFocus?: boolean): void;
16180
16440
  pointerLeaved(x: number, y: number, target: EventTarget): void;
16181
16441
  /**
16182
16442
  * body crosshair 선과 축 flag를 모두 숨긴다.<br/>
@@ -16437,9 +16697,11 @@ declare class LineSeriesArrow extends SeriesMarker<LineSeriesArrowOptions> {
16437
16697
  at: 'start' | 'end';
16438
16698
  }[];
16439
16699
  calcAutoAngle(pts: LineSeriesPoint[], index: number, at: 'start' | 'end'): number;
16440
- calcSegmentAngle(p0: IPointPos, p1: IPointPos, lineType: LineType, stepDir: LineStepDirection, at: 'start' | 'end'): number;
16700
+ calcSegmentAngle(p0: IPointPos, p1: IPointPos, lineType: LineType, stepDir: LineStepDirection, at: 'start' | 'end', inverted?: boolean): number;
16441
16701
  calcArrowAngle(pts: LineSeriesPoint[], index: number, at: 'start' | 'end'): number;
16442
16702
  protected _doPrepareRender(chart: IChart): void;
16703
+ private $_stepsAlongCategory;
16704
+ private $_displayPos;
16443
16705
  private $_buildRunStyle;
16444
16706
  private $_applyStyleIsolation;
16445
16707
  private $_neighborIndex;
@@ -16660,7 +16922,7 @@ declare class BarSeries<OP extends BarSeriesOptions = BarSeriesOptions> extends
16660
16922
  get canPolar(): boolean;
16661
16923
  }
16662
16924
  /**
16663
- * {@link BarSeries}, {@link CircleBarSeires}의 그룹 기반 모델.<br/>
16925
+ * {@link BarSeries}, {@link CircleBarSeries}의 그룹 기반 모델.<br/>
16664
16926
  * {@link options 설정} 모델은 {@link https://realchart.co.kr/docs/api/options/BarSeriesGroupBaseOptions BarSeriesGroupBaseOptions}이다.
16665
16927
  */
16666
16928
  declare abstract class BarSeriesGroupBase<T extends BarSeriesBase, OP extends BarSeriesGroupBaseOptions<BarSeriesBaseOptions>> extends ClusterableSeriesGroup<T, OP> implements IClusterable {
@@ -17127,7 +17389,7 @@ declare class EqualizerSeries extends BasedSeries<EqualizerSeriesOptions> {
17127
17389
  /**
17128
17390
  * ErrorBar 시리즈.<br/>
17129
17391
  * {@link https://realchart.co.kr/docs/api/options/SeriesOptions#type type}은 {@link https://realchart.co.kr/config/config/series/errorbar errorbar}이고,
17130
- * {@link options 설정} 모델은 {@link https://realchart.co.kr/docs/api/options/ErrorbarSeriesOptions ErrorbarSeriesOptions}이다.
17392
+ * {@link options 설정} 모델은 {@link https://realchart.co.kr/docs/api/options/ErrorBarSeriesOptions ErrorBarSeriesOptions}이다.
17131
17393
  */
17132
17394
  declare class ErrorBarSeries extends LowRangedSeries<ErrorBarSeriesOptions> {
17133
17395
  static readonly type = "errorbar";
@@ -17305,7 +17567,7 @@ declare class PieSeriesDepth extends ChartItem<PieSeriesDepthOptions> {
17305
17567
  private _runLength;
17306
17568
  private _runRatio;
17307
17569
  getLength(): number;
17308
- prop<K extends keyof PieSeriesDepthOptions>(prop: K, def?: any): PieSeriesDepthOptions[K];
17570
+ prop<K extends keyof PieSeriesDepthOptions>(prop: K): PieSeriesDepthOptions[K];
17309
17571
  protected _isVisible(): boolean;
17310
17572
  protected _doSetSimple(op: any, src: any): boolean;
17311
17573
  protected _doApply(op: PieSeriesDepthOptions): void;