realmap 1.0.13 → 1.1.0

package/index.d.ts

@@ -1,5 +1,7 @@
+declare const PI: number;
 declare const PI_2: number;
 declare const ORG_ANGLE: number;
+declare const DEG_RAD: number;
 declare const RAD_DEG: number;
 type Path = string | any[];
 declare function fixnum(value: number): number;
@@ -26,6 +28,10 @@ interface SVGStyles {
      * SVG에 적용되는 css {@page https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/fill fill} 스타일 속성.<br/>
      */
     fill?: string;
+    /**
+     * SVG에 적용되는 css {@page https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/filter filter} 스타일 속성.<br/>
+     */
+    filter?: string;
     /**
      * SVG에 적용되는 css {@page https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/fill-opacity fill-opacity} 스타일 속성.<br/>
      */
@@ -655,7 +661,7 @@ type AnnotationType = 'image' | 'shape' | 'text' | 'html' | 'chart';
  *
  * @config chart.annotation[base]
  */
-interface AnnotationOptions extends ChartItemOptions {
+interface AnnotationOptions extends PositionableItemOptions {
     type?: AnnotationType;
     /**
      * true로 지정하면 시리즈들 위에 표시된다.<br/>
@@ -664,11 +670,6 @@ interface AnnotationOptions extends ChartItemOptions {
      * @default false
      */
     front?: boolean;
-    /**
-     * 어노테이션 이름.<br/>
-     * 동적으로 어노테이션을 다루기 위해서는 반드시 지정해야 한다.
-     */
-    name?: string;
     /**
      * 어노테이션 배치 기준이 되는 맵차트 구성 요소.<br/>
      * 현재, 같은 영역(body 혹은 chart)에 포함된 {@link config.base.gauge 게이지}나 다른 어노테이션의 {@link name 이름}을 지정할 수 있다.
@@ -681,15 +682,9 @@ interface AnnotationOptions extends ChartItemOptions {
      * @default 'left' anchor가 지정되면 'center', 아니면 'left'
      */
     align?: Align;
-    /**
-     * 수직 배치.<br/>
-     *
-     * @default top
-     */
-    verticalAlign?: VerticalAlign;
     /**
      * {@link align}과 {@link verticalAlign}으로 지정된 위치에서 실제 표시될 위치의 수평 간격.<br/>
-     * 값이 양수일 때, {@link anchor}가 지정된 경우 anchor 아이템으 밖으로 멀어지고, 아니면 영역 경계 안쪽으로 멀어진다.
+     * 값이 양수일 때, {@link anchor}가 지정된 경우 anchor 아이템의 밖으로 멀어지고, 아니면 영역 경계 안쪽으로 멀어진다.
      * 또, {@link anchor}가 지정된 경우 **'0.5w'** 등으로 이 어노테이션의 너비를 기준으로 한 크기로 지정할 수 있다.
      *
      * @default 0
@@ -697,7 +692,7 @@ interface AnnotationOptions extends ChartItemOptions {
     offsetX?: number | string;
     /**
      * {@link align}과 {@link verticalAlign}으로 지정된 위치에서 실제 표시될 위치의 수직 간격.<br/>
-     * 값이 양수일 때, {@link anchor}가 지정된 경우 anchor 아이템으 밖으로 멀어지고, 아니면 영역 경계 안쪽으로 멀어진다.
+     * 값이 양수일 때, {@link anchor}가 지정된 경우 anchor 아이템의 밖으로 멀어지고, 아니면 영역 경계 안쪽으로 멀어진다.
      * 또, {@link anchor}가 지정된 경우 **'0.5h'**처럼 이 어노테이션의 너비를 기준으로 한 크기로 지정할 수 있다.
      *
      * @default 0
@@ -716,12 +711,6 @@ interface AnnotationOptions extends ChartItemOptions {
      * @default 'chart'
      */
     scope?: AnnotationScope;
-    /**
-     * 배경 스타일.<br/>
-     * 경계 및 배경 색, padding 스타일을 지정할 수 있다.
-     * [주의] padding을 style이 아니라 여기서 지정하는 이유: background가 표시되지 않으면 사용자가 padding여부를 알 수 없다.
-     */
-    backgroundStyle?: SVGStyleOrClass;
     /**
      * true로 지정하면 상위 영역을 벗어난 부분도 표시되게 한다.<br/>
      * body에 포함된 경우 body 영역,
@@ -729,46 +718,6 @@ interface AnnotationOptions extends ChartItemOptions {
      *
      */
     noClip?: boolean;
-    /**
-     * body 어노테이션일 경우,
-     * x 축을 기준으로 지정하는 수평(inverted일 때 수직) 위치.<br/>
-     * chart에 지정된 어노테이션에서는 무시된다.
-     *
-     */
-    x1?: number | Date;
-    /**
-     * body 어노테이션일 경우,
-     * x 축을 기준으로 지정하는 수평(inverted일 때 수직) 위치.<br/>
-     * chart에 지정된 어노테이션에서는 무시된다.
-     *
-     */
-    x2?: number | Date;
-    /**
-     * body 어노테이션일 경우,
-     * y 축을 기준으로 지정하는 수직(inverted일 때 수평) 위치.<br/>
-     * chart에 지정된 어노테이션에서는 무시된다.
-     *
-     */
-    y1?: number | Date;
-    /**
-     * body 어노테이션일 경우,
-     * y 축을 기준으로 지정하는 수직(inverted일 때 수평) 위치.<br/>
-     * chart에 지정된 어노테이션에서는 무시된다.
-     *
-     */
-    y2?: number | Date;
-    /**
-     * Annotation 너비.<br/>
-     * 픽셀 단위의 고정 값이나, plot 영역에 대한 상태 크기롤 지정할 수 있다.
-     *
-     */
-    width?: PercentSize;
-    /**
-     * Annotation 높이.<br/>
-     * 픽셀 단위의 고정 값이나, plot 영역에 대한 상태 크기롤 지정할 수 있다.
-     *
-     */
-    height?: PercentSize;
 }
 declare const ImageAnnotationType = "image";
 /**
@@ -1373,25 +1322,25 @@ interface MapBackgroundOptions extends ChartItemOptions {
  */
 interface BodyPanelOptions extends ChartItemOptions {
     /**
-     * body 영역 내에서 panel의 수평 정렬.<br/>
+     * {@page config.body} 영역 내에서 panel의 수평 정렬.<br/>
      *
      * @default 'left'
      */
     align?: Align;
     /**
-     * body 영역 내에서 panel의 수직 정렬.<br/>
+     * {@page config.body} 영역 내에서 panel의 수직 정렬.<br/>
      *
      * @default 'top'
      */
     verticalAlign?: VerticalAlign;
     /**
-     * body 영역 경계와 panel 사이의 수평 간격.<br/>
+     * {@page config.body} 영역 경계와 panel 사이의 수평 간격.<br/>
      *
      * @default 8 픽셀
      */
     offsetX?: number;
     /**
-     * body 영역 경계와 panel 사이의 수직 간격.<br/>
+     * {@page config.body} 영역 경계와 panel 사이의 수직 간격.<br/>
      *
      * @default 8 픽셀
      */
@@ -1421,11 +1370,12 @@ interface ZoomPanelOptions extends BodyPanelOptions {
      */
     direction?: 'vertical' | 'horizontal';
     /**
-     * 버튼 클릭 시 증감될 zoom 변경량을 백분율로 지정한다.<br/>
+     * 버튼 클릭 시 증감될 zoom 변화율을 지정한다.<br/>
+     * 값이 클수록 작은 변화량이 된다.
      *
      * @default 20
      */
-    zoomStep?: number;
+    zoomFactor?: number;
     /**
      * 버튼 너비.<br/>
      * {@page buttonHeight}가 지정되지 않으면 이 속성값과 동일하게 표시된다.
@@ -1500,6 +1450,9 @@ interface DrilldownPanelOptions extends BodyPanelOptions {
      */
     verticalAlign?: VerticalAlign;
 }
+/**
+ * 콜백 매개변수 타입 base.<br/>
+ */
 interface CommonCallbackArgs {
     /**
      * Realmap의 공개 {@page api.Chart} 모델
@@ -1556,10 +1509,10 @@ interface BodyOptions extends ChartItemOptions {
      */
     maxZoom?: number;
     /**
-     * 마우스 휠로 zooming할 때 이 속성에 지정한 값에 따라 wheel 변화량을 계산한다.<br/>
+     * 마우스 휠로 zooming할 때 이 속성에 지정한 값에 따라 wheel 변화량을 zoom 변화율로 반영한다.<br/>
      * 큰 값을 지정할 수록 작게 변화한다.
      *
-     * @default 4
+     * @default 5
      */
     wheelZoomFactor?: number;
     /**
@@ -1850,9 +1803,86 @@ interface MapWidgetGroupOptions extends MapWidgetOptions {
     direction?: 'vertical' | 'horizontal';
 }
 /**
- * DataPointCallbackArgs
+ * 어노테이션 배치 기준.<br/>
+ * [주의]body에 설정된 annoation에는 적용되지 않는다.
+ * @enum
+ */
+declare const _PositionalScope: {
+    /**
+     * container에서 padding을 적용한 영역을 기준으로 표시한다.
+     *
+     * @config
+     */
+    readonly CHART: "chart";
+    /**
+     * container 전체 영역을 기준으로 표시한다.
+     *
+     * @config
+     */
+    readonly CONTAINER: "container";
+};
+/** @dummy */
+type PositionalScope = typeof _PositionalScope[keyof typeof _PositionalScope];
+interface PositionableItemOptions extends ChartItemOptions {
+    /**
+     * 아이템 이름.<br/>
+     * 동적으로 아이템을 다루기 위해서는 반드시 지정해야 한다.
+     */
+    name?: string;
+    /**
+     * 수평 배치.<br/>
+     *
+     * @default 'left'
+     */
+    align?: Align;
+    /**
+     * 수직 배치.<br/>
+     *
+     * @default top
+     */
+    verticalAlign?: VerticalAlign;
+    /**
+     * {@link align}과 {@link verticalAlign}으로 지정된 위치에서 실제 표시될 위치의 수평 간격.<br/>
+     *
+     * @default 0
+     */
+    offsetX?: number | string;
+    /**
+     * {@link align}과 {@link verticalAlign}으로 지정된 위치에서 실제 표시될 위치의 수직 간격.<br/>
+     *
+     * @default 0
+     */
+    offsetY?: number | string;
+    /**
+     * 아이템 배치 기준.<br/>
+     *
+     * @default 'chart'
+     */
+    scope?: PositionalScope;
+    /**
+     * 배경 스타일.<br/>
+     * 경계 및 배경 색, padding 스타일을 지정할 수 있다.
+     * [주의] padding을 style이 아니라 여기서 지정하는 이유: background가 표시되지 않으면 사용자가 padding여부를 알 수 없다.
+     */
+    backgroundStyle?: SVGStyleOrClass;
+    /**
+     * 아이템 너비.<br/>
+     * 픽셀 단위의 고정 값이나, plot 영역에 대한 상태 크기롤 지정할 수 있다.
+     */
+    width?: PercentSize;
+    /**
+     * 아이템 높이.<br/>
+     * 픽셀 단위의 고정 값이나, plot 영역에 대한 상태 크기롤 지정할 수 있다.
+     */
+    height?: PercentSize;
+}
+/**
+ * DataPoint 관련 callback 매개변수 타입.<br/>
  */
 interface DataPointArgs extends CommonCallbackArgs {
+    /**
+     * 시리즈 객체.
+     */
     series: object;
     count: number;
     id: string;
@@ -1989,33 +2019,6 @@ interface ChartExporter {
     hideContextMenu: () => void;
 }
 
-interface IPoint {
-    x: number;
-    y: number;
-}
-
-interface ISize {
-    width: number;
-    height: number;
-}
-/** @internal */
-declare class Size {
-    width: number;
-    height: number;
-    static readonly EMPTY: Size;
-    static empty(): Size;
-    static create(w?: number, h?: number): Size;
-    constructor(width?: number, height?: number);
-    /** isEmpty */
-    get isEmpty(): boolean;
-    clone(): Size;
-    equals(sz: Size): boolean;
-    setEmpty(): Size;
-    set(width: number, height: number): Size;
-    round(): Size;
-    toString(): string;
-}
-
 /** @internal */
 declare class Color {
     private static readonly COLORS;
@@ -2083,6 +2086,28 @@ declare class NumberFormatter {
     private $_parse;
 }
 
+interface ISize {
+    width: number;
+    height: number;
+}
+/** @internal */
+declare class Size {
+    width: number;
+    height: number;
+    static readonly EMPTY: Size;
+    static empty(): Size;
+    static create(w?: number, h?: number): Size;
+    constructor(width?: number, height?: number);
+    /** isEmpty */
+    get isEmpty(): boolean;
+    clone(): Size;
+    equals(sz: Size): boolean;
+    setEmpty(): Size;
+    set(width: number, height: number): Size;
+    round(): Size;
+    toString(): string;
+}
+
 interface IRect {
     x: number;
     y: number;
@@ -2180,6 +2205,11 @@ declare class TextFormatter {
     $_parse(fmt: string): void;
 }
 
+interface IPoint {
+    x: number;
+    y: number;
+}
+
 /** @internal */
 declare class RmTool<T extends RmControl = RmControl> {
     private _control;
@@ -2187,8 +2217,8 @@ declare class RmTool<T extends RmControl = RmControl> {
     private _moveElement;
     private _draggable;
     private _dragTracker;
-    private _touchX;
-    private _touchY;
+    private _clickX;
+    private _clickY;
     private _prevX;
     private _prevY;
     protected _touches: {
@@ -2211,8 +2241,6 @@ declare class RmTool<T extends RmControl = RmControl> {
     get dragTracker(): DragTracker;
     setDragTracker(value: DragTracker): void;
     get dragging(): boolean;
-    touchX(): number;
-    touchY(): number;
     pointerDown(ev: PointerEvent): boolean;
     protected _stopEvent(ev: Event): void;
     private $_doDrag;
@@ -2251,7 +2279,7 @@ declare class RmTool<T extends RmControl = RmControl> {
     private $_startDrag;
     private $_drag;
     private $_stopDragTracker;
-    private $_pointerToPoint;
+    protected _pointerToPoint(event: PointerEvent): IPoint;
     private $_checkSwipe;
     /**
      * 터치 시작 시점에 실행한 설정 등을 이 후 touch 이벤트가 발생하면 초기화한다.
@@ -2315,7 +2343,6 @@ declare abstract class RmControl extends RmObject {
     private _requestTimer;
     private _defaultTool;
     private _tool;
-    private _invalidElements;
     private _toAnimation;
     private _invalidateLock;
     private _lockDirty;
@@ -2356,6 +2383,7 @@ declare abstract class RmControl extends RmObject {
     getCssVar(name: string): string;
     addDef(element: Element): void;
     removeDef(element: Element | string): void;
+    hasDef(defId: string): boolean;
     /**
      * defs에 직사각형 clipPath를 등록한다.
      */
@@ -2445,6 +2473,8 @@ declare class RmElement extends RmObject {
     private _dom;
     private _parent;
     removing: boolean;
+    private _saveStyle;
+    private _saveClass;
     constructor(doc: Document, styleName: string, tag?: string);
     protected _doInitStyles(): void;
     protected _doDestory(): void;
@@ -2481,6 +2511,7 @@ declare class RmElement extends RmObject {
     containsDom(dom: Element): boolean;
     addDom(dom: SVGElement | HTMLElement): HTMLElement | SVGElement;
     add<T extends RmElement>(child: T): T;
+    append<T extends RmElement>(child: T): T;
     addAll(...children: RmElement[]): void;
     insertChild<T extends RmElement>(child: T, before: RmElement): T;
     insertFirst<T extends RmElement>(child: T): T;
@@ -2515,17 +2546,14 @@ declare class RmElement extends RmObject {
     appendDom(dom: Node): Node;
     insertDom(dom: Node, before: Node): Node;
     clearDom(): void;
-    private _saveStyle;
-    private _saveClass;
+    hasSavedStyles(): boolean;
     saveStyles(): void;
     restoreStyles(): void;
     internalClearStyles(): void;
     clearStyles(): boolean;
-    clearStyle(props: string[]): boolean;
     internalSetStyles(styles: any): void;
     internalImportantStylesOrClass(style: any): void;
-    setStyles(styles: SVGStyles): boolean;
-    resetStyles(styles: any): boolean;
+    resetStyles(styles: any): void;
     protected _resetClass(): void;
     setClass(className: string): void;
     clearStyleAndClass(): void;
@@ -2535,12 +2563,9 @@ declare class RmElement extends RmObject {
     internalResetStyleOrClass(style: SVGStyleOrClass): void;
     protected _setBackgroundBorderRadius(value: number): void;
     setBackStyles(styles: any): boolean;
-    setStyle(prop: string, value: any): boolean;
-    internalSetStyle(prop: string, value: string): void;
+    internalSetStyle(prop: string, value: any): void;
     internalSetImportantStyle(prop: string, value: string): void;
     setBackStyle(prop: string, value: string): boolean;
-    putStyles(styles: any, buff?: any): any;
-    putStyle(prop: string, value: string, buff?: any): any;
     setColor(color: string): this;
     getFill(): any;
     getStroke(): any;
@@ -2559,16 +2584,17 @@ declare class RmElement extends RmObject {
     rotate(angle: number): RmElement;
     internalRotate(angle: number): void;
     setCursor(cursor: string): void;
+    hasClip(): boolean;
+    setClip(cr?: ClipElement | string): void;
     clipRect(x: number, y: number, width: number, height: number, rd?: number): ClipRectElement;
     clipPath(path: Path): ClipPathElement;
-    attachClipPath(clipId: string): void;
-    detachClipPath(): void;
-    private $_setClip;
     private createClipId;
     sort(children: RmElement[]): void;
     getParent<T extends RmElement>(type: {
         new (): T;
     }): T;
+    onScrollStart(): void;
+    onScrollEnd(): void;
     protected _testing(): boolean;
     protected _doAttached(parent: RmElement): void;
     protected _doDetached(parent: RmElement): void;
@@ -2670,9 +2696,9 @@ declare class TextElement extends RmElement {
     calcRangeWidth(start?: number, end?: number): number;
     truncate(bounds: number, ellipsis: boolean): void;
     setContrast(target: Element, darkStyle: SVGStyleOrClass, brightStyle: SVGStyleOrClass): TextElement;
+    setStyle(prop: string, value: any): boolean;
+    setStyles(styles: SVGStyles): boolean;
     clearDom(): void;
-    setStyles(styles: any): boolean;
-    setStyle(prop: string, value: string): boolean;
     bbox(): IRect;
     getBBoundsTest(): IRect;
     stain(): void;
@@ -2781,8 +2807,15 @@ declare const _Shapes: {
 /** @dummy */
 type Shape = typeof _Shapes[keyof typeof _Shapes];
 
+/**
+ */
 type PointHoverCallback = (args: DataPointArgs) => void;
+/**
+ */
 type PointClickCallback = (args: DataPointArgs) => boolean;
+/**
+ * xxx
+ */
 type PointStyleCallback = (args: DataPointArgs) => SVGStyleOrClass | undefined;
 /**
  * @enum
@@ -2824,10 +2857,17 @@ declare const _PointLabelPositions: {
 };
 /** @dummy */
 type PointLabelPosition = typeof _PointLabelPositions[keyof typeof _PointLabelPositions];
+interface PointLabelPositionCallbackArgs extends CommonCallbackArgs {
+    point: any;
+}
 /**
  * 데이터포인트 label 설정 옵션.<br/>
  */
 interface DataPointLabelOptions extends IconedTextOptions {
+    /**
+     * 데이터포인트 위에 마우스가 있을 때 적용되는 스타일셋 혹은 class selector.
+     */
+    hoverStyle?: SVGStyleOrClass;
     /**
      * @default true
      */
@@ -2869,13 +2909,14 @@ interface DataPointLabelOptions extends IconedTextOptions {
      */
     textCallback?: (point: any) => string;
     /**
-     * 데이터 포인트별 label 표시 여부를 리턴하는 콜백.
+     * 데이터 포인트별 label 표시 여부를 리턴하는 콜백.<br/>
      */
     visibleCallback?: (point: any) => boolean;
     /**
-     * 데이터 포인트별로 추가 적용되는 스타일을 리턴한다.
+     * 데이터 포인트별로 추가 적용되는 스타일을 리턴한다.<br/>
      */
     styleCallback?: (point: any) => SVGStyleOrClass;
+    positionCallback?: (args: PointLabelPositionCallbackArgs) => PointLabelPosition;
     /**
      * @ignore 미구현
      * 데이터 포인트 label들이 처음 load될 때 실행될 animation 종류.<br/>
@@ -2937,13 +2978,14 @@ interface DataPointCalloutOptions extends ChartItemOptions {
 /**
  * 시리즈는 {@page data}로 지정된 값들을 데이터포인트로 표시하는 맵차트의 핵심 구성 요소이다.<br/>
  * 맵차트 설정의 다른 부분이나 API에 참조하기 위해서는 {@page name}을 반드시 지정해야 햔다.
- * 맵차트 생성 시 {@page config.series.#type} 을 지정하지 않으면 {@page config.series.bar 'bar'} 시리즈로 생성된다.<br/>
+ * 맵차트 생성 시 {@page type} 을 지정하지 않으면 {@page config.series.map 'map'} 시리즈로 생성된다.<br/>
  *
  * @config chart.series[base]
  */
 interface SeriesOptions extends ChartItemOptions {
     /**
-     * 맵차트 설정 객체에 지정하는 시리즈 종류.<br/>
+     * 시리즈 종류를 지정한다.<br/>
+     * 지정하지 않으면 {@page config.series.map 'map'} 시리즈로 생성된다.
      */
     type?: string;
     /**
@@ -2964,13 +3006,17 @@ interface SeriesOptions extends ChartItemOptions {
     map?: string | number;
     /**
      * 데이터포인트 label 설정 옵션.<br/>
+     * boolean으로 지정하면 {@page visible} 속성을,
+     * 문자열로 지정하면 {@page text} 속성을 별도로 지정하는 것과 동일하다.
      */
-    pointLabel?: DataPointLabelOptions | boolean;
+    pointLabel?: DataPointLabelOptions | boolean | string;
     /**
      * 데이터포인트 위치에서 선을 그어 떨어뜨려 표시하는 옵션.<br/>
      * 데이터가 밀집된 지역이나 겹치는 값들 사이에서 분리하여 배치하기 위해 사용한다.<br/>
-     * data의 offset 속성에서 `[경도 변화량, 위도 변화량]`으로 지정한 값들로 선을 남기며 이동시킨다.<br/>
-     * ex) `[{ offset: [[0, 2], [1, -1]], value: 100 }, ...]`
+     * 데이터포인트에 **callout** 속성이 `[경도, 위도]` 형식으로 지정되면 그 위치에 표시하고,
+     * **offset** 속성이 지정되면 원래 표시 위치에서 `[경도 변화량, 위도 변화량]`으로 지정한 값들 만큼 이동시킨다.<br/>
+     * ex) `{ callout: [[127.2, 35.3], [127.9, 35.3]], ... }`<br/>
+     * ex) `{ offset: [[0, 2], [1, -1]], ... }`
      */
     callout?: DataPointCalloutOptions | boolean;
     /**
@@ -2997,7 +3043,8 @@ interface SeriesOptions extends ChartItemOptions {
     dataPath?: string;
     /**
      * {@page data}가 array로 제공되어 datapoint로 생성될 때,
-     * array의 각 항목에 해당하는 이름으로 datapoint source의 값을 사용한다.
+     * array의 각 항목에 해당하는 이름으로 datapoint source의 값을 사용한다.<br/>
+     * ex) `['id', 'lon', 'lat', 'name', 'color']`
      */
     fields?: string[];
     /**
@@ -3006,37 +3053,39 @@ interface SeriesOptions extends ChartItemOptions {
      *
      * @default 'id'
      */
-    idField?: string;
+    idField?: string | number;
     /**
      * {@page data}로 전달되는 데이터포인트 생성 객체들의 'name' 속성 값 대신,
      * 이 속성으로 지정된 값을 데이터포인트 **이름**으로 설정한다.<br/>
      *
      * @default 'name'
      */
-    nameField?: string;
+    nameField?: string | number;
     /**
      * {@page data}로 전달되는 데이터포인트 생성 객체들의 'lon' 속성 값 대신,
      * 이 속성으로 지정된 값을 데이터포인트 **경도** 값으로 설정한다.<br/>
      *
      * @default 'lon'
      */
-    lonField?: string;
+    lonField?: string | number;
     /**
      * {@page data}로 전달되는 데이터포인트 생성 객체들의 'lat' 속성 값 대신,
      * 이 속성으로 지정된 값을 데이터포인트 **위도** 값으로 설정한다.<br/>
      *
      * @default 'lat'
      */
-    latField?: string;
+    latField?: string | number;
     /**
      * {@page data}로 전달되는 데이터포인트 생성 객체들의 'color' 속성 값 대신,
-     * 이 속성으로 지정된 값을 데이터포인트 기본 **색상**으로 적용한다.<br/>
+     * 이 속성으로 지정된 값을 데이터포인트의 기본 색상으로 적용한다.<br/>
+     *
+     * @default 'color'
      */
-    colorField?: string;
+    colorField?: string | number;
     /**
      * 데이터 포인트 기본 색.<br/>
      * 숫자로 지정하면 정수로 변환된 값에 해당하는 팔레트 색상으로 설정된다.
-     * 'var(--color-n)'으로 지정한 것과 동일하며, 1 ~ 12 사이의 값으로 지정한다.<br/>
+     * 'var(--color-n)'으로 지정한 것과 동일하며, 1 ~ 12 사이의 값으로 설정할 수 있다.
      * {@page style}로 지정된 색상보다는 우선하지만,
      * {@page pointColors}나 {@page styleCallback}으로 설정된 색상이 이 속성으로 설정한 색상보다 우선한다.
      */
@@ -3047,47 +3096,51 @@ interface SeriesOptions extends ChartItemOptions {
      * 시리즈 {@page style}이나 {@page color}로 지정된 색 보다는 우선하지만,
      * {@page styleCallback}에서 설정된 색상이나 데이터포인트별로 지정한 색상이 이 속성으로 설정된 색상보다 우선한다.
      */
-    pointColors?: string[] | string | ((point: any) => string);
+    pointColors?: string[] | string | ((point: DataPointArgs) => string);
     /**
-     * 데이터포인트 툴팁 텍스트.
+     * 데이터포인트 툴팁 텍스트.<br/>
+     * true로 지정하면 기본 툴팁이 적용되고, false로 지정하면 tooltip이 표시되지 않는다.
      */
     tooltipText?: string | boolean;
-    tooltipCallback?: (args: any) => string;
     /**
-     * 이 시리즈가 연결된 legend를 index나 이름으로 지정한다.<br/>
-     * -1 등 잘못된 값을 지정하면 legend에 표시되지 않는다.
+     * 동적으로 {@page tooltipText}를 리턴하는 콜백.<br/>
+     * null이나 undefined를 리턴하면 {@page tooltipText} 설정을 따른다.
+     */
+    tooltipCallback?: (args: DataPointArgs) => string;
+    /**
+     * 이 시리즈가 연결된 legend를 legend의 index나 이름으로 지정한다.<br/>
+     * 범위를 벗어난 index 등 잘못된 값을 지정하면 legend에 표시되지 않는다.
+     * 특별히 지정하지 않으면 첫 번째 index에 표시된다.
      *
      * @default 0
      */
     legend?: number | string;
     /**
      * @ignore 미구현
+     *
      * 차트 설정 로드 시 실행되는 animation 종류.
      */
     loadAnimation?: 'default' | 'reveal' | 'grow' | 'spread' | 'fadein';
     /**
-     * true로 설정하면 hovering을 포함한 포인터 상호 작용에 비활성화 된다.<br/>
+     * true로 설정하면 hovering을 포함한 마우스 등의 포인터에 반응하지 않는다.<br/>
      */
     disabled?: boolean;
-    /**
-     * @ignore 미구현
-     * 데이터포인트 hover 효과.<br/>
-     */
-    hoverEffect?: 'none' | 'default';
-    /**
-     * 데이터포인트 위에 마우스가 있을 때 적용되는 스타일셋 혹은 class selector.
-     */
-    hoverStyle?: SVGStyleOrClass;
     /**
      * 데이터 point의 동적 스타일 콜백.<br/>
-     * {@page style}, {@page pointColors} 등 다른 스타일 지정들 보다 우선한다.
+     * {@page style}, {@page pointColors} 등 다른 스타일 설정들 보다 우선한다.
      */
     styleCallback?: PointStyleCallback;
     /**
-     * 데이터포인트들이 새로 로드된 후 호출된다.
+     * 데이터포인트들이 로드된 후 호출된다.<br/>
      */
     onPointsLoaded?: (series: object, firstTime: boolean) => void;
+    /**
+     * {@page rm.Series#addPoint}를 호출해서 데이터포인트가 하나 추가된 후 호출된다.<br/>
+     */
     onPointAdded?: (args: DataPointArgs) => void;
+    /**
+     * {@page rm.Series#removePoint}를 호출해서 데이터포인트가 하나 제거된 후 호출된다.<br/>
+     */
     onPointRemoved?: (args: DataPointArgs) => void;
     onPointUpdated?: (args: DataPointArgs) => void;
     onPointListAdded?: (args: DataPointListkArgs) => void;
@@ -3115,10 +3168,20 @@ interface ValueSeriesOptions extends SeriesOptions {
      */
     valueField?: string;
 }
+/**
+ * area가 아니라 위치 기준으로 데이터를 표시하는 시리즈.<br/>
+ */
+interface CoordBaseSeriesOptions extends ValueSeriesOptions {
+    /**
+     * 데이터포인트를 표시하지 않는 영역(들)을 지정한다.<br/>
+     * [왼쪽위, 오른쪽아래, ...] 형태로 두 위치를 연속적으로 지정해서 복수 개의 영역을 설정할 수 있다.
+     */
+    excludeBounds?: MapCoord[];
+}
 /**
  * 특정 위치에 연관된 값을 버블이나 shape 등으로 표시한다.<br/>
  */
-interface MarkerSeriesOptions extends ValueSeriesOptions {
+interface MarkerSeriesOptions extends CoordBaseSeriesOptions {
     /**
      * 데이터포인트 {@page shape 도형} 회전 각도.<br/>
      */
@@ -3137,7 +3200,7 @@ interface SparkSeriesCategory {
  * 특정 위치에 연관된 값들을 단순 차트(spark chart)로 표시한다.<br/>
  * bar, line, pie 차트가 제공된다.
  */
-interface SparkSeriesOptions extends ValueSeriesOptions {
+interface SparkSeriesOptions extends CoordBaseSeriesOptions {
     /**
      * 데이터포인트의 값이 복수개일 때 값별 색상을 순서대로 지정한다.<br/>
      * color 항목이 설정되지 않으면 데이터포인트의 기본 색상이 사용된다.
@@ -3174,7 +3237,7 @@ interface SparkSeriesOptions extends ValueSeriesOptions {
      */
     position?: PointViewPosition;
 }
-interface GaugeOptions extends ValueSeriesOptions {
+interface GaugeOptions extends CoordBaseSeriesOptions {
     /**
      * 데이터포인트 차트 너비를 픽셀 단위로 지정한다.<br/>
      */
@@ -3293,6 +3356,8 @@ declare const BarSeriesType = "bar";
 interface BarSeriesOptions extends OrthogonalSparkSeriesOptions {
     type?: typeof BarSeriesType;
     /**
+     * @private 미구현
+     *
      * sub label 설정 모델.
      */
     subLabel?: DataPointLabelOptions | boolean;
@@ -3306,9 +3371,22 @@ interface BarSeriesOptions extends OrthogonalSparkSeriesOptions {
     barWidth?: number;
     maxValue?: number;
     /**
-     * null인 y값을 {@page baseValue}로 간주한다.
+     * null인 y값을 {@page baseValue}로 간주한다.<br/>
      */
     nullAsBase?: boolean;
+    /**
+     * {@page categories}가 지정되지 않고, {@page colorByField}가 true인 경우,
+     * bar들의 색상이 이 속성에 지정한 색들로 순환 지정된다.<br/>
+     * 이 속성이 지정되지 않으면 데이터포인트 색상을 기준으로 색을 분리해 표시한다.
+     */
+    fieldColors?: string[];
+    /**
+     * {@page fieldColors} 속성에 따라 bar들이 다른 색으로 표시되게 한다.<br/>
+     * {@page categories}가 지정되면 그 설정을 따른다.
+     *
+     * @default true
+     */
+    colorByField?: boolean;
     /**
      * {@page baseValue} 혹은 y축의 baseValue보다 작은 쪽의 point들에 적용되는 스타일.
      */
@@ -3393,11 +3471,19 @@ interface PieSeriesOptions extends SparkSeriesOptions {
     startAngle?: number;
     totalAngle?: number;
     clockwise?: boolean;
-    legendByField?: boolean;
     /**
+     * {@page categories}가 지정되지 않고, {@page colorByField}가 true인 경우,
+     * bar들의 색상이 이 속성에 지정한 색들로 순환 지정된다.<br/>
+     * 이 속성이 지정되지 않으면 데이터포인트 색상을 기준으로 색을 분리해 표시한다.
+     */
+    fieldColors?: string[];
+    /**
+     * {@page fieldColors} 속성에 따라 파이 섹터들이 다른 색으로 표시되게 한다.<br/>
+     * {@page categories}가 지정되면 각 category에 지정된 색상을 따른다.
+     *
      * @default true
      */
-    colorByValue?: boolean;
+    colorByField?: boolean;
     /**
      * 파이 섹터 무시 경계 값 및 속성 설정 목록.<br/>
      * 데이터포인트 values의 총 합이 지정된 값보다 작을 때
@@ -3699,11 +3785,11 @@ interface MapSeriesLabelOptions extends DataPointLabelOptions {
 }
 declare const MapSeriesType = "map";
 /**
- * Map area 영역들을 칠하는 시리즈.<br/>
+ * 맵 소스에서 경계가 설정된 영역들을 표시하는 시리즈.<br/>
  * {@page op.SeriesOptions#type}은 'map'이다.<br/>
- * choropleth map(단계 구분도. 색상으로 area별 특성을 나타내는 지도).
- * 설정에서 type을 지정하지 않으면 생성되는 기본 시리즈이다.
- * Map chart가 지도처럼 보이려면 반드시 하나 이상의 map series가 포함되어야 한다.<br/>
+ * {@link https://en.wikipedia.org/wiki/Choropleth_map choropleth map}(단계 구분도. 색상으로 area별 특성을 나타내는 지도)으로 사용된다.
+ * 맵차트 설정에서 {@page op.SeriesOptions#type}을 지정하지 않으면 자동으로 생성되는 기본 시리즈이다.
+ * 맵차트가 지도처럼 보이려면 반드시 하나 이상의 map 시리즈나 {@page config.series.tiledweb tiledweb 시리즈}가 포함되어야 한다.<br/>
  *
  * @config chart.series[type=map]
  */
@@ -3746,7 +3832,15 @@ interface MapSeriesOptions extends ValueSeriesOptions {
      * @default false
      */
     nullHovering?: boolean;
+    /**
+     * 데이터포인트 위에 마우스가 있을 때 적용되는 색상.<br />
+     * hoverStyle보다 우선되어 적용된다.
+     */
     hoverColor?: string;
+    /**
+     * 데이터포인트 위에 마우스가 있을 때 적용되는 스타일셋 혹은 class selector.<br />
+     * hoverColor와 hoverStyle 둘 다 적용되지 않은 경우, 기본 fill, filter가 적용된다.
+     */
     hoverStyle?: SVGStyleOrClass;
     /**
      * true로 지정하면 마우스 클릭 등으로 area를 선택할 수 있다.<br/>
@@ -3760,7 +3854,7 @@ interface MapSeriesOptions extends ValueSeriesOptions {
      */
     selectedStyle?: SVGStyleOrClass;
     /**
-     * true로 지정하면 data point가 설정되지 않은 area들도 nullColor로 표시한다.<br/>
+     * true로 지정하면 data point가 설정되지 않은 area들도 {@page nullStyle}로 표시한다.<br/>
      * 복수 개의 시리즈로 영역들을 그룹핑하려면 반드시 false로 지정해야 한다.
      *
      * @default true
@@ -3800,7 +3894,7 @@ interface MapSeriesOptions extends ValueSeriesOptions {
     /**
      * true로 지정하면 데이터포인트가 설정된 area들이 설정되지 않은 area보다 위에 그려지게 한다.<br/>
      *
-     * @default false;
+     * @default false
      */
     bringToFront?: boolean;
     /**
@@ -3820,7 +3914,7 @@ declare const FeatureSeriesType = "feature";
  *
  * @config chart.series[type=map]
  */
-interface FeatureSeriesOptions extends ValueSeriesOptions {
+interface FeatureSeriesOptions extends CoordBaseSeriesOptions {
     type?: typeof FeatureSeriesType;
     hoverColor?: string;
     hoverStyle?: SVGStyleOrClass;
@@ -4002,7 +4096,7 @@ declare const FigureSeriesType = "figure";
  *
  * @config chart.series[type=figure]
  */
-interface FigureSeriesOptions extends ValueSeriesOptions {
+interface FigureSeriesOptions extends CoordBaseSeriesOptions {
     type?: typeof FigureSeriesType;
     figures?: {
         [id: string]: {
@@ -4142,6 +4236,8 @@ declare const _HitmapMode: {
 type HitmapMode = typeof _HitmapMode[keyof typeof _HitmapMode];
 declare const HeatmapSeriesType = "heatmap";
 /**
+ * @private 미구현
+ *
  * 특정 위치를 중심으로 주변 영역을 칠하는 시리즈.<br/>
  * {@page op.SeriesOptions#type}은 'heatmap'이다.<br/>
  *
@@ -4159,6 +4255,18 @@ interface HeatmapSeriesOptions extends MarkerSeriesOptions {
     point?: HitmapPointModeOptions;
     kde?: HitmapKdeModeOptions;
 }
+declare const RegionSeriesType = "region";
+/**
+ * @private 미구현
+ *
+ * Region 시리즈.<br/>
+ * {@page op.SeriesOptions#type}은 'region'이다.<br/>
+ *
+ * @config chart.series[type=region]
+ */
+interface RegionSeriesOptions extends MarkerSeriesOptions {
+    type?: typeof RegionSeriesType;
+}
 interface PanelSeriesSectionOptions extends ChartItemOptions {
     /**
      * @default '${value}'
@@ -4186,7 +4294,7 @@ declare const PanelSeriesType = "panel";
  *
  * @config chart.series[type=panel]
  */
-interface PanelSeriesOptions extends ValueSeriesOptions {
+interface PanelSeriesOptions extends CoordBaseSeriesOptions {
     type?: typeof PanelSeriesType;
     /**
      * {@page header}와 본체를 배치하는 방향.<br />
@@ -4216,10 +4324,14 @@ interface PanelSeriesOptions extends ValueSeriesOptions {
      */
     position?: PointViewPosition;
 }
+interface TileWebProvider {
+    url: string;
+    theme?: string;
+    subDomain?: string;
+    credit: string;
+}
 declare const TiledWebSeriesType = "tiledweb";
 /**
- * @ignore
- *
  * 지도 해상도에 맞는 조각 그림들로 맵 배경을 채우는 시리즈.<br/>
  * {@page op.SeriesOptions#type}은 'tiledweb'이다.<br/>
  *
@@ -4227,6 +4339,18 @@ declare const TiledWebSeriesType = "tiledweb";
  */
 interface TiledWebSeriesOptions extends SeriesOptions {
     type?: typeof TiledWebSeriesType;
+    /**
+     * @default 'osm'
+     */
+    provider?: TileWebProvider | string;
+    /**
+     * @default 'Standard'
+     */
+    theme?: string;
+    /**
+     * @default 'a'
+     */
+    subdomain?: string;
 }
 /**
  * track 시리즈 outline 설정 옵션.<br/>
@@ -4260,6 +4384,8 @@ interface TrackSeriesOptions extends SeriesOptions {
 }
 declare const BandSeriesType = "band";
 /**
+ * @private 미구현
+ *
  * Band Series<br/>
  * {@page op.SeriesOptions#type}은 'band'이다.<br/>
  *
@@ -4270,6 +4396,8 @@ interface BandSeriesOptions extends SeriesOptions {
 }
 declare const TableSeriesType = "table";
 /**
+ * @private 미구현
+ *
  * Table Series<br/>
  * {@page op.SeriesOptions#type}은 'table'이다.<br/>
  *
@@ -4280,6 +4408,8 @@ interface TableSeriesOptions extends SeriesOptions {
 }
 declare const SankeySeriesType = "sankey";
 /**
+ * @private 미구현
+ *
  * Sankey Series<br/>
  * {@page op.SeriesOptions#type}은 'sankey'이다.<br/>
  *
@@ -4288,6 +4418,39 @@ declare const SankeySeriesType = "sankey";
 interface SankeySeriesOptions extends SeriesOptions {
     type?: typeof SankeySeriesType;
 }
+/**
+ * @private 미구현
+ *
+ * WebGL 시리즈 옵션 base.<br/>
+ * {@page op.SeriesOptions#type}은 'table'이다.<br/>
+ *
+ * @config chart.series
+ * @module gl
+ */
+interface GLSeriesOptions extends ValueSeriesOptions {
+}
+declare const GLPointSeriesType = "glpoint";
+/**
+ * @private 미구현
+ *
+ * WebGL 포인트 시리즈 옵션.<br/>
+ * {@page op.SeriesOptions#type}은 'glpoint'이다.<br/>
+ *
+ * @config chart.series[type=glpoint]
+ */
+interface GLPointSeriesOptions extends GLSeriesOptions {
+    type?: typeof GLPointSeriesType;
+    /**
+     * 데이터포인트 {@page shape 도형}의 반지름.
+     *
+     * @default 5
+     */
+    radius?: number;
+    /**
+     * @default 'center'
+     */
+    position?: PointViewPosition;
+}
 /**
  * Circle 게이지 내부 원 설정 모델.<br/>
  */
@@ -4685,7 +4848,7 @@ interface ClockGaugeOptions extends GaugeOptions {
      */
     active?: boolean;
 }
-type SeriesOptionsType = MapSeriesOptions | FeatureSeriesOptions | PointSeriesOptions | PinSeriesOptions | FigureSeriesOptions | VectorSeriesOptions | RouteSeriesOptions | ImageSeriesOptions | BarSeriesOptions | PieSeriesOptions | WaffleSeriesOptions | LineSeriesOptions | BubbleSeriesOptions | HeatmapSeriesOptions | PanelSeriesOptions | TiledWebSeriesOptions | TrackSeriesOptions | SankeySeriesOptions | CircleGaugeOptions | ClockGaugeOptions;
+type SeriesOptionsType = MapSeriesOptions | FeatureSeriesOptions | PointSeriesOptions | PinSeriesOptions | FigureSeriesOptions | VectorSeriesOptions | RouteSeriesOptions | ImageSeriesOptions | BarSeriesOptions | PieSeriesOptions | WaffleSeriesOptions | LineSeriesOptions | BubbleSeriesOptions | HeatmapSeriesOptions | PanelSeriesOptions | TiledWebSeriesOptions | TrackSeriesOptions | SankeySeriesOptions | CircleGaugeOptions | ClockGaugeOptions | RegionSeriesOptions | GLPointSeriesOptions;
 
 /**
  * 시리즈 load animation 타입.
@@ -4907,7 +5070,7 @@ interface MapProjection {
     isGlobe: boolean;
     lonElliptic: boolean;
     latElliptic: boolean;
-    getYRange(latFrom: number, latTo: number): any;
+    getYRange(latFrom: number, latTo: number): MapCoord;
     project(coord: MapCoord): MapCoord;
     backward(coord: MapCoord): MapCoord;
     clip(pts: MapCoord[]): MapCoord[];
@@ -4916,6 +5079,7 @@ interface MapProjection {
     getClipBounds(lonInterval: number, latInterval: number): MapCoord[];
     isClipping(): boolean;
     getScrolledLon(lon: number): number;
+    inSecond(lon: number): boolean;
 }
 declare class MapArea extends RmObject implements ISelectionSource {
     source?: AreaItem;
@@ -5103,13 +5267,17 @@ declare class Tooltip extends ChartItem<TooltipOptions> {
     protected _doApply(options: TooltipOptions): void;
 }
 
+type GetLabelPositionFn = (p: DataPoint) => PointLabelPosition;
 /**
  * Series data point label options.
  */
 declare class DataPointLabel<OP extends DataPointLabelOptions = DataPointLabelOptions> extends IconedText<OP> {
+    private static readonly DEFAULT_POSITION;
     static defaults: DataPointLabelOptions;
     private _point;
     _domain: IRichTextDomain;
+    private _getPosition;
+    get getPosition(): GetLabelPositionFn;
     getValue(p: DataPoint, index: number): any;
     getTextDomain(p: DataPoint): IRichTextDomain;
     getText(value: any): string;
@@ -5117,6 +5285,7 @@ declare class DataPointLabel<OP extends DataPointLabelOptions = DataPointLabelOp
     getDefaultIconPos(): IconPosition;
     protected _doSetSimple(op: OP, src: any): boolean;
     protected _doPrepareRender(chart: IChart, op: OP): void;
+    protected _doApply(options: DataPointLabelOptions): void;
 }
 declare class DataPointAnchorPoint<OP extends CalloutAnchorPointOptions = CalloutAnchorPointOptions> extends ChartItem<OP> {
     static defaults: CalloutAnchorPointOptions;
@@ -5136,12 +5305,9 @@ interface ISeries<T extends DataPoint = DataPoint> {
     _idFielder: (src: any) => any;
     _nameFielder?: (src: any) => string;
     _valueFielder?: (src: any) => any;
-    _tupleFielder?: (src: any) => any[];
     _lonFielder?: (src: any) => number;
     _latFielder?: (src: any) => number;
-    _valuesFielder?: (src: any) => any[];
     _colorFielder: (src: any) => string;
-    coordOfArea(id: string): MapCoord;
     getColorScale(): string | number;
     initPoints(source: any[]): T[];
     followTooltipPointer(): boolean;
@@ -5164,8 +5330,8 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     private _data;
     private _dataPath;
     private _name;
-    index: number;
-    seriesIndex: number;
+    private _index;
+    _seriesIndex: number;
     protected _map: MapModel;
     protected _mapChanged: boolean;
     protected _points: DataPointCollection;
@@ -5205,6 +5371,10 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     legendColor(): string;
     legendLabel(): string;
     _type(): string;
+    /**
+     * 차트 시리즈 목록에서 위치.<br/>
+     */
+    get index(): number;
     /**
      * 시리즈 이름.<br/>
      * 시리즈 생성시 지정된 후 변경할 수 없다.
@@ -5234,13 +5404,16 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     followTooltipPointer(): boolean;
     isEmpty(visibleOnly: boolean): boolean;
     isDataSeries(): boolean;
+    isMapSeries(): boolean;
     getDetailed(): Series;
     getValueRange(): {
         min: number;
         max: number;
     };
     needMapScale(): boolean;
+    needTranslate(): boolean;
     contains(p: DataPoint): boolean;
+    isExcluded(p: DataPoint): boolean;
     initPoints(source: any[]): DataPoint[];
     getPoint(index: number): DataPoint;
     find(condition: {
@@ -5264,18 +5437,49 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     getLabelOff(): number;
     protected _defLabelOff(): number;
     setCalcedColor(cs: CSSStyleDeclaration, prop: string): void;
-    coordOfArea(id: string): MapCoord;
     pointById(id: string): DataPoint;
     canAddAnimation(): boolean;
     canRemoveAnimation(): boolean;
     _dataLoaded: boolean;
     private $_dataPointsChanged;
-    loadData(data: any, animate?: boolean): void;
+    loadData(data: any, animate?: boolean): this;
+    /**
+     * 데이터포인트를 하나 추가한다.<br/>
+     * 데이터포인트 하나를 제거하라면 {@page removePoint}를 사용한다.
+     *
+     * @param source 데이터포인트 정보
+     * @param index 추가 위치. 0보다 적으면 마지막에 추가된다.
+     * @param duration 0보다 큰값을 지정하면 애니메이션이 표시된다.
+     * @returns 생성된 데이터포인트 객체
+     */
     addPoint(source: any, index?: number, duration?: number): DataPoint;
+    /**
+     * 데이터포인트를 하나 이상 추가한다.<br/>
+     * 여러 데이터포인트 한꺼번에 제거하라면 {@page removePointList}를 사용한다.
+     *
+     * @param source 데이터포인트 정보 목록
+     * @param index 추가 위치. 0보다 적으면 마지막에 추가된다.
+     * @param duration 0보다 큰값을 지정하면 애니메이션이 표시된다.
+     * @returns 생성된 데이터포인트 객체 목록
+     */
     addPointList(source: any[], index?: number, duration?: number): DataPoint[];
+    /**
+     * 지정한 데이터포인트를 제거한다.<br/>
+     * 데이터포인트 하나를 추가하라면 {@page addPoint}를 사용한다.
+     *
+     * @param p 삭제할 데이터포인트 객체나 인덱스 또는 문자열 id
+     * @param duration 0보다 크면 삭제 애니메이션 표시
+     */
     removePoint(p: DataPoint | number | string, duration?: number): void;
     private $_points;
     private $_remove;
+    /**
+     * 복수 개 데이터포인트를 제거한다.<br/>
+     * 데이터포인트를 여러개 동시에 추가하라면 {@page addPointList}를 사용한다.
+     *
+     * @param p 삭제할 데이터포인트 객체나 인덱스 또는 문자열 id 목록.
+     * @param duration 0보다 크면 삭제 애니메이션 표시
+     */
     removePointList(points: (DataPoint | number | string)[], duration?: number): DataPoint[];
     clearPoints(duration?: number): void;
     removeFirst(duration?: number): void;
@@ -5303,12 +5507,13 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     lock(): void;
     unlock(): void;
     _setLegend(legend: object): void;
-    protected _doApply(options: SeriesOptions): void;
+    protected _doApply(op: OP): void;
     _prepareRender(): void;
     protected _doAfterRender(): void;
     protected _doMapChanged(): void;
     protected _doPrepareRender(chart: IChart, op: OP): void;
     protected abstract _createPoint(source: any): DataPoint;
+    _setIndex(index: number, seriesIndex?: number): void;
     protected $_addPoint(source: any, i: number): DataPoint;
     protected _createFielder(f: any): (v: any) => any;
     protected _createFielders(op: SeriesOptions): void;
@@ -5330,6 +5535,7 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
 declare abstract class ValuePoint extends DataPoint {
     value: number;
     protected _readObject(series: ISeries, v: any): void;
+    protected _readArray(series: ISeries, v: any[]): void;
     protected _assignTo(proxy: any): any;
     getValue(): number;
     getBaseValue(): number;
@@ -5341,11 +5547,18 @@ declare abstract class ValueSeries<OP extends ValueSeriesOptions = ValueSeriesOp
     protected _createFielders(op: ValueSeriesOptions): void;
     protected _createValueFielder(op: ValueSeriesOptions): (v: any) => any;
 }
+declare abstract class CoordBaseSeries<OP extends CoordBaseSeriesOptions = CoordBaseSeriesOptions> extends ValueSeries<OP> {
+    static defaults: CoordBaseSeriesOptions;
+    private _excludes;
+    isExcludedCoord(coord: MapCoord): boolean;
+    isExcluded(p: DataPoint): boolean;
+    protected _doApply(op: OP): void;
+}
 declare abstract class MarkerSeriesPoint extends ValuePoint {
 }
 /**
  */
-declare abstract class MarkerSeries<OP extends MarkerSeriesOptions = MarkerSeriesOptions> extends ValueSeries<OP> {
+declare abstract class MarkerSeries<OP extends MarkerSeriesOptions = MarkerSeriesOptions> extends CoordBaseSeries<OP> {
     static defaults: MarkerSeriesOptions;
 }
 declare class SparkSeriesPoint extends ValuePoint {
@@ -5371,17 +5584,18 @@ declare class SparkCategoryImpl implements ILegendSource {
 /**
  * 복수 개의 관련된 값들을 표시하는 시리즈 기반 클래스.<br/>
  */
-declare abstract class SparkSeries<OP extends SparkSeriesOptions = SparkSeriesOptions> extends ValueSeries<OP> {
+declare abstract class SparkSeries<OP extends SparkSeriesOptions = SparkSeriesOptions> extends CoordBaseSeries<OP> {
     static defaults: SparkSeriesOptions;
     _categories: SparkCategoryImpl[];
     getMinMax(points: SparkSeriesPoint[]): {
         min: number;
         max: number;
     };
-    protected _doApply(options: SparkSeriesOptions): void;
+    protected _doApply(op: OP): void;
     protected _createValueFielder(op: SparkSeriesOptions): (v: any) => any;
     getLegendSources(legend: object, list: ILegendSource[]): void;
     private $_parseCategories;
+    protected _splitColors(): string[];
 }
 declare abstract class OrthogonalSparkSeriesPoint extends SparkSeriesPoint {
 }
@@ -5410,17 +5624,17 @@ declare abstract class OrthogonalSparkSeries<OP extends OrthogonalSparkSeriesOpt
         base: number;
     };
     getPadding(domain: number): number;
-    protected _doApply(options: OrthogonalSparkSeriesOptions): void;
+    protected _doApply(op: OP): void;
 }
 declare abstract class GaugePoint extends ValuePoint {
     position: PointViewPosition;
 }
-declare abstract class Gauge<OP extends GaugeOptions = GaugeOptions> extends ValueSeries<OP> {
+declare abstract class Gauge<OP extends GaugeOptions = GaugeOptions> extends CoordBaseSeries<OP> {
     static readonly DEF_SIZE = 60;
     static defaults: GaugeOptions;
     _width: number;
     _height: number;
-    protected _doApply(op: GaugeOptions): void;
+    protected _doApply(op: OP): void;
 }
 declare abstract class ValueGauge<OP extends ValueGaugeOptions = ValueGaugeOptions> extends Gauge<OP> {
     static defaults: ValueGaugeOptions;
@@ -5429,7 +5643,7 @@ declare abstract class ValueGauge<OP extends ValueGaugeOptions = ValueGaugeOptio
     private _min;
     private _max;
     getValueRate(value: number): number;
-    protected _doApply(op: ValueGaugeOptions): void;
+    protected _doApply(op: OP): void;
     protected _doPrepareRender(chart: IChart): void;
 }
 
@@ -5498,6 +5712,7 @@ declare class DataPoint implements ISelectionSource {
     visible: boolean;
     xPos: number;
     yPos: number;
+    _excluded: boolean;
     _runColor: string;
     _zindex: number;
     private _selected;
@@ -5729,10 +5944,13 @@ declare class Credits extends ChartItem<CreditsOptions> {
 
 /**
  * 컬러, 버블 스케일 등의 스케일 기반 설정.<br/>
+ *
+ * @config chart.scale[base]
  */
 interface ScaleOptions extends MapSimpleWidgetOptions {
     /**
-     * {@page minValue}나 {@page maxValue}를 지정하지 않는 경우 범위 기준값을 계산할 시리즈의 이름이나 index.<br />
+     * {@page minValue}나 {@page maxValue}를 지정하지 않는 경우 범위 기준값을 계산할
+     * 시리즈의 {@page config.base.series#name 이름}이나 {@page Series#index}.<br />
      * 이 속성을 지정하지 않으면 첫 번째 map 시리즈의 범위를 계산한다.
      */
     series?: string | number;
@@ -5758,6 +5976,8 @@ declare const _ColorScaleLayout: {
 /** @dummy */
 type ColorScaleLayout = typeof _ColorScaleLayout[keyof typeof _ColorScaleLayout];
 /**
+ * 컬러 스케일 표시 방식.<br/>
+ *
  * @enum
  */
 declare const ColorScaleDisplays: {
@@ -5976,8 +6196,9 @@ interface ColorScaleOptions extends ScaleOptions {
      */
     steps?: ColorScaleStep[];
     /**
-     * steps가 지정되지 않고, 2 이상의 값으로 지정하면,
-     * 데이터포인트 값들을 이 속성값을 base로 하는 log 값으로 변환해서 표시한다.<br/>
+     * 2 이상의 값으로 지정하면 이 속성값을 base로 하는 log 값을 기준으로 step을 생성한다.<br/>
+     * step label은 log를 취하지 않은 원 값을 표시한다.
+     * {@page steps}가 지정된 경우 각 step의 from/to 값이 log로 계산된 값으로
      *
      * @default undefined
      */
@@ -6021,6 +6242,11 @@ interface ColorScaleOptions extends ScaleOptions {
      * 숫자로 지정하면 pixel 수, '%'로 지정하면 scale이 표시될 수 있는 최대 크기에 대한 백분율로 설정된다.
      */
     barLength?: PercentSize;
+    /**
+     * 각 step의 색상을 gradient 없이 단일 색상으로 표시한다.<br/>
+     * 스텝별로 fromColor, toColor가 지정된 경우에는 이 속성과 상관없이 gradient로 표시된다.
+     */
+    solidFill?: boolean;
 }
 /**
  * bubble 스텝을 구분하는 bubble scale 틱 라인 옵션.<br/>
@@ -6436,6 +6662,35 @@ declare class MapScale extends ScaleBase<MapScaleOptions> {
     private $_calcScale;
 }
 
+interface MapRegionTargetOptions extends ChartItemOptions {
+}
+interface MapRegionConnectorOptions extends ChartItemOptions {
+}
+interface MapRegionOptions extends PositionableItemOptions {
+    /**
+     * 원본 위치 표시 욥션.<br/>
+     */
+    target?: MapRegionTargetOptions;
+    /**
+     * {@page target}과의 연결 표시 옵션.<br/>
+     */
+    connector?: MapRegionConnectorOptions;
+    /**
+     * 이 맵리전에 표시될 {@page series}로 지정한 맵시리즈의 일부 영역을 지정한다.<br/>
+     */
+    bounds?: [MapCoord, MapCoord];
+    /**
+     * 원본 맵시리즈 이름.<br/>
+     */
+    series?: string;
+    /**
+     * region 뷰의 너비.<br/>
+     *
+     * @default 200
+     */
+    width?: number;
+}
+
 /**
  * @config chart.map
  */
@@ -6572,6 +6827,15 @@ interface ChartConfiguration {
      * {@page annotation}과 동일하고, 이 속성이 우선한다.<br/>
      */
     annotations?: AnnotationOptionsType | AnnotationOptionsType[];
+    /**
+     * {@page guide.mapregion 멥리젼} 또는 맵리젼 목록.<br/>
+     */
+    mapRegion?: MapRegionOptions | MapRegionOptions[];
+    /**
+     * @ignore
+     * {@page mapRegion}과 동일하고, 이 속성이 우선한다.<br/>
+     */
+    mapRegions?: MapRegionOptions | MapRegionOptions[];
     /**
      * 내보내기 설정.<br/>
      */
@@ -6686,6 +6950,7 @@ declare class ColorScale extends ScaleBase<ColorScaleOptions> implements IColorR
     private _endColor;
     private _colors;
     private _barLengthDim;
+    private _logBase;
     private _logger;
     private _steps;
     private _valueSteps;
@@ -6696,7 +6961,7 @@ declare class ColorScale extends ScaleBase<ColorScaleOptions> implements IColorR
     get tick(): ColorScaleTick;
     get nullStep(): ColorScaleNull;
     get minColor(): Color;
-    get maxColor(): Color;
+    get endColor(): Color;
     getRanger(): IColorRanger;
     getLayout(): ColorScaleLayout;
     getBarSize(wDomain: number, hDomain: number, vertical: boolean): ISize;
@@ -6704,8 +6969,8 @@ declare class ColorScale extends ScaleBase<ColorScaleOptions> implements IColorR
     getPosition(value: number): number;
     getTicks(): IColorScaleTick[];
     getSteps(): ColorScaleStep[];
-    getValueSteps(): number[];
     getLegendSources(target: ILegendSource[]): void;
+    _buildSteps(): void;
     _type(): string;
     isVertical(): boolean;
     getDefaultDisplay(caption: MapWidgetCaption): MapWidgetCaptionDisplay;
@@ -6713,9 +6978,7 @@ declare class ColorScale extends ScaleBase<ColorScaleOptions> implements IColorR
     protected _getScaledSeries(chart: IChart): ISeries;
     private $_parseColorStops;
     protected _doPrepareRender(chart: IChart, op: ColorScaleOptions): void;
-    _buildSteps(): void;
     private $_parseValue;
-    private $_normalizeMin;
     private $_parseColor;
     private $_buildSteps;
 }
@@ -6919,7 +7182,7 @@ declare class ZoomPanel extends BodyPanel<ZoomPanelOptions> {
     static defaults: ZoomPanelOptions;
     get vertical(): boolean;
     getButtonSize(): ISize;
-    getZoomStep(): number;
+    getZoomFactor(): number;
     protected _isVisible(): boolean;
 }
 declare class DrilldownPanel extends BodyPanel<DrilldownPanelOptions> {
@@ -6957,6 +7220,7 @@ declare class MapSeriesPoint extends ValuePoint {
     getLabel(index: number): string;
     getParam(param: string): any;
     _valuesChanged(prev: any): boolean;
+    setSelected(selected: boolean): void;
 }
 declare class MapSeriesDrilldown extends ChartItem<DrilldownOptions> {
     static defaults: DrilldownOptions;
@@ -7023,7 +7287,7 @@ declare class MapSeries extends ValueSeries<MapSeriesOptions> {
     getMapBorders(): MapSeriesBorder[];
     isHiddenArea(areaId: string): MapArea;
     getHistory(): MapSeries[];
-    get(second: boolean, index: number): MapArea;
+    get(index: number): MapArea;
     pointOf(area: MapArea): MapSeriesPoint;
     pointByProp(prop: string, value: any): MapSeriesPoint;
     getBounds(projection: ProjectionType): IRect;
@@ -7035,6 +7299,7 @@ declare class MapSeries extends ValueSeries<MapSeriesOptions> {
     getDetailed(): MapSeries;
     showDetail(): void;
     showParent(): void;
+    isMapSeries(): boolean;
     protected _createLabel(chart: IChart): DataPointLabel;
     private $_createDetail;
     protected _doLoad(options: ChartItemOptions, source: any): void;
@@ -7053,9 +7318,73 @@ declare class MapSeries extends ValueSeries<MapSeriesOptions> {
     setCalcedColor(cs: CSSStyleDeclaration, prop: string): void;
     getColorScale(): string | number;
     canSelect(): boolean;
+    select(p: ISelectionSource): void;
     private $_loadBorders;
 }
 
+declare class MapRegionTarget extends ChartItem<MapRegionTargetOptions> {
+}
+declare class MapRegionConnector extends ChartItem<MapRegionConnectorOptions> {
+}
+/**
+ * 맵리젼 모델.<br/>
+ * {@page options 옵션} 모델은 {@page op.MapRegionOptions}이고,
+ * {@page config 맵차트 설정}에서 {@page config.mapregion 'mapRegion'} 항목으로 설정한다.
+ * ```js
+ * const config = {
+ *      mapRegion: [{
+ *          name: 'region1',
+ *          bounds: [[lon1, lat1], [lon2, lat2]],
+ *      }],
+ * };
+ * ```
+ * 또, Chart.{@page rm.Chart#getmapregion getMapRegion}으로
+ * 모델 객체를 가져올 수 있다.
+ * ```js
+ * const region = chart.getMapRegion('region1');
+ * region.visible = false;
+ * ```
+ * {@page guide.mapregions MapRegion 개요} 페이지를 참조한다.
+ *
+ */
+declare class MapRegion extends PositioanbleItem<MapRegionOptions> {
+    inBody: boolean;
+    static defaults: MapRegionOptions;
+    private _target;
+    private _connector;
+    private _map;
+    private _zoom;
+    private _panX;
+    private _panY;
+    scroll: number;
+    private _scale;
+    private _vRect;
+    private _wMap;
+    constructor(chart: IChart, inBody: boolean);
+    protected _doInit(op: MapRegionOptions): void;
+    get target(): MapRegionTarget;
+    get connector(): MapRegionConnector;
+    prepareLayout(width: number, height: number): {
+        scale: number;
+        wMap: number;
+        hMap: number;
+        tx: number;
+        ty: number;
+    };
+    refresh(): void;
+    protected _getNamePrefix(): string;
+    protected _doPrepareRender(chart: IChart, op: MapRegionOptions): void;
+    private $_calcPan;
+    private $_prepareLayout;
+}
+/**
+ * @internal
+ */
+declare class MapRegionCollection extends PositionalItemCollection<MapRegion> {
+    getRegion(name: string): MapRegion;
+    protected _loadItem(chart: IChart, src: any, index: number, inBody: boolean): MapRegion;
+}
+
 declare class MapBackground extends ChartItem<MapBackgroundOptions> {
     static defaults: MapBackgroundOptions;
     isVisible(): boolean;
@@ -7089,6 +7418,7 @@ declare class Body extends ChartItem<BodyOptions> implements IAnnotationOwner {
     private _scale;
     private _vRect;
     private _wMap;
+    private _rawScroll;
     constructor(chart: IChart);
     protected _doInit(op: BodyOptions): void;
     anchorByName(name: string): ChartItem;
@@ -7166,10 +7496,11 @@ declare class Body extends ChartItem<BodyOptions> implements IAnnotationOwner {
     /**
      * coord는 projection 하지 않은 값.
      */
-    toVisible(coord: MapCoord, second: boolean): MapCoord;
+    toVisible(coord: MapCoord): MapCoord;
     isScrollable(): boolean;
     setZoom(value: number, duration?: number | AnimationOptions | (() => void)): void;
     incZoom(delta: number): void;
+    zoomByFactor(factor: number, animate?: boolean): void;
     _canSetZoom(value: number): boolean;
     /**
      * 지정한 좌표로 zoom하고 area center로 이동한다.
@@ -7190,7 +7521,11 @@ declare class Body extends ChartItem<BodyOptions> implements IAnnotationOwner {
     /**
      * 떨어진 두 위치로 정해지는 영역이 모두 표시되도록 zoom(in/out)하고 영역 중앙으로 이동한다.<br/>
      */
-    zoomToBounds(from: MapCoord, to: MapCoord, duration?: number): void;
+    zoomToBounds(from: MapCoord, to: MapCoord, duration?: number, ratio?: number): void;
+    calcZoomInfo(from: MapCoord, to: MapCoord, ratio: number): {
+        center: MapCoord;
+        zoom: number;
+    };
     /**
      * 지정한 지점이나 area의 center가 중앙이 되도록 이동한다.
      *
@@ -7202,7 +7537,7 @@ declare class Body extends ChartItem<BodyOptions> implements IAnnotationOwner {
     getAnnotation(name: string): Annotation;
     updateOption(prop: keyof BodyOptions, value: any, render?: boolean): this;
     updateOptions(source?: BodyOptions, render?: boolean): this;
-    protected _doApply(options: BodyOptions): void;
+    protected _doApply(op: BodyOptions): void;
     protected _doPrepareRender(chart: IChart): void;
     _getZoom(): number;
 }
@@ -7249,6 +7584,7 @@ declare class ChartObject extends RmEventProvider<IMapChartEvents> implements IC
     private _baseMap;
     private _series;
     _annotations: AnnotationCollection;
+    _mapRegions: MapRegionCollection;
     _widgetGroups: MapWidgetGroupCollection;
     _legends: LegendCollection;
     _colorScales: ColorScaleCollection;
@@ -7283,11 +7619,10 @@ declare class ChartObject extends RmEventProvider<IMapChartEvents> implements IC
     _optionChanged(item: ChartItem, tag?: any): void;
     animatable(): boolean;
     loadAnimatable(): boolean;
-    isVisible(coord: MapCoord): boolean;
     requestShowSeries(series: Series, visible: boolean): void;
     _selectionChanged(series: ISeries, p: DataPoint): void;
     getNextPointShape(): Shape;
-    getProjection(second: boolean): MapProjection;
+    getProjection(): MapProjection;
     projectionChanged(): void;
     zoomChanged(oldZoom: number): void;
     mapChanged(map: MapModel): void;
@@ -7323,6 +7658,8 @@ declare class ChartObject extends RmEventProvider<IMapChartEvents> implements IC
     get isDirty(): boolean;
     get isDrilldowned(): boolean;
     getAnnotations(): Annotation[];
+    getMapRegions(): MapRegion[];
+    coordOfArea(id: string): MapCoord;
     requestRender(now: boolean): void;
     mapByName(name: string): MapModel;
     mapAt(index: number): MapModel;
@@ -7333,6 +7670,7 @@ declare class ChartObject extends RmEventProvider<IMapChartEvents> implements IC
     seriesAt(index: number): Series;
     seriesByPoint(point: DataPoint): Series;
     annotationByName(name: string): Annotation;
+    mapRegionByName(name: string): MapRegion;
     _collectWidgets(): {
         [dir: string]: MapWidget<MapWidgetOptions>[];
     };
@@ -7398,10 +7736,10 @@ interface IChart {
     assignTemplates(target: any): any;
     projectionChanged(): void;
     zoomChanged(oldZoom: number): void;
+    coordOfArea(id: string): MapCoord;
     seriesByName(series: string): Series;
     seriesAt(index: number): Series;
     getSeries(series: string | number): Series;
-    isVisible(coord: MapCoord): boolean;
     getColorScale(scale: string | number): ColorScale;
     requestShowSeries(series: Series, visible: boolean): void;
     isDrilldowned: boolean;
@@ -7409,7 +7747,7 @@ interface IChart {
     drillup(series?: Series): void;
     _getSeriesType(type: string): any;
     _getAnnotationType(type: string): any;
-    getProjection(second: boolean): MapProjection;
+    getProjection(): MapProjection;
     _visibleChanged(item: ChartItem): void;
     _optionChanged(item: ChartItem, tag?: any): void;
     _getLegendSources(legend: object): ILegendSource[];
@@ -7466,7 +7804,7 @@ declare class ChartItem<OP extends ChartItemOptions = ChartItemOptions> extends
      *
      * @param prop 설정 항목 이름
      * @param value 설정 값
-     * @param render true로 지정하면 옵션 변경 시 맵차트를 다시 그린다. 기본갑 true
+     * @param render true로 지정하면 옵션 변경 시 맵차트를 다시 그린다. 기본값: true
      * @returns 모델 객체 자신
      */
     updateOption(prop: keyof OP, value: any, render?: boolean): this;
@@ -7627,23 +7965,60 @@ declare class MapWidgetGroup extends MapWidget<MapWidgetGroupOptions> {
     isVertical(): boolean;
 }
 declare abstract class MapWidgetCollection<T extends MapWidget = MapWidget> extends ChartItemCollection<T> {
-    private _map;
+    private _dic;
     protected _visibles: T[];
     getVisibles(loc: ChartItemLocation): T[];
     get(name: string | number, loc: ChartItemLocation): T;
     find(name: string | number, force: boolean): T;
     beforeRender(): void;
-    protected _collectVisibles(): void;
     prepareRender(): void;
     load(src: any): void;
     protected abstract _collectionProp(): string;
     protected abstract _createWidget(chart: IChart): T;
     protected _canEmpty(): boolean;
     private $_loadItem;
+    protected _collectVisibles(): void;
 }
 declare class MapWidgetGroupCollection extends MapWidgetCollection<MapWidgetGroup> {
     protected _collectionProp(): string;
     protected _createWidget(chart: IChart): MapWidgetGroup;
+    beforeRender(): void;
+}
+declare abstract class PositioanbleItem<OP extends PositionableItemOptions = PositionableItemOptions> extends ChartItem<OP> {
+    static defaults: PositionableItemOptions;
+    index: number;
+    private _name;
+    private _widthDim;
+    private _heightDim;
+    private _offsetXDim;
+    private _offsetYDim;
+    private _offsetX;
+    private _offsetY;
+    /**
+     * 아이템 이름.<br/>
+     * 동적으로 아이템을 다루기 위해서는 반드시 지정해야 한다.
+     */
+    get name(): string;
+    getOffset(w: number, h: number): IPoint;
+    getSize(wDomain: number, hDomain: number): ISize;
+    getPosition(left: number, top: number, wDomain: number, hDomain: number, width: number, height: number): IPoint;
+    protected _doApply(options: PositionableItemOptions): void;
+    protected abstract _getNamePrefix(): string;
+    protected _getDefaultAlign(): string;
+}
+/**
+ * @internal
+ */
+declare abstract class PositionalItemCollection<T extends PositioanbleItem> extends ChartItemCollection<T> {
+    protected _map: {
+        [name: string]: T;
+    };
+    protected _visibles: T[];
+    getVisibles(): T[];
+    get(name: string | number): T;
+    load(src: any, inBody: boolean): void;
+    prepareRender(): void;
+    protected abstract _loadItem(chart: IChart, src: any, index: number, inBody: boolean): T;
 }
 /**
  * color, bubble 스케일 base.<br/>
@@ -7677,45 +8052,22 @@ declare abstract class ScaleBase<OP extends ScaleOptions = ScaleOptions> extends
  * {@page guide.annotations Annotation 개요} 페이지를 참조한다.
  *
  */
-declare abstract class Annotation<OP extends AnnotationOptions = AnnotationOptions> extends ChartItem<OP> {
+declare abstract class Annotation<OP extends AnnotationOptions = AnnotationOptions> extends PositioanbleItem<OP> {
     inBody: boolean;
     static register(...clses: typeof Annotation<AnnotationOptions>[]): void;
     static readonly type: string;
     static defaults: AnnotationOptions;
-    private _width;
-    private _height;
-    private _offsetX;
-    private _offsetY;
-    index: number;
-    private _name;
-    private _widthDim;
-    private _heightDim;
-    private _offsetXDim;
-    private _offsetYDim;
-    _x: number;
-    _y: number;
-    _w: number;
-    _h: number;
     _anchorObj: ChartItem;
     constructor(chart: IChart, inBody: boolean);
     _type(): string;
-    /**
-     * 어노테이션 이름.<br/>
-     * 동적으로 어노테이션을 다루기 위해서는 반드시 지정해야 한다.
-     *
-     * @config
-     */
-    get name(): string;
     /**
      * 처음 표시될 때 실행될 에니메이션 설정 정보.
      */
-    getOffset(w: number, h: number): IPoint;
-    getSize(wDomain: number, hDomain: number): ISize;
-    getPosition(left: number, top: number, wDomain: number, hDomain: number, width: number, height: number): IPoint;
     refresh(): void;
+    protected _getNamePrefix(): string;
     _load(source: any): OP;
-    protected _doApply(options: AnnotationOptions): void;
     protected _doPrepareRender(chart: IChart, op: AnnotationOptions): void;
+    protected _getDefaultAlign(): string;
 }
 /**
  * @internal
@@ -7730,17 +8082,13 @@ interface IAnnotationOwner {
 /**
  * @internal
  */
-declare class AnnotationCollection extends ChartItemCollection<Annotation> {
+declare class AnnotationCollection extends PositionalItemCollection<Annotation> {
     owner: IAnnotationOwner;
-    private _map;
-    private _visibles;
     constructor(owner: IAnnotationOwner);
-    getVisibles(): Annotation[];
     getAnnotation(name: string): Annotation;
-    get(name: string | number): Annotation;
     load(src: any, inBody: boolean): void;
     prepareRender(): void;
-    private $_loadItem;
+    protected _loadItem(chart: IChart, src: any, index: number, inBody: boolean): Annotation;
 }
 
 /**
@@ -7754,7 +8102,7 @@ interface LoadCallbackArgs extends CommonCallbackArgs {
 declare class MapChart {
     _obj: ChartObject;
     private _modelCallback;
-    _loadCallback: (param: LoadCallbackArgs) => void;
+    _loadCallback: (args: LoadCallbackArgs) => void;
     private _loaded;
     constructor(config?: ChartConfiguration, callback?: (model: ChartObject, oldModel: ChartObject) => void);
     /**
@@ -7870,7 +8218,7 @@ declare class MapChart {
      *
      * @param config 맵차트 설정 정보
      */
-    load(config: ChartConfiguration, loadAnimation?: boolean, callback?: (param: LoadCallbackArgs) => void): MapChart;
+    load(config: ChartConfiguration, loadAnimation?: boolean, callback?: (args: LoadCallbackArgs) => void): MapChart;
     /**
      * load 메서드의 async 버전. <br/>
      *
@@ -7937,6 +8285,16 @@ declare class MapChart {
     getPoint(id: string): MapCoord;
     seriesAt(index: number): Series;
     seriesByName(name: string): Series;
+    /**
+     * 픽셀 좌표를 경위도 좌표로 변환한다. <br/>
+     * 픽셀 좌표는 맵차트 영역의 왼쪽 위 모서리를 (0,0)으로 하는 좌표계이다. <br/>
+     * 차트가 아직 그려지지 않은 상태에서는 NaN이 담긴 배열을 반환하는 점에 주의.<br/>
+     * LoadCallback이 호출된 시점부터 이용할 수 있다.
+     *
+     * @param x 픽셀 X 좌표
+     * @param y 픽셀 Y 좌표
+     * @returns 경위도 좌표 [lon, lat]
+     */
     pointToMap(x: number, y: number): MapCoord;
     drilldown(series?: number | string | MapSeries, area?: string): Promise<void>;
     drillup(series?: number | string | MapSeries): Promise<void>;
@@ -8095,7 +8453,7 @@ declare class ImageElement extends RmElement {
      * @IE11 image proxy onload event
      */
     onloadProxy: () => void;
-    constructor(doc: Document, full: boolean, styleName?: string);
+    constructor(doc: Document, styleName?: string, full?: boolean);
     /** image url */
     get url(): string;
     set url(value: string);
@@ -8191,8 +8549,6 @@ declare abstract class MapWidgetView<T extends MapWidget = MapWidget> extends Bo
 
 interface IAnnotationAnchorOwner {
     getAnnotationAnchor(model: any): RmElement;
-    tx: number;
-    ty: number;
 }
 /**
  * [주의] clipping하기 위해 translate를 background와 내부 view에 설정한다.
@@ -8351,15 +8707,6 @@ declare class PolyLineElement extends PathElement {
     setLines(pts: (number | MapCoord | IPoint)[], curved: boolean): void;
 }
 
-declare class HoverAnimation extends RmAnimation {
-    private _series;
-    _focused: boolean;
-    _marker: MarkerSeriesPointView;
-    constructor(sv: SeriesView<Series>, marker: MarkerSeriesPointView, focused: boolean, endHandler: RmAnimationEndHandler);
-    protected _doStart(): void;
-    protected _doUpdate(rate: number): boolean;
-    protected _doStop(): void;
-}
 interface IPointView {
     point: DataPoint;
     tooltipColor(): string;
@@ -8428,6 +8775,11 @@ declare abstract class PointElement<T extends DataPoint = DataPoint> extends Pat
     point: T;
     constructor(doc: Document, group?: boolean);
     tooltipColor(): string;
+    /**
+     * 데이터포인트 라벨과 view 표시 동기화 #361
+     * - point가 보이지 않으면 label도 숨긴다.
+     */
+    setVisible(value: boolean): boolean;
     protected _drawSpline(pts: {
         x: number;
         y: number;
@@ -8440,9 +8792,6 @@ declare class PointContainer extends LayerElement {
 }
 type PointPositioner = (x: number, y: number, wPoint: number, hPoint: number) => IPoint;
 type LabelPositioner = (x: number, y: number, rLabel: IRect, wPoint: number, hPoint: number, off: number) => IPoint;
-interface ISeriesViewOwner {
-    getSiblingOf(sv: SeriesView): SeriesView;
-}
 /**
  * @internal
  *
@@ -8464,7 +8813,7 @@ declare abstract class SeriesView<T extends Series = Series> extends ChartElemen
     protected _labelPositioner: {
         [pos: string]: LabelPositioner;
     };
-    _second: boolean;
+    protected _scroll: number;
     _h1: number;
     _h2: number;
     private _defs;
@@ -8477,38 +8826,43 @@ declare abstract class SeriesView<T extends Series = Series> extends ChartElemen
     private _posRate;
     protected _prevRate: number;
     _animations: Animation[];
-    _hoverAnis: HoverAnimation[];
     _hoverPts: IPointView[];
     protected _wBody: number;
     protected _hBody: number;
+    protected _transInfo: IBodyTransform;
+    protected _inRegion: boolean;
     protected _dirty: boolean;
     _scale: number;
     protected _scaler: (coord: MapCoord) => MapCoord;
     _aniOpacity: number;
     constructor(doc: Document, className: string, needLabels: boolean, useDefs: boolean);
-    get owner(): ISeriesViewOwner;
+    $_setInRegion(): this;
+    needClip(): boolean;
     secondLabelContainer(): LayerElement;
     protected _setCalcedColor(model: T, dom: Element): void;
     protected _setModelColor(color: string): void;
-    prepareModel(doc: Document, model: T): void;
+    prepareModel(doc: Document, model: T, scroll: number): void;
     prepareLayout(doc: Document): void;
-    render(wBody: number, hBody: number): void;
+    render(wBody: number, hBody: number, transInfo: IBodyTransform): void;
     reset(): void;
     isPointLabelVisible(p: DataPoint): boolean;
     isPointCalloutVisible(p: DataPoint): boolean;
     setScaler(scaler: (coord: MapCoord) => MapCoord): void;
-    getPointView(dom: Element): IPointView;
+    getPointView(dom: Element, x: number, y: number, hitTesting: boolean): IPointView;
     pointerMoved(x: number, y: number, dom: Element): boolean;
-    setHoverStyle(pv: RmElement): void;
     defaultAnimation(): string;
     setGrowRate(rate: number): void;
     setPosRate(rate: number): void;
     setPrevRate(rate: number): void;
-    pointByDom(elt: Element): IPointView;
-    click(elt: Element): void;
-    select(elt: Element, clear: boolean): void;
-    toggleSelect(elt: Element): void;
+    pointByDom(elt: Element, p: IPoint): IPointView;
+    click(elt: Element, p: IPoint): void;
+    select(elt: Element, p: IPoint, clear: boolean): void;
+    toggleSelect(elt: Element, p: IPoint): void;
     runPointAddAnimation(p: DataPoint): void;
+    /**
+     * 데이터포인트와 연결된 라벨 표시/숨김 처리 #361
+     */
+    setPointLabelVisible(point: DataPoint, visible: boolean): void;
     protected abstract _doPrepeare(doc: Document, model: T, dataDirty: boolean): void;
     protected abstract _doRender(width: number, height: number): void;
     protected abstract _doReset(): void;
@@ -8553,6 +8907,8 @@ declare abstract class MarkerSeriesView<T extends MarkerSeries = MarkerSeries> e
 }
 
 interface IBodyViewOwner {
+    tx: number;
+    ty: number;
     showTooltip(series: Series, pv: IPointView, map: RmElement, p: IPoint): void;
     hideTooltip(): void;
     tooltipVisible(): boolean;
@@ -8567,20 +8923,15 @@ declare class BodyView extends ChartElement<Body> implements IAnnotationAnchorOw
     private _mapBack;
     private _contentLayer;
     private _axisGuideContainer;
-    private _secondAxisGuideContainer;
     private _seriesContainer;
-    private _secondContainer;
     private _annotationContainer;
     private _frontAnnotationContainer;
     _annotationViews: AnnotationView<Annotation>[];
     private _annotationMap;
     private _annotations;
     private _frontAxisGuideContainer;
-    private _secondFrontAxisGuideContainer;
+    private _feedbackContainer;
     private _crosshairView;
-    private _seconded;
-    private _h1;
-    private _h2;
     private _clip;
     private _clipMap;
     private _requestShow;
@@ -8593,8 +8944,6 @@ declare class BodyView extends ChartElement<Body> implements IAnnotationAnchorOw
     get isProjectionChanged(): boolean;
     getSeries(series: Series): SeriesView<Series<SeriesOptions>>;
     prepare(doc: Document, model: Body): void;
-    protected _doMeasure(doc: Document, model: Body, hintWidth: number, hintHeight: number): ISize;
-    protected _doLayout(param: any): void;
     afterRender(): void;
     clean(): void;
     reset(): void;
@@ -8603,6 +8952,12 @@ declare class BodyView extends ChartElement<Body> implements IAnnotationAnchorOw
     seriesByDom(dom: Element): SeriesView;
     showSeries(series: Series): void;
     hideSeries(series: Series): void;
+    getBackBounds(): DOMRect;
+    addFeedback(view: RmElement): void;
+    onScrollStart(): void;
+    onScrollEnd(): void;
+    protected _doMeasure(doc: Document, model: Body, hintWidth: number, hintHeight: number): ISize;
+    protected _doLayout(param: any): void;
     /**
      * 클릭된 픽셀 좌표(x, y)를 경위도 좌표로 변환한다.<br/>
      * 픽셀 좌표는 BodyView의 Dom 노드의 오프셋 좌표여야 한다.
@@ -8619,14 +8974,27 @@ declare class BodyView extends ChartElement<Body> implements IAnnotationAnchorOw
      * @param point 픽셀 좌표
      * @returns 경위도 좌표
      */
-    mouseToMap(point: IPoint): MapCoord;
-    pointToMap(x: number, y: number): MapCoord;
+    mouseToMap(point: IPoint, ignoreScroll?: boolean, ignorePadding?: boolean): MapCoord;
+    boundsToMap(r: IRect, ignoreScroll?: boolean, ignorePadding?: boolean): {
+        from: MapCoord;
+        to: MapCoord;
+    };
+    pointToMap(x: number, y: number, ignoreScroll: boolean): MapCoord;
+    mapToPoint(coord: MapCoord): IPoint;
+    boundsByCoord(coordFrom: MapCoord, coordTo: MapCoord): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
     private $_prepareSeries;
     private $_prepareLayoutSeries;
     private $_prepareAnnotations;
     private $_layoutAnnotations;
     private $_layoutAxisGuides;
     /**
+     * @private
+     *
      * 스크롤 상황인 경우에 한해 클리핑 적용.
      *
      * 단, 프로젝션에서 클리핑을 지원해야 적용할 수 있다.
@@ -8634,7 +9002,7 @@ declare class BodyView extends ChartElement<Body> implements IAnnotationAnchorOw
      *
      * 프로젝션이 변경된 경우, 클리핑 영역을 갱신한다.
      */
-    private $_doClipPathLayout;
+    private $_layoutClip;
 }
 
 declare class TitleView extends BoundableElement<Title> {
@@ -8711,9 +9079,13 @@ declare class ChartView extends LayerElement implements IAnnotationAnchorOwner {
     private _widgetLayer;
     private _widgetMap;
     private _frontAnnotationContainer;
+    private _mapRegionContainer;
     private _annotationViews;
     private _annotationMap;
     private _annotations;
+    private _mapRegionViews;
+    private _mapRegionMap;
+    private _mapRegions;
     private _zoomPanelView;
     private _drilldownPanelView;
     private _mapScaleView;
@@ -8744,8 +9116,11 @@ declare class ChartView extends LayerElement implements IAnnotationAnchorOwner {
     buttonClicked(button: ButtonElement): void;
     updateAnnotation(anno: Annotation): void;
     isAnimating(): void;
+    onScrollStart(): void;
     private $_prepareAnnotations;
     private $_layoutAnnotations;
+    private $_prepareMapRegions;
+    private $_layoutMapRegions;
     private $_layoutPanel;
 }
 
@@ -8817,13 +9192,16 @@ declare class BarSeries extends OrthogonalSparkSeries<BarSeriesOptions> {
     static type: string;
     static defaults: BarSeriesOptions;
     private _subLabel;
+    private _fieldColors;
     protected _doInit(op: BarSeriesOptions): void;
     get subLabel(): DataPointLabel<DataPointLabelOptions>;
     get reversed(): boolean;
+    getFieldColors(): string[];
     pointLabelCount(): number;
     protected _createPoint(source: any): BarSeriesPoint;
     protected _defLabelOff(): number;
     protected _createLegendMarker(doc: Document, size: number): RmElement;
+    setCalcedColor(cs: CSSStyleDeclaration, prop: string): void;
 }
 
 declare class BubbleSeriesPoint extends MarkerSeriesPoint {
@@ -9147,7 +9525,7 @@ declare class FigureSeriesImage extends ChartItem<FigureSeriesImageOptions> {
  * {@page op.SeriesOptions#type}은 {@page config.series.figure 'figure'}이고,
  * {@page options 설정} 모델은 {@page op.FigureSeriesOptions}이다.
  */
-declare class FigureSeries extends ValueSeries<FigureSeriesOptions> {
+declare class FigureSeries extends CoordBaseSeries<FigureSeriesOptions> {
     static type: string;
     static defaults: FigureSeriesOptions;
     private _innerLabel;
@@ -9252,7 +9630,7 @@ declare class PanelSeriesBody extends PanelSeriesSection<PanelSeriesBodyOptions>
  * {@page op.SeriesOptions#type}은 {@page config.series.point 'panel'}이고,
  * {@page options 설정} 모델은 {@page op.PanelSeriesOptions}이다.
  */
-declare class PanelSeries extends ValueSeries<PanelSeriesOptions> {
+declare class PanelSeries extends CoordBaseSeries<PanelSeriesOptions> {
     static readonly DEF_MIN_WIDTH = 80;
     static readonly DEF_MIN_HEIGHT = 50;
     static type: string;
@@ -9299,13 +9677,16 @@ declare class PieSeries extends SparkSeries<PieSeriesOptions> {
     _totalRad: number;
     private _radiusDim;
     private _thresholds;
+    private _fieldColors;
     getRadius(domain: number): number;
     hasThreshold(): PieSeriesThresholdImpl[];
     getThreshold(value: number): PieSeriesThresholdImpl;
+    getFieldColors(): string[];
     protected _createPoint(source: any): PieSeriesPoint;
     protected _defLabelOff(): number;
     protected _doApply(options: PieSeriesOptions): void;
     protected _doPrepareRender(chart: IChart, op: PieSeriesOptions): void;
+    setCalcedColor(cs: CSSStyleDeclaration, prop: string): void;
     private $_parseThresholds;
 }
 
@@ -9525,7 +9906,9 @@ declare class HtmlAnnotation extends Annotation<HtmlAnnotationOptions> {
     setParams(params: object): void;
     applyParams(target: string): string;
     /**
-     * ${param;default}
+     * ${param;default;format;type} 형식으로 지정한다.
+     * 첫번째 param만 필수값이다.
+     * type이 지정되지 않으면 먼저 숫자로 변경되는 지 판단해서 format에 지정된 숫자 형식으로 변환한다.
      */
     private $_apply;
     protected _isVisible(): boolean;
@@ -9820,4 +10203,4 @@ declare const createChartAsync: typeof Globals.createChartAsync;
 declare const preset: typeof Globals.preset;
 declare const setLicenseKey: typeof Globals.setLicenseKey;
 
-export { Align, Annotation, AnnotationAnimationOptions, AnnotationOptions, AnnotationOptionsType, AnnotationView, AssetItemOptions, AssetOptionsType, BackgroundImageOptions, BandSeriesOptions, BandSeriesType, BarSeries, BarSeriesOptions, Body, BodyView, BubbleSeries, BubbleSeriesOptions, ChartAnnotationOptions, ChartAnnotationType, ChartConfiguration, ChartControl, ChartElement, ChartItem, ChartItemOptions, ChartObject, ChartOptionsOptions, ChartTextOptions, ChartView, CircleElement, CircleGauge, ClockGauge, Color, ColorListOptions, ColorRanger, Credits, CreditsOptions, DataPoint, DataPointArgs as DataPointCallbackArgs, DataPointLabel, DataPointLabelOptions, Dom, DragTracker, ElementPool, ExportOptions, Exporter, ExporterOptions, ExternalModuleManager, FeatureSeriesLabelOptions, FeatureSeriesOptions, FeatureSeriesType, FigureSeries, GradientOptions, HeatmapSeriesOptions, HeatmapSeriesType, HtmlAnnotation, IChart, ILegendSource, IPercentSize, IPointView, IRect, ISeries, ISize, IconedTextOptions, ImageAnnotation, ImageAnnotationOptions, ImageListOptions, ImageSeries, LayerElement, Legend, LegendOptions, LineElement, LineSeries, LineSeriesOptions, LinearGradientOptions, LoadCallbackArgs, MapArea, MapAxis, MapAxisBandGuide, MapAxisGuide, MapAxisLineGuide, MapAxisRangeGuide, MapChart, MapCoord, MapCrosshair, MapInset, MapInsetDisplay, MapProjection, MapSeries, MapSeriesLabelOptions, MapSeriesOptions, MapSeriesType, MapTool, MapBackgroundOptions as MapViewBackgroundOptions, BodyOptions as MapViewOptions, MarkerSeries, MarkerSeriesOptions, MarkerSeriesPoint, MarkerSeriesPointView, MarkerSeriesView, ORG_ANGLE, OrthogonalSparkSeries, PI_2, PanelSeries, PathElement, PatternOptions, PercentSize, PieSeries, PieSeriesOptions, PinSeries, PointElement, PointLabelView, PointSeries, PointViewPool, PointViewPosition, PolyLineElement, ProjectionType, RAD_DEG, RadialGradientOptions, RectElement, RmElement, RouteSeries, RouteSeriesOptions, RouteSeriesType, SVGStyleOrClass, SVGStyles, SankeySeriesOptions, SankeySeriesType, SectionView, SectorElement, Series, SeriesAnimation, SeriesOptions, SeriesOptionsType, SeriesView, Shape, ShapeAnnotation, ShapeAnnotationOptions, ShapeDrawer, Size, SparkSeries, Subtitle, SubtitleOptions, TableSeriesOptions, TableSeriesType, TextAnchor, TextAnnotation, TextAnnotationOptions, TextElement, TextLayout, TiledWebSeriesOptions, TiledWebSeriesType, Title, TitleOptions, TooltipOptions, TrackSeriesOptions, TrackSeriesOutlineOptions, TrackSeriesType, Utils, ValuePoint, ValueSeries, VectorSeriesOptions, VectorSeriesType, WaffleSeries, _isIE, absv, assignObj, calcPercent, copyObj, cos, createChart, createChartAsync, createRect, extend, fixnum, getDistance, getVersion, incv, isArray, isEmptyRect, isObject, isString, maxv, minv, parsePercentSize, pickNum, pickProp, pickProp3, pixel, preset, rectToSize, setDebugging, setGlobals, setLicenseKey, setLogging, sin };
+export { Align, Annotation, AnnotationAnimationOptions, AnnotationOptions, AnnotationOptionsType, AnnotationView, AssetItemOptions, AssetOptionsType, BackgroundImageOptions, BandSeriesOptions, BandSeriesType, BarSeries, BarSeriesOptions, Body, BodyView, BubbleSeries, BubbleSeriesOptions, ChartAnnotationOptions, ChartAnnotationType, ChartConfiguration, ChartControl, ChartElement, ChartItem, ChartItemOptions, ChartObject, ChartOptionsOptions, ChartTextOptions, ChartView, CircleElement, CircleGauge, ClockGauge, Color, ColorListOptions, ColorRanger, CoordBaseSeries, Credits, CreditsOptions, DEG_RAD, DataPoint, DataPointArgs as DataPointCallbackArgs, DataPointLabel, DataPointLabelOptions, Dom, DragTracker, ElementPool, ExportOptions, Exporter, ExporterOptions, ExternalModuleManager, FeatureSeriesLabelOptions, FeatureSeriesOptions, FeatureSeriesType, FigureSeries, GLPointSeriesOptions, GLPointSeriesType, GLSeriesOptions, GradientOptions, HeatmapSeriesOptions, HeatmapSeriesType, HtmlAnnotation, IChart, ILegendSource, IPercentSize, IPointView, IRect, ISeries, ISize, IconedTextOptions, ImageAnnotation, ImageAnnotationOptions, ImageElement, ImageListOptions, ImageSeries, LayerElement, Legend, LegendOptions, LineElement, LineSeries, LineSeriesOptions, LinearGradientOptions, LoadCallbackArgs, MapArea, MapAxis, MapAxisBandGuide, MapAxisGuide, MapAxisLineGuide, MapAxisRangeGuide, MapChart, MapCoord, MapCrosshair, MapInset, MapInsetDisplay, MapProjection, MapSeries, MapSeriesLabelOptions, MapSeriesOptions, MapSeriesType, MapTool, MapBackgroundOptions as MapViewBackgroundOptions, BodyOptions as MapViewOptions, MarkerSeries, MarkerSeriesOptions, MarkerSeriesPoint, MarkerSeriesPointView, MarkerSeriesView, ORG_ANGLE, OrthogonalSparkSeries, PI, PI_2, PanelSeries, PathElement, PatternOptions, PercentSize, PieSeries, PieSeriesOptions, PinSeries, PointElement, PointLabelView, PointSeries, PointViewPool, PointViewPosition, PolyLineElement, ProjectionType, RAD_DEG, RadialGradientOptions, RectElement, RegionSeriesOptions, RegionSeriesType, RmElement, RouteSeries, RouteSeriesOptions, RouteSeriesType, SVGStyleOrClass, SVGStyles, SankeySeriesOptions, SankeySeriesType, SectionView, SectorElement, Series, SeriesAnimation, SeriesOptions, SeriesOptionsType, SeriesView, Shape, ShapeAnnotation, ShapeAnnotationOptions, ShapeDrawer, Size, SparkSeries, Subtitle, SubtitleOptions, TableSeriesOptions, TableSeriesType, TextAnchor, TextAnnotation, TextAnnotationOptions, TextElement, TextLayout, TileWebProvider, TiledWebSeriesOptions, TiledWebSeriesType, Title, TitleOptions, TooltipOptions, TrackSeriesOptions, TrackSeriesOutlineOptions, TrackSeriesType, Utils, ValuePoint, ValueSeries, VectorSeriesOptions, VectorSeriesType, WaffleSeries, _isIE, absv, assignObj, calcPercent, copyObj, cos, createChart, createChartAsync, createRect, extend, fixnum, getDistance, getVersion, incv, isArray, isEmptyRect, isObject, isString, maxv, minv, parsePercentSize, pickNum, pickProp, pickProp3, pixel, preset, rectToSize, setDebugging, setGlobals, setLicenseKey, setLogging, sin };