@candleview/core 2.9.3 → 2.9.5

package/dist/index.d.ts

@@ -599,6 +599,8 @@ declare class BubbleBoxMark implements IGraph, IMarkStyle {
     private _onMouseUp;
     private _isPointNearControlPoint;
     private _updateHoverState;
+    private _showHandles;
+    setShowHandles(show: boolean): void;
     private _onDoubleClick;
     private _showEditorModal;
     private _onContextMenu;
@@ -624,6 +626,10 @@ declare class BubbleBoxMark implements IGraph, IMarkStyle {
     controlPointPrice(): number;
     bubbleTime(): number;
     bubblePrice(): number;
+    getTextColor(): string;
+    getFontSize(): number;
+    isBold(): boolean;
+    isItalic(): boolean;
     getText(): string;
     updateText(text: string): void;
     updateStyles(styles: {
@@ -673,12 +679,7 @@ declare class BubbleBoxMarkManager implements IMarkManager<BubbleBoxMark> {
     private bubbleBoxMarks;
     private dragStartData;
     private isOperating;
-    private isCreatingNewBubble;
-    private creationStep;
     constructor(props: BubbleBoxMarkManagerProps);
-    private _addEventListeners;
-    private _removeEventListeners;
-    private _handleBubbleBoxMarkDragStart;
     clearState(): void;
     getMarkAtPoint(point: Point): BubbleBoxMark | null;
     getMarkAtPointWithType(point: Point): {
@@ -719,11 +720,11 @@ declare interface BubbleBoxMarkManagerProps {
 
 declare interface BubbleBoxMarkState {
     isBubbleBoxMarkMode: boolean;
-    bubbleBoxMarkPoints: Point[] | null;
+    bubbleBoxMarkStartPoint: Point | null;
     currentBubbleBoxMark: BubbleBoxMark | null;
     isDragging: boolean;
     dragTarget: BubbleBoxMark | null;
-    dragType: 'controlPoint' | 'bubble' | 'connection' | null;
+    dragPoint: 'controlPoint' | 'bubble' | 'connection' | null;
 }
 
 export declare class CandleView {
@@ -822,6 +823,7 @@ export declare class CandleView {
     clearCurrentTool(): void;
     getCurrentTool(): string | null;
     setData(data: ICandleViewDataPoint[]): void;
+    updateData(newData: ICandleViewDataPoint[]): void;
     getCurrentTheme(): ThemeConfig;
     setTheme(themeType: 'light' | 'dark'): void;
     setLocale(locale: 'en' | 'zh-cn'): void;
@@ -832,6 +834,66 @@ export declare class CandleView {
     getPriceEvents(): PriceEvent[];
     getChart(): Chart | null;
     destroy(): void;
+    /**
+     * Add a single static mark
+     * @param time Timestamp
+     * @param text Mark text
+     * @param direction Mark direction (StaticMarkDirection.Top or StaticMarkDirection.Bottom)
+     * @param type Mark type (StaticMarkType.Text or StaticMarkType.Arrow)
+     * @param options Optional configuration
+     */
+    addStaticMark(time: number, text: string, direction: StaticMarkDirection, type: StaticMarkType, options?: IStaticMarkOptions): void;
+    /**
+     * Add multiple static marks in batch
+     * @param marks Array of marks
+     */
+    addStaticMarks(marks: IStaticMarkItem[]): void;
+    /**
+     * Add a text mark (convenience method)
+     * @param time Timestamp
+     * @param text Mark text
+     * @param direction Mark direction
+     * @param options Optional configuration
+     */
+    addTextMark(time: number, text: string, direction: StaticMarkDirection, options?: IStaticMarkOptions): void;
+    /**
+     * Add an arrow mark (convenience method)
+     * @param time Timestamp
+     * @param direction Mark direction
+     * @param options Optional configuration
+     */
+    addArrowMark(time: number, direction: StaticMarkDirection, options?: IStaticMarkOptions & {
+        label?: string;
+    }): void;
+    /**
+     * Add multiple text marks in batch
+     * @param marks Array of text marks
+     */
+    addTextMarks(marks: Array<{
+        time: number;
+        text: string;
+        direction: StaticMarkDirection;
+        options?: IStaticMarkOptions;
+    }>): void;
+    /**
+     * Add multiple arrow marks in batch
+     * @param marks Array of arrow marks
+     */
+    addArrowMarks(marks: Array<{
+        time: number;
+        direction: StaticMarkDirection;
+        options?: IStaticMarkOptions & {
+            label?: string;
+        };
+    }>): void;
+    /**
+     * Clear all static marks
+     */
+    clearAllStaticMarks(): void;
+    /**
+     * Get the count of static marks
+     */
+    getStaticMarkCount(): number;
 }
 
 export declare interface CandleViewConfig {
@@ -862,8 +924,8 @@ export declare interface CandleViewConfig {
 
 declare class Chart {
     private container;
-    data: ICandleViewDataPoint[];
-    private preprocessedData;
+    originalData: ICandleViewDataPoint[];
+    preprocessedData: DataPreprocessResult | null;
     private theme;
     currentTheme: ThemeConfig;
     private chartType;
@@ -932,6 +994,7 @@ declare class Chart {
     private textMarkEditorPosition;
     private textMarkEditorData;
     onExitBrushMode?: () => void;
+    leftPanel: LeftPanel | null;
     constructor(options: {
         container: HTMLElement;
         data: ICandleViewDataPoint[];
@@ -1034,11 +1097,14 @@ declare class Chart {
     getVisibleIndicatorTypes(): MainChartIndicatorType[];
     updateIndicatorParams(indicatorId: string, newParams: MainChartIndicatorParam[]): void;
     toggleIndicatorVisibility(type: MainChartIndicatorType): void;
-    private convertDataByType;
-    private fitContent;
     private setupResizeObserver;
     handleResize(): void;
-    updateData(originalData: ICandleViewDataPoint[], preprocessedData?: DataPreprocessResult): void;
+    getChart(): IChartApi | null;
+    private indicatorUpdateTimer;
+    private panesUpdateTimer;
+    private marketProfileUpdateTimer;
+    private heatMapUpdateTimer;
+    setData(preprocessedData?: DataPreprocessResult): void;
     updateChartType(type: MainChartType): void;
     getCurrentTheme(): ThemeConfig;
     setTheme(themeType: 'light' | 'dark'): void;
@@ -1585,7 +1651,6 @@ export declare class DataPreprocessor {
 
 export declare interface DataPreprocessResult {
     displayData: ICandleViewDataPoint[];
-    hiddenBaseData: ICandleViewDataPoint[];
     realDataRange: {
         firstIndex: number;
         lastIndex: number;
@@ -2188,11 +2253,9 @@ export declare interface DrawingManagerState {
     isPinDragging: boolean;
     pinDragTarget: any;
     isBubbleBoxMarkMode: boolean;
-    bubbleBoxMarkPoints: Point[] | null;
     currentBubbleBoxMark: any;
     isBubbleBoxDragging: boolean;
     bubbleBoxDragTarget: any;
-    bubbleBoxDragType: 'controlPoint' | 'bubble' | 'connection' | null;
     isTextEditMarkMode: boolean;
     isTextEditDragging: boolean;
     textEditDragTarget: any;
@@ -6027,6 +6090,9 @@ export declare interface I18n {
         flagMarkDesc: string;
         image: string;
         imageDesc: string;
+        imageUrl: string;
+        inputImageUrl: string;
+        orInputImageUrl: string;
         video: string;
         videoDesc: string;
         audio: string;
@@ -6420,6 +6486,147 @@ declare interface IMarkStyle {
     getCurrentStyles(): Record<string, any>;
 }
 
+declare interface IStaticMarkItem {
+    time: number;
+    text: string;
+    direction: StaticMarkDirection;
+    type: StaticMarkType;
+    options?: IStaticMarkOptions;
+}
+
+declare interface IStaticMarkOptions {
+    textColor?: string;
+    backgroundColor?: string;
+    isCircular?: boolean;
+    fontSize?: number;
+    padding?: number;
+    label?: string;
+}
+
+declare class LeftPanel {
+    options: LeftPanelOptions;
+    private theme;
+    private i18n;
+    private element;
+    private container;
+    private toolManager;
+    private state;
+    private drawingModalRef;
+    private emojiPickerRef;
+    private cursorModalRef;
+    private brushModalRef;
+    private fibonacciModalRef;
+    private projectInfoModalRef;
+    private irregularShapeModalRef;
+    private textToolModalRef;
+    private aiModalRef;
+    private scriptModalRef;
+    private scrollContainerRef;
+    private scrollTopBtn;
+    private scrollBottomBtn;
+    constructor(options: LeftPanelOptions);
+    private injectScrollbarStyles;
+    private init;
+    private createDOM;
+    private scrollToTop;
+    private scrollToBottom;
+    private addDivider;
+    private renderCursorTools;
+    private renderLineTools;
+    private renderTecGraphTools;
+    private renderMarkTools;
+    private renderOtherTools;
+    private renderTrash;
+    private createToolButton;
+    private handleToolAction;
+    private updateCursorButtonIcon;
+    private updateToolButtonIcon;
+    private getMaxModalHeight;
+    private showDrawingModal;
+    private showBrushModal;
+    private showCursorModal;
+    private showFibonacciModal;
+    private showProjectInfoModal;
+    private showIrregularShapeModal;
+    private showTextToolModal;
+    private showEmojiModal;
+    private closeModal;
+    closeAllModals(): void;
+    private bindOutsideClick;
+    setActiveTool(toolId: string | null): void;
+    private toggleLock;
+    private toggleVisibility;
+    private updateOtherTools;
+    private getToolConfig;
+    private findToolInGroups;
+    private getIconSvg;
+    private getModalTop;
+    private updateContainerHeight;
+    private updateScrollButtons;
+    private updateScrollButtonsUI;
+    private bindEvents;
+    private handleClickOutside;
+    private setState;
+    updateTheme(theme: Theme): void;
+    updateI18n(i18n: I18n): void;
+    destroy(): void;
+    updateState(updates: Partial<LeftPanelState>): void;
+    isMarkLocked(): boolean;
+    getState(): LeftPanelState;
+}
+
+declare interface LeftPanelOptions {
+    container: HTMLElement;
+    theme: Theme;
+    i18n: I18n;
+    onToolSelect?: (tool: string) => void;
+    selectedEmoji?: string;
+    onEmojiSelect?: (emoji: string) => void;
+    state: LeftPanelState;
+    onStateChange: (updates: Partial<LeftPanelState>) => void;
+    chart?: any;
+}
+
+declare interface LeftPanelState {
+    isDrawingModalOpen: boolean;
+    isEmojiSelectPopUpOpen: boolean;
+    isBrushModalOpen: boolean;
+    isCursorModalOpen: boolean;
+    isFibonacciModalOpen: boolean;
+    isProjectInfoModalOpen: boolean;
+    isIrregularShapeModalOpen: boolean;
+    isTextToolModalOpen: boolean;
+    isAIToolsModalOpen: boolean;
+    isScriptModalOpen: boolean;
+    selectedEmoji: string;
+    selectedEmojiCategory: string;
+    selectedCursor: string;
+    selectedAITool: string | null;
+    selectedScriptTool: string | null;
+    lastSelectedTools: {
+        drawing: string;
+        brush: string;
+        cursor: string;
+        fibonacci: string;
+        projectInfo: string;
+        irregularShape: string;
+        textTool: string;
+        aiTools: string;
+        script: string;
+    };
+    arrowButtonStates: Record<string, boolean>;
+    toolHoverStates: Record<string, boolean>;
+    isMarkLocked: boolean;
+    isMarkVisibility: boolean;
+    toolSearch: string;
+    containerHeight: number;
+    scrollButtonVisibility: {
+        showTop: boolean;
+        showBottom: boolean;
+    };
+    isBrushActive: boolean;
+}
+
 export declare const Light: ThemeConfig;
 
 declare class LinearRegressionChannelMark implements IGraph, IMarkStyle {
@@ -7616,6 +7823,11 @@ declare class PinMark implements IGraph, IMarkStyle {
     };
     destroy(): void;
     updateText(text: string): void;
+    getText(): string;
+    getTextColor(): string;
+    getFontSize(): number;
+    isBold(): boolean;
+    isItalic(): boolean;
 }
 
 declare class PinMarkManager implements IMarkManager<PinMark> {
@@ -7924,6 +8136,10 @@ declare class PriceLabelMark implements IGraph, IMarkStyle {
         minY: number;
         maxY: any;
     } | null;
+    getTextColor(): string;
+    getFontSize(): number;
+    isBold(): boolean;
+    isItalic(): boolean;
 }
 
 declare class PriceLabelMarkManager implements IMarkManager<PriceLabelMark> {
@@ -8958,6 +9174,16 @@ declare interface SignPostMarkState {
     dragTarget: SignPostMark | null;
 }
 
+export declare enum StaticMarkDirection {
+    Top = "Top",
+    Bottom = "Bottom"
+}
+
+export declare enum StaticMarkType {
+    Text = "Text",
+    Arrow = "Arrow"
+}
+
 export declare enum SubChartIndicatorType {
     RSI = "RSI",
     MACD = "MACD",
@@ -9040,6 +9266,10 @@ declare class TextEditMark implements IGraph, IMarkStyle {
     private requestUpdate;
     bubbleTime(): number;
     bubblePrice(): number;
+    getTextColor(): string;
+    getFontSize(): number;
+    isBold(): boolean;
+    isItalic(): boolean;
     getText(): string;
     updateText(text: string): void;
     updateStyles(styles: {