realchart 0.9.3 → 0.9.4

package/dist/index.d.ts

@@ -59,6 +59,10 @@ declare enum SectionDir {
     BOTTOM = 2,
     RIGHT = 3
 }
+declare enum AlignBase {
+    CHART = "chart",
+    PLOT = "plot"
+}
 
 interface ISize {
     width: number;
@@ -252,7 +256,7 @@ declare class RcElement extends RcObject {
     setStyleOrClass(style: SVGStyleOrClass): void;
     internalSetStyleOrClass(style: SVGStyleOrClass): void;
     addStyleOrClass(style: SVGStyleOrClass): void;
-    setStyleName(value: string): void;
+    setClass(value: string): void;
     setStyle(prop: string, value: string): boolean;
     internalSetStyle(prop: string, value: string): void;
     putStyles(styles: any, buff?: any): any;
@@ -260,8 +264,8 @@ declare class RcElement extends RcObject {
     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;
+    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;
     setTemporary(): RcElement;
@@ -368,6 +372,32 @@ declare class TextElement extends RcElement {
 }
 
 type RichTextParamCallback = (target: any, param: string) => string;
+declare class Word {
+    text: string;
+    private _literals;
+    get type(): string;
+    parse(str: string): Word;
+    getText(target: any, callback: RichTextParamCallback): string;
+    prepareSpan(span: SVGTSpanElement, target: any, domain: RichTextParamCallback): SVGTSpanElement;
+    protected _doParse(str: string): Word;
+}
+declare class SvgLine {
+    private _words;
+    get words(): Word[];
+    parse(s: string): SvgLine;
+    getText(target: any, domain: RichTextParamCallback): string;
+}
+declare class SvgRichText {
+    private _format;
+    lineHeight: number;
+    private _lines;
+    constructor(format?: string);
+    get format(): string;
+    set format(value: string);
+    get lines(): SvgLine[];
+    build(view: TextElement, target: any, domain: RichTextParamCallback): void;
+    $_parse(fmt: string): void;
+}
 
 declare abstract class ChartItem extends RcObject {
     readonly chart: IChart;
@@ -403,7 +433,7 @@ declare abstract class FormattableText extends ChartText {
     private _text;
     private _numSymbols;
     private _numberFormatter;
-    private _richTextImpl;
+    protected _richTextImpl: SvgRichText;
     constructor(chart: IChart, visible: boolean);
     prefix: string;
     suffix: string;
@@ -414,7 +444,10 @@ declare abstract class FormattableText extends ChartText {
     offset: number;
     get text(): string;
     set text(value: string);
+    setText(value: string): FormattableText;
+    isVisible(): boolean;
     buildSvg(view: TextElement, target: any, callback: RichTextParamCallback): void;
+    setLineHeight(v: number): void;
     protected _doLoadSimple(source: any): boolean;
     private $_getNumberText;
     protected _getText(text: string, value: any, useSymbols: boolean, forceSymbols?: boolean): string;
@@ -458,6 +491,7 @@ declare class DataPoint {
     static swap(pts: IPointPos[]): IPointPos[];
     source: any;
     index: number;
+    vindex: number;
     x: any;
     y: any;
     readonly pid: number;
@@ -519,10 +553,6 @@ declare enum LegendPosition {
     PLOT = "plot",
     SUBPLOT = "subplot"
 }
-declare enum LegendAlignBase {
-    CHART = "chart",
-    PLOT = "plot"
-}
 declare enum LegendLayout {
     AUTO = "auto",
     HORIZONTAL = "horizontal",
@@ -536,7 +566,7 @@ declare class Legend extends ChartItem {
     constructor(chart: IChart);
     position: LegendPosition;
     layout: LegendLayout;
-    alignBase: LegendAlignBase;
+    alignBase: AlignBase;
     left: number;
     right: number;
     top: number;
@@ -545,7 +575,8 @@ declare class Legend extends ChartItem {
     itemGap: number;
     markerGap: number;
     backgroundStyles: SVGStyleOrClass;
-    itemsPerRow: number;
+    itemsPerLine: number;
+    lineGap: number;
     maxWidth: RtPercentSize;
     maxHeight: RtPercentSize;
     items(): LegendItem[];
@@ -553,10 +584,10 @@ declare class Legend extends ChartItem {
     isVisible(): boolean;
     getPosition(): LegendPosition;
     getLayout(): LegendLayout;
-    prepareRender(): void;
     getMaxWidth(domain: number): number;
     getMaxHeight(domain: number): number;
     protected _doLoad(src: any): void;
+    protected _doPrepareRender(chart: IChart): void;
     private $_collectItems;
 }
 
@@ -586,6 +617,7 @@ declare enum PointItemPosition {
 declare class DataPointLabel extends FormattableText {
     position: PointItemPosition;
     offset: number;
+    distance: number;
     constructor(chart: IChart);
     getText(value: any): string;
 }
@@ -678,10 +710,12 @@ interface ISeries extends IPlottingItem {
     getValue(point: DataPoint, axis: IAxis): number;
     isVisible(p: DataPoint): boolean;
 }
-interface DataPointArgs {
+interface IPointStyleArgs {
     series: string | number;
     count: number;
     vcount: number;
+    yMin: number;
+    yMax: number;
     index: number;
     vindex: number;
     x: any;
@@ -689,6 +723,7 @@ interface DataPointArgs {
     xValue: any;
     yValue: any;
 }
+type PointStyleCallback = (args: IPointStyleArgs) => SVGStyleOrClass;
 declare abstract class Series extends ChartItem implements ISeries, ILegendSource {
     static _loadSeries(chart: IChart, src: any, defType?: string): Series;
     readonly name: string;
@@ -706,6 +741,7 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     _maxValue: number;
     _referents: Series[];
     _calcedColor: string;
+    protected _pointArgs: IPointStyleArgs;
     constructor(chart: IChart, name?: string);
     abstract _type(): string;
     zOrder: number;
@@ -720,10 +756,12 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     color: string;
     pointColors: boolean | string[];
     clipped: boolean;
+    pointStyleCallback: PointStyleCallback;
     contains(p: DataPoint): boolean;
     getPoints(): DataPointCollection;
     getLabeledPoints(): DataPoint[];
     getVisiblePoints(): DataPoint[];
+    pointLabelCount(): number;
     isEmpty(): boolean;
     needAxes(): boolean;
     canCategorized(): boolean;
@@ -747,6 +785,7 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     prepareRender(): void;
     collectCategories(axis: IAxis): string[];
     collectValues(axis: IAxis, vals: number[]): void;
+    collectVisibles(): DataPoint[];
     pointValuesPrepared(axis: IAxis): void;
     reference(other: Series, axis: IAxis): void;
     isVisible(point: DataPoint): boolean;
@@ -755,6 +794,10 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     getLabelOff(off: number): number;
     referBy(ref: Series): void;
     setPointVisible(p: DataPoint, visible: boolean): void;
+    protected _createPointArgs(): IPointStyleArgs;
+    protected _preparePointArgs(args: IPointStyleArgs): void;
+    protected _getPointStyleArgs(args: IPointStyleArgs, p: DataPoint): void;
+    getPointStyle(p: DataPoint): any;
     _referOtherSeries(series: Series): boolean;
     protected _getField(axis: IAxis): any;
     _colorByPoint(): boolean;
@@ -763,7 +806,6 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     protected _doLoadPoints(src: any[]): void;
     protected _doPrepareRender(): void;
     prepareAfter(): void;
-    _getPointArgs(p: DataPoint): DataPointArgs;
 }
 declare class PlottingItemCollection {
     readonly chart: IChart;
@@ -855,6 +897,7 @@ interface IAxis {
     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;
     getUnitLength(length: number, value: number): number;
 }
@@ -958,8 +1001,8 @@ declare abstract class Axis extends ChartItem implements IAxis {
     abstract type(): string;
     position: AxisPosition;
     reversed: boolean;
-    min: number;
-    max: number;
+    minValue: number;
+    maxValue: number;
     marginNear: number;
     marginFar: number;
     isEmpty(): boolean;
@@ -980,6 +1023,7 @@ declare abstract class Axis extends ChartItem implements IAxis {
     abstract getUnitLength(length: number, value: number): number;
     getLabelLength(length: number, value: number): number;
     getValue(value: any): number;
+    incStep(value: number, step: any): number;
     parseValue(value: any): number;
     contains(value: number): boolean;
     protected _doLoadProp(prop: string, value: any): boolean;
@@ -1045,8 +1089,15 @@ declare class Body extends ChartItem {
     protected _doPrepareRender(chart: IChart): void;
 }
 
+declare enum PaletteMode {
+    NORMAL = "normal",
+    MIXED = "mixed",
+    RANDOM = "random"
+}
+
 declare class Title extends ChartItem {
     text: string;
+    alignBase: AlignBase;
     align: Align;
     backgroundStyle: SVGStyleOrClass;
     isVisible(): boolean;
@@ -1105,6 +1156,7 @@ declare class Credits extends ChartItem {
 declare class ChartOptions extends ChartItem {
     theme: string;
     palette: string;
+    paletteMode: PaletteMode;
     animatable: boolean;
     xStart: number | string;
     xStep: number | string;
@@ -1272,16 +1324,17 @@ declare class ElementPool<T extends RcElement> extends RcObject {
     get(index: number): T;
     getAll(): T[];
     elementOf(dom: Element): T;
+    find(matcher: (v: T) => boolean): T;
+    setRemoveDelay(v: number): ElementPool<T>;
+    removeLater(v: RcElement, duration: number): void;
     private $_create;
     prepare(count: number, visitor?: Visitor<T>, initor?: Visitor<T>): ElementPool<T>;
     reprepare(viewProp: string, objs: RcObject[], objProp: string, cleaner?: Visitor<T>, initor?: Visitor<T>, visitor?: Visitor<T>): ElementPool<T>;
     borrow(): T;
     free(element: T, removeDelay?: number): void;
     freeAll(elements: T[], removeDelay?: number): void;
-    fadeout(element: T, removeDelay: number, startOpacity?: number): void;
     forEach(visitor: (v: T, i?: number, count?: number) => void): void;
     visit(visitor: (v: T, i: number, count: number) => boolean): boolean;
-    find(visitor: (v: T) => boolean): T;
     sort(compare: (v1: T, v2: T) => number): ElementPool<T>;
     map(callback: (v: T) => any): any[];
 }
@@ -1297,6 +1350,7 @@ declare abstract class RcAnimation {
     private _timer;
     private _handler;
     start(): void;
+    stop(): void;
     protected _start(duration: number, delay?: number, easing?: string): void;
     protected _stop(): void;
     protected _doStart(): void;
@@ -1327,16 +1381,15 @@ declare class PointLabelView extends LabelElement {
     moving: boolean;
     constructor(doc: Document);
 }
-declare class PointLabelContainer extends GroupElement {
+declare class PointLabelContainer extends LayerElement {
     private _labels;
     private _maps;
     constructor(doc: Document);
     clear(): void;
     prepareLabel(doc: Document, view: PointLabelView, index: number, p: DataPoint, model: DataPointLabel): void;
-    prepare(doc: Document, model: Series): void;
+    prepare(doc: Document, owner: SeriesView<Series>): void;
     get(point: DataPoint, index: number): PointLabelView;
-    borrow(index: number): PointLabelView;
-    free(index: number, view: PointLabelView, removeDelay?: number): void;
+    removePoint(p: DataPoint, delay: number): void;
 }
 declare class PointContainer extends LayerElement {
     inverted: boolean;
@@ -1357,7 +1410,7 @@ declare abstract class SeriesView<T extends Series> extends ChartElement<T> {
     static readonly POINT_CLASS = "rct-point";
     static readonly DATA_FOUCS = "focus";
     protected _pointContainer: PointContainer;
-    private _labelContainer;
+    protected _labelContainer: PointLabelContainer;
     private _trendLineView;
     protected _visPoints: DataPoint[];
     protected _inverted: boolean;
@@ -1368,12 +1421,14 @@ declare abstract class SeriesView<T extends Series> extends ChartElement<T> {
     getClipContainer(): RcElement;
     setViewRate(rate: number): void;
     setPosRate(rate: number): void;
+    isPointVisible(p: DataPoint): boolean;
     protected _doViewRateChanged(rate: number): void;
     _setChartOptions(inverted: boolean, animatable: boolean): void;
     _animationStarted(ani: Animation): void;
     _animationFinished(ani: Animation): void;
     protected abstract _getPointPool(): ElementPool<RcElement>;
     pointByDom(elt: Element): IPointView;
+    findPointView(p: DataPoint): RcElement;
     clicked(elt: Element): void;
     protected _doPointClicked(view: IPointView): void;
     protected _getColor(): string;
@@ -1381,7 +1436,9 @@ declare abstract class SeriesView<T extends Series> extends ChartElement<T> {
     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 _prepareVisPoints(model: T): DataPoint[];
+    private $_setColorIndex;
+    protected _setPointStyle(v: RcElement, p: DataPoint, styles?: any[]): void;
     protected _labelViews(): PointLabelContainer;
     protected _getViewRate(): number;
     protected _animating(): boolean;
@@ -1457,6 +1514,7 @@ declare class BodyView extends ChartElement<Body> {
     pointerMoved(p: IPoint, target: EventTarget): void;
     private $_setFocused;
     seriesByDom(elt: Element): SeriesView<Series>;
+    findSeries(ser: Series): SeriesView<Series>;
     protected _doMeasure(doc: Document, model: Body, hintWidth: number, hintHeight: number, phase: number): ISize;
     protected _doLayout(): void;
     private $_createSeriesView;
@@ -1511,6 +1569,7 @@ declare class ChartView extends RcElement {
     hideTooltip(): void;
     legendByDom(dom: Element): LegendItem;
     seriesByDom(dom: Element): SeriesView<Series>;
+    findSeriesView(series: Series): SeriesView<Series>;
     creditByDom(dom: Element): CreditView;
     clipSeries(view: RcElement, x: number, y: number, w: number, h: number, invertable: boolean): void;
     protected _doAttached(parent: RcElement): void;
@@ -1531,20 +1590,27 @@ declare class ChartControl extends RcControl implements IChartEventListener {
     set model(value: Chart);
     chartView(): ChartView;
     refresh(): void;
-    update(config: any, loadAnimation?: boolean): void;
+    load(config: any, loadAnimation?: boolean): void;
     useImage(src: string): void;
     protected _doRender(bounds: IRect): void;
     protected _doRenderBackground(elt: HTMLDivElement, width: number, height: number): void;
 }
 
+declare class RcChartControl {
+    private _proxy;
+    constructor(control: ChartControl);
+    load(config: any, animate?: boolean): void;
+    refresh(): void;
+}
+
 declare class Globals {
     static getVersion(): string;
     static setDebugging(debug: boolean): void;
-    static createChart(doc: Document, container: string | HTMLDivElement, config: any): ChartControl;
+    static createChart(doc: Document, container: string | HTMLDivElement, config: any): RcChartControl;
 }
 
 declare const getVersion: typeof Globals.getVersion;
 declare const setDebugging: typeof Globals.setDebugging;
 declare const createChart: typeof Globals.createChart;
 
-export { Chart, ChartControl, createChart, getVersion, setDebugging };
+export { RcChartControl, createChart, getVersion, setDebugging };