realchart 0.9.2 → 0.9.3

package/dist/index.d.ts

@@ -31,6 +31,7 @@ declare abstract class RcEventProvider<T> extends RcObject {
 }
 
 type Path = string | any[];
+type RtPercentSize = string | number;
 type SizeValue = string | number;
 interface SVGStyles {
     fill?: string;
@@ -110,6 +111,7 @@ declare abstract class RcControl extends RcWrappableObject {
     dom(): HTMLElement;
     width(): number;
     height(): number;
+    setData(data: string, value: any, container?: boolean): void;
     clearDefs(): void;
     clearTemporaryDefs(): void;
     appendDom(elt: HTMLElement): void;
@@ -129,7 +131,8 @@ declare abstract class RcControl extends RcWrappableObject {
     clipBounds(x?: number, y?: number, width?: number, height?: number, rd?: number): ClipElement;
     clipRect(r: IRect): ClipElement;
     clipPath(): ClipPathElement;
-    removeDef(element: RcElement): void;
+    addDef(element: Element): void;
+    removeDef(element: Element | string): void;
     containerToElement(element: RcElement, x: number, y: number): IPoint;
     abstract useImage(src: string): void;
     protected _setTesting(): void;
@@ -141,7 +144,6 @@ declare abstract class RcControl extends RcWrappableObject {
     private $_initControl;
     protected _initDefs(doc: Document, defs: SVGElement): void;
     protected _render(): void;
-    private $_invalidateElement;
     private $_requestRender;
     updateNow(): void;
     private $_render;
@@ -238,25 +240,32 @@ declare class RcElement extends RcObject {
     appendDom(dom: Node): Node;
     insertDom(dom: Node, before: Node): Node;
     clearDom(): void;
+    internalClearStyles(): void;
     clearStyles(): boolean;
     clearStyle(props: string[]): boolean;
+    internalSetStyles(styles: any): void;
     setStyles(styles: any): boolean;
     resetStyles(styles: any): boolean;
     protected _resetClass(): void;
     clearStyleAndClass(): void;
+    internalClearStyleAndClass(): void;
     setStyleOrClass(style: SVGStyleOrClass): void;
+    internalSetStyleOrClass(style: SVGStyleOrClass): void;
     addStyleOrClass(style: SVGStyleOrClass): void;
     setStyleName(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;
     setData(data: string, value?: string): void;
     unsetData(data: string): void;
+    setBoolData(data: string, value: boolean): void;
     removeLater(moveToFirst?: boolean, duration?: number): RcElement;
     fadeout(removeDelay: number, startOpacity: number): RcElement;
     clipRect(x: number, y: number, width: number, height: number, rd?: number): ClipElement;
     setClip(cr?: ClipElement | ClipPathElement | string): void;
     setTemporary(): RcElement;
+    setCursor(cursor: string): void;
     protected _testing(): boolean;
     protected _doAttached(parent: RcElement): void;
     protected _doDetached(parent: RcElement): void;
@@ -288,6 +297,28 @@ declare class ClipPathElement extends RcElement {
     setPath(path: Path): void;
 }
 
+interface IAssetItem {
+    id: string;
+}
+declare abstract class AssetItem<T extends IAssetItem> {
+    source: T;
+    constructor(source: T);
+    abstract getEelement(doc: Document): Element;
+}
+interface IAssetOwner {
+    addDef(element: Element): void;
+    removeDef(element: string): void;
+}
+declare class AssetCollection {
+    private _items;
+    get count(): number;
+    get(index: number): AssetItem<IAssetItem>;
+    load(source: any): void;
+    register(doc: Document, owner: IAssetOwner): void;
+    unregister(doc: Document, owner: IAssetOwner): void;
+    private $_loadItem;
+}
+
 declare enum TextAnchor {
     START = "start",
     MIDDLE = "middle",
@@ -402,6 +433,16 @@ declare class Crosshair extends ChartItem {
     labelStyles: SVGStyleOrClass;
 }
 
+declare enum Shape {
+    CIRCLE = "circle",
+    DIAMOND = "diamond",
+    RECTANGLE = "rectangle",
+    SQUARE = "square",
+    TRIANGLE = "triangle",
+    ITRIANGLE = "itriangle",
+    STAR = "star"
+}
+
 declare enum LineType {
     DEFAULT = "default",
     SPLINE = "spline",
@@ -445,25 +486,24 @@ declare class DataPoint {
     protected _readSingle(v: any): void;
 }
 declare class DataPointCollection {
-    private _owner;
+    protected _owner: ISeries;
     private _points;
     constructor(owner: ISeries);
     get count(): number;
     isEmpty(): boolean;
     get(index: number): DataPoint;
+    contains(p: DataPoint): boolean;
     load(source: any): void;
     getProps(prop: string | number): any[];
     getValues(axis: string): any[];
     forEach(callback: (p: DataPoint, i?: number) => any): void;
     getPoints(): DataPoint[];
-    getVisibles(): DataPoint[];
 }
 
 interface ILegendSource {
     visible: boolean;
     legendColor(): string;
     legendLabel(): string;
-    legendVisible(): boolean;
 }
 declare class LegendItem extends ChartItem {
     legend: Legend;
@@ -490,6 +530,9 @@ declare enum LegendLayout {
 }
 declare class Legend extends ChartItem {
     private _items;
+    private _maxWidthDim;
+    private _maxHeightDim;
+    private _position;
     constructor(chart: IChart);
     position: LegendPosition;
     layout: LegendLayout;
@@ -498,14 +541,22 @@ declare class Legend extends ChartItem {
     right: number;
     top: number;
     bottom: number;
+    gap: number;
     itemGap: number;
     markerGap: number;
     backgroundStyles: SVGStyleOrClass;
+    itemsPerRow: number;
+    maxWidth: RtPercentSize;
+    maxHeight: RtPercentSize;
     items(): LegendItem[];
     isEmpty(): boolean;
     isVisible(): boolean;
+    getPosition(): LegendPosition;
     getLayout(): LegendLayout;
     prepareRender(): void;
+    getMaxWidth(domain: number): number;
+    getMaxHeight(domain: number): number;
+    protected _doLoad(src: any): void;
     private $_collectItems;
 }
 
@@ -627,6 +678,17 @@ interface ISeries extends IPlottingItem {
     getValue(point: DataPoint, axis: IAxis): number;
     isVisible(p: DataPoint): boolean;
 }
+interface DataPointArgs {
+    series: string | number;
+    count: number;
+    vcount: number;
+    index: number;
+    vindex: number;
+    x: any;
+    y: any;
+    xValue: any;
+    yValue: any;
+}
 declare abstract class Series extends ChartItem implements ISeries, ILegendSource {
     static _loadSeries(chart: IChart, src: any, defType?: string): Series;
     readonly name: string;
@@ -639,10 +701,11 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     _xAxisObj: IAxis;
     _yAxisObj: IAxis;
     protected _points: DataPointCollection;
-    _visPoints: DataPoint[];
+    _runPoints: DataPoint[];
     _minValue: number;
     _maxValue: number;
     _referents: Series[];
+    _calcedColor: string;
     constructor(chart: IChart, name?: string);
     abstract _type(): string;
     zOrder: number;
@@ -652,11 +715,12 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     yField: string | number;
     colorField: string;
     dataProp: string;
-    xStart: number;
+    xStart: number | string;
     xStep: number | string;
     color: string;
     pointColors: boolean | string[];
     clipped: boolean;
+    contains(p: DataPoint): boolean;
     getPoints(): DataPointCollection;
     getLabeledPoints(): DataPoint[];
     getVisiblePoints(): DataPoint[];
@@ -668,12 +732,13 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     displayName(): string;
     legendColor(): string;
     legendLabel(): string;
-    legendVisible(): boolean;
     ignoreAxisBase(axis: IAxis): boolean;
     canMixWith(other: IPlottingItem): boolean;
     getBaseValue(axis: IAxis): number;
     canMinPadding(axis: IAxis): boolean;
     canMaxPadding(axis: IAxis): boolean;
+    hasMarker(): boolean;
+    setShape(shape: Shape): void;
     protected _createPoint(source: any): DataPoint;
     createPoints(source: any[]): DataPoint[];
     getXStart(): number;
@@ -689,14 +754,16 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     getLabelPosition(p: PointItemPosition): PointItemPosition;
     getLabelOff(off: number): number;
     referBy(ref: Series): void;
+    setPointVisible(p: DataPoint, visible: boolean): void;
     _referOtherSeries(series: Series): boolean;
     protected _getField(axis: IAxis): any;
-    protected _colorByPoint(): boolean;
+    _colorByPoint(): boolean;
     protected _doLoad(src: any): void;
     protected _loadData(src: any): any;
     protected _doLoadPoints(src: any[]): void;
     protected _doPrepareRender(): void;
     prepareAfter(): void;
+    _getPointArgs(p: DataPoint): DataPointArgs;
 }
 declare class PlottingItemCollection {
     readonly chart: IChart;
@@ -705,11 +772,13 @@ declare class PlottingItemCollection {
     private _visibles;
     private _series;
     private _visibleSeries;
+    private _widget;
     constructor(chart: IChart);
     get first(): IPlottingItem;
     get firstSeries(): Series;
     get firstVisible(): IPlottingItem;
     get firstVisibleSeries(): Series;
+    isWidget(): boolean;
     isEmpty(): boolean;
     items(): IPlottingItem[];
     visibles(): IPlottingItem[];
@@ -717,6 +786,7 @@ declare class PlottingItemCollection {
     visibleSeries(): Series[];
     needAxes(): boolean;
     get(name: string): Series;
+    seriesByPoint(point: DataPoint): Series;
     getLegendSources(): ILegendSource[];
     load(src: any): void;
     prepareRender(): void;
@@ -813,7 +883,7 @@ declare class AxisGrid extends AxisItem {
 declare class AxisGuideLabel extends FormattableText {
     constructor(chart: IChart);
     align: Align;
-    valign: VerticalAlign;
+    verticalAlign: VerticalAlign;
 }
 declare abstract class AxisGuide extends AxisItem {
     readonly label: AxisGuideLabel;
@@ -932,7 +1002,7 @@ declare class AxisCollection {
     get items(): Axis[];
     load(src: any): void;
     contains(axis: Axis): boolean;
-    get(name: string): Axis;
+    get(name: string | number): Axis;
     disconnect(): void;
     collectValues(): void;
     collectReferentsValues(): void;
@@ -990,7 +1060,7 @@ declare enum SubtitlePosition {
 }
 declare class Subtitle extends Title {
     position: SubtitlePosition;
-    valign: VerticalAlign;
+    verticalAlign: VerticalAlign;
     text: string;
 }
 
@@ -1003,7 +1073,7 @@ interface IChart {
     xAxis: IAxis;
     yAxis: IAxis;
     colors: string[];
-    _polar: boolean;
+    isPolar(): boolean;
     isInverted(): boolean;
     animatable(): boolean;
     startAngle(): number;
@@ -1020,20 +1090,34 @@ interface IChart {
     _connectSeries(series: IPlottingItem, isX: boolean): Axis;
     _getLegendSources(): ILegendSource[];
     _visibleChanged(item: ChartItem): void;
+    _pointVisibleChanged(series: Series, point: DataPoint): void;
     _modelChanged(item: ChartItem): void;
 }
+declare class Credits extends ChartItem {
+    text: string;
+    url: string;
+    floating: boolean;
+    align: Align;
+    verticalAlign: VerticalAlign;
+    offsetX: number;
+    offsetY: number;
+}
 declare class ChartOptions extends ChartItem {
-    polar: boolean;
+    theme: string;
+    palette: string;
     animatable: boolean;
-    xStart: number;
-    xStep: number;
+    xStart: number | string;
+    xStep: number | string;
     axisGap: number;
-    style: SVGStyleOrClass;
+    credits: Credits;
 }
 interface IChartEventListener {
     onVisibleChanged?(chart: Chart, item: ChartItem): void;
+    onPointVisibleChange?(chart: Chart, series: Series, point: DataPoint): void;
 }
 declare class Chart extends RcEventProvider<IChartEventListener> implements IChart {
+    private _assets;
+    private _themes;
     private _options;
     private _title;
     private _subtitle;
@@ -1043,15 +1127,18 @@ declare class Chart extends RcEventProvider<IChartEventListener> implements ICha
     private _yAxes;
     private _body;
     private _inverted;
-    _polar: boolean;
+    private _polar;
     colors: string[];
     constructor(source?: any);
     startAngle(): number;
     get xStart(): number;
     get xStep(): number;
+    get xStepUnit(): string;
     animatable(): boolean;
     type: string;
+    polar: boolean;
     inverted: boolean;
+    get assets(): AssetCollection;
     get options(): ChartOptions;
     get title(): Title;
     get subtitle(): Subtitle;
@@ -1065,9 +1152,12 @@ declare class Chart extends RcEventProvider<IChartEventListener> implements ICha
     _getSeries(): PlottingItemCollection;
     _getXAxes(): AxisCollection;
     _getYAxes(): AxisCollection;
+    isPolar(): boolean;
+    isWidget(): boolean;
     isInverted(): boolean;
     isEmpty(): boolean;
     seriesByName(series: string): Series;
+    seriesByPoint(point: DataPoint): Series;
     axisByName(axis: string): Axis;
     containsAxis(axis: Axis): boolean;
     getAxes(dir: SectionDir): Axis[];
@@ -1084,6 +1174,7 @@ declare class Chart extends RcEventProvider<IChartEventListener> implements ICha
     _getAxisType(type: string): any;
     getAxesGap(): number;
     _visibleChanged(item: ChartItem): void;
+    _pointVisibleChanged(series: Series, point: DataPoint): void;
     _modelChanged(item: ChartItem): void;
 }
 
@@ -1263,17 +1354,20 @@ type LabelLayoutInfo = {
     labelOff: number;
 };
 declare abstract class SeriesView<T extends Series> extends ChartElement<T> {
-    static readonly POINT_CLASS = "rct-data-point";
+    static readonly POINT_CLASS = "rct-point";
     static readonly DATA_FOUCS = "focus";
     protected _pointContainer: PointContainer;
     private _labelContainer;
     private _trendLineView;
+    protected _visPoints: DataPoint[];
     protected _inverted: boolean;
     protected _animatable: boolean;
     private _viewRate;
     constructor(doc: Document, styleName: string);
+    invertable(): boolean;
     getClipContainer(): RcElement;
     setViewRate(rate: number): void;
+    setPosRate(rate: number): void;
     protected _doViewRateChanged(rate: number): void;
     _setChartOptions(inverted: boolean, animatable: boolean): void;
     _animationStarted(ani: Animation): void;
@@ -1282,10 +1376,12 @@ declare abstract class SeriesView<T extends Series> extends ChartElement<T> {
     pointByDom(elt: Element): IPointView;
     clicked(elt: Element): void;
     protected _doPointClicked(view: IPointView): void;
+    protected _getColor(): string;
     protected _doMeasure(doc: Document, model: T, hintWidth: number, hintHeight: number, phase: number): ISize;
     protected _doLayout(): void;
     protected abstract _prepareSeries(doc: Document, model: T): void;
     protected abstract _renderSeries(width: number, height: number): void;
+    protected _setColorIndex(v: RcElement, p: DataPoint): void;
     protected _labelViews(): PointLabelContainer;
     protected _getViewRate(): number;
     protected _animating(): boolean;
@@ -1333,7 +1429,7 @@ declare class AxisGuideContainer extends LayerElement {
     add(child: AxisGuideView<AxisGuide>): RcElement;
 }
 interface IPlottingOwner {
-    clipSeries(view: RcElement, x: number, y: number, w: number, h: number): void;
+    clipSeries(view: RcElement, x: number, y: number, w: number, h: number, invertable: boolean): void;
     showTooltip(series: Series, point: DataPoint): void;
     hideTooltip(): void;
 }
@@ -1382,6 +1478,13 @@ declare class TitleView extends BoundableElement<Title> {
 
 declare class EmptyView extends GroupElement {
 }
+declare class CreditView extends ChartElement<Credits> {
+    private _textView;
+    constructor(doc: Document);
+    clicked(dom: Element): void;
+    protected _doMeasure(doc: Document, model: Credits, intWidth: number, hintHeight: number, phase: number): ISize;
+    protected _doLayout(param: any): void;
+}
 declare class ChartView extends RcElement {
     private _model;
     _inverted: boolean;
@@ -1392,9 +1495,10 @@ declare class ChartView extends RcElement {
     private _polarView;
     private _currBody;
     private _axisSectionViews;
+    private _creditView;
     private _tooltipView;
     private _seriesClip;
-    private _org;
+    _org: IPoint;
     private _plotWidth;
     private _plotHeight;
     constructor(doc: Document);
@@ -1407,7 +1511,8 @@ declare class ChartView extends RcElement {
     hideTooltip(): void;
     legendByDom(dom: Element): LegendItem;
     seriesByDom(dom: Element): SeriesView<Series>;
-    clipSeries(view: RcElement, x: number, y: number, w: number, h: number): void;
+    creditByDom(dom: Element): CreditView;
+    clipSeries(view: RcElement, x: number, y: number, w: number, h: number, invertable: boolean): void;
     protected _doAttached(parent: RcElement): void;
     private $_checkEmpty;
     private $_prepareBody;
@@ -1421,6 +1526,7 @@ declare class ChartControl extends RcControl implements IChartEventListener {
     private _chartView;
     constructor(doc: Document, container: string | HTMLDivElement);
     onVisibleChanged(chart: Chart, item: ChartItem): void;
+    onPointVisibleChanged(chart: Chart, series: Series, point: DataPoint): void;
     get model(): Chart;
     set model(value: Chart);
     chartView(): ChartView;