@363045841yyt/klinechart-core 0.8.11-alpha.0 → 0.8.12

package/src/controllers/createChartController.ts

@@ -12,6 +12,7 @@
  *   - Tear down DOM + listeners on dispose().
  */
 
+import { KLineChartError } from '../errors'
 import { createSignal, type Signal } from '../reactivity'
 import type {
     ChartController,
@@ -223,7 +224,7 @@ function mapInteractionSnapshot(snapshot: LegacyInteractionSnapshot): Interactio
 function buildDom(container: HTMLElement): MountedDom {
     const ownerDoc = container.ownerDocument
     if (!ownerDoc) {
-        throw new Error(
+        throw new KLineChartError('CONTROLLER_CONFIG_INVALID',
             '[createChartController] container has no ownerDocument; cannot build DOM scaffold',
         )
     }
@@ -236,11 +237,11 @@ function buildDom(container: HTMLElement): MountedDom {
         chartContainer = ownerDoc.createElement('div')
         chartContainer.style.width = '100%'
         chartContainer.style.height = '100%'
-        chartContainer.style.position = 'relative'
-        chartContainer.style.overflow = 'auto'
         container.appendChild(chartContainer)
         containerCreatedByUs = true
     }
+    chartContainer.style.position = 'relative'
+    chartContainer.style.overflow = 'auto'
 
     const scrollContent = ownerDoc.createElement('div')
     scrollContent.className = 'klc-scroll-content'
@@ -296,10 +297,10 @@ function buildDom(container: HTMLElement): MountedDom {
 
 export async function createChartController(opts: ChartMountOptions): Promise<ChartController> {
     if (!opts) {
-        throw new Error('[createChartController] opts is required')
+        throw new KLineChartError('CONTROLLER_CONFIG_INVALID', '[createChartController] opts is required')
     }
     if (!opts.container) {
-        throw new Error('[createChartController] opts.container must be a non-null HTMLElement')
+        throw new KLineChartError('CONTROLLER_CONFIG_INVALID', '[createChartController] opts.container must be a non-null HTMLElement')
     }
 
     await loadBuiltinIndicators()
@@ -317,6 +318,15 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
         }
         : buildDom(opts.container)
 
+    // ── Fix 0×0 sizing for buildDom()-created right axis host ──
+    if (!hasExistingDom && mounted.rightAxisLayer) {
+        const hostWidth =
+            (opts.rightAxisWidth ?? DEFAULT_OPTS.rightAxisWidth) +
+            (opts.priceLabelWidth ?? DEFAULT_OPTS.priceLabelWidth)
+        mounted.rightAxisLayer.style.bottom = '0'
+        mounted.rightAxisLayer.style.width = hostWidth + 'px'
+    }
+
     const initialZoomLevel = opts.initialZoomLevel ?? DEFAULT_OPTS.initialZoomLevel
     const zoomLevelCount = opts.zoomLevels ?? DEFAULT_OPTS.zoomLevels
 
@@ -372,7 +382,7 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
         kGap: currentKGap,
     })
 
-    const data: Signal<ReadonlyArray<KLineData>> = createSignal(opts.data)
+    const data: Signal<ReadonlyArray<KLineData>> = createSignal(opts.data ?? [])
     const dataLoading: Signal<boolean> = createSignal(false)
 
     const symbols: Signal<ReadonlyArray<SymbolSpec>> = chart.symbols
@@ -402,10 +412,12 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
         /* tolerate jsdom */
     }
 
-    try {
-        chart.setData([...opts.data])
-    } catch {
-        /* tolerate first-paint racing */
+    if (opts.data) {
+        try {
+            chart.setData([...opts.data])
+        } catch {
+            /* tolerate first-paint racing */
+        }
     }
 
     // Apply initial DataFetcher
@@ -906,6 +918,7 @@ export async function createChartController(opts: ChartMountOptions): Promise<Ch
         comparisonColors,
         comparisonLoading,
         catalog: DEFAULT_INDICATOR_CATALOG,
+        alertController: chart.alertController,
         setSymbols,
         addComparisonSymbol,
         removeComparisonSymbol,

package/src/controllers/types.ts

@@ -12,6 +12,7 @@ import type { Signal } from '../reactivity'
 import type { CustomMarkerEntity } from '../engine/marker/registry'
 import type { PaneSpec } from '../engine/chartTypes'
 import type { InteractionSnapshot } from '../engine/chart'
+import type { AlertController } from '../alerts/types'
 
 // Controller-owned public surface. Legacy engine types may mirror these
 // shapes internally, but adapters depend only on core-defined contracts.
@@ -215,7 +216,7 @@ export interface DrawingControllerCallbacks {
 
 export interface ChartMountOptions {
     container: HTMLElement
-    data: ReadonlyArray<KLineData>
+    data?: ReadonlyArray<KLineData>
     symbols?: ReadonlyArray<SymbolSpec>
     dataFetcher?: DataFetcher
     initialZoomLevel?: number
@@ -267,6 +268,9 @@ export interface ChartController extends DrawingChartAdapter {
     // indicator catalog (static — adapters use for picker UI)
     readonly catalog: ReadonlyArray<IndicatorDefinition>
 
+    // ---- Alerts ----
+    readonly alertController: AlertController
+
     // ---- Data ----
     setSymbols(next: ReadonlyArray<SymbolSpec>): void
     addComparisonSymbol(spec: SymbolSpec): void

package/src/data-fetchers/baostock.ts

@@ -1,3 +1,4 @@
+import { KLineChartError } from '../errors'
 import type { KLineData } from '../controllers/types'
 import { DataFetcher } from './fetcherDefinitionRegistry'
 import type { FetchConfig } from './types'
@@ -27,7 +28,7 @@ async function fetchBaoStock(
   try {
     const res = await fetch(url)
     if (!res.ok) {
-      throw new Error(`[baostock] fetch failed: ${res.status} ${res.statusText}`)
+      throw new KLineChartError('FETCH_FAILED', `[baostock] fetch failed: ${res.status} ${res.statusText}`)
     }
     const json = await res.json()
     return (json.data ?? json).map(

package/src/data-fetchers/dataBuffer.effects.ts

@@ -1,5 +1,6 @@
 import { Context, Effect, pipe, Schedule } from 'effect'
 import type { Effect as EffectType } from 'effect/Effect'
+import { KLineChartError } from '../errors'
 import type { KLineData, SymbolSpec } from '../controllers/types'
 import type { TimeShareData } from '../types/price'
 
@@ -83,7 +84,8 @@ export const fetchKLine = (
       )
       if (data.length === 0) {
         return yield* Effect.fail(
-          new Error(
+          new KLineChartError(
+            'FETCH_FAILED',
             `[DataBuffer] empty data for ${spec.symbol} ${formatDate(startTs)}~${formatDate(endTs)}`,
           ),
         )

package/src/data-fetchers/fetcherDefinitionRegistry.ts

@@ -1,3 +1,4 @@
+import { KLineChartError } from '../errors'
 import type { DataFetcherDefinitionConfig, DataFetcherDefinition, DataFetcherFn, TimeShareFetcherFn } from './types'
 
 type DataFetcherClass = {
@@ -12,7 +13,7 @@ export function DataFetcher(config: DataFetcherDefinitionConfig) {
   return function <T extends DataFetcherClass>(value: T, context: ClassDecoratorContext<T>): T {
     context.addInitializer(function (this: T) {
       if (typeof this.fetcher !== 'function') {
-        throw new Error(
+        throw new KLineChartError('NOT_REGISTERED',
           `[DataFetcher] '${config.name}' definition must expose static fetcher`,
         )
       }

package/src/data-fetchers/gotdx.ts

@@ -1,4 +1,5 @@
 import type { KLineData, TimeShareData } from '../controllers/types'
+import { KLineChartError } from '../errors'
 import { DataFetcher } from './fetcherDefinitionRegistry'
 import type { FetchConfig, TimeShareFetchConfig } from './types'
 
@@ -60,7 +61,7 @@ async function fetchGotdxHistoryTick(
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify(body),
   })
-  if (!res.ok) throw new Error(`[gotdx] history-tick failed: ${res.status} ${res.statusText}`)
+  if (!res.ok) throw new KLineChartError('FETCH_FAILED', `[gotdx] history-tick failed: ${res.status} ${res.statusText}`)
   const list: Array<{ timestamp: string; Price: number; Avg: number; Vol: number }> = await res.json()
   return list.map((item) => ({
     timestamp: new Date(item.timestamp).getTime(),
@@ -157,7 +158,7 @@ async function fetchGotdx(
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(body),
     })
-    if (!res.ok) throw new Error(`[gotdx] ex/kline-by-date failed: ${res.status} ${res.statusText}`)
+    if (!res.ok) throw new KLineChartError('FETCH_FAILED', `[gotdx] ex/kline-by-date failed: ${res.status} ${res.statusText}`)
     const list: ExKLineItem[] = await res.json()
     return list.map((item) => mapExItem(item, config.symbol))
   }
@@ -179,7 +180,7 @@ async function fetchGotdx(
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify(body),
   })
-  if (!res.ok) throw new Error(`[gotdx] stock/kline-by-date failed: ${res.status} ${res.statusText}`)
+  if (!res.ok) throw new KLineChartError('FETCH_FAILED', `[gotdx] stock/kline-by-date failed: ${res.status} ${res.statusText}`)
   const list: SecurityBar[] = await res.json()
   return list.map((item) => mapBar(item, config.symbol))
 }

package/src/data-fetchers/router.ts

@@ -1,5 +1,6 @@
 import type { DataFetcher } from '../controllers/types'
 import type { TimeShareFetcherFn } from './types'
+import { KLineChartError } from '../errors'
 import { getRegisteredFetcher, fetcherSupportsPeriod, getTimeShareFetcher } from './fetcherDefinitionRegistry'
 
 const FALLBACK_SOURCE = 'baostock'
@@ -13,7 +14,8 @@ export const routerDataFetcher: DataFetcher = (source, config) => {
     const fallback = getRegisteredFetcher(FALLBACK_SOURCE)
     if (!fallback) {
       return Promise.reject(
-        new Error(
+        new KLineChartError(
+          'FETCH_FAILED',
           `[DataFetcher] no fetcher registered for "${source}" and no fallback available`,
         ),
       )
@@ -23,7 +25,8 @@ export const routerDataFetcher: DataFetcher = (source, config) => {
 
   if (!fetcherSupportsPeriod(source, config.period)) {
     return Promise.reject(
-      new Error(
+      new KLineChartError(
+        'FETCH_FAILED',
         `[DataFetcher] "${source}" does not support period "${config.period}". Supported: ${def.capabilities?.join(', ') ?? 'none'}`,
       ),
     )
@@ -36,7 +39,7 @@ export const routerTimeShareFetcher: TimeShareFetcherFn = (source, config) => {
   const fetcher = getTimeShareFetcher(source)
   if (!fetcher) {
     return Promise.reject(
-      new Error(`[DataFetcher] "${source}" does not support timeshare data fetching`),
+      new KLineChartError('FETCH_FAILED', `[DataFetcher] "${source}" does not support timeshare data fetching`),
     )
   }
   return fetcher(source, config)

package/src/data-fetchers/tradingview.ts

@@ -1,3 +1,4 @@
+import { KLineChartError } from '../errors'
 import type { KLineData } from '../controllers/types'
 import { DataFetcher } from './fetcherDefinitionRegistry'
 import type { FetchConfig } from './types'
@@ -34,11 +35,11 @@ async function fetchTradingview(
   try {
     const res = await fetch(url)
     if (!res.ok) {
-      throw new Error(`[tradingview] fetch failed: ${res.status} ${res.statusText}`)
+      throw new KLineChartError('FETCH_FAILED', `[tradingview] fetch failed: ${res.status} ${res.statusText}`)
     }
     const json = await res.json()
     if (!json.success) {
-      throw new Error(`[tradingview] API error: ${json.error_msg}`)
+      throw new KLineChartError('FETCH_FAILED', `[tradingview] API error: ${json.error_msg}`)
     }
     if (json.warning) {
       console.warn(`[tradingview] ${json.warning}`)

package/src/engine/chart.ts

@@ -4,7 +4,7 @@ import { createSignal, type Signal, type Computed } from '../reactivity/signal'
 import type { SymbolSpec, CustomDataSource } from '../controllers/types'
 import { ChartDataManager } from './data/chartDataManager'
 import { ChartPaneLayout } from './layout/chartPaneLayout'
-import { UpdateLevel } from './layout/pane'
+import { UpdateLevel, type VisibleRange } from './layout/pane'
 import type { ScaleType } from './utils/tickPosition'
 import { InteractionController, type InteractionSnapshot } from './controller/interaction'
 export type { InteractionSnapshot }
@@ -32,6 +32,15 @@ import {
     wrapPaneInfo,
 } from '../plugin'
 import type { SubIndicatorType } from './renderers/Indicator'
+import type { AlertController, MarketSnapshot } from '../alerts/types'
+import { createAlertController } from '../alerts'
+import {
+  createVolumeLookbacks,
+  pushToVolumeLookbacks,
+  type VolumeLookbacks,
+} from '../alerts/rollingVolume'
+import { resolveStateKey } from './indicators/indicatorMetadata'
+import type { IndicatorMetadata } from './indicators/indicatorMetadata'
 
 
 // 重新导出以保持向后兼容
@@ -83,8 +92,17 @@ export class Chart {
     private _modeSavedKGap = 0
     private _modeSavedZoomLevel = 0
 
-    /** 分时模式激活前的 pane Y 轴刻度类型（退出分时时恢复） */
-    private _savedScaleTypes: Map<string, ScaleType> | undefined
+  /** 分时模式激活前的 pane Y 轴刻度类型（退出分时时恢复） */
+  private _savedScaleTypes: Map<string, ScaleType> | undefined
+
+  /** 上次预警评估的最新 K 线时间戳（用于去重） */
+  private _lastAlertTimestamp: number | null = null
+
+  /** 预警控制器 */
+  readonly alertController: AlertController
+
+  /** 滚动成交量窗口（惰性初始化） */
+  private _volumeLookbacks: VolumeLookbacks | null = null
 
     /**
      * 启用主图指标
@@ -189,6 +207,8 @@ export class Chart {
             },
         })
 
+        this.alertController = createAlertController()
+
         this.dataManager = new ChartDataManager({
             getOption: () => this.opt,
             getEffectiveDpr: () => this.viewportManager.getEffectiveDpr(),
@@ -217,12 +237,15 @@ export class Chart {
                     }
                 }
             },
+            onDataProcessed: (data, range) => this.evaluateAlerts(data, range), // Alert 管线绑定
         })
 
         this.zoomController = new ChartZoomController({
             getLogicalScrollLeft: () => this.viewportManager.getLogicalScrollLeft(),
             getCurrentDpr: () => this.viewportManager.getEffectiveDpr(),
             getLeftLoadBufferWidth: () => this.dataManager.getLeftLoadBufferWidth(),
+            getContentWidth: () => this.dataManager.getContentWidth(),
+            getClientWidth: () => this.viewportManager.getViewport()?.viewWidth ?? this.dom.container?.clientWidth ?? 0,
             setScrollLeft: (v) => { this.viewportManager.setScrollLeft(v) },
             onZoomCommitted: (result) => {
                 this.opt = { ...this.opt, kWidth: result.kWidth, kGap: result.kGap }
@@ -264,6 +287,12 @@ export class Chart {
             setPendingIndicatorDataUpdate: (v) => { this.dataManager.pendingIndicatorDataUpdate = v },
         })
 
+        // Worker 异步结果就绪后串联 Alert 管线
+        this.indicatorManager.indicatorSchedulerAccessor.setOnResultsApplied(() => {
+            const data = this.dataManager.getInternalData()
+            this.evaluateAlerts(data, this.dataManager.lastVisibleRange)
+        })
+
         // 初始化渲染器
         this.renderer = new ChartRenderer({
             getDom: () => this.dom,
@@ -687,6 +716,97 @@ export class Chart {
         return this.indicatorManager.indicatorSchedulerAccessor
     }
 
+    /** 获取预警控制器 */
+    getAlertController(): AlertController {
+        return this.alertController
+    }
+
+    /** 数据就绪时触发预警评估 */
+    private evaluateAlerts(data: KLineData[], range: VisibleRange): void {
+        const latest = data[data.length - 1]
+        if (!latest) return
+        // 去重：同一根 K 线只评估一次（增量加载/Worker 重复回调时跳过）
+        if (latest.timestamp === this._lastAlertTimestamp) return
+        this._lastAlertTimestamp = latest.timestamp
+
+        // 推进滚动量滑窗（仅在新 K 线到达时）
+        let lookbacks = this._volumeLookbacks
+        if (!lookbacks) {
+            lookbacks = createVolumeLookbacks([5, 10, 20, 60])
+            this._volumeLookbacks = lookbacks
+        }
+        pushToVolumeLookbacks(lookbacks, latest.volume ?? 0)
+
+        const snapshot = this.buildMarketSnapshot(data)
+        if (!snapshot) return
+        const events = this.alertController.evaluate(snapshot, Date.now())
+        if (events.length > 0) {
+            console.log('[Alerts] fired:', events)
+        }
+    }
+
+    /** 构建预警引擎所需的当前市场快照 */
+    private buildMarketSnapshot(data: KLineData[]): MarketSnapshot | null {
+        const latest = data[data.length - 1]
+        if (!latest) return null
+
+        if (latest.volume === undefined) return null
+
+        const bar = {
+            timestamp: latest.timestamp,
+            open: latest.open,
+            high: latest.high,
+            low: latest.low,
+            close: latest.close,
+            volume: latest.volume,
+        }
+
+        const indicators: Record<string, number> = {}
+        const scheduler = this.getIndicatorScheduler()
+        for (const meta of scheduler.getAllIndicators()) {
+            const paneId = meta.defaultPaneId === 'main' ? 'main' : meta.defaultPaneId
+            const stateKey = resolveStateKey(meta.stateKey, paneId)
+            const state = this.pluginHost.getSharedState<any>(stateKey)
+            if (!state?.series) continue
+            const series = state.series
+            if (Array.isArray(series)) {
+                const val = series[series.length - 1]
+                if (typeof val === 'number' && Number.isFinite(val)) {
+                    indicators[meta.name] = val
+                }
+            } else if (typeof series === 'object') {
+                const keys = Object.keys(series)
+                if (keys.length > 0) {
+                    const lastKey = keys[keys.length - 1]!
+                    const arr = series[lastKey]
+                    if (Array.isArray(arr)) {
+                        const val = arr[arr.length - 1]
+                        if (typeof val === 'number' && Number.isFinite(val)) {
+                            indicators[meta.name] = val
+                        }
+                    }
+                }
+            }
+        }
+
+        // 只读滚动量（由 evaluateAlerts 推进滑窗）
+        const rollingVolume: Record<number, number> = {}
+        if (this._volumeLookbacks) {
+            for (const [size, calc] of this._volumeLookbacks) {
+                rollingVolume[size] = calc.mean
+            }
+        }
+
+        return {
+            bar,
+            indicators,
+            rollingVolume,
+            volumeProfile: undefined,
+            orderBook: undefined,
+            footprint: undefined,
+        }
+    }
+
     getLogicalSlotCount(): number {
         return this.dataManager.getLogicalSlotCount()
     }
@@ -772,6 +892,7 @@ export class Chart {
         this.layoutManager.destroy()
         this.sharedWebGLSurface.destroy()
         this.indicatorManager.destroy()
+        this.alertController.dispose()
         await this.pluginHost.destroy()
     }
 
@@ -896,6 +1017,8 @@ export class Chart {
     }
 
     setSymbols(specs: ReadonlyArray<SymbolSpec>): void {
+        // 品种/周期切换时重置最新 K 线时间戳，确保新数据触发预警
+        this._lastAlertTimestamp = null
         const primaryPeriod = specs[0]?.period
         if (primaryPeriod) {
             this.setActiveMode(primaryPeriod === 'timeshare' ? this._timeShareMode : this._kLineMode)

package/src/engine/data/chartDataManager.ts

@@ -31,6 +31,7 @@ export interface DataDependencies {
   setPendingIndicatorDataUpdate: (v: boolean) => void
   isPointerDown: () => boolean
   onTimeShareDataReady: (dataLength: number) => void
+  onDataProcessed?: (data: KLineData[], range: VisibleRange) => void
 }
 
 const BUF_PRIMARY = 'main'
@@ -184,7 +185,19 @@ private _symbolsSignal = createSignal<ReadonlyArray<SymbolSpec>>([])
     this.pendingPrependedCount = 0
 
     if (prependedCount === 0 && this.deps.getCachedScrollLeft() < this.getLeftLoadBufferWidth()) {
-      this.deps.setScrollLeft(this.getLeftLoadBufferWidth())
+      const scrollLeft = this.deps.getCachedScrollLeft()
+      if (scrollLeft <= 0) {
+        this.deps.setScrollLeft(this.getLeftLoadBufferWidth())
+      } else {
+        const dpr = this.deps.getEffectiveDpr()
+        const opt = this.deps.getOption()
+        const { unitPx, startXPx } = getPhysicalKLineConfig(opt.kWidth, opt.kGap, dpr)
+        const totalDataWidth = (startXPx + bufferData.length * unitPx) / dpr
+        const leftBuffer = this.getLeftLoadBufferWidth()
+        if (scrollLeft >= leftBuffer + totalDataWidth) {
+          this.deps.setScrollLeft(leftBuffer)
+        }
+      }
     }
 
     if ((prevDataLength ?? this._dataSignal.peek().length) === 0 && bufferData.length > 0) {
@@ -216,6 +229,8 @@ private _symbolsSignal = createSignal<ReadonlyArray<SymbolSpec>>([])
     if (indicatorsReady) {
       this.pendingIndicatorDataUpdate = false
       this.deps.scheduleDraw()
+      // Alert 管线入口：Chart 构造时绑定 → evaluateAlerts()
+      this.deps.onDataProcessed?.(bufferData, this.lastVisibleRange)
     } else {
       this.pendingIndicatorDataUpdate = true
     }
@@ -899,16 +914,23 @@ private _symbolsSignal = createSignal<ReadonlyArray<SymbolSpec>>([])
     const dpr = this.deps.getEffectiveDpr()
     const opt = this.deps.getOption()
     const { unitPx, startXPx } = getPhysicalKLineConfig(opt.kWidth, opt.kGap, dpr)
-    const lastKLineEndPx = (startXPx + (dataLength + ChartDataManager.TRAILING_SLOTS) * unitPx) / dpr
+    const lastKLineEndPx = (startXPx + dataLength * unitPx) / dpr
     const viewport = this.deps.getViewport()
     const clientWidth = viewport?.viewWidth
       ?? (this.deps.getObservedSize().width > 0 ? this.deps.getObservedSize().width : undefined)
       ?? Math.round(this.deps.getDom().container?.clientWidth ?? 0)
     if (clientWidth <= 0) return
-    const target = this.getLeftLoadBufferWidth() + Math.max(0, lastKLineEndPx - clientWidth)
+    const leftBuffer = this.getLeftLoadBufferWidth()
+    let target: number
+    if (lastKLineEndPx <= clientWidth) {
+      // 数据不足以填满一屏 → 右对齐：最后一根 K 线固定在右侧
+      target = leftBuffer - (clientWidth - lastKLineEndPx)
+    } else {
+      target = leftBuffer + (lastKLineEndPx - clientWidth)
+    }
     const contentWidth = this.getContentWidth()
     const maxScroll = Math.max(0, contentWidth - clientWidth)
-    const scrollLeft = Math.round(Math.min(target, maxScroll) * dpr) / dpr
+    const scrollLeft = Math.round(Math.max(0, Math.min(target, maxScroll)) * dpr) / dpr
     this.deps.setScrollLeft(scrollLeft)
     this.deps.scheduleDraw()
   }

package/src/engine/drawing/toolConfig.ts

@@ -1,3 +1,4 @@
+import { KLineChartError } from '../../errors'
 import type { DrawingKind } from '../../plugin'
 
 // ---- Tool ID type ----
@@ -63,7 +64,7 @@ export function getAnchorCountForTool(toolId: DrawingToolId): 1 | 2 | 3 | null {
 export function getDrawingKind(toolId: DrawingToolId): DrawingKind {
   switch (toolId) {
     case 'cursor':
-      throw new Error('cursor is not a drawing kind')
+      throw new KLineChartError('INVALID_PARAM', 'cursor is not a drawing kind')
     case 'h-line':
       return 'horizontal-line'
     case 'h-ray':

package/src/engine/indicators/chartIndicatorManager.ts

@@ -1,3 +1,4 @@
+import { KLineChartError } from '../../errors'
 import type { KLineData } from '../../types/price'
 import { createSignal, computed, type Signal, type Computed } from '../../reactivity/signal'
 import type { IndicatorInstance, SubPaneInfo, PaneSpec, ChartOptions } from '../chartTypes'
@@ -375,7 +376,7 @@ export class ChartIndicatorManager {
 
         const definition = this.indicatorScheduler.getIndicatorMetadata(indicatorId)
         if (!definition) {
-            throw new Error(`[Chart] Unknown indicator: ${indicatorId}`)
+            throw new KLineChartError('NOT_REGISTERED', `[Chart] Unknown indicator: ${indicatorId}`)
         }
         const renderer = createSubIndicatorRenderer({ indicatorId, paneId, definition, params })
         const rendererName = renderer.name

package/src/engine/indicators/indicatorDefinitionRegistry.ts

@@ -1,3 +1,4 @@
+import { KLineChartError } from '../../errors'
 import type {
     IndicatorMetadata,
     IndicatorCategory,
@@ -73,7 +74,7 @@ export function Indicator(config: IndicatorDefinitionConfig) {
         context.addInitializer(function (this: T) {
             const rendererFactory = this.rendererFactory
             if (typeof rendererFactory !== 'function') {
-                throw new Error(`[Indicator] '${config.name}' definition must expose static rendererFactory`)
+                throw new KLineChartError('INVALID_PARAM', `[Indicator] '${config.name}' definition must expose static rendererFactory`)
             }
 
             const normalizedName = normalizeIndicatorId(config.name)

package/src/engine/indicators/indicatorMetadata.ts

@@ -5,6 +5,7 @@
  * 每个指标通过 metadata 描述其状态 key、渲染器工厂等元信息
  */
 
+import { KLineChartError } from '../../errors'
 import type { PluginHost, RendererPluginWithHost } from '../../plugin'
 import type { IndicatorConfigSnapshot, IndicatorSeriesBundle } from './workerProtocol'
 import type { KLineData } from '../../types/price'
@@ -272,7 +273,7 @@ export interface IndicatorMetadata<T = unknown> {
 export function resolveStateKey(stateKey: StateKey, paneId?: string): string {
     if (typeof stateKey === 'function') {
         if (!paneId) {
-            throw new Error('[IndicatorMetadata] Pane ID required for dynamic state key')
+            throw new KLineChartError('INVALID_PARAM', '[IndicatorMetadata] Pane ID required for dynamic state key')
         }
         return stateKey(paneId)
     }

package/src/engine/indicators/indicatorRegistry.ts

@@ -1,3 +1,4 @@
+import { KLineChartError } from '../../errors'
 import type { IndicatorMetadata } from './indicatorMetadata'
 import { getRegisteredIndicatorDefinitions } from './indicatorDefinitionRegistry'
 
@@ -52,20 +53,20 @@ export class IndicatorRegistry {
     register<T>(meta: IndicatorMetadata<T>): void {
         // 验证必填字段
         if (!meta.name || typeof meta.name !== 'string') {
-            throw new Error('[IndicatorRegistry] Indicator name is required')
+            throw new KLineChartError('INVALID_PARAM', '[IndicatorRegistry] Indicator name is required')
         }
 
         if (!meta.displayName) {
-            throw new Error(`[IndicatorRegistry] displayName is required for indicator '${meta.name}'`)
+            throw new KLineChartError('INVALID_PARAM', `[IndicatorRegistry] displayName is required for indicator '${meta.name}'`)
         }
 
         if (!meta.rendererFactory || typeof meta.rendererFactory !== 'function') {
-            throw new Error(`[IndicatorRegistry] rendererFactory is required for indicator '${meta.name}'`)
+            throw new KLineChartError('INVALID_PARAM', `[IndicatorRegistry] rendererFactory is required for indicator '${meta.name}'`)
         }
 
         const normalizedName = this.normalize(meta.name)
         if (!normalizedName) {
-            throw new Error('[IndicatorRegistry] Indicator name is required')
+            throw new KLineChartError('INVALID_PARAM', '[IndicatorRegistry] Indicator name is required')
         }
 
         // 检查重复注册
@@ -112,7 +113,7 @@ export class IndicatorRegistry {
     getRequired(name: string): IndicatorMetadata {
         const meta = this.get(name)
         if (!meta) {
-            throw new Error(`[IndicatorRegistry] Unknown indicator '${name}'`)
+            throw new KLineChartError('NOT_REGISTERED', `[IndicatorRegistry] Unknown indicator '${name}'`)
         }
         return meta
     }

package/src/engine/indicators/registerBuiltins.ts

@@ -1,3 +1,4 @@
+import { KLineChartError } from '../../errors'
 import { getRegisteredIndicatorDefinitions } from './indicatorDefinitionRegistry'
 
 let loaded = false
@@ -52,7 +53,7 @@ export async function loadBuiltinIndicators(): Promise<void> {
 
 export function getBuiltinIndicatorDefinitions() {
   if (!loaded) {
-    throw new Error(
+    throw new KLineChartError('INVALID_STATE',
       'Builtin indicators not loaded yet. Call await loadBuiltinIndicators() first.',
     )
   }