realmap 1.0.7 → 1.0.8

package/{dist/index.d.ts → index.d.ts}

@@ -94,6 +94,31 @@ type SVGStyleOrClass = SVGStyles | string;
  */
 interface CSSStyles extends Partial<CSSStyleDeclaration> {
 }
+/** @internal */
+interface CSSStyles2 extends CSSStyles {
+    display?: string;
+    position?: string;
+    alignItems?: string;
+    justifyContent?: string;
+    flexDirection?: string;
+    flexWrap?: string;
+    gap?: string;
+    flex?: string;
+    width?: string;
+    height?: string;
+    minHeight?: string;
+    minWidth?: string;
+    maxWidth?: string;
+    left?: string;
+    top?: string;
+    overflow?: string;
+    marginRight?: string;
+    whiteSpace?: string;
+    margin?: string;
+    marginLeft?: string;
+    pointerEvents?: string;
+    transform?: string;
+}
 interface ISides {
     left: number;
     right: number;
@@ -828,7 +853,7 @@ interface AnnotationAnimationOptions {
     type: string;
     duration?: number;
 }
-type AnnotationType = 'image' | 'shape' | 'text';
+type AnnotationType = 'image' | 'shape' | 'text' | 'html';
 /**
  * Annotation 모델.<br/>
  *
@@ -837,7 +862,8 @@ type AnnotationType = 'image' | 'shape' | 'text';
 interface AnnotationOptions extends ChartItemOptions {
     type?: AnnotationType;
     /**
-     * true로 지정하면 시리즈들 위에 표시된다.
+     * true로 지정하면 시리즈들 위에 표시된다.<br/>
+     * 명시적으로 false로 지정해야 시리즈들 아래 표시된다.
      *
      * @default false
      */
@@ -1062,7 +1088,54 @@ interface TextAnnotationOptions extends AnnotationOptions {
      */
     textOrientation?: TextOrientation;
 }
-type AnnotationOptionsType = ImageAnnotationOptions | ShapeAnnotationOptions | TextAnnotationOptions;
+declare const HtmlAnnotationType = "html";
+/**
+ * HTML 어노테이션.<br/>
+ * {@page op.AnnotationOptions#type}은 'html'이다.<br/>
+ *
+ * // TODO #fiddle annotation/html-annotation Html Annotation
+ * @css 'rm-html-annotation'
+ * @config chart.annotation[type=html]
+ */
+interface HtmlAnnotationOptions extends AnnotationOptions {
+    type?: typeof HtmlAnnotationType;
+    /**
+     * true로 설정되고 {@link text}가 설정된 경우에만 표시된다.
+     *
+     * @default true
+     */
+    visible?: boolean;
+    /**
+     * 이 속성으로 지정한 html 내용을 표시한다.<br/>
+     * '.'나 '#'으로 시작되는 html selector로 지정하면 해당하는 dom의 {@page https://developer.mozilla.org/ko/docs/Web/API/Element/innerHTML innerHTML}을 가져와 표시한다.<br/>
+     * 예를 들어 id가 'abc'인 dom인 경우 '#abc'로 지정한다.
+     * 즉, document.{@page https://developer.mozilla.org/ko/docs/Web/API/Document/querySelector querySelector}(htmlFrom)로 리턴되는 dom의 내용을 표시한다.<br/>
+     * 생성되는 dom의 스타일은 {@page htmlStyle}로 지정한다.
+     */
+    html?: string;
+    /**
+     * 이 속성으로 지정한 selector에 해당하는 dom의 {@page https://developer.mozilla.org/ko/docs/Web/API/Element/innerHTML innerHTML}을 가져와 표시한다.<br/>
+     * 예를 들어 id가 'abc'인 dom인 경우 '#abc'로 지정한다.
+     * 즉, document.{@page https://developer.mozilla.org/ko/docs/Web/API/Document/querySelector querySelector}(htmlFrom)로 리턴되는 dom의 내용을 표시한다.<br/>
+     * 이 속성이 {@page html}보다 우선한다. 다만, 존재하지 않은 dom을 지정한 경우 {@page html}에 지정한 내용을 대신 표시한다.
+     * 생성되는 dom의 스타일은 {@page htmlStyle}로 지정한다.
+     */
+    htmlFrom?: string;
+    /**
+     * {@page html}로 생성되는 최상위 dom에 적용되는 스타일셋.<br/>
+     */
+    htmlStyle?: CSSStyleDeclaration;
+    /**
+     * @append
+     * 너비를 반드시 지정해야 한다.<br/>
+     * 지정하지 않으면 100 픽셀 너비로 표시한다.
+     * {@page height 높이}를 지정하지 않으면 생성된 dom의 높이에 맞춰진다.
+     *
+     * @default 100
+     */
+    width?: PercentSize;
+}
+type AnnotationOptionsType = ImageAnnotationOptions | ShapeAnnotationOptions | TextAnnotationOptions | HtmlAnnotationOptions;
 
 /** @internal */
 declare class Color {
@@ -1526,7 +1599,7 @@ declare class RmElement extends RmObject {
     getStyle(prop: string): string;
     hasStyle(className: string): boolean;
     containsDom(dom: Element): boolean;
-    addDom(dom: SVGElement): SVGElement;
+    addDom(dom: SVGElement | HTMLElement): HTMLElement | SVGElement;
     add<T extends RmElement>(child: T): T;
     addAll(...children: RmElement[]): void;
     insertChild<T extends RmElement>(child: T, before: RmElement): T;
@@ -1553,6 +1626,7 @@ declare class RmElement extends RmObject {
     scale(value: number, yValue?: number): this;
     trans(x: number, y: number): RmElement;
     transp(p: IPoint): RmElement;
+    transc(p: MapCoord): RmElement;
     transEx(x: number, y: number, duration?: number, invalidate?: boolean): RmElement;
     transX(x: number): RmElement;
     transY(y: number): RmElement;
@@ -2036,6 +2110,12 @@ interface SeriesOptions extends ChartItemOptions {
      * 콘솔에 경고 메시지가 표시된다.
      */
     dataUrl?: string;
+    /**
+     * {@page data}나 {@page dataUrl}로 지정된 데이터소스에서 시리즈 데이터로 가져올 배열의 위치를 지정한다.<br/>
+     * "aaa.bbb" 형식으로 지정한다. 배열 항목은 숫자로 지정한다. "aaa.2.bbb".
+     * 지정하지 않으면 최상위 JSON 객체를 그대로 사용한다.
+     */
+    dataPath?: string;
     /**
      * {@page data}가 array로 제공되어 datapoint로 생성될 때,
      * array의 각 항목에 해당하는 이름으로 datapoint source의 값을 사용한다.
@@ -3071,15 +3151,65 @@ declare const TiledWebSeriesType = "tiledweb";
 interface TiledWebSeriesOptions extends SeriesOptions {
     type?: typeof TiledWebSeriesType;
 }
+/**
+ * track 시리즈 outline 설정 옵션.<br/>
+ */
+interface TrackSeriesOutlineOptions extends ChartItemOptions {
+}
 declare const TrackSeriesType = "track";
 /**
- * Track Series<br/>
+ * 출발 지점에서 도착 지점까지 복수 지점으로 이어지는 경로를 표시하는 시리즈.<br/>
  * {@page op.SeriesOptions#type}은 'track'이다.<br/>
  *
  * @config chart.series[type=track]
  */
 interface TrackSeriesOptions extends SeriesOptions {
     type?: typeof TrackSeriesType;
+    /**
+     * 각 지점을 표시하는 모양.<br/>
+     * 명시적으로 지정하지 않으면 기본 제공되는 shape 목록 중 하나로 자동 설정된다.<br/>
+     */
+    shape?: Shape;
+    /**
+     * 지점 표시 {@page shape 도형}의 반지름.<br/>
+     *
+     * @default 3 픽셀
+     */
+    radius?: number;
+    /**
+     * track 시리즈 outline 설정 옵션.<br/>
+     */
+    outline?: TrackSeriesOutlineOptions | boolean;
+}
+declare const BandSeriesType = "band";
+/**
+ * Band Series<br/>
+ * {@page op.SeriesOptions#type}은 'band'이다.<br/>
+ *
+ * @config chart.series[type=band]
+ */
+interface BandSeriesOptions extends SeriesOptions {
+    type?: typeof BandSeriesType;
+}
+declare const TableSeriesType = "table";
+/**
+ * Table Series<br/>
+ * {@page op.SeriesOptions#type}은 'table'이다.<br/>
+ *
+ * @config chart.series[type=table]
+ */
+interface TableSeriesOptions extends SeriesOptions {
+    type?: typeof TableSeriesType;
+}
+declare const ChartSeriesType = "chart";
+/**
+ * Chart Series<br/>
+ * {@page op.SeriesOptions#type}은 'chart'이다.<br/>
+ *
+ * @config chart.series[type=chart]
+ */
+interface ChartSeriesOptions extends SeriesOptions {
+    type?: typeof ChartSeriesType;
 }
 declare const SankeySeriesType = "sankey";
 /**
@@ -4597,6 +4727,7 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     static defaults: SeriesOptions;
     static getPointTooltipParam(series: Series, point: DataPoint, param: string): any;
     private _data;
+    private _dataPath;
     private _name;
     index: number;
     seriesIndex: number;
@@ -6245,6 +6376,7 @@ declare class MapSeriesPoint extends ValuePoint {
     protected _readObject(series: MapSeries, v: any): void;
     getLabel(index: number): string;
     getParam(param: string): any;
+    _valuesChanged(prev: any): boolean;
 }
 declare class MapSeriesDrilldown extends ChartItem<DrilldownOptions> {
     static defaults: DrilldownOptions;
@@ -7451,6 +7583,10 @@ declare class LineElement extends PathElement {
     setHLine(y: number, x1: number, x2: number): void;
     setHLineC(y: number, x1: number, x2: number): void;
 }
+declare class PolyLineElement extends PathElement {
+    constructor(doc: Document, styleName?: string, lines?: (number | IPoint)[], curved?: boolean);
+    setLines(pts: (number | MapCoord | IPoint)[], curved: boolean): void;
+}
 
 type ShapeDrawer = (rd: number, rd2: number) => (string | number)[];
 
@@ -8463,7 +8599,7 @@ declare class PointSeries extends MarkerSeries<PointSeriesOptions> {
     private _stroke;
     private _strokeWidth;
     constructor(chart: IChart);
-    getShape(p: PointSeriesPoint): Shape;
+    getShape(): Shape;
     getRadius(): number;
     setLegendMarkerStyle(marker: RmElement): void;
     protected _createPoint(source: any): PointSeriesPoint;
@@ -8475,7 +8611,7 @@ declare class PointSeries extends MarkerSeries<PointSeriesOptions> {
 }
 
 declare class RouteSeriesPoint extends DataPoint {
-    coords: [[number, number], [number, number]];
+    coords: [MapCoord, MapCoord];
     path: any[];
     get lon1(): number;
     get lat1(): number;
@@ -8598,6 +8734,26 @@ declare class ShapeAnnotation extends Annotation<ShapeAnnotationOptions> {
     protected _doSetSimple(src: any): boolean;
 }
 
+/**
+ * Text Annotation 모델.<br/>
+ * {@page op.AnnotationOptions#type}은 {@page config.annotation.image 'shape'}이고,
+ * {@page options 설정} 모델은 {@page op.ShapeAnnotationOptions}이다.
+ */
+declare class HtmlAnnotation extends Annotation<HtmlAnnotationOptions> {
+    static readonly DEF_SIZE = 100;
+    static readonly type = "html";
+    static defaults: HtmlAnnotationOptions;
+    private _params;
+    setParams(params: object): void;
+    applyParams(target: string): string;
+    /**
+     * ${param;default}
+     */
+    private $_apply;
+    protected _isVisible(): boolean;
+    protected _doSetSimple(src: any): boolean;
+}
+
 declare abstract class SeriesAnimation {
     static reveal(series: SeriesView<Series>, options?: IRevealAnimation): void;
     static grow(series: SeriesView<Series>, endHandler?: RmAnimationEndHandler): void;
@@ -8788,6 +8944,90 @@ declare class Utils {
         min: number;
         max: number;
     };
+    /**
+     * @param path 'aaa.bbb.2.ccc' 형식으로 지정한다. 2는 배열 항목 index.
+     */
+    static valueAt(data: any, path?: string): any;
+}
+
+interface IDomContaner {
+    dom(): Element;
+}
+/**
+ * @internal
+ *
+ * Utilities for HTML element.
+ */
+declare class Dom {
+    static getWin(doc: Document): Window;
+    static isVisible(elt: HTMLElement): boolean;
+    static setVisible(elt: HTMLElement | SVGSVGElement, visible: boolean, visibleStyle?: string): boolean;
+    static hide(elt: HTMLElement | SVGSVGElement): void;
+    static show(elt: HTMLElement | SVGSVGElement, visibleStyle?: string): void;
+    static addClass(elt: HTMLElement | SVGSVGElement, className: string): HTMLElement | SVGSVGElement;
+    static removeClass(elt: HTMLElement | SVGSVGElement, className: string): HTMLElement | SVGSVGElement;
+    static getImageUrl(css: CSSStyleDeclaration): string;
+    static getFocused(): HTMLElement;
+    static isAncestorOf(elt: HTMLElement, child: HTMLElement): boolean;
+    static getOffset(elt: HTMLElement): {
+        x: number;
+        y: number;
+    };
+    static getSize(elt: HTMLElement): {
+        width: number;
+        height: number;
+    };
+    static moveX(elt: HTMLElement, x: number): void;
+    static moveY(elt: HTMLElement, y: number): void;
+    static move(elt: HTMLElement | SVGSVGElement, x: number, y: number): void;
+    static moveI(elt: HTMLElement, x: number, y: number): void;
+    static resize(elt: HTMLElement | SVGSVGElement, width: number, height: number): void;
+    static resizeSVG(elt: SVGSVGElement, width: number, height: number): void;
+    static setWidth(elt: HTMLElement, width: number): void;
+    static setHeight(elt: HTMLElement, height: number): void;
+    static getBrowserSize(elt?: HTMLElement): {
+        width: number;
+        height: number;
+    };
+    static setRect(elt: HTMLElement, r: IRect): void;
+    static setBounds(elt: HTMLElement, x: number, y: number, w: number, h: number): void;
+    static setBoundsEx(elt: HTMLElement, x: number, y: number, w: number, h: number): void;
+    static getClientRect(elt: HTMLElement): ClientRect | DOMRect;
+    static getChildIndex(elt: HTMLElement): number;
+    static clearChildren(parent: Element): void;
+    static clearElements(parent: Element): void;
+    static append(elt: Node, child: Node): void;
+    static addChild(elt: HTMLElement, child: HTMLElement): boolean;
+    static removeChild(elt: HTMLElement, child: HTMLElement): boolean;
+    static removeChildren(elt: Element, children: (Element | IDomContaner)[]): void;
+    static remove(elt: Node): null;
+    static clearStyle(elt: HTMLElement): void;
+    static removeStyles(css: CSSStyleDeclaration, style: CSSStyles2): void;
+    static setStyle(elt: HTMLElement, style: CSSStyles2): void;
+    static replaceStyle(css: CSSStyleDeclaration, style: CSSStyles2, prevStyle: CSSStyles2): CSSStyles2;
+    static createElement<K extends keyof HTMLElementTagNameMap>(doc: Document, tagName: K, style: CSSStyles2): HTMLElementTagNameMap[K];
+    static htmlEncode(text: string): string;
+    static setData(elt: HTMLElement | SVGSVGElement, name: string, value: any): void;
+    static toggleData(elt: HTMLElement | SVGSVGElement, name: string, value: boolean): void;
+    static getData(elt: HTMLElement, name: string): any;
+    static hasData(elt: HTMLElement, name: string): boolean;
+    static setVar(elt: HTMLElement | SVGSVGElement, name: string, value: string): void;
+    static animate(elt: HTMLElement, prop: string, from: any, to: any, duration?: number, fill?: string): Animation;
+    static setAttr(elt: Element, attr: string, value: any): void;
+    static setAttrs(elt: Element, attrs: any): void;
+    static getDomId(): string;
+    static createBR(doc: Document, className: string): HTMLBRElement;
+    static createSpan(doc: Document, style: CSSStyles2): HTMLSpanElement;
+    static createCheckBox(doc: Document, style: CSSStyles2): HTMLInputElement;
+    static createRadio(doc: Document, style: CSSStyles2): HTMLInputElement;
+    static getPadding(dom: HTMLElement | SVGElement): ISides;
+    static getPaddingEx(dom: HTMLElement | SVGElement): ISides;
+    static stopAnimation(ani: Animation): null;
+    static childByPath(dom: Node, path: number[]): Node;
+    static childByClass<T extends Element>(parent: HTMLElement, className: string): T;
+    static setDisabled(dom: Element, value: boolean): void;
+    static setImportantStyle(css: CSSStyleDeclaration, property: string, value: string): void;
+    static setNoScale(elt: SVGElement): void;
 }
 
 declare const getVersion: typeof Globals.getVersion;
@@ -8798,4 +9038,4 @@ declare const createChart: typeof Globals.createChart;
 declare const createChartAsync: typeof Globals.createChartAsync;
 declare const preset: typeof Globals.preset;
 
-export { Align, Annotation, AnnotationAnimationOptions, AnnotationOptions, AnnotationOptionsType, AssetItemOptions, AssetOptionsType, BackgroundImageOptions, BarSeries, BarSeriesOptions, Body, BodyView, BubbleSeries, BubbleSeriesOptions, ChartConfiguration, ChartControl, ChartElement, ChartItem, ChartItemOptions, ChartObject, ChartOptionsOptions, ChartTextOptions, ChartView, CircleElement, CircleGauge, ClockGauge, Color, ColorListOptions, ColorRanger, CreditsOptions, DataPoint, DataPointArgs as DataPointCallbackArgs, DataPointLabel, DataPointLabelOptions, ElementPool, ExportOptions, Exporter, ExporterOptions, FeatureSeriesLabelOptions, FeatureSeriesOptions, FeatureSeriesType, FigureSeries, GradientOptions, HeatmapSeriesOptions, HeatmapSeriesType, IChart, ILegendSource, IPercentSize, IPointView, IRect, ISeries, IconedTextOptions, ImageAnnotation, ImageAnnotationOptions, ImageListOptions, ImageSeries, Legend, LegendOptions, LineElement, LineSeries, LineSeriesOptions, LinearGradientOptions, LoadCallbackArgs, MapArea, MapAxis, MapAxisBandGuide, MapAxisGuide, MapAxisLineGuide, MapAxisRangeGuide, MapChart, MapCoord, MapCrosshair, MapInset, MapInsetDisplay, MapSeries, MapSeriesLabelOptions, MapSeriesOptions, MapSeriesType, MapBackgroundOptions as MapViewBackgroundOptions, BodyOptions as MapViewOptions, MarkerSeries, MarkerSeriesOptions, MarkerSeriesPoint, MarkerSeriesPointView, MarkerSeriesView, ORG_ANGLE, OrthogonalSparkSeries, PI_2, PanelSeries, PatternOptions, PercentSize, PieSeries, PieSeriesOptions, PinSeries, PointElement, PointLabelView, PointSeries, PointViewPool, PointViewPosition, ProjectionType, RAD_DEG, RadialGradientOptions, RectElement, RmElement, RouteSeries, RouteSeriesOptions, RouteSeriesType, SVGStyleOrClass, SVGStyles, SankeySeriesOptions, SankeySeriesType, SectionView, SectorElement, Series, SeriesAnimation, SeriesOptions, SeriesOptionsType, SeriesView, ShapeAnnotation, ShapeAnnotationOptions, Size, SparkSeries, Subtitle, SubtitleOptions, TextAnchor, TextAnnotation, TextAnnotationOptions, TextElement, TextLayout, TiledWebSeriesOptions, TiledWebSeriesType, Title, TitleOptions, TooltipOptions, TrackSeriesOptions, 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, setLogging, sin };
+export { Align, Annotation, AnnotationAnimationOptions, AnnotationOptions, AnnotationOptionsType, AssetItemOptions, AssetOptionsType, BackgroundImageOptions, BandSeriesOptions, BandSeriesType, BarSeries, BarSeriesOptions, Body, BodyView, BubbleSeries, BubbleSeriesOptions, ChartConfiguration, ChartControl, ChartElement, ChartItem, ChartItemOptions, ChartObject, ChartOptionsOptions, ChartSeriesOptions, ChartSeriesType, ChartTextOptions, ChartView, CircleElement, CircleGauge, ClockGauge, Color, ColorListOptions, ColorRanger, CreditsOptions, DataPoint, DataPointArgs as DataPointCallbackArgs, DataPointLabel, DataPointLabelOptions, Dom, ElementPool, ExportOptions, Exporter, ExporterOptions, FeatureSeriesLabelOptions, FeatureSeriesOptions, FeatureSeriesType, FigureSeries, GradientOptions, HeatmapSeriesOptions, HeatmapSeriesType, HtmlAnnotation, IChart, ILegendSource, IPercentSize, IPointView, IRect, ISeries, 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, 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, setLogging, sin };