@quantlife/qlchart 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,1973 @@
+import { CandlestickData as CandlestickData_2 } from 'lightweight-charts';
+import { ChartOptions as ChartOptions_2 } from 'lightweight-charts';
+import { CustomData } from 'lightweight-charts';
+import { CustomSeriesOptions } from 'lightweight-charts';
+import { CustomSeriesPricePlotValues } from 'lightweight-charts';
+import { CustomSeriesWhitespaceData } from 'lightweight-charts';
+import { DeepPartial } from 'lightweight-charts';
+import { ForwardRefExoticComponent } from 'react';
+import { IChartApi } from 'lightweight-charts';
+import { ICustomSeriesPaneRenderer } from 'lightweight-charts';
+import { ICustomSeriesPaneView } from 'lightweight-charts';
+import { IDrawing } from 'lightweight-charts-drawing';
+import { ISeriesApi } from 'lightweight-charts';
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { PaneRendererCustomData } from 'lightweight-charts';
+import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+import { RefObject } from 'react';
+import { SeriesType as SeriesType_2 } from 'lightweight-charts';
+import { StoreApi } from 'zustand';
+import { Time } from 'lightweight-charts';
+import { UseBoundStore } from 'zustand';
+import { UTCTimestamp } from 'lightweight-charts';
+
+/**
+ * 用户激活的指标配置
+ */
+declare interface ActiveIndicatorConfig {
+    /** 对应IndicatorTemplate.key */
+    key: string;
+    /** 用户自定义参数（覆盖defaultParams） */
+    params: Record<string, number>;
+    /** 是否可见 */
+    visible: boolean;
+    /** 用户自定义样式（覆盖lines中的默认颜色） */
+    styleOverrides?: Record<string, string>;
+}
+
+/** 内置指标定义 */
+export declare const BUILTIN_INDICATORS: IndicatorDefinition[];
+
+/** LWC K线数据 */
+export declare interface CandlestickData {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+}
+
+/** K线数据（API返回的原始格式） */
+export declare interface CandlestickRawData {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume?: number;
+}
+
+/** 分类中文标签 */
+export declare const CATEGORY_LABELS: Record<DrawingToolCategory, string>;
+
+/** 图表事件枚举 */
+export declare enum ChartEvent {
+    ChartCreated = "chart:created",
+    ChartDisposed = "chart:disposed",
+    DataLoaded = "data:loaded",
+    PeriodChanged = "period:changed",
+    CrosshairMove = "crosshair:move",
+    SeriesAdded = "series:added",
+    SeriesRemoved = "series:removed",
+    ThemeChanged = "theme:changed",
+    LayoutChanged = "layout:changed",
+    Error = "error"
+}
+
+export declare function ChartFunctionMenu({ chart }: ChartFunctionMenuProps): JSX_2.Element;
+
+export declare interface ChartFunctionMenuProps {
+    chart: IChartApi | null;
+}
+
+/**
+ * 图表管理器
+ * 封装 LWC IChartApi 的生命周期
+ */
+export declare class ChartManager {
+    private chart;
+    private eventManager;
+    private container;
+    constructor(eventManager: EventManager);
+    /** 创建图表实例 */
+    create(container: HTMLElement, options?: ChartManagerCreateOptions): IChartApi;
+    /** 销毁图表实例 */
+    dispose(): void;
+    /** 更新图表选项 */
+    updateOptions(options: DeepPartial<ChartOptions_2>): void;
+    /** 获取图表实例 */
+    getChart(): IChartApi | null;
+    /** 调整图表大小 */
+    resize(width: number, height: number): void;
+    /** 截图 */
+    screenshot(): string | null;
+}
+
+export declare interface ChartManagerCreateOptions {
+    width?: number;
+    height?: number;
+    theme?: DeepPartial<ChartOptions_2>;
+}
+
+/** 图表选项 */
+export declare interface ChartOptions {
+    width?: number;
+    height?: number;
+    layout?: {
+        background?: string;
+        textColor?: string;
+    };
+    grid?: {
+        vertLines?: {
+            color?: string;
+        };
+        horzLines?: {
+            color?: string;
+        };
+    };
+    crosshair?: {
+        mode?: 'normal' | 'magnet';
+    };
+    timeScale?: {
+        timeVisible?: boolean;
+        secondsVisible?: boolean;
+    };
+}
+
+/** 图表数据请求参数 */
+export declare interface ChartRequestParams {
+    pairId: string;
+    product: string;
+    period: string;
+    startTime?: number;
+    endTime?: number;
+    limit?: number;
+}
+
+/** 图表API响应 */
+export declare interface ChartResponse<T = unknown> {
+    code: number;
+    data: T;
+    msg?: string;
+}
+
+export declare interface ChartState {
+    activePairId: string | null;
+    activeProduct: string | null;
+    activePeriod: string;
+    activeSeriesType: SeriesType;
+    activeTheme: 'dark' | 'light';
+    layoutMode: LayoutMode;
+    panels: PanelConfig[];
+    /** 当前活跃面板 ID（全局工具栏操作的目标） */
+    activePanelId: string | null;
+    /** 每个面板的独立周期状态：panelId → period */
+    panelPeriods: Record<string, string>;
+    setPair: (pairId: string, product: string) => void;
+    setPeriod: (period: string) => void;
+    setSeriesType: (type: SeriesType) => void;
+    setTheme: (theme: 'dark' | 'light') => void;
+    setLayoutMode: (mode: LayoutMode) => void;
+    updatePanel: (index: number, config: Partial<PanelConfig>) => void;
+    /** 设置活跃面板 */
+    setActivePanel: (panelId: string) => void;
+    /** 设置当前活跃面板的周期（多面板写入panelPeriods，单面板fallback全局） */
+    setActivePanelPeriod: (period: string) => void;
+    /** 设置指定面板的周期 */
+    setPanelPeriod: (panelId: string, period: string) => void;
+}
+
+/** 图表主题选项（映射到LWC的theme相关选项） */
+export declare interface ChartThemeOptions {
+    layout: {
+        background: {
+            color: string;
+        };
+        textColor: string;
+    };
+    grid: {
+        vertLines: {
+            color: string;
+        };
+        horzLines: {
+            color: string;
+        };
+    };
+    crosshair?: {
+        mode?: number;
+        vertLine?: {
+            color?: string;
+            labelBackgroundColor?: string;
+        };
+        horzLine?: {
+            color?: string;
+            labelBackgroundColor?: string;
+        };
+    };
+    /** ★ V3: 时间格式化配置 */
+    localization?: {
+        timeFormatter?: (time: Time) => string;
+        dateFormat?: string;
+    };
+    /** ★ V3: 时间轴配置 */
+    timeScale?: {
+        timeVisible?: boolean;
+        secondsVisible?: boolean;
+        tickMarkFormatter?: (time: Time, tickMarkType: number, locale: string) => string;
+    };
+}
+
+/** 创建一个指标配置 */
+export declare function createIndicatorConfig(definition: IndicatorDefinition, overrides?: Partial<IndicatorConfig>): IndicatorConfig;
+
+/** 十字光标数据 */
+export declare interface CrosshairData {
+    time: Time;
+    price: number;
+    volume?: number;
+}
+
+export declare const darkPreset: ThemeConfig;
+
+/**
+ * 数据管理器（增强版）
+ *
+ * 三大核心能力：
+ * 1. 拖动加载（ScrollLoader）— 监听 visibleLogicalRangeChange，触底自动加载历史
+ * 2. 定时获取（RealtimePoller）— setInterval 拉取最新 K 线
+ * 3. 分片缓存（SliceCache）— 按 pair+product+period 维度缓存已加载的分片
+ *
+ * 同时保持对旧 fetchChartData() 的向后兼容。
+ */
+export declare class DataManager {
+    private fetchFn;
+    private cache;
+    private cacheTTL;
+    private chart;
+    private series;
+    private pairId;
+    private product;
+    private period;
+    private isLoadingHistory;
+    private hasMoreHistory;
+    private scrollHandler;
+    private realtimeTimer;
+    private allData;
+    private slices;
+    constructor(fetchFn: FetchFn);
+    /**
+     * 绑定到图表实例，启用拖动加载
+     */
+    attachToChart(chart: IChartApi, series: ISeriesApi<any>, params: {
+        pairId: string;
+        product: string;
+        period: string;
+    }): void;
+    /**
+     * 解绑图表，清理所有监听和定时器
+     */
+    detach(): void;
+    /**
+     * 加载更早的历史数据
+     */
+    private loadMoreHistory;
+    /**
+     * 在 series 前面追加历史数据（方案B：维护全量数组）
+     */
+    private prependData;
+    /**
+     * 启动定时获取最新数据
+     */
+    startRealtimeFetch(intervalMs?: number): void;
+    /**
+     * 停止定时获取
+     */
+    stopRealtimeFetch(): void;
+    /**
+     * 获取最新 K 线并增量更新
+     */
+    private fetchLatest;
+    private getCacheKey;
+    /**
+     * 保存分片到缓存
+     */
+    private saveSlice;
+    /**
+     * 查询缓存中是否包含指定时间范围的数据
+     */
+    private getCachedSlices;
+    /**
+     * 检查分片缓存是否覆盖了请求范围
+     */
+    private isRangeCached;
+    /**
+     * 从当前 allData 获取最早时间戳（毫秒）
+     */
+    private getEarliestDataTime;
+    /**
+     * 从当前 allData 获取最新时间戳（毫秒）
+     */
+    private getLatestDataTime;
+    /**
+     * 从 series 同步全量数据到 allData
+     */
+    private syncAllDataFromSeries;
+    /**
+     * 手动设置全量数据（外部调用 setData 后同步）
+     */
+    setAllData(data: CandlestickData[]): void;
+    /**
+     * 获取图表数据（带缓存，向后兼容）
+     */
+    fetchChartData(params: ChartRequestParams): Promise<unknown>;
+    private getLegacyCacheKey;
+    private getCacheEntry;
+    private setCache;
+    /** 手动设置缓存数据 */
+    setCacheData(params: ChartRequestParams, data: unknown): void;
+    /** 清除所有缓存（旧缓存 + 分片缓存） */
+    clearCache(): void;
+    /** 设置缓存TTL（毫秒） */
+    setCacheTTL(ttl: number): void;
+}
+
+/**
+ * 绘图工具注册表
+ * 从 lightweight-charts-drawing 的 68 种工具中筛选出我们需要的 21 种
+ */
+export declare const DRAWING_TOOLS: DrawingToolConfig[];
+
+/**
+ * DrawingAdapter - 绘图适配器
+ * 作为 QLChart 和 lightweight-charts-drawing DrawingManager 的桥接层
+ *
+ * Core/Plugin 层不依赖 React
+ */
+export declare class DrawingAdapter {
+    private manager;
+    private chart;
+    private series;
+    private container;
+    private unsubscribers;
+    private chartId;
+    private creationState;
+    private chartClickHandler;
+    private chartDblClickHandler;
+    private containerMouseMoveHandler;
+    private keydownHandler;
+    private defaultDrawingStyle;
+    private bodyDragState;
+    private bodyDragStartHandler;
+    private bodyDragMoveHandler;
+    private bodyDragEndHandler;
+    private freeDrawStartHandler;
+    private freeDrawMoveHandler;
+    private freeDrawEndHandler;
+    private freeDrawActive;
+    private freeDrawRafId;
+    private freeDrawPendingEvent;
+    private rafId;
+    private pendingDragEvent;
+    private magnetEnabled;
+    private candleData;
+    private priceRangeCache;
+    private activeToolType;
+    private currentPeriod;
+    private textLabelOverlay;
+    private textInputEditor;
+    /** 当前绘图目标 pane index（0 = 主图） */
+    private currentPaneIndex;
+    /** paneIndex → 该 pane 的绘图数据（绘图隔离） */
+    private paneDrawingsMap;
+    /** pane 切换请求回调（通知外部获取目标 pane 的 series） */
+    private onPaneSwitchNeededCb?;
+    /** ★ V5 需求1：paneIndex → series 映射（内部维护，不再依赖外部回查） */
+    private paneSeriesInternalMap;
+    private savedScrollOptions;
+    private savedScaleOptions;
+    private onDrawingCreatedCb?;
+    private onDrawingSelectedCb?;
+    private onDrawingModifiedCb?;
+    private onDrawingRemovedCb?;
+    private onToolChangedCb?;
+    private onDrawingDoubleClickCb?;
+    /**
+     * 绑定 DrawingManager 到 chart/series/container
+     */
+    attach(chart: IChartApi, series: ISeriesApi<SeriesType_2>, container: HTMLElement, chartId?: string): void;
+    /**
+     * 解绑并销毁 DrawingManager
+     */
+    detach(): void;
+    /** 是否已绑定 */
+    isAttached(): boolean;
+    isFullyAttached(): boolean;
+    getAttachDiagnostics(): Record<string, unknown>;
+    /**
+     * 设置当前绘图工具
+     * 'cursor' = 取消绘图模式
+     */
+    setActiveTool(toolType: DrawingToolType): void;
+    /** 获取当前工具类型 */
+    getActiveTool(): string | null;
+    setPeriod(period: string): void;
+    /** 获取当前周期 */
+    getCurrentPeriod(): string;
+    /**
+     * Bug1修复：刷新测量器标签 — patch 所有 date-price-range 绘图
+     */
+    private refreshMeasureLabels;
+    /**
+     * Bug1修复：Patch 测量器绘图，覆盖 getMeasureInfo 计算正确的 bars
+     */
+    private patchMeasureDrawing;
+    /**
+     * Bug1修复：将周期字符串转换为秒数
+     */
+    private periodToSeconds;
+    /**
+     * Bug1修复：公开方法 — patch 测量器绘图（供外部调用）
+     */
+    patchMeasureDrawingPublic(drawing: IDrawing): void;
+    /** 获取所有绘图实例 */
+    getAllDrawings(): IDrawing[];
+    /** 设置所有绘图的可见性 */
+    setAllVisible(visible: boolean): void;
+    /** 获取所有绘图是否可见 */
+    getAllVisible(): boolean;
+    /** 选中某个绘图 */
+    selectDrawing(id: string): void;
+    /** 取消选中 */
+    deselectAll(): void;
+    /** 获取当前选中的绘图 */
+    getSelectedDrawing(): IDrawing | null;
+    /** 删除指定绘图 */
+    removeDrawing(id: string): void;
+    /** 删除当前选中的绘图 */
+    removeSelected(): void;
+    /** 清空所有绘图 */
+    clearAll(): void;
+    /**
+     * 导出绘图数据（用于持久化）
+     */
+    exportDrawings(): DrawingPersistData[];
+    /**
+     * 导入绘图数据（从后端加载恢复）
+     */
+    importDrawings(data: DrawingPersistData[]): void;
+    /**
+     * 更新主序列引用（数据重载后调用）
+     */
+    updateSeries(series: ISeriesApi<SeriesType_2>): void;
+    /**
+     * ★ Bug5修复：切换绘图目标series（用于在副图中绘图）
+     */
+    setTargetSeries(series: ISeriesApi<SeriesType_2>): void;
+    /** 设置K线数据（用于磁铁吸附计算） */
+    setCandleData(data: CandlestickData_2[]): void;
+    /**
+     * ★ 多周期共享修复：二分查找最接近targetTime的K线时间戳
+     * candleData按time升序排列（由transformCandlestickData保证）
+     * 时间复杂度: O(log n)
+     */
+    private findNearestCandleTime;
+    /**
+     * ★ 多周期共享修复：将锚点时间对齐到当前周期的K线时间戳
+     * 用于跨周期共享时解决时间戳不匹配问题
+     */
+    private alignAnchorsToPeriod;
+    /** 设置磁铁吸附开关 */
+    setMagnetEnabled(enabled: boolean): void;
+    /**
+     * 获取鼠标位置最近的K线价格（磁铁吸附）
+     */
+    getNearestPrice(clientX: number, clientY: number): {
+        time: number;
+        price: number;
+    } | null;
+    /** 设置事件回调 */
+    onDrawingCreated(cb: (drawing: IDrawing) => void): void;
+    onDrawingSelected(cb: (drawing: IDrawing | null) => void): void;
+    onDrawingModified(cb: (drawing: IDrawing) => void): void;
+    onDrawingRemoved(cb: (id: string) => void): void;
+    onToolChanged(cb: (tool: string | null) => void): void;
+    onDrawingDoubleClick(cb: (drawing: IDrawing | null) => void): void;
+    /** Bug3修复：设置绘图文字标签（从属性面板调用） */
+    setDrawingText(drawingId: string, text: string): void;
+    /** 销毁 */
+    dispose(): void;
+    /**
+     * ★ V2: 检测点击落在哪个 pane
+     * LWC v5 提供 chart.panes() API，每个 pane 有 getHeight()
+     */
+    private detectPaneIndex;
+    /**
+     * ★ V2: 切换绘图目标 pane（带绘图隔离）
+     */
+    switchPane(paneIndex: number, paneSeries: ISeriesApi<SeriesType_2>): void;
+    /**
+     * ★ V2: 获取当前目标 pane index
+     */
+    getCurrentPaneIndex(): number;
+    /**
+     * ★ V2: 重置到主图 pane
+     */
+    resetToMainPane(): void;
+    /**
+     * ★ V6 需求1：清除所有 pane series 映射（指标 clearAll 后调用）
+     */
+    clearPaneSeriesMap(): void;
+    /**
+     * ★ V5 需求1：注册 pane series 映射（供内部 detectPaneIndex 自动切换）
+     */
+    registerPaneSeries(paneIndex: number, series: ISeriesApi<SeriesType_2>): void;
+    /**
+     * ★ V5 需求1：取消注册 pane series
+     */
+    unregisterPaneSeries(paneIndex: number): void;
+    /**
+     * ★ V2: 设置 pane 切换请求回调
+     */
+    onPaneSwitchNeeded(cb: (paneIndex: number) => void): void;
+    /**
+     * Bug①修复：绑定拖拽交互
+     * 选中绘图时禁用 chart 的平移和缩放，取消选中时恢复
+     * 关键：handleScroll/handleScale 是 ChartOptions 顶层属性，pressedMouseMove 是正确属性名
+     */
+    private bindDragInteraction;
+    private bindEvents;
+    private unbindEvents;
+    /**
+     * 处理图表点击 — 绘图创建核心逻辑
+     */
+    private handleChartClick;
+    /**
+     * 开始创建绘图
+     */
+    private startCreation;
+    /**
+     * 添加锚点
+     */
+    private addAnchor;
+    /**
+     * 完成创建 — 重置状态，自动切回光标
+     */
+    private completeCreation;
+    /**
+     * 取消创建 — 移除创建中的绘图，重置状态
+     */
+    private cancelCreation;
+    /**
+     * 处理双击 — 动态锚点工具结束创建
+     */
+    private handleChartDblClick;
+    /**
+     * 处理鼠标移动 — 实时预览创建中的绘图
+     */
+    private handleContainerMouseMove;
+    /**
+     * 处理键盘 — Esc 取消创建
+     */
+    private handleKeydown;
+    /**
+     * 整体拖拽：启动检测（capture 阶段，先于库的 mousedown）
+     */
+    private handleBodyDragStart;
+    /**
+     * 整体拖拽：移动入口（rAF节流）
+     */
+    private handleBodyDragMove;
+    /**
+     * 整体拖拽：实际移动逻辑（逐锚点像素转换方案）
+     */
+    private processBodyDragMove;
+    /**
+     * 整体拖拽：结束
+     */
+    private handleBodyDragEnd;
+    /**
+     * 画笔自由绘制：mousedown 拦截
+     */
+    private handleFreeDrawStart;
+    /**
+     * 画笔自由绘制：mousemove（rAF节流）
+     */
+    private handleFreeDrawMove;
+    /**
+     * 画笔自由绘制：mouseup
+     */
+    private handleFreeDrawEnd;
+    /**
+     * 显示文字输入编辑器
+     */
+    private showTextInputEditor;
+    /**
+     * 隐藏文字输入编辑器
+     */
+    private hideTextInputEditor;
+    /**
+     * Bug4修复：更新所有文字标签位置（图表滚动/缩放后调用）
+     */
+    private updateTextLabels;
+    /**
+     * 辅助：构造 Viewport
+     */
+    private getViewport;
+    /**
+     * Bug2修复：获取K线价格范围（带缓存）
+     */
+    private getPriceRange;
+    /**
+     * Bug2修复：限制价格在K线数据的合理范围内
+     * 允许 20% 的超出余量，避免完全锁死影响用户体验
+     */
+    private clampPriceToData;
+    /**
+     * Fib Bug修复：扩大命中范围的 fallback hitTest
+     * @param pixel 鼠标像素坐标
+     * @param threshold 扩大的命中阈值（像素）
+     * @return 最近的命中绘图，或 null
+     */
+    private hitTestFallback;
+}
+
+/**
+ * 绘图模块容器组件
+ *
+ * 独立管理绘图工具栏的渲染。
+ * 渲染位置由父组件控制（通常在QLChartPanel中）。
+ *
+ * 使用方式：
+ * ```tsx
+ * <DrawingModule />
+ * ```
+ */
+export declare function DrawingModule({ showPropertyPanel, className, }: DrawingModuleProps): JSX_2.Element;
+
+export declare interface DrawingModuleProps {
+    /** 是否显示属性面板（默认true） */
+    showPropertyPanel?: boolean;
+    /** 自定义 className */
+    className?: string;
+}
+
+/** 绘图持久化数据 */
+declare interface DrawingPersistData {
+    id: string;
+    chartId: string;
+    type: string;
+    anchors: Array<{
+        time: number;
+        price: number;
+    }>;
+    style: DrawingStyleConfig;
+    options: {
+        visible?: boolean;
+        locked?: boolean;
+        zIndex?: number;
+        extendLeft?: boolean;
+        extendRight?: boolean;
+    };
+    createdAt: number;
+    updatedAt: number;
+    /** ★ V2 新增：所属 pane index（0=主图） */
+    paneIndex?: number;
+}
+
+/** 持久化管理器 */
+export declare class DrawingPersistence {
+    private storageKey;
+    private pairId;
+    private product;
+    private mode;
+    private apiBaseUrl?;
+    private debounceTimer;
+    constructor(config: PersistenceConfig);
+    /** 保存画图数据 */
+    save(drawings: DrawingPersistData[]): Promise<void>;
+    /** 加载画图数据 */
+    load(): Promise<DrawingPersistData[]>;
+    /** 删除指定画图 */
+    remove(id: string): Promise<void>;
+    /** 更新单条绘图（增量更新） */
+    update(drawing: DrawingPersistData): Promise<void>;
+    /** 清空所有画图 */
+    clear(): Promise<void>;
+    /** 导出为JSON字符串（备份用） */
+    exportJSON(drawings: DrawingPersistData[]): string;
+    /** 从JSON字符串导入 */
+    importJSON(json: string): Promise<void>;
+    /** 自动保存（debounce） */
+    autoSave(drawings: DrawingPersistData[]): void;
+    /** 销毁 */
+    dispose(): void;
+    /** 构建存储Key（仅使用 pairId + product，移除 chartId 和 period） */
+    private buildKey;
+    /** 简单hash函数 */
+    private simpleHash;
+    private localSave;
+    private localLoad;
+    private localRemove;
+    private localClear;
+    /** 检查localStorage容量 */
+    private checkStorageSize;
+    /** 批量保存（全量覆盖） */
+    private remoteSave;
+    /** 按交易对加载全部绘图 */
+    private remoteLoad;
+    /** 删除单条绘图 */
+    private remoteRemove;
+    /** 更新单条绘图（增量更新） */
+    private remoteUpdate;
+    /** 清空指定交易对的所有绘图 */
+    private remoteClear;
+}
+
+export declare interface DrawingState {
+    /** 当前激活的绘图工具 */
+    activeTool: DrawingToolType;
+    /** 绘图数量（用于显示 badge） */
+    drawingCount: number;
+    /** 当前选中的绘图 ID */
+    selectedDrawingId: string | null;
+    /** 当前选中的绘图类型 */
+    selectedDrawingType: string | null;
+    /** 磁铁吸附开关 */
+    magnetEnabled: boolean;
+    /** 是否正在绘图 */
+    isDrawing: boolean;
+    /** 显示属性面板 */
+    showPropertyPanel: boolean;
+    /** 属性面板是否被双击锁定打开 */
+    isPropertyPanelPinned: boolean;
+    /** 工具栏方向 */
+    toolbarOrientation: 'vertical' | 'horizontal';
+    /** 工具栏自定义位置 */
+    toolbarPosition: {
+        x: number;
+        y: number;
+    } | null;
+    /** 工具栏是否正在拖拽 */
+    isToolbarDragging: boolean;
+    /** 选中绘图的样式快照（用于属性面板编辑） */
+    selectedStyle: DrawingStyleConfig | null;
+    /** 绘图工具栏是否展开 */
+    drawingToolbarOpen: boolean;
+    /** 每分类的展开状态 */
+    expandedCategory: DrawingToolCategory | null;
+    /** 每分类当前选中的工具（用于显示分类行的 icon） */
+    categoryActiveTools: Partial<Record<DrawingToolCategory, DrawingToolType>>;
+    /** ★ V2: 当前绘图目标 pane index（0 = 主图） */
+    currentPaneIndex: number;
+    setActiveTool: (tool: DrawingToolType) => void;
+    setDrawingCount: (count: number) => void;
+    selectDrawing: (id: string | null, style?: DrawingStyleConfig | null, type?: string | null) => void;
+    setMagnetEnabled: (enabled: boolean) => void;
+    setIsDrawing: (drawing: boolean) => void;
+    setShowPropertyPanel: (show: boolean) => void;
+    setIsPropertyPanelPinned: (pinned: boolean) => void;
+    setToolbarOrientation: (o: 'vertical' | 'horizontal') => void;
+    setToolbarPosition: (pos: {
+        x: number;
+        y: number;
+    } | null) => void;
+    setIsToolbarDragging: (dragging: boolean) => void;
+    setSelectedStyle: (style: DrawingStyleConfig | null) => void;
+    setDrawingToolbarOpen: (open: boolean) => void;
+    /** 设置展开的分类 */
+    setExpandedCategory: (category: DrawingToolCategory | null) => void;
+    /** 设置分类当前工具 */
+    setCategoryActiveTool: (category: DrawingToolCategory, tool: DrawingToolType) => void;
+    /** ★ V2: 设置当前 pane index */
+    setCurrentPaneIndex: (index: number) => void;
+    clearAll: () => void;
+}
+
+/** 绘图样式（与库的 DrawingStyle 对齐） */
+declare interface DrawingStyleConfig {
+    lineColor: string;
+    lineWidth: number;
+    lineDash?: number[];
+    fillColor?: string;
+    fillOpacity?: number;
+    showLabels?: boolean;
+    labelFont?: string;
+    labelColor?: string;
+    /** 附加文字标签 */
+    text?: string;
+    /** 线条样式名称 */
+    lineStyle?: string;
+    /** 斐波那契比例线 */
+    fibRatios?: string;
+    /** ★ Req3：斐波那契级别（序列化为 JSON 字符串便于存储） */
+    fibLevels?: string;
+}
+
+/** 绘图工具分类 */
+declare enum DrawingToolCategory {
+    Lines = "line",
+    Channels = "channel",
+    Fibonacci = "fibonacci",
+    Shapes = "shape",
+    Annotations = "annotation",
+    Positions = "trading",
+    Measure = "measurement",
+    Patterns = "pattern",
+    VolumeProfile = "volume-profile"
+}
+
+/** 绘图工具配置 */
+declare interface DrawingToolConfig {
+    type: DrawingToolType;
+    label: string;
+    icon: string;
+    category: DrawingToolCategory;
+    anchorCount: number;
+    priority: number;
+}
+
+/** 绘图工具类型 - 映射到 lightweight-charts-drawing 的 tool type strings */
+declare type DrawingToolType = 'cursor' | 'trend-line' | 'horizontal-line' | 'vertical-line' | 'ray' | 'rectangle' | 'fib-retracement' | 'path' | 'parallel-channel' | 'circle' | 'ellipse' | 'triangle' | 'fib-extension' | 'arrow' | 'brush' | 'cross-line' | 'callout' | 'long-position' | 'short-position' | 'fib-fan' | 'date-price-range' | 'fib-circles' | 'fib-time-zone' | 'rotated-rectangle' | 'pattern-abcd' | 'pattern-xabcd' | 'pattern-head-shoulders' | 'pattern-triangle' | 'pattern-cypher' | 'info-line' | 'extended-line' | 'trend-angle' | 'horizontal-ray' | 'regression-trend' | 'flat-top-bottom' | 'disjoint-channel' | 'andrews-pitchfork' | 'schiff-pitchfork' | 'modified-schiff-pitchfork' | 'inside-pitchfork' | 'fib-channel' | 'fib-time-extension' | 'fib-spiral' | 'fib-arcs' | 'fib-wedge' | 'pitchfan' | 'gann-box' | 'gann-fan' | 'gann-square-fixed' | 'gann-square' | 'forecast' | 'bars-pattern' | 'projection' | 'price-range' | 'date-range' | 'polyline' | 'curve' | 'double-curve' | 'arc' | 'polygon' | 'text' | 'text-annotation' | 'anchored-text' | 'note' | 'price-note' | 'price-label' | 'flag-mark' | 'pin' | 'comment' | 'signpost' | 'table' | 'highlighter' | 'arrow-marker' | 'arrow-mark-up' | 'arrow-mark-down' | 'volume-profile';
+
+/** 事件处理器类型 */
+export declare type EventHandler<T = unknown> = (data: T) => void;
+
+/**
+ * 泛型事件总线
+ * 用于图表各模块间的解耦通信
+ */
+export declare class EventManager {
+    private listeners;
+    /** 注册事件监听 */
+    on<T = unknown>(event: string, handler: EventHandler<T>): () => void;
+    /** 取消事件监听 */
+    off<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /** 触发事件 */
+    emit<T = unknown>(event: string, data?: T): void;
+    /** 清除所有监听 */
+    clear(): void;
+}
+
+/** 数据获取回调函数类型 */
+export declare type FetchFn = (params: ChartRequestParams) => Promise<unknown>;
+
+/** 获取工具配置 */
+export declare function getToolConfig(type: DrawingToolType): DrawingToolConfig | undefined;
+
+/** 获取按分类分组的工具 */
+export declare function getToolsByCategory(): Map<DrawingToolCategory, DrawingToolConfig[]>;
+
+/** 获取按优先级分组的工具 */
+export declare function getToolsByPriority(priority: number): DrawingToolConfig[];
+
+/** LWC 成交量数据 */
+export declare interface HistogramData {
+    time: number;
+    value: number;
+    color?: string;
+}
+
+/** 空心蜡烛图数据 */
+export declare interface HollowCandlestickData extends CustomData {
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+}
+
+/** 空心蜡烛图 PaneView */
+export declare class HollowCandlestickSeries implements ICustomSeriesPaneView<unknown, HollowCandlestickData, CustomSeriesOptions> {
+    private _renderer;
+    defaultOptions(): CustomSeriesOptions;
+    renderer(): ICustomSeriesPaneRenderer;
+    update(data: PaneRendererCustomData<unknown, HollowCandlestickData>, _seriesOptions: CustomSeriesOptions): void;
+    priceValueBuilder(plotRow: HollowCandlestickData): CustomSeriesPricePlotValues;
+    isWhitespace(data: HollowCandlestickData | CustomSeriesWhitespaceData<unknown>): data is CustomSeriesWhitespaceData<unknown>;
+}
+
+/** 活跃指标配置 */
+export declare interface IndicatorConfig {
+    id: string;
+    name: string;
+    label: string;
+    type: IndicatorType;
+    params: Record<string, number>;
+    visible: boolean;
+    color?: string;
+    seriesIds: string[];
+    paneIndex?: number;
+}
+
+/** 单条指标数据 */
+export declare interface IndicatorDataPoint {
+    time: number;
+    values: Record<string, number>;
+}
+
+/** 指标数据响应（API返回） */
+export declare interface IndicatorDataResponse {
+    name: string;
+    params: Record<string, number>;
+    data: IndicatorDataPoint[];
+}
+
+/** 指标定义（注册表） */
+export declare interface IndicatorDefinition {
+    name: string;
+    label: string;
+    type: IndicatorType;
+    defaultParams: Record<string, number>;
+    paramDefs: IndicatorParamDef[];
+    description: string;
+    colors: string[];
+}
+
+/**
+ * 指标显示类型（v2新架构）
+ */
+declare enum IndicatorDisplayType {
+    /** 主图叠加（如MA、EMA、BOLL） */
+    Overlay = "overlay",
+    /** 主图背景（如成交量Volume） */
+    Background = "background",
+    /** 副图指标（如MACD、RSI、KDJ） */
+    Pane = "pane"
+}
+
+/**
+ * 单条指标线定义（v2新架构）
+ * 一个指标（如MACD）可能包含多条线（DIF、DEA、MACD柱）
+ */
+declare interface IndicatorLineDef {
+    /** 线的唯一key（如 'dif', 'dea', 'macd'） */
+    key: string;
+    /** 显示名称（如 'DIF'） */
+    label: string;
+    /** 该线的数据在data二维数组的每行中的列索引 */
+    dataIndex: number;
+    /** 渲染类型 */
+    renderType: 'line' | 'histogram' | 'area';
+    /** 默认颜色 */
+    color: string;
+    /** 线宽（默认1） */
+    lineWidth?: number;
+}
+
+/** 指标线条渲染定义 */
+declare interface IndicatorLineSpec {
+    /** 数据字段名（对应 indicatorData 中的 key） */
+    field: string;
+    /** 显示名称 */
+    label: string;
+    /** 渲染类型 */
+    type: 'line' | 'histogram' | 'area';
+    /** 颜色 */
+    color: string;
+    /** 线宽（默认1） */
+    lineWidth?: number;
+    /** 柱状图正值颜色（仅 histogram） */
+    positiveColor?: string;
+    /** 柱状图负值颜色（仅 histogram） */
+    negativeColor?: string;
+}
+
+/**
+ * 后端返回的指标列表响应
+ */
+declare interface IndicatorListResponse {
+    /** 可用指标列表 */
+    indicators: IndicatorTemplate[];
+    /** 用户已添加的指标（上次会话状态） */
+    activeIndicators?: ActiveIndicatorConfig[];
+    /** 指标分类列表（用于面板分类筛选） */
+    categories?: string[];
+}
+
+declare interface IndicatorModalProps {
+    open: boolean;
+    onClose: () => void;
+}
+
+/** 指标面板 — 现在渲染 IndicatorModal */
+export declare function IndicatorPanel(props: IndicatorPanelProps): JSX_2.Element;
+
+/** 向后兼容别名 */
+export declare type IndicatorPanelProps = IndicatorModalProps;
+
+/** 指标参数定义 */
+export declare interface IndicatorParamDef {
+    name: string;
+    label: string;
+    defaultValue: number;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+
+/** 指标数据（API返回） */
+export declare interface IndicatorRawData {
+    time: number;
+    value: number;
+}
+
+/**
+ * IndicatorRenderer - 指标渲染器
+ * 统一管理指标的渲染和移除
+ *
+ * 双模式架构：
+ * - 有 renderSpec → AutoIndicatorRenderer（数据驱动，零硬编码）
+ * - 无 renderSpec → switch-case fallback（兼容旧模式）
+ *
+ * 重构：副图指标使用LWC v5原生pane系统，不再使用PaneChartPanel
+ */
+export declare class IndicatorRenderer {
+    private chart;
+    private seriesManager;
+    /** indicatorConfig.id → series引用列表 */
+    private renderedSeries;
+    /** 副图pane索引分配器（0是主图，从1开始） */
+    private nextPaneIndex;
+    /** indicatorConfig.id → paneIndex 映射 */
+    private indicatorPaneMap;
+    /** ★ V2 新增：paneIndex → 主series 引用（副图的代表性series） */
+    private paneSeriesMap;
+    /** ★ 任务3-2.3：自动渲染引擎（数据驱动模式） */
+    private autoRenderer;
+    /** ★ 任务3-2.3：使用 AutoRenderer 渲染的 spec key 集合 */
+    private autoRenderedKeys;
+    setChart(chart: IChartApi): void;
+    setSeriesManager(sm: SeriesManager): void;
+    /**
+     * @deprecated 不再需要独立的paneChart，副图使用LWC v5原生pane
+     */
+    setPaneChart(_chart: IChartApi): void;
+    /**
+     * 渲染指标（双模式）
+     * - 有 config.renderSpec → 使用 AutoIndicatorRenderer（数据驱动）
+     * - 无 spec → fallback 到 switch-case
+     * @returns 渲染后创建的 seriesIds
+     */
+    renderIndicator(config: IndicatorConfig & {
+        renderSpec?: IndicatorRenderSpec;
+    }, data: IndicatorDataPoint[]): string[];
+    /**
+     * 分配pane索引（同一指标复用同一pane）
+     */
+    private allocPaneIndex;
+    /**
+     * ★ V5 需求3：设置pane拉伸比例（使用 LWC v5 setStretchFactor）
+     * 主图保持大比例，副图保持小比例，确保时间轴有空间
+     */
+    private setPaneHeight;
+    /**
+     * 更新指标（移除旧的，重新渲染）
+     */
+    updateIndicator(config: IndicatorConfig, data: IndicatorDataPoint[]): string[];
+    /**
+     * 移除指标
+     */
+    removeIndicator(indicatorId: string): void;
+    /**
+     * 获取已渲染的指标ID列表
+     */
+    getRenderedIndicatorIds(): string[];
+    /**
+     * 清理所有渲染的指标
+     */
+    clearAll(): void;
+    /**
+     * ★ V2: 获取指定 pane 的代表 series
+     */
+    getPaneSeries(paneIndex: number): ISeriesApi<any> | null;
+    /**
+     * ★ V2: 根据 series 反查 paneIndex
+     */
+    getPaneIndexBySeries(series: ISeriesApi<any>): number;
+    /**
+     * ★ V5 需求1: 根据指标ID获取 paneIndex
+     */
+    getPaneIndexByIndicatorId(indicatorId: string): number;
+    /**
+     * ★ V2: 获取所有已注册的 pane 信息
+     */
+    getRegisteredPanes(): Array<{
+        paneIndex: number;
+        hasSeries: boolean;
+    }>;
+}
+
+/** 指标渲染描述（后端返回，前端自动渲染） */
+declare interface IndicatorRenderSpec {
+    /** 指标唯一key */
+    key: string;
+    /** 显示名称 */
+    label: string;
+    /** 渲染位置 */
+    placement: 'overlay' | 'pane';
+    /** 副图高度比例（仅pane，默认0.2） */
+    paneHeightRatio?: number;
+    /** 线条定义 */
+    lines: IndicatorLineSpec[];
+}
+
+/** 指标搜索查询参数 */
+declare interface IndicatorSearchQuery {
+    keyword?: string;
+    category?: string;
+    displayType?: 'overlay' | 'pane';
+}
+
+export declare interface IndicatorState {
+    /** 当前活跃的指标 */
+    activeIndicators: IndicatorConfig[];
+    /** 可用指标列表 */
+    availableIndicators: IndicatorDefinition[];
+    /** 指标数据缓存 name → data */
+    indicatorDataCache: Record<string, IndicatorDataResponse>;
+    /** 添加指标 */
+    addIndicator: (config: IndicatorConfig) => void;
+    /** 移除指标 */
+    removeIndicator: (id: string) => void;
+    /** 切换指标可见性 */
+    toggleIndicator: (id: string) => void;
+    /** 更新指标参数 */
+    updateIndicatorParams: (id: string, params: Record<string, number>) => void;
+    /** 设置指标数据 */
+    setIndicatorData: (name: string, data: IndicatorDataResponse) => void;
+    /** 清理所有 */
+    clearAll: () => void;
+}
+
+/** 指标标签 - 显示指标名+当前值+配置按钮 */
+export declare function IndicatorTag({ config }: IndicatorTagProps): JSX_2.Element;
+
+export declare interface IndicatorTagProps {
+    config: IndicatorConfig;
+}
+
+/**
+ * 后端返回的指标列表项模板
+ */
+declare interface IndicatorTemplate {
+    /** 指标唯一标识 */
+    key: string;
+    /** 显示名称 */
+    label: string;
+    /** 简短描述 */
+    description: string;
+    /** 显示类型 */
+    displayType: IndicatorDisplayType;
+    /** 分类（如 '趋势', '震荡', '成交量', '通道'） */
+    category: string;
+    /** 默认参数 */
+    defaultParams: Record<string, number>;
+    /** 参数定义（用户可调整） */
+    paramDefs: IndicatorParamDef[];
+    /** 包含的线条定义 */
+    lines: IndicatorLineDef[];
+    /** 默认副图高度比例（仅pane类型） */
+    paneHeightRatio?: number;
+    /** 是否内置（vs自定义） */
+    builtin: boolean;
+    /** 图标（emoji或CSS class） */
+    icon?: string;
+    /** 排序权重 */
+    sortOrder?: number;
+}
+
+/** 指标显示类型 */
+export declare enum IndicatorType {
+    Overlay = "overlay",// 主图叠加
+    Pane = "pane"
+}
+
+/** K线回放引擎 */
+export declare class KlineReplay {
+    private allData;
+    private currentIndex;
+    private timerId;
+    private speed;
+    private series;
+    private onProgress;
+    /** 绑定序列 */
+    attach(series: ISeriesApi<SeriesType_2>): void;
+    /** 设置进度回调 */
+    setOnProgress(cb: (current: number, total: number) => void): void;
+    /** 加载全部K线数据（回放前调用） */
+    load(data: any[]): void;
+    /** 开始回放：从第一根开始逐根播放 */
+    play(): void;
+    /** 暂停回放 */
+    pause(): void;
+    /** 继续回放 */
+    resume(): void;
+    /** 停止回放并恢复全部数据 */
+    stop(): void;
+    /** 手动步进到下一根 */
+    next(): void;
+    /** 手动步进到上一根 */
+    prev(): void;
+    /** 跳转到指定索引位置 */
+    goto(index: number): void;
+    /** 设置播放速度 */
+    setSpeed(ms: number): void;
+    /** 获取当前进度 */
+    getProgress(): {
+        current: number;
+        total: number;
+    };
+    /** 是否正在播放 */
+    get isPlaying(): boolean;
+    /** 销毁，清理定时器 */
+    dispose(): void;
+    private startTimer;
+    private clearTimer;
+    private emitProgress;
+}
+
+/** K线回放选项 */
+export declare interface KlineReplayOptions {
+    /** 每根K线的间隔时间(ms)，默认 1000 */
+    speed: number;
+}
+
+export declare function KlineTypeSelector({ activeType }: KlineTypeSelectorProps): JSX_2.Element;
+
+declare interface KlineTypeSelectorProps {
+    activeType: SeriesType;
+}
+
+/** 布局模式：单图、水平双屏、垂直双屏、四分屏 */
+export declare type LayoutMode = '1' | '2h' | '2v' | '4';
+
+export declare function LayoutSwitcher({ currentMode, onModeChange }: LayoutSwitcherProps): JSX_2.Element;
+
+export declare interface LayoutSwitcherProps {
+    currentMode?: LayoutMode;
+    onModeChange?: (mode: LayoutMode) => void;
+}
+
+export declare const lightPreset: ThemeConfig;
+
+/** LWC 线数据 */
+export declare interface LineData {
+    time: number;
+    value: number;
+}
+
+/**
+ * 从库的 tool type 映射回我们的 DrawingToolType
+ */
+export declare function mapLibTypeToOurs(libType: string): DrawingToolType | null;
+
+/**
+ * 工具类型映射：将我们的 DrawingToolType 映射到库的 tool type string
+ * 注意：fib-fan 在库中是 fib-speed-fan
+ */
+export declare function mapToolTypeToLib(type: DrawingToolType): string | null;
+
+export declare const MARKET_PRESETS: Record<string, Partial<MockDataConfig>>;
+
+/** 行情趋势类型 */
+export declare type MarketTrend = 'up' | 'down' | 'side' | 'v-reverse' | 'random';
+
+/** Mock数据生成配置 */
+export declare interface MockDataConfig {
+    period: string;
+    count: number;
+    startPrice: number;
+    trend: MarketTrend;
+    volatility: number;
+    volumeRange: [number, number];
+}
+
+export declare class MockDataService {
+    /**
+     * 生成K线数据
+     * 基于几何布朗运动模型（GBM）
+     */
+    static generateCandlesticks(config: MockDataConfig): CandlestickRawData[];
+    private static getTrendFactor;
+    static generateBullMarket(count?: number): CandlestickRawData[];
+    static generateBearMarket(count?: number): CandlestickRawData[];
+    static generateSideways(count?: number): CandlestickRawData[];
+    static generateVShape(count?: number): CandlestickRawData[];
+    static generateRandom(count?: number): CandlestickRawData[];
+    /**
+     * 创建可作为QLChartProvider.fetchFn使用的Mock函数
+     * 这是连接Mock数据与QLChart组件的桥梁
+     */
+    static createMockFetchFn(defaultConfig?: Partial<MockDataConfig>): FetchFn;
+}
+
+export declare interface MockIndicatorConfig {
+    name: string;
+    count: number;
+    baseTime?: number;
+    interval?: number;
+}
+
+export declare class MockIndicatorService {
+    static generate(config: MockIndicatorConfig): IndicatorDataPoint[];
+    static generateMultiple(names: string[], count: number, baseTime?: number, interval?: number): Record<string, IndicatorDataPoint[]>;
+}
+
+/**
+ * OverlayIndicator - 主图叠加指标渲染
+ * MA, EMA, BOLL 等
+ */
+export declare class OverlayIndicator {
+    /**
+     * 渲染 MA 指标
+     * @returns seriesId[]
+     */
+    static renderMA(seriesManager: SeriesManager, data: IndicatorDataPoint[], color?: string): string[];
+    /**
+     * 渲染 EMA 指标
+     */
+    static renderEMA(seriesManager: SeriesManager, data: IndicatorDataPoint[], color?: string): string[];
+    /**
+     * 渲染 BOLL 布林带（3条线）
+     */
+    static renderBOLL(seriesManager: SeriesManager, data: IndicatorDataPoint[], colors?: string[]): string[];
+}
+
+export declare const PAIR_PRESETS: Record<string, Partial<MockDataConfig>>;
+
+/** 交易对信息 */
+export declare interface PairInfo {
+    pairId: string;
+    product: string;
+    name: string;
+    decimals: number;
+}
+
+/**
+ * PaneIndicator - 副图指标渲染（LWC v5原生pane系统）
+ *
+ * 使用 chart.addSeries(def, options, paneIndex) 将series添加到指定pane
+ * 不再需要独立的PaneChartPanel
+ */
+export declare class PaneIndicator {
+    /**
+     * 在指定pane中渲染指标线
+     * @returns 创建的series引用列表
+     */
+    static render(chart: IChartApi, paneIndex: number, lines: PaneLineData[], priceScaleId?: string): Array<{
+        id: string;
+        series: ISeriesApi<any>;
+    }>;
+    /**
+     * 渲染 MACD（2条线 + 1个柱状图）
+     */
+    static renderMACD(chart: IChartApi, paneIndex: number, data: Array<{
+        time: UTCTimestamp;
+        value: number;
+    }>[], colors?: string[]): Array<{
+        id: string;
+        series: ISeriesApi<any>;
+    }>;
+    /**
+     * 渲染 RSI
+     */
+    static renderRSI(chart: IChartApi, paneIndex: number, data: Array<{
+        time: UTCTimestamp;
+        value: number;
+    }>, color?: string): Array<{
+        id: string;
+        series: ISeriesApi<any>;
+    }>;
+    /**
+     * 渲染 KDJ（3条线）
+     */
+    static renderKDJ(chart: IChartApi, paneIndex: number, data: Array<{
+        time: UTCTimestamp;
+        value: number;
+    }>[], colors?: string[]): Array<{
+        id: string;
+        series: ISeriesApi<any>;
+    }>;
+    /**
+     * 渲染 CCI
+     */
+    static renderCCI(chart: IChartApi, paneIndex: number, data: Array<{
+        time: UTCTimestamp;
+        value: number;
+    }>, color?: string): Array<{
+        id: string;
+        series: ISeriesApi<any>;
+    }>;
+}
+
+/** 面板信息 */
+export declare interface PaneInfo {
+    index: number;
+    heightPercent: number;
+    seriesIds: string[];
+    label: string;
+}
+
+/** 面板配置 */
+export declare interface PanelConfig {
+    id: string;
+    pairId: string;
+    product: string;
+    period: string;
+    seriesType: SeriesType;
+    showToolbar: boolean;
+    weight?: number;
+}
+
+/** 副图指标线数据 */
+declare interface PaneLineData {
+    key: string;
+    label: string;
+    data: Array<{
+        time: UTCTimestamp;
+        value: number;
+    }>;
+    renderType: 'line' | 'histogram' | 'area';
+    color: string;
+    lineWidth?: number;
+}
+
+/**
+ * 多面板管理器
+ * 管理 LWC v5 的 pane 系统，用于副图指标
+ */
+export declare class PaneManager {
+    private chart;
+    private eventManager;
+    private panes;
+    private nextPaneIndex;
+    constructor(eventManager: EventManager);
+    /** 设置图表实例 */
+    setChart(chart: IChartApi): void;
+    /** 获取主图 pane 信息 */
+    getMainPane(): PaneInfo;
+    /**
+     * 添加成交量叠加层
+     * 在主图底部用 HistogramSeries + priceScaleMargins 实现
+     */
+    addVolumeOverlay(heightPercent?: number): ISeriesApi<SeriesType_2> | null;
+    /**
+     * 添加指标面板（副图）
+     * 使用独立的 priceScaleId 创建新 pane
+     */
+    addIndicatorPane(indicatorName: string, heightPercent?: number): string;
+    /** 移除面板 */
+    removePane(paneIndex: number): void;
+    /** 设置面板高度 */
+    setPaneHeight(paneIndex: number, heightPercent: number): void;
+    /** 获取所有面板 */
+    getPanes(): PaneInfo[];
+    /** 根据 priceScaleId 获取面板信息 */
+    getPaneByIndex(index: number): PaneInfo | undefined;
+    /** 清理所有面板 */
+    dispose(): void;
+}
+
+export declare function PeriodSelector({ activePeriod }: PeriodSelectorProps): JSX_2.Element;
+
+declare interface PeriodSelectorProps {
+    activePeriod: string;
+}
+
+/** 持久化配置 */
+export declare interface PersistenceConfig {
+    /** 交易对ID（核心标识） */
+    pairId: string;
+    /** 产品类型 */
+    product: string;
+    /** 周期（保留用于UI层，不参与持久化key） */
+    period?: string;
+    /** 图表实例ID（保留用于内部标识，不参与持久化key） */
+    chartId?: string;
+    /** API基础URL，有值则使用远程模式 */
+    apiBaseUrl?: string;
+}
+
+/** QLChart 配置 */
+export declare interface QLChartConfig {
+    /** API基础URL */
+    apiBaseUrl?: string;
+    /** 默认主题 */
+    defaultTheme?: ThemePreset;
+    /** 默认周期 */
+    defaultPeriod?: string;
+    /** 默认序列类型 */
+    defaultSeriesType?: SeriesType;
+    /** 数据获取函数 */
+    fetchFn?: (params: Record<string, unknown>) => Promise<unknown>;
+    /** ★ Req1：是否启用数据缓存（默认true） */
+    cacheEnabled?: boolean;
+    /** ★ Req1：缓存TTL（毫秒，默认300000 = 5分钟） */
+    cacheTTL?: number;
+    /** ★ Req1：实时数据订阅（WebSocket场景） */
+    realtimeSubscribe?: RealtimeSubscribeFn;
+    /** 指标列表查询函数（注入式，未注入时 fallback 到 BUILTIN_INDICATORS） */
+    indicatorListFn?: () => Promise<IndicatorListResponse>;
+    /** 指标搜索函数（注入式，用于指标面板搜索） */
+    indicatorSearchFn?: (query: IndicatorSearchQuery) => Promise<IndicatorTemplate[]>;
+}
+
+export declare function QLChartLayout({ mode: modeProp, panels: panelsProp, crosshairSync, onLayoutChange, }: QLChartLayoutProps): JSX_2.Element;
+
+export declare interface QLChartLayoutProps {
+    /** 布局模式 */
+    mode?: LayoutMode;
+    /** 面板配置 */
+    panels?: PanelConfig[];
+    /** 是否开启光标联动 */
+    crosshairSync?: boolean;
+    /** 布局变化回调 */
+    onLayoutChange?: (mode: LayoutMode) => void;
+}
+
+export declare const QLChartPanel: ForwardRefExoticComponent<QLChartPanelProps & RefAttributes<QLChartPanelRef>>;
+
+export declare interface QLChartPanelProps {
+    pairId: string;
+    product: string;
+    period?: string;
+    seriesType?: SeriesType;
+    showToolbar?: boolean;
+    panelId?: string;
+    panelIndex?: number;
+    onChartCreated?: (chart: IChartApi | null, index: number) => void;
+    /** chart 和 series 就绪回调 */
+    onChartReady?: (chart: IChartApi | null, mainSeries: ISeriesApi<SeriesType_2> | null) => void;
+    /** 是否为单面板模式（控制绘图UI渲染位置） */
+    isSinglePanel?: boolean;
+}
+
+/** ★ Req1：QLChartPanel 暴露的命令式API */
+export declare interface QLChartPanelRef {
+    /** 推送实时K线数据（增量更新） */
+    pushRealtimeData: (data: RealtimeCandle) => void;
+    /** 批量推送实时数据 */
+    pushRealtimeBatch: (datas: RealtimeCandle[]) => void;
+    /** 重载数据 */
+    reload: () => void;
+    /** 获取chart实例 */
+    getChart: () => IChartApi | null;
+    /** 获取主序列 */
+    getMainSeries: () => ISeriesApi<SeriesType_2> | null;
+    /** 清除缓存 */
+    clearCache: () => void;
+}
+
+/** 配置Provider
+ *
+ * 支持两种使用方式：
+ * 1. 散装属性（推荐）：`<QLChartProvider fetchFn={fn} cacheEnabled />`
+ * 2. config对象（向后兼容）：`<QLChartProvider config={{ fetchFn: fn }} />`
+ */
+export declare function QLChartProvider({ config, children, ...restProps }: {
+    config?: QLChartConfig;
+    children: ReactNode;
+} & Partial<QLChartConfig>): JSX_2.Element;
+
+export declare function QLToolbar({ period, seriesType, theme, chartManager, chartRef, containerRef }: QLToolbarProps): JSX_2.Element;
+
+export declare interface QLToolbarProps {
+    period: string;
+    seriesType: SeriesType;
+    theme: ThemePreset;
+    chartManager?: {
+        getChart: () => any;
+    } | null;
+    chartRef?: React.RefObject<any>;
+    containerRef?: React.RefObject<HTMLElement>;
+}
+
+/**
+ * 实时K线数据格式（秒级时间戳，与LWC对齐）
+ */
+export declare interface RealtimeCandle {
+    /** K线时间戳（秒级，与LWC一致） */
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume?: number;
+}
+
+/** ★ Req1：实时K线数据格式（秒级时间戳，与LWC一致） */
+declare interface RealtimeCandle_2 {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume?: number;
+}
+
+/**
+ * 实时数据馈送管理器
+ *
+ * 接收外部推送的增量K线数据，通过 LWC 的 series.update() 实时更新图表。
+ *
+ * LWC update() 自动判断：
+ * - time === 最新K线time → 更新该K线
+ * - time > 最新K线time → 追加新K线
+ * - time < 最新K线time → 忽略
+ */
+export declare class RealtimeDataFeed {
+    private mainSeries;
+    private volumeSeries;
+    private lastTime;
+    /**
+     * 绑定到图表序列
+     */
+    attach(mainSeries: ISeriesApi<SeriesType_2>, volumeSeries?: ISeriesApi<SeriesType_2> | null): void;
+    /**
+     * 解绑
+     */
+    detach(): void;
+    /**
+     * 推送单条增量数据
+     */
+    push(data: RealtimeCandle): void;
+    /**
+     * 批量推送
+     */
+    pushBatch(datas: RealtimeCandle[]): void;
+    /**
+     * 获取最后推送的time
+     */
+    getLastTime(): number;
+    /**
+     * 更新绑定的series引用（chart重建后调用）
+     */
+    updateSeries(mainSeries: ISeriesApi<SeriesType_2>, volumeSeries?: ISeriesApi<SeriesType_2> | null): void;
+}
+
+/** ★ Req1：实时数据订阅函数 */
+export declare interface RealtimeSubscribeFn {
+    (params: {
+        pairId: string;
+        product: string;
+        period: string;
+        onUpdate: (data: RealtimeCandle_2) => void;
+    }): (() => void) | void;
+}
+
+/** 砖形图数据（后端提供） */
+export declare interface RenkoData extends CustomData {
+    /** 砖块开盘价 */
+    open: number;
+    /** 砖块收盘价 */
+    close: number;
+    /** 方向 */
+    type: 'up' | 'down';
+}
+
+/** 砖形图 PaneView */
+export declare class RenkoSeries implements ICustomSeriesPaneView<unknown, RenkoData, CustomSeriesOptions> {
+    private _renderer;
+    defaultOptions(): CustomSeriesOptions;
+    renderer(): ICustomSeriesPaneRenderer;
+    update(data: PaneRendererCustomData<unknown, RenkoData>, _seriesOptions: CustomSeriesOptions): void;
+    priceValueBuilder(plotRow: RenkoData): CustomSeriesPricePlotValues;
+    isWhitespace(data: RenkoData | CustomSeriesWhitespaceData<unknown>): data is CustomSeriesWhitespaceData<unknown>;
+}
+
+export declare function ReplayController({ replay }: ReplayControllerProps): JSX_2.Element | null;
+
+export declare interface ReplayControllerProps {
+    replay: KlineReplay | null;
+}
+
+export declare interface ReplayState {
+    /** 是否处于回放模式 */
+    isReplayMode: boolean;
+    /** 是否正在播放 */
+    isPlaying: boolean;
+    /** 播放速度 ms/根 */
+    speed: number;
+    /** 进度 */
+    progress: {
+        current: number;
+        total: number;
+    };
+    /** 进入回放模式 */
+    enterReplay: () => void;
+    /** 退出回放模式 */
+    exitReplay: () => void;
+    /** 设置播放状态 */
+    setPlaying: (playing: boolean) => void;
+    /** 设置速度 */
+    setSpeed: (ms: number) => void;
+    /** 设置进度 */
+    setProgress: (current: number, total: number) => void;
+}
+
+/**
+ * 截图导出工具
+ * 从 lightweight-charts v5 的 DOM 容器中获取 canvas 并导出
+ */
+export declare class ScreenshotUtil {
+    /**
+     * 从 chart 实例获取 canvas 元素
+     * lightweight-charts v5 没有 takeScreenshot()，需要从 DOM 获取
+     */
+    private static getChartCanvas;
+    /**
+     * 从 chart 容器 DOM 获取所有 canvas 并合并
+     */
+    private static getCanvasFromContainer;
+    /**
+     * 截取图表为 PNG base64 data URL
+     */
+    static toPng(chart: IChartApi, container?: HTMLElement): string;
+    /**
+     * 截取并下载为 PNG 文件
+     */
+    static download(chart: IChartApi, container?: HTMLElement, filename?: string): void;
+    /**
+     * 截取并复制到剪贴板
+     */
+    static copyToClipboard(chart: IChartApi, container?: HTMLElement): Promise<boolean>;
+}
+
+/**
+ * 序列管理器
+ * 管理图表上所有的序列（K线、指标、成交量等）
+ */
+export declare class SeriesManager {
+    private seriesMap;
+    private chart;
+    private eventManager;
+    constructor(chart: IChartApi, eventManager: EventManager);
+    /** 更新chart实例（chart重建时调用） */
+    setChart(chart: IChartApi): void;
+    /** 添加主序列（K线等） */
+    addMainSeries(type: SeriesType, options?: Record<string, unknown>): ISeriesApi<SeriesType_2> | null;
+    /** 添加叠加序列（指标、成交量等） */
+    addOverlaySeries(type: SeriesType, options?: Record<string, unknown>, priceScaleId?: string): ISeriesApi<SeriesType_2> | null;
+    /** 设置序列数据 */
+    setData(seriesId: string, data: unknown[]): void;
+    /** 更新序列最新数据点 */
+    update(seriesId: string, data: unknown): void;
+    /** 移除序列 */
+    removeSeries(seriesId: string): void;
+    /** 切换序列类型 */
+    switchType(seriesId: string, newType: SeriesType, data?: unknown[]): string | null;
+    /** 获取序列 */
+    getSeries(seriesId: string): ISeriesApi<SeriesType_2> | undefined;
+    /** 获取第一个主序列（用于DrawingAdapter attach） */
+    getFirstMainSeries(): ISeriesApi<SeriesType_2> | null;
+    /** 获取第一个任何类型的序列 */
+    getFirstSeries(): ISeriesApi<SeriesType_2> | null;
+    /** 清除所有序列 */
+    clearAll(): void;
+    /** 添加叠加品种（对比模式） */
+    addComparisonSeries(type: SeriesType, data: any[], options?: Record<string, unknown>): string | null;
+    /** 移除所有对比序列 */
+    clearComparisonSeries(): void;
+}
+
+/** 序列类型枚举 */
+export declare enum SeriesType {
+    Candlestick = "candlestick",
+    Bar = "bar",
+    Line = "line",
+    Area = "area",
+    Baseline = "baseline",
+    Histogram = "histogram",
+    HollowCandlestick = "hollow-candlestick",
+    VolumeCandlestick = "volume-candlestick",
+    HeikinAshi = "heikin-ashi",
+    Renko = "renko",
+    LineBreak = "line-break"
+}
+
+/** 主题配置 */
+export declare interface ThemeConfig {
+    name: ThemePreset;
+    chart: ChartThemeOptions;
+    /** 涨色 */
+    upColor: string;
+    /** 跌色 */
+    downColor: string;
+    /** 工具栏背景色 */
+    toolbarBg: string;
+    /** 工具栏文字色 */
+    toolbarText: string;
+    /** 工具栏按钮激活色 */
+    toolbarActiveBg: string;
+}
+
+/**
+ * 主题管理器
+ * 管理图表主题的切换与配置
+ */
+export declare class ThemeManager {
+    private currentTheme;
+    private eventManager;
+    private presets;
+    constructor(eventManager: EventManager);
+    /** 设置主题 */
+    setTheme(theme: ThemePreset): void;
+    /** 获取当前主题名称 */
+    getCurrentTheme(): ThemePreset;
+    /** 获取当前主题配置 */
+    getCurrentConfig(): ThemeConfig;
+    /** 获取映射到LWC的图表选项 */
+    getChartOptions(theme?: ThemePreset): DeepPartial<ChartOptions_2>;
+    /** 获取涨色 */
+    getUpColor(): string;
+    /** 获取跌色 */
+    getDownColor(): string;
+    /** 注册自定义主题预设 */
+    registerPreset(name: ThemePreset, config: ThemeConfig): void;
+}
+
+/** 主题预设名称 */
+export declare type ThemePreset = 'dark' | 'light';
+
+/**
+ * 时间栏模块容器组件
+ *
+ * 通过 PanelRegistry 获取活跃面板的 chartManager，
+ * 不再依赖 props 传递。
+ */
+export declare function TimeBarModule({ variant, className, }: TimeBarModuleProps): JSX_2.Element;
+
+export declare interface TimeBarModuleProps {
+    /** 样式变体 */
+    variant?: 'toolbar' | 'standalone';
+    /** 自定义 className */
+    className?: string;
+}
+
+export declare interface TimeBarState {
+    /** 当前选中的快捷范围标签 */
+    activeRangeLabel: string | null;
+    /** 自定义起始日期 */
+    customStartDate: string;
+    /** 自定义结束日期 */
+    customEndDate: string;
+    /** 是否显示日期选择器 */
+    showDatePicker: boolean;
+    setActiveRangeLabel: (label: string | null) => void;
+    setCustomDateRange: (start: string, end: string) => void;
+    setShowDatePicker: (show: boolean) => void;
+    reset: () => void;
+}
+
+export declare function TimeRangeSelector({ chartManager }: TimeRangeSelectorProps): JSX_2.Element;
+
+declare interface TimeRangeSelectorProps {
+    chartManager?: {
+        getChart: () => any;
+    } | null;
+}
+
+/**
+ * 将API返回的K线原始数据转换为LWC CandlestickData[]
+ * 注意：time从毫秒转秒
+ */
+export declare function transformCandlestickData(apiData: CandlestickRawData[]): {
+    time: UTCTimestamp;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+}[];
+
+/**
+ * 将API返回的指标数据转换为LWC LineData[]
+ */
+export declare function transformIndicatorData(apiData: IndicatorRawData[]): {
+    time: UTCTimestamp;
+    value: number;
+}[];
+
+/**
+ * 将API返回的K线数据转换为LWC HistogramData[]（成交量）
+ * 涨绿跌红
+ */
+export declare function transformVolumeData(apiData: CandlestickRawData[]): {
+    time: UTCTimestamp;
+    value: number;
+    color: string;
+}[];
+
+/**
+ * 图表Hook
+ * 创建ChartManager + SeriesManager，管理生命周期
+ * 使用 useState 触发重渲染，确保下游 effects 能拿到非null的 managers
+ */
+export declare function useChart(): UseChartReturn;
+
+export declare interface UseChartReturn {
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    chartManager: ChartManager | null;
+    seriesManager: SeriesManager | null;
+}
+
+export declare const useChartStore: UseBoundStore<StoreApi<ChartState>>;
+
+/**
+ * 多图表光标十字线联动 Hook
+ * 监听每个 chart 的 crosshairMove 事件，同步到其他 chart
+ *
+ * 修复点：
+ * 1. setCrosshairPosition 第三参数从 IChartApi 改为 ISeriesApi（通过 PanelRegistry 获取）
+ * 2. 依赖数组增加 panelIds.join(',')，面板变化时重新订阅
+ */
+export declare function useCrosshairSync(chartRefs: RefObject<(IChartApi | null)[]>, panelIds?: string[]): void;
+
+export declare function useDrawingModule(options: UseDrawingModuleOptions): UseDrawingModuleReturn;
+
+export declare interface UseDrawingModuleOptions {
+    chartManager: ChartManager | null;
+    seriesManager: SeriesManager | null;
+    containerRef: React.RefObject<HTMLElement | null>;
+    pairId: string;
+    product: string;
+    period: string;
+    panelId?: string;
+    panelIndex?: number;
+    onChartCreated?: (chart: IChartApi | null, index: number) => void;
+    dataLoaded: boolean;
+    /** ★ V4: 指标渲染器 ref（用于副图绘图 pane 切换，实时读取避免闭包捕获） */
+    indicatorRendererRef?: React.RefObject<IndicatorRenderer | null>;
+}
+
+export declare interface UseDrawingModuleReturn {
+    drawingAdapterRef: React.RefObject<DrawingAdapter | null>;
+    recentTools: DrawingToolType[];
+    handleDrawingStyleChange: (id: string, style: Partial<DrawingStyleConfig>) => void;
+    handleDeleteDrawing: () => void;
+    handleContextMenuToolSelect: (tool: DrawingToolType) => void;
+}
+
+export declare const useDrawingStore: UseBoundStore<StoreApi<DrawingState>>;
+
+export declare const useIndicatorStore: UseBoundStore<StoreApi<IndicatorState>>;
+
+/** 获取配置 */
+export declare function useQLChartConfig(): QLChartConfig;
+
+export declare const useReplayStore: UseBoundStore<StoreApi<ReplayState>>;
+
+/**
+ * 主题Hook
+ */
+export declare function useTheme(): UseThemeReturn;
+
+export declare interface UseThemeReturn {
+    theme: 'dark' | 'light';
+    config: ThemeConfig;
+    toggleTheme: () => void;
+    setTheme: (theme: 'dark' | 'light') => void;
+}
+
+export declare const useTimeBarStore: UseBoundStore<StoreApi<TimeBarState>>;
+
+export { }