@363045841yyt/klinechart-core 0.8.14 → 0.9.0-alpha.0

package/dist/engine/controller/interaction.js

@@ -3,77 +3,64 @@ import { UpdateLevel } from '../layout/pane';
 import { MarkerInteractionState } from './markerInteraction';
 import { PinchTracker } from './pinchTracker';
 import { computeTooltipPosition } from './tooltipPosition';
+import { isOnRightHalf } from '../../foundation/utils/viewportSide';
 /**
  * 交互控制器，处理拖拽滚动、缩放、十字线 hover 等交互逻辑
  */
 export class InteractionController {
     chart;
-    isDragging = false;
-    dragMode = 'none';
+    _state;
+    // ── Plain fields (kept — internal event processing only, not exposed) ──
     dragStartX = 0;
     scrollStartX = 0;
-    applyPanScroll(container, nextScrollLeft) {
-        const maxScrollLeft = Math.max(0, container.scrollWidth - container.clientWidth);
-        const clampedScrollLeft = Math.min(Math.max(0, nextScrollLeft), maxScrollLeft);
-        const dpr = this.chart.getCurrentDpr();
-        const rounded = Math.round(clampedScrollLeft * dpr) / dpr;
-        container.scrollLeft = rounded;
-        this.chart.setScrollLeft(container.scrollLeft);
-    }
-    /** 垂直拖动相关 */
     dragStartY = 0;
+    /** maxScrollLeft at drag start, cached to prevent jumps when scrollWidth grows mid-drag */
+    _cachedMaxScrollLeft = -1;
     activePaneIdOnDrag = null;
-    /** 分隔线拖拽相关 */
     activeSeparatorUpperPaneId = null;
-    hoveredSeparatorUpperPaneId = null;
-    /** 右轴悬浮相关 */
-    hoveredRightAxisPaneId = null;
-    /** [触屏]:触摸会话标记，避免触摸触发的模拟 mouse 事件干扰 */
     isTouchSession = false;
-    /** 触屏探索模式：true=长按出十字线不滚动，false=直接滚动 */
     exploreMode = true;
-    /** 触屏按下时的时间戳/位置（用于 tap 检测） */
     touchStartTime = 0;
     touchStartX = 0;
     touchStartY = 0;
     pinchTracker = new PinchTracker();
-    /** 十字线位置 */
-    crosshairPos = null;
-    /** 十字线当前指向的 K 线索引 */
-    crosshairIndex = null;
-    /** 十字线指向的价格（用于价格轴平移时跟随） */
-    crosshairPrice = null;
-    /** 鼠标悬停的 K 线索引（命中 candle 时有效） */
-    hoveredIndex = null;
-    /** 当前活跃的 pane ID */
-    activePaneId = null;
-    /** tooltip 位置 */
-    tooltipPos = { x: 0, y: 0 };
-    /** tooltip 尺寸 */
-    tooltipSize = { width: 220, height: 180 };
-    /** tooltip 锚定位放置方向 */
-    tooltipAnchorPlacement = 'right-bottom';
-    /** 是否使用 CSS 锚定位 */
-    useTooltipAnchorPositioning = false;
-    /** 统一交互状态变更回调 */
-    onInteractionChangeCallback;
-    /** 用户设置 */
-    settings = {};
+    lastClientPos = null;
     markerState = new MarkerInteractionState();
-    /** 当前帧的 K 线起始 x 坐标数组 */
-    kLinePositions = null;
-    /** 当前帧的 K 线中心 x 坐标数组（物理像素对齐） */
-    kLineCenters = null;
-    /** 当前帧的可见 K 线索引范围 */
-    visibleRange = null;
-    /** hover 去重快照 */
     lastHoverRenderKey = '';
-    /** K 线宽度（物理像素），用于计算 K 线中心偏移 */
-    kWidthPx = null;
+    useTooltipAnchorPositioning = false;
+    tooltipPositionMode = 'crosshair';
+    tooltipAdaptiveLock = null;
+    tooltipSize = { width: 220, height: 180 };
+    get settings() {
+        return this.chart.kernel.settings.readonly.settings.peek();
+    }
     /** 触屏长按判定时间 (ms) */
     static LONG_PRESS_MS = 400;
-    constructor(chart) {
+    // ── Getters delegate to kernel module ──
+    get crosshairPos() {
+        return this._state.readonly.crosshairPos.peek();
+    }
+    get crosshairPrice() {
+        return this._state.readonly.crosshairPrice.peek();
+    }
+    get hoveredIndex() {
+        return this._state.readonly.hoveredIndex.peek();
+    }
+    get activePaneId() {
+        return this._state.readonly.activePaneId.peek();
+    }
+    get tooltipPos() {
+        return this._state.readonly.tooltipPos.peek();
+    }
+    get tooltipAnchorPlacement() {
+        return this._state.readonly.tooltipAnchorPlacement.peek();
+    }
+    get crosshairIndex() {
+        return this._state.readonly.crosshairIndex.peek();
+    }
+    constructor(chart, state) {
         this.chart = chart;
+        this._state = state;
         this.setupPinchZoom();
     }
     setupPinchZoom() {
@@ -86,41 +73,32 @@ export class InteractionController {
             this.chart.handlePinchZoom(delta, centerX);
         });
     }
-    /** 更新用户设置 */
-    updateSettings(settings) {
-        const prev = this.settings.disableMainPaneVerticalScroll;
-        this.settings = { ...settings };
-        // 开启自适应时，重置主图垂直偏移
-        if (!prev && this.settings.disableMainPaneVerticalScroll) {
+    /**
+     * 同步 settings 变更带来的交互侧效应（tooltip 模式 / 主图纵轴复位）。
+     * 业务 settings 本体在 kernel.settings；此处不再持有 plain 副本。
+     */
+    onSettingsChanged(prev, next) {
+        const nextMode = next.tooltipPosition ?? 'crosshair';
+        if (nextMode !== 'adaptive')
+            this.tooltipAdaptiveLock = null;
+        this.tooltipPositionMode = nextMode;
+        if (!prev.disableMainPaneVerticalScroll && next.disableMainPaneVerticalScroll) {
             this.chart.resetPriceTransform('main');
         }
     }
+    /** @deprecated Use kernel's interactionSnapshot computed directly. */
     getInteractionSnapshot() {
-        return {
-            crosshairPos: this.crosshairPos ? { ...this.crosshairPos } : null,
-            crosshairIndex: this.crosshairIndex,
-            crosshairPrice: this.crosshairPrice,
-            hoveredIndex: this.hoveredIndex,
-            activePaneId: this.activePaneId,
-            tooltipPos: { ...this.tooltipPos },
-            tooltipAnchorPlacement: this.tooltipAnchorPlacement,
-            hoveredMarkerData: this.markerState.hoveredMarkerData,
-            hoveredCustomMarker: this.markerState.hoveredCustomMarker,
-            isDragging: this.isDragging,
-            isResizingPaneBoundary: this.dragMode === 'resize-separator',
-            isHoveringPaneBoundary: this.hoveredSeparatorUpperPaneId !== null,
-            hoveredPaneBoundaryId: this.hoveredSeparatorUpperPaneId,
-            isHoveringRightAxis: this.hoveredRightAxisPaneId !== null,
-        };
+        return this._state.readonly.interactionSnapshot.peek();
     }
     isPointerDown() {
-        return this.isDragging || this.pinchTracker.getPointerCount() > 0;
-    }
-    setOnInteractionChange(callback) {
-        this.onInteractionChangeCallback = callback;
+        return this._state.readonly.isDragging.peek() || this.pinchTracker.getPointerCount() > 0;
     }
-    notifyInteractionChange() {
-        this.onInteractionChangeCallback?.(this.getInteractionSnapshot());
+    /**
+     * @deprecated Interaction state is now auto-derived from the kernel module.
+     *             External consumers should subscribe to the interactionSnapshot signal.
+     */
+    setOnInteractionChange(_callback) {
+        // no-op
     }
     getHoverRenderKey() {
         const crosshairX = this.crosshairPos
@@ -133,10 +111,10 @@ export class InteractionController {
             this.crosshairIndex ?? 'n',
             this.hoveredIndex ?? 'n',
             this.activePaneId ?? 'n',
-            this.hoveredRightAxisPaneId ?? 'n',
-            this.hoveredSeparatorUpperPaneId ?? 'n',
-            this.markerState.hoveredMarkerId ?? 'n',
-            this.markerState.hoveredCustomMarker?.id ?? 'n',
+            this._state.readonly.hoveredRightAxisPaneId.peek() ?? 'n',
+            this._state.readonly.hoveredSeparatorUpperPaneId.peek() ?? 'n',
+            this._state.readonly.hoveredMarkerId.peek() ?? 'n',
+            this._state.readonly.hoveredCustomMarker.peek()?.id ?? 'n',
             crosshairX,
             crosshairY,
         ].join('|');
@@ -148,8 +126,7 @@ export class InteractionController {
     onPointerDown(e) {
         this.isTouchSession = e.pointerType === 'touch';
         if (this.pinchTracker.handlePointerDown(e, this.isTouchSession)) {
-            this.isDragging = false;
-            this.dragMode = 'none';
+            this._state.actions.endDrag();
             return;
         }
         // 单指操作（需要是主指针且不在捏合中，且不是捏合后的残余手指）
@@ -171,11 +148,10 @@ export class InteractionController {
         }
         const separatorUpperPaneId = this.hitTestPaneSeparator(mouseY);
         if (separatorUpperPaneId) {
-            this.isDragging = true;
-            this.dragMode = 'resize-separator';
+            this._state.actions.startDrag('resize-separator');
             this.dragStartY = e.clientY;
             this.activeSeparatorUpperPaneId = separatorUpperPaneId;
-            this.hoveredSeparatorUpperPaneId = separatorUpperPaneId;
+            this._state.actions.setSeparatorHover(separatorUpperPaneId);
             this.clearHover();
             this.chart.scheduleDraw();
             return;
@@ -187,15 +163,17 @@ export class InteractionController {
             return;
         }
         const pane = this.getPaneByY(mouseY);
-        this.isDragging = true;
+        this._state.actions.startDrag('pan');
         this.touchStartTime = Date.now();
         this.touchStartX = e.clientX;
         this.touchStartY = e.clientY;
         // 触屏始终以 pan 模式开始，长按后才切换为 explore
-        this.dragMode = 'pan';
         this.dragStartX = e.clientX;
         this.dragStartY = e.clientY;
         this.scrollStartX = this.chart.getCachedScrollLeft();
+        this._cachedMaxScrollLeft = -1;
+        const captureContainer = this.chart.getDom().container;
+        captureContainer?.setPointerCapture(e.pointerId);
         this.activePaneIdOnDrag = pane?.id || null;
         this.chart.scheduleDraw();
     }
@@ -217,15 +195,14 @@ export class InteractionController {
         this.pinchTracker.handlePointerUp(e);
         if (e.isPrimary === false)
             return;
-        const wasPanning = this.dragMode === 'pan';
-        const wasExploring = this.dragMode === 'explore';
+        const wasPanning = this._state.readonly.dragMode.peek() === 'pan';
+        const wasExploring = this._state.readonly.dragMode.peek() === 'explore';
         if (this.isTouchSession) {
             if (wasExploring) {
                 // 长按触发了 explore → 保持十字线
                 this.exploreMode = true;
                 this.updatePlotHoverFromPoint(e.clientX, e.clientY);
                 this.chart.scheduleDraw();
-                this.notifyInteractionChange();
             }
             else if (wasPanning) {
                 // 有实际滑动 → 下次支持长按
@@ -243,7 +220,6 @@ export class InteractionController {
                     this.exploreMode = false;
                     this.clearHover();
                     this.chart.scheduleDraw();
-                    this.notifyInteractionChange();
                 }
                 else {
                     this.exploreMode = true;
@@ -254,11 +230,10 @@ export class InteractionController {
         if (wasPanning) {
             this.chart.checkVisibleRangeGap();
         }
-        this.isDragging = false;
-        this.dragMode = 'none';
+        this._state.actions.endDrag();
         this.activePaneIdOnDrag = null;
         this.activeSeparatorUpperPaneId = null;
-        this.notifyInteractionChange();
+        this._cachedMaxScrollLeft = -1;
     }
     /**
      * 处理 Pointer 离开事件
@@ -268,33 +243,30 @@ export class InteractionController {
         this.pinchTracker.handlePointerLeave(e);
         if (e.isPrimary === false)
             return;
-        this.isDragging = false;
-        this.dragMode = 'none';
+        this.tooltipAdaptiveLock = null;
+        this._state.actions.endDrag();
         this.activePaneIdOnDrag = null;
         this.clearSeparatorState();
         if (!this.isTouchSession) {
             this.clearHover();
             this.chart.scheduleDraw();
-            this.notifyInteractionChange();
         }
         this.isTouchSession = false;
     }
     /** 处理滚动事件 */
     onScroll(options = {}) {
-        this.kLinePositions = null;
-        this.kLineCenters = null;
-        this.visibleRange = null;
+        this._state.actions.updateFramePositions(null, null, null);
         this.clearHover();
         if (options.scheduleDraw !== false) {
             this.chart.scheduleDraw();
         }
-        this.notifyInteractionChange();
     }
     /**
      * 处理 Pointer 移动事件（支持鼠标和触屏）
      * @param e PointerEvent
      */
     onPointerMove(e) {
+        this.lastClientPos = { x: e.clientX, y: e.clientY };
         if (this.pinchTracker.handlePointerMove(e))
             return;
         if (!e.isPrimary)
@@ -303,8 +275,8 @@ export class InteractionController {
             this.isTouchSession = true;
         }
         const container = this.chart.getDom().container;
-        if (this.isDragging) {
-            if (this.dragMode === 'resize-separator') {
+        if (this._state.readonly.isDragging.peek()) {
+            if (this._state.readonly.dragMode.peek() === 'resize-separator') {
                 const deltaY = e.clientY - this.dragStartY;
                 if (deltaY !== 0 && this.activeSeparatorUpperPaneId) {
                     const resized = this.chart.resizePaneBoundary(this.activeSeparatorUpperPaneId, deltaY);
@@ -314,7 +286,7 @@ export class InteractionController {
                 }
                 return;
             }
-            if (this.dragMode === 'scale-price') {
+            if (this._state.readonly.dragMode.peek() === 'scale-price') {
                 const deltaY = e.clientY - this.dragStartY;
                 if (deltaY !== 0 && this.activePaneIdOnDrag) {
                     this.chart.scalePrice(this.activePaneIdOnDrag, deltaY);
@@ -323,27 +295,31 @@ export class InteractionController {
                 return;
             }
             // 触屏：长按达到阈值后从 pan 切换到 explore
-            if (this.isTouchSession && this.dragMode === 'pan' && this.exploreMode) {
+            if (this.isTouchSession && this._state.readonly.dragMode.peek() === 'pan' && this.exploreMode) {
                 const elapsed = Date.now() - this.touchStartTime;
                 const dx = Math.abs(e.clientX - this.touchStartX);
                 const dy = Math.abs(e.clientY - this.touchStartY);
                 if (elapsed >= InteractionController.LONG_PRESS_MS && dx < 10 && dy < 10) {
-                    this.dragMode = 'explore';
+                    this._state.actions.setDragMode('explore');
                     this.updatePlotHoverFromPoint(e.clientX, e.clientY);
                     this.chart.scheduleDraw();
-                    this.notifyInteractionChange();
                     return;
                 }
             }
-            if (this.dragMode === 'explore') {
+            if (this._state.readonly.dragMode.peek() === 'explore') {
                 this.updatePlotHoverFromPoint(e.clientX, e.clientY);
                 this.chart.scheduleDraw();
-                this.notifyInteractionChange();
                 return;
             }
-            if (this.dragMode === 'pan') {
+            if (this._state.readonly.dragMode.peek() === 'pan') {
+                const container = this.chart.getDom().container;
                 const deltaX = this.dragStartX - e.clientX;
-                this.applyPanScroll(container, this.scrollStartX + deltaX);
+                if (this._cachedMaxScrollLeft < 0) {
+                    this._cachedMaxScrollLeft = Math.max(0, (container?.scrollWidth ?? 0) - (container?.clientWidth ?? 0));
+                }
+                const clamped = Math.min(Math.max(0, this.scrollStartX + deltaX), this._cachedMaxScrollLeft);
+                const dpr = this.chart.getCurrentDpr();
+                this.chart.syncScrollLeft(Math.round(clamped * dpr) / dpr);
                 const deltaY = e.clientY - this.dragStartY;
                 this.dragStartY = e.clientY;
                 if (deltaY !== 0 && this.activePaneIdOnDrag === 'main') {
@@ -357,14 +333,13 @@ export class InteractionController {
         const location = this.getPlotPointerLocation(e.clientX, e.clientY);
         if (!location)
             return;
-        this.hoveredSeparatorUpperPaneId = this.hitTestPaneSeparator(location.mouseY);
+        this._state.actions.setSeparatorHover(this.hitTestPaneSeparator(location.mouseY));
         this.updatePlotHoverFromPoint(e.clientX, e.clientY);
         const hoverRenderKey = this.getHoverRenderKey();
         if (hoverRenderKey !== this.lastHoverRenderKey) {
             this.lastHoverRenderKey = hoverRenderKey;
             this.chart.scheduleDraw(UpdateLevel.Overlay);
         }
-        this.notifyInteractionChange();
     }
     /**
      * 设置当前帧的 K 线起始 x 坐标数组和可见范围
@@ -374,11 +349,10 @@ export class InteractionController {
      * @param centers K 线中心 x 坐标数组（物理像素对齐后）
      */
     setKLinePositions(positions, visibleRange, kWidthPx, centers) {
-        this.kLinePositions = positions;
-        this.kLineCenters = centers ?? null;
-        this.visibleRange = visibleRange;
-        if (kWidthPx !== undefined) {
-            this.kWidthPx = kWidthPx;
+        this._state.actions.updateFramePositions(positions, centers ?? null, kWidthPx ?? null);
+        // 十字线自动同步：positions 刷新后用最新鼠标位置重算，防止缩放/滚动后索引滞后
+        if (this.lastClientPos && !this._state.readonly.isDragging.peek()) {
+            this.updatePlotHoverFromPoint(this.lastClientPos.x, this.lastClientPos.y);
         }
     }
     onRightAxisPointerDown(e) {
@@ -390,7 +364,6 @@ export class InteractionController {
             return;
         if (this.beginScalePriceDrag(e.clientY, location.mouseY)) {
             this.chart.scheduleDraw();
-            this.notifyInteractionChange();
         }
     }
     onRightAxisPointerMove(e) {
@@ -399,7 +372,7 @@ export class InteractionController {
         if (e.pointerType === 'touch') {
             this.isTouchSession = true;
         }
-        if (this.isDragging && this.dragMode === 'scale-price') {
+        if (this._state.readonly.isDragging.peek() && this._state.readonly.dragMode.peek() === 'scale-price') {
             const deltaY = e.clientY - this.dragStartY;
             if (deltaY !== 0 && this.activePaneIdOnDrag) {
                 this.chart.scalePrice(this.activePaneIdOnDrag, deltaY);
@@ -413,7 +386,6 @@ export class InteractionController {
             this.lastHoverRenderKey = hoverRenderKey;
             this.chart.scheduleDraw(UpdateLevel.Overlay);
         }
-        this.notifyInteractionChange();
     }
     onRightAxisPointerUp(e) {
         this.onPointerUp(e);
@@ -421,14 +393,13 @@ export class InteractionController {
     onRightAxisPointerLeave(e) {
         if (e.isPrimary === false)
             return;
-        if (this.isDragging && this.dragMode === 'scale-price')
+        if (this._state.readonly.isDragging.peek() && this._state.readonly.dragMode.peek() === 'scale-price')
             return;
-        this.hoveredRightAxisPaneId = null;
-        this.notifyInteractionChange();
+        this._state.actions.setRightAxisHover(null);
     }
     /** 检查是否正在拖拽 */
     isDraggingState() {
-        return this.isDragging;
+        return this._state.readonly.isDragging.peek();
     }
     setOnMarkerHover(callback) {
         this.markerState.setOnMarkerHover(callback);
@@ -486,37 +457,30 @@ export class InteractionController {
         const pane = this.getPaneByY(mouseY);
         if (!pane)
             return false;
-        // 主图禁用垂直滚动时，禁止价格轴缩放
         if (pane.id === 'main' && this.settings.disableMainPaneVerticalScroll) {
             return false;
         }
-        this.isDragging = true;
-        this.dragMode = 'scale-price';
+        this._state.actions.startDrag('scale-price');
         this.dragStartY = clientY;
         this.activePaneIdOnDrag = pane.id;
-        this.hoveredRightAxisPaneId = pane.id;
-        this.hoveredSeparatorUpperPaneId = null;
-        this.crosshairPos = null;
-        this.crosshairIndex = null;
-        this.crosshairPrice = null;
-        this.hoveredIndex = null;
-        this.activePaneId = pane.id;
+        this._state.actions.setRightAxisHover(pane.id);
+        this._state.actions.setSeparatorHover(null);
+        this._state.actions.updateCrosshair(null, null);
+        this._state.actions.updateHover(null, pane.id);
         return true;
     }
     clearHover() {
         this.lastHoverRenderKey = '';
-        this.hoveredRightAxisPaneId = null;
-        this.crosshairPos = null;
-        this.crosshairIndex = null;
-        this.crosshairPrice = null;
-        this.hoveredIndex = null;
-        this.activePaneId = null;
+        this._state.actions.setRightAxisHover(null);
+        this._state.actions.updateCrosshair(null, null);
+        this._state.actions.updateHover(null, null);
+        this._state.actions.updateMarkerHover(null, null, null);
         this.markerState.clearAll(this.chart.getMarkerManager());
     }
     clearSeparatorState() {
         this.activeSeparatorUpperPaneId = null;
-        this.hoveredSeparatorUpperPaneId = null;
-        this.hoveredRightAxisPaneId = null;
+        this._state.actions.setSeparatorHover(null);
+        this._state.actions.setRightAxisHover(null);
     }
     /**
      * 从屏幕坐标更新 hover 状态
@@ -531,17 +495,14 @@ export class InteractionController {
         const viewport = this.chart.getViewport();
         const plotHeight = viewport?.plotHeight ?? Math.max(1, Math.round(this.chart.getDom().container.clientHeight));
         if (mouseY < 0 || mouseY > plotHeight) {
-            this.hoveredRightAxisPaneId = null;
+            this._state.actions.setRightAxisHover(null);
             return;
         }
         const pane = this.getPaneByY(mouseY);
-        this.hoveredRightAxisPaneId = pane?.id || null;
-        this.hoveredSeparatorUpperPaneId = null;
-        this.crosshairPos = null;
-        this.crosshairIndex = null;
-        this.crosshairPrice = null;
-        this.hoveredIndex = null;
-        this.activePaneId = pane?.id || null;
+        this._state.actions.setRightAxisHover(pane?.id || null);
+        this._state.actions.setSeparatorHover(null);
+        this._state.actions.updateCrosshair(null, null);
+        this._state.actions.updateHover(null, pane?.id || null);
     }
     /**
      * 指针悬停检测（coordinator）
@@ -550,6 +511,7 @@ export class InteractionController {
      * 边界 → pane 分隔器 → marker → K 线 bar → 十字线定位 → candle 命中 → tooltip。
      * 每个步骤都可能提前 return，无需执行后续检测。
      */
+    /** @internal 公开给外部在合适的时机触发十字线重算（如 setKLinePositions 之后） */
     updatePlotHoverFromPoint(clientX, clientY) {
         const ctx = this.resolveHoverContext(clientX, clientY);
         if (!ctx)
@@ -568,11 +530,16 @@ export class InteractionController {
             this.handleTimeshareHover(ctx, bar);
             return;
         }
+        if (this.tooltipPositionMode === 'adaptive') {
+            this._state.actions.setHoveredIndex(bar.globalIdx);
+            this.updateTooltip(ctx);
+            return;
+        }
         if (!this.hitTestCandle(ctx, bar)) {
-            this.hoveredIndex = null;
+            this._state.actions.setHoveredIndex(null);
             return;
         }
-        this.hoveredIndex = bar.globalIdx;
+        this._state.actions.setHoveredIndex(bar.globalIdx);
         this.updateTooltip(ctx);
     }
     /**
@@ -616,15 +583,12 @@ export class InteractionController {
      * 若指针悬浮在 pane 分隔条上，清除十字线状态并返回 true。
      */
     handleSeparatorHit(ctx) {
-        this.hoveredRightAxisPaneId = null;
+        this._state.actions.setRightAxisHover(null);
         const separatorUpperPaneId = this.hitTestPaneSeparator(ctx.mouseY);
-        this.hoveredSeparatorUpperPaneId = separatorUpperPaneId;
+        this._state.actions.setSeparatorHover(separatorUpperPaneId);
         if (separatorUpperPaneId) {
-            this.crosshairPos = null;
-            this.crosshairIndex = null;
-            this.crosshairPrice = null;
-            this.hoveredIndex = null;
-            this.activePaneId = null;
+            this._state.actions.updateCrosshair(null, null);
+            this._state.actions.updateHover(null, null);
             return true;
         }
         return false;
@@ -636,11 +600,11 @@ export class InteractionController {
      */
     handleMarkerHit(ctx) {
         const markerManager = this.chart.getMarkerManager();
-        if (this.markerState.updateHoverFromPoint(ctx.worldX, ctx.mouseX, ctx.mouseY, markerManager)) {
-            this.crosshairPos = null;
-            this.crosshairIndex = null;
-            this.crosshairPrice = null;
-            this.hoveredIndex = null;
+        const result = this.markerState.updateHoverFromPoint(ctx.worldX, ctx.mouseX, ctx.mouseY, markerManager);
+        this._state.actions.updateMarkerHover(result.hitMarkerId, result.hitMarkerData, result.hitCustomMarker);
+        if (result.hit) {
+            this._state.actions.updateCrosshair(null, null);
+            this._state.actions.setHoveredIndex(null);
             return true;
         }
         return false;
@@ -652,11 +616,15 @@ export class InteractionController {
      * 若无 kLinePositions、visibleRange 或 kWidthPx，返回 null。
      */
     findNearestBar(ctx) {
-        if (!this.kLinePositions || !this.visibleRange || !this.kWidthPx)
+        const kLinePositions = this._state.readonly.kLinePositions.peek();
+        const kWidthPx = this._state.readonly.kWidthPx.peek();
+        const vp = this.chart.viewport.peek();
+        const visibleRange = vp ? { start: vp.visibleFrom, end: vp.visibleTo } : null;
+        if (!kLinePositions || !visibleRange || !kWidthPx)
             return null;
-        const { worldX, mouseY, dpr } = ctx;
-        const kWidthLogical = this.kWidthPx / dpr;
-        const positions = this.kLinePositions;
+        const { worldX, mouseY, dpr, scrollLeft, plotWidth } = ctx;
+        const kWidthLogical = kWidthPx / dpr;
+        const positions = kLinePositions;
         let lo = 0, hi = positions.length;
         while (lo < hi) {
             const mid = (lo + hi) >> 1;
@@ -678,9 +646,27 @@ export class InteractionController {
         else if (lo === positions.length && positions.length > 0) {
             localIdx = positions.length - 1;
         }
+        // 跳过中心不在可视视口内的 K 线（边缘裁剪），取相邻可见 K 线
+        const barCenter = positions[localIdx] + kWidthLogical / 2;
+        if (barCenter < scrollLeft) {
+            if (localIdx + 1 < positions.length) {
+                localIdx += 1;
+            }
+            else {
+                return null;
+            }
+        }
+        else if (barCenter > scrollLeft + plotWidth) {
+            if (localIdx > 0) {
+                localIdx -= 1;
+            }
+            else {
+                return null;
+            }
+        }
         return {
             localIdx,
-            globalIdx: localIdx + this.visibleRange.start,
+            globalIdx: localIdx + visibleRange.start,
             kLineStartX: positions[localIdx],
             widthLogical: kWidthLogical,
         };
@@ -695,27 +681,19 @@ export class InteractionController {
     positionCrosshair(ctx, bar) {
         const { mouseX, mouseY, scrollLeft, plotWidth, plotHeight, dpr } = ctx;
         const pane = this.getPaneByY(mouseY);
-        this.activePaneId = pane?.id || null;
-        if (bar.globalIdx < 0 || bar.globalIdx >= (this.chart.getRenderData()?.length ?? 0)) {
-            this.crosshairIndex = null;
-            this.crosshairPos = null;
-            this.crosshairPrice = null;
+        this._state.actions.setActivePaneId(pane?.id || null);
+        if (bar.globalIdx < 0 || bar.globalIdx >= this.chart.getInternalData().length) {
+            this._state.actions.updateCrosshair(null, null);
             return;
         }
-        this.crosshairIndex = bar.globalIdx;
-        const centerX = this.kLineCenters?.[bar.localIdx] ?? bar.kLineStartX + bar.widthLogical / 2;
+        const kLineCenters = this._state.readonly.kLineCenters.peek();
+        const centerX = kLineCenters?.[bar.localIdx] ?? bar.kLineStartX + bar.widthLogical / 2;
         const snappedX = centerX - scrollLeft;
-        this.crosshairPos = {
+        const price = pane ? pane.yAxis.yToPrice(mouseY - pane.top) : null;
+        this._state.actions.updateCrosshair({
             x: Math.min(Math.max(snappedX, 0), plotWidth),
             y: Math.min(Math.max(mouseY, 0), plotHeight),
-        };
-        if (pane) {
-            const localY = mouseY - pane.top;
-            this.crosshairPrice = pane.yAxis.yToPrice(localY);
-        }
-        else {
-            this.crosshairPrice = null;
-        }
+        }, price);
     }
     /**
      * 分时模式悬停处理
@@ -724,19 +702,19 @@ export class InteractionController {
      * 不执行 candle body/wick 命中检测。
      */
     handleTimeshareHover(ctx, bar) {
-        this.hoveredIndex = bar.globalIdx;
+        this._state.actions.setHoveredIndex(bar.globalIdx);
         this.updateTooltip(ctx);
     }
     /**
      * Candle 实体/影线命中检测
      *
      * 检测指针是否落在 K 线实体内或影线上。
-     * 小实体（< 8px）会扩展命中区域以保证可用性。
+     * 小实体（< 20px）和短影线（< 8px）会扩展命中区域以保证涨停/跌停等极端行情的可用性。
      * 未命中时返回 false。
      */
     hitTestCandle(ctx, bar) {
         const { mouseY, worldX, dpr } = ctx;
-        const data = this.chart.getRenderData();
+        const data = this.chart.getInternalData();
         const k = typeof this.crosshairIndex === 'number'
             ? data?.[this.crosshairIndex]
             : undefined;
@@ -752,7 +730,7 @@ export class InteractionController {
         const bodyBottom = Math.max(openY, closeY);
         const inUnitX = worldX - bar.kLineStartX;
         const cxLogical = bar.widthLogical / 2;
-        const MIN_BODY_HIT_HEIGHT = 8;
+        const MIN_BODY_HIT_HEIGHT = 100;
         const bodyHeight = Math.abs(bodyBottom - bodyTop);
         const effectiveBodyTop = bodyHeight < MIN_BODY_HIT_HEIGHT
             ? (bodyTop + bodyBottom) / 2 - MIN_BODY_HIT_HEIGHT / 2
@@ -760,14 +738,22 @@ export class InteractionController {
         const effectiveBodyBottom = bodyHeight < MIN_BODY_HIT_HEIGHT
             ? (bodyTop + bodyBottom) / 2 + MIN_BODY_HIT_HEIGHT / 2
             : bodyBottom;
+        const MIN_WICK_HIT_HEIGHT = 8;
+        const wickHeight = Math.abs(highY - lowY);
+        const effectiveWickTop = wickHeight < MIN_WICK_HIT_HEIGHT
+            ? (highY + lowY) / 2 - MIN_WICK_HIT_HEIGHT / 2
+            : Math.min(highY, lowY);
+        const effectiveWickBottom = wickHeight < MIN_WICK_HIT_HEIGHT
+            ? (highY + lowY) / 2 + MIN_WICK_HIT_HEIGHT / 2
+            : Math.max(highY, lowY);
         const HIT_WICK_HALF_EXTENDED = 3;
         const hitBody = localY >= effectiveBodyTop &&
             localY <= effectiveBodyBottom &&
             inUnitX >= 0 &&
             inUnitX <= bar.widthLogical;
         const hitWick = Math.abs(inUnitX - cxLogical) <= HIT_WICK_HALF_EXTENDED &&
-            localY >= Math.min(highY, lowY) &&
-            localY <= Math.max(highY, lowY);
+            localY >= effectiveWickTop &&
+            localY <= effectiveWickBottom;
         return hitBody || hitWick;
     }
     /**
@@ -777,6 +763,9 @@ export class InteractionController {
      */
     updateTooltip(ctx) {
         const { mouseX, mouseY, viewWidth, viewHeight, plotWidth, plotHeight } = ctx;
+        if (this.tooltipPositionMode === 'adaptive' && this.tooltipAdaptiveLock === null) {
+            this.tooltipAdaptiveLock = isOnRightHalf(mouseX, viewWidth) ? 'top-left' : 'top-right';
+        }
         const tooltipResult = computeTooltipPosition({
             mouseX,
             mouseY,
@@ -786,18 +775,16 @@ export class InteractionController {
             plotHeight,
             tooltipSize: this.tooltipSize,
             useAnchorPositioning: this.useTooltipAnchorPositioning,
+            mode: this.tooltipPositionMode,
+            adaptiveCorner: this.tooltipAdaptiveLock ?? undefined,
         });
-        if (tooltipResult.anchorPlacement) {
-            this.tooltipAnchorPlacement = tooltipResult.anchorPlacement;
-        }
-        this.tooltipPos = tooltipResult.pos;
+        this._state.actions.updateTooltip(tooltipResult.pos, tooltipResult.anchorPlacement ?? 'right-bottom');
     }
     /**
      * 重置所有交互状态（数据更新时调用）
      */
     reset() {
-        this.isDragging = false;
-        this.dragMode = 'none';
+        this._state.actions.endDrag();
         this.dragStartX = 0;
         this.dragStartY = 0;
         this.scrollStartX = 0;
@@ -805,17 +792,11 @@ export class InteractionController {
         this.clearSeparatorState();
         this.isTouchSession = false;
         this.pinchTracker.reset();
-        this.crosshairPos = null;
-        this.crosshairIndex = null;
-        this.crosshairPrice = null;
-        this.hoveredIndex = null;
-        this.activePaneId = null;
+        this._state.actions.updateCrosshair(null, null);
+        this._state.actions.updateHover(null, null);
         this.markerState.reset();
-        this.kLinePositions = null;
-        this.kLineCenters = null;
-        this.visibleRange = null;
+        this._state.actions.updateFramePositions(null, null, null);
         this.lastHoverRenderKey = '';
-        this.kWidthPx = null;
     }
     /** 获取十字线指向的 K 线索引 */
     getCrosshairIndex() {