realchart 0.9.16 → 0.9.18

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,9 +33,26 @@ 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;
@@ -43,6 +61,14 @@ interface IValueRange {
     label?: string;
     style?: SVGStyleOrClass;
 }
+interface IValueRanges {
+    fromValue?: number;
+    toValue?: number;
+    steps?: number[];
+    colors: string[];
+    labels?: string[];
+    styles?: SVGStyleOrClass[];
+}
 
 declare abstract class RcObject {
     static destroy(obj: RcObject): null;
@@ -104,6 +130,7 @@ declare abstract class RcControl extends RcWrappableObject {
     private _htmlRoot;
     private _svg;
     private _defs;
+    private _back;
     private _root;
     private _pointerHandler;
     private _inited;
@@ -115,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;
@@ -168,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;
@@ -407,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;
@@ -433,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;
@@ -468,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;
@@ -478,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 {
@@ -522,6 +559,7 @@ declare class DataPoint {
     yGroup: number;
     drillDown: any[] | object;
     range: IValueRange;
+    zValue: number;
     constructor(source: any);
     get yAbs(): number;
     get xAbs(): number;
@@ -548,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[];
@@ -561,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;
 }
@@ -594,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;
@@ -608,6 +649,8 @@ interface IPlottingItem {
     yAxis: string | number;
     visible: boolean;
     zOrder: number;
+    setCol(col: number): void;
+    setRow(row: number): void;
     getVisiblePoints(): DataPoint[];
     getLegendSources(list: ILegendSource[]): void;
     needAxes(): boolean;
@@ -695,15 +738,19 @@ interface IDataPointCallbackArgs {
     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;
@@ -722,6 +769,8 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     _maxX: number;
     _minY: number;
     _maxY: number;
+    _minZ: number;
+    _maxZ: number;
     _referents: Series[];
     _calcedColor: string;
     _simpleMode: boolean;
@@ -746,15 +795,16 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     dataProp: string;
     xStart: any;
     xStep: number | string;
+    pointStyle: SVGStyleOrClass;
     color: string;
     pointColors: boolean | string[];
-    viewRanges: IValueRange[];
+    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[];
@@ -763,11 +813,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;
@@ -777,6 +827,8 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     canMaxPadding(axis: IAxis): boolean;
     hasMarker(): boolean;
     setShape(shape: Shape): void;
+    setCol(col: number): void;
+    setRow(row: number): void;
     createPoints(source: any[]): DataPoint[];
     getXStart(): number;
     getXStep(): number;
@@ -802,9 +854,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;
@@ -866,6 +921,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;
@@ -882,6 +938,8 @@ declare abstract class SeriesGroup<T extends Series> extends ChartItem implement
     getBaseValue(axis: IAxis): number;
     abstract _type(): string;
     abstract _seriesType(): string;
+    setCol(col: number): void;
+    setRow(row: number): void;
     collectValues(axis: IAxis, vals: number[]): void;
     pointValuesPrepared(axis: IAxis): void;
     collectCategories(axis: IAxis): string[];
@@ -945,7 +1003,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;
@@ -956,6 +1013,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;
@@ -969,13 +1027,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;
@@ -1234,15 +1307,6 @@ 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);
@@ -1253,8 +1317,8 @@ declare class Pane extends ChartItem {
     width: number;
     height: number;
     constructor(chart: IChart, row: number, col: number);
-    title: PaneTitle;
     body: PaneBody;
+    prepareRender(): void;
 }
 declare class Split extends ChartItem {
     private _cols;
@@ -1306,7 +1370,7 @@ interface IChart {
     firstSeries: Series;
     xAxis: IAxis;
     yAxis: IAxis;
-    subtitle: Title;
+    subtitle: Subtitle;
     body: Body;
     split: Split;
     colors: string[];
@@ -1320,7 +1384,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;
@@ -1455,6 +1519,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;
@@ -1463,6 +1530,7 @@ declare abstract class AxisTick extends AxisItem {
     showFirst: boolean;
     showLast: boolean;
     constructor(axis: Axis);
+    protected _doLoadSimple(source: any): boolean;
 }
 declare enum AxisLabelArrange {
     NONE = "none",