realchart 0.9.14 → 0.9.16

package/dist/index.d.ts

@@ -41,6 +41,7 @@ interface IValueRange {
     toValue?: number;
     color: string;
     label?: string;
+    style?: SVGStyleOrClass;
 }
 
 declare abstract class RcObject {
@@ -69,6 +70,11 @@ declare abstract class RcWrappableObject extends RcObject {
     isWrapper(w: any): boolean;
 }
 
+interface IPoint {
+    x: number;
+    y: number;
+}
+
 interface ISize {
     width: number;
     height: number;
@@ -81,11 +87,6 @@ interface IRect {
     height: number;
 }
 
-interface IPoint {
-    x: number;
-    y: number;
-}
-
 interface IPointerHandler {
     handleDown(ev: PointerEvent): void;
     handleUp(ev: PointerEvent): void;
@@ -123,6 +124,7 @@ declare abstract class RcControl extends RcWrappableObject {
     svg(): SVGSVGElement;
     width(): number;
     height(): number;
+    clipContainer(): SVGElement;
     setData(data: string, value: any, container?: boolean): void;
     clearDefs(): void;
     private $_clearDefs;
@@ -229,7 +231,7 @@ declare class RcElement extends RcObject {
     setVisible(value: boolean): boolean;
     get rotation(): number;
     set rotation(value: number);
-    setRotaion(originX: number, originY: number, rotation: number): RcElement;
+    setRotation(originX: number, originY: number, rotation: number): RcElement;
     getStyle(prop: string): string;
     hasStyle(className: string): boolean;
     add(child: RcElement): RcElement;
@@ -305,7 +307,7 @@ declare class RcElement extends RcObject {
 declare class ClipElement extends RcElement {
     private _id;
     private _rect;
-    constructor(doc: Document, x: number, y: number, width: number, height: number, rx?: number, ry?: number);
+    constructor(doc: Document, x?: number, y?: number, width?: number, height?: number, rx?: number, ry?: number);
     get id(): string;
     setBounds(x: number, y: number, w: number, h: number): RcElement;
     get x(): number;
@@ -461,6 +463,23 @@ declare abstract class FormattableText extends ChartText {
     private $_getNumberText;
     protected _getText(text: string, value: any, useSymbols: boolean, forceSymbols?: boolean): string;
 }
+declare class BackgroundImage extends ChartItem {
+    url: string;
+    style: SVGStyleOrClass;
+}
+
+declare abstract class Annotation extends ChartItem {
+    constructor(chart: IChart);
+    abstract _type(): string;
+    front: boolean;
+    name: string;
+    align: Align;
+    verticalAlign: VerticalAlign;
+    offsetX: number;
+    offsetY: number;
+    rotation: number;
+    getPostion(wDomain: number, hDomain: number, width: number, height: number): IPoint;
+}
 
 declare enum Shape {
     CIRCLE = "circle",
@@ -502,6 +521,7 @@ declare class DataPoint {
     yPos: number;
     yGroup: number;
     drillDown: any[] | object;
+    range: IValueRange;
     constructor(source: any);
     get yAbs(): number;
     get xAbs(): number;
@@ -579,11 +599,15 @@ declare class DataPointLabel extends FormattableText {
     protected _doLoad(source: any): void;
 }
 interface IPlottingItem {
+    _row: number;
+    _col: number;
+    row: number;
+    col: number;
     index: number;
     xAxis: string | number;
     yAxis: string | number;
     visible: boolean;
-    isSide(): boolean;
+    zOrder: number;
     getVisiblePoints(): DataPoint[];
     getLegendSources(list: ILegendSource[]): void;
     needAxes(): boolean;
@@ -661,7 +685,6 @@ interface ISeries extends IPlottingItem {
     displayName(): string;
     createPoints(source: any[]): DataPoint[];
     getPoints(): DataPointCollection;
-    getValue(point: DataPoint, axis: IAxis): number;
     isVisible(p: DataPoint): boolean;
 }
 interface IDataPointCallbackArgs {
@@ -670,6 +693,8 @@ interface IDataPointCallbackArgs {
     vcount: number;
     yMin: number;
     yMax: number;
+    xMin: number;
+    xMax: number;
     index: number;
     vindex: number;
     x: any;
@@ -682,16 +707,21 @@ type PointClickCallbck = (args: IDataPointCallbackArgs) => boolean;
 declare abstract class Series extends ChartItem implements ISeries, ILegendSource {
     static readonly LEGEND_MARKER = "rct-legend-item-marker";
     static _loadSeries(chart: IChart, src: any, defType?: string): Series;
-    private _ranges;
+    _row: number;
+    _col: number;
     index: number;
     group: SeriesGroup<Series>;
     _xAxisObj: IAxis;
     _yAxisObj: IAxis;
     protected _points: DataPointCollection;
     _runPoints: DataPoint[];
+    _visPoints: DataPoint[];
+    _runRangeValue: 'x' | 'y' | 'z';
     _runRanges: IValueRange[];
-    _minValue: number;
-    _maxValue: number;
+    _minX: number;
+    _maxX: number;
+    _minY: number;
+    _maxY: number;
     _referents: Series[];
     _calcedColor: string;
     _simpleMode: boolean;
@@ -700,10 +730,12 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     constructor(chart: IChart, name?: string);
     abstract _type(): string;
     readonly name: string;
-    readonly label: string;
+    label: string;
     readonly pointLabel: DataPointLabel;
     readonly trendline: Trendline;
     readonly tooltip: Tooltip;
+    row: number;
+    col: number;
     visibleThreshold: number;
     zOrder: number;
     xAxis: string | number;
@@ -716,8 +748,8 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     xStep: number | string;
     color: string;
     pointColors: boolean | string[];
-    ranges: IValueRange[];
-    rangeAxis: 'x' | 'y' | 'z';
+    viewRanges: IValueRange[];
+    viewRangeValue: 'x' | 'y' | 'z';
     clipped: boolean;
     visibleInLegend: boolean;
     visibleInNavigator: boolean;
@@ -730,7 +762,6 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     pointLabelCount(): number;
     isEmpty(): boolean;
     needAxes(): boolean;
-    isSide(): boolean;
     canCategorized(): boolean;
     defaultYAxisType(): string;
     clusterable(): boolean;
@@ -749,11 +780,16 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     createPoints(source: any[]): DataPoint[];
     getXStart(): number;
     getXStep(): number;
-    getValue(point: DataPoint, axis: IAxis): number;
     prepareRender(): void;
+    prepareAfter(): void;
     collectCategories(axis: IAxis): string[];
     collectValues(axis: IAxis, vals: number[]): void;
     collectVisibles(): DataPoint[];
+    protected _getRangeMinMax(axis: 'x' | 'y' | 'z'): {
+        min: number;
+        max: number;
+    };
+    prepareViewRanges(): void;
     pointValuesPrepared(axis: IAxis): void;
     reference(other: Series, axis: IAxis): void;
     isVisible(point: DataPoint): boolean;
@@ -768,6 +804,7 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     getPointStyle(p: DataPoint): any;
     getPointTooltip(point: DataPoint, param: string): any;
     pointClicked(p: DataPoint): boolean;
+    getViewRangeAxis(): 'x' | 'y' | 'z';
     protected _createPoint(source: any): DataPoint;
     protected _createLegendMarker(doc: Document, size: number): RcElement;
     _referOtherSeries(series: Series): boolean;
@@ -778,7 +815,8 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     protected _doLoadPoints(src: any[]): void;
     loadPoints(src: any[]): void;
     protected _doPrepareRender(): void;
-    prepareAfter(): void;
+    protected _setViewRange(p: DataPoint, axis: 'x' | 'y' | 'z'): void;
+    _defViewRangeValue(): 'x' | 'y' | 'z';
 }
 declare class PlottingItemCollection {
     readonly chart: IChart;
@@ -802,7 +840,8 @@ declare class PlottingItemCollection {
     series(): Series[];
     needAxes(): boolean;
     getSeries(name: string): Series;
-    getVisibleSeries(side: boolean): Series[];
+    getVisibleSeries(): Series[];
+    getPaneSeries(row: number, col: number): Series[];
     seriesByPoint(point: DataPoint): Series;
     getLegendSources(): ILegendSource[];
     load(src: any): void;
@@ -819,18 +858,22 @@ declare enum SeriesGroupLayout {
 }
 declare abstract class SeriesGroup<T extends Series> extends ChartItem implements ISeriesGroup {
     layoutMax: number;
+    _row: number;
+    _col: number;
     index: number;
     private _series;
     protected _visibles: T[];
     _xAxisObj: IAxis;
     _yAxisObj: IAxis;
     _stackPoints: Map<number, DataPoint[]>;
+    row: number;
+    col: number;
     layout: SeriesGroupLayout;
     xAxis: string | number;
     yAxis: string | number;
     visibleInLegend: boolean;
+    zOrder: number;
     get series(): T[];
-    isSide(): boolean;
     needAxes(): boolean;
     isEmpty(): boolean;
     canCategorized(): boolean;
@@ -861,6 +904,64 @@ declare abstract class SeriesGroup<T extends Series> extends ChartItem implement
     private $_collectFill;
 }
 
+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;
+}
+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);
+    get centerX(): RtPercentSize;
+    set centerX(value: RtPercentSize);
+    get centerY(): RtPercentSize;
+    set centerY(value: RtPercentSize);
+    startAngle: number;
+    circular: boolean;
+    image: BackgroundImage;
+    zoomType: ZoomType;
+    zoomButton: ZoomButton;
+    canZoom(): boolean;
+    getSplits(): number[];
+    calcRadius(width: number, height: number): number;
+    setPolar(width: number, height: number): Body;
+    getStartAngle(): number;
+    getPolar(series: Series): {
+        start: number;
+        cx: number;
+        cy: number;
+        rd: number;
+    };
+    isZoomed(): boolean;
+    getAnnotations(): Annotation[];
+    protected _doLoadProp(prop: string, value: any): boolean;
+    protected _doPrepareRender(chart: IChart): void;
+    private $_loadAnnotations;
+}
+
 declare enum PaletteMode {
     NORMAL = "normal",
     MIXED = "mixed",
@@ -877,6 +978,8 @@ declare class Title extends ChartItem {
 }
 
 declare abstract class GaugeBase extends Widget {
+    _row: number;
+    _col: number;
     private _size;
     private _width;
     private _height;
@@ -884,6 +987,8 @@ declare abstract class GaugeBase extends Widget {
     private _right;
     private _top;
     private _bottom;
+    row: number;
+    col: number;
     index: number;
     private _sizeDim;
     private _widthDim;
@@ -894,7 +999,6 @@ declare abstract class GaugeBase extends Widget {
     private _bottomDim;
     constructor(chart: IChart);
     abstract _type(): string;
-    side: boolean;
     name: string;
     get left(): RtPercentSize;
     set left(value: RtPercentSize);
@@ -952,7 +1056,8 @@ declare class GaugeCollection {
     constructor(chart: IChart);
     get count(): number;
     get firstGauge(): Gauge;
-    getVisibles(side: boolean): GaugeBase[];
+    getVisibles(): GaugeBase[];
+    getPaneVisibles(row: number, col: number): GaugeBase[];
     getGauge(name: string): Gauge;
     get(name: string | number): GaugeBase;
     load(src: any): void;
@@ -1129,23 +1234,88 @@ declare abstract class CircularGauge extends ValueGauge {
     protected _doPrepareRender(chart: IChart): void;
 }
 
+declare class PaneTitle extends ChartItem {
+    pane: Pane;
+    constructor(pane: Pane);
+    text: string;
+    align: Align;
+    backgroundStyle: SVGStyleOrClass;
+    isVisible(): boolean;
+    protected _doLoadSimple(source: any): boolean;
+}
+declare class PaneBody extends Body {
+    pane: Pane;
+    constructor(pane: Pane);
+}
+declare class Pane extends ChartItem {
+    row: number;
+    col: number;
+    width: number;
+    height: number;
+    constructor(chart: IChart, row: number, col: number);
+    title: PaneTitle;
+    body: PaneBody;
+}
+declare class Split extends ChartItem {
+    private _cols;
+    private _rows;
+    private _widths;
+    private _heights;
+    private _panes;
+    private _xAxes;
+    private _yAxes;
+    _vcols: number;
+    _vrows: number;
+    private _vwidths;
+    private _vheights;
+    private _vpanes;
+    constructor(chart: IChart);
+    rows: number | (number | `${number}*` | '*')[];
+    cols: number | (number | `${number}*` | '*')[];
+    count(): number;
+    rowCount(): number;
+    colCount(): number;
+    paneCount(): number;
+    getPane(row: number, col: number): Pane;
+    getRow(row: number): Pane[];
+    getColumn(col: number): Pane[];
+    protected _doLoadSimple(source: any): boolean;
+    protected _doLoadProp(prop: string, value: any): boolean;
+    load(source: any): ChartItem;
+    protected _doPrepareRender(chart: IChart): void;
+    getXLens(length: number): number[];
+    getYLens(length: number): number[];
+    layoutAxes(width: number, height: number, inverted: boolean, phase: number): void;
+    private $_calcAxesPoints;
+    calcAxesPoints(xLens: number[], yLens: number[]): void;
+    calcSizes(width: number, height: number): void;
+    private $_parseSizes;
+    private $_parsePanes;
+    private $_loadPanes;
+    private $_collectPanes;
+    private $_calcSizes;
+}
+
 interface IChart {
     type: string;
     gaugeType: string;
-    _splitted: boolean;
-    _splits: number[];
+    _xPaneAxes: XPaneAxisMatrix;
+    _yPaneAxes: YPaneAxisMatrix;
     options: ChartOptions;
     first: IPlottingItem;
     firstSeries: Series;
     xAxis: IAxis;
     yAxis: IAxis;
     subtitle: Title;
+    body: Body;
+    split: Split;
     colors: string[];
     _createChart(config: any): IChart;
     assignTemplates(target: any): any;
     isGauge(): boolean;
     isPolar(): boolean;
     isInverted(): boolean;
+    isSplitted(): boolean;
     animatable(): boolean;
     startAngle(): number;
     seriesByName(series: string): Series;
@@ -1156,6 +1326,7 @@ interface IChart {
     _getAxisType(type: string): any;
     _getGaugeType(type: string): any;
     _getGaugeGroupType(type: string): any;
+    _getAnnotationType(type: string): any;
     _getSeries(): PlottingItemCollection;
     _getGauges(): GaugeCollection;
     _getXAxes(): AxisCollection;
@@ -1208,6 +1379,7 @@ declare class Crosshair extends ChartItem {
     showAlways: boolean;
     followPointer: boolean;
     numberFormat: string;
+    timeFormat: string;
     isBar(): boolean;
     getFlag(length: number, pos: number): string;
 }
@@ -1215,7 +1387,8 @@ declare class Crosshair extends ChartItem {
 interface IAxis {
     type(): string;
     chart: IChart;
-    side: boolean;
+    row: number;
+    col: number;
     _vlen: number;
     _isX: boolean;
     _isHorz: boolean;
@@ -1230,11 +1403,11 @@ interface IAxis {
     length(): number;
     zoom(start: number, end: number): boolean;
     getValue(value: any): number;
-    parseValue(value: any): number;
     contains(value: number): boolean;
     incStep(value: number, step: any): number;
     getPosition(length: number, value: number, point?: boolean): number;
     getValueAt(length: number, pos: number): number;
+    getAxisValueAt(length: number, pos: number): any;
     getUnitLength(length: number, value: number): number;
     hasBreak(): boolean;
     isBreak(pos: number): boolean;
@@ -1255,7 +1428,7 @@ declare enum AxisTitleAlign {
 declare class AxisTitle extends AxisItem {
     private _rotation;
     text: string;
-    get rotatin(): 0 | 90 | 270 | -90 | -270;
+    get rotation(): 0 | 90 | 270 | -90 | -270;
     set rotation(value: 0 | 90 | 270 | -90 | -270);
     align: AxisTitleAlign;
     offset: number;
@@ -1373,6 +1546,7 @@ declare abstract class Axis extends ChartItem implements IAxis {
     protected _min: number;
     protected _max: number;
     _zoom: AxisZoom;
+    _runPos: AxisPosition;
     constructor(chart: IChart, isX: boolean, name?: string);
     abstract type(): string;
     readonly name: string;
@@ -1386,7 +1560,6 @@ declare abstract class Axis extends ChartItem implements IAxis {
     readonly scrollBar: AxisScrollBar;
     row: number;
     col: number;
-    side: boolean;
     position: AxisPosition;
     reversed: boolean;
     minValue: number;
@@ -1400,6 +1573,7 @@ declare abstract class Axis extends ChartItem implements IAxis {
     axisMax(): number;
     abstract isContinuous(): boolean;
     abstract getValueAt(length: number, pos: number): number;
+    getAxisValueAt(length: number, pos: number): any;
     protected abstract _createTickModel(): AxisTick;
     protected abstract _createLabelModel(): AxisLabel;
     protected abstract _doPrepareRender(): void;
@@ -1416,7 +1590,6 @@ declare abstract class Axis extends ChartItem implements IAxis {
     getLabelLength(length: number, value: number): number;
     getValue(value: any): number;
     incStep(value: number, step: any): number;
-    parseValue(value: any): number;
     contains(value: number): boolean;
     resetZoom(): void;
     zoom(start: number, end: number): boolean;
@@ -1435,11 +1608,9 @@ declare abstract class Axis extends ChartItem implements IAxis {
 declare class AxisCollection {
     readonly chart: IChart;
     readonly isX: boolean;
-    readonly row: number;
-    readonly col: number;
     protected _items: Axis[];
     private _map;
-    constructor(chart: IChart, isX: boolean, row: number, col: number);
+    constructor(chart: IChart, isX: boolean);
     get count(): number;
     get first(): Axis;
     get items(): Axis[];
@@ -1459,6 +1630,32 @@ declare class AxisCollection {
     resetZoom(): void;
     private $_loadAxis;
 }
+declare class PaneAxes {
+    _axes: Axis[];
+    isEmpty(): boolean;
+}
+declare abstract class PaneAxisMatrix {
+    chart: IChart;
+    isX: boolean;
+    protected _matrix: PaneAxes[][];
+    constructor(chart: IChart, isX: boolean);
+    rows(): number;
+    cols(): number;
+    abstract prepare(axes: AxisCollection, rows: number, cols: number): void;
+    get(row: number, col: number): PaneAxes;
+    getRow(row: number): PaneAxes[];
+    getColumn(col: number): PaneAxes[];
+    buildTicks(lens: number[]): void;
+    calcPoints(lens: number[], phase: number): void;
+}
+declare class XPaneAxisMatrix extends PaneAxisMatrix {
+    constructor(chart: IChart);
+    prepare(axes: AxisCollection, rows: number, cols: number): void;
+}
+declare class YPaneAxisMatrix extends PaneAxisMatrix {
+    constructor(chart: IChart);
+    prepare(axes: AxisCollection, rows: number, cols: number): void;
+}
 
 declare abstract class CircleGaugeRimBase extends ChartItem {
     gauge: CircleGauge;