@visactor/vchart 1.5.2 → 1.5.3

package/cjs/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-core';\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: Datum[] | string, options?: IParserOptions) => Promise<IVChart>;\n\n  /**\n   * **异步**批量更新数据。\n   * @param list 待更新的数据列表\n   * @returns VChart 实例\n   */\n  updateDataInBatches: (list: { id: string; data: 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: 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   * **同步方法** 模块 spec 更新\n   * @param filter\n   * @param spec\n   * @param forceMerge\n   * @returns\n   * @sync 1.4.0\n   */\n  updateModelSpecSync: (\n    filter: string | { type: string; index: number },\n    spec: unknown,\n    forceMerge?: boolean,\n    morphConfig?: IMorphConfig\n  ) => IVChart;\n\n  /**\n   * **异步方法** 模块 spec 更新\n   * @param filter\n   * @param spec\n   * @param forceMerge\n   * @returns\n   * @sync 1.4.0\n   */\n  updateModelSpec: (\n    filter: string | { type: string; index: number },\n    spec: unknown,\n    forceMerge?: boolean,\n    morphConfig?: IMorphConfig\n  ) => 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   * 导出绘制了图表内容的 canvas\n   * @returns HTMLCanvasElement\n   * @since 1.5.2\n   */\n  exportCanvas: () => HTMLCanvasElement | undefined;\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"]}
+{"version":3,"sources":["../src/core/interface.ts"],"names":[],"mappings":"","file":"interface.js","sourcesContent":["import type { DataSet } 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 { IGradientColor, Stage } from '@visactor/vrender-core';\nimport type { IThemeColorScheme } from '../theme/color-scheme/interface';\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: Datum[] | string, options?: IParserOptions) => Promise<IVChart>;\n\n  /**\n   * **异步**批量更新数据。\n   * @param list 待更新的数据列表\n   * @returns VChart 实例\n   */\n  updateDataInBatches: (list: { id: string; data: 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: 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   * **同步方法** 模块 spec 更新\n   * @param filter\n   * @param spec\n   * @param forceMerge\n   * @returns\n   * @sync 1.4.0\n   */\n  updateModelSpecSync: (\n    filter: string | { type: string; index: number },\n    spec: unknown,\n    forceMerge?: boolean,\n    morphConfig?: IMorphConfig\n  ) => IVChart;\n\n  /**\n   * **异步方法** 模块 spec 更新\n   * @param filter\n   * @param spec\n   * @param forceMerge\n   * @returns\n   * @sync 1.4.0\n   */\n  updateModelSpec: (\n    filter: string | { type: string; index: number },\n    spec: unknown,\n    forceMerge?: boolean,\n    morphConfig?: IMorphConfig\n  ) => 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   * 获取当前主题，会返回完整的主题配置（只能获取用户通过`setCurrentTheme`方法设置过的主题，默认值为`ThemeManager`统一设置的主题）\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   * 导出绘制了图表内容的 canvas\n   * @returns HTMLCanvasElement\n   * @since 1.5.2\n   */\n  exportCanvas: () => HTMLCanvasElement | undefined;\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\n/** 图表层级的主题 */\nexport interface IChartLevelTheme {\n  /** 图表背景色 */\n  background?: string | IGradientColor;\n  /** 图表字体配置 */\n  fontFamily?: string;\n  /** 全局色板 */\n  colorScheme?: IThemeColorScheme;\n}\n"]}

package/cjs/core/vchart.d.ts

@@ -59,7 +59,7 @@ export declare class VChart implements IVChart {
     private _curSize;
     private _observer;
     private _currentThemeName;
-    private _currentTheme;
+    private _currentChartLevelTheme;
     private _onError?;
     private _context;
     constructor(spec: ISpec, options: IInitOption);
@@ -70,6 +70,7 @@ export declare class VChart implements IVChart {
     private _bindResizeEvent;
     private _unBindResizeEvent;
     private _getCurSize;
+    private _doResize;
     private _onResize;
     private _initDataSet;
     updateCustomConfigAndRerender(modifyConfig: () => IUpdateSpecResult | undefined, morphConfig?: IMorphConfig): Promise<IVChart>;
@@ -107,7 +108,7 @@ export declare class VChart implements IVChart {
     setSelected(datum: MaybeArray<any> | null, filter?: (series: ISeries, mark: IMark) => boolean, region?: IRegionQuerier): void;
     setHovered(datum: MaybeArray<Datum> | null, filter?: (series: ISeries, mark: IMark) => boolean, region?: IRegionQuerier): void;
     private _updateCurrentTheme;
-    private _updateChartConfiguration;
+    private _shouldChartResize;
     private _getBackground;
     getCurrentTheme(): ITheme;
     getCurrentThemeName(): string;

package/cjs/core/vchart.js

@@ -38,7 +38,7 @@ Object.defineProperty(exports, "__esModule", {
     value: !0
 }), exports.registerVChartCore = exports.VChart = void 0;
 
-const array_1 = require("../data/parser/array"), common_1 = require("../typings/spec/common"), interface_1 = require("../component/interface"), vdataset_1 = require("@visactor/vdataset"), util_1 = require("../util"), factory_1 = require("./factory"), event_1 = require("../event/event"), event_dispatcher_1 = require("../event/event-dispatcher"), geo_source_1 = require("../series/map/geo-source"), register_1 = require("../data/register"), initialize_1 = require("../data/initialize"), stack_split_1 = require("../data/transforms/stack-split"), copy_data_view_1 = require("../data/transforms/copy-data-view"), interface_2 = require("../animation/interface"), theme_manager_1 = require("../theme/theme-manager"), compiler_1 = require("../compile/compiler"), image_1 = require("../util/image"), constant_1 = require("../constant"), vutils_1 = require("@visactor/vutils"), instance_manager_1 = require("./instance-manager"), vrender_components_1 = require("@visactor/vrender-components"), util_2 = require("../chart/util"), region_1 = require("../region/region"), layout_1 = require("../layout"), mark_1 = require("../mark"), config_1 = require("../animation/config"), vgrammar_core_1 = require("@visactor/vgrammar-core"), util_3 = require("./util");
+const array_1 = require("../data/parser/array"), common_1 = require("../typings/spec/common"), interface_1 = require("../component/interface"), vdataset_1 = require("@visactor/vdataset"), util_1 = require("../util"), factory_1 = require("./factory"), event_1 = require("../event/event"), event_dispatcher_1 = require("../event/event-dispatcher"), geo_source_1 = require("../series/map/geo-source"), register_1 = require("../data/register"), initialize_1 = require("../data/initialize"), stack_split_1 = require("../data/transforms/stack-split"), copy_data_view_1 = require("../data/transforms/copy-data-view"), interface_2 = require("../animation/interface"), theme_manager_1 = require("../theme/theme-manager"), compiler_1 = require("../compile/compiler"), image_1 = require("../util/image"), constant_1 = require("../constant"), vutils_1 = require("@visactor/vutils"), instance_manager_1 = require("./instance-manager"), vrender_components_1 = require("@visactor/vrender-components"), util_2 = require("../chart/util"), region_1 = require("../region/region"), layout_1 = require("../layout"), mark_1 = require("../mark"), config_1 = require("../animation/config"), vgrammar_core_1 = require("@visactor/vgrammar-core"), util_3 = require("./util"), util_4 = require("../theme/util");
 
 class VChart {
     static useRegisters(comps) {
@@ -98,12 +98,9 @@ class VChart {
             onError: msg => {
                 throw new Error(msg);
             }
-        }, this._observer = null, this._context = {}, this._onResize = (0, util_1.debounce)(((...args) => {
-            const {width: width, height: height} = this._getCurSize();
-            this._curSize.width === width && this._curSize.height === height || (this._curSize = {
-                width: width,
-                height: height
-            }, this.resize(width, height));
+        }, this._observer = null, this._currentChartLevelTheme = {}, this._context = {}, 
+        this._onResize = (0, util_1.debounce)(((...args) => {
+            this._doResize();
         }), 100), this._option = (0, vutils_1.merge)(this._option, options), this._onError = null === (_a = this._option) || void 0 === _a ? void 0 : _a.onError;
         const _g = this._option, {dom: dom, renderCanvas: renderCanvas, mode: mode, stage: stage, poptip: poptip} = _g, restOptions = __rest(_g, [ "dom", "renderCanvas", "mode", "stage", "poptip" ]);
         dom && (this._container = (0, util_1.isString)(dom) ? null === document || void 0 === document ? void 0 : document.getElementById(dom) : dom), 
@@ -128,7 +125,7 @@ class VChart {
         this._event = new event_1.Event(this._eventDispatcher, mode), this._compiler.initView(), 
         null === (_d = this.getStage()) || void 0 === _d || _d.setTheme({
             text: {
-                fontFamily: this._currentTheme.fontFamily
+                fontFamily: this._currentChartLevelTheme.fontFamily
             }
         }), this._initDataSet(this._option.dataSet), this._autoSize = !!(0, util_1.isTrueBrowser)(mode) && (null === (_f = null !== (_e = spec.autoFit) && void 0 !== _e ? _e : this._option.autoFit) || void 0 === _f || _f), 
         this._bindResizeEvent(), this._bindVGrammarViewEvent(), this._event.emit(constant_1.ChartEvent.initialized, {}), 
@@ -153,7 +150,15 @@ class VChart {
             performanceHook: this._option.performanceHook,
             viewBox: this._viewBox,
             animation: this._option.animation,
-            getTheme: () => this._currentTheme,
+            getThemeConfig: () => {
+                var _a;
+                return {
+                    globalTheme: this._currentThemeName,
+                    optionTheme: this._option.theme,
+                    specTheme: null === (_a = this._spec) || void 0 === _a ? void 0 : _a.theme,
+                    chartLevelTheme: this._currentChartLevelTheme
+                };
+            },
             layout: this._option.layout,
             onError: this._onError
         });
@@ -192,6 +197,13 @@ class VChart {
             height: null !== (_b = this._spec.height) && void 0 !== _b ? _b : containerHeight
         };
     }
+    _doResize() {
+        const {width: width, height: height} = this._getCurSize();
+        this._curSize.width === width && this._curSize.height === height || (this._curSize = {
+            width: width,
+            height: height
+        }, this.resize(width, height));
+    }
     _initDataSet(dataSet) {
         dataSet instanceof vdataset_1.DataSet ? this._dataSet = dataSet : this._dataSet = new vdataset_1.DataSet, 
         (0, register_1.registerDataSetInstanceParser)(this._dataSet, "dataview", vdataset_1.dataViewParser), 
@@ -220,7 +232,7 @@ class VChart {
         this._userEvents.forEach((e => {
             var _a;
             return null === (_a = this._event) || void 0 === _a ? void 0 : _a.on(e.eType, e.query, e.handler);
-        })), updateResult.reSize && this._onResize(); else if (updateResult.reCompile && (null === (_b = this._compiler) || void 0 === _b || _b.clear({
+        })), updateResult.reSize && this._doResize(); else if (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({
@@ -370,8 +382,8 @@ class VChart {
                 spec = (0, util_1.specTransform)(spec);
                 const lastSpec = this._spec;
                 this._spec = spec, (0, vutils_1.isEqual)(lastSpec.theme, spec.theme) || (this._updateCurrentTheme(), 
-                null === (_a = this._chart) || void 0 === _a || _a.setCurrentTheme(this._currentTheme, !1));
-                const reSize = this._updateChartConfiguration(lastSpec);
+                null === (_a = this._chart) || void 0 === _a || _a.setCurrentTheme());
+                const reSize = this._shouldChartResize(lastSpec);
                 return null === (_c = null === (_b = this._compiler) || void 0 === _b ? void 0 : _b.getVGrammarView()) || void 0 === _c || _c.updateLayoutTag(), 
                 (0, util_2.mergeUpdateResult)(this._chart.updateSpec(spec, morphConfig), {
                     change: reSize,
@@ -385,12 +397,13 @@ class VChart {
     updateSpecSync(spec, forceMerge = !1, morphConfig) {
         return spec ? ((0, util_1.isString)(spec) && (spec = JSON.parse(spec)), forceMerge && (spec = (0, 
         util_1.mergeSpec)({}, this._spec, spec)), this.updateCustomConfigAndRerenderSync((() => {
-            var _a, _b, _c;
+            var _a, _b, _c, _d;
             (spec = (0, util_1.specTransform)(spec)).data = null !== (_a = spec.data) && void 0 !== _a ? _a : [];
             const lastSpec = this._spec;
-            this._spec = spec;
-            const reSize = this._updateChartConfiguration(lastSpec);
-            return null === (_c = null === (_b = this._compiler) || void 0 === _b ? void 0 : _b.getVGrammarView()) || void 0 === _c || _c.updateLayoutTag(), 
+            this._spec = spec, (0, vutils_1.isEqual)(lastSpec.theme, spec.theme) || (this._updateCurrentTheme(), 
+            null === (_b = this._chart) || void 0 === _b || _b.setCurrentTheme());
+            const reSize = this._shouldChartResize(lastSpec);
+            return null === (_d = null === (_c = this._compiler) || void 0 === _c ? void 0 : _c.getVGrammarView()) || void 0 === _d || _d.updateLayoutTag(), 
             (0, util_2.mergeUpdateResult)(this._chart.updateSpec(spec, morphConfig), {
                 change: reSize,
                 reMake: !1,
@@ -449,15 +462,15 @@ class VChart {
     }
     on(eType, query, handler) {
         var _a;
-        this._userEvents.push({
+        this._userEvents && (this._userEvents.push({
             eType: eType,
             query: "function" == typeof query ? null : query,
             handler: "function" == typeof query ? query : handler
-        }), null === (_a = this._event) || void 0 === _a || _a.on(eType, query, handler);
+        }), null === (_a = this._event) || void 0 === _a || _a.on(eType, query, handler));
     }
     off(eType, handler) {
         var _a;
-        if (handler) {
+        if (this._userEvents && 0 !== this._userEvents.length) if (handler) {
             const index = this._userEvents.findIndex((e => e.eType === eType && e.handler === handler));
             index >= 0 && (this._userEvents.splice(index, 1), null === (_a = this._event) || void 0 === _a || _a.off(eType, handler));
         } else this._userEvents.forEach((e => {
@@ -475,40 +488,32 @@ class VChart {
         this._chart && this._chart.setHovered(datum, filter, region);
     }
     _updateCurrentTheme(nextThemeName) {
-        var _a, _b, _c;
-        let finalTheme, optionTheme = this._option.theme, specTheme = null === (_a = this._spec) || void 0 === _a ? void 0 : _a.theme;
-        if (theme_manager_1.ThemeManager.themeExist(nextThemeName)) {
-            const newTheme = theme_manager_1.ThemeManager.getTheme(nextThemeName);
-            optionTheme = !optionTheme || (0, util_1.isString)(optionTheme) ? {} : optionTheme, 
-            specTheme = !specTheme || (0, util_1.isString)(specTheme) ? {} : specTheme, finalTheme = (0, 
-            util_1.mergeTheme)({}, newTheme, optionTheme, specTheme), this._currentThemeName = nextThemeName;
-        } else if ((0, util_1.isString)(specTheme) && theme_manager_1.ThemeManager.themeExist(specTheme)) finalTheme = (0, 
-        util_1.mergeTheme)({}, theme_manager_1.ThemeManager.getTheme(specTheme)), this._currentThemeName = specTheme; else if ((0, 
-        util_1.isString)(optionTheme) && theme_manager_1.ThemeManager.themeExist(optionTheme)) finalTheme = (0, 
-        util_1.mergeTheme)({}, theme_manager_1.ThemeManager.getTheme(optionTheme), (0, util_1.getThemeObject)(specTheme)), 
-        this._currentThemeName = optionTheme; else {
-            const baseTheme = (0, util_1.getThemeObject)(this._currentThemeName);
-            finalTheme = (0, util_1.mergeTheme)({}, baseTheme, (0, util_1.getThemeObject)(optionTheme), (0, 
-            util_1.getThemeObject)(specTheme));
-        }
-        this._currentTheme = (0, util_1.preprocessSpecOrTheme)("theme", finalTheme, finalTheme.colorScheme), 
-        (0, vrender_components_1.setPoptipTheme)((0, util_1.preprocessSpecOrTheme)("mark-theme", (0, 
-        util_1.mergeSpec)({}, null === (_b = this._currentTheme.component) || void 0 === _b ? void 0 : _b.poptip))), 
-        null === (_c = this._compiler) || void 0 === _c || _c.setBackground(this._getBackground());
-    }
-    _updateChartConfiguration(oldSpec) {
+        var _a, _b;
+        const optionTheme = this._option.theme, specTheme = null === (_a = this._spec) || void 0 === _a ? void 0 : _a.theme;
+        nextThemeName && (this._currentThemeName = nextThemeName);
+        const colorScheme = (0, util_4.mergeThemeAndGet)("colorScheme", this._currentThemeName, optionTheme, specTheme);
+        this._currentChartLevelTheme = {
+            colorScheme: colorScheme,
+            background: (0, util_4.mergeThemeAndGet)("background", this._currentThemeName, optionTheme, specTheme, colorScheme),
+            fontFamily: (0, util_4.mergeThemeAndGet)("fontFamily", this._currentThemeName, optionTheme, specTheme, colorScheme)
+        }, (0, vrender_components_1.setPoptipTheme)((0, util_1.preprocessSpecOrTheme)("mark-theme", (0, 
+        util_4.mergeThemeAndGet)("component.poptip", this._currentThemeName, optionTheme, specTheme, colorScheme), colorScheme)), 
+        null === (_b = this._compiler) || void 0 === _b || _b.setBackground(this._getBackground());
+    }
+    _shouldChartResize(oldSpec) {
         var _a, _b;
         let resize = !1;
-        this._spec.width === oldSpec.width && this._spec.height === oldSpec.height || (resize = !0);
+        (0, util_1.isNil)(this._spec.width) ? this._spec.width = oldSpec.width : this._spec.width !== oldSpec.width && (resize = !0), 
+        (0, util_1.isNil)(this._spec.height) ? this._spec.height = oldSpec.height : this._spec.height !== oldSpec.height && (resize = !0);
         const lasAutoSize = this._autoSize;
         return this._autoSize = !!(0, util_1.isTrueBrowser)(this._option.mode) && (null === (_b = null !== (_a = this._spec.autoFit) && void 0 !== _a ? _a : this._option.autoFit) || void 0 === _b || _b), 
-        this._autoSize !== lasAutoSize && (resize = !0), this._updateCurrentTheme(), resize;
+        this._autoSize !== lasAutoSize && (resize = !0), resize;
     }
     _getBackground() {
-        return ("string" == typeof this._spec.background ? this._spec.background : null) || this._currentTheme.background || this._option.background;
+        return ("string" == typeof this._spec.background ? this._spec.background : null) || this._currentChartLevelTheme.background || this._option.background;
     }
     getCurrentTheme() {
-        return this._currentTheme;
+        return (0, util_1.getThemeObject)(this._currentThemeName);
     }
     getCurrentThemeName() {
         return this._currentThemeName;
@@ -517,7 +522,7 @@ class VChart {
         return __awaiter(this, void 0, void 0, (function*() {
             return theme_manager_1.ThemeManager.themeExist(name) ? (yield this.updateCustomConfigAndRerender((() => {
                 var _a;
-                return this._updateCurrentTheme(name), null === (_a = this._chart) || void 0 === _a || _a.setCurrentTheme(this._currentTheme, !0), 
+                return this._updateCurrentTheme(name), null === (_a = this._chart) || void 0 === _a || _a.setCurrentTheme(!0), 
                 {
                     change: !0,
                     reMake: !1
@@ -528,7 +533,7 @@ class VChart {
     setCurrentThemeSync(name) {
         return theme_manager_1.ThemeManager.themeExist(name) ? (this.updateCustomConfigAndRerenderSync((() => {
             var _a;
-            return this._updateCurrentTheme(name), null === (_a = this._chart) || void 0 === _a || _a.setCurrentTheme(this._currentTheme, !0), 
+            return this._updateCurrentTheme(name), null === (_a = this._chart) || void 0 === _a || _a.setCurrentTheme(!0), 
             {
                 change: !0,
                 reMake: !1