@univerjs-pro/engine-chart 1.0.0-alpha.1 → 1.0.0-alpha.3

package/lib/types/models/chart-render-model-manager.service.d.ts

@@ -0,0 +1,26 @@
+import type { IDisposable, Injector } from '@univerjs/core';
+import type { ChartHostRenderMode, IChartInstance, IChartRenderInstance, IChartRenderInstanceCreateContext, IChartRenderModel, IChartRenderModelImageExportInput, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult } from '../types';
+import { Disposable } from '@univerjs/core';
+export interface IChartRenderModelManagerService extends IDisposable {
+    registerRenderModel(name: string, renderModel: IChartRenderModel): void;
+    setRenderModel(name: string): void;
+    getRenderModel(name?: string): IChartRenderModel | undefined;
+    getCurrentRenderModel(): IChartRenderModel;
+    createChartInstance(): IChartInstance;
+    createChartInstance(mode: ChartHostRenderMode, context?: IChartRenderInstanceCreateContext): IChartRenderInstance;
+    exportImage(input: IChartRenderModelImageExportInput, options?: IChartRenderModelImageExportOptions): Promise<IChartRenderModelImageExportResult>;
+}
+export declare const IChartRenderModelManagerService: import("@wendellhu/redi").IdentifierDecorator<IChartRenderModelManagerService>;
+export declare class ChartRenderModelManagerService extends Disposable implements IChartRenderModelManagerService {
+    private readonly _renderModelMap;
+    private _currentRenderModel;
+    registerRenderModel(name: string, renderModel: IChartRenderModel): void;
+    setRenderModel(name: string): void;
+    getRenderModel(name?: string): IChartRenderModel | undefined;
+    getCurrentRenderModel(): IChartRenderModel;
+    createChartInstance(): IChartInstance;
+    createChartInstance(mode: ChartHostRenderMode, context?: IChartRenderInstanceCreateContext): IChartRenderInstance;
+    exportImage(input: IChartRenderModelImageExportInput, options?: IChartRenderModelImageExportOptions): Promise<IChartRenderModelImageExportResult>;
+    dispose(): void;
+}
+export declare function registerChartRenderModelManagerService(injector: Injector, defaultRenderModel?: IChartRenderModel): IChartRenderModelManagerService;

package/lib/types/models/chart-runtime-style.d.ts

@@ -10,3 +10,4 @@ import { ChartTypeBits } from '../enum';
  * the runtime render style consumed by physical-position operators.
  */
 export declare function resolveChartRuntimeStyle(style: ChartStyle, chartType?: ChartTypeBits): ChartStyle;
+export declare function resolveChartStyleBackgroundColor(style?: Pick<ChartStyle, 'backgroundColor'> | null): string;

package/lib/types/models/constants/build-in-theme/index.d.ts

@@ -1,15 +1,15 @@
 export { themeDefault } from './default';
 export { getThemeAxesByType, getThemeProps } from './theme-util';
 export type { IEchartTheme } from './types';
-export { univer1 as UniverTheme1 } from './univer1';
-export { univer2 as UniverTheme2 } from './univer2';
-export { univer3 as UniverTheme3 } from './univer3';
-export { univer4 as UniverTheme4 } from './univer4';
-export { univer5 as UniverTheme5 } from './univer5';
-export { univer6 as UniverTheme6 } from './univer6';
-export { univerGradient1 as UniverThemeGradient1 } from './univer-gradient1';
-export { univerGradient2 as UniverThemeGradient2 } from './univer-gradient2';
-export { univerGradient3 as UniverThemeGradient3 } from './univer-gradient3';
-export { univerGradient4 as UniverThemeGradient4 } from './univer-gradient4';
-export { univerGradient5 as UniverThemeGradient5 } from './univer-gradient5';
-export { univerGradient6 as UniverThemeGradient6 } from './univer-gradient6';
+export { UniverTheme1 } from './univer1';
+export { UniverTheme2 } from './univer2';
+export { UniverTheme3 } from './univer3';
+export { UniverTheme4 } from './univer4';
+export { UniverTheme5 } from './univer5';
+export { UniverTheme6 } from './univer6';
+export { UniverThemeGradient1 } from './univer-gradient1';
+export { UniverThemeGradient2 } from './univer-gradient2';
+export { UniverThemeGradient3 } from './univer-gradient3';
+export { UniverThemeGradient4 } from './univer-gradient4';
+export { UniverThemeGradient5 } from './univer-gradient5';
+export { UniverThemeGradient6 } from './univer-gradient6';

package/lib/types/models/constants/build-in-theme/univer-gradient1.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univerGradient1: IEchartTheme;
+export declare const UniverThemeGradient1: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer-gradient2.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univerGradient2: IEchartTheme;
+export declare const UniverThemeGradient2: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer-gradient3.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univerGradient3: IEchartTheme;
+export declare const UniverThemeGradient3: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer-gradient4.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univerGradient4: IEchartTheme;
+export declare const UniverThemeGradient4: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer-gradient5.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univerGradient5: IEchartTheme;
+export declare const UniverThemeGradient5: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer-gradient6.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univerGradient6: IEchartTheme;
+export declare const UniverThemeGradient6: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer1.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univer1: IEchartTheme;
+export declare const UniverTheme1: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer2.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univer2: IEchartTheme;
+export declare const UniverTheme2: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer3.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univer3: IEchartTheme;
+export declare const UniverTheme3: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer4.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univer4: IEchartTheme;
+export declare const UniverTheme4: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer5.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univer5: IEchartTheme;
+export declare const UniverTheme5: IEchartTheme;

package/lib/types/models/constants/build-in-theme/univer6.d.ts

@@ -1,2 +1,2 @@
 import type { IEchartTheme } from './types';
-export declare const univer6: IEchartTheme;
+export declare const UniverTheme6: IEchartTheme;

package/lib/types/models/constants/default.d.ts

@@ -1,10 +1,12 @@
+import type { ChartStyle } from '../../types';
 export declare const EChartRenderEngineName = "EChartRenderEngine";
 export declare const defaultChartWidth = 468;
 export declare const defaultChartHeight = 369;
 export declare const LegendPadding = 15;
 export declare const TitleOrLegendPadding = 12;
 export declare const TitleDefaultStartPosition = 8;
-export declare const defaultChartPadding = 14;
+export declare const DEFAULT_CHART_LAYOUT_PADDING = 14;
+export declare function getChartLayoutPadding(style?: ChartStyle): number;
 export declare const TitleLineHeightBase = 1.2;
 export declare const AxisLabelMaxPercent = 0.15;
 export declare const defaultBubbleSize = 0.12;

package/lib/types/models/echart-render-model.d.ts

@@ -1,6 +1,7 @@
-import type { ChartStyle, EChartInstance, EChartSpec, IChartConfig, IChartHostRect, IChartInstance, IChartRenderModel, IChartRenderModelStylizeInit } from '../types';
+import type { ChartElementEventHandler, ChartElementEventType, ChartImageSource, ChartStyle, EChartInstance, EChartSpec, IChartConfig, IChartHostRect, IChartInstance, IChartRenderAsImageOptions, IChartRenderInstance, IChartRenderInstanceCreateContext, IChartRenderModel, IChartRenderModelImageExportInput, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult, IChartRenderModelStylizeInit, IChartRenderRuntimeOptions } from '../types';
 import type { IWordCloudRenderConfig } from '../wordcloud-chart/word-cloud-render-config';
 import { Disposable } from '@univerjs/core';
+import { ChartHostRenderMode } from '../types';
 export interface IEChartRenderModelOptions {
     wordCloudRenderConfig?: IWordCloudRenderConfig;
 }
@@ -14,24 +15,62 @@ export declare class EChartRenderModel extends Disposable implements IChartRende
     private _addSpecConverters;
     private _addSpecOperators;
     createChartInstance(): IChartInstance<EChartSpec>;
+    createChartInstance(mode: ChartHostRenderMode, context?: IChartRenderInstanceCreateContext<EChartSpec>): IChartRenderInstance;
+    clearRuntimeCache(chartId: string): void;
+    clearAllRuntimeCache(): void;
+    dispose(): void;
     toSpec(config: IChartConfig, style: ChartStyle): import("echarts").EChartsOption;
     stylizeSpec(spec: EChartSpec, stylizeInit: IChartRenderModelStylizeInit<EChartSpec>, rect: IChartHostRect): import("echarts").EChartsOption | {
         backgroundColor: string;
     };
+    exportImage(input: IChartRenderModelImageExportInput, options?: IChartRenderModelImageExportOptions): Promise<IChartRenderModelImageExportResult>;
 }
 export declare class EChartRenderEngine extends Disposable implements EChartInstance {
     static engineName: string;
     private _instance;
     container: HTMLElement | string;
     private _devicePixelRatio;
+    private _lastSpec;
+    private readonly _eventHandlers;
+    private readonly _nativeEventHandlers;
+    private readonly _nativeZrBlankEventHandlers;
+    private readonly _elementEditModeHandlers;
+    private _elementEditModeZrMouseMoveHandler;
+    private _elementEditModeZrClickHandler;
+    private _elementEditModeEnabled;
+    private _editOverlay;
+    private readonly _emittedElementEventKeys;
+    private _emittedElementEventKeysClearQueued;
     constructor();
     getDevicePixelRatio(): 1 | 2 | undefined;
     mount(id: string | HTMLElement): void;
-    resize(echartsProvider?: any): void;
+    resize(echartsProviderOrOptions?: any | IChartRenderRuntimeOptions): void;
     private _ensureChartInstance;
     get containerElement(): HTMLElement | null;
-    render(spec: EChartSpec, echartsProvider?: any): void;
+    render(spec: EChartSpec, echartsProviderOrOptions?: any | IChartRenderRuntimeOptions): void;
+    renderAsImage(spec: EChartSpec, options: IChartRenderAsImageOptions): Promise<ChartImageSource>;
+    on(type: ChartElementEventType, handler: ChartElementEventHandler): {
+        dispose: () => void;
+    };
+    setElementEditMode(enabled: boolean): void;
+    private _bindAllNativeEvents;
+    private _bindNativeEvent;
+    private _unbindNativeEvent;
+    private _bindNativeZrBlankEvent;
+    private _unbindNativeZrBlankEvent;
+    private _bindElementEditModeEvents;
+    private _unbindElementEditModeEvents;
+    private _emitChartElementEvent;
+    private _shouldSkipDuplicateElementEvent;
+    private _handleElementEditHover;
+    private _handleElementEditZrHover;
+    private _handleElementEditClick;
+    private _handleElementEditZrClick;
+    private _hideTooltip;
+    private _ensureEditOverlay;
+    private _removeEditOverlay;
+    private _clearHoverBorder;
+    private _clearFixedBorder;
     exportImg(echartsProvider?: any): Promise<string>;
-    onDispose(): void;
     dispose(): void;
 }

package/lib/types/models/image-chart-host.d.ts

@@ -0,0 +1,18 @@
+import type { ChartImageSource, IChartHostLease, IChartHostRect, IChartHostStyle, IImageChartHost } from '../types';
+import { Disposable } from '@univerjs/core';
+import { ChartHostRenderMode } from '../types';
+export declare function chartImageSourceToDataUrl(image: ChartImageSource): string;
+export declare abstract class ImageChartHost extends Disposable implements IImageChartHost {
+    readonly chartId: string;
+    readonly mode = ChartHostRenderMode.Image;
+    private readonly _offscreenChartHost;
+    constructor(chartId: string);
+    abstract getRect(): IChartHostRect | null;
+    abstract setStyle(style: IChartHostStyle): void;
+    abstract nextVersion(): number;
+    abstract commitSnapshot(image: ChartImageSource, version: number): boolean;
+    abstract requestPaint(): void;
+    abstract invalidateSnapshot(): void;
+    acquireOffscreenHost(rect: IChartHostRect): IChartHostLease;
+    dispose(): void;
+}

package/lib/types/models/mode-converter/mode-converter.d.ts

@@ -2,7 +2,6 @@ import type { Injector } from '@univerjs/core';
 import type { ChartTypeBits } from '../../enum';
 import type { ChartStyle, IChartContext, IChartHostRect, IUniverDataSet } from '../../types';
 import type { IChartLocaleTexts } from '../chart-locale-texts';
-import { StaticChartSource } from '../../source/static-chart-source';
 import { ChartModel } from '../chart-model';
 /**
  * The parameters for initializing a chart model.
@@ -53,7 +52,6 @@ export interface IChartModelInitParams {
     isRowDirection?: boolean;
     localeTexts?: IChartLocaleTexts;
 }
-export declare function generateChartModelContext(chartModel: ChartModel, dataSource: StaticChartSource): IChartContext;
 /**
  * Convert the initial data to a chart model.
  * @param initJson The initial data of the chart model.

package/lib/types/models/mode-converter/render-spec-operators/legend-size.d.ts

@@ -1,2 +1,3 @@
+import type { ChartStyle } from '../../../types';
 export declare const MinLegendTextWidth = 48;
-export declare function getLegendTextWidthLimit(width?: number): number;
+export declare function getLegendTextWidthLimit(width?: number, style?: ChartStyle): number;

package/lib/types/models/offscreen-chart-host.d.ts

@@ -0,0 +1,7 @@
+import type { IChartHostLease, IChartHostRect } from '../types';
+import { Disposable } from '@univerjs/core';
+export declare class OffscreenChartHost extends Disposable {
+    private readonly _leases;
+    acquire(rect: IChartHostRect): IChartHostLease;
+    dispose(): void;
+}

package/lib/types/models/series-style/series-style-resolver.d.ts

@@ -0,0 +1,9 @@
+type SeriesStyleKeyInput = string | number | null | undefined;
+export interface ISeriesStyleSource {
+    seriesId?: SeriesStyleKeyInput;
+    seriesIndex?: SeriesStyleKeyInput;
+    baseSeriesIndex?: SeriesStyleKeyInput;
+}
+export declare function getSeriesStyleKey(source: ISeriesStyleSource): string | undefined;
+export declare function resolveSeriesStyle<T extends object>(seriesStyleMap: Partial<Record<string, T | undefined>> | undefined, source: ISeriesStyleSource, fallbackSources?: readonly ISeriesStyleSource[]): T | undefined;
+export {};

package/lib/types/source/source-util.d.ts

@@ -1,6 +1,6 @@
 import type { OptionDataValue } from '../types';
 import { ChartSourceDataTypeEnum } from '../enum';
-export declare function getCategoryData(source: OptionDataValue[][], categoryIndex: number, isRowDirection: boolean, sourceType?: ChartSourceDataTypeEnum[][]): {
+export declare function getCategoryData(source: OptionDataValue[][], categoryIndex: number, sourceType?: ChartSourceDataTypeEnum[][]): {
     categoryData: Array<OptionDataValue | undefined>;
     isAllDateTime: boolean;
 };

package/lib/types/source/static-chart-source.d.ts

@@ -1,14 +1,22 @@
 import type { IUniverDataSet } from '../types';
 import { BehaviorSubject } from 'rxjs';
 import { ChartDataSource } from './chart-source';
+/**
+ * Legacy static init data uses `dimensions` as the table header row and
+ * `source` as row-major table cells. StaticChartSource adapts that input to the
+ * canonical vector-based IUniverDataSet returned by convertDataSet().
+ */
+type ILegacyTableDataSet = IUniverDataSet;
 export declare class StaticChartSource extends ChartDataSource {
     _canSwitchOrient$: BehaviorSubject<boolean>;
-    private _columnDirectionDataSetCache;
+    private _rawDataSet;
+    private _convertedDataSetCache;
     constructor();
-    initData(data: IUniverDataSet, isRowDirection?: boolean): void;
-    setData(data: IUniverDataSet): void;
+    initData(data: ILegacyTableDataSet, isRowDirection?: boolean): void;
+    setData(data: ILegacyTableDataSet): void;
     updateIsRowDirection(flag: boolean): void;
     refresh(): void;
     convertDataSet(): IUniverDataSet;
     dispose(): void;
 }
+export {};

package/lib/types/types.d.ts

@@ -1,6 +1,7 @@
 import type { IDisposable, Nullable } from '@univerjs/core';
 import type { Observable } from 'rxjs';
 import type { AreaLineStyle, AxisAlignEnum, AxisValueType, CategoryType, ChartBorderDashType, ChartSourceDataTypeEnum, ChartTrendlineType, ChartTypeBits, DataOrientation, InvalidValueType, IRuntimeAxisPosition, IRuntimeAxisPriority, LabelAlignEnum, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, RelationChartLayoutEnum, SelectModeEnum, SeriesLabelPosition, TitlePositionEnum, WaterfallSeriesTypeEnum, WaterfallStackTypeEnum, WordCloudShapeEnum } from './enum';
+import type { ICartesianPointData } from './models/chart-data-operators/cartesian-point-data';
 import type { IChartLocaleTexts } from './models/chart-locale-texts';
 import type { IEchartTheme } from './models/constants/build-in-theme';
 import type { BarSeriesOption } from './utils/echarts';
@@ -28,6 +29,17 @@ export type DimensionDefinitionLoose = IDimensionDefinition['name'] | IDimension
 export type OptionDataValue = string | number | Date | null | undefined;
 export type ChartDataSourceValue = OptionDataValue;
 export type ChartDataSourceValues = ChartDataSourceValue[][];
+/**
+ * Canonical chart dataset used by chart context operators and chart-data builders.
+ *
+ * Adapters must normalize their raw input before exposing this shape:
+ * - `dimensions[index]` is the optional header label for `source[index]`.
+ * - `source[index]` is one logical data vector, already oriented by the adapter.
+ * - `sourceType` and `sourceLabels`, when present, have the same vector shape as `source`.
+ *
+ * Category detection reads from `source` vectors only. `dimensions` must not be
+ * used as a fallback category vector.
+ */
 export interface IUniverDataSet {
     source: OptionDataValue[][];
     dimensions: Array<DimensionDefinitionLoose>;
@@ -49,15 +61,15 @@ export interface IChartContext {
         categoryIndex?: number;
         seriesIndexes?: number[];
     };
-    bubbleSizeSeriesId?: number;
-    bubbleXAxis?: number;
-    bubbleYAxis?: number;
-    bubbleLabel?: number;
-    bubbleSeries?: number;
+    scatterXIndex?: number;
+    scatterYIndex?: number;
+    scatterLabelIndex?: number;
+    bubbleSizeIndex?: number;
+    bubbleSeriesIndex?: number;
 }
 export interface IRelationNodes {
     id: string;
-    category: string;
+    category?: string;
     name: string;
     value: number;
     symbolSize?: number;
@@ -80,34 +92,7 @@ export interface IChartData {
      * the dataset of the chart, it should match echart dataset option
      */
     dataset?: IUniverDataSet;
-    bubble?: {
-        bubbleSizeData?: {
-            id: string;
-            name: string;
-            items: IChartDataItem[];
-        };
-        bubbleXData?: {
-            id: string;
-            name: string;
-            items: IChartDataItem[];
-        };
-        bubbleYData?: {
-            id: string;
-            name: string;
-            items: IChartDataItem[];
-        };
-        bubbleLabelData?: {
-            id: string;
-            name: string;
-            items: IChartDataItem[];
-        };
-        bubbleSeriesData?: {
-            id: string;
-            name: string;
-            items: IChartDataItem[];
-        };
-        isValidateBubbleSource?: boolean;
-    };
+    cartesianPoint?: ICartesianPointData;
     heatmapData?: {
         xData: string[];
         yData: string[];
@@ -167,6 +152,8 @@ export interface IChartRuntimeContext {
     axes: IRuntimeAxis[];
     themeInfo: IEchartTheme;
     wordCloudRenderConfig?: IWordCloudRenderConfig;
+    /** Runtime-only extra inset reserved by host adapters around chart content. */
+    layoutInset?: number;
     /**
      * The function to transform the color to the render color with considering the system theme is dark mode or not.
      * @param {string} color - The color to be rendered.
@@ -326,6 +313,8 @@ export interface IChartStyle {
     trendlines: ITrendLine[];
     pie: {
         doughnutHole: Nullable<number>;
+        /** Slice offset as a ratio of the pie radius. */
+        explosion?: number;
         labelStyle: IPieLabelStyle;
         borderColor: string;
         hasPaddingAngle: boolean;
@@ -375,6 +364,7 @@ export interface IChartStyle {
     pareto: {
         lineStyle: ISeriesStyle;
         barStyle: ISeriesStyle;
+        includeZeroValues?: boolean;
     };
     heatmap: {
         visualMapType: 'continuous' | 'piecewise';
@@ -413,6 +403,89 @@ export interface IChartRenderSpecConverter<ChartRenderSpec = Record<string, any>
 }
 export type ChartConfigInterceptor = (config: IChartConfig) => IChartConfig;
 export type RenderSpecOperator<ChartRenderSpec> = (spec: ChartRenderSpec, style: ChartStyle, config: IChartConfig, instance: IChartInstance) => void;
+export declare enum ChartHostRenderMode {
+    Image = "image",
+    Dom = "dom"
+}
+export interface IChartHostBorderStyle {
+    color?: string;
+    width?: number;
+}
+export interface IChartHostStyle {
+    stroke?: string;
+    fill?: string;
+    border?: IChartHostBorderStyle;
+    radius?: number;
+    [key: string]: any;
+}
+export interface IChartHostLease extends IDisposable {
+    readonly mountNode: HTMLElement;
+}
+export interface IChartHost extends IDisposable {
+    readonly chartId: string;
+    readonly mode: ChartHostRenderMode;
+    getRect(): IChartHostRect | null;
+    setStyle(style: IChartHostStyle): void;
+}
+export interface IImageChartHost extends IChartHost {
+    readonly mode: ChartHostRenderMode.Image;
+    nextVersion(): number;
+    commitSnapshot(image: ChartImageSource, version: number): boolean;
+    requestPaint(): void;
+    invalidateSnapshot(): void;
+    acquireOffscreenHost(rect: IChartHostRect): IChartHostLease;
+}
+export interface IDomChartHost extends IChartHost {
+    readonly mode: ChartHostRenderMode.Dom;
+    ensureMount(): Promise<HTMLElement | null>;
+    checkMounted(): boolean;
+    syncLayout(): void;
+    markReady(): void;
+    markNotReady(): void;
+}
+export interface IChartRenderInput {
+    chartId: string;
+    config: IChartConfig;
+    style: ChartStyle;
+}
+export interface IChartRenderModelImageExportInput extends IChartRenderInput {
+    width: number;
+    height: number;
+}
+export interface IChartRenderModelImageExportOptions {
+    pixelRatio?: number;
+    backgroundColor?: string | null;
+}
+export interface IChartRenderModelImageExportResult {
+    dataUrl: string;
+    width: number;
+    height: number;
+    pixelRatio: number;
+}
+export interface IChartRenderInstance extends IDisposable {
+    readonly mode: ChartHostRenderMode;
+    bind(host: IChartHost): void;
+    render(input: IChartRenderInput): Promise<void>;
+    exportImg(): Promise<string | undefined>;
+    resize(): void;
+    on(type: ChartElementEventType, handler: ChartElementEventHandler): IDisposable;
+    setElementEditMode(enabled: boolean): void;
+}
+export interface IChartRenderInstanceStyleInput<Spec = Record<string, any>> extends IChartRenderInput {
+    mode: ChartHostRenderMode;
+    spec?: Spec;
+}
+export interface IChartRenderInstanceSpecInput<Spec = Record<string, any>> extends IChartRenderInput {
+    mode: ChartHostRenderMode;
+    spec: Spec;
+}
+export interface IChartRenderInstanceCreateContext<Spec = Record<string, any>> {
+    resolveHostStyle?: (input: IChartRenderInstanceStyleInput<Spec>) => IChartHostStyle;
+    resolveRenderBackgroundColor?: (input: IChartRenderInstanceStyleInput<Spec> & {
+        hostStyle: IChartHostStyle;
+    }) => string | undefined;
+    prepareSpec?: (input: IChartRenderInstanceSpecInput<Spec>) => Spec;
+}
 export interface IChartRenderModelStylizeInit<Spec> {
     chartStyle: ChartStyle;
     chartConfig: IChartConfig;
@@ -421,19 +494,99 @@ export interface IChartRenderModelStylizeInit<Spec> {
 export interface IChartRenderModel<Spec extends Record<string, any> = Record<string, any>> extends IDisposable {
     toSpec(chartConfig: IChartConfig, style: ChartStyle): Spec;
     stylizeSpec(spec: Spec, stylizeInit: IChartRenderModelStylizeInit<Spec>, rect: IChartHostRect): Spec;
+    exportImage(input: IChartRenderModelImageExportInput, options?: IChartRenderModelImageExportOptions): Promise<IChartRenderModelImageExportResult>;
     updateWatermark(addWatermark: boolean): void;
     createChartInstance(): IChartInstance<Spec>;
+    createChartInstance(mode: ChartHostRenderMode, context?: IChartRenderInstanceCreateContext<Spec>): IChartRenderInstance;
+    clearRuntimeCache?(chartId: string): void;
+    clearAllRuntimeCache?(): void;
     dispose(): void;
 }
 export interface IChartThemeOptions {
     colors: string[];
 }
+export declare enum ChartImageSourceType {
+    Url = "url",
+    Canvas = "canvas",
+    ImageBitmap = "imageBitmap"
+}
+export type ChartImageSource = {
+    type: ChartImageSourceType.Url;
+    url: string;
+} | {
+    type: ChartImageSourceType.Canvas;
+    canvas: HTMLCanvasElement;
+} | {
+    type: ChartImageSourceType.ImageBitmap;
+    imageBitmap: ImageBitmap;
+};
+export interface IChartRenderAsImageOptions {
+    width: number;
+    height: number;
+    pixelRatio?: number;
+    backgroundColor?: string;
+    echartsProvider?: any;
+    chartId?: string;
+    host: HTMLElement;
+}
+export interface IChartRenderRuntimeOptions {
+    echartsProvider?: any;
+    chartId?: string;
+    width?: number;
+    height?: number;
+}
+export type ChartElementKind = 'blank' | 'chartArea' | 'title' | 'subtitle' | 'xAxisTitle' | 'yAxisTitle' | 'rightYAxisTitle' | 'xAxisLabel' | 'yAxisLabel' | 'rightYAxisLabel' | 'xAxisLine' | 'yAxisLine' | 'rightYAxisLine' | 'gridLine' | 'tick' | 'legend' | 'legendItem' | 'mark' | 'series' | 'dataPoint' | 'dataLabel';
+export interface IChartElementBounds {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+export interface IChartElementOverlay {
+    type: 'rect' | 'circle' | 'polyline' | 'polygon' | 'sector';
+    bounds: IChartElementBounds;
+    shape?: Record<string, any>;
+    padding?: number;
+    items?: IChartElementOverlay[];
+}
+export interface IChartElementHit {
+    kind: ChartElementKind;
+    bounds?: IChartElementBounds;
+    overlay?: IChartElementOverlay;
+    axisId?: 'xAxis' | 'yAxis' | 'rightYAxis';
+    axisIndex?: number;
+    axisPosition?: 'top' | 'right' | 'bottom' | 'left';
+    legendIndex?: number;
+    legendName?: string;
+    seriesIndex?: number;
+    seriesId?: string;
+    seriesName?: string;
+    dataIndex?: number;
+    baseSeriesIndex?: string;
+    waterfallSeriesType?: WaterfallSeriesTypeEnum;
+}
+export type ChartElementEventType = 'click' | 'dblclick' | 'pointerdown' | 'pointerup' | 'pointermove' | 'pointerenter' | 'pointerleave';
+export interface IChartElementEvent {
+    type: ChartElementEventType;
+    hit: IChartElementHit;
+    localPoint: {
+        x: number;
+        y: number;
+    };
+    button?: number;
+    nativeEvent?: Event;
+    preventDefault?(): void;
+}
+export type ChartElementEventHandler = (event: IChartElementEvent) => void;
 export interface IChartInstance<Spec = Record<string, any>> extends IDisposable {
     container: HTMLElement | string;
     mount(id: string | HTMLElement): void;
     render(spec: Spec, echartsProvider?: any): void;
+    render(spec: Spec, options?: IChartRenderRuntimeOptions): void;
+    renderAsImage(spec: Spec, options: IChartRenderAsImageOptions): Promise<ChartImageSource>;
+    on(type: ChartElementEventType, handler: ChartElementEventHandler): IDisposable;
+    setElementEditMode(enabled: boolean): void;
     exportImg(): Promise<string>;
-    onDispose?(dispose: () => void): void;
     resize(): void;
 }
 export interface IChartInstanceConstructor<Spec> {

package/lib/types/util.d.ts

@@ -3,7 +3,7 @@ export declare const chartBitsUtils: {
     has(bit: number, attribute: number): boolean;
     baseOn(bit: number, base: number): boolean;
     remove(bit: number, attribute: number): number;
-    chartBitToString(bit: ChartTypeBits): "" | "line" | "wordCloud" | "bar" | "scatter" | "pie" | "radar" | "graph" | "funnel" | "sankey" | "boxplot" | "heatmap" | "combination";
+    chartBitToString(bit: ChartTypeBits): "" | "line" | "bar" | "wordCloud" | "scatter" | "pie" | "radar" | "graph" | "funnel" | "sankey" | "boxplot" | "heatmap" | "combination";
 };
 export declare const setProperty: (data: Record<string, any>, propertyPath: string, value: any) => void;
 export declare const getProperty: <T = any>(data: Record<string, any> | undefined, propertyPath: string) => T | undefined;

package/lib/types/wordcloud-chart/adapters/echarts/chart-view.d.ts

@@ -1,7 +1,7 @@
-import type { echarts as EchartsType } from '../../../utils/echarts';
+import type { echarts } from '../../../utils/echarts';
 import { WORD_CLOUD_SERIES_TYPE } from './echarts-options';
 export interface IRegisterWordCloudChartViewContext {
     createTextElement(layout: any, data: any, dataIndex: number, seriesModel: any): unknown;
 }
-export declare function registerWordCloudChartView(echarts: typeof EchartsType, context: IRegisterWordCloudChartViewContext): void;
+export declare function registerWordCloudChartView(echartsInstance: typeof echarts, context: IRegisterWordCloudChartViewContext): void;
 export { WORD_CLOUD_SERIES_TYPE };

package/lib/types/wordcloud-chart/adapters/echarts/install.d.ts

@@ -1,4 +1,5 @@
-import type { echarts as EchartsType } from '../../../utils/echarts';
+import type { echarts } from '../../../utils/echarts';
 import type { IWordCloudEChartsSeriesOption } from '../../types';
-export declare function registerWordCloudChart(echarts: typeof EchartsType): typeof EchartsType;
+export declare function registerWordCloudChart(echartsInstance: typeof echarts): typeof echarts;
+export declare function waitForWordCloudImageResourcesReady(spec: unknown, timeout?: number): Promise<void>;
 export type { IWordCloudEChartsSeriesOption };