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

package/dist/rendering/scene/retainedScene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retainedScene.d.ts","sourceRoot":"","sources":["../../../src/rendering/scene/retainedScene.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AAEjC,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,YAAY,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,YAAY,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,YAAY,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,aAAa,CAAC;QACpB,MAAM,EAAE,aAAa,CAAC;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC/C,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;IACF,UAAU,EAAE,MAAM,CAAA;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,YAAY,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,aAAa,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9C,KAAK,EAAE,aAAa,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9C,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAMxD,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC7B,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAA;IAC5C,QAAQ,IAAI,IAAI,CAAA;IAChB,KAAK,IAAI,MAAM,EAAE,CAAA;IACjB,KAAK,IAAI,IAAI,CAAA;CACd,CAAA;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAwCrF"}

package/dist/rendering/scene/retainedScene.js

@@ -0,0 +1,42 @@
+export function createRetainedScene(options = {}) {
+    const staleFrames = options.staleFrames ?? 2;
+    const nodes = new Map();
+    let frameNumber = 0;
+    return {
+        beginFrame(nextFrameNumber) {
+            frameNumber = nextFrameNumber;
+        },
+        upsert(node) {
+            nodes.set(node.key, {
+                ...node,
+                lastTouchedFrame: frameNumber,
+            });
+        },
+        collectVisible(paneId) {
+            const result = [];
+            for (const stored of nodes.values()) {
+                if (paneId !== undefined && stored.paneId !== paneId)
+                    continue;
+                const { lastTouchedFrame: _lastTouchedFrame, ...node } = stored;
+                result.push(node);
+            }
+            result.sort((a, b) => a.z - b.z || a.key.localeCompare(b.key));
+            return result;
+        },
+        endFrame() { },
+        prune() {
+            const removed = [];
+            for (const [key, stored] of nodes) {
+                if (frameNumber - stored.lastTouchedFrame >= staleFrames) {
+                    nodes.delete(key);
+                    removed.push(key);
+                }
+            }
+            return removed;
+        },
+        clear() {
+            nodes.clear();
+        },
+    };
+}
+//# sourceMappingURL=retainedScene.js.map

package/dist/rendering/scene/retainedScene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retainedScene.js","sourceRoot":"","sources":["../../../src/rendering/scene/retainedScene.ts"],"names":[],"mappings":"AA4DA,MAAM,UAAU,mBAAmB,CAAC,UAAgC,EAAE;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAA;IAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAA;IACjD,IAAI,WAAW,GAAG,CAAC,CAAA;IAEnB,OAAO;QACL,UAAU,CAAC,eAAe;YACxB,WAAW,GAAG,eAAe,CAAA;QAC/B,CAAC;QACD,MAAM,CAAC,IAAI;YACT,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE;gBAClB,GAAG,IAAI;gBACP,gBAAgB,EAAE,WAAW;aAC9B,CAAC,CAAA;QACJ,CAAC;QACD,cAAc,CAAC,MAAM;YACnB,MAAM,MAAM,GAAgB,EAAE,CAAA;YAC9B,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;oBAAE,SAAQ;gBAC9D,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;gBAC/D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YAC9D,OAAO,MAAM,CAAA;QACf,CAAC;QACD,QAAQ,KAAU,CAAC;QACnB,KAAK;YACH,MAAM,OAAO,GAAa,EAAE,CAAA;YAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBAClC,IAAI,WAAW,GAAG,MAAM,CAAC,gBAAgB,IAAI,WAAW,EAAE,CAAC;oBACzD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;oBACjB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACnB,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,KAAK;YACH,KAAK,CAAC,KAAK,EAAE,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.9.0-alpha.0";
+export declare const VERSION = "0.9.0-alpha.2";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.9.0-alpha.0';
+export const VERSION = '0.9.0-alpha.2';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@363045841yyt/klinechart-core",
-  "version": "0.9.0-alpha.0",
+  "version": "0.9.0-alpha.2",
   "description": "Headless K-line chart engine + reactive controllers. Zero framework dependencies.",
   "license": "MIT",
   "repository": {
@@ -126,6 +126,7 @@
     "@arethetypeswrong/cli": "^0.18.3",
     "@size-limit/preset-small-lib": "^12.1.0",
     "@types/jsdom": "^28.0.0",
+    "@webgpu/types": "^0.1.71",
     "publint": "^0.3.0",
     "size-limit": "^12.1.0",
     "typescript": "~6.0.3",

package/src/__tests__/signal.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect, vi } from 'vitest'
 
-import { createSignal, effect, computed } from '../foundation/reactivity/signal'
+import { createSignal, effect, computed, selectSignal } from '../foundation/reactivity/signal'
 
 describe('createSignal', () => {
   it('reads initial value', () => {
@@ -123,3 +123,49 @@ describe('computed', () => {
     expect(listener).toHaveBeenCalledTimes(1)
   })
 })
+
+describe('selectSignal', () => {
+  it('notifies only when selected value changes', () => {
+    const source = createSignal({ a: 1, b: 2 })
+    const selected = selectSignal(source, (s) => s.a)
+    const listener = vi.fn()
+    selected.subscribe(listener)
+
+    source.set({ a: 1, b: 9 })
+    expect(listener).not.toHaveBeenCalled()
+    expect(selected.peek()).toBe(1)
+
+    source.set({ a: 3, b: 9 })
+    expect(listener).toHaveBeenCalledTimes(1)
+    expect(selected.peek()).toBe(3)
+  })
+
+  it('supports custom equality for structural fields', () => {
+    const source = createSignal({ pos: { x: 1, y: 2 } as { x: number; y: number } | null })
+    const selected = selectSignal(
+      source,
+      (s) => s.pos,
+      (a, b) =>
+        a === b || (a !== null && b !== null && a.x === b.x && a.y === b.y) || (a === null && b === null),
+    )
+    const listener = vi.fn()
+    selected.subscribe(listener)
+
+    source.set({ pos: { x: 1, y: 2 } })
+    expect(listener).not.toHaveBeenCalled()
+
+    source.set({ pos: { x: 2, y: 2 } })
+    expect(listener).toHaveBeenCalledTimes(1)
+  })
+
+  it('dispose stops following source updates', () => {
+    const source = createSignal({ a: 1, b: 0 })
+    const selected = selectSignal(source, (s) => s.a)
+    const listener = vi.fn()
+    selected.subscribe(listener)
+    selected.dispose()
+    source.set({ a: 9, b: 0 })
+    expect(listener).not.toHaveBeenCalled()
+    expect(selected.peek()).toBe(1)
+  })
+})

package/src/controllers/__tests__/createChartController.theme.test.ts

@@ -0,0 +1,102 @@
+// @vitest-environment jsdom
+import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest'
+
+import { createChartController } from '../createChartController'
+import { loadBuiltinIndicators } from '../../engine/indicators/registerBuiltins'
+
+class ResizeObserverMock {
+  observe = vi.fn()
+  disconnect = vi.fn()
+  unobserve = vi.fn()
+}
+
+function createCanvasContextStub() {
+  return {
+    setTransform: vi.fn(),
+    scale: vi.fn(),
+    clearRect: vi.fn(),
+    save: vi.fn(),
+    restore: vi.fn(),
+    beginPath: vi.fn(),
+    moveTo: vi.fn(),
+    lineTo: vi.fn(),
+    stroke: vi.fn(),
+    fillRect: vi.fn(),
+    strokeRect: vi.fn(),
+    fillText: vi.fn(),
+    measureText: vi.fn(() => ({ width: 40 })),
+  } as unknown as CanvasRenderingContext2D
+}
+
+function createWebGLStub(): WebGL2RenderingContext {
+  const noop = () => {}
+  return new Proxy({} as unknown as WebGL2RenderingContext, {
+    get(_, prop) {
+      if (typeof prop !== 'string') return undefined
+      if (/^[A-Z][A-Z0-9_]*$/.test(prop)) return 0
+      if (prop === 'getShaderInfoLog' || prop === 'getProgramInfoLog') return () => ''
+      if (prop === 'getShaderParameter' || prop === 'getProgramParameter') return () => true
+      if (prop === 'getError') return () => 0
+      if (prop === 'getSupportedExtensions') return () => []
+      if (prop === 'getContextAttributes') return () => ({})
+      if (prop === 'getParameter') return () => 0
+      if (prop === 'getUniformLocation' || prop === 'getAttribLocation') return () => 0
+      if (prop.startsWith('create') || prop === 'getExtension') return () => ({ __webglStub: true })
+      if (prop === 'drawingBufferWidth' || prop === 'drawingBufferHeight') return 300
+      return noop
+    },
+  })
+}
+
+describe('createChartController mount theme', () => {
+  beforeAll(async () => {
+    await loadBuiltinIndicators()
+  })
+
+  beforeEach(() => {
+    vi.stubGlobal('ResizeObserver', ResizeObserverMock)
+    HTMLCanvasElement.prototype.getContext = vi.fn((type: string) => {
+      if (type === '2d') return createCanvasContextStub()
+      if (type === 'webgl2' || type === 'webgl') return createWebGLStub()
+      return null
+    }) as never
+  })
+
+  afterEach(() => {
+    vi.unstubAllGlobals()
+    vi.restoreAllMocks()
+  })
+
+  it('opts.theme light overrides settings default dark', async () => {
+    const container = document.createElement('div')
+    Object.defineProperty(container, 'clientWidth', { value: 800, configurable: true })
+    Object.defineProperty(container, 'clientHeight', { value: 600, configurable: true })
+    document.body.appendChild(container)
+
+    const ctrl = await createChartController({
+      container,
+      theme: 'light',
+    })
+
+    expect(ctrl.settings.peek().theme).toBe('light')
+    expect(ctrl.theme.peek()).toBe('light')
+
+    ctrl.dispose()
+    container.remove()
+  })
+
+  it('without opts.theme keeps default dark preference', async () => {
+    const container = document.createElement('div')
+    Object.defineProperty(container, 'clientWidth', { value: 800, configurable: true })
+    Object.defineProperty(container, 'clientHeight', { value: 600, configurable: true })
+    document.body.appendChild(container)
+
+    const ctrl = await createChartController({ container })
+
+    expect(ctrl.settings.peek().theme).toBe('dark')
+    expect(ctrl.theme.peek()).toBe('dark')
+
+    ctrl.dispose()
+    container.remove()
+  })
+})

package/src/controllers/createChartController.ts

@@ -28,6 +28,10 @@ import { zoomLevelToKWidth, kGapFromKWidth } from '../engine/utils/zoom'
 import { KLineChartError } from '../errors'
 import { ChartBridge } from '../features/mcp/chartBridge'
 import { computed, type ReadonlySignal } from '../foundation/reactivity/index'
+import {
+  createDefaultRendererHost,
+  type RendererBackend,
+} from '../rendering/render/index'
 
 import type {
   ChartController,
@@ -334,6 +338,10 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
     initialZoomLevel,
   }
 
+  const initialSettings = resolveSettings(opts.settings)
+  const rendererHost = await createDefaultRendererHost(
+    initialSettings.rendererBackend as RendererBackend,
+  )
   const chart = new Chart(
     {
       container: mounted.container,
@@ -344,8 +352,13 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
       xAxisCanvas: mounted.xAxisCanvas,
     },
     chartOptions,
+    { rendererHost, initialSettings },
   )
 
+  if (import.meta.env?.MODE !== 'production' && typeof window !== 'undefined') {
+    ;(window as any).__chart = chart
+  }
+
   const currentDpr =
     typeof window !== 'undefined' && window.devicePixelRatio > 0 ? window.devicePixelRatio : 1
   const currentKWidth = zoomLevelToKWidth(initialZoomLevel, {
@@ -373,8 +386,9 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
   const comparisonLoading = chart.comparisonLoading
 
   // Signals from ChartStateKernel — no wrapper needed
-  const themeSignal: ReadonlySignal<'light' | 'dark'> = chart.kernel.theme.readonly.theme
+  const themeSignal: ReadonlySignal<'light' | 'dark'> = chart.theme
   const settingsSignal = chart.kernel.settings.readonly.settings
+  const rendererRuntimeSignal = chart.kernel.renderer.readonly.runtime
   const chartModeSignal = chart.kernel.mode.readonly.chartMode
   const drawingTool = chart.kernel.drawing.readonly.drawingTool
   // drawings need type mapping (plugin DrawingObject → controller DrawingObject)
@@ -414,8 +428,8 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
     chart.setSymbols(opts.symbols)
   }
 
-  // Apply initial theme if non-default
-  if (opts.theme && opts.theme !== 'light') {
+  // Apply mount theme preference (settings default may be dark — always honor explicit opts.theme)
+  if (opts.theme) {
     try {
       chart.setTheme(opts.theme)
     } catch {
@@ -423,15 +437,6 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
     }
   }
 
-  // Apply initial settings (partial, merged with defaults)
-  if (opts.settings) {
-    try {
-      chart.updateSettingsFacade(resolveSettings(opts.settings))
-    } catch {
-      /* tolerate first-paint racing */
-    }
-  }
-
   // -------------------------------------------------------------------
   // Apply initial render state + seed data
   // -------------------------------------------------------------------
@@ -537,6 +542,11 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
     chart.setTheme(nextTheme)
   }
 
+  function setSystemTheme(nextTheme: 'light' | 'dark'): void {
+    if (disposed) return
+    chart.setSystemTheme(nextTheme)
+  }
+
   function zoomToLevel(level: number, anchorX?: number): void {
     if (disposed) return
     chart.zoomToLevel(level, anchorX)
@@ -714,11 +724,21 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
     return chart.drawings() as any[]
   }
 
+  function requestDraw(): void {
+    if (disposed) return
+    chart.scheduleDraw()
+  }
+
   function setSelectedDrawingId(id: string | null): void {
     if (disposed) return
     chart.setSelectedDrawingId(id)
   }
 
+  function getSelectedDrawingId(): string | null {
+    if (disposed) return null
+    return chart.kernel.drawing.readonly.selectedDrawingId.peek()
+  }
+
   function getViewport(): { scrollLeft: number; plotWidth: number; plotHeight: number } | null {
     if (disposed) return null
     const vp = chart.getViewport()
@@ -891,6 +911,7 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
     symbols,
     theme: themeSignal,
     settings: settingsSignal,
+    rendererRuntime: rendererRuntimeSignal,
     chartMode: chartModeSignal,
     indicators,
     subPanes,
@@ -924,6 +945,7 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
     getData,
     getZoomLevelCount,
     setTheme,
+    setSystemTheme,
     zoomToLevel,
     zoomIn,
     zoomOut,
@@ -949,7 +971,9 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
     removeDrawing,
     setDrawings,
     getFullDrawings,
+    requestDraw,
     setSelectedDrawingId,
+    getSelectedDrawingId,
     getViewport,
     getKWidthKGap,
     getCurrentDpr,

package/src/controllers/index.ts

@@ -31,6 +31,11 @@ export type {
   DataFetcher,
   CustomDataSource,
 } from './types'
+export type {
+  RendererBackend,
+  RendererBackendRuntime,
+  RendererBackendStatus,
+} from '../rendering/render/rendererHost'
 
 export { createChartController } from './createChartController'
 export { createIndicatorSelectorController } from './createIndicatorSelectorController'

package/src/controllers/types.ts

@@ -202,10 +202,17 @@ export interface DrawingChartAdapter {
   getFullDrawings(): any[]
   /** highlight a drawing by ID */
   setSelectedDrawingId(id: string | null): void
+  /** read selected drawing id from kernel */
+  getSelectedDrawingId(): string | null
   /** write drawing tool id via Chart (kernel SSOT + session side effects) */
   setDrawingToolId(toolId: import('../engine/drawing/toolConfig').DrawingToolId): void
   /** read current drawing tool id from kernel */
   getDrawingToolId(): import('../engine/drawing/toolConfig').DrawingToolId
+  /**
+   * 会话态变更后请求重绘（不写 kernel）。
+   * 预览 / 拖拽中间态只改会话层时调用。
+   */
+  requestDraw?(): void
   /** current viewport (nullable if chart not ready) */
   getViewport(): DrawingChartViewport | null
   /** resolved chart options (kWidth, kGap) */
@@ -291,6 +298,10 @@ export interface ChartController extends DrawingChartAdapter {
   readonly settings: ReadonlySignal<
     Readonly<import('../foundation/config/chartSettings').ChartSettings>
   >
+  /** 当前有效 renderer、切换状态和最近错误。 */
+  readonly rendererRuntime: ReadonlySignal<
+    Readonly<import('../rendering/render/rendererHost').RendererBackendRuntime>
+  >
   /** 图表模式 id：kline | timeshare */
   readonly chartMode: ReadonlySignal<'kline' | 'timeshare'>
   readonly indicators: ReadonlySignal<ReadonlyArray<IndicatorInstance>>
@@ -343,7 +354,10 @@ export interface ChartController extends DrawingChartAdapter {
   ensureDataRange(startTs: number): void
 
   // ---- Theme ----
+  /** 设置主题偏好 light|dark（写 settings） */
   setTheme(theme: 'light' | 'dark'): void
+  /** 注入系统主题（settings.theme === auto 时驱动 effectiveTheme） */
+  setSystemTheme(theme: 'light' | 'dark'): void
 
   // ---- Zoom ----
   zoomToLevel(level: number, anchorX?: number): void

package/src/engine/__tests__/chart.dpr.test.ts

@@ -521,6 +521,70 @@ describe('Chart pane layout regressions', () => {
     await chart.destroy()
   })
 
+  it('removeDrawing drops id from kernel and clears selection', async () => {
+    const chart = new Chart(createDom(1000, 600), defaultOptions)
+    const d1 = {
+      id: 'd1',
+      kind: 'trend-line' as const,
+      paneId: 'main',
+      visible: true,
+      anchors: [],
+      params: {},
+      style: { stroke: '#f00' },
+    }
+    const d2 = { ...d1, id: 'd2' }
+    chart.setDrawings([d1, d2])
+    chart.setSelectedDrawingId('d1')
+    chart.removeDrawing('d1')
+    expect(chart.kernel.drawing.readonly.drawings.peek().map((d) => d.id)).toEqual(['d2'])
+    expect(chart.kernel.drawing.readonly.selectedDrawingId.peek()).toBeNull()
+    await chart.destroy()
+  })
+
+  it('removeDrawing with registered session updates kernel only', async () => {
+    const { DrawingInteractionController } = await import('../drawing/interaction')
+    const chart = new Chart(createDom(1000, 600), defaultOptions)
+    const d1 = {
+      id: 'd1',
+      kind: 'trend-line' as const,
+      paneId: 'main',
+      visible: true,
+      anchors: [],
+      params: {},
+      style: { stroke: '#f00' },
+    }
+    const d2 = { ...d1, id: 'd2' }
+    chart.setDrawings([d1, d2])
+    chart.setSelectedDrawingId('d1')
+
+    const adapter = {
+      setDrawings: (list: typeof d1[]) => chart.setDrawings(list),
+      getFullDrawings: () => [...chart.kernel.drawing.readonly.drawings.peek()],
+      setSelectedDrawingId: (id: string | null) => chart.setSelectedDrawingId(id),
+      getSelectedDrawingId: () => chart.kernel.drawing.readonly.selectedDrawingId.peek(),
+      setDrawingToolId: (id: import('../drawing/toolConfig').DrawingToolId) =>
+        chart.setDrawingTool(id),
+      getDrawingToolId: () => chart.kernel.drawing.readonly.drawingTool.peek(),
+      requestDraw: () => chart.scheduleDraw(),
+      getViewport: () => null,
+      getKWidthKGap: () => ({ kWidth: 6, kGap: 2 }),
+      getCurrentDpr: () => 1,
+      getData: () => [],
+      getLogicalIndexAtX: () => null,
+      getTimestampAtLogicalIndex: () => null,
+      priceToY: () => 0,
+      yToPrice: () => 0,
+      getPaneInfo: () => undefined,
+    }
+    const session = new DrawingInteractionController(adapter)
+    chart.registerDrawingSession(session)
+    chart.setSelectedDrawingId('d1')
+    chart.removeDrawing('d1')
+    expect(chart.kernel.drawing.readonly.drawings.peek().map((d) => d.id)).toEqual(['d2'])
+    expect(chart.kernel.drawing.readonly.selectedDrawingId.peek()).toBeNull()
+    chart.registerDrawingSession(null)
+    await chart.destroy()
+  })
   it('setDrawingTool writes DrawingToolId to kernel', async () => {
     const chart = new Chart(createDom(1000, 600), defaultOptions)
     expect(chart.kernel.drawing.readonly.drawingTool.peek()).toBe('cursor')

package/src/engine/__tests__/paneRenderer.resize.test.ts

@@ -3,7 +3,6 @@ import { describe, expect, it } from 'vitest'
 
 import { Pane } from '@/core/layout/pane'
 import { PaneRenderer } from '@/core/paneRenderer'
-import { SharedWebGLSurface } from '@/core/renderers/webgl/sharedWebGLSurface'
 
 describe('PaneRenderer resize DPR mapping', () => {
   it('maps logical plot size to physical canvas size and keeps CSS size logical', () => {
@@ -11,7 +10,6 @@ describe('PaneRenderer resize DPR mapping', () => {
     const overlayCanvas = document.createElement('canvas')
     const yAxisCanvas = document.createElement('canvas')
     const pane = new Pane('main')
-    const sharedWebGLSurface = new SharedWebGLSurface()
     const renderer = new PaneRenderer(
       { mainCanvas, overlayCanvas, yAxisCanvas },
       pane,
@@ -21,7 +19,6 @@ describe('PaneRenderer resize DPR mapping', () => {
         yPaddingPx: 0,
         priceLabelWidth: 60,
       },
-      sharedWebGLSurface,
     )
 
     renderer.resize(500, 240, 2)
@@ -40,7 +37,6 @@ describe('PaneRenderer resize DPR mapping', () => {
     const overlayCanvas = document.createElement('canvas')
     const yAxisCanvas = document.createElement('canvas')
     const pane = new Pane('main')
-    const sharedWebGLSurface = new SharedWebGLSurface()
     const renderer = new PaneRenderer(
       { mainCanvas, overlayCanvas, yAxisCanvas },
       pane,
@@ -50,7 +46,6 @@ describe('PaneRenderer resize DPR mapping', () => {
         yPaddingPx: 0,
         priceLabelWidth: 70,
       },
-      sharedWebGLSurface,
     )
 
     renderer.resize(500, 200, 1.5)
@@ -74,7 +69,6 @@ describe('PaneRenderer resize DPR mapping', () => {
     host.appendChild(yAxisCanvas)
 
     const pane = new Pane('main')
-    const sharedWebGLSurface = new SharedWebGLSurface()
     const renderer = new PaneRenderer(
       { mainCanvas, overlayCanvas, yAxisCanvas },
       pane,
@@ -84,7 +78,6 @@ describe('PaneRenderer resize DPR mapping', () => {
         yPaddingPx: 0,
         priceLabelWidth: 70,
       },
-      sharedWebGLSurface,
     )
 
     renderer.resize(500, 200, 1.5)

package/src/engine/__tests__/renderSinglePath.test.ts

@@ -0,0 +1,121 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+
+import { createScene } from '../../rendering/scene/createScene'
+import { createLayerFromPlugin } from '../../rendering/scene/createLayerFromPlugin'
+import { RendererPluginManager } from '../../foundation/plugin/rendererPluginManager'
+import type { RendererPlugin, RenderContext } from '../../foundation/plugin/index'
+import { RENDERER_PRIORITY } from '../../foundation/plugin/index'
+
+/**
+ * Phase 0 契约：绘制只走 Scene；Manager 仅注册表；
+ * useRenderer 桥 = register + addLayer；setRendererEnabled 驱动 Layer 显隐。
+ */
+describe('render single-path (Phase 0)', () => {
+  let scene: ReturnType<typeof createScene>
+  let manager: RendererPluginManager
+  let consoleError: ReturnType<typeof vi.spyOn>
+
+  beforeEach(() => {
+    scene = createScene()
+    manager = new RendererPluginManager()
+    consoleError = vi.spyOn(console, 'error').mockImplementation(() => {})
+  })
+
+  afterEach(() => {
+    scene.dispose()
+    manager.clear()
+    consoleError.mockRestore()
+  })
+
+  function makePlugin(name: string, draw = vi.fn()): RendererPlugin {
+    return {
+      name,
+      paneId: 'main',
+      priority: RENDERER_PRIORITY.MAIN,
+      enabled: true,
+      draw,
+    }
+  }
+
+  function paintMain() {
+    scene.paintPane({
+      renderer: {} as never,
+      region: { x: 0, y: 0, width: 100, height: 100, dpr: 1 },
+      paneRole: 'main',
+      paneId: 'main',
+      frameNumber: 1,
+      deltaMs: 0,
+    })
+  }
+
+  it('bridge: register + createLayerFromPlugin paints via scene only', () => {
+    const draw = vi.fn()
+    const plugin = makePlugin('bridge-a', draw)
+    const ctx = { theme: 'dark' } as unknown as RenderContext
+    manager.register(plugin)
+    scene.addLayer(createLayerFromPlugin(plugin, () => ctx, 'main'))
+
+    paintMain()
+    expect(draw).toHaveBeenCalledOnce()
+    expect(draw).toHaveBeenCalledWith(ctx)
+  })
+
+  it('setLayerVisibility false skips paint (timeshare candle path)', () => {
+    const draw = vi.fn()
+    const plugin = makePlugin('candle', draw)
+    scene.addLayer(createLayerFromPlugin(plugin, () => ({}) as RenderContext, 'main'))
+
+    expect(scene.setLayerVisibility('plugin:candle', false)).toBe(true)
+    paintMain()
+    expect(draw).not.toHaveBeenCalled()
+
+    scene.setLayerVisibility('plugin:candle', true)
+    paintMain()
+    expect(draw).toHaveBeenCalledOnce()
+  })
+
+  it('remove path: Manager.unregister owns onUninstall; removeLayer does not dispose-call it', () => {
+    const onUninstall = vi.fn()
+    const plugin = makePlugin('to-remove', vi.fn())
+    plugin.onUninstall = onUninstall
+    manager.register(plugin)
+    scene.addLayer(createLayerFromPlugin(plugin, () => null, 'main'))
+
+    manager.unregister('to-remove')
+    expect(onUninstall).toHaveBeenCalledOnce()
+
+    scene.removeLayer('plugin:to-remove')
+    // layer.dispose empty — no second onUninstall
+    expect(onUninstall).toHaveBeenCalledOnce()
+  })
+
+  it('one layer throw does not abort sibling layers', () => {
+    const ok = vi.fn()
+    const boom = vi.fn(() => {
+      throw new Error('boom')
+    })
+    scene.addLayer(
+      createLayerFromPlugin(makePlugin('boom', boom), () => ({}) as RenderContext, 'main'),
+    )
+    scene.addLayer(
+      createLayerFromPlugin(makePlugin('ok', ok), () => ({}) as RenderContext, 'main'),
+    )
+
+    expect(() => paintMain()).not.toThrow()
+    expect(boom).toHaveBeenCalledOnce()
+    expect(ok).toHaveBeenCalledOnce()
+  })
+
+  it('Scene paints without Manager draw API (single path)', () => {
+    const draw = vi.fn()
+    const plugin = makePlugin('only-scene', draw)
+    manager.register(plugin)
+    manager.setEnabled(plugin.name, false)
+    scene.addLayer(createLayerFromPlugin(plugin, () => ({}) as RenderContext, 'main'))
+
+    // Manager 无 render 入口；Scene 仍画
+    expect(typeof (manager as { render?: unknown }).render).toBe('undefined')
+    paintMain()
+    expect(draw).toHaveBeenCalledOnce()
+  })
+})