@363045841yyt/klinechart 0.7.0 → 0.7.3-alpha.0

package/dist/src/core/chart.d.ts

@@ -1,420 +0,0 @@
-import { KLineData } from '../types/price';
-import { ChartSettings } from '../config/chartSettings';
-import { VisibleRange, UpdateLevel } from './layout/pane';
-import { InteractionController } from './controller/interaction';
-import { PaneRenderer } from './paneRenderer';
-import { MarkerManager, CustomMarkerEntity } from './marker/registry';
-import { getPhysicalKLineConfig, calcKWidthPx } from './utils/klineConfig';
-import { IndicatorScheduler } from './indicators/scheduler';
-import { SubPaneEntry } from './subPaneManager';
-import { PluginHostImpl, RendererPlugin, RendererPluginWithHost, PaneRole, PaneCapabilities } from '../plugin';
-import { SubIndicatorType } from './renderers/Indicator';
-export { getPhysicalKLineConfig, calcKWidthPx };
-/**
- * 图表 DOM 元素引用
- * @property container 图表容器 div
- * @property canvasLayer Canvas 层容器 div（包含所有绘制 canvas）
- */
-/**
- * 图表 DOM 元素引用
- * @property container 图表容器 div
- * @property canvasLayer Canvas 层容器 div（包含所有绘制 canvas）
- * @property xAxisCanvas X 轴时间轴 canvas
- */
-export type ChartDom = {
-    container: HTMLDivElement;
-    canvasLayer: HTMLDivElement;
-    rightAxisLayer: HTMLDivElement;
-    xAxisCanvas: HTMLCanvasElement;
-};
-/**
- * Pane 面板配置
- * @property id Pane 标识符
- * @property ratio Pane 高度占比
- * @property visible 是否可见（默认 true）
- */
-export type PaneSpec = {
-    id: string;
-    ratio: number;
-    visible?: boolean;
-    minHeightPx?: number;
-    role?: PaneRole;
-    capabilities?: Partial<PaneCapabilities>;
-};
-export type PaneRendererDom = {
-    mainCanvas: HTMLCanvasElement;
-    overlayCanvas: HTMLCanvasElement;
-    yAxisCanvas: HTMLCanvasElement;
-};
-export type ChartOptions = {
-    /** K 线宽度（可选，由 zoomLevel 派生） */
-    kWidth?: number;
-    /** K 线间隙（可选，由 DPR 计算） */
-    kGap?: number;
-    yPaddingPx: number;
-    rightAxisWidth: number;
-    bottomAxisHeight: number;
-    minKWidth: number;
-    maxKWidth: number;
-    panes: PaneSpec[];
-    /** pane 之间的真实分隔空隙（逻辑像素） */
-    paneGap?: number;
-    /** 价格标签额外宽度（用于显示涨跌幅，默认 60px） */
-    priceLabelWidth?: number;
-    /** pane 最小高度（逻辑像素，默认 60） */
-    defaultPaneMinHeightPx?: number;
-    /**
-     * 缩放级别数量（默认 10）
-     * - 将 minKWidth ~ maxKWidth 划分为多少个离散级别
-     * - 例如 10 表示有 10 个缩放级别（1-10）
-     */
-    zoomLevels?: number;
-    /**
-     * 初始缩放级别（1 ~ zoomLevels，默认 1）
-     * 未指定时默认为最小级别
-     */
-    initialZoomLevel?: number;
-};
-/** K 线起始 x 坐标数组，positions[i] 表示第 i 根 K 线的起始 x 坐标（逻辑像素） */
-export type KLinePositions = number[];
-export type Viewport = {
-    viewWidth: number;
-    viewHeight: number;
-    plotWidth: number;
-    plotHeight: number;
-    scrollLeft: number;
-    dpr: number;
-};
-type ResolvedChartOptions = Omit<ChartOptions, 'kWidth' | 'kGap'> & {
-    kWidth: number;
-    kGap: number;
-};
-export declare class Chart {
-    private dom;
-    private opt;
-    private data;
-    private raf;
-    private pendingUpdateLevel;
-    private viewport;
-    private paneRenderers;
-    private markerManager;
-    private drawingStore;
-    readonly interaction: InteractionController;
-    /** 插件宿主 */
-    private pluginHost;
-    /** 渲染器插件管理器 */
-    private rendererPluginManager;
-    /** 精确 DPR（来自 ResizeObserver 的 devicePixelContentBoxSize） */
-    private preciseDpr;
-    /** 统一监听容器尺寸与 DPR 变化 */
-    private resizeObserver?;
-    /** scroll 事件处理器引用（用于 cleanup） */
-    private onScroll?;
-    /** 最近一次观测到的容器尺寸 */
-    private observedSize;
-    /** 缓存的 scrollLeft（通过 scroll 事件同步，避免每帧读取 DOM 触发强制回流） */
-    private cachedScrollLeft;
-    /** overlay 上一帧是否有十字线（用于判断何时需要清除） */
-    private overlayHadCrosshair;
-    /** 用户设置配置（传递给渲染器） */
-    private settings;
-    /** pane ratio 状态（按 paneId 维护，sum=1 仅对可见 pane） */
-    private paneRatios;
-    /** 视口变化回调（供外部同步 DPR/尺寸） */
-    private onViewportChange?;
-    /** 共享 X 轴上下文缓存 */
-    private xAxisCtx;
-    /** Chart 级共享 WebGL canvas/context */
-    private sharedWebGLSurface;
-    /** pane 布局回流回调（Chart -> UI 单向） */
-    private onPaneLayoutChange?;
-    /** 数据变化回调（供外部同步 dataLength） */
-    private onDataChange?;
-    /** 当前缩放级别（1 ~ zoomLevelCount） */
-    private currentZoomLevel;
-    /** 缩放级别总数 */
-    private readonly zoomLevelCount;
-    /** 指标调度器（负责计算 MA 等指标并写入 StateStore）
-     * TODO: 阶段5迁移为插件注册，Scheduler 通过事件监听 data/viewport 变更，Chart 不直接持有
-     */
-    private indicatorScheduler;
-    /** 上次可见范围（用于检测视口变化） */
-    private lastVisibleRange;
-    /** Overlay 帧复用的最近主渲染结果 */
-    private cachedDrawFrame;
-    /** 副图管理器 */
-    private subPaneManager;
-    /** 当前激活的主图指标列表（如 ['boll', 'ma']） */
-    private activeMainIndicators;
-    /** 主图指标参数配置 */
-    private mainIndicatorParams;
-    /**
-     * 启用主图指标
-     * @param indicatorId 指标ID
-     * @param params 可选的指标参数
-     * @returns 是否成功启用
-     */
-    enableMainIndicator(indicatorId: string, params?: Record<string, number | boolean | string>): boolean;
-    /**
-     * 禁用主图指标
-     * @param indicatorId 指标ID
-     * @returns 是否成功禁用
-     */
-    disableMainIndicator(indicatorId: string): boolean;
-    /**
-     * 切换主图指标启用状态
-     * @param indicatorId 指标ID
-     * @param enabled 是否启用
-     */
-    toggleMainIndicator(indicatorId: string, enabled: boolean): void;
-    /**
-     * 获取当前激活的主图指标列表
-     * @returns 激活的指标ID数组
-     */
-    getActiveMainIndicators(): string[];
-    /**
-     * 检查主图指标是否激活
-     * @param indicatorId 指标ID
-     */
-    isMainIndicatorActive(indicatorId: string): boolean;
-    /**
-     * 更新主图指标参数
-     * @param indicatorId 指标ID
-     * @param params 参数对象
-     */
-    updateMainIndicatorParams(indicatorId: string, params: Record<string, number | boolean | string>): void;
-    /**
-     * 获取主图指标参数
-     * @param indicatorId 指标ID
-     */
-    getMainIndicatorParams(indicatorId: string): Record<string, number | boolean | string> | null;
-    /**
-     * 清除所有主图指标
-     */
-    clearMainIndicators(): void;
-    /**
-     * 启用主图指标渲染器（内部方法）
-     */
-    private enableMainIndicatorRenderer;
-    /**
-     * 禁用主图指标渲染器（内部方法）
-     */
-    private disableMainIndicatorRenderer;
-    /**
-     * 更新调度器配置（内部方法）
-     */
-    private updateIndicatorSchedulerConfig;
-    /**
-     * @deprecated 使用 enableMainIndicator/disableMainIndicator 替代
-     */
-    setActiveMainIndicators(indicators: string[]): void;
-    /**
-     * 创建图表实例
-     * @param dom 由 Vue 组件传入的 DOM 句柄
-     * @param opt 初始配置
-     */
-    constructor(dom: ChartDom, opt: ChartOptions);
-    private initResizeObserver;
-    private updateObservedMetrics;
-    private getEffectiveDpr;
-    getViewport(): Viewport | null;
-    getCurrentDpr(): number;
-    /** 获取缓存的 scrollLeft（避免读取 DOM 触发强制回流） */
-    getCachedScrollLeft(): number;
-    /** 获取插件宿主 */
-    get plugin(): PluginHostImpl;
-    /** 安装渲染器插件 */
-    useRenderer(plugin: RendererPlugin | RendererPluginWithHost, config?: Record<string, unknown>): void;
-    /** 移除渲染器插件 */
-    removeRenderer(name: string): void;
-    /** 获取渲染器插件 */
-    getRenderer<T extends RendererPlugin = RendererPlugin>(name: string): T | undefined;
-    /** 更新渲染器配置（自动重绘） */
-    updateRendererConfig(name: string, config: Record<string, unknown>): void;
-    /** 启用/禁用渲染器 */
-    setRendererEnabled(name: string, enabled: boolean): void;
-    /** 获取所有渲染器 */
-    getAllRenderers(): RendererPlugin[];
-    /** 更新用户设置（触发重绘） */
-    updateSettings(settings: ChartSettings): void;
-    /**
-     * 绘制一帧
-     * @param level 更新级别，决定渲染哪些层
-     */
-    draw(level?: UpdateLevel): void;
-    private prepareFrameData;
-    private renderPanes;
-    private renderXAxis;
-    /**
-     * 应用渲染状态（由 Vue/Store 层在状态更新后调用）
-     * Chart 不拥有业务 SSOT，只负责接收参数并渲染
-     * 这是写入 opt.kWidth/kGap 和 currentZoomLevel 的唯一入口
-     */
-    applyRenderState(kWidth: number, kGap: number, zoomLevel?: number): void;
-    /** 获取总缩放级别数 */
-    getZoomLevelCount(): number;
-    /** 注册视口变化回调 */
-    setOnViewportChange(cb: (viewport: Viewport) => void): void;
-    /** 注册 pane 布局回流回调 */
-    setOnPaneLayoutChange(cb: (panes: PaneSpec[]) => void): void;
-    /** 注册数据变化回调 */
-    setOnDataChange(cb: (data: KLineData[]) => void): void;
-    /** 获取所有 PaneRenderer */
-    getPaneRenderers(): PaneRenderer[];
-    /** 获取 MarkerManager（供 InteractionController 使用） */
-    getMarkerManager(): MarkerManager;
-    /** 更新自定义标记 */
-    updateCustomMarkers(markers: CustomMarkerEntity[]): void;
-    /** 清除自定义标记 */
-    clearCustomMarkers(): void;
-    /** 获取 ChartDom（供 InteractionController 使用） */
-    getDom(): ChartDom;
-    /** 获取当前 ChartOptions（返回内部当前快照） */
-    getOption(): ResolvedChartOptions;
-    /**
-     * 计算 K 线起始 x 坐标数组，与 candle.ts 的像素对齐方式保持一致
-     * @param range 可见 K 线索引范围
-     * @returns x 坐标数组（逻辑像素，经过物理像素对齐）
-     */
-    calcKLinePositions(range: VisibleRange): KLinePositions;
-    /**
-     * 更新配置并触发布局/重绘
-     * @param partial 部分配置项
-     */
-    updateOptions(partial: Partial<ChartOptions>): void;
-    /** 更新 pane 布局配置
-     * @param panes 新的 pane 配置数组
-     */
-    updatePaneLayout(panes: PaneSpec[]): void;
-    setPaneDefinitions(defs: PaneSpec[]): void;
-    upsertPane(def: PaneSpec): void;
-    removePaneDefinition(paneId: string): void;
-    bindIndicatorToPane(paneId: string, indicatorId: SubIndicatorType, params?: Record<string, number | boolean | string>): void;
-    /** 更新绘图对象 */
-    setDrawings(drawings: import('../plugin').DrawingObject[]): void;
-    /** 更新选中的绘图 ID */
-    setSelectedDrawingId(id: string | null): void;
-    /** 获取当前 pane 布局快照（含 ratio） */
-    getPaneLayoutSpecs(): PaneSpec[];
-    private emitPaneLayoutChange;
-    private applyPaneLayoutSpecs;
-    /**
-     * 调整相邻 pane 边界（支持连锁挤压）
-     * @param upperPaneId 上方 pane ID（边界位于此 pane 与其下方邻居之间）
-     * @param deltaY Y 方向位移（逻辑像素，正数表示边界向下，upper 增大；负数表示向上，upper 减小）
-     */
-    resizePaneBoundary(upperPaneId: string, deltaY: number): boolean;
-    private resolvePaneRole;
-    addPane(paneId: string): void;
-    /**
-     * 动态移除 pane
-     * @param paneId pane 标识符
-     */
-    removePane(paneId: string): void;
-    /**
-     * 检查 pane 是否存在
-     * @param paneId pane 标识符
-     */
-    hasPane(paneId: string): boolean;
-    /**
-     * 创建副图面板并注册指标渲染器
-     * @param paneId 副图实例标识符（如 'RSI_0', 'MACD_0'）
-     * @param indicatorId 指标类型
-     * @param params 指标参数
-     * @returns 是否创建成功
-     */
-    createSubPane(paneId: string, indicatorId: SubIndicatorType, params?: Record<string, number | boolean | string>): boolean;
-    /**
-     * 移除副图面板及其渲染器
-     * @param paneId 副图实例标识符
-     */
-    removeSubPane(paneId: string): void;
-    /**
-     * 替换副图的指标类型
-     * @param paneId 副图实例标识符
-     * @param newIndicatorId 新的指标类型
-     * @param params 新指标参数
-     */
-    replaceSubPaneIndicator(paneId: string, newIndicatorId: SubIndicatorType, params?: Record<string, number | boolean | string>): void;
-    /**
-     * 更新副图指标参数
-     * @param paneId 副图实例标识符
-     * @param params 新参数
-     */
-    updateSubPaneParams(paneId: string, params: Record<string, unknown>): void;
-    /**
-     * 清除所有副图面板
-     */
-    clearSubPanes(): void;
-    /**
-     * 获取当前所有副图指标类型
-     * @deprecated 使用 getSubPaneEntries 获取完整信息
-     */
-    getSubPaneIndicators(): SubIndicatorType[];
-    /**
-     * 获取所有副图条目
-     */
-    getSubPaneEntries(): SubPaneEntry[];
-    /**
-     * 根据 paneId 获取副图条目
-     * @param paneId 副图实例标识符
-     */
-    getSubPaneEntry(paneId: string): SubPaneEntry | undefined;
-    private getDefaultSubPaneParams;
-    /** 副图渲染器名称前缀（保留向后兼容） */
-    private static readonly SUB_PANE_PREFIX;
-    /**
-     * 平移价格轴（用于主图区域上下拖动）
-     * @param paneId 目标 pane ID
-     * @param deltaY Y轴像素偏移（正数向下拖动）
-     */
-    translatePrice(paneId: string, deltaY: number): void;
-    /**
-     * 重置价格轴垂直偏移
-     * @param paneId 目标 pane ID
-     */
-    resetPriceOffset(paneId: string): void;
-    /**
-     * 缩放价格轴（用于右侧刻度栏上下拖动）
-     * @param paneId 目标 pane ID
-     * @param deltaY Y轴像素偏移（向上拖动放大，向下拖动缩小）
-     */
-    scalePrice(paneId: string, deltaY: number): void;
-    /**
-     * 更新数据并请求重绘
-     * @param data K 线数据数组
-     */
-    updateData(data: KLineData[]): void;
-    /** 获取当前数据源（供 renderers 和 interaction 使用） */
-    getData(): KLineData[];
-    /** 获取指标调度器（供外部控制器更新指标配置） */
-    getIndicatorScheduler(): IndicatorScheduler;
-    private getTrailingSlotCount;
-    getLogicalSlotCount(): number;
-    getTimestampAtLogicalIndex(index: number): number | null;
-    /** 根据视口内 X 坐标反查逻辑索引（允许超出最后一根 K 线） */
-    getLogicalIndexAtX(mouseX: number): number | null;
-    /** 根据视口内 X 坐标反查数据索引（用于绘图落点） */
-    getDataIndexAtX(mouseX: number): number | null;
-    /** 获取内容总宽度（用于外部 scroll-content 撑开 scrollWidth） */
-    getContentWidth(): number;
-    /** 容器尺寸变化时调用 */
-    resize(): void;
-    /**
-     * 请求下一帧重绘（RAF 合并，支持分层更新）
-     * @param level 更新级别，默认为 All
-     */
-    scheduleDraw(level?: UpdateLevel): void;
-    /** 销毁图表实例 */
-    destroy(): Promise<void>;
-    /** 初始化所有 pane */
-    private initPanes;
-    private syncPaneRatiosFromSpecs;
-    private syncPaneRatiosToSpecs;
-    private normalizeVisiblePaneRatios;
-    private getPaneMinHeight;
-    private computePaneHeightsByRatio;
-    /** 计算每个 pane 的布局（top 和 height） */
-    private layoutPanes;
-    private computeViewport;
-}

package/dist/src/core/controller/interaction.d.ts

@@ -1,167 +0,0 @@
-import { Chart } from '../chart';
-import { MarkerEntity, CustomMarkerEntity } from '../marker/registry';
-import { ChartSettings } from '../../config/chartSettings';
-export interface InteractionSnapshot {
-    crosshairPos: {
-        x: number;
-        y: number;
-    } | null;
-    crosshairIndex: number | null;
-    crosshairPrice: number | null;
-    hoveredIndex: number | null;
-    activePaneId: string | null;
-    tooltipPos: {
-        x: number;
-        y: number;
-    };
-    tooltipAnchorPlacement: 'right-bottom' | 'left-bottom';
-    hoveredMarkerData: MarkerEntity | null;
-    hoveredCustomMarker: CustomMarkerEntity | null;
-    isDragging: boolean;
-    isResizingPaneBoundary: boolean;
-    isHoveringPaneBoundary: boolean;
-    hoveredPaneBoundaryId: string | null;
-    isHoveringRightAxis: boolean;
-}
-/**
- * 交互控制器，处理拖拽滚动、缩放、十字线 hover 等交互逻辑
- */
-export declare class InteractionController {
-    private chart;
-    private isDragging;
-    private dragMode;
-    private dragStartX;
-    private scrollStartX;
-    private applyPanScroll;
-    /** 垂直拖动相关 */
-    private dragStartY;
-    private activePaneIdOnDrag;
-    /** 分隔线拖拽相关 */
-    private activeSeparatorUpperPaneId;
-    private hoveredSeparatorUpperPaneId;
-    /** 右轴悬浮相关 */
-    private hoveredRightAxisPaneId;
-    /** [触屏]:触摸会话标记，避免触摸触发的模拟 mouse 事件干扰 */
-    private isTouchSession;
-    private pinchTracker;
-    /** 十字线位置 */
-    crosshairPos: {
-        x: number;
-        y: number;
-    } | null;
-    /** 十字线当前指向的 K 线索引 */
-    crosshairIndex: number | null;
-    /** 十字线指向的价格（用于价格轴平移时跟随） */
-    crosshairPrice: number | null;
-    /** 鼠标悬停的 K 线索引（命中 candle 时有效） */
-    hoveredIndex: number | null;
-    /** 当前活跃的 pane ID */
-    activePaneId: string | null;
-    /** tooltip 位置 */
-    tooltipPos: {
-        x: number;
-        y: number;
-    };
-    /** tooltip 尺寸 */
-    tooltipSize: {
-        width: number;
-        height: number;
-    };
-    /** tooltip 锚定位放置方向 */
-    tooltipAnchorPlacement: 'right-bottom' | 'left-bottom';
-    /** 是否使用 CSS 锚定位 */
-    private useTooltipAnchorPositioning;
-    /** 统一交互状态变更回调 */
-    private onInteractionChangeCallback?;
-    /** 用户设置 */
-    private settings;
-    private markerState;
-    /** 当前帧的 K 线起始 x 坐标数组 */
-    private kLinePositions;
-    /** 当前帧的可见 K 线索引范围 */
-    private visibleRange;
-    /** hover 去重快照 */
-    private lastHoverRenderKey;
-    /** K 线宽度（物理像素），用于计算 K 线中心偏移 */
-    private kWidthPx;
-    constructor(chart: Chart);
-    setOnPinchZoom(callback: (delta: number, centerX: number) => void): void;
-    /** 更新用户设置 */
-    updateSettings(settings: ChartSettings): void;
-    getInteractionSnapshot(): InteractionSnapshot;
-    setOnInteractionChange(callback: (snapshot: InteractionSnapshot) => void): void;
-    private notifyInteractionChange;
-    private getHoverRenderKey;
-    /**
-     * [触屏]:处理 Pointer 按下事件
-     * @param e PointerEvent
-     */
-    onPointerDown(e: PointerEvent): void;
-    /**
-     * 设置 tooltip 尺寸
-     * @param size 宽高对象
-     */
-    setTooltipSize(size: {
-        width: number;
-        height: number;
-    }): void;
-    setTooltipAnchorPositioning(enabled: boolean): void;
-    /**
-     * 处理 Pointer 抬起事件
-     * @param e PointerEvent
-     */
-    onPointerUp(e: PointerEvent): void;
-    /**
-     * 处理 Pointer 离开事件
-     * @param e PointerEvent
-     */
-    onPointerLeave(e: PointerEvent): void;
-    /** 处理滚动事件 */
-    onScroll(): void;
-    /**
-     * 处理 Pointer 移动事件（支持鼠标和触屏）
-     * @param e PointerEvent
-     */
-    onPointerMove(e: PointerEvent): void;
-    /**
-     * 设置当前帧的 K 线起始 x 坐标数组和可见范围
-     * @param positions K 线起始 x 坐标数组
-     * @param visibleRange 可见 K 线索引范围
-     * @param kWidthPx K 线宽度（物理像素）
-     */
-    setKLinePositions(positions: number[] | null, visibleRange: {
-        start: number;
-        end: number;
-    } | null, kWidthPx?: number): void;
-    onRightAxisPointerDown(e: PointerEvent): void;
-    onRightAxisPointerMove(e: PointerEvent): void;
-    onRightAxisPointerUp(e: PointerEvent): void;
-    onRightAxisPointerLeave(e: PointerEvent): void;
-    /** 检查是否正在拖拽 */
-    isDraggingState(): boolean;
-    setOnMarkerHover(callback: (marker: MarkerEntity | null) => void): void;
-    setOnMarkerClick(callback: (marker: MarkerEntity) => void): void;
-    setOnCustomMarkerHover(callback: (marker: CustomMarkerEntity | null) => void): void;
-    setOnCustomMarkerClick(callback: (marker: CustomMarkerEntity) => void): void;
-    /** 命中可拖拽分隔线（返回上方 paneId） */
-    private hitTestPaneSeparator;
-    private getPaneByY;
-    private getPlotPointerLocation;
-    private getRightAxisPointerLocation;
-    private beginScalePriceDrag;
-    clearHover(): void;
-    private clearSeparatorState;
-    /**
-     * 从屏幕坐标更新 hover 状态
-     * @param clientX 屏幕 x 坐标
-     * @param clientY 屏幕 y 坐标
-     */
-    private updateRightAxisHoverFromPoint;
-    private updatePlotHoverFromPoint;
-    /**
-     * 重置所有交互状态（数据更新时调用）
-     */
-    reset(): void;
-    /** 获取十字线指向的 K 线索引 */
-    getCrosshairIndex(): number | null;
-}

package/dist/src/core/controller/markerInteraction.d.ts

@@ -1,28 +0,0 @@
-import { MarkerEntity, CustomMarkerEntity, MarkerManager } from '../marker/registry';
-/** Marker交互状态，管理标记 hover/click 状态和回调，与 InteractionController 正交。 */
-export declare class MarkerInteractionState {
-    hoveredMarkerId: string | null;
-    clickedMarkerId: string | null;
-    hoveredMarkerData: MarkerEntity | null;
-    clickedMarkerData: MarkerEntity | null;
-    hoveredCustomMarker: CustomMarkerEntity | null;
-    private onMarkerHoverCallback?;
-    private onMarkerClickCallback?;
-    private onCustomMarkerHoverCallback?;
-    private onCustomMarkerClickCallback?;
-    setOnMarkerHover(callback: (marker: MarkerEntity | null) => void): void;
-    setOnMarkerClick(callback: (marker: MarkerEntity) => void): void;
-    setOnCustomMarkerHover(callback: (marker: CustomMarkerEntity | null) => void): void;
-    setOnCustomMarkerClick(callback: (marker: CustomMarkerEntity) => void): void;
-    handleClick(hitMarker: MarkerEntity): void;
-    /** 从坐标更新 hover 状态。返回 true 表示命中 marker/custom-marker，调用方应跳过后续 hover 逻辑。 */
-    updateHoverFromPoint(worldX: number, mouseX: number, mouseY: number, markerManager: MarkerManager): boolean;
-    private enterMarkerHover;
-    private leaveMarkerHover;
-    private enterCustomMarkerHover;
-    private leaveCustomMarkerHover;
-    /** 清空 hover 状态并触发回调（拖拽/离开时调用）。需要 markerManager 以便同步清除 Native hover。 */
-    clearAll(markerManager: MarkerManager): void;
-    /** 全量重置（数据更新时调用，不触发热点回调） */
-    reset(): void;
-}

package/dist/src/core/controller/pinchTracker.d.ts

@@ -1,18 +0,0 @@
-/** 触屏双指捏合跟踪，与 InteractionController 正交。 */
-export declare class PinchTracker {
-    private activePointers;
-    private lastPinchDistance;
-    private pinchCenter;
-    private isPinching;
-    private onPinchZoomCallback?;
-    setOnPinchZoom(callback: (delta: number, centerX: number) => void): void;
-    getIsPinching(): boolean;
-    getPointerCount(): number;
-    /** Returns true if pinch started (caller should early-return, not process drag). */
-    handlePointerDown(e: PointerEvent, isTouchSession: boolean): boolean;
-    handlePointerUp(e: PointerEvent): void;
-    handlePointerLeave(e: PointerEvent): void;
-    /** Returns true if pinch zoom was processed (caller should skip further pointer-move handling). */
-    handlePointerMove(e: PointerEvent): boolean;
-    reset(): void;
-}

package/dist/src/core/controller/tooltipPosition.d.ts

@@ -1,21 +0,0 @@
-export interface TooltipPositionInput {
-    mouseX: number;
-    mouseY: number;
-    viewWidth: number;
-    viewHeight: number;
-    plotWidth: number;
-    plotHeight: number;
-    tooltipSize: {
-        width: number;
-        height: number;
-    };
-    useAnchorPositioning: boolean;
-}
-export interface TooltipPositionOutput {
-    pos: {
-        x: number;
-        y: number;
-    };
-    anchorPlacement?: 'right-bottom' | 'left-bottom';
-}
-export declare function computeTooltipPosition(input: TooltipPositionInput): TooltipPositionOutput;