realchart 0.9.15 → 0.9.17

package/dist/index.d.ts

@@ -2,6 +2,7 @@ type Path = string | any[];
 type RtPercentSize = string | number;
 interface SVGStyles {
     fill?: string;
+    fillOpacity?: string;
     stroke?: string;
     strokeWidth?: string;
     fontFamily?: string;
@@ -32,15 +33,41 @@ declare enum SectionDir {
     CENTER = "center",
     MIDDLE = "middle"
 }
+interface ISides {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+    horz?: number;
+    vert?: number;
+}
+interface ISides {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+    horz?: number;
+    vert?: number;
+}
 declare enum AlignBase {
     CHART = "chart",
-    PLOT = "plot"
+    PLOT = "plot",
+    PARENT = "parent"
 }
 interface IValueRange {
     fromValue?: number;
     toValue?: number;
     color: string;
     label?: string;
+    style?: SVGStyleOrClass;
+}
+interface IValueRanges {
+    fromValue?: number;
+    toValue?: number;
+    steps?: number[];
+    colors: string[];
+    labels?: string[];
+    styles?: SVGStyleOrClass[];
 }
 
 declare abstract class RcObject {
@@ -103,6 +130,7 @@ declare abstract class RcControl extends RcWrappableObject {
     private _htmlRoot;
     private _svg;
     private _defs;
+    private _back;
     private _root;
     private _pointerHandler;
     private _inited;
@@ -114,6 +142,7 @@ declare abstract class RcControl extends RcWrappableObject {
     private _lockDirty;
     private _cssVars;
     loaded: boolean;
+    _padding: ISides;
     constructor(doc: Document, container: string | HTMLDivElement, className?: string);
     protected _doDestory(): void;
     isInited(): boolean;
@@ -123,6 +152,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;
@@ -166,7 +196,7 @@ declare abstract class RcControl extends RcWrappableObject {
     protected abstract _doRender(bounds: IRect): void;
     protected _doBeforeRender(): void;
     protected _doAfterRender(): void;
-    protected _doRenderBackground(elt: HTMLDivElement, width: number, height: number): void;
+    protected _doRenderBackground(elt: HTMLDivElement, root: RcElement, width: number, height: number): void;
     protected _windowResizeHandler: (event: Event) => void;
     protected _windowResized(): void;
     toOffset(event: any): any;
@@ -305,7 +335,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;
@@ -405,7 +435,7 @@ declare class SvgRichText {
 declare class ChartItem extends RcObject {
     readonly chart: IChart;
     private _visible;
-    constructor(chart: IChart, visible?: boolean);
+    constructor(chart: IChart, visible: boolean);
     get visible(): boolean;
     set visible(value: boolean);
     style: SVGStyleOrClass;
@@ -431,11 +461,15 @@ declare enum ChartTextEffect {
     BACKGROUND = "background"
 }
 declare abstract class ChartText extends ChartItem {
+    private _outlineThickness;
+    _outlineWidth: string;
     effect: ChartTextEffect;
     lightStyle: SVGStyleOrClass;
     darkStyle: SVGStyleOrClass;
     backgroundStyle: SVGStyleOrClass;
     autoContrast: boolean;
+    get outlineThickness(): number;
+    set outlineThickness(value: number);
 }
 declare abstract class FormattableText extends ChartText {
     private _numberSymbols;
@@ -466,6 +500,10 @@ declare class BackgroundImage extends ChartItem {
     style: SVGStyleOrClass;
 }
 
+declare enum AnnotationScope {
+    CHART = "chart",
+    CONTAINER = "container"
+}
 declare abstract class Annotation extends ChartItem {
     constructor(chart: IChart);
     abstract _type(): string;
@@ -476,7 +514,8 @@ declare abstract class Annotation extends ChartItem {
     offsetX: number;
     offsetY: number;
     rotation: number;
-    getPostion(wDomain: number, hDomain: number, width: number, height: number): IPoint;
+    scope: AnnotationScope;
+    getPostion(inverted: boolean, left: number, top: number, wDomain: number, hDomain: number, width: number, height: number): IPoint;
 }
 
 declare enum Shape {
@@ -519,6 +558,8 @@ declare class DataPoint {
     yPos: number;
     yGroup: number;
     drillDown: any[] | object;
+    range: IValueRange;
+    zValue: number;
     constructor(source: any);
     get yAbs(): number;
     get xAbs(): number;
@@ -545,7 +586,7 @@ declare class DataPointCollection {
     contains(p: DataPoint): boolean;
     load(source: any): void;
     getProps(prop: string | number): any[];
-    getValues(axis: string): any[];
+    getCategories(axis: string): any[];
     getProxies(): any[];
     forEach(callback: (p: DataPoint, i?: number) => any): void;
     getPoints(xAxis: IAxis, yAxis: IAxis): DataPoint[];
@@ -558,7 +599,7 @@ declare abstract class Widget extends ChartItem {
 
 interface ILegendSource {
     visible: boolean;
-    legendMarker(doc: Document): RcElement;
+    legendMarker(doc: Document, size: number): RcElement;
     legendColor(): string;
     legendLabel(): string;
 }
@@ -591,9 +632,12 @@ declare class DataPointLabel extends FormattableText {
     position: PointItemPosition;
     offset: number;
     distance: number;
+    visibleCallback: (point: any) => boolean;
+    styleCallback: (point: any) => SVGStyleOrClass;
     constructor(chart: IChart);
+    "@config visible": any;
     getText(value: any): string;
-    protected _doLoad(source: any): void;
+    protected _doLoadSimple(source: any): boolean;
 }
 interface IPlottingItem {
     _row: number;
@@ -690,15 +734,21 @@ interface IDataPointCallbackArgs {
     vcount: number;
     yMin: number;
     yMax: number;
+    xMin: number;
+    xMax: number;
+    zMin: number;
+    zMax: number;
     index: number;
     vindex: number;
     x: any;
     y: any;
+    z: any;
     xValue: any;
     yValue: any;
+    zValue: any;
 }
 type PointStyleCallback = (args: IDataPointCallbackArgs) => SVGStyleOrClass;
-type PointClickCallbck = (args: IDataPointCallbackArgs) => boolean;
+type PointClickCallback = (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;
@@ -710,9 +760,15 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     _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;
+    _minZ: number;
+    _maxZ: number;
     _referents: Series[];
     _calcedColor: string;
     _simpleMode: boolean;
@@ -737,15 +793,16 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     dataProp: string;
     xStart: any;
     xStep: number | string;
+    pointStyle: SVGStyleOrClass;
     color: string;
     pointColors: boolean | string[];
-    ranges: IValueRange[];
-    rangeAxis: 'x' | 'y' | 'z';
+    viewRanges: IValueRange[] | IValueRanges;
+    viewRangeValue: 'x' | 'y' | 'z';
     clipped: boolean;
     visibleInLegend: boolean;
     visibleInNavigator: boolean;
     pointStyleCallback: PointStyleCallback;
-    onPointClick: PointClickCallbck;
+    onPointClick: PointClickCallback;
     contains(p: DataPoint): boolean;
     getPoints(): DataPointCollection;
     getLabeledPoints(): DataPoint[];
@@ -754,11 +811,11 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     isEmpty(): boolean;
     needAxes(): boolean;
     canCategorized(): boolean;
+    hasZ(): boolean;
     defaultYAxisType(): string;
     clusterable(): boolean;
     displayName(): string;
-    legendMarker(doc: Document): RcElement;
-    setLegendMarker(elt: RcElement): void;
+    legendMarker(doc: Document, size: number): RcElement;
     legendColor(): string;
     legendLabel(): string;
     ignoreAxisBase(axis: IAxis): boolean;
@@ -772,9 +829,15 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     getXStart(): number;
     getXStep(): 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;
@@ -787,8 +850,12 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     protected _preparePointArgs(args: IDataPointCallbackArgs): void;
     protected _getPointCallbackArgs(args: IDataPointCallbackArgs, p: DataPoint): void;
     getPointStyle(p: DataPoint): any;
+    getPointLabelStyle(p: DataPoint): any;
     getPointTooltip(point: DataPoint, param: string): any;
     pointClicked(p: DataPoint): boolean;
+    getViewRangeAxis(): 'x' | 'y' | 'z';
+    isPointLabelsVisible(): boolean;
+    isPointLabelVisible(p: DataPoint): boolean;
     protected _createPoint(source: any): DataPoint;
     protected _createLegendMarker(doc: Document, size: number): RcElement;
     _referOtherSeries(series: Series): boolean;
@@ -799,7 +866,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;
@@ -849,6 +917,7 @@ declare abstract class SeriesGroup<T extends Series> extends ChartItem implement
     _xAxisObj: IAxis;
     _yAxisObj: IAxis;
     _stackPoints: Map<number, DataPoint[]>;
+    constructor(chart: IChart);
     row: number;
     col: number;
     layout: SeriesGroupLayout;
@@ -928,7 +997,6 @@ declare class Body extends ChartItem {
     zoomType: ZoomType;
     zoomButton: ZoomButton;
     canZoom(): boolean;
-    getSplits(): number[];
     calcRadius(width: number, height: number): number;
     setPolar(width: number, height: number): Body;
     getStartAngle(): number;
@@ -939,6 +1007,7 @@ declare class Body extends ChartItem {
         rd: number;
     };
     isZoomed(): boolean;
+    '@config annotation': Annotation[];
     getAnnotations(): Annotation[];
     protected _doLoadProp(prop: string, value: any): boolean;
     protected _doPrepareRender(chart: IChart): void;
@@ -952,13 +1021,28 @@ declare enum PaletteMode {
 }
 
 declare class Title extends ChartItem {
+    constructor(chart: IChart);
+    verticalAlign: VerticalAlign;
     text: string;
     alignBase: AlignBase;
     align: Align;
     backgroundStyle: SVGStyleOrClass;
+    sectionGap: number;
     isVisible(): boolean;
     protected _doLoadSimple(source: any): boolean;
 }
+declare enum SubtitlePosition {
+    BOTTOM = "bottom",
+    RIGHT = "right",
+    LEFT = "left",
+    TOP = "top"
+}
+declare class Subtitle extends Title {
+    position: SubtitlePosition;
+    verticalAlign: VerticalAlign;
+    text: string;
+    gap: number;
+}
 
 declare abstract class GaugeBase extends Widget {
     _row: number;
@@ -1238,6 +1322,8 @@ declare class Pane extends ChartItem {
     constructor(chart: IChart, row: number, col: number);
     title: PaneTitle;
     body: PaneBody;
+    prepareRender(): void;
+    protected _doLoad(source: any): void;
 }
 declare class Split extends ChartItem {
     private _cols;
@@ -1289,7 +1375,7 @@ interface IChart {
     firstSeries: Series;
     xAxis: IAxis;
     yAxis: IAxis;
-    subtitle: Title;
+    subtitle: Subtitle;
     body: Body;
     split: Split;
     colors: string[];
@@ -1303,7 +1389,7 @@ interface IChart {
     startAngle(): number;
     seriesByName(series: string): Series;
     axisByName(axis: string): Axis;
-    getAxes(dir: SectionDir): Axis[];
+    getAxes(dir: SectionDir, visibleOnly: boolean): Axis[];
     _getGroupType(type: string): any;
     _getSeriesType(type: string): any;
     _getAxisType(type: string): any;
@@ -1438,6 +1524,9 @@ declare abstract class AxisGuide extends AxisItem {
     readonly label: AxisGuideLabel;
     front: boolean;
     zindex: number;
+    col: number | number[];
+    row: number | number[];
+    canConstainedTo(row: number, col: number): boolean;
 }
 declare abstract class AxisTick extends AxisItem {
     length: number;
@@ -1446,6 +1535,7 @@ declare abstract class AxisTick extends AxisItem {
     showFirst: boolean;
     showLast: boolean;
     constructor(axis: Axis);
+    protected _doLoadSimple(source: any): boolean;
 }
 declare enum AxisLabelArrange {
     NONE = "none",