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

package/src/engine/drawing/__tests__/drawingState.workCopy.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it, vi } from 'vitest'
-import { DrawingState } from '../DrawingState'
+import { DrawingState, mergePaint, PREVIEW_ID } from '../DrawingState'
 import type { DrawingChartAdapter } from '../../../controllers/types'
 import type { DrawingObject } from '../../../foundation/plugin/index'
 
@@ -15,13 +15,34 @@ function mk(id: string): DrawingObject {
   }
 }
 
-function mockAdapter(): DrawingChartAdapter {
+function mockAdapter(
+  initial: DrawingObject[] = [],
+  initialSelected: string | null = null,
+): DrawingChartAdapter & {
+  kernelList: DrawingObject[]
+  setDrawings: ReturnType<typeof vi.fn>
+  requestDraw: ReturnType<typeof vi.fn>
+} {
+  let selected: string | null = initialSelected
+  let kernelList = [...initial]
+  const setDrawings = vi.fn((list: DrawingObject[]) => {
+    kernelList = list.filter((d) => d.id !== PREVIEW_ID).map((d) => ({ ...d }))
+  })
+  const requestDraw = vi.fn()
   return {
-    setDrawings: vi.fn(),
-    getFullDrawings: vi.fn(() => []),
-    setSelectedDrawingId: vi.fn(),
+    kernelList: kernelList as DrawingObject[],
+    get kernel() {
+      return kernelList
+    },
+    setDrawings,
+    getFullDrawings: vi.fn(() => kernelList),
+    setSelectedDrawingId: vi.fn((id: string | null) => {
+      selected = id
+    }),
+    getSelectedDrawingId: vi.fn(() => selected),
     setDrawingToolId: vi.fn(),
     getDrawingToolId: vi.fn(() => 'cursor'),
+    requestDraw,
     getViewport: vi.fn(() => null),
     getKWidthKGap: vi.fn(() => ({ kWidth: 6, kGap: 2 })),
     getCurrentDpr: vi.fn(() => 1),
@@ -31,48 +52,86 @@ function mockAdapter(): DrawingChartAdapter {
     priceToY: vi.fn(() => 0),
     yToPrice: vi.fn(() => 0),
     getPaneInfo: vi.fn(() => undefined),
-  }
+  } as any
 }
 
-describe('DrawingState work copy', () => {
-  it('addOrUpdate works after setDrawings from frozen kernel snapshot', () => {
-    const adapter = mockAdapter()
+describe('DrawingState session SSOT', () => {
+  it('addOrUpdate commits to adapter without local full list', () => {
+    const adapter = mockAdapter([mk('a')])
     const state = new DrawingState(adapter)
-    const frozen = Object.freeze([Object.freeze(mk('a'))]) as DrawingObject[]
-    state.setDrawings(frozen)
-    expect(() => state.addOrUpdate(mk('b'))).not.toThrow()
+    state.addOrUpdate(mk('b'))
+    expect(adapter.setDrawings).toHaveBeenCalled()
+    const last = adapter.setDrawings.mock.calls.at(-1)![0] as DrawingObject[]
+    expect(last.map((d) => d.id).sort()).toEqual(['a', 'b'])
     expect(state.getAll().map((d) => d.id).sort()).toEqual(['a', 'b'])
   })
 
-  it('setPreview works after setDrawings from frozen snapshot', () => {
-    const adapter = mockAdapter()
+  it('setPreview does not write kernel; only requestDraw', () => {
+    const adapter = mockAdapter([mk('a')])
     const state = new DrawingState(adapter)
-    state.setDrawings(Object.freeze([Object.freeze(mk('a'))]) as DrawingObject[])
-    expect(() =>
-      state.setPreview({
-        ...mk('__preview__'),
-        id: '__preview__',
-      }),
-    ).not.toThrow()
+    adapter.setDrawings.mockClear()
+    state.setPreview({ ...mk(PREVIEW_ID), id: PREVIEW_ID })
+    expect(adapter.setDrawings).not.toHaveBeenCalled()
+    expect(adapter.requestDraw).toHaveBeenCalled()
     expect(state.hasPreview()).toBe(true)
+    expect(state.getPaintOverlay().map((d) => d.id)).toEqual([PREVIEW_ID])
+    expect(state.getAll().map((d) => d.id)).toEqual(['a', PREVIEW_ID])
   })
 
-  it('nested fields from frozen snapshot are mutable after adopt', () => {
+  it('setDrawings strips preview id before kernel write', () => {
     const adapter = mockAdapter()
     const state = new DrawingState(adapter)
-    const frozen = Object.freeze([
-      Object.freeze({
-        ...mk('a'),
-        anchors: Object.freeze([Object.freeze({ id: 'p1', index: 0, price: 1 })]),
-        style: Object.freeze({ stroke: '#f00' }),
-      }),
-    ]) as DrawingObject[]
-    state.setDrawings(frozen)
-    const d = state.getById('a')!
-    expect(() => {
-      d.anchors[0]!.price = 99
-      d.style.stroke = '#0f0'
-    }).not.toThrow()
-    expect(d.anchors[0]!.price).toBe(99)
+    state.setDrawings([mk('a'), { ...mk(PREVIEW_ID), id: PREVIEW_ID }])
+    const last = adapter.setDrawings.mock.calls.at(-1)![0] as DrawingObject[]
+    expect(last.map((d) => d.id)).toEqual(['a'])
+  })
+
+  it('getAll returns merge of kernel + overlay without mutating kernel', () => {
+    const adapter = mockAdapter([mk('a')])
+    const state = new DrawingState(adapter)
+    state.setPreview({ ...mk(PREVIEW_ID), id: PREVIEW_ID })
+    const all = state.getAll()
+    all.push(mk('hack'))
+    expect(adapter.getFullDrawings()).toHaveLength(1)
+  })
+
+  it('setSelected only writes adapter; getSelectedId reads adapter', () => {
+    const adapter = mockAdapter([mk('a')])
+    const state = new DrawingState(adapter)
+    state.setSelected(mk('a'))
+    expect(adapter.setSelectedDrawingId).toHaveBeenCalledWith('a')
+    expect(state.getSelectedId()).toBe('a')
+  })
+
+  it('removeDrawing drops id and clears selection via adapter', () => {
+    const adapter = mockAdapter([mk('a'), mk('b')], 'a')
+    const state = new DrawingState(adapter)
+    state.removeDrawing('a')
+    expect(adapter.setSelectedDrawingId).toHaveBeenCalledWith(null)
+    const last = adapter.setDrawings.mock.calls.at(-1)![0] as DrawingObject[]
+    expect(last.map((d) => d.id)).toEqual(['b'])
+  })
+
+  it('setDragOverride does not write kernel; commitDrag writes once', () => {
+    const adapter = mockAdapter([mk('a')])
+    const state = new DrawingState(adapter)
+    adapter.setDrawings.mockClear()
+    const moved = { ...mk('a'), anchors: [{ id: 'p', index: 1, time: 1, price: 99 }] }
+    state.setDragOverride(moved)
+    expect(adapter.setDrawings).not.toHaveBeenCalled()
+    expect(adapter.requestDraw).toHaveBeenCalled()
+    state.commitDrag()
+    expect(adapter.setDrawings).toHaveBeenCalledTimes(1)
+    const last = adapter.setDrawings.mock.calls.at(-1)![0] as DrawingObject[]
+    expect(last[0]!.anchors[0]!.price).toBe(99)
+    expect(state.getPaintOverlay()).toEqual([])
+  })
+
+  it('mergePaint replaces by id and appends preview', () => {
+    const a = mk('a')
+    const a2 = { ...mk('a'), style: { stroke: '#f00' } }
+    const p = { ...mk(PREVIEW_ID), id: PREVIEW_ID }
+    expect(mergePaint([a], [a2, p]).map((d) => d.id)).toEqual(['a', PREVIEW_ID])
+    expect(mergePaint([a], [a2, p])[0]!.style.stroke).toBe('#f00')
   })
 })

package/src/engine/drawing/__tests__/drawingStore.projection.test.ts

@@ -3,6 +3,7 @@ import { describe, expect, it } from 'vitest'
 import type { DrawingObject } from '../../../foundation/plugin/index'
 import { createDrawingState } from '../../state/drawingState'
 import { DrawingStore } from '../index'
+import { PREVIEW_ID } from '../DrawingState'
 
 function mk(id: string, paneId = 'main'): DrawingObject {
   return {
@@ -35,4 +36,25 @@ describe('DrawingStore projection', () => {
     expect(store.getAll().map((d) => d.id)).toEqual(['c'])
     expect(store.getSelectedId()).toBeNull()
   })
+
+  it('merges session overlay for paint without changing kernel signal', () => {
+    const state = createDrawingState()
+    state.actions.setDrawings([mk('a')])
+    let overlay: DrawingObject[] = []
+
+    const store = new DrawingStore({
+      drawings$: state.readonly.drawings,
+      selectedDrawingId$: state.readonly.selectedDrawingId,
+      getOverlay: () => overlay,
+    })
+
+    overlay = [{ ...mk(PREVIEW_ID), id: PREVIEW_ID }]
+    expect(store.getAll().map((d) => d.id)).toEqual(['a', PREVIEW_ID])
+    expect(state.readonly.drawings.peek().map((d) => d.id)).toEqual(['a'])
+
+    const moved = { ...mk('a'), style: { stroke: '#0f0' } }
+    overlay = [moved]
+    expect(store.getAll()).toHaveLength(1)
+    expect(store.getAll()[0]!.style.stroke).toBe('#0f0')
+  })
 })

package/src/engine/drawing/index.ts

@@ -26,14 +26,17 @@ export type {
 }
 
 import type { ReadonlySignal } from '../../foundation/reactivity/signal'
+import { mergePaint } from './DrawingState'
 
 export interface DrawingStoreDeps {
   drawings$: ReadonlySignal<ReadonlyArray<DrawingObject>>
   selectedDrawingId$: ReadonlySignal<string | null>
+  /** 会话层覆盖（拖拽/预览）；缺省为空 */
+  getOverlay?: () => ReadonlyArray<DrawingObject>
 }
 
 /**
- * 绘图投影器 —— 业务态在 kernel.drawing；此类只读 signal 供渲染插件使用。
+ * 绘图投影器 —— kernel 业务 SSOT ⊕ 会话 overlay，供渲染插件读取。
  */
 export class DrawingStore {
   constructor(private readonly deps: DrawingStoreDeps) {}
@@ -42,13 +45,18 @@ export class DrawingStore {
     return this.deps.selectedDrawingId$.peek()
   }
 
+  private paintList(): DrawingObject[] {
+    const committed = this.deps.drawings$.peek()
+    const overlay = this.deps.getOverlay?.() ?? []
+    return mergePaint(committed, overlay)
+  }
+
   getAll(): DrawingObject[] {
-    return [...this.deps.drawings$.peek()]
+    return this.paintList()
   }
 
   getVisibleByPane(paneId: string): DrawingObject[] {
-    return this.deps.drawings$
-      .peek()
+    return this.paintList()
       .filter((drawing) => drawing.visible && drawing.paneId === paneId)
       .slice()
       .sort((a, b) => (a.zIndex ?? 0) - (b.zIndex ?? 0))

package/src/engine/drawing/interaction.ts

@@ -1,5 +1,5 @@
 import type { DrawingChartAdapter } from '../../controllers/types'
-import type { DrawingObject, DrawingKind, DrawingStyle } from '../../foundation/plugin/index'
+import type { DrawingObject, DrawingStyle } from '../../foundation/plugin/index'
 
 import { AnchorCollector } from './AnchorCollector'
 import { DragHandler } from './DragHandler'
@@ -22,16 +22,9 @@ export interface DrawingInteractionCallbacks {
 }
 
 /**
- * 绘图交互控制器 v2 — 精简事件路由，组合子模块。
+ * 绘图交互控制器 —— 精简事件路由，组合子模块。
  *
- * ┌─────────────────────────────────────┐
- * │ DrawingInteractionController        │
- * │  ├─ DrawingState     (图元 CRUD)   │
- * │  ├─ AnchorCollector  (锚点累积)    │
- * │  ├─ PreviewRenderer  (预览构建)    │
- * │  ├─ HitTester        (命中检测)    │
- * │  └─ DragHandler      (拖拽管理)    │
- * └─────────────────────────────────────┘
+ * 已确认图元只写 kernel；预览与拖拽覆盖只在 DrawingState 会话层。
  */
 export class DrawingInteractionController {
   private adapter: DrawingChartAdapter
@@ -52,16 +45,19 @@ export class DrawingInteractionController {
     this.dragHandler = new DragHandler()
   }
 
+  /** 渲染合成用：拖拽覆盖 + 预览 */
+  getPaintOverlay(): DrawingObject[] {
+    return this.drawingState.getPaintOverlay()
+  }
+
   // ============ 配置 ============
 
-  /** 注册回调（创建/选中/工具切换事件通知） */
   setCallbacks(callbacks: DrawingInteractionCallbacks) {
     this.callbacks = callbacks
   }
 
   // ============ 工具状态 ============
 
-  /** 返回当前激活的绘图工具 ID（读 kernel SSOT） */
   getActiveTool(): DrawingToolId {
     return this.adapter.getDrawingToolId()
   }
@@ -72,51 +68,48 @@ export class DrawingInteractionController {
   applyToolSession(toolId: DrawingToolId): void {
     this.anchorCollector.reset()
     this.drawingState.removePreview()
-    this.dragHandler.endDrag()
+    if (this.dragHandler.isDragging()) {
+      this.drawingState.clearDragOverride()
+      this.dragHandler.endDrag()
+    }
     this.setSelected(null)
     this.callbacks.onToolChange?.(toolId)
   }
 
-  /**
-   * 切换绘图工具 —— 经 adapter 写 kernel（Chart 单写路径）。
-   */
   setTool(toolId: DrawingToolId) {
     this.adapter.setDrawingToolId(toolId)
   }
 
-  // ============ 图元 CRUD（委托 DrawingState） ============
+  // ============ 图元 CRUD ============
 
-  /** 返回所有图元（含预览） */
   getDrawings(): DrawingObject[] {
     return this.drawingState.getAll()
   }
 
-  /** 整体替换图元列表 */
   setDrawings(drawings: DrawingObject[]) {
     this.drawingState.setDrawings(drawings)
   }
 
-  /** 清空锚点累积、预览、拖拽状态及所有图元 */
   clear() {
     this.anchorCollector.reset()
     this.drawingState.removePreview()
-    this.dragHandler.endDrag()
+    if (this.dragHandler.isDragging()) {
+      this.drawingState.clearDragOverride()
+      this.dragHandler.endDrag()
+    }
     this.drawingState.clear()
   }
 
-  /** 更新指定图元的样式（合并） */
   updateDrawingStyle(drawingId: string, style: Partial<DrawingStyle>): void {
     this.drawingState.updateDrawingStyle(drawingId, style)
   }
 
-  /** 删除指定图元 */
   removeDrawing(drawingId: string): void {
     this.drawingState.removeDrawing(drawingId)
   }
 
   // ============ 选中状态 ============
 
-  /** 返回当前选中的图元 */
   getSelectedDrawing(): DrawingObject | null {
     return this.drawingState.getSelected()
   }
@@ -124,25 +117,23 @@ export class DrawingInteractionController {
   // ============ 事件处理 ============
 
   /**
-   * 指针移动事件入口。
-   * 拖拽中 → 委托 DragHandler 更新锚点；绘图模式 → 构建预览图元。
+   * 指针移动：拖拽只写会话覆盖；绘图模式只写预览。均不写 kernel。
    * @returns true 表示事件已消费，需要重绘
    */
   onPointerMove(e: PointerEvent, container: HTMLElement): boolean {
-    // 1) 正在拖拽
     if (this.dragHandler.isDragging()) {
       const drawing = this.drawingState.getById(this.dragHandler.getDraggingDrawingId() ?? '')
       if (!drawing) {
+        this.drawingState.clearDragOverride()
         this.dragHandler.endDrag()
         return false
       }
       const updated = this.dragHandler.handleDragMove(drawing, e, container, this.adapter)
       if (!updated) return false
-      this.drawingState.addOrUpdate(updated)
+      this.drawingState.setDragOverride(updated)
       return true
     }
 
-    // 2) 绘图工具预览
     const activeTool = this.getActiveTool()
     if (activeTool !== 'cursor') {
       const anchor = resolveAnchorFromPointer(e, container, this.adapter)
@@ -169,30 +160,25 @@ export class DrawingInteractionController {
   }
 
   /**
-   * 指针按下事件入口。
-   * 光标模式 → 命中检测 + 选中 + 拖拽开始；绘图模式 → 创建或累积锚点。
+   * 指针按下：光标模式命中+选中+开拖；绘图模式创建或累积锚点。
    * @returns true 表示事件已消费
    */
   onPointerDown(e: PointerEvent, container: HTMLElement): boolean {
     const activeTool = this.getActiveTool()
-    // 光标模式：命中检测 → 选中 → 开始拖拽
     if (activeTool === 'cursor') {
       return this.handleCursorDown(e, container)
     }
 
-    // 绘图模式
     const anchor = resolveAnchorFromPointer(e, container, this.adapter)
     if (!anchor) return false
 
     const anchorCount = getAnchorCountForTool(activeTool)
 
-    // 单锚点工具：点击即创建
     if (anchorCount === 1) {
       this.createSingleAnchorDrawing(anchor, activeTool)
       return true
     }
 
-    // 多锚点工具：累积
     if (anchorCount === 2 || anchorCount === 3) {
       const result = this.anchorCollector.addAnchor(anchor, activeTool)
       if (result) {
@@ -205,18 +191,18 @@ export class DrawingInteractionController {
   }
 
   /**
-   * 指针抬起事件入口。结束拖拽。
+   * 指针抬起：拖拽结果一次 commit 到 kernel。
    * @returns true 表示事件已消费
    */
   onPointerUp(_e: PointerEvent, _container: HTMLElement): boolean {
     if (!this.dragHandler.isDragging()) return false
+    this.drawingState.commitDrag()
     this.dragHandler.endDrag()
     return true
   }
 
   // ============ 私有方法 ============
 
-  /** 光标模式下指针按下：命中检测 → 选中 → 开始拖拽 */
   private handleCursorDown(e: PointerEvent, container: HTMLElement): boolean {
     const rect = container.getBoundingClientRect()
     const mouseX = e.clientX - rect.left
@@ -244,13 +230,11 @@ export class DrawingInteractionController {
     return true
   }
 
-  /** 设置选中图元并通知回调 */
   private setSelected(drawing: DrawingObject | null) {
     this.drawingState.setSelected(drawing)
     this.callbacks.onDrawingSelected?.(drawing)
   }
 
-  /** 单锚点工具：点击即创建图元，完成后切回光标模式 */
   private createSingleAnchorDrawing(anchor: DrawingAnchorInput, activeTool: DrawingToolId) {
     this.drawingState.removePreview()
 
@@ -280,7 +264,6 @@ export class DrawingInteractionController {
     this.adapter.setDrawingToolId('cursor')
   }
 
-  /** 多锚点工具（2-3 锚点）：锚点累积满后创建图元，完成后切回光标模式 */
   private createMultiAnchorDrawing(anchors: DrawingAnchorInput[], activeTool: DrawingToolId) {
     this.drawingState.removePreview()
 
@@ -327,3 +310,5 @@ export class DrawingInteractionController {
     this.adapter.setDrawingToolId('cursor')
   }
 }
+
+export { PREVIEW_ID }

package/src/engine/indicators/chartIndicatorManager.ts

@@ -13,7 +13,6 @@ import {
 } from '../../foundation/reactivity/signal'
 import type { MainIndicatorEntry } from '../state/indicatorState'
 import type { SubPaneSpec } from '../state/subPaneState'
-import { createLayerFromPlugin } from '../../rendering/scene/createLayerFromPlugin'
 import type { Layer } from '../../rendering/scene/types'
 import type { KLineData } from '../../foundation/types/price'
 import type { IndicatorInstance, SubPaneInfo, PaneSpec, ChartOptions } from '../chartTypes'
@@ -371,29 +370,21 @@ export class ChartIndicatorManager {
 
     if (!existingLayer) {
       const plugin = definition.rendererFactory({ paneId: 'main', indicatorId })
-      // register with old system for getRenderer compatibility
+      // useRenderer：注册表 + 唯一 Scene Layer
       this.deps.useRenderer(plugin)
-      // disable old rendering to avoid double rendering (scene handles it)
-      this.deps.setRendererEnabled(rendererName, false)
-      // create bridge layer and add to scene
-      const layer = createLayerFromPlugin(plugin, () => this.deps.getRenderContext('main'), 'main')
-      this.deps.addLayer(layer)
     }
 
     this.deps.setLayerVisibility(layerId, true)
 
-    if (!this.deps.getRenderer('mainIndicatorLegend')) {
+    // core 可能已挂 legend Layer 且未进 Manager；两者任一存在都不再注册第二实例
+    if (
+      !this.deps.getLayer('plugin:mainIndicatorLegend') &&
+      !this.deps.getRenderer('mainIndicatorLegend')
+    ) {
       const legend = createMainIndicatorLegendRendererPlugin({
         yPaddingPx: this.deps.getOption().yPaddingPx,
       })
       this.deps.useRenderer(legend)
-      this.deps.setRendererEnabled('mainIndicatorLegend', false)
-      const legendLayer = createLayerFromPlugin(
-        legend,
-        () => this.deps.getRenderContext('main'),
-        'main',
-      )
-      this.deps.addLayer(legendLayer)
     }
   }
 
@@ -402,7 +393,6 @@ export class ChartIndicatorManager {
       this.indicatorScheduler.getIndicatorMetadata(indicatorId)?.mainPane?.rendererName
     if (rendererName) {
       this.deps.setRendererEnabled(rendererName, false)
-      this.deps.setLayerVisibility(`plugin:${rendererName}`, false)
     }
   }
 

package/src/engine/layout/chartPaneLayout.ts

@@ -1,7 +1,6 @@
 import type { PaneRole } from '../../foundation/plugin/index'
 import type { ChartDom, PaneSpec, Viewport } from '../chartTypes'
 import { PaneRenderer } from '../paneRenderer'
-import type { SharedWebGLSurface } from '../renderers/webgl/sharedWebGLSurface'
 import type { ScaleType } from '../utils/tickPosition'
 
 import { Pane, UpdateLevel } from './pane'
@@ -18,7 +17,6 @@ export interface PaneLayoutDependencies {
     defaultPaneMinHeightPx?: number
   }
   getViewport: () => Viewport | null
-  getSharedWebGLSurface: () => SharedWebGLSurface
   setKnownPaneIds: (ids: string[]) => void
   notifyPaneResize: (paneId: string, pane: Pane) => void
   scheduleDraw: (level?: UpdateLevel) => void
@@ -140,6 +138,7 @@ export class ChartPaneLayout {
       mainCanvas.style.position = 'absolute'
       mainCanvas.style.left = '0'
       mainCanvas.style.top = '0'
+      mainCanvas.style.zIndex = '0'
 
       overlayCanvas.id = `${spec.id}-overlay`
       overlayCanvas.className = 'overlay-canvas'
@@ -148,6 +147,7 @@ export class ChartPaneLayout {
       overlayCanvas.style.top = '0'
       overlayCanvas.style.pointerEvents = 'none'
       overlayCanvas.style.backgroundColor = 'transparent'
+      overlayCanvas.style.zIndex = '2'
 
       const leftYAxisCanvas = this.createAxisCanvas(spec, pane, 'left')
 
@@ -160,7 +160,6 @@ export class ChartPaneLayout {
           yPaddingPx: this.deps.getOption().yPaddingPx,
           priceLabelWidth: this.deps.getOption().priceLabelWidth,
         },
-        this.deps.getSharedWebGLSurface(),
       )
 
       return renderer
@@ -171,7 +170,10 @@ export class ChartPaneLayout {
     const rightAxisLayer = dom.rightAxisLayer
     const leftAxisLayer = dom.leftAxisLayer
     if (canvasLayer) {
-      const existingCanvases = canvasLayer.querySelectorAll('canvas:not(.x-axis-canvas)')
+      // 保留 chart 级 WebGPU scene canvas（M2 hybrid DOM）
+      const existingCanvases = canvasLayer.querySelectorAll(
+        'canvas:not(.x-axis-canvas):not(.gpu-scene-canvas)',
+      )
       existingCanvases.forEach((canvas) => canvas.remove())
     }
     if (rightAxisLayer) {
@@ -330,13 +332,6 @@ export class ChartPaneLayout {
       pane.setPadding(opt.yPaddingPx, opt.yPaddingPx)
 
       renderer.resize(vp.plotWidth, h, vp.dpr)
-      renderer.setWebGLRegion({
-        x: 0,
-        y,
-        width: vp.plotWidth,
-        height: h,
-        dpr: vp.dpr,
-      })
       this.deps.notifyPaneResize(pane.id, pane)
       const domEls = renderer.getDom()
       domEls.mainCanvas.style.top = `${y}px`

package/src/engine/layout/pane.ts

@@ -1,6 +1,5 @@
 import type { PaneCapabilities, PaneRole } from '../../foundation/plugin/index'
 import type { KLineData } from '../../foundation/types/price'
-import type { MarkerManager } from '../marker/registry'
 import type { PriceRange } from '../scale/price'
 import { PriceScale } from '../scale/priceScale'
 import { getVisiblePriceRange } from '../viewport/viewport'
@@ -49,38 +48,6 @@ function defaultCapabilitiesByRole(role: PaneRole): PaneCapabilities {
   }
 }
 
-/**
- * Pane 级渲染器接口：在单个 pane 的坐标系中绘制内容
- */
-export interface PaneRenderer {
-  /**
-   * 在指定 pane 坐标系中绘制内容
-   * @param ctx Canvas 绘图上下文，Chart 已执行 translate(0, pane.top)，y=0 对应 pane 顶部
-   * @param pane 当前 pane 实例
-   * @param data 全量 K 线数据
-   * @param range 当前视口可见的索引范围
-   * @param scrollLeft 滚动偏移量，renderer 内部如需 world 坐标需执行 ctx.translate(-scrollLeft, 0)
-   * @param kWidth K 线宽度
-   * @param kGap K 线间隔
-   * @param dpr 设备像素比
-   * @param paneWidth pane 宽度
-   * @param kLinePositions 可选，K 线起始 x 坐标数组（由 Chart 统一计算）
-   */
-  draw(args: {
-    ctx: CanvasRenderingContext2D
-    pane: Pane
-    data: KLineData[]
-    range: VisibleRange
-    scrollLeft: number
-    kWidth: number
-    kGap: number
-    dpr: number
-    paneWidth: number
-    kLinePositions: number[]
-    markerManager?: MarkerManager
-  }): void
-}
-
 /**
  * Pane：代表一个"窗口区域"（主图 / 副图）
  */
@@ -97,9 +64,6 @@ export class Pane {
   /** pane 独立 Y 轴 */
   readonly yAxis = new PriceScale()
 
-  /** 该 pane 的渲染器列表 */
-  readonly renderers: PaneRenderer[] = []
-
   /**
    * 创建 pane 实例
    * @param id pane 标识符（例如 'main'、'sub'），用于在 Chart/Interaction 中识别 pane
@@ -133,14 +97,6 @@ export class Pane {
     this.yAxis.setPadding(top, bottom)
   }
 
-  /**
-   * 注册一个 pane 级渲染器
-   * @param renderer pane 级渲染器实例
-   */
-  addRenderer(renderer: PaneRenderer) {
-    this.renderers.push(renderer)
-  }
-
   /**
    * 根据当前可见索引区间更新 priceRange 并同步到 yAxis
    * @param data 全量 K 线数据