realchart 0.9.33 → 0.9.35

package/dist/index.d.ts

@@ -514,7 +514,7 @@ declare class SvgRichText {
     setFormat(value: string): void;
     lines(): SvgLine[];
     build(view: TextElement, maxWidth: number, maxHeight: number, target: any, domain: IRichTextDomain): void;
-    layout(view: TextElement, align: Align, width: number, height: number, padding: Sides): void;
+    layout(tv: TextElement, align: Align, width: number, height: number, pad: Sides): void;
     $_parse(fmt: string): void;
 }
 
@@ -523,6 +523,13 @@ declare enum PaletteMode {
     SHUFFLE = "shuffle",
     RANDOM = "random"
 }
+declare enum SeriesLoadAnimation {
+    DEFAULT = "default",
+    REVEAL = "reveal",
+    GROW = "grow",
+    SPREAD = "spread",
+    FADEIN = "fadein"
+}
 
 interface IAssetItem {
     id: string;
@@ -643,6 +650,129 @@ declare class BackgroundImage extends ChartItem {
     style: SVGStyleOrClass;
 }
 
+declare enum AnnotationScope {
+    CHART = "chart",
+    CONTAINER = "container"
+}
+declare abstract class Annotation extends ChartItem {
+    inBody: boolean;
+    private _width;
+    private _height;
+    private _widthDim;
+    private _heightDim;
+    _x: number;
+    _y: number;
+    _w: number;
+    _h: number;
+    constructor(chart: IChart, inBody: boolean);
+    abstract _type(): string;
+    front: boolean;
+    name: string;
+    align: Align;
+    verticalAlign: VerticalAlign;
+    offsetX: number;
+    offsetY: number;
+    rotation: number;
+    scope: AnnotationScope;
+    loadAnimation: IAnnotationAnimation;
+    backgroundStyle: SVGStyleOrClass;
+    noClip: boolean;
+    x1: number | Date;
+    x2: number | Date;
+    y1: number | Date;
+    y2: number | Date;
+    get width(): RtPercentSize;
+    set width(value: RtPercentSize);
+    get height(): RtPercentSize;
+    set height(value: RtPercentSize);
+    getSize(wDomain: number, hDomain: number): ISize;
+    getPosition(inverted: boolean, left: number, top: number, wDomain: number, hDomain: number, width: number, height: number): IPoint;
+    update(): void;
+    protected _doPrepareRender(chart: IChart): void;
+}
+
+declare enum ZoomType {
+    NONE = "none",
+    X = "x",
+    Y = "y",
+    BOTH = "both"
+}
+declare class ZoomButton extends ChartItem {
+    body: Body;
+    constructor(body: Body);
+    isVisible(): boolean;
+}
+declare class BodySplit extends ChartItem {
+    body: Body;
+    constructor(body: Body);
+    size: number;
+}
+interface IPolar {
+    start: number;
+    total: number;
+    cx: number;
+    cy: number;
+    rd: number;
+}
+declare class Body extends ChartItem {
+    private _radius;
+    private _centerX;
+    private _centerY;
+    private _annotations;
+    private _radiusDim;
+    private _cxDim;
+    private _cyDim;
+    private _rd;
+    private _cx;
+    private _cy;
+    constructor(chart: IChart);
+    split: BodySplit;
+    get radius(): RtPercentSize;
+    set radius(value: RtPercentSize);
+    innerRadius: RtPercentSize;
+    get centerX(): RtPercentSize;
+    set centerX(value: RtPercentSize);
+    get centerY(): RtPercentSize;
+    set centerY(value: RtPercentSize);
+    circular: boolean;
+    image: BackgroundImage;
+    zoomType: ZoomType;
+    zoomButton: ZoomButton;
+    canZoom(): boolean;
+    calcRadius(width: number, height: number): number;
+    setPolar(width: number, height: number): Body;
+    getPolar(axis: Axis): IPolar;
+    isZoomed(): boolean;
+    '@config annotation': Annotation[];
+    getAnnotations(): Annotation[];
+    getAnnotation(name: string): Annotation;
+    protected _doLoadProp(prop: string, value: any): boolean;
+    protected _doPrepareRender(chart: IChart): void;
+    private $_loadAnnotations;
+}
+
+type RcAnimationEndHandler = (ani: RcAnimation) => void;
+declare abstract class RcAnimation {
+    static readonly DURATION = 700;
+    static readonly SHORT_DURATION = 300;
+    delay: number;
+    duration: number;
+    easing: string;
+    endHandler: RcAnimationEndHandler;
+    private _easing;
+    private _started;
+    private _timer;
+    private _handler;
+    start(endHandler?: RcAnimationEndHandler): RcAnimation;
+    stop(): void;
+    protected _start(duration: number, delay?: number, easing?: string): void;
+    protected _stop(): void;
+    protected _doStart(): void;
+    protected _doStop(): void;
+    protected _canUpdate(): boolean;
+    protected abstract _doUpdate(rate: number): boolean;
+}
+
 declare enum Shape {
     CIRCLE = "circle",
     DIAMOND = "diamond",
@@ -688,91 +818,6 @@ declare class ChartDataCollection {
     load(source: any): void;
 }
 
-type RcAnimationEndHandler = (ani: RcAnimation) => void;
-declare abstract class RcAnimation {
-    static readonly DURATION = 700;
-    static readonly SHORT_DURATION = 300;
-    delay: number;
-    duration: number;
-    easing: string;
-    endHandler: RcAnimationEndHandler;
-    private _easing;
-    private _started;
-    private _timer;
-    private _handler;
-    start(endHandler?: RcAnimationEndHandler): RcAnimation;
-    stop(): void;
-    protected _start(duration: number, delay?: number, easing?: string): void;
-    protected _stop(): void;
-    protected _doStart(): void;
-    protected _doStop(): void;
-    protected _canUpdate(): boolean;
-    protected abstract _doUpdate(rate: number): boolean;
-}
-
-declare class DataPoint {
-    index: number;
-    vindex: number;
-    x: any;
-    y: any;
-    series: string | number;
-    readonly pid: number;
-    source: any;
-    isNull: boolean;
-    xValue: number;
-    yValue: number;
-    yRate: number;
-    visible: boolean;
-    color: string;
-    xPos: number;
-    yPos: number;
-    yGroup: number;
-    drillDown: any[] | object;
-    range: IValueRange;
-    zValue: number;
-    label: any;
-    ani: RcAnimation;
-    yPrev: number;
-    yNew: number;
-    constructor(source: any);
-    ariaHint(): string;
-    labelCount(): number;
-    getValue(): number;
-    proxy(): any;
-    assignTo(proxy?: any): any;
-    getProp(fld: string | number): any;
-    parse(series: ISeries): void;
-    getLabel(index: number): any;
-    swap(): void;
-    getTooltipPos(): IPoint;
-    updateValue(value: number, animation: RcAnimation): void;
-    cleanValue(): void;
-    getTooltip(param: string): any;
-    protected _assignTo(proxy: any): any;
-    protected _readArray(series: ISeries, v: any[]): void;
-    protected _readObject(series: ISeries, v: any): void;
-    protected _readSingle(v: any): void;
-}
-declare class DataPointCollection {
-    protected _owner: ISeries;
-    private _points;
-    constructor(owner: ISeries);
-    get count(): number;
-    isEmpty(): boolean;
-    get(index: number): DataPoint;
-    pointAt(xValue: number | any): DataPoint;
-    contains(p: DataPoint): boolean;
-    load(source: any): void;
-    clear(): void;
-    add(p: DataPoint): void;
-    remove(p: DataPoint): boolean;
-    getProps(prop: string | number): any[];
-    getCategories(axis: string): any[];
-    getProxies(): any[];
-    forEach(callback: (p: DataPoint, i?: number) => any): void;
-    getPoints(xAxis: IAxis, yAxis: IAxis): DataPoint[];
-}
-
 declare abstract class Widget extends ChartItem {
     protected _doLoad(source: any): void;
     protected _doPrepareRender(chart: IChart): void;
@@ -844,9 +889,11 @@ declare class DataPointLabel extends IconedText {
     textAlign: Align;
     offset: number;
     distance: number;
+    textField: string;
     textCallback: (point: any) => string;
     visibleCallback: (point: any) => boolean;
     styleCallback: (point: any) => SVGStyleOrClass;
+    getValue(p: DataPoint, index: number): any;
     getTextDomain(p: DataPoint): IRichTextDomain;
     getText(value: any): string;
     getOffset(): number;
@@ -976,7 +1023,7 @@ declare abstract class Series extends ChartItem implements ISeries, IChartDataLi
     _yFielder: (src: any) => any;
     _zFielder: (src: any) => any;
     _colorFielder: (src: any) => any;
-    _dataDirty: boolean;
+    _dataSourceDirty: boolean;
     _cdata: ChartData;
     protected _points: DataPointCollection;
     _runPoints: DataPoint[];
@@ -1035,6 +1082,8 @@ declare abstract class Series extends ChartItem implements ISeries, IChartDataLi
     visibleInLegend: boolean;
     visibleInNavigator: boolean;
     tooltipText: string;
+    tooltipCallback: (args: any) => string;
+    loadAnimation: SeriesLoadAnimation;
     pointStyleCallback: PointStyleCallback;
     onPointClick: PointClickCallback;
     contains(p: DataPoint): boolean;
@@ -1052,6 +1101,7 @@ declare abstract class Series extends ChartItem implements ISeries, IChartDataLi
     legendMarker(doc: Document, size: number): RcElement;
     legendColor(): string;
     legendLabel(): string;
+    styleLegendMarker(marker: RcElement): void;
     canMixWith(other: IPlottingItem): boolean;
     getBaseValue(axis: IAxis): number;
     isBased(axis: IAxis): boolean;
@@ -1110,6 +1160,7 @@ declare abstract class Series extends ChartItem implements ISeries, IChartDataLi
     _colorByPoint(): boolean;
     protected _createFielder(f: any): (v: any) => any;
     protected _createFielders(): void;
+    protected _defaultLoadAnimation(): SeriesLoadAnimation;
     protected _doLoad(src: any): void;
     protected _doLoadData(src: any): any[];
     _loadPoints(data: any): void;
@@ -1232,88 +1283,67 @@ declare abstract class SeriesGroup<T extends Series> extends ChartItem implement
     private $_collectFill;
 }
 
-declare enum AnnotationScope {
-    CHART = "chart",
-    CONTAINER = "container"
-}
-declare abstract class Annotation extends ChartItem {
-    _seriesObj: ISeries;
-    constructor(chart: IChart);
-    abstract _type(): string;
-    front: boolean;
-    name: string;
-    align: Align;
-    verticalAlign: VerticalAlign;
-    offsetX: number;
-    offsetY: number;
-    rotation: number;
-    scope: AnnotationScope;
-    series: string;
-    loadAnimation: IAnnotationAnimation;
-    backgroundStyle: SVGStyleOrClass;
-    getPosition(inverted: boolean, left: number, top: number, wDomain: number, hDomain: number, width: number, height: number): IPoint;
-    update(): void;
-    protected _doPrepareRender(chart: IChart): void;
-}
-
-declare enum ZoomType {
-    NONE = "none",
-    X = "x",
-    Y = "y",
-    BOTH = "both"
-}
-declare class ZoomButton extends ChartItem {
-    body: Body;
-    constructor(body: Body);
-    isVisible(): boolean;
-}
-declare class BodySplit extends ChartItem {
-    body: Body;
-    constructor(body: Body);
-    size: number;
-}
-interface IPolar {
-    start: number;
-    total: number;
-    cx: number;
-    cy: number;
-    rd: number;
+declare class DataPoint {
+    index: number;
+    vindex: number;
+    x: any;
+    y: any;
+    series: string | number;
+    readonly pid: number;
+    source: any;
+    isNull: boolean;
+    xValue: number;
+    yValue: number;
+    yRate: number;
+    visible: boolean;
+    color: string;
+    xPos: number;
+    yPos: number;
+    yGroup: number;
+    drillDown: any[] | object;
+    range: IValueRange;
+    zValue: number;
+    yLabel: any;
+    ani: RcAnimation;
+    yPrev: number;
+    yNew: number;
+    constructor(source: any);
+    ariaHint(): string;
+    labelCount(): number;
+    getValue(): number;
+    proxy(): any;
+    assignTo(proxy?: any): any;
+    getProp(fld: string | number): any;
+    parse(series: ISeries): void;
+    getLabelValue(index: number): any;
+    swap(): void;
+    getTooltipPos(): IPoint;
+    updateValue(value: number, animation: RcAnimation): void;
+    cleanValue(): void;
+    getTooltip(param: string): any;
+    protected _assignTo(proxy: any): any;
+    protected _readArray(series: ISeries, v: any[]): void;
+    protected _readObject(series: ISeries, v: any): void;
+    protected _readSingle(v: any): void;
 }
-declare class Body extends ChartItem {
-    private _radius;
-    private _centerX;
-    private _centerY;
-    private _annotations;
-    private _radiusDim;
-    private _cxDim;
-    private _cyDim;
-    private _rd;
-    private _cx;
-    private _cy;
-    constructor(chart: IChart);
-    split: BodySplit;
-    get radius(): RtPercentSize;
-    set radius(value: RtPercentSize);
-    innerRadius: RtPercentSize;
-    get centerX(): RtPercentSize;
-    set centerX(value: RtPercentSize);
-    get centerY(): RtPercentSize;
-    set centerY(value: RtPercentSize);
-    circular: boolean;
-    image: BackgroundImage;
-    zoomType: ZoomType;
-    zoomButton: ZoomButton;
-    canZoom(): boolean;
-    calcRadius(width: number, height: number): number;
-    setPolar(width: number, height: number): Body;
-    getPolar(axis: Axis): IPolar;
-    isZoomed(): boolean;
-    '@config annotation': Annotation[];
-    getAnnotations(): Annotation[];
-    getAnnotation(name: string): Annotation;
-    protected _doLoadProp(prop: string, value: any): boolean;
-    protected _doPrepareRender(chart: IChart): void;
-    private $_loadAnnotations;
+declare class DataPointCollection {
+    protected _owner: ISeries;
+    private _points;
+    constructor(owner: ISeries);
+    get count(): number;
+    isEmpty(): boolean;
+    get(index: number): DataPoint;
+    pointAt(xValue: number | any): DataPoint;
+    contains(p: DataPoint): boolean;
+    load(source: any): void;
+    clear(): void;
+    add(p: DataPoint): void;
+    remove(p: DataPoint): boolean;
+    getProps(prop: string | number): any[];
+    getCategories(axis: string): any[];
+    getProxies(): any[];
+    forEach(callback: (p: DataPoint, i?: number) => any): void;
+    getPoints(xAxis: IAxis, yAxis: IAxis): DataPoint[];
 }
 
 declare class Title extends ChartItem {
@@ -1350,8 +1380,6 @@ declare abstract class GaugeBase extends Widget {
     private _right;
     private _top;
     private _bottom;
-    row: number;
-    col: number;
     index: number;
     private _sizeDim;
     private _widthDim;
@@ -1363,6 +1391,8 @@ declare abstract class GaugeBase extends Widget {
     constructor(chart: IChart);
     abstract _type(): string;
     name: string;
+    row: number;
+    col: number;
     get left(): RtPercentSize;
     set left(value: RtPercentSize);
     get right(): RtPercentSize;
@@ -1377,7 +1407,7 @@ declare abstract class GaugeBase extends Widget {
     set height(value: RtPercentSize);
     get size(): RtPercentSize;
     set size(value: RtPercentSize);
-    paneStyle: SVGStyleOrClass;
+    backgroundStyle: SVGStyleOrClass;
     getSize(width: number, height: number): ISize;
     getLeft(doamin: number): number;
     getRight(doamin: number): number;
@@ -1417,7 +1447,7 @@ declare class GaugeCollection {
     private _visibles;
     private _gauges;
     constructor(chart: IChart);
-    get count(): number;
+    isEmpty(): boolean;
     get firstGauge(): Gauge;
     getVisibles(): GaugeBase[];
     getPaneVisibles(row: number, col: number): GaugeBase[];
@@ -2069,7 +2099,7 @@ declare class RcChartControl {
     private _proxy;
     private _exporter;
     private constructor();
-    load(config: any, animate?: boolean): void;
+    load(config: any, animate?: boolean, callback?: () => void): void;
     render(now?: boolean): void;
     get xAxis(): RcChartAxis;
     getXAxis(name: string | number): RcChartAxis;
@@ -2132,7 +2162,7 @@ declare class Globals {
     static setDebugging(debug: boolean): void;
     static setLogging(logging: boolean): void;
     static setAnimatable(value: boolean): void;
-    static createChart(doc: Document, container: string | HTMLDivElement, config: any, animate?: boolean): RcChartControl;
+    static createChart(doc: Document, container: string | HTMLDivElement, config: any, animate?: boolean, callback?: () => void): RcChartControl;
     static createData(options?: IRcChartDataOptions, rows?: any[]): RcChartData;
 }