@visactor/vchart 1.2.3 → 1.3.0-beta.0

package/esm/core/interface.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/interface.ts"],"names":[],"mappings":"","file":"interface.js","sourcesContent":["import type { DataSet, DataView } from '@visactor/vdataset';\n\nimport type { IParserOptions } from '@visactor/vdataset/es/parser';\nimport type {\n  Datum,\n  IMarkStateSpec,\n  IPoint,\n  IRegionQuerier,\n  IShowTooltipOption,\n  ISpec,\n  ITooltipHandler,\n  Maybe,\n  MaybeArray,\n  StringOrNumber\n} from '../typings';\nimport type { IMorphConfig } from '../animation/spec';\nimport type { IBoundsLike } from '@visactor/vutils';\nimport type { EventCallback, EventParams, EventQuery, EventType } from '../event/interface';\nimport type { IMark } from '../mark/interface';\nimport type { ISeries } from '../series/interface/series';\nimport type { ITheme } from '../theme';\nimport type { IComponent } from '../component/interface';\nimport type { LayoutCallBack } from '../layout/interface';\nimport type { Compiler } from '../compile/compiler';\nimport type { IChart } from '../chart/interface';\nimport type { Stage } from '@visactor/vrender';\n\nexport type DataLinkSeries = {\n  /**\n   * 关联的系列 id\n   * the binding series id\n   */\n  seriesId?: StringOrNumber;\n  /**\n   * 关联的系列索引\n   * the binding series index\n   */\n  seriesIndex?: number;\n};\n\nexport type DataLinkAxis = {\n  /**\n   * 关联的轴 id，目前仅支持直角坐标轴\n   * the binding axis id\n   */\n  axisId?: StringOrNumber;\n  /**\n   * 关联的轴索引，目前仅支持直角坐标轴\n   * the binding axis index\n   */\n  axisIndex?: number;\n};\n\nexport interface IVChart {\n  readonly id: number;\n\n  /**\n   * **同步**渲染图表。\n   * @param morphConfig 图表 morph 动画配置，可选\n   * @returns VChart 实例\n   */\n  renderSync: (morphConfig?: IMorphConfig) => IVChart;\n\n  /**\n   * **异步**渲染图表。\n   * @async\n   * @param morphConfig 图表 morph 动画配置，可选\n   * @returns VChart 实例\n   */\n  renderAsync: (morphConfig?: IMorphConfig) => Promise<IVChart>;\n\n  /**\n   * **异步**更新数据。\n   * @param id 数据 id\n   * @param data 数据值\n   * @param options 数据参数\n   * @returns VChart 实例\n   */\n  updateData: (id: StringOrNumber, data: DataView | Datum[] | string, options?: IParserOptions) => Promise<IVChart>;\n\n  /**\n   * **异步**批量更新数据。\n   * @param list 待更新的数据列表\n   * @returns VChart 实例\n   */\n  updateDataInBatches: (list: { id: string; data: DataView | Datum[]; options?: IParserOptions }[]) => Promise<IVChart>;\n\n  /**\n   * **同步**更新数据。\n   * @param id 数据 id\n   * @param data 数据值\n   * @param options 数据参数\n   * @returns VChart 实例\n   */\n  updateDataSync: (id: StringOrNumber, data: DataView | Datum[], options?: IParserOptions) => IVChart;\n\n  /**\n   * **异步**spec 更新。\n   * @param spec\n   * @param forceMerge\n   * @returns\n   */\n  updateSpec: (spec: ISpec, forceMerge?: boolean, morphConfig?: IMorphConfig) => Promise<IVChart>;\n\n  /**\n   * 更新绘制区域。\n   * @param viewBox 绘制区域\n   * @param reRender 是否重新渲染，默认为 true\n   * @returns\n   */\n  updateViewBox: (viewBox: IBoundsLike, reRender?: boolean) => IVChart;\n\n  /**\n   * **异步方法**，图表尺寸更新方法。\n   * @param width 宽度\n   * @param height 高度\n   * @returns VChart 当前实例\n   */\n  resize: (width: number, height: number) => Promise<IVChart>;\n\n  /**\n   * 销毁图表。\n   */\n  release: () => void;\n\n  /**\n   * 事件监听\n   */\n  on: ((eType: EventType, handler: EventCallback<EventParams>) => void) &\n    ((eType: EventType, query: EventQuery, handler: EventCallback<EventParams>) => void);\n  off: (eType: EventType, handler?: EventCallback<EventParams>) => void;\n\n  /**\n   * 更新或设置图元状态。\n   * @param state 状态筛选器\n   * @param filter 筛选器\n   */\n  updateState: (\n    state: Record<string, Omit<IMarkStateSpec<unknown>, 'style'>>,\n    filter?: (series: ISeries, mark: IMark, stateKey: string) => boolean //series + mark 筛选\n  ) => void;\n\n  /**\n   * 更新图元选中状态。\n   * @param datum hover 图元数据\n   * @param filter 筛选器 用来筛选系列与mark\n   * @param region region 筛选器\n   */\n  setSelected: (\n    datum: MaybeArray<any> | null,\n    filter?: (series: ISeries, mark: IMark) => boolean,\n    region?: IRegionQuerier\n  ) => void;\n\n  /**\n   * 更新图元 hover 状态\n   * @param datum hover 图元数据\n   * @param filter 筛选器 用来筛选系列与mark\n   * @param region region 筛选器\n   */\n  setHovered: (\n    datum: MaybeArray<Datum> | null,\n    filter?: (series: ISeries, mark: IMark) => boolean,\n    region?: IRegionQuerier\n  ) => void;\n\n  /**\n   * 获取当前主题，会返回完整的主题配置\n   * */\n  getCurrentTheme: () => ITheme;\n\n  /**\n   * 获取当前主题名称（只能获取用户通过`setCurrentTheme`方法设置过的主题，默认值为`ThemeManager`统一设置的主题）\n   */\n  getCurrentThemeName: () => string;\n\n  /**\n   * **异步方法**， 设置当前主题。\n   * @param name 主题名称\n   * @returns\n   */\n  setCurrentTheme: (name: string) => Promise<IVChart>;\n\n  /**\n   * 自定义 TooltipHandler。\n   * @param tooltipHandler\n   */\n  setTooltipHandler: (tooltipHandler: ITooltipHandler) => void;\n\n  /**\n   * 获取用户定义的 TooltipHandler\n   * @returns ITooltipHandler\n   */\n  getTooltipHandlerByUser: () => ITooltipHandler | undefined;\n\n  /**\n   * 获取 TooltipHandler\n   * @returns\n   */\n  getTooltipHandler: () => ITooltipHandler | undefined;\n\n  /**\n   * 手动调用展示 tooltip\n   * @param datum 原始数据\n   * @param options\n   * @returns\n   */\n  showTooltip: (datum: Datum, options: IShowTooltipOption) => boolean;\n\n  /**\n   * 手动调用，关闭 tooltip\n   * @returns\n   */\n  hideTooltip: () => boolean;\n\n  // 图例相关 api\n  /**\n   * 根据图例组件 id 获取图例数据\n   * @param id 组件 id\n   * @returns\n   */\n  getLegendDataById: (id: string) => Datum[];\n\n  /**\n   * 根据图例组件索引获取图例数据\n   * @param index 图例索引，默认为 0\n   * @returns\n   */\n  getLegendDataByIndex: (index?: number) => Datum[];\n\n  /**\n   * 根据图例组件 id 获取当前图例的选中项\n   * @param id 组件 id\n   * @returns\n   */\n  getLegendSelectedDataById: (id: string) => StringOrNumber[];\n\n  /**\n   * 根据图例组件索引获取当前图例的选中项\n   * @param index 图例索引，默认为 0\n   * @returns\n   */\n  getLegendSelectedDataByIndex: (index?: number) => StringOrNumber[];\n\n  /**\n   * 根据图例组件 id 更新图例选中数据\n   * @param id\n   * @returns\n   */\n  setLegendSelectedDataById: (id: string, selectedData: StringOrNumber[]) => void;\n\n  /**\n   * 根据图例组件索引更新图例选中数据\n   * @param index 图例索引，默认为 0\n   * @returns\n   */\n  setLegendSelectedDataByIndex: (index: number, selectedData: StringOrNumber[]) => void;\n\n  /**\n   * **异步方法**返回一个包含图片展示的 data URI。\n   * @returns data URI\n   */\n  getDataURL: () => Promise<any>;\n\n  /**\n   * **异步方法** 导出图表图片，只支持浏览器端。\n   * @param name 保存的图片名称\n   * @returns\n   */\n  exportImg: (name?: string) => Promise<void>;\n\n  /**\n   * 目前仅支持 node 环境，用于 node 端的图片导出\n   * @returns\n   */\n  getImageBuffer: () => void;\n  /**\n   * 设置自定义布局\n   */\n  setLayout: (layout: LayoutCallBack) => void;\n  /**\n   * 强制重新布局\n   */\n  reLayout: () => void;\n\n  /**\n   * 获取编译器实例\n   * @returns\n   */\n  getCompiler: () => Compiler;\n\n  /**\n   * Get the chart instance\n   * 获取 Chart 图表实例。\n   * @returns Chart 实例\n   */\n  getChart: () => Maybe<IChart>;\n\n  /**\n   * Get the renderer instance.\n   * 获取渲染引擎实例。\n   * @returns the instance of VRender Stage\n   */\n  getStage: () => Stage;\n\n  /**\n   * 获取 canvas dom\n   * @returns HTMLCanvasElement | undefined\n   */\n  getCanvas: () => HTMLCanvasElement | undefined;\n\n  /**\n   * 获取图表的 dom 容器\n   * @returns\n   */\n  getContainer: () => Maybe<HTMLElement>;\n\n  /**\n   * 获取图表所有的组件实例\n   * @returns 组件实例\n   */\n  getComponents: () => IComponent[];\n\n  /**\n   * 获取图表的 DataSet 实例\n   * @returns DataSet 实例\n   */\n  getDataSet: () => Maybe<DataSet>;\n\n  // 数据转换相关的 api\n  /**\n   * Convert the data to coordinate position\n   * @param datum the datum to convert\n   * @param dataLinkInfo the data link info, could be seriesId or seriesIndex, default is { seriesIndex: 0 }\n   * @param isRelativeToCanvas 是否相对画布坐标，默认为 false Whether relative to canvas coordinates, default is false\n   * @returns\n   */\n  convertDatumToPosition: (datum: Datum, dataLinkInfo?: DataLinkSeries, isRelativeToCanvas?: boolean) => IPoint | null;\n\n  /**\n   * Convert the value to coordinate position\n   * @param value number | [number, number], the value to convert\n   * @param dataLinkInfo the data link info, could be seriesId,seriesIndex,axisId,axisIndex\n   * @param isRelativeToCanvas 是否相对画布坐标，默认为 false Whether relative to canvas coordinates, default is false\n   * returns\n   */\n  convertValueToPosition: ((\n    value: StringOrNumber,\n    dataLinkInfo: DataLinkAxis,\n    isRelativeToCanvas?: boolean\n  ) => number | null) &\n    ((\n      value: [StringOrNumber, StringOrNumber],\n      dataLinkInfo: DataLinkSeries,\n      isRelativeToCanvas?: boolean\n    ) => IPoint | null);\n}\n\nexport interface IGlobalConfig {\n  /** 是否全局显示唯一 tooltip */\n  uniqueTooltip?: boolean;\n  /** 是否监测图表 dom 变化自动 release */\n  // TODO\n  // autoRelease?: boolean;\n}\n"]}
+{"version":3,"sources":["../src/core/interface.ts"],"names":[],"mappings":"","file":"interface.js","sourcesContent":["import type { DataSet, DataView } from '@visactor/vdataset';\n\nimport type { IParserOptions } from '@visactor/vdataset/es/parser';\nimport type {\n  Datum,\n  IMarkStateSpec,\n  IPoint,\n  IRegionQuerier,\n  IShowTooltipOption,\n  ISpec,\n  ITooltipHandler,\n  Maybe,\n  MaybeArray,\n  StringOrNumber\n} from '../typings';\nimport type { IMorphConfig } from '../animation/spec';\nimport type { IBoundsLike } from '@visactor/vutils';\nimport type { EventCallback, EventParams, EventQuery, EventType } from '../event/interface';\nimport type { IMark } from '../mark/interface';\nimport type { ISeries } from '../series/interface/series';\nimport type { ITheme } from '../theme';\nimport type { IComponent } from '../component/interface';\nimport type { LayoutCallBack } from '../layout/interface';\nimport type { Compiler } from '../compile/compiler';\nimport type { IChart } from '../chart/interface';\nimport type { Stage } from '@visactor/vrender';\n\nexport type DataLinkSeries = {\n  /**\n   * 关联的系列 id\n   * the binding series id\n   */\n  seriesId?: StringOrNumber;\n  /**\n   * 关联的系列索引\n   * the binding series index\n   */\n  seriesIndex?: number;\n};\n\nexport type DataLinkAxis = {\n  /**\n   * 关联的轴 id，目前仅支持直角坐标轴\n   * the binding axis id\n   */\n  axisId?: StringOrNumber;\n  /**\n   * 关联的轴索引，目前仅支持直角坐标轴\n   * the binding axis index\n   */\n  axisIndex?: number;\n};\n\nexport interface IVChart {\n  readonly id: number;\n\n  /**\n   * **同步**渲染图表。\n   * @param morphConfig 图表 morph 动画配置，可选\n   * @returns VChart 实例\n   */\n  renderSync: (morphConfig?: IMorphConfig) => IVChart;\n\n  /**\n   * **异步**渲染图表。\n   * @async\n   * @param morphConfig 图表 morph 动画配置，可选\n   * @returns VChart 实例\n   */\n  renderAsync: (morphConfig?: IMorphConfig) => Promise<IVChart>;\n\n  /**\n   * **异步**更新数据。\n   * @param id 数据 id\n   * @param data 数据值\n   * @param options 数据参数\n   * @returns VChart 实例\n   */\n  updateData: (id: StringOrNumber, data: DataView | Datum[] | string, options?: IParserOptions) => Promise<IVChart>;\n\n  /**\n   * **异步**批量更新数据。\n   * @param list 待更新的数据列表\n   * @returns VChart 实例\n   */\n  updateDataInBatches: (list: { id: string; data: DataView | Datum[]; options?: IParserOptions }[]) => Promise<IVChart>;\n\n  /**\n   * **同步**更新数据。\n   * @param id 数据 id\n   * @param data 数据值\n   * @param options 数据参数\n   * @returns VChart 实例\n   */\n  updateDataSync: (id: StringOrNumber, data: DataView | Datum[], options?: IParserOptions) => IVChart;\n\n  /**\n   * **异步**spec 更新。\n   * @param spec\n   * @param forceMerge\n   * @returns\n   */\n  updateSpec: (spec: ISpec, forceMerge?: boolean, morphConfig?: IMorphConfig) => Promise<IVChart>;\n\n  /**\n   * 更新绘制区域。\n   * @param viewBox 绘制区域\n   * @param reRender 是否重新渲染，默认为 true\n   * @returns\n   */\n  updateViewBox: (viewBox: IBoundsLike, reRender?: boolean) => IVChart;\n\n  /**\n   * **异步方法**，图表尺寸更新方法。\n   * @param width 宽度\n   * @param height 高度\n   * @returns VChart 当前实例\n   */\n  resize: (width: number, height: number) => Promise<IVChart>;\n\n  /**\n   * 销毁图表。\n   */\n  release: () => void;\n\n  /**\n   * 事件监听\n   */\n  on: ((eType: EventType, handler: EventCallback<EventParams>) => void) &\n    ((eType: EventType, query: EventQuery, handler: EventCallback<EventParams>) => void);\n  off: (eType: EventType, handler?: EventCallback<EventParams>) => void;\n\n  /**\n   * 更新或设置图元状态。\n   * @param state 状态筛选器\n   * @param filter 筛选器\n   */\n  updateState: (\n    state: Record<string, Omit<IMarkStateSpec<unknown>, 'style'>>,\n    filter?: (series: ISeries, mark: IMark, stateKey: string) => boolean //series + mark 筛选\n  ) => void;\n\n  /**\n   * 更新图元选中状态。\n   * @param datum hover 图元数据\n   * @param filter 筛选器 用来筛选系列与mark\n   * @param region region 筛选器\n   */\n  setSelected: (\n    datum: MaybeArray<any> | null,\n    filter?: (series: ISeries, mark: IMark) => boolean,\n    region?: IRegionQuerier\n  ) => void;\n\n  /**\n   * 更新图元 hover 状态\n   * @param datum hover 图元数据\n   * @param filter 筛选器 用来筛选系列与mark\n   * @param region region 筛选器\n   */\n  setHovered: (\n    datum: MaybeArray<Datum> | null,\n    filter?: (series: ISeries, mark: IMark) => boolean,\n    region?: IRegionQuerier\n  ) => void;\n\n  /**\n   * 获取当前主题，会返回完整的主题配置\n   * */\n  getCurrentTheme: () => ITheme;\n\n  /**\n   * 获取当前主题名称（只能获取用户通过`setCurrentTheme`方法设置过的主题，默认值为`ThemeManager`统一设置的主题）\n   */\n  getCurrentThemeName: () => string;\n\n  /**\n   * **异步方法**， 设置当前主题。\n   * @param name 主题名称\n   * @returns\n   */\n  setCurrentTheme: (name: string) => Promise<IVChart>;\n\n  /**\n   * 自定义 TooltipHandler。\n   * @param tooltipHandler\n   */\n  setTooltipHandler: (tooltipHandler: ITooltipHandler) => void;\n\n  /**\n   * 获取用户定义的 TooltipHandler\n   * @returns ITooltipHandler\n   */\n  getTooltipHandlerByUser: () => ITooltipHandler | undefined;\n\n  /**\n   * 获取 TooltipHandler\n   * @returns\n   */\n  getTooltipHandler: () => ITooltipHandler | undefined;\n\n  /**\n   * 手动调用展示 tooltip\n   * @param datum 原始数据\n   * @param options\n   * @returns\n   */\n  showTooltip: (datum: Datum, options: IShowTooltipOption) => boolean;\n\n  /**\n   * 手动调用，关闭 tooltip\n   * @returns\n   */\n  hideTooltip: () => boolean;\n\n  // 图例相关 api\n  /**\n   * 根据图例组件 id 获取图例数据\n   * @param id 组件 id\n   * @returns\n   */\n  getLegendDataById: (id: string) => Datum[];\n\n  /**\n   * 根据图例组件索引获取图例数据\n   * @param index 图例索引，默认为 0\n   * @returns\n   */\n  getLegendDataByIndex: (index?: number) => Datum[];\n\n  /**\n   * 根据图例组件 id 获取当前图例的选中项\n   * @param id 组件 id\n   * @returns\n   */\n  getLegendSelectedDataById: (id: string) => StringOrNumber[];\n\n  /**\n   * 根据图例组件索引获取当前图例的选中项\n   * @param index 图例索引，默认为 0\n   * @returns\n   */\n  getLegendSelectedDataByIndex: (index?: number) => StringOrNumber[];\n\n  /**\n   * 根据图例组件 id 更新图例选中数据\n   * @param id\n   * @returns\n   */\n  setLegendSelectedDataById: (id: string, selectedData: StringOrNumber[]) => void;\n\n  /**\n   * 根据图例组件索引更新图例选中数据\n   * @param index 图例索引，默认为 0\n   * @returns\n   */\n  setLegendSelectedDataByIndex: (index: number, selectedData: StringOrNumber[]) => void;\n\n  /**\n   * **异步方法**返回一个包含图片展示的 data URI。\n   * @returns data URI\n   */\n  getDataURL: () => Promise<any>;\n\n  /**\n   * **异步方法** 导出图表图片，只支持浏览器端。\n   * @param name 保存的图片名称\n   * @returns\n   */\n  exportImg: (name?: string) => Promise<void>;\n\n  /**\n   * 目前仅支持 node 环境，用于 node 端的图片导出\n   * @returns\n   */\n  getImageBuffer: () => void;\n  /**\n   * 设置自定义布局\n   */\n  setLayout: (layout: LayoutCallBack) => void;\n  /**\n   * 强制重新布局\n   */\n  reLayout: () => void;\n\n  /**\n   * 获取编译器实例\n   * @returns\n   */\n  getCompiler: () => Compiler;\n\n  /**\n   * Get the chart instance\n   * 获取 Chart 图表实例。\n   * @returns Chart 实例\n   */\n  getChart: () => Maybe<IChart>;\n\n  /**\n   * Get the renderer instance.\n   * 获取渲染引擎实例。\n   * @returns the instance of VRender Stage\n   */\n  getStage: () => Stage;\n\n  /**\n   * 获取 canvas dom\n   * @returns HTMLCanvasElement | undefined\n   */\n  getCanvas: () => HTMLCanvasElement | undefined;\n\n  /**\n   * 获取图表的 dom 容器\n   * @returns\n   */\n  getContainer: () => Maybe<HTMLElement>;\n\n  /**\n   * 获取图表所有的组件实例\n   * @returns 组件实例\n   */\n  getComponents: () => IComponent[];\n\n  /**\n   * 获取图表的 DataSet 实例\n   * @returns DataSet 实例\n   */\n  getDataSet: () => Maybe<DataSet>;\n\n  // 数据转换相关的 api\n  /**\n   * Convert the data to coordinate position\n   * @param datum the datum to convert\n   * @param dataLinkInfo the data link info, could be seriesId or seriesIndex, default is { seriesIndex: 0 }\n   * @param isRelativeToCanvas 是否相对画布坐标，默认为 false Whether relative to canvas coordinates, default is false\n   * @returns\n   */\n  convertDatumToPosition: (datum: Datum, dataLinkInfo?: DataLinkSeries, isRelativeToCanvas?: boolean) => IPoint | null;\n\n  /**\n   * Convert the value to coordinate position\n   * @param value number | [number, number], the value to convert\n   * @param dataLinkInfo the data link info, could be seriesId,seriesIndex,axisId,axisIndex\n   * @param isRelativeToCanvas 是否相对画布坐标，默认为 false Whether relative to canvas coordinates, default is false\n   * returns\n   */\n  convertValueToPosition: ((\n    value: StringOrNumber,\n    dataLinkInfo: DataLinkAxis,\n    isRelativeToCanvas?: boolean\n  ) => number | null) &\n    ((\n      value: [StringOrNumber, StringOrNumber],\n      dataLinkInfo: DataLinkSeries,\n      isRelativeToCanvas?: boolean\n    ) => IPoint | null);\n\n  /** 停止正在进行的所有动画 */\n  stopAnimation: () => void;\n\n  /** 暂停正在进行的所有动画 */\n  pauseAnimation: () => void;\n\n  /** 恢复暂停时正在进行的所有动画 */\n  resumeAnimation: () => void;\n}\n\nexport interface IGlobalConfig {\n  /** 是否全局显示唯一 tooltip */\n  uniqueTooltip?: boolean;\n  /** 是否监测图表 dom 变化自动 release */\n  // TODO\n  // autoRelease?: boolean;\n}\n"]}

package/esm/core/vchart.d.ts

@@ -1,6 +1,6 @@
 import type { ISeries } from '../series/interface/series';
 import type { ILayoutConstructor, LayoutCallBack } from '../layout/interface';
-import type { IMarkStateSpec, IInitOption } from '../typings/spec/common';
+import type { IDataValues, IMarkStateSpec, IInitOption } from '../typings/spec/common';
 import type { ISeriesConstructor } from '../series/interface';
 import type { DimensionIndexOption, IChart, IChartConstructor } from '../chart/interface';
 import type { IComponentConstructor } from '../component/interface';
@@ -80,6 +80,8 @@ export declare class VChart implements IVChart {
         options?: IParserOptions;
     }[]): Promise<IVChart>;
     updateDataSync(id: StringOrNumber, data: DataView | Datum[], options?: IParserOptions): IVChart;
+    updateFullDataSync(data: IDataValues | IDataValues[], reRender?: boolean): IVChart;
+    updateFullData(data: IDataValues | IDataValues[], reRender?: boolean): Promise<IVChart>;
     updateSpec(spec: ISpec, forceMerge?: boolean, morphConfig?: IMorphConfig): Promise<IVChart>;
     updateSpecSync(spec: ISpec, forceMerge?: boolean, morphConfig?: IMorphConfig): IVChart;
     resize(width: number, height: number): Promise<IVChart>;
@@ -120,6 +122,9 @@ export declare class VChart implements IVChart {
     getContainer(): Maybe<HTMLElement>;
     getComponents(): import("../component/interface").IComponent[];
     setDimensionIndex(value: StringOrNumber, opt?: DimensionIndexOption): void;
+    stopAnimation(): void;
+    pauseAnimation(): void;
+    resumeAnimation(): void;
     convertDatumToPosition(datum: Datum, dataLinkInfo?: DataLinkSeries, isRelativeToCanvas?: boolean): IPoint | null;
     convertValueToPosition(value: StringOrNumber, dataLinkInfo: DataLinkAxis, isRelativeToCanvas?: boolean): number | null;
     convertValueToPosition(value: [StringOrNumber, StringOrNumber], dataLinkInfo: DataLinkSeries, isRelativeToCanvas?: boolean): IPoint | null;

package/esm/core/vchart.js

@@ -40,7 +40,7 @@ import { ComponentTypeEnum } from "../component/interface";
 
 import { DataSet, dataViewParser, DataView } from "@visactor/vdataset";
 
-import { isString, isValid, isNil, array, merge, createID, debounce, isTrueBrowser, warn, specTransform, convertPoint } from "../util";
+import { isString, isValid, isNil, array, mergeSpec, createID, debounce, isTrueBrowser, warn, specTransform, convertPoint, preprocessSpecOrTheme, mergeTheme } from "../util";
 
 import { Factory } from "./factory";
 
@@ -68,12 +68,14 @@ import { getCanvasDataURL, URLToImage } from "../util/image";
 
 import { ChartEvent, DEFAULT_CHART_HEIGHT, DEFAULT_CHART_WIDTH, VGRAMMAR_HOOK_EVENT } from "../constant";
 
-import { getContainerSize, isArray, isEmpty, Logger } from "@visactor/vutils";
+import { getContainerSize, isArray, isEmpty, Logger, merge as mergeOrigin } from "@visactor/vutils";
 
 import { InstanceManager } from "./instance-manager";
 
 import { setPoptipTheme } from "@visactor/vrender-components";
 
+import { calculateChartSize } from "../chart/util";
+
 export class VChart {
     static useChart(charts) {
         charts.forEach((c => Factory.registerChart(c.type, c)));
@@ -125,9 +127,6 @@ export class VChart {
             onError: msg => {
                 throw new Error(msg);
             }
-        }, this._curSize = {
-            width: 0,
-            height: 0
         }, this._observer = null, this._context = {}, this._onResize = debounce(((...args) => {
             var _a, _b;
             const {width: containerWidth, height: containerHeight} = getContainerSize(this._container, DEFAULT_CHART_WIDTH, DEFAULT_CHART_HEIGHT), width = null !== (_a = this._spec.width) && void 0 !== _a ? _a : containerWidth, height = null !== (_b = this._spec.height) && void 0 !== _b ? _b : containerHeight;
@@ -136,12 +135,17 @@ export class VChart {
                 width: width,
                 height: height
             });
-        }), 100), this._option = merge(this._option, options), this._onError = this._option.onError;
+        }), 100), this._option = mergeOrigin(this._option, options), this._onError = this._option.onError;
         const _e = this._option, {dom: dom, renderCanvas: renderCanvas, mode: mode, stage: stage, poptip: poptip} = _e, restOptions = __rest(_e, [ "dom", "renderCanvas", "mode", "stage", "poptip" ]);
         dom && (this._container = isString(dom) ? null === document || void 0 === document ? void 0 : document.getElementById(dom) : dom), 
         renderCanvas && (this._canvas = renderCanvas), stage && (this._stage = stage), "node" === mode || this._container || this._canvas || this._stage ? (this._viewBox = this._option.viewBox, 
         this._currentThemeName = ThemeManager.getCurrentThemeName(), this._setSpec(spec), 
-        this._updateCurrentTheme(), this._compiler = new Compiler({
+        this._updateCurrentTheme(), this._curSize = calculateChartSize(this._spec, {
+            container: this._container,
+            canvas: this._canvas,
+            mode: this._option.mode || RenderModeEnum["desktop-browser"],
+            modeParams: this._option.modeParams
+        }), this._compiler = new Compiler({
             dom: null !== (_a = this._container) && void 0 !== _a ? _a : "none",
             canvas: renderCanvas
         }, Object.assign(Object.assign({
@@ -151,16 +155,14 @@ export class VChart {
         }, restOptions), {
             background: this._getBackground(),
             onError: this._onError
-        })), this._eventDispatcher = new EventDispatcher(this, this._compiler), this._event = new Event(this._eventDispatcher, mode), 
-        this._compiler.initView(), null === (_b = this.getStage()) || void 0 === _b || _b.setTheme({
+        })), this._compiler.setSize(this._curSize.width, this._curSize.height), this._eventDispatcher = new EventDispatcher(this, this._compiler), 
+        this._event = new Event(this._eventDispatcher, mode), this._compiler.initView(), 
+        null === (_b = this.getStage()) || void 0 === _b || _b.setTheme({
             text: {
                 fontFamily: this._currentTheme.fontFamily
             }
         }), this._initDataSet(this._option.dataSet), this._autoSize = !!isTrueBrowser(mode) && (null === (_d = null !== (_c = spec.autoFit) && void 0 !== _c ? _c : this._option.autoFit) || void 0 === _d || _d), 
-        this._curSize = {
-            width: spec.width || 0,
-            height: spec.height || 0
-        }, this._bindResizeEvent(), this._bindVGrammarViewEvent(), this._event.emit(ChartEvent.initialized, {}), 
+        this._bindResizeEvent(), this._bindVGrammarViewEvent(), this._event.emit(ChartEvent.initialized, {}), 
         InstanceManager.registerInstance(this)) : this._option.onError("please specify container or renderCanvas!");
     }
     _setSpec(spec) {
@@ -197,7 +199,8 @@ export class VChart {
             layout: this._option.layout,
             onError: this._onError
         });
-        chart ? (this._chart = chart, this._chart.created(), this._chart.init({})) : this._option.onError("init chart fail");
+        chart ? (this._chart = chart, this._chart.setCanvasRect(this._curSize.width, this._curSize.height), 
+        this._chart.created(), this._chart.init({})) : this._option.onError("init chart fail");
     }
     _releaseData() {
         this._dataSet && (this._dataSet.dataViewMap = {}, this._dataSet = null);
@@ -243,10 +246,12 @@ export class VChart {
         this) : this;
     }
     _reCompile(updateResult) {
-        var _a, _b;
+        var _a, _b, _c;
         updateResult.reMake ? (this._releaseData(), this._initDataSet(), this._chart.release(), 
-        this._chart = null, null === (_a = this._compiler) || void 0 === _a || _a.releaseGrammar()) : (this.getComponents().forEach((c => c.clear())), 
-        null === (_b = this._compiler) || void 0 === _b || _b.compile({
+        this._chart = null, null === (_a = this._compiler) || void 0 === _a || _a.releaseGrammar()) : updateResult.reCompile && (null === (_b = this._compiler) || void 0 === _b || _b.clear({
+            chart: this._chart,
+            vChart: this
+        }), null === (_c = this._compiler) || void 0 === _c || _c.compile({
             chart: this._chart,
             vChart: this
         }, {}));
@@ -349,9 +354,37 @@ export class VChart {
         }
         return this;
     }
+    updateFullDataSync(data, reRender = !0) {
+        if (this._chart) return this._chart.updateFullData(data), reRender && this._compiler.renderSync(), 
+        this;
+        return array(data).forEach((d => {
+            const {id: id, values: values, parser: parser, fields: fields} = d, preDV = this._spec.data.find((dv => dv.name === id));
+            if (preDV) preDV.setFields(fields), preDV.parse(values, parser); else {
+                const dataView = dataToDataView(d, this._dataSet, this._spec.data, {
+                    onError: this._option.onError
+                });
+                this._spec.data.push(dataView);
+            }
+        })), this;
+    }
+    updateFullData(data, reRender = !0) {
+        return __awaiter(this, void 0, void 0, (function*() {
+            if (this._chart) return this._chart.updateFullData(data), reRender && (yield this._compiler.renderAsync()), 
+            this;
+            return array(data).forEach((d => {
+                const {id: id, values: values, parser: parser, fields: fields} = d, preDV = this._spec.data.find((dv => dv.name === id));
+                if (preDV) preDV.setFields(fields), preDV.parse(values, parser); else {
+                    const dataView = dataToDataView(d, this._dataSet, this._spec.data, {
+                        onError: this._option.onError
+                    });
+                    this._spec.data.push(dataView);
+                }
+            })), this;
+        }));
+    }
     updateSpec(spec, forceMerge = !1, morphConfig) {
         return __awaiter(this, void 0, void 0, (function*() {
-            return spec ? (isString(spec) && (spec = JSON.parse(spec)), forceMerge && (spec = merge({}, this._spec, spec)), 
+            return spec ? (isString(spec) && (spec = JSON.parse(spec)), forceMerge && (spec = mergeSpec({}, this._spec, spec)), 
             yield this.updateCustomConfigAndRerender((() => {
                 var _a, _b;
                 return spec = specTransform(spec), this._spec = spec, this._updateCurrentTheme(), 
@@ -361,11 +394,11 @@ export class VChart {
         }));
     }
     updateSpecSync(spec, forceMerge = !1, morphConfig) {
-        return spec ? (isString(spec) && (spec = JSON.parse(spec)), forceMerge && (spec = merge({}, this._spec, spec)), 
+        return spec ? (isString(spec) && (spec = JSON.parse(spec)), forceMerge && (spec = mergeSpec({}, this._spec, spec)), 
         this.updateCustomConfigAndRerenderSync((() => {
-            var _a, _b;
-            return spec = specTransform(spec), this._spec = spec, this._updateCurrentTheme(), 
-            null === (_b = null === (_a = this._compiler) || void 0 === _a ? void 0 : _a.getVGrammarView()) || void 0 === _b || _b.updateLayoutTag(), 
+            var _a, _b, _c;
+            return (spec = specTransform(spec)).data = null !== (_a = spec.data) && void 0 !== _a ? _a : [], 
+            this._spec = spec, this._updateCurrentTheme(), null === (_c = null === (_b = this._compiler) || void 0 === _b ? void 0 : _b.getVGrammarView()) || void 0 === _c || _c.updateLayoutTag(), 
             this._chart.updateSpec(spec, morphConfig);
         }), morphConfig), this) : this;
     }
@@ -404,11 +437,17 @@ export class VChart {
         this._chart && this._chart.setHovered(datum, filter, region);
     }
     _updateCurrentTheme() {
-        var _a, _b, _c, _d, _e;
-        isString(null === (_a = this._spec) || void 0 === _a ? void 0 : _a.theme) ? (this._currentTheme = merge({}, ThemeManager.getTheme(this._spec.theme)), 
-        this._currentThemeName = this._spec.theme) : this._currentTheme = merge({}, ThemeManager.getTheme(this._currentThemeName), null !== (_c = null === (_b = this._spec) || void 0 === _b ? void 0 : _b.theme) && void 0 !== _c ? _c : {}), 
-        setPoptipTheme(merge({}, null === (_d = this._currentTheme.component) || void 0 === _d ? void 0 : _d.poptip)), 
-        null === (_e = this._compiler) || void 0 === _e || _e.setBackground(this._getBackground());
+        var _a, _b, _c, _d;
+        const userTheme = null !== (_b = null === (_a = this._spec) || void 0 === _a ? void 0 : _a.theme) && void 0 !== _b ? _b : this._option.theme;
+        if (isString(userTheme)) {
+            const theme = mergeTheme({}, ThemeManager.getTheme(userTheme));
+            this._currentTheme = preprocessSpecOrTheme(theme, theme.colorScheme), this._currentThemeName = userTheme;
+        } else {
+            const theme = mergeTheme({}, ThemeManager.getTheme(this._currentThemeName), null != userTheme ? userTheme : {});
+            this._currentTheme = preprocessSpecOrTheme(theme, theme.colorScheme);
+        }
+        setPoptipTheme(preprocessSpecOrTheme(mergeSpec({}, null === (_c = this._currentTheme.component) || void 0 === _c ? void 0 : _c.poptip))), 
+        null === (_d = this._compiler) || void 0 === _d || _d.setBackground(this._getBackground());
     }
     _getBackground() {
         return ("string" == typeof this._spec.background ? this._spec.background : null) || this._currentTheme.background || this._option.background;
@@ -564,6 +603,18 @@ export class VChart {
         var _a;
         return null === (_a = this._chart) || void 0 === _a ? void 0 : _a.setDimensionIndex(value, opt);
     }
+    stopAnimation() {
+        var _a, _b, _c;
+        null === (_c = null === (_b = null === (_a = this._compiler) || void 0 === _a ? void 0 : _a.getVGrammarView()) || void 0 === _b ? void 0 : _b.animate) || void 0 === _c || _c.stop();
+    }
+    pauseAnimation() {
+        var _a, _b, _c;
+        null === (_c = null === (_b = null === (_a = this._compiler) || void 0 === _a ? void 0 : _a.getVGrammarView()) || void 0 === _b ? void 0 : _b.animate) || void 0 === _c || _c.pause();
+    }
+    resumeAnimation() {
+        var _a, _b, _c;
+        null === (_c = null === (_b = null === (_a = this._compiler) || void 0 === _a ? void 0 : _a.getVGrammarView()) || void 0 === _b ? void 0 : _b.animate) || void 0 === _c || _c.resume();
+    }
     convertDatumToPosition(datum, dataLinkInfo = {}, isRelativeToCanvas = !1) {
         var _a;
         if (!this._chart) return null;
@@ -590,7 +641,7 @@ export class VChart {
             null;
             const pointValue = null == axis ? void 0 : axis.valueToPosition(value);
             if (isRelativeToCanvas) {
-                const axisLayoutStartPoint = axis.getLayoutStartPoint(), axisOrient = axis.orient;
+                const axisLayoutStartPoint = axis.getLayoutStartPoint(), axisOrient = axis.getOrient();
                 return pointValue + ("bottom" === axisOrient || "top" === axisOrient ? axisLayoutStartPoint.x : axisLayoutStartPoint.y);
             }
             return pointValue;