realmap 1.0.10 → 1.0.11

package/index.d.ts

@@ -252,32 +252,32 @@ interface IPaddings {
 /**
  * @enum
  *
- * Legend나 ColorScale 등 차트 구성 요소들의 표시 위치.<br/>
+ * Legend나 ColorScale 등 맵차트 구성 요소들의 표시 위치.<br/>
  * 위치를 지정한 후 다른 속성들로 정렬시킬 수 있다.
  */
 declare const _ChartItemLocation: {
     /**
-     * 차트 본체 아래 표시한다.
+     * 맵차트 본체 아래 표시한다.
      *
      */
     readonly BOTTOM: "bottom";
     /**
-     * 차트 타이틀 아래 표시한다.
+     * 맵차트 타이틀 아래 표시한다.
      *
      */
     readonly TOP: "top";
     /**
-     * 차트 본체 오른쪽에 표시한다.
+     * 맵차트 본체 오른쪽에 표시한다.
      *
      */
     readonly RIGHT: "right";
     /**
-     * 차트 본체 왼쪽에 표시한다.
+     * 맵차트 본체 왼쪽에 표시한다.
      *
      */
     readonly LEFT: "left";
     /**
-     * 차트 본체 영역 내부에 표시한다.
+     * 맵차트 본체 영역 내부에 표시한다.
      *
      */
     readonly BODY: "body";
@@ -291,8 +291,17 @@ type Positions = 'top' | 'right' | 'bottom' | 'left';
 interface ConfigObject {
     [key: string]: any;
 }
+
+type ShapeDrawer = (rd: number, rd2: number) => (string | number)[];
 type MapCoord = [number, number];
-type MapPolygon = MapCoord[][];
+type MapRect = {
+    h1: number;
+    h2: number;
+    v1: number;
+    v2: number;
+};
+type MapArc = MapCoord[];
+type MapPolygon = MapArc[];
 type MapProps = any;
 
 /**
@@ -350,19 +359,19 @@ interface MapInsetDisplay {
      * 지정하지 않으면 1.
      * 0보다 큰 값이어야 한다.
      */
-    scale?: number;
+    readonly scale?: number;
     /**
      * inset area의 [왼쪽, 위쪽] 기준으로, 표시 위치 [경도, 위도]를 도(°) 단위로 지정한다.<br/>
      * [주의] {@page children}으로 적용될 때는 이 값 대신 {@page offset}을 반드시 지정해야 한다.
      */
-    coord?: MapCoord;
+    readonly coord?: MapCoord;
     /**
      * coord로 지정한 inset 위치에 더 추가되는 [경도, 위도] 값이거나
      * coord가 지정되지 않은 경우 원래 위치에서 떨어진 위치 값.<br/>
      * 라이브러리에서 제공하는 미리 정의된 inset 위치를 조정하는 값으로 사용할 수 있다.
      * [주의] {@page children}으로 적용될 때는 {@page coord} 대신 반듯 이 값을 지정해야 한다.
      */
-    offset?: MapCoord;
+    readonly offset?: MapCoord;
     /**
      * inset을 구분하는 경계선을 도(°)단위로 지정한다.<br/>
      * 값들은 space나 ','로 분리해서 x, y 순서대로 위치를 지정하고,
@@ -376,7 +385,7 @@ interface MapInsetDisplay {
      * ex) '-0.1 h+0.05 +0.1 h+0.1 w+0.2 h' // 제주도 위쪽에 꺽인 line을 표시한다.
      *     '-0.2 -0.1 -0.2 h+0.1' // 울릉도 좌측에 직선으로 표시한다.
      */
-    border?: MapCoord[] | string;
+    readonly border?: MapCoord[] | string;
     /**
      * inset을 감싸서 구분하는 사각형을 도(°)단위로 지정한다.<br/>
      * 이 값이 지정되면 {@page border}는 무시된다.<br/>
@@ -387,15 +396,21 @@ interface MapInsetDisplay {
      *     '0.05 0.01 0.03'   // 상 0.05°, 우 0.01°, 하 0.03, 좌 0.01°
      *     '0.05 0.01 0.03 0.02' // 상, 우, 하, 좌
      */
-    frame?: string;
+    readonly frame?: string;
     /**
      * border나 frame에 적용할 스타일셋.<br/>
      * 기본으로 'rm-map-series-inset' 클래스 선택자가 적용된다.
      */
-    style?: SVGStyleOrClass;
+    readonly style?: SVGStyleOrClass;
+    /**
+     * 명시적 false로 지정하면 이 inset이 포함하는 영역을 맵에서 제거한다.<br/>
+     * 대개 두 번째 map에서 사용된다.
+     */
+    readonly visible?: boolean;
 }
 /**
  * 본토에서 멀리 떨어진 영역들을 당겨서 표시하는 설정.<br/>
+ * [주의] 아래쪽 계산값들을 제외하곤 모두 readonly로 취급해야 한다.
  *
  * @css 'rm-map-series-inset'
  */
@@ -406,7 +421,7 @@ interface MapInset extends MapInsetDisplay {
      * {@page parent}가 지정되지 않으면
      * 자식들을 모두 함께 이동시킨다.
      */
-    area: string;
+    readonly area: string;
     /**
      * 이 area가 존재하지 않고,
      * {@page parent}가 지정되지 않으면
@@ -414,13 +429,14 @@ interface MapInset extends MapInsetDisplay {
      * [주의] {@page frame}이나 {@page border}의 기준이 되는 child area의 id를 첫번째 항목으로 설정해야 한다.
      * [주의] parent 하나에 한 번만 지정할 수 있다.
      */
-    children?: string[];
+    readonly children?: string[];
     /**
      * {@page area}가 존재하지 않을 때,
      * 이 속서에 해당하는 area를 찾아서 {@page polygons}에 해당하는 영역들을 이동시킨다.<br/>
      * 콤마로 분리해서 둘 이상의 area를 지정할 수 있는데, 순서대로 해당되는 영역이 존재하면 사용한다.
+     * [주의] parent 하나에 한 번만 지정할 수 있다.
      */
-    parent?: string;
+    readonly parent?: string;
     /**
      * {@page area}가 존재하지 않고, {@page parent}가 지정됐을 때,
      * 이 속서에 지정하는 영역덜을 동시에 이동시킨다.<br/>
@@ -428,14 +444,22 @@ interface MapInset extends MapInsetDisplay {
      * [주의] {@page parent}가 복수개로 지정되면 이 속성도 [[], [],..] 형태로 복수 개 지정해야 한다.
      * [주의] parent 하나에 한 번만 지정할 수 있다.
      */
-    polygons?: number[] | number[][] | number;
+    readonly polygons?: number[] | number[][] | number;
+    /**
+     * @private
+     * 계산된 값들.
+     */
+    off?: MapCoord;
+    box?: MapCoord[];
+    pts?: any[];
+    bounds?: MapRect;
 }
 type MapSourceMeta = {
     license?: {
         license?: string;
         author?: string;
         url?: string;
-        etc?: "차트 최적화를 위해 좌표계 변환 및 Feature Polygon 수정";
+        etc?: "맵차트 최적화를 위해 좌표계 변환 및 Feature Polygon 수정";
     };
     dokdo?: {
         group?: string;
@@ -444,18 +468,23 @@ type MapSourceMeta = {
     };
     dummies?: string[];
 };
+/**
+ * 접경선 정보.<br/>
+ * 연결된 선으로 표시되므로, 반드시 접경선이 그려지는 순서대로  양쪽 area(들)을 지정해야 한다.
+ */
+type MapBorderSource = [string | [string], string | [string]];
 /**
  * 맵시리즈에서 사용할 기본 맵을 지정한다.<br/>
  */
 interface MapSource {
     /**
      * 맵 이름.<br/>
-     * 차트에 여러 개 맵이 지정될 수 있으며,
-     * 차트 시리즈 등에서 맵을 참조할 때 사용된다.
+     * 맵차트에 여러 개 맵이 지정될 수 있으며,
+     * 맵차트 시리즈 등에서 맵을 참조할 때 사용된다.
      */
     name?: string;
     /**
-     * 명시적 false로 지정하면 차트에서 맵으로 사용되지 않는다.<br/>
+     * 명시적 false로 지정하면 맵차트에서 맵으로 사용되지 않는다.<br/>
      *
      * @default true
      */
@@ -481,10 +510,15 @@ interface MapSource {
      */
     nameKey?: string;
     /**
-     * 차트 맵 모델을 구성할 때 제외시킬 영역들의 id 목록.<br/>
+     * 맵차트 맵 모델을 구성할 때 제외시킬 영역들의 id 목록.<br/>
      */
     exclude?: string[];
-    insets?: MapInset[];
+    /**
+     * 맵 인셋 목록을 지정한다.<br/>
+     * 이름을 문자열로 지정하면 라이브러기가 기본 제공하는 인셋들이 사용된다.
+     * 또, 이름앞에 '-'를 추가하면 visible이 false로 설정된다.
+     */
+    insets?: (string | MapInset)[];
     /**
      * 맵 상하좌우 주변에 추가할 영역의 크기를  도(°) 단위로 지정한다.<br/>
      * css padding이나 margin 지정 방식과 동일하게 지정한댜.<br/>
@@ -509,7 +543,12 @@ interface MapSource {
      */
     useOffset?: boolean | MapCoord;
     /**
-     * 내부 경계(internal boundary)선 정보를 생성할 지 여부.<br/>
+     * 부극 취고위까지 지도에 포함되면 90도까지 그려진 것으로 간주한다.<br/>
+     * 명시적 false로 지정하면 계산된 영역까지만 포함한다.
+     */
+    alignArctic?: boolean;
+    /**
+     * 내부 경계(internal boundary)선 정보를 별도로 생성할 지 여부.<br/>
      */
     needInternal?: boolean;
     /**
@@ -517,26 +556,49 @@ interface MapSource {
      */
     excludeInternal?: string[];
     /**
-     * 부극 취고위까지 지도에 포함되면 90도까지 그려진 것으로 간주한다.<br/>
-     * 명시적 false로 지정하면 계산된 영역까지만 포함한다.
+     * 외부 경계선 정보를 별도로 생성할 지 여부.<br/>
      */
-    alignArctic?: boolean;
+    needExternal?: boolean;
+    /**
+     * {@page needInternal 내부 경계선}에서 제외할 영역 목록.<br/>
+     */
+    excludeExternal?: string[];
+    /**
+     * 접경선 목록.<br/>
+     */
+    borders?: [{
+        name: string;
+        border: MapBorderSource;
+        closed?: boolean;
+    }];
 }
 declare abstract class MapSourceItem {
     id: string;
-    props: MapProps;
-    constructor(id: string, props: MapProps);
+    constructor(id: string);
 }
 declare class AreaItem extends MapSourceItem {
+    props: MapProps;
     polygon: MapPolygon;
     polygons: MapPolygon[];
     internal?: MapPolygon[];
     internals?: MapPolygon[][];
+    external?: MapPolygon[];
+    externals?: MapPolygon[][];
     dummy: boolean;
+    constructor(id: string, props: MapProps);
+}
+declare class MapBorderInfo {
+    name: string;
+    closed: boolean;
+    border: [string[], string[]];
+    constructor(name: string, source: MapBorderSource, closed: boolean);
+}
+declare class BorderItem extends MapSourceItem {
+    polygon: MapPolygon;
+    constructor(id: string, polygon: MapPolygon);
 }
 declare abstract class MapSourceImpl extends RmObject {
-    static createStockInset(area: string, display?: MapInsetDisplay): MapInset;
-    private _index;
+    static createStockInset(area: string, display?: boolean | MapInsetDisplay): MapInset;
     readonly name: string;
     readonly enabled: boolean;
     readonly idKey: string;
@@ -546,7 +608,9 @@ declare abstract class MapSourceImpl extends RmObject {
     readonly dummies: string[];
     readonly useOffset: boolean | MapCoord;
     readonly internals: boolean;
+    readonly externals: boolean;
     readonly alignArctic: boolean;
+    readonly borders: MapBorderInfo[];
     items: MapSourceItem[];
     insets: {
         [area: string]: MapInset;
@@ -605,7 +669,7 @@ interface AnnotationOptions extends ChartItemOptions {
      */
     name?: string;
     /**
-     * 어노테이션 배치 기준이 되는 차트 구성 요소.<br/>
+     * 어노테이션 배치 기준이 되는 맵차트 구성 요소.<br/>
      * 현재, 같은 영역(body 혹은 chart)에 포함된 {@link config.base.gauge 게이지}나 다른 어노테이션의 {@link name 이름}을 지정할 수 있다.
      *
      */
@@ -893,7 +957,7 @@ declare const _ClickAction: {
     readonly NONE: "none";
     readonly SELECT: "select";
     /**
-     * 차트가 zoom 가능한 상태일 때 zoom-in 한다.
+     * 맵차트가 zoom 가능한 상태일 때 zoom-in 한다.
      */
     readonly ZOOM: "zoom";
     /**
@@ -921,7 +985,7 @@ declare const _DblClickAction: {
     readonly NONE: "none";
     readonly SELECT: "select";
     /**
-     * 차트가 zoom 가능한 상태일 때 zoom-in 한다.
+     * 맵차트가 zoom 가능한 상태일 때 zoom-in 한다.
      */
     readonly ZOOM: "zoom";
     /**
@@ -965,7 +1029,7 @@ interface OnClickArgs extends CommonCallbackArgs {
     area?: string;
 }
 /**
- * 차트 전체에 영향을 미치는 옵션들.<br />
+ * 맵차트 전체에 영향을 미치는 옵션들.<br />
  *
  * @config chart.chart
  */
@@ -1013,7 +1077,7 @@ interface ChartOptionsOptions extends ChartItemOptions {
      */
     widgetGap?: number;
     /**
-     * div의 크기가 변경될 때, 차트를 해당 크기에 맞게 조정할지 여부
+     * div의 크기가 변경될 때, 맵차트를 해당 크기에 맞게 조정할지 여부
      *
      * @default false
      */
@@ -1028,8 +1092,8 @@ interface ChartOptionsOptions extends ChartItemOptions {
     onSelectionChanged?: (args: any) => void;
 }
 /**
- * 차트 제목(title) 설정 모델.<br/>
- * 기본적으로 차트 중앙 상단에 표시되지만 {@link align}, {@link verticalAlign} 등으로 위치를 변경할 수 있다.<br/>
+ * 맵차트 제목(title) 설정 모델.<br/>
+ * 기본적으로 맵차트 중앙 상단에 표시되지만 {@link align}, {@link verticalAlign} 등으로 위치를 변경할 수 있다.<br/>
  *
  * {@page guide.title 타이틀 개요} 페이지를 참조한다.
  * @config chart.title
@@ -1050,7 +1114,7 @@ interface TitleOptions extends ChartItemOptions {
     /**
      * 정렬 기준.<br/>
      * 시리즈들이 그려지는 plotting 영역이나,
-     * 차트 전체 영역을 기준으로 할 수 있다.
+     * 맵차트 전체 영역을 기준으로 할 수 있다.
      * 또, {@link config.subtitle 부제목}인 경우 제목을 기준으로 위치를 지정할 수 있다.
      *
      * @default 'map'
@@ -1073,7 +1137,7 @@ interface TitleOptions extends ChartItemOptions {
      */
     backgroundStyle?: SVGStyleOrClass;
     /**
-     * 주 제목과 부 제목이 표시되는 영역과 차트 본체 등 과의 간격을 픽셀 단위로 지정한다.<br/>
+     * 주 제목과 부 제목이 표시되는 영역과 맵차트 본체 등 과의 간격을 픽셀 단위로 지정한다.<br/>
      * 주 제목이 표시되면 (부 제목의 값은 무시되고)주 제목의 값을 사용하고,
      * 부 제목만 표시될 때는 부 제목의 값을 사용한다.
      *
@@ -1106,7 +1170,7 @@ declare const _SubtitlePosition: {
 /** @dummy */
 type SubtitlePosition = typeof _SubtitlePosition[keyof typeof _SubtitlePosition];
 /**
- * 차트 제목 주위에 표시되는 부제목 옵션.<br/>
+ * 맵차트 제목 주위에 표시되는 부제목 옵션.<br/>
  * 기본적으로 주제목(title)의 설정을 따르고, 몇가지 속성들이 추가된다.<br/>
  * 별도 설정이 없으면 표시되지 않는다.
  *
@@ -1147,7 +1211,7 @@ interface SubtitleOptions extends TitleOptions {
     verticalAlign?: VerticalAlign;
 }
 /**
- * 차트 개발 제작자 등을 표시하는
+ * 맵차트 개발 제작자 등을 표시하는
  * 크레딧 영역에 대한 설정 모델.
  */
 interface CreditsOptions extends ChartItemOptions {
@@ -1199,7 +1263,7 @@ interface CreditsOptions extends ChartItemOptions {
     offsetY?: number;
     /**
      * {@link floating}이 true가 아니고, 중앙이 아닌 곳에 표시될 때,
-     * 차트 나머지 영역과의 간격을 픽셀로 지정한다.<br/>
+     * 맵차트 나머지 영역과의 간격을 픽셀로 지정한다.<br/>
      * {@page verticalAlign}이 'middle'이면 수평 간격, 아니면 수직 간격에 적용된다.
      *
      * @default 4
@@ -1453,7 +1517,7 @@ interface OnZoomChangedArgs extends CommonCallbackArgs {
     oldZoom: number;
 }
 /**
- * 차트 본체(body) 설정 모델.<br/>
+ * 맵차트 본체(body) 설정 모델.<br/>
  * 투영 옵션과 지도 제어 옵션들을 설정할 수 있다.<br/>
  * @config chart.body
  */
@@ -1741,13 +1805,13 @@ interface MapWidgetOptions extends ChartItemOptions {
      */
     location?: ChartItemLocation;
     /**
-     * 범례 또는 scale과 (location이 body일 때)body 또는 차트 경계 사이의 수평 간격.<br/>
+     * 범례 또는 scale과 (location이 body일 때)body 또는 맵차트 경계 사이의 수평 간격.<br/>
      *
      * @default 0
      */
     offsetX?: number;
     /**
-     * 범례 또는 scale과 (location이 body일 때)body 또는 차트 경계 사이의 수직 간격.<br/>
+     * 범례 또는 scale과 (location이 body일 때)body 또는 맵차트 경계 사이의 수직 간격.<br/>
      *
      * @default 0
      */
@@ -1790,22 +1854,14 @@ interface MapWidgetGroupOptions extends MapWidgetOptions {
 interface DataPointArgs extends CommonCallbackArgs {
     series: object;
     count: number;
-    vcount: number;
-    yMin: number;
-    yMax: number;
-    xMin: number;
-    xMax: number;
-    zMin: number;
-    zMax: number;
+    id: string;
     index: number;
-    vindex: number;
-    x: any;
-    y: any;
-    z: any;
-    xValue: any;
-    yValue: any;
-    zValue: any;
-    labelIndex: number;
+    name?: string;
+    color?: string;
+    className?: string;
+    value?: any;
+    labelIndex?: number;
+    coord?: MapCoord;
     source: any;
 }
 interface DataPointListkArgs extends CommonCallbackArgs {
@@ -1835,7 +1891,7 @@ interface ZoomToAreaOptions {
 }
 
 /**
- * 차트 내보내기 설정 모델
+ * 맵차트 내보내기 설정 모델
  * @config chart.exporting
  */
 interface ExporterOptions extends ChartItemOptions {
@@ -1844,7 +1900,7 @@ interface ExporterOptions extends ChartItemOptions {
      */
     visible?: boolean;
     /**
-     * 내보내기 버튼을 사용해 내보낸 차트에 사용할 확장자 없는 파일 이름.\
+     * 내보내기 버튼을 사용해 내보낸 맵차트에 사용할 확장자 없는 파일 이름.\
      * 'export' 함수를 호출할 때 fileName을 지정하지 않을 경우 이 속성이 적용된다.
      * fileName을 지정하지 않을 경우 realmap.type으로 다운로드 된다.
      *
@@ -1907,21 +1963,21 @@ type ExportType = typeof _ExportType[keyof typeof _ExportType];
  */
 interface ExportOptions {
     /**
-     * 내보낸 차트에 사용할 확장자.\
+     * 내보낸 맵차트에 사용할 확장자.\
      * type을 지정하지 않을 경우 png로 내보내기 된다.\
      * @config
      * // @TODO https://github.com/realgrid/realreport-chart/issues/549
      */
     type?: ExportType;
     /**
-     * 내보낸 차트에 사용할 확장자 없는 파일명.
+     * 내보낸 맵차트에 사용할 확장자 없는 파일명.
      * fileName을 지정하지 않을 경우 realmap.type으로 다운로드 된다.
      * @config
      */
     fileName?: string;
 }
 /**
- * 외부 모듈로 구현되는 차트 내보내기 기능 명세.
+ * 외부 모듈로 구현되는 맵차트 내보내기 기능 명세.
  */
 interface ChartExporter {
     exportToImage: (dom: HTMLElement, options: ExportOptions, config: ExporterOptions) => void;
@@ -2725,7 +2781,7 @@ type Shape = typeof _Shapes[keyof typeof _Shapes];
 
 type PointHoverCallback = (args: DataPointArgs) => void;
 type PointClickCallback = (args: DataPointArgs) => boolean;
-type PointStyleCallback = (args: DataPointArgs) => SVGStyleOrClass;
+type PointStyleCallback = (args: DataPointArgs) => SVGStyleOrClass | undefined;
 /**
  * @enum
  */
@@ -2877,15 +2933,15 @@ interface DataPointCalloutOptions extends ChartItemOptions {
     layoutOnly?: boolean;
 }
 /**
- * 시리즈는 {@page data}로 지정된 값들을 데이터포인트로 표시하는 차트의 핵심 구성 요소이다.<br/>
- * 차트 설정의 다른 부분이나 API에 참조하기 위해서는 {@page name}을 반드시 지정해야 햔다.
- * 차트 생성 시 {@page config.series.#type} 을 지정하지 않으면 {@page config.series.bar 'bar'} 시리즈로 생성된다.<br/>
+ * 시리즈는 {@page data}로 지정된 값들을 데이터포인트로 표시하는 맵차트의 핵심 구성 요소이다.<br/>
+ * 맵차트 설정의 다른 부분이나 API에 참조하기 위해서는 {@page name}을 반드시 지정해야 햔다.
+ * 맵차트 생성 시 {@page config.series.#type} 을 지정하지 않으면 {@page config.series.bar 'bar'} 시리즈로 생성된다.<br/>
  *
  * @config chart.series[base]
  */
 interface SeriesOptions extends ChartItemOptions {
     /**
-     * 차트 설정 객체에 지정하는 시리즈 종류.<br/>
+     * 맵차트 설정 객체에 지정하는 시리즈 종류.<br/>
      */
     type?: string;
     /**
@@ -2901,7 +2957,7 @@ interface SeriesOptions extends ChartItemOptions {
     label?: string;
     /**
      * 명시적으로 이 속성을 지정하면,
-     * 관련된 맵이 차트에 활성됐을 때만 시리즈가 표시된다.
+     * 관련된 맵이 맵차트에 활성됐을 때만 시리즈가 표시된다.
      */
     map?: string | number;
     /**
@@ -2919,7 +2975,7 @@ interface SeriesOptions extends ChartItemOptions {
      * 데이터포인트 목록을 생성하는 데 참조되는 데이터셋.<br/>
      * {@page g.createChartAsync createChartAsync}를 호출해서 비동기로
      * 맵차트를 생성할 때는 {@page dataUrl}로 원격 데이터 소스를 지정할 수 있다.
-     * [주의] 처음 load 후 data의 내용을 변경해도 차트에 반영되지 않는다.
+     * [주의] 처음 load 후 data의 내용을 변경해도 맵차트에 반영되지 않는다.
      */
     data?: any;
     /**
@@ -2927,7 +2983,7 @@ interface SeriesOptions extends ChartItemOptions {
      * {@page g.createChartAsync createChartAsync} 호출 시, 해당 url로 GET 요청을 전송하여 데이터를 다운받고,
      * 해당 시리즈의 data 속성에 저장한다.<br/>
      * {@page data}가 설정되면 이 속성은 무시된다.
-     * 또, 비동기 함수가 아닌 {@page g.createChart createChart}로 차트를 생성할 때 이 속성으로 data를 설정하려는 경우
+     * 또, 비동기 함수가 아닌 {@page g.createChart createChart}로 맵차트를 생성할 때 이 속성으로 data를 설정하려는 경우
      * 콘솔에 경고 메시지가 표시된다.
      */
     dataUrl?: string;
@@ -3007,6 +3063,10 @@ interface SeriesOptions extends ChartItemOptions {
      * 차트 설정 로드 시 실행되는 animation 종류.
      */
     loadAnimation?: 'default' | 'reveal' | 'grow' | 'spread' | 'fadein';
+    /**
+     * true로 설정하면 hovering을 포함한 포인터 상호 작용에 비활성화 된다.<br/>
+     */
+    disabled?: boolean;
     /**
      * @ignore 미구현
      * 데이터포인트 hover 효과.<br/>
@@ -3073,7 +3133,7 @@ interface SparkSeriesCategory {
 }
 /**
  * 특정 위치에 연관된 값들을 단순 차트(spark chart)로 표시한다.<br/>
- * bar, line, par 차트가 제공된다.
+ * bar, line, pie 차트가 제공된다.
  */
 interface SparkSeriesOptions extends ValueSeriesOptions {
     /**
@@ -3089,7 +3149,7 @@ interface SparkSeriesOptions extends ValueSeriesOptions {
     valueFields?: string[];
     /**
      * true로 지정되고 {@page categories}가 지정되면
-     * 차트 legend에 category별로 항목이 표시된다.
+     * 맵차트 legend에 category별로 항목이 표시된다.
      *
      * @default undefined
      */
@@ -3585,16 +3645,27 @@ interface DrilldownOptions extends ChartItemOptions {
     autoMapChange?: boolean;
 }
 /**
- * 내부 접경선으로 표시 설정 옵션.<br/>
+ * 맵 시리즈 내외부 접경선 표시 설정 옵션.<br/>
  * [topoJSON](https://github.com/topojson/topojson-specification?tab=readme-ov-file) 소스로
- * 작성된 맵인 경우 내부 접경선을 별도의 스타일로 구분해서 표시할 수 있다.
+ * 작성된 맵인 경우 내외부 접경선을 별도의 스타일로 구분해서 표시할 수 있다.
  */
-interface MapInternalBorderOptions extends ChartItemOptions {
+interface MapBordersOptions extends ChartItemOptions {
     /**
      * @default false
      */
     visible?: boolean;
 }
+/**
+ * 맵 시리즈 내외부 접경선 표시 설정 옵션.<br/>
+ * [topoJSON](https://github.com/topojson/topojson-specification?tab=readme-ov-file) 소스로
+ * 작성된 맵인 경우 내외부 접경선을 별도의 스타일로 구분해서 표시할 수 있다.
+ */
+interface MapBorderOptions extends ChartItemOptions {
+    /**
+     * border 목록일 때, 각 목록을 구분하는 이름.<br/>
+     */
+    name?: string;
+}
 declare const MapSeriesType = "map";
 /**
  * Map area 영역들을 칠하는 시리즈.<br/>
@@ -3616,11 +3687,10 @@ interface MapSeriesOptions extends ValueSeriesOptions {
      * 맵 area와 연결할 키값들을 지정한다.<br/>
      * 두 값을 배열로 지정하면 첫번째 문자열은 맵소스 "properties"의 속성명,
      * 두번째는 데이터포인트의 속성명이다.
-     * 값을 하나만 지정하면 양쪽 같은 속성명으로 연결한다.<br/>
-     * 이 값이 지정되지 않으면 데이터포인트의 "id" 또는 idField 속성으로 지정한 속성값과 맵소스의 "rm-id" 또는 "id" 속성값으로 연결한다.
+     * 값을 하나만 지정하거나 문자열로 지정하면 양쪽 같은 속성명으로 연결한다.<br/>
+     * 이 값이 지정되지 않으면 데이터포인트의 "id" 또는 {@page idField} 속성으로 지정한 속성값과 맵소스의 "rm-id" 또는 "id" 속성값으로 연결한다.
      */
     mapKeys?: string | [string, string];
-    middleKeys?: [string, string];
     /**
      * 데이터포인트가 연결되지 않은 area의 스타일.<br/>
      *
@@ -3657,15 +3727,30 @@ interface MapSeriesOptions extends ValueSeriesOptions {
      * @default true
      */
     allAreas?: boolean;
+    /**
+     * 표시하지 않는 영역들을 지정한다.<br/>
+     * {@page mapKeys} 속성으로 지정된 key나 'id' 또는 {@page idField}로 지정된 값(들)로 지정한다.
+     */
+    hiddenAreas?: string | string[];
     /**
      * 내부 접경선 표시 설정 옵션.<br/>
      */
-    internalBorder?: MapInternalBorderOptions;
+    internalBorder?: MapBordersOptions;
+    /**
+     * 외부 접경선 표시 설정 옵션.<br/>
+     */
+    externalBorder?: MapBordersOptions;
+    /**
+     * 특정 영역들의 경계선 옵션 목록.<br/>
+     */
+    mapBorders?: string | MapBorderOptions | (string | MapBorderOptions)[];
     colorRange?: ColorRange;
     /**
-     * 차트에 설정된 color scale 아이디 혹은 인덱스.
+     * 차트에 설정된 color scale 아이디 혹은 인덱스.<br/>
+     * 명시적 null을 지정하면 컬러스케일에 연결되지 않는다.
+     * 다른 잘못된 값이면 첫번째 스케일에 연결된다.
      */
-    colorScale?: string | number;
+    colorScale?: string | number | null;
     drilldown?: DrilldownOptions;
     /**
      * @ignore
@@ -3703,9 +3788,11 @@ interface FeatureSeriesOptions extends ValueSeriesOptions {
     selectable?: boolean;
     colorRange?: ColorRange;
     /**
-     * 차트에 설정된 color scale 아이디 혹은 인덱스.
+     * 차트에 설정된 color scale 아이디 혹은 인덱스.<br/>
+     * 명시적 null을 지정하면 컬러스케일에 연결되지 않는다.
+     * 다른 잘못된 값이면 첫번째 스케일에 연결된다.
      */
-    colorScale?: string | number;
+    colorScale?: string | number | null;
     /**
      * @ignore
      */
@@ -3833,9 +3920,11 @@ interface PinSeriesOptions extends MarkerSeriesOptions {
      */
     position?: PointViewPosition;
     /**
-     * 차트에 설정된 color scale 아이디 혹은 인덱스.
+     * 차트에 설정된 color scale 아이디 혹은 인덱스.<br/>
+     * 명시적 null을 지정하면 컬러스케일에 연결되지 않는다.
+     * 다른 잘못된 값이면 첫번째 스케일에 연결된다.
      */
-    colorScale?: string | number;
+    colorScale?: string | number | null;
 }
 declare const FigureSeriesType = "figure";
 /**
@@ -4534,8 +4623,8 @@ type LegendItemsAlign = typeof _LegendItemsAligns[keyof typeof _LegendItemsAlign
  */
 declare const _LegendLayout: {
     /**
-     * legend가 차트 좌우에 배치되면 item들을 수직으로 배치하고,
-     * legend가 차트 상하에 배치되면 item들을 수평으로 배치한다.
+     * legend가 맵차트 좌우에 배치되면 item들을 수직으로 배치하고,
+     * legend가 맵차트 상하에 배치되면 item들을 수평으로 배치한다.
      */
     readonly AUTO: "auto";
     /**
@@ -4550,7 +4639,7 @@ declare const _LegendLayout: {
 /** @dummy */
 type LegendLayout = typeof _LegendLayout[keyof typeof _LegendLayout];
 /**
- * 차트 시리즈 구성을 직관적으로 이해할 수 있도록 도와주는 범례 설정 모델.<br/>
+ * 맵차트 시리즈 구성을 직관적으로 이해할 수 있도록 도와주는 범례 설정 모델.<br/>
  * visible 기본값이 undefined이고,
  * 따로 지정하지 않으면 시리즈가 둘 이상 포함돼야 legend가 표시된다.<br/>
  * {@link guide.legend 범례 개요} 페이지를 참조한다.
@@ -4662,7 +4751,7 @@ declare class LegendItem extends ChartItem<ChartItemOptions> {
     text(): string;
 }
 /**
- * 차트 시리즈 구성을 직관적으로 이해할 수 있도록 도와주는 범례 설정 모델.<br/>
+ * 맵차트 시리즈 구성을 직관적으로 이해할 수 있도록 도와주는 범례 설정 모델.<br/>
  * visible 기본값이 undefined이고,
  * 따로 지정하지 않으면 시리즈가 둘 이상 포함돼야 legend가 표시된다.<br/>
  * {@link guide.legend 범례 개요} 페이지를 참조한다.
@@ -4687,12 +4776,13 @@ declare class Legend extends MapSimpleWidget<LegendOptions> {
     isVisible(): boolean;
     protected _doInit(op: LegendOptions): void;
     protected _doApply(options: LegendOptions): void;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: LegendOptions): void;
 }
 declare class LegendCollection extends MapWidgetCollection<Legend> {
     protected _collectionProp(): string;
     protected _canEmpty(): boolean;
     protected _createWidget(chart: IChart): Legend;
+    prepareRender(): void;
 }
 
 /**
@@ -4728,6 +4818,7 @@ declare class MapArea extends RmObject implements ISelectionSource {
     private _info;
     private _path;
     private _internal;
+    private _external;
     h1: number;
     h2: number;
     v1: number;
@@ -4752,6 +4843,7 @@ declare class MapArea extends RmObject implements ISelectionSource {
     name: string;
     get path(): string;
     get internal(): string;
+    get external(): string;
     get selected(): boolean;
     displayText(): string;
     /**
@@ -4777,11 +4869,23 @@ declare class MapArea extends RmObject implements ISelectionSource {
         y1: number;
         y2: number;
     };
-    readPath(prj: MapProjection): string;
-    readInternal(prj: MapProjection, off: MapCoord): string;
+    readPath(prj: MapProjection, info: {
+        internals: boolean;
+        externals: boolean;
+    }): string;
+    private $_readInternal;
+    private $_readExternal;
     getCenter(): MapCoord;
     _clone(): MapArea;
 }
+declare class MapBorder extends RmObject {
+    source: BorderItem;
+    private _path;
+    constructor(source: BorderItem);
+    get path(): string;
+    reset(): void;
+    readPath(prj: MapProjection): void;
+}
 interface IMapOwner {
     getProjection(second: boolean): MapProjection;
     projectionChanged(): void;
@@ -4800,6 +4904,7 @@ declare class MapModel extends RmObject {
     private _second;
     private _areas;
     private _areaMap;
+    private _borders;
     _insets: MapInset[];
     _useOffset: boolean | MapCoord;
     private _mapAreaFinder;
@@ -4831,6 +4936,8 @@ declare class MapModel extends RmObject {
     set hiddenAreas(value: string[]);
     get alignArctic(): any;
     get hasInternals(): boolean;
+    get hasExternals(): boolean;
+    get hasBorders(): MapBorderInfo[];
     get isWorld(): boolean;
     get(index: number): MapArea;
     areaOf(id: any): MapArea;
@@ -4844,6 +4951,8 @@ declare class MapModel extends RmObject {
      */
     reset(): void;
     isVisible(area: string): boolean;
+    insetAt(coord: MapCoord): MapInset;
+    getBorder(name: string): MapBorder;
     /**
      * 투영전에 지도 bounds를 계산한다.
      * projection offset을 설정하려면 투영하기 전에 지도 경계값이 필요하다.
@@ -4901,7 +5010,7 @@ declare class DataPointLabel<OP extends DataPointLabelOptions = DataPointLabelOp
     isVisible(): boolean;
     getDefaultIconPos(): IconPosition;
     protected _doSetSimple(op: OP, src: any): boolean;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: OP): void;
 }
 declare class DataPointAnchorPoint<OP extends CalloutAnchorPointOptions = CalloutAnchorPointOptions> extends ChartItem<OP> {
     static defaults: CalloutAnchorPointOptions;
@@ -4926,6 +5035,7 @@ interface ISeries<T extends DataPoint = DataPoint> {
     _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;
@@ -4992,7 +5102,7 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     /**
      * 시리즈 이름.<br/>
      * 시리즈 생성시 지정된 후 변경할 수 없다.
-     * 차트의 다른 구성 요소에서 이 시리즈를 참조할 때 사용되며,
+     * 맵차트의 다른 구성 요소에서 이 시리즈를 참조할 때 사용되며,
      * 레전드나 툴팁에서 시리즈를 나타내는 텍스트로도 사용된다.
      *
      * @config
@@ -5049,7 +5159,6 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     protected _defLabelOff(): number;
     setCalcedColor(cs: CSSStyleDeclaration, prop: string): void;
     coordOfArea(id: string): MapCoord;
-    getCoord(p: DataPoint): MapCoord;
     pointById(id: string): DataPoint;
     canAddAnimation(): boolean;
     canRemoveAnimation(): boolean;
@@ -5092,7 +5201,7 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     _prepareRender(): void;
     protected _doAfterRender(): void;
     protected _doMapChanged(): void;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: OP): void;
     protected abstract _createPoint(source: any): DataPoint;
     protected $_addPoint(source: any, i: number): DataPoint;
     protected _createFielder(f: any): (v: any) => any;
@@ -5115,6 +5224,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 _assignTo(proxy: any): any;
     getValue(): number;
     getBaseValue(): number;
 }
@@ -5251,6 +5361,12 @@ declare class DataPoint implements ISelectionSource {
      * 데이터포인트 표시 위치.<br/>
      */
     coord: MapCoord;
+    /**
+     * @private
+     *
+     * 인셋에 포함된 경우 인셋의 offset.<br/>
+     */
+    inset: MapCoord;
     /**
      * 본래 위치와 다른 곳에 데이터포인트 정보를 표시할 때,
      * 해당하는 위치까지의 경로를 표시한다.<br/>
@@ -5351,7 +5467,7 @@ interface AssetItemOptions {
     /**
      * 에셋 id.<br/>
      * 시리즈나 축에서 이 에셋 항목을 참조할 때 사용하는 키로서
-     * 차트 내에서 유일한 문자열로 반드시 지정해야 한다.
+     * 맵차트 내에서 유일한 문자열로 반드시 지정해야 한다.
      *
      */
     id: string;
@@ -5490,8 +5606,8 @@ declare class AssetCollection {
 }
 
 /**
- * 차트 제작 주체 등을 표시하는 영역에 대한 모델.<br/>
- * 기본적으로 차트 오른쪽 아래에 표시되지만, {@link align}, {@link verticalAlign} 등으로 위치를 지정할 수 있다.
+ * 맵차트 제작 주체 등을 표시하는 영역에 대한 모델.<br/>
+ * 기본적으로 맵차트 오른쪽 아래에 표시되지만, {@link align}, {@link verticalAlign} 등으로 위치를 지정할 수 있다.
  * {@link url}을 설정하면 마우스 클릭 시 새창을 열고 해당 위치로 이동시킨다.
  */
 declare class Credits extends ChartItem<CreditsOptions> {
@@ -5514,8 +5630,8 @@ interface ScaleOptions extends MapSimpleWidgetOptions {
  */
 declare const _ColorScaleLayout: {
     /**
-     * color scale이 차트 좌우에 배치되면 item들을 수직으로 배치하고,
-     * color scale이 차트 상하에 배치되면 item들을 수평으로 배치한다.
+     * color scale이 맵차트 좌우에 배치되면 item들을 수직으로 배치하고,
+     * color scale이 맵차트 상하에 배치되면 item들을 수평으로 배치한다.
      */
     readonly AUTO: "auto";
     /**
@@ -6204,7 +6320,7 @@ declare class MapScale extends ScaleBase<MapScaleOptions> {
     _type(): string;
     protected _getScaledSeries(chart: IChart): ISeries;
     protected _doApply(options: MapScaleOptions): void;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: MapScaleOptions): void;
     private $_calcScale;
 }
 
@@ -6214,9 +6330,9 @@ declare class MapScale extends ScaleBase<MapScaleOptions> {
 interface MapSourceOptions extends MapSource {
 }
 /**
- * 차트의 기준이 되는 맵과 관련 속성 및 시리즈와 게이지의 기본 타입을 결정하는 중요한 몇가지 속성들과
+ * 맵차트의 기준이 되는 맵과 관련 속성 및 시리즈와 게이지의 기본 타입을 결정하는 중요한 몇가지 속성들과
  * 하위 구성 요소들에 대한 옵션들을 설정한다.<br/>
- * 차트 생성 시 이 옵션 객체를 구성해서 전달해야 한다.
+ * 맵차트 생성 시 이 옵션 객체를 구성해서 전달해야 한다.
  *
  * ```js
  * const chart = RealMap.createChart(doc, 'div', {
@@ -6250,12 +6366,12 @@ interface ChartConfiguration {
      * 한 주의 시작 요일.<br/>
      * ex) 0: 일요일, 1: 월요일
      *
-     * [주의] 차트 로딩 후 변경할 수 없다.
+     * [주의] 맵차트 로딩 후 변경할 수 없다.
      *
      */
     startOfWeek?: number;
     /**
-     * 차트 영역 전체에 연관되는 속성들을 설정한다.<br/>
+     * 맵차트 영역 전체에 연관되는 속성들을 설정한다.<br/>
      */
     chart?: ChartOptionsOptions;
     /**
@@ -6267,15 +6383,15 @@ interface ChartConfiguration {
      */
     assets?: AssetOptionsType | AssetOptionsType[];
     /**
-     * {@page guide.title 차트 타이틀} 표시 영역.<br/>
+     * {@page guide.title 맵차트 타이틀} 표시 영역.<br/>
      */
     title?: TitleOptions | string;
     /**
-     * {@page guide.title 차트 타이틀} 주변에 추가롤 표시되는 부제목 영역.<br/>
+     * {@page guide.title 맵차트 타이틀} 주변에 추가롤 표시되는 부제목 영역.<br/>
      */
     subtitle?: SubtitleOptions | string;
     /**
-     * 차트의 기준이 될 지도 소스 및 관련 옵션.<br/>
+     * 맵차트의 기준이 될 지도 소스 및 관련 옵션.<br/>
      * 배열로 둘 이상의 맵을 지정할 수 있다.
      */
     map?: MapSourceOptions | MapSourceOptions[];
@@ -6315,11 +6431,11 @@ interface ChartConfiguration {
     bubbleScales?: BubbleScaleOptions | BubbleScaleOptions[];
     mapScale?: MapScale;
     /**
-     * 차트가 {@page guide.zoom zoom} 가능할 때 zomm 버튼들이 표시되는 패널.<br/>
+     * 맵차트가 {@page guide.zoom zoom} 가능할 때 zomm 버튼들이 표시되는 패널.<br/>
      */
     zoomPanel?: ZoomPanelOptions | boolean;
     /**
-     * 차트가 {@page guide.drilldown 드릴다운} 상태일 때 뒤로 가기 버튼(들)이 표시되는 패널.<br/>
+     * 맵차트가 {@page guide.drilldown 드릴다운} 상태일 때 뒤로 가기 버튼(들)이 표시되는 패널.<br/>
      */
     drilldownPanel?: DrilldownPanelOptions | boolean;
     /**
@@ -6385,12 +6501,13 @@ declare class BubbleScale extends ScaleBase<BubbleScaleOptions> {
     isVertical(): boolean;
     protected _getScaledSeries(chart: IChart): ISeries;
     protected _doApply(options: BubbleScaleOptions): void;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: BubbleScaleOptions): void;
     private $_buildSteps;
 }
 declare class BubbleScaleCollection extends MapWidgetCollection<BubbleScale> {
     protected _collectionProp(): string;
     protected _createWidget(chart: IChart): BubbleScale;
+    beforeRender(): void;
 }
 
 interface IColorRanger {
@@ -6483,7 +6600,7 @@ declare class ColorScale extends ScaleBase<ColorScaleOptions> implements IColorR
     protected _doApply(options: ColorScaleOptions): void;
     protected _getScaledSeries(chart: IChart): ISeries;
     private $_parseColorStops;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: ColorScaleOptions): void;
     _buildSteps(): void;
     private $_parseValue;
     private $_normalizeMin;
@@ -6495,10 +6612,11 @@ declare class ColorScaleCollection extends MapWidgetCollection<ColorScale> {
     getLegendSources(): ILegendSource[];
     protected _collectionProp(): string;
     protected _createWidget(chart: IChart): ColorScale;
+    beforeRender(): void;
 }
 
 /**
- * 차트 내보내기 관련 설정 모델.
+ * 맵차트 내보내기 관련 설정 모델.
  */
 declare class Exporter extends ChartItem<ExporterOptions> {
     static defaults: ExporterOptions;
@@ -6537,7 +6655,7 @@ declare class MapAxisGrid extends ChartItem<MapAxisGridOptions> {
     getLonStep(): number;
     getLatStep(): number;
     protected _doApply(options: MapAxisGridOptions): void;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: MapAxisOptions): void;
     private $_defaultStep;
 }
 /**
@@ -6698,8 +6816,8 @@ declare class DrilldownPanel extends BodyPanel<DrilldownPanelOptions> {
 }
 
 /**
- * 차트 제목(title) 설정 모델.<br/>
- * 기본적으로 차트 중앙 상단에 표시되지만 {@link align}, {@link verticalAlign} 등으로 위치를 변경할 수 있다.<br/>
+ * 맵차트 제목(title) 설정 모델.<br/>
+ * 기본적으로 맵차트 중앙 상단에 표시되지만 {@link align}, {@link verticalAlign} 등으로 위치를 변경할 수 있다.<br/>
  * {@link guide.title 타이틀 개요} 페이지를 참조한다.
  *
  * @config chart.title
@@ -6710,7 +6828,7 @@ declare class Title<OP extends TitleOptions = TitleOptions> extends ChartItem<OP
     protected _doSetSimple(op: OP, src: any): boolean;
 }
 /**
- * 차트 부제목(subtitle) 설정 모델.<br/>
+ * 맵차트 부제목(subtitle) 설정 모델.<br/>
  * 기본적으로 주 제목(title)의 설정을 따르고, 몇가지 속성들이 추가된다.<br/>
  * {@link guide.subtitle 부제목 개요} 페이지를 참조한다.
  *
@@ -6731,8 +6849,20 @@ declare class MapSeriesPoint extends ValuePoint {
 declare class MapSeriesDrilldown extends ChartItem<DrilldownOptions> {
     static defaults: DrilldownOptions;
 }
-declare class MapSeriesInternalBorder extends ChartItem<MapInternalBorderOptions> {
-    static defaults: MapInternalBorderOptions;
+declare class MapSeriesBorder extends ChartItem<MapBorderOptions> {
+    name: string;
+    series: MapSeries;
+    static defaults: MapBorderOptions;
+    border: MapBorder;
+    constructor(name: string, series: MapSeries);
+    getPath(): string;
+    protected _doSetSimple(op: MapBorderOptions, src: any): boolean;
+}
+declare class MapSeriesBorders extends ChartItem<MapBordersOptions> {
+    name: string;
+    series: MapSeries;
+    static defaults: MapBordersOptions;
+    constructor(name: string, series: MapSeries);
 }
 /**
  * Map 시리즈 모델.<br/>
@@ -6748,18 +6878,26 @@ declare class MapSeries extends ValueSeries<MapSeriesOptions> {
     private _detailed;
     private _drilldown;
     private _internalBorder;
+    private _externalBorder;
     private _areaPts;
     private _minValue;
     private _maxValue;
     private _colorObj;
     private _colorRanger;
     private _useMapData;
+    private _areaMap;
+    private _hiddenAreas;
+    private _mapBorders;
+    private _saveBorders;
     get areaCount(): number;
     get parent(): MapSeries;
     get detail(): MapSeries;
     get drilldown(): MapSeriesDrilldown;
-    get internalBorder(): MapSeriesInternalBorder;
+    get internalBorder(): MapSeriesBorders;
+    get externalBorder(): MapSeriesBorders;
     get color(): Color;
+    getMapBorders(): MapSeriesBorder[];
+    isHiddenArea(areaId: string): MapArea;
     getHistory(): MapSeries[];
     get(second: boolean, index: number): MapArea;
     pointOf(area: MapArea): MapSeriesPoint;
@@ -6776,7 +6914,7 @@ declare class MapSeries extends ValueSeries<MapSeriesOptions> {
     protected _createLabel(chart: IChart): DataPointLabel;
     private $_createDetail;
     protected _doLoad(options: ChartItemOptions, source: any): void;
-    protected _doApply(options: MapSeriesOptions): void;
+    protected _doApply(op: MapSeriesOptions): void;
     needMapScale(): boolean;
     canAddAnimation(): boolean;
     canRemoveAnimation(): boolean;
@@ -6786,11 +6924,12 @@ declare class MapSeries extends ValueSeries<MapSeriesOptions> {
     protected _createPoint(source: any): MapSeriesPoint;
     protected _getPointArgs(args: DataPointArgs, p: MapSeriesPoint): DataPointArgs;
     _prepareRender(): void;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: MapSeriesOptions): void;
     protected _doLoadPoints(src: any): void;
     setCalcedColor(cs: CSSStyleDeclaration, prop: string): void;
     getColorScale(): string | number;
     canSelect(): boolean;
+    private $_loadBorders;
 }
 
 declare class MapBackground extends ChartItem<MapBackgroundOptions> {
@@ -6805,7 +6944,7 @@ interface IBodyTransform {
     vy: number;
 }
 /**
- * 시리즈, annotation, axis grid 및 guide 등이 표시되는 차트 주 영역 모델.<br/>
+ * 시리즈, annotation, axis grid 및 guide 등이 표시되는 맵차트 주 영역 모델.<br/>
  * {@page options 설정} 모델은 {@page op.BodyOptions}이다.
  */
 declare class Body extends ChartItem<BodyOptions> implements IAnnotationOwner {
@@ -7035,7 +7174,7 @@ declare class ChartObject extends RmEventProvider<IMapChartEvents> implements IC
     selectionItemAdded(item: ISelectionSource): void;
     selectionItemRemoved(item: ISelectionSource): void;
     selectionCleared(): void;
-    get type(): "map" | "feature" | "point" | "pin" | "vector" | "bar" | "pie" | "figure" | "bubble" | "route" | "image" | "line" | "heatmap" | "panel" | "waffle" | "gauge" | "clock";
+    get type(): "line" | "map" | "feature" | "point" | "pin" | "vector" | "bar" | "pie" | "figure" | "bubble" | "route" | "image" | "heatmap" | "panel" | "waffle" | "gauge" | "clock";
     get chartOptions(): ChartOptions;
     get legend(): Legend;
     get credits(): Credits;
@@ -7194,7 +7333,7 @@ declare class ChartItem<OP extends ChartItemOptions = ChartItemOptions> extends
      * 모델 설정 값들을 변경한다.<br/>
      *
      * @param source 설정 옵션들이 포함된 json 객체
-     * @param render true로 지정하면 옵션 변경 시 차트를 다시 그린다. 기본갑 true
+     * @param render true로 지정하면 옵션 변경 시 맵차트를 다시 그린다. 기본갑 true
      * @returns 모델 객체 자신
      */
     updateOptions(source?: OP, render?: boolean): this;
@@ -7203,7 +7342,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;
@@ -7211,7 +7350,7 @@ declare class ChartItem<OP extends ChartItemOptions = ChartItemOptions> extends
      * boolean 타입의 모델 설정 값을 반대 값으로 변경한다.<br/>
      *
      * @param prop 설정 항목 이름
-     * @param render true로 지정하면 옵션 변경 시 차트를 다시 그린다. 기본갑 true
+     * @param render true로 지정하면 옵션 변경 시 맵차트를 다시 그린다. 기본갑 true
      * @returns 모델 객체 자신
      */
     toggleOption(prop: keyof OP, render?: boolean): this;
@@ -7219,21 +7358,21 @@ declare class ChartItem<OP extends ChartItemOptions = ChartItemOptions> extends
      * 명시적으로 설정된 모델 설정 값을 제거해서 모델의 기본 값이 적용되도록 한다.<br/>
      *
      * @param prop 설정 항목 이름
-     * @param render true로 지정하면 옵션 변경 시 차트를 다시 그린다. 기본갑 true
+     * @param render true로 지정하면 옵션 변경 시 맵차트를 다시 그린다. 기본갑 true
      * @returns 모델 객체 자신
      */
     removeOption(prop: keyof OP, render?: boolean): this;
     /**
      * 명시적으로 설정된 모든 모델 설정 값들을 제거한다..<br/>
      *
-     * @param render true로 지정하면 옵션 변경 시 차트를 다시 그린다. 기본갑 true
+     * @param render true로 지정하면 옵션 변경 시 맵차트를 다시 그린다. 기본갑 true
      * @returns 모델 객체 자신
      */
     clearOptions(render?: boolean): this;
     /**
      * 명시적으로 모델에 설정된 모든 style 값들을 제거한다.<br/>
      *
-     * @param render true로 지정하면 옵션 변경 시 차트를 다시 그린다. 기본갑 false
+     * @param render true로 지정하면 옵션 변경 시 맵차트를 다시 그린다. 기본갑 false
      * @returns
      */
     clearStyle(render?: boolean): this;
@@ -7242,7 +7381,7 @@ declare class ChartItem<OP extends ChartItemOptions = ChartItemOptions> extends
      *
      * @param prop css 스타일 항목 이름.
      * @param value 적용할 스타일 값.
-     * @param render true로 지정하면 옵션 변경 시 차트를 다시 그린다. 기본갑 true
+     * @param render true로 지정하면 옵션 변경 시 맵차트를 다시 그린다. 기본갑 true
      * @returns
      */
     setStyle(prop: string, value: any, render?: boolean): this;
@@ -7250,7 +7389,7 @@ declare class ChartItem<OP extends ChartItemOptions = ChartItemOptions> extends
      * 여러 항목의 모델 css style 값들을 json 객체로 지정해서 동시에 변경한다.<br/>
      *
      * @param styles 스타일 항목들과 값들이 설정된 json 객체
-     * @param render true로 지정하면 옵션 변경 시 차트를 다시 그린다. 기본갑 true
+     * @param render true로 지정하면 옵션 변경 시 맵차트를 다시 그린다. 기본갑 true
      * @returns
      */
     setStyles(styles: any, render?: boolean): this;
@@ -7268,7 +7407,7 @@ declare class ChartItem<OP extends ChartItemOptions = ChartItemOptions> extends
     protected _doSave(target: object): void;
     /** @internal */
     protected _doUpdate(source: any): void;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: OP): void;
     protected _doAfterRender(): void;
 }
 declare abstract class ChartItemCollection<T extends ChartItem> {
@@ -7312,7 +7451,7 @@ declare abstract class IconedText<OP extends IconedTextOptions = IconedTextOptio
     private _root;
     abstract getDefaultIconPos(): IconPosition;
     getIconPos(): IconPosition;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: IconedTextOptions): void;
     getUrl(url: string): string;
 }
 declare class MapWidgetBackground extends ChartItem<MapWidgetBackgroundOptions> {
@@ -7348,7 +7487,7 @@ declare abstract class MapWidget<OP extends MapWidgetOptions = MapWidgetOptions>
     _setIndex(value: number): void;
     getDefaultDisplay(caption: MapWidgetCaption): MapWidgetCaptionDisplay;
     protected _doInit(op: MapWidgetOptions): void;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: OP): void;
 }
 declare abstract class MapSimpleWidget<OP extends MapSimpleWidgetOptions = MapSimpleWidgetOptions> extends MapWidget<OP> {
 }
@@ -7368,6 +7507,9 @@ declare abstract class MapWidgetCollection<T extends MapWidget = MapWidget> exte
     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;
@@ -7386,14 +7528,14 @@ declare abstract class ScaleBase<OP extends ScaleOptions = ScaleOptions> extends
     static defaults: ScaleOptions;
     protected _series: ISeries;
     get series(): ISeries<DataPoint>;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: OP): void;
     protected abstract _getScaledSeries(chart: IChart): ISeries;
 }
 
 /**
  * Annotation 모델들의 기반 클래스.<br/>
  * {@page options 옵션} 모델은 {@page op.AnnotationOptions}이고,
- * {@page config 차트 설정}에서 {@page config.annotation 'annotation'} 항목으로 설정한다.
+ * {@page config 맵차트 설정}에서 {@page config.annotation 'annotation'} 항목으로 설정한다.
  * ```js
  * const config = {
  *      annotation: [{
@@ -7449,7 +7591,7 @@ declare abstract class Annotation<OP extends AnnotationOptions = AnnotationOptio
     refresh(): void;
     _load(source: any): OP;
     protected _doApply(options: AnnotationOptions): void;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: AnnotationOptions): void;
 }
 /**
  * @internal
@@ -7478,12 +7620,12 @@ declare class AnnotationCollection extends ChartItemCollection<Annotation> {
 }
 
 /**
- * 차트 생성 이후 호출되는 콜백의 매개변수로 사용된다.
+ * 맵차트 생성 이후 호출되는 콜백의 매개변수로 사용된다.
  */
 interface LoadCallbackArgs extends CommonCallbackArgs {
 }
 /**
- * RealMap 라이브러리의 차트 모델.<br/>
+ * RealMap 라이브러리의 맵차트 모델.<br/>
  */
 declare class MapChart {
     _obj: ChartObject;
@@ -7511,21 +7653,21 @@ declare class MapChart {
      */
     get map(): MapModel;
     /**
-     * 차트 타이틀 모델.
+     * 맵차트 타이틀 모델.
      */
     get title(): Title;
     /**
-     * 차트 부제목 모델.
+     * 맵차트 부제목 모델.
      */
     get subtitle(): Subtitle;
     /**
-     * 차트에 설정된 첫번째 시리즈.<br/>
+     * 맵차트에 설정된 첫번째 시리즈.<br/>
      * {@link guide.series 시리즈 개요} 및
      * {@link config.base.series 시리즈 설정}을 참조한다.
      */
     get series(): Series;
     /**
-     * 차트에 설정된 첫번째 맵시리즈.<br/>
+     * 맵차트에 설정된 첫번째 맵시리즈.<br/>
      * {@link guide.series 시리즈 개요} 및
      * {@link config.base.series 시리즈 설정}을 참조한다.
      */
@@ -7567,11 +7709,11 @@ declare class MapChart {
      */
     get selection(): MapSelection;
     /**
-     * 차트 내보내기 관련 설정 모델.
+     * 맵차트 내보내기 관련 설정 모델.
      */
     get exporter(): Exporter;
     /**
-     * 차트 축의 기준이 되는 맵 모델을 지정한다.<br/>
+     * 맵차트 축의 기준이 되는 맵 모델을 지정한다.<br/>
      * 매개변수를 지정하지 않거나 잘못된 값을 넘기면 첫번째 enabled인 맵으로 설정된다.
      */
     setBaseMap(indexOrName?: number | string): void;
@@ -7599,34 +7741,34 @@ declare class MapChart {
     getAnnotation(name: string): Annotation;
     /**
      * 기존 모델 설정을 모두 제거하고 초기화 한 후,
-     * config로 전달된 설정에 따라 차트를 새로 구성한다.<br/>
+     * config로 전달된 설정에 따라 맵차트를 새로 구성한다.<br/>
      * 기존에 생성되었던 시리즈나 게이지들과 축들이 모두 제거되고 새로 생성된다.
      *
-     * @param config 차트 설정 정보
+     * @param config 맵차트 설정 정보
      */
     load(config: ChartConfiguration, loadAnimation?: boolean, callback?: (param: LoadCallbackArgs) => void): MapChart;
     /**
      * load 메서드의 async 버전. <br/>
      *
      * 기존 모델 설정을 모두 제거하고 초기화 한 후,
-     * config로 전달된 설정에 따라 차트를 새로 구성한다.<br/>
+     * config로 전달된 설정에 따라 맵차트를 새로 구성한다.<br/>
      * 기존에 생성되었던 시리즈나 게이지들과 축들이 모두 제거되고 새로 생성된다.
      *
      * 또한 map과 series 옵션에 url 속성이 있는 경우, 해당 url에서 데이터를 가져온 다음, <br/>
      * 각 옵션의 map 또는 data 속성을 채운다.
      *
-     * @param config 차트 설정 정보
+     * @param config 맵차트 설정 정보
      */
     loadAsync(config: ChartConfiguration, loadAnimation?: boolean, callback?: () => void): Promise<MapChart>;
     /**
-     * {@link load}와 달리 기존 모델을 유지하면서 차트 설정 일부를 반영한다.<br/>
+     * {@link load}와 달리 기존 모델을 유지하면서 맵차트 설정 일부를 반영한다.<br/>
      *
      * @param options 설정 객체
      * @param render true로 지정하면 다시 그리도록 요청한다.
      */
     updateOptions(options: ChartConfiguration, render?: boolean): void;
     /**
-     * 현재 표시 중인 차트를 PNG, JPG 또는 SVG 벡터 이미지로 다운로드한다.
+     * 현재 표시 중인 맵차트를 PNG, JPG 또는 SVG 벡터 이미지로 다운로드한다.
      *
      * ```js
      * chart.export({
@@ -7639,11 +7781,11 @@ declare class MapChart {
      */
     export(options: ExportOptions): void;
     /**
-     * 다음 rendering frame을 기다리지 않고, 차트를 즉시 다시 그린다.<br/>
-     * 차트 rendering 작업은 자원 소모가 많고 소용 시간도 적지 않으므로,
+     * 다음 rendering frame을 기다리지 않고, 맵차트를 즉시 다시 그린다.<br/>
+     * 맵차트 rendering 작업은 자원 소모가 많고 소용 시간도 적지 않으므로,
      * data나 여러 모델을 수정하는 경우 모든 작업이 완료된 후 한 번 호출해야 한다.
      * 가능하면 이 함수는 호출하지 않고
-     * 차트 기본 동작(다음 frame에 이전 변경 사항들을 모아서 한 번 rendering)으로 실행되게 해야 한다.
+     * 맵차트 기본 동작(다음 frame에 이전 변경 사항들을 모아서 한 번 rendering)으로 실행되게 해야 한다.
      */
     render(now?: boolean): void;
     setParam(param: string, value: any, redraw?: boolean): void;
@@ -7663,7 +7805,7 @@ declare class MapChart {
      */
     removeSeries(series: string | Series, animate?: boolean): void;
     /**
-     * 차트 설정의 map.points로 지정한 위치를 리턴한다.
+     * 맵차트 설정의 map.points로 지정한 위치를 리턴한다.
      *
      * @param id 포인트 키.
      * @returns [lon, lat]
@@ -7694,7 +7836,7 @@ declare class Globals {
      */
     static setLicenseKey(key: string): void;
     /**
-     * true로 지정하면 차트 요소별 디버그 경계를 표시한다.<br/>
+     * true로 지정하면 맵차트 요소별 디버그 경계를 표시한다.<br/>
      * 기본은 false 상태다.
      *
      * ```js
@@ -7723,7 +7865,7 @@ declare class Globals {
      */
     static setGlobals(globals: any): void;
     /**
-     * 차트 설정 모델을 기반으로 svg를 생성한 후,
+     * 맵차트 설정 모델을 기반으로 svg를 생성한 후,
      * 지정된 div 엘리먼트의 유일한 자식으로 포함시킨다.\
      * div 전체 영역의 크기로 표시된다.
      *
@@ -7733,14 +7875,14 @@ declare class Globals {
      *
      * @param doc
      * @param container 컨트롤이 생성되는 div 엘리먼트나 id
-     * @param config 차트 모델 설정 JSON
+     * @param config 맵차트 모델 설정 JSON
      * @param animate 첫 로딩 animation을 실행한다.
-     * @param callback 차트가 모두 로드되고 첫 렌더링이 완료된 후 호출되는 콜백 함수.
-     * @returns 생성된 차트 객체
+     * @param callback 맵차트가 모두 로드되고 첫 렌더링이 완료된 후 호출되는 콜백 함수.
+     * @returns 생성된 맵차트 객체
      */
     static createChart(doc: Document, container: string | HTMLDivElement, config: any, animate?: boolean, callback?: (param: LoadCallbackArgs) => void): MapChart;
     /**
-     * 지도 파일이나 데이터가 URL을 통해 제공되는 경우, 데이터를 모두 로드한 뒤 차트를 생성하도록 비동기 처리할 수 있다.
+     * 지도 파일이나 데이터가 URL을 통해 제공되는 경우, 데이터를 모두 로드한 뒤 맵차트를 생성하도록 비동기 처리할 수 있다.
      *
      * ```js
      * const config = {
@@ -7756,16 +7898,16 @@ declare class Globals {
      *
      * @param doc
      * @param container 컨트롤이 생성되는 div 엘리먼트나 id
-     * @param config 차트 모델 설정 JSON
+     * @param config 맵차트 모델 설정 JSON
      * @param animate 첫 로딩 animation을 실행한다.
-     * @param callback 차트가 모두 로드되고 첫 렌더링이 완료된 후 호출되는 콜백 함수.
-     * @returns 생성된 차트 객체
+     * @param callback 맵차트가 모두 로드되고 첫 렌더링이 완료된 후 호출되는 콜백 함수.
+     * @returns 생성된 맵차트 객체
      */
     static createChartAsync(doc: Document, container: string | HTMLDivElement, config: any, animate?: boolean, callback?: (param: LoadCallbackArgs) => void): Promise<MapChart>;
     /**
      * name에 해당하는 기본 제공 객체를 리턴한다.<br/>
      */
-    static preset(name: string, info?: MapInsetDisplay): MapInset;
+    static preset(name: string, info?: boolean | MapInsetDisplay): MapInset;
 }
 
 /**
@@ -8085,8 +8227,6 @@ declare class PolyLineElement extends PathElement {
     setLines(pts: (number | MapCoord | IPoint)[], curved: boolean): void;
 }
 
-type ShapeDrawer = (rd: number, rd2: number) => (string | number)[];
-
 declare class HoverAnimation extends RmAnimation {
     private _series;
     _focused: boolean;
@@ -8563,7 +8703,6 @@ declare class BubbleSeriesPoint extends MarkerSeriesPoint {
     labelCount(): number;
     protected _readObject(series: ISeries<BubbleSeriesPoint>, v: any): void;
     protected _valuesChanged(prev: any): boolean;
-    protected _assignTo(proxy: any): void;
 }
 /**
  * Bubble 시리즈 모델.<br/>
@@ -8597,7 +8736,7 @@ declare class BubbleSeries extends MarkerSeries<BubbleSeriesOptions> {
     pointLabelCount(): number;
     getPointLabels(): DataPointLabel<DataPointLabelOptions>[];
     protected _createPoint(source: any): BubbleSeriesPoint;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: BubbleSeriesOptions): void;
 }
 
 declare class CircleGaugeItem<OP extends ChartItemOptions> extends ChartItem<OP> {
@@ -9021,7 +9160,7 @@ declare class PieSeries extends SparkSeries<PieSeriesOptions> {
     protected _createPoint(source: any): PieSeriesPoint;
     protected _defLabelOff(): number;
     protected _doApply(options: PieSeriesOptions): void;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: PieSeriesOptions): void;
     private $_parseThresholds;
 }
 
@@ -9068,7 +9207,7 @@ declare class PinSeries extends MarkerSeries<PinSeriesOptions> {
         max: number;
     };
     getRangedColor(p: PinSeriesPoint): string;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: PinSeriesOptions): void;
 }
 
 /**
@@ -9171,7 +9310,7 @@ declare class WaffleSeries extends SparkSeries<WaffleSeriesOptions> {
         hCell: number;
         gap: number;
     };
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: WaffleSeriesOptions): void;
     private $_caculate;
     private $_rows;
     private $_cols;
@@ -9246,7 +9385,7 @@ declare class HtmlAnnotation extends Annotation<HtmlAnnotationOptions> {
     private $_apply;
     protected _isVisible(): boolean;
     protected _doSetSimple(op: HtmlAnnotationOptions, src: any): boolean;
-    protected _doPrepareRender(chart: IChart): void;
+    protected _doPrepareRender(chart: IChart, op: HtmlAnnotationOptions): void;
 }
 
 declare abstract class SeriesAnimation {