realchart 0.9.24 → 0.9.25

package/dist/index.d.ts

@@ -10,6 +10,8 @@ interface SVGStyles {
     fontSize?: string;
     fontWeight?: string;
     fontStyle?: string;
+    rx?: string;
+    textAlign?: 'left' | 'center' | 'right';
 }
 type SVGStyleOrClass = SVGStyles | string;
 interface IMinMax {
@@ -170,6 +172,8 @@ declare abstract class RcControl extends RcWrappableObject {
     svg(): SVGSVGElement;
     width(): number;
     height(): number;
+    contentWidth(): number;
+    contentHeight(): number;
     clipContainer(): SVGElement;
     setData(data: string, value: any, container?: boolean): void;
     clearDefs(): void;
@@ -190,8 +194,9 @@ declare abstract class RcControl extends RcWrappableObject {
     setAnimation(to?: number): void;
     fling(distance: number, duration: number): void;
     getCssVar(name: string): string;
-    clipBounds(x?: number, y?: number, width?: number, height?: number, rd?: number): ClipElement;
-    clipRect(r: IRect): ClipElement;
+    clipBounds(x?: number, y?: number, width?: number, height?: number, rd?: number): ClipRectElement;
+    clipRect(r: IRect): ClipRectElement;
+    clipCircle(): ClipCircleElement;
     clipPath(): ClipPathElement;
     addDef(element: Element): void;
     removeDef(element: Element | string): void;
@@ -230,8 +235,8 @@ declare abstract class RcControl extends RcWrappableObject {
     private _wheelHandler;
 }
 declare class RcElement extends RcObject {
-    static TESTING: boolean;
     static DEBUGGING: boolean;
+    static TESTING: boolean;
     static ASSET_KEY: string;
     static TEMP_KEY: string;
     private _visible;
@@ -331,15 +336,14 @@ declare class RcElement extends RcObject {
     setClass(value: string): void;
     setStyle(prop: string, value: string): boolean;
     internalSetStyle(prop: string, value: string): void;
-    putStyles(styles: any, buff?: any): any;
-    putStyle(prop: string, value: string, buff?: any): any;
+    textAlign(): Align;
     setData(data: string, value?: string): void;
     unsetData(data: string): void;
     setBoolData(data: string, value: boolean): void;
     removeLater(delay: number, callback?: (v: RcElement) => void): RcElement;
     hide(delay: number): RcElement;
-    clipRect(x: number, y: number, width: number, height: number, rd?: number): ClipElement;
-    setClip(cr?: ClipElement | ClipPathElement | string): void;
+    clipRect(x: number, y: number, width: number, height: number, rd?: number): ClipRectElement;
+    setClip(cr?: ClipElement | string): void;
     setTemporary(): RcElement;
     setCursor(cursor: string): void;
     ignorePointer(): void;
@@ -350,11 +354,14 @@ declare class RcElement extends RcObject {
     protected _updateTransform(): void;
     getTransform(): string;
 }
-declare class ClipElement extends RcElement {
+declare abstract class ClipElement extends RcElement {
     private _id;
+    constructor(doc: Document);
+    get id(): string;
+}
+declare class ClipRectElement extends ClipElement {
     private _rect;
     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;
     resize(width: number, height: number, attr?: boolean): RcElement;
     get x(): number;
@@ -366,13 +373,16 @@ declare class ClipElement extends RcElement {
     get height(): number;
     set height(value: number);
 }
-declare class ClipPathElement extends RcElement {
-    private _id;
+declare class ClipPathElement extends ClipElement {
     private _path;
     constructor(doc: Document);
-    get id(): string;
     setPath(path: Path): void;
 }
+declare class ClipCircleElement extends ClipElement {
+    private _circle;
+    constructor(doc: Document);
+    setCircle(cx: number, cy: number, radius: number): void;
+}
 
 declare enum TextAnchor {
     START = "start",
@@ -517,82 +527,6 @@ 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;
-    front: boolean;
-    name: string;
-    align: Align;
-    verticalAlign: VerticalAlign;
-    offsetX: number;
-    offsetY: number;
-    rotation: number;
-    scope: AnnotationScope;
-    getPostion(inverted: boolean, left: number, top: number, wDomain: number, hDomain: number, width: number, height: number): IPoint;
-}
-
-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;
-    calcRadius(width: number, height: number): number;
-    setPolar(width: number, height: number): Body;
-    getStartAngle(): number;
-    getPolar(axis: Axis): {
-        start: number;
-        cx: number;
-        cy: number;
-        rd: number;
-    };
-    isZoomed(): boolean;
-    '@config annotation': Annotation[];
-    getAnnotations(): Annotation[];
-    protected _doLoadProp(prop: string, value: any): boolean;
-    protected _doPrepareRender(chart: IChart): void;
-    private $_loadAnnotations;
-}
-
 declare enum Shape {
     CIRCLE = "circle",
     DIAMOND = "diamond",
@@ -609,6 +543,66 @@ declare enum LineType {
     STEP = "step"
 }
 
+interface IPointPos {
+    xPos: number;
+    yPos: number;
+    isNull: boolean;
+}
+declare class DataPoint {
+    static swap(pts: IPointPos[]): IPointPos[];
+    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;
+    constructor(source: any);
+    get yAbs(): number;
+    get xAbs(): number;
+    ariaHint(): string;
+    labelCount(): number;
+    assignTo(proxy?: any): any;
+    getProp(fld: string | number): any;
+    parse(series: ISeries): void;
+    getLabel(index: number): any;
+    getValueOf: (traget: any, param: string) => any;
+    swap(): void;
+    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): DataPoint;
+    contains(p: DataPoint): boolean;
+    load(source: any): void;
+    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;
@@ -648,6 +642,7 @@ declare enum PointItemPosition {
     OUTSIDE_FIRST = "outsideFirst"
 }
 declare class DataPointLabel extends FormattableText {
+    private static readonly OFFSET;
     position: PointItemPosition;
     offset: number;
     distance: number;
@@ -655,8 +650,8 @@ declare class DataPointLabel extends FormattableText {
     visibleCallback: (point: any) => boolean;
     styleCallback: (point: any) => SVGStyleOrClass;
     constructor(chart: IChart);
-    "@config visible": any;
     getText(value: any): string;
+    getOffset(): number;
     protected _doLoadSimple(source: any): boolean;
 }
 interface IPlottingItem {
@@ -768,6 +763,7 @@ interface IDataPointCallbackArgs {
     xValue: any;
     yValue: any;
     zValue: any;
+    source: any;
 }
 type PointStyleCallback = (args: IDataPointCallbackArgs) => SVGStyleOrClass;
 type PointClickCallback = (args: IDataPointCallbackArgs) => boolean;
@@ -850,6 +846,7 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     canMaxPadding(axis: IAxis): boolean;
     hasMarker(): boolean;
     setShape(shape: Shape): void;
+    needClip(polar: boolean): boolean;
     setCol(col: number): void;
     setRow(row: number): void;
     createPoints(source: any[]): DataPoint[];
@@ -955,6 +952,7 @@ declare abstract class SeriesGroup<T extends Series> extends ChartItem implement
     yAxis: string | number;
     visibleInLegend: boolean;
     zOrder: number;
+    noClip: boolean;
     get series(): T[];
     needAxes(): boolean;
     isEmpty(): boolean;
@@ -988,64 +986,83 @@ declare abstract class SeriesGroup<T extends Series> extends ChartItem implement
     private $_collectFill;
 }
 
-interface IPointPos {
-    xPos: number;
-    yPos: number;
-    isNull: boolean;
+declare enum AnnotationScope {
+    CHART = "chart",
+    CONTAINER = "container"
 }
-declare class DataPoint {
-    static swap(pts: IPointPos[]): IPointPos[];
-    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;
-    constructor(source: any);
-    get yAbs(): number;
-    get xAbs(): number;
-    ariaHint(): string;
-    labelCount(): number;
-    assignTo(proxy?: any): any;
-    getProp(fld: string | number): any;
-    parse(series: ISeries): void;
-    getLabel(index: number): any;
-    getValueOf: (traget: any, param: string) => any;
-    swap(): void;
-    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 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;
+    getPosition(inverted: boolean, left: number, top: number, wDomain: number, hDomain: number, width: number, height: number): IPoint;
+    protected _doPrepareRender(chart: IChart): void;
 }
-declare class DataPointCollection {
-    protected _owner: ISeries;
-    private _points;
-    constructor(owner: ISeries);
-    get count(): number;
-    isEmpty(): boolean;
-    get(index: number): DataPoint;
-    pointAt(xValue: number): DataPoint;
-    contains(p: DataPoint): boolean;
-    load(source: any): void;
-    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 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);
+    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): {
+        start: number;
+        total: number;
+        cx: number;
+        cy: number;
+        rd: number;
+    };
+    isZoomed(): boolean;
+    '@config annotation': Annotation[];
+    getAnnotations(): Annotation[];
+    protected _doLoadProp(prop: string, value: any): boolean;
+    protected _doPrepareRender(chart: IChart): void;
+    private $_loadAnnotations;
 }
 
 declare enum PaletteMode {
@@ -1062,7 +1079,6 @@ declare class Title extends ChartItem {
     align: Align;
     backgroundStyle: SVGStyleOrClass;
     gap: number;
-    textAlign: Align;
     isVisible(): boolean;
     protected _doLoadSimple(source: any): boolean;
 }
@@ -1393,8 +1409,8 @@ declare class Split extends ChartItem {
 interface IChart {
     type: string;
     gaugeType: string;
-    _xPaneAxes: XPaneAxisMatrix;
-    _yPaneAxes: YPaneAxisMatrix;
+    _xPaneAxes: PaneXAxisMatrix;
+    _yPaneAxes: PaneYAxisMatrix;
     options: ChartOptions;
     first: IPlottingItem;
     firstSeries: Series;
@@ -1413,7 +1429,6 @@ interface IChart {
     isInverted(): boolean;
     isSplitted(): boolean;
     animatable(): boolean;
-    startAngle(): number;
     seriesByName(series: string): Series;
     axisByName(axis: string): Axis;
     getAxes(dir: SectionDir, visibleOnly: boolean): Axis[];
@@ -1444,6 +1459,8 @@ declare class Credits extends ChartItem {
     verticalAlign: VerticalAlign;
     offsetX: number;
     offsetY: number;
+    gap: number;
+    isFloating(): boolean;
 }
 declare class ChartOptions extends ChartItem {
     theme: string;
@@ -1539,7 +1556,7 @@ declare class AxisGrid extends AxisItem {
     startVisible: boolean;
     endVisible: boolean;
     constructor(axis: Axis);
-    isVisible(): boolean;
+    isVisible(polar: boolean): boolean;
     getPoints(length: number): number[];
 }
 declare class AxisGuideLabel extends FormattableText {
@@ -1561,9 +1578,6 @@ declare abstract class AxisGuide extends AxisItem {
 declare abstract class AxisTick extends AxisItem {
     length: number;
     gap: number;
-    integral: boolean;
-    showFirst: boolean;
-    showLast: boolean;
     constructor(axis: Axis);
     protected _doLoadSimple(source: any): boolean;
 }
@@ -1590,12 +1604,16 @@ declare abstract class AxisLabel extends FormattableText {
     rotation: number;
     autoArrange: AxisLabelArrange;
     wrap: boolean;
+    firstText: string;
+    lastText: string;
+    firstStyle: SVGStyleOrClass;
+    lastStyle: SVGStyleOrClass;
     textCallback: (args: IAxisLabelArgs) => string;
     styleCallback: (args: any) => SVGStyleOrClass;
     abstract getTick(index: number, value: any): string;
     protected _getParamValue(tick: IAxisTick, param: string): any;
-    getLabelText(tick: IAxisTick): string;
-    getLabelStyle(tick: IAxisTick): any;
+    getLabelText(tick: IAxisTick, count: number): string;
+    getLabelStyle(tick: IAxisTick, count: number): any;
 }
 interface IAxisTick {
     index: number;
@@ -1636,7 +1654,7 @@ declare class AxisZoom {
     start: number;
     end: number;
     constructor(axis: Axis, start: number, end: number);
-    get length(): number;
+    length(): number;
     resize(start: number, end: number): boolean;
 }
 declare abstract class Axis extends ChartItem implements IAxis {
@@ -1658,10 +1676,10 @@ declare abstract class Axis extends ChartItem implements IAxis {
     _vlen: number;
     _minPad: number;
     _maxPad: number;
-    _startAngle: number;
     _values: number[];
     protected _min: number;
     protected _max: number;
+    protected _single: boolean;
     _zoom: AxisZoom;
     _runPos: AxisPosition;
     _labelArgs: IAxisLabelArgs;
@@ -1678,12 +1696,15 @@ declare abstract class Axis extends ChartItem implements IAxis {
     readonly scrollBar: AxisScrollBar;
     row: number;
     col: number;
+    startAngle: number;
+    totalAngle: number;
     position: AxisPosition;
     reversed: boolean;
     minValue: number;
     maxValue: number;
     marginNear: number;
     marginFar: number;
+    unit: string;
     isEmpty(): boolean;
     getBaseValue(): number;
     length(): number;
@@ -1692,7 +1713,9 @@ declare abstract class Axis extends ChartItem implements IAxis {
     abstract isContinuous(): boolean;
     abstract getValueAt(length: number, pos: number): number;
     getAxisValueAt(length: number, pos: number): any;
-    startAngle(): number;
+    getStartAngle(): number;
+    getTotalAngle(): number;
+    isArced(): boolean;
     protected abstract _createTickModel(): AxisTick;
     protected abstract _createLabelModel(): AxisLabel;
     protected abstract _doPrepareRender(): void;
@@ -1718,7 +1741,7 @@ declare abstract class Axis extends ChartItem implements IAxis {
     isBreak(pos: number): boolean;
     getTickLabelArgs(index: number, value: any): IAxisLabelArgs;
     protected _doLoadProp(prop: string, value: any): boolean;
-    protected _getStartAngle(start: number): number;
+    protected _setMinMax(min: number, max: number): void;
     protected _createGrid(): AxisGrid;
     private $_loadGuides;
     _connect(series: IPlottingItem): void;
@@ -1745,7 +1768,6 @@ declare class AxisCollection {
     collectReferentsValues(): void;
     prepareRender(): void;
     $_buildTicks(length: number): void;
-    protected _getLength(axis: Axis, length: number): number;
     connect(series: IPlottingItem): Axis;
     forEach(callback: (p: Axis, i?: number) => any): void;
     isZoomed(): boolean;
@@ -1770,11 +1792,11 @@ declare abstract class PaneAxisMatrix {
     buildTicks(lens: number[]): void;
     calcPoints(lens: number[], phase: number): void;
 }
-declare class XPaneAxisMatrix extends PaneAxisMatrix {
+declare class PaneXAxisMatrix extends PaneAxisMatrix {
     constructor(chart: IChart);
     prepare(axes: AxisCollection, rows: number, cols: number): void;
 }
-declare class YPaneAxisMatrix extends PaneAxisMatrix {
+declare class PaneYAxisMatrix extends PaneAxisMatrix {
     constructor(chart: IChart);
     prepare(axes: AxisCollection, rows: number, cols: number): void;
 }
@@ -2072,13 +2094,15 @@ declare class RcChartControl {
 declare class Globals {
     static getVersion(): string;
     static setDebugging(debug: boolean): void;
+    static setLogging(logging: boolean): void;
     static setAnimatable(value: boolean): void;
     static createChart(doc: Document, container: string | HTMLDivElement, config: any): RcChartControl;
 }
 
 declare const getVersion: typeof Globals.getVersion;
 declare const setDebugging: typeof Globals.setDebugging;
+declare const setLogging: typeof Globals.setLogging;
 declare const setAnimatable: typeof Globals.setAnimatable;
 declare const createChart: typeof Globals.createChart;
 
-export { RcAreaRangeSeries, RcAreaSeries, RcAreaSeriesGroup, RcBarRangeSeries, RcBarSeries, RcBarSeriesGroup, RcBellCurveSeries, RcBody, RcBoxPlotSeries, RcBubbleSeries, RcBulletGauge, RcBulletGaugeGroup, RcBumpSeriesGroup, RcCandlestickSeries, RcCategoryAxis, RcChartAxis, RcChartControl, RcChartGauge, RcChartGaugeBase, RcChartObject, RcChartSeries, RcCircleGauge, RcCircleGaugeGroup, RcCircularGauge, RcClockGauge, RcContinuousAxis, RcDumbbellSeries, RcEqualizerSeries, RcFunnelSeries, RcGaugeGroup, RcGaugeRangeBand, RcGaugeScale, RcHeatmapSeries, RcHistogramSeries, RcLegend, RcLineSeries, RcLineSeriesGroup, RcLinearAxis, RcLinearGauge, RcLinearGaugeGroup, RcLinearGaugeBase as RcLinerGaugeBase, RcLogAxis, RcLollipopSeries, RcParetoSeries, RcPieSeries, RcPieSeriesGroup, RcPointLabel, RcScatterSeries, RcSeriesGroup, RcSubtitle, RcTimeAxis, RcTitle, RcTreemapSeries, RcValueGauge, RcVectorSeries, RcWaterfallSeries, createChart, getVersion, setAnimatable, setDebugging };
+export { RcAreaRangeSeries, RcAreaSeries, RcAreaSeriesGroup, RcBarRangeSeries, RcBarSeries, RcBarSeriesGroup, RcBellCurveSeries, RcBody, RcBoxPlotSeries, RcBubbleSeries, RcBulletGauge, RcBulletGaugeGroup, RcBumpSeriesGroup, RcCandlestickSeries, RcCategoryAxis, RcChartAxis, RcChartControl, RcChartGauge, RcChartGaugeBase, RcChartObject, RcChartSeries, RcCircleGauge, RcCircleGaugeGroup, RcCircularGauge, RcClockGauge, RcContinuousAxis, RcDumbbellSeries, RcEqualizerSeries, RcFunnelSeries, RcGaugeGroup, RcGaugeRangeBand, RcGaugeScale, RcHeatmapSeries, RcHistogramSeries, RcLegend, RcLineSeries, RcLineSeriesGroup, RcLinearAxis, RcLinearGauge, RcLinearGaugeGroup, RcLinearGaugeBase as RcLinerGaugeBase, RcLogAxis, RcLollipopSeries, RcParetoSeries, RcPieSeries, RcPieSeriesGroup, RcPointLabel, RcScatterSeries, RcSeriesGroup, RcSubtitle, RcTimeAxis, RcTitle, RcTreemapSeries, RcValueGauge, RcVectorSeries, RcWaterfallSeries, createChart, getVersion, setAnimatable, setDebugging, setLogging };