realchart 0.9.3 → 0.9.5

package/README.md

@@ -23,45 +23,33 @@ const chart = RealChart.createChart(document, 'realchart', config);
 ```ts
 // config
 const config = {
-    options: {
-        animatable: false
-    },
-    title: "Basic Real-Chart",
-    legend: true,
-    xAxis: {
-        title: 'X Axis',
-        grid: true
-    },
-    yAxis: {
-        title: 'Y Axis',
-    },
-    series: {
-        pointLabel: {
-            visible: true,
-            effect: 'outline',
-            style: {
-            },
-        },
-        data: [
-            ['home', 7], 
-            ['sky', 11], 
-            ['def', 9], 
-            ['소홍', 10], 
-            ['지리산', 14.3], 
-            ['zzz', 13],
-            ['낙동강', 12.5]
-        ],
-        data2: [
-            [1, 7], 
-            [2, 11], 
-            [3, 9], 
-            [4, 10], 
-            [5, 14.3], 
-            [6, 13],
-            [7, 12.5]
-        ],
-    }
-}
+  options: {},
+  title: "Axis Breaks",
+  xAxis: {
+    title: "일일 Daily fat",
+    categories: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
+    grid: true
+  },
+  yAxis: {
+    title: "Vertical 수직축 Axis",
+    break: [{
+      from: 500,
+      to: 3000,
+      inclusive: false,
+      space: 5
+    }]
+  },
+  series: [{
+    name: 'column1',
+    pointLabel: true,
+    data: [499, 128, 180, 345, 3050, 3590, 3840, 3630, 3120, 520, 240, 80]
+  }, {
+    name: 'column3',
+    pointLabel: true,
+    data: [64, 138, 164, 408, 3120, 3540, 3875, 3420, 720, 320, 160, 20]
+  }]
+};
+const chart = RealChart.createChart(document, 'realchart', config);
 ```
 ### styles
 

package/dist/index.d.ts

@@ -54,10 +54,14 @@ declare enum VerticalAlign {
     BOTTOM = "bottom"
 }
 declare enum SectionDir {
-    LEFT = 0,
-    TOP = 1,
-    BOTTOM = 2,
-    RIGHT = 3
+    LEFT = "left",
+    TOP = "top",
+    BOTTOM = "bottom",
+    RIGHT = "right"
+}
+declare enum AlignBase {
+    CHART = "chart",
+    PLOT = "plot"
 }
 
 interface ISize {
@@ -86,6 +90,7 @@ interface IPointerHandler {
 declare abstract class RcControl extends RcWrappableObject {
     static readonly CLASS_NAME = "rct-control";
     static readonly SHADOW_FILTER = "rr-chart-shadow-filter";
+    static _animatable: boolean;
     private _container;
     private _dom;
     private _htmlRoot;
@@ -97,7 +102,6 @@ declare abstract class RcControl extends RcWrappableObject {
     private _testing;
     private _dirty;
     private _requestTimer;
-    private _invalidElements;
     private _toAnimation;
     private _invalidateLock;
     private _lockDirty;
@@ -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;
@@ -377,12 +407,15 @@ declare abstract class ChartItem extends RcObject {
     set visible(value: boolean);
     style: SVGStyleOrClass;
     load(source: any): ChartItem;
+    update(source: any): ChartItem;
     prepareRender(): void;
     protected _changed(): void;
     protected _doLoadSimple(source: any): boolean;
     protected _getDefObjProps(prop: string): any;
     protected _doLoad(source: any): void;
     protected _doLoadProp(prop: string, value: any): boolean;
+    protected _doUpdateSimple(source: any): boolean;
+    protected _doUpdate(source: any): boolean;
     protected _doPrepareRender(chart: IChart): void;
 }
 declare enum ChartTextEffect {
@@ -403,7 +436,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 +447,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;
@@ -456,11 +492,13 @@ interface IPointPos {
 }
 declare class DataPoint {
     static swap(pts: IPointPos[]): IPointPos[];
-    source: any;
     index: number;
+    vindex: number;
     x: any;
     y: any;
+    series: string | number;
     readonly pid: number;
+    source: any;
     isNull: boolean;
     xValue: number;
     yValue: number;
@@ -475,11 +513,13 @@ declare class DataPoint {
     get xAbs(): number;
     ariaHint(): string;
     labelCount(): number;
+    assignTo(proxy: any): void;
     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 _colorIndex(): number;
     protected _readArray(series: ISeries, v: any[]): void;
     protected _readObject(series: ISeries, v: any): void;
@@ -502,12 +542,14 @@ declare class DataPointCollection {
 
 interface ILegendSource {
     visible: boolean;
+    legendMarker(): RcElement;
     legendColor(): string;
     legendLabel(): string;
 }
 declare class LegendItem extends ChartItem {
     legend: Legend;
     source: ILegendSource;
+    static readonly MARKER_SIZE = 12;
     constructor(legend: Legend, source: ILegendSource);
     text(): string;
 }
@@ -519,10 +561,6 @@ declare enum LegendPosition {
     PLOT = "plot",
     SUBPLOT = "subplot"
 }
-declare enum LegendAlignBase {
-    CHART = "chart",
-    PLOT = "plot"
-}
 declare enum LegendLayout {
     AUTO = "auto",
     HORIZONTAL = "horizontal",
@@ -536,7 +574,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 +583,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 +592,14 @@ declare class Legend extends ChartItem {
     isVisible(): boolean;
     getPosition(): LegendPosition;
     getLayout(): LegendLayout;
-    prepareRender(): void;
     getMaxWidth(domain: number): number;
     getMaxHeight(domain: number): number;
+    getLeft(doamin: number): number;
+    getRight(doamin: number): number;
+    getTop(doamin: number): number;
+    getBottom(doamin: number): number;
     protected _doLoad(src: any): void;
+    protected _doPrepareRender(chart: IChart): void;
     private $_collectItems;
 }
 
@@ -586,8 +629,10 @@ declare enum PointItemPosition {
 declare class DataPointLabel extends FormattableText {
     position: PointItemPosition;
     offset: number;
+    distance: number;
     constructor(chart: IChart);
     getText(value: any): string;
+    protected _doLoad(source: any): void;
 }
 interface IPlottingItem {
     index: number;
@@ -678,10 +723,12 @@ interface ISeries extends IPlottingItem {
     getValue(point: DataPoint, axis: IAxis): number;
     isVisible(p: DataPoint): boolean;
 }
-interface DataPointArgs {
+interface IPointStyleCallbackArgs {
     series: string | number;
     count: number;
     vcount: number;
+    yMin: number;
+    yMax: number;
     index: number;
     vindex: number;
     x: any;
@@ -689,6 +736,7 @@ interface DataPointArgs {
     xValue: any;
     yValue: any;
 }
+type PointStyleCallback = (args: IPointStyleCallbackArgs) => SVGStyleOrClass;
 declare abstract class Series extends ChartItem implements ISeries, ILegendSource {
     static _loadSeries(chart: IChart, src: any, defType?: string): Series;
     readonly name: string;
@@ -706,6 +754,8 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     _maxValue: number;
     _referents: Series[];
     _calcedColor: string;
+    private _legendMarker;
+    protected _pointArgs: IPointStyleCallbackArgs;
     constructor(chart: IChart, name?: string);
     abstract _type(): string;
     zOrder: number;
@@ -720,16 +770,21 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     color: string;
     pointColors: boolean | string[];
     clipped: boolean;
+    displayInLegend: boolean;
+    pointStyleCallback: PointStyleCallback;
     contains(p: DataPoint): boolean;
     getPoints(): DataPointCollection;
     getLabeledPoints(): DataPoint[];
     getVisiblePoints(): DataPoint[];
+    pointLabelCount(): number;
     isEmpty(): boolean;
     needAxes(): boolean;
     canCategorized(): boolean;
     defaultYAxisType(): string;
     clusterable(): boolean;
     displayName(): string;
+    legendMarker(): RcElement;
+    setLegendMarker(elt: RcElement): void;
     legendColor(): string;
     legendLabel(): string;
     ignoreAxisBase(axis: IAxis): boolean;
@@ -747,6 +802,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 +811,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(): IPointStyleCallbackArgs;
+    protected _preparePointArgs(args: IPointStyleCallbackArgs): void;
+    protected _getPointStyleArgs(args: IPointStyleCallbackArgs, p: DataPoint): void;
+    getPointStyle(p: DataPoint): any;
     _referOtherSeries(series: Series): boolean;
     protected _getField(axis: IAxis): any;
     _colorByPoint(): boolean;
@@ -763,7 +823,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;
@@ -810,6 +869,7 @@ declare abstract class SeriesGroup<T extends Series> extends ChartItem implement
     layout: SeriesGroupLayout;
     xAxis: string | number;
     yAxis: string | number;
+    displayInLegend: boolean;
     get series(): T[];
     needAxes(): boolean;
     isEmpty(): boolean;
@@ -855,6 +915,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 +1019,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;
@@ -970,6 +1031,7 @@ declare abstract class Axis extends ChartItem implements IAxis {
     protected abstract _createLabelModel(): AxisLabel;
     protected abstract _doPrepareRender(): void;
     protected abstract _doBuildTicks(min: number, max: number, length: number): IAxisTick[];
+    isBased(): boolean;
     disconnect(): void;
     collectValues(): void;
     collectReferentsValues(): void;
@@ -980,6 +1042,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 +1108,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 +1175,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;
@@ -1112,6 +1183,7 @@ declare class ChartOptions extends ChartItem {
     credits: Credits;
 }
 interface IChartEventListener {
+    onModelChanged?(chart: Chart, item: ChartItem): void;
     onVisibleChanged?(chart: Chart, item: ChartItem): void;
     onPointVisibleChange?(chart: Chart, series: Series, point: DataPoint): void;
 }
@@ -1173,9 +1245,9 @@ declare class Chart extends RcEventProvider<IChartEventListener> implements ICha
     _getSeriesType(type: string): any;
     _getAxisType(type: string): any;
     getAxesGap(): number;
+    _modelChanged(item: ChartItem): void;
     _visibleChanged(item: ChartItem): void;
     _pointVisibleChanged(series: Series, point: DataPoint): void;
-    _modelChanged(item: ChartItem): void;
 }
 
 declare abstract class GroupElement extends RcElement {
@@ -1230,6 +1302,7 @@ declare abstract class ChartElement<T extends ChartItem> extends RcElement {
     _debugRect: RectElement;
     constructor(doc: Document, styleName?: any);
     chart(): IChart;
+    protected _prepareStyleOrClass(model: T): void;
     measure(doc: Document, model: T, hintWidth: number, hintHeight: number, phase: number): ISize;
     layout(param?: any): ChartElement<ChartItem>;
     resizeByMeasured(): ChartElement<ChartItem>;
@@ -1272,16 +1345,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 +1371,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 +1402,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;
@@ -1356,9 +1430,11 @@ type LabelLayoutInfo = {
 declare abstract class SeriesView<T extends Series> extends ChartElement<T> {
     static readonly POINT_CLASS = "rct-point";
     static readonly DATA_FOUCS = "focus";
+    static readonly LEGEND_MARKER = "rct-legend-item-marker";
     protected _pointContainer: PointContainer;
-    private _labelContainer;
+    protected _labelContainer: PointLabelContainer;
     private _trendLineView;
+    protected _legendMarker: RcElement;
     protected _visPoints: DataPoint[];
     protected _inverted: boolean;
     protected _animatable: boolean;
@@ -1368,20 +1444,28 @@ 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;
+    prepareSeries(doc: Document, model: T): void;
+    protected _prepareStyleOrClass(model: T): void;
     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 _getLegendMarker(doc: Document): RcElement;
+    protected _createLegendMarker(doc: Document, size: number): RcElement;
+    protected _collectVisPoints(model: T): DataPoint[];
+    private $_setColorIndex;
+    protected _setPointStyle(v: RcElement, model: T, p: DataPoint, styles?: any[]): void;
     protected _labelViews(): PointLabelContainer;
     protected _getViewRate(): number;
     protected _animating(): boolean;
@@ -1453,10 +1537,12 @@ declare class BodyView extends ChartElement<Body> {
     private _crosshairLines;
     private _focused;
     constructor(doc: Document, owner: IPlottingOwner);
+    prepareSeries(doc: Document, chart: IChart): void;
     prepareGuideContainers(): void;
     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 +1597,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;
@@ -1525,26 +1612,36 @@ declare class ChartControl extends RcControl implements IChartEventListener {
     private _model;
     private _chartView;
     constructor(doc: Document, container: string | HTMLDivElement);
+    onModelChanged(chart: Chart, item: ChartItem): void;
     onVisibleChanged(chart: Chart, item: ChartItem): void;
     onPointVisibleChanged(chart: Chart, series: Series, point: DataPoint): void;
     get model(): Chart;
     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 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 setAnimatable: typeof Globals.setAnimatable;
 declare const createChart: typeof Globals.createChart;
 
-export { Chart, ChartControl, createChart, getVersion, setDebugging };
+export { RcChartControl, createChart, getVersion, setAnimatable, setDebugging };