@363045841yyt/klinechart 0.6.3 → 0.6.6

package/dist/src/core/indicators/scheduler.d.ts

@@ -1,5 +1,6 @@
 import { PluginHost } from '../../plugin';
 import { KLineData } from '../../types/price';
+import { BOLLSchedulerConfig, EXPMASchedulerConfig, ENESchedulerConfig, RSISchedulerConfig, CCISchedulerConfig, STOCHSchedulerConfig, MOMSchedulerConfig, WMSRSchedulerConfig, KSTSchedulerConfig, FASTKSchedulerConfig, MACDSchedulerConfig } from './workerProtocol';
 import { MAFlags } from './calculators';
 /**
  * 可见范围
@@ -8,259 +9,122 @@ interface VisibleRange {
     start: number;
     end: number;
 }
+export type { BOLLSchedulerConfig, EXPMASchedulerConfig, ENESchedulerConfig, RSISchedulerConfig, CCISchedulerConfig, STOCHSchedulerConfig, MOMSchedulerConfig, WMSRSchedulerConfig, KSTSchedulerConfig, FASTKSchedulerConfig, MACDSchedulerConfig, };
 /**
- * BOLL 调度器配置
- */
-export interface BOLLSchedulerConfig {
-    period: number;
-    multiplier: number;
-    showUpper: boolean;
-    showMiddle: boolean;
-    showLower: boolean;
-    showBand: boolean;
-}
-/**
- * EXPMA 调度器配置
- */
-export interface EXPMASchedulerConfig {
-    fastPeriod: number;
-    slowPeriod: number;
-}
-/**
- * ENE 调度器配置
- */
-export interface ENESchedulerConfig {
-    period: number;
-    deviation: number;
-}
-/**
- * RSI 调度器配置
- */
-export interface RSISchedulerConfig {
-    period1: number;
-    period2: number;
-    period3: number;
-    showRSI1: boolean;
-    showRSI2: boolean;
-    showRSI3: boolean;
-}
-/**
- * CCI 调度器配置
- */
-export interface CCISchedulerConfig {
-    period: number;
-    showCCI: boolean;
-}
-/**
- * STOCH 调度器配置
- */
-export interface STOCHSchedulerConfig {
-    n: number;
-    m: number;
-    showK: boolean;
-    showD: boolean;
-}
-/**
- * MOM 调度器配置
- */
-export interface MOMSchedulerConfig {
-    period: number;
-    showMOM: boolean;
-}
-/**
- * WMSR 调度器配置
- */
-export interface WMSRSchedulerConfig {
-    period: number;
-    showWMSR: boolean;
-}
-/**
- * KST 调度器配置
- */
-export interface KSTSchedulerConfig {
-    roc1: number;
-    roc2: number;
-    roc3: number;
-    roc4: number;
-    signalPeriod: number;
-    showKST: boolean;
-    showSignal: boolean;
-}
-/**
- * FASTK 调度器配置
- */
-export interface FASTKSchedulerConfig {
-    period: number;
-    showFASTK: boolean;
-}
-/**
- * 指标调度器
- *
- * 职责：
- * 1. 维护当前图表激活的指标配置
- * 2. 在数据/视口/配置变更时触发计算
- * 3. 将计算结果写入 StateStore，供渲染器消费
- *
- * 优化策略：
- * - 双脏标记（dirtyData/dirtyRange）：数据变更重算 series + 极值，视口变更仅重算极值
- * - cachedSeries 缓存：视口变更时复用已计算的 series，避免 O(n) 重算
+ * IndicatorScheduler - 主线程 facade
  */
 export declare class IndicatorScheduler {
     private pluginHost;
-    private currentData;
-    private maConfig;
     private visibleRange;
-    private cachedSeries;
-    private bollConfig;
-    private cachedBollSeries;
-    private expmaConfig;
-    private cachedExpmaSeries;
-    private eneConfig;
-    private cachedEneSeries;
-    private rsiConfig;
-    private rsiPaneId;
-    private cachedRsiSeries;
-    private cciConfig;
-    private cciPaneId;
-    private cachedCciSeries;
-    private stochConfig;
-    private stochPaneId;
-    private cachedStochSeries;
-    private momConfig;
-    private momPaneId;
-    private cachedMomSeries;
-    private wmsrConfig;
-    private wmsrPaneId;
-    private cachedWmsrSeries;
-    private kstConfig;
-    private kstPaneId;
-    private cachedKstSeries;
-    private fastkConfig;
-    private fastkPaneId;
-    private cachedFastkSeries;
-    private dirtyData;
-    private dirtyRange;
-    private dirtyBollConfig;
-    private dirtyExpmaConfig;
-    private dirtyEneConfig;
-    private dirtyRsiConfig;
-    private dirtyCciConfig;
-    private dirtyStochConfig;
-    private dirtyMomConfig;
-    private dirtyWmsrConfig;
-    private dirtyKstConfig;
-    private dirtyFastkConfig;
-    private dirtyRsiState;
-    private dirtyCciState;
-    private dirtyStochState;
-    private dirtyMomState;
-    private dirtyWmsrState;
-    private dirtyKstState;
-    private dirtyFastkState;
-    /** 当前激活的主图指标列表 */
     private activeMainIndicators;
-    /**
-     * 设置 PluginHost，用于读写 StateStore
+    private dataVersion;
+    private configVersion;
+    private requestId;
+    private lastAppliedRequestId;
+    private currentData;
+    private configSnapshot;
+    private worker;
+    private workerReady;
+    private useWorker;
+    private pendingRequest;
+    private inlineRuntime;
+    private latestResult;
+    private invalidateCallback;
+    constructor();
+    /**
+     * 设置 PluginHost
      */
     setPluginHost(host: PluginHost): void;
     /**
-     * 设置当前激活的主图指标（用于极值计算过滤）
-     * @param indicators 激活的指标ID列表，如 ['ma', 'boll', 'expma', 'ene']
+     * 设置重绘回调
      */
-    setActiveMainIndicators(indicators: string[]): void;
+    setInvalidateCallback(callback: () => void): void;
+    /**
+     * 销毁调度器
+     */
+    destroy(): void;
+    private getDefaultConfig;
+    private initBackend;
+    private tryInitWorker;
+    private initInlineRuntime;
+    private fallbackToInline;
+    private terminateWorker;
+    private handleWorkerMessage;
+    private handleSeriesResult;
+    private applyResults;
+    private updateVisibleStatesOnly;
     /**
      * 数据变更时调用
-     * @param data 新的 K 线数据
-     * @param visibleRange 当前可见范围
      */
     update(data: KLineData[], visibleRange: VisibleRange): void;
     /**
-     * MA 配置变更时调用
-     * @param config 新的 MA 配置（哪些周期启用）
+     * 视口变更时调用 - 同步处理，不走 Worker
+     */
+    updateVisibleRange(visibleRange: VisibleRange): void;
+    /**
+     * MA 配置变更
      */
     updateMAConfig(config: MAFlags): void;
     /**
-     * BOLL 配置变更时调用
-     * @param config 新的 BOLL 配置
+     * BOLL 配置变更
      */
     updateBOLLConfig(config: Partial<BOLLSchedulerConfig>): void;
     /**
-     * EXPMA 配置变更时调用
-     * @param config 新的 EXPMA 配置
+     * EXPMA 配置变更
      */
     updateEXPMAConfig(config: Partial<EXPMASchedulerConfig>): void;
     /**
-     * ENE 配置变更时调用
-     * @param config 新的 ENE 配置
+     * ENE 配置变更
      */
     updateENEConfig(config: Partial<ENESchedulerConfig>): void;
     /**
-     * RSI 配置变更时调用
-     * @param config 新的 RSI 配置
-     * @param paneId RSI pane ID（可选，默认 'sub_RSI'）
+     * RSI 配置变更
      */
     updateRSIConfig(config: Partial<RSISchedulerConfig>, paneId?: string): void;
     /**
-     * CCI 配置变更时调用
-     * @param config 新的 CCI 配置
-     * @param paneId CCI pane ID（可选，默认 'sub_CCI'）
+     * CCI 配置变更
      */
     updateCCIConfig(config: Partial<CCISchedulerConfig>, paneId?: string): void;
     /**
-     * STOCH 配置变更时调用
-     * @param config 新的 STOCH 配置
-     * @param paneId STOCH pane ID（可选，默认 'sub_STOCH'）
+     * STOCH 配置变更
      */
     updateSTOCHConfig(config: Partial<STOCHSchedulerConfig>, paneId?: string): void;
     /**
-     * MOM 配置变更时调用
-     * @param config 新的 MOM 配置
-     * @param paneId MOM pane ID（可选，默认 'sub_MOM'）
+     * MOM 配置变更
      */
     updateMOMConfig(config: Partial<MOMSchedulerConfig>, paneId?: string): void;
     /**
-     * WMSR 配置变更时调用
-     * @param config 新的 WMSR 配置
-     * @param paneId WMSR pane ID（可选，默认 'sub_WMSR'）
+     * WMSR 配置变更
      */
     updateWMSRConfig(config: Partial<WMSRSchedulerConfig>, paneId?: string): void;
     /**
-     * KST 配置变更时调用
-     * @param config 新的 KST 配置
-     * @param paneId KST pane ID（可选，默认 'sub_KST'）
+     * KST 配置变更
      */
     updateKSTConfig(config: Partial<KSTSchedulerConfig>, paneId?: string): void;
     /**
-     * FASTK 配置变更时调用
-     * @param config 新的 FASTK 配置
-     * @param paneId FASTK pane ID（可选，默认 'sub_FASTK'）
+     * FASTK 配置变更
      */
     updateFASTKConfig(config: Partial<FASTKSchedulerConfig>, paneId?: string): void;
     /**
-     * 视口变更时调用
-     * @param visibleRange 新的可见范围
-     */
-    updateVisibleRange(visibleRange: VisibleRange): void;
-    /**
-     * 强制全部重算
+     * MACD 配置变更
      */
-    recompute(): void;
+    updateMACDConfig(config: Partial<MACDSchedulerConfig>, paneId?: string): void;
     /**
-     * 根据脏标记执行计算
-     *
-     * 计算流程：
-     * 1. 若 dirtyData 或指标配置脏标记，重算对应 series
-     * 2. 若任一 series 重算或 dirtyRange，重算所有指标在视口内的极值
-     * 3. 写入所有指标的 StateStore
+     * 设置当前激活的主图指标
      */
-    private computeIfDirty;
+    setActiveMainIndicators(indicators: string[]): void;
     /**
-     * 获取主图指标极值（用于与K线极值合并计算价格轴范围）
-     * @returns 主图指标的价格范围，无指标时返回 null
+     * 获取主图指标价格范围
      */
     getMainIndicatorPriceRange(): {
         min: number;
         max: number;
     } | null;
+    /**
+     * 强制全部重算
+     */
+    recompute(): void;
+    private triggerRecompute;
+    private computeWithWorker;
+    private computeWithInline;
 }
-export {};

package/dist/src/core/indicators/soa.d.ts

@@ -0,0 +1,115 @@
+import { KLineData } from '../../types/price';
+/**
+ * KLineData 的 SoA (Structure of Arrays) 布局
+ * 用于零拷贝传输到 Web Worker
+ *
+ * 内存布局：
+ * | timestamps | opens | highs | lows | closes | volumes | turnovers |
+ * |   8*N      |  8*N  |  8*N  |  8*N |   8*N  |   8*N   |    8*N    |
+ *
+ * 其中 N 为数据长度，每列 8 字节（Float64）
+ */
+export interface KLineSoALayout {
+    /** 底层缓冲区（SharedArrayBuffer 或 ArrayBuffer） */
+    buffer: SharedArrayBuffer | ArrayBuffer;
+    /** 数据长度 */
+    length: number;
+    /** 是否使用 SharedArrayBuffer */
+    isShared: boolean;
+    /** 是否有成交量数据 */
+    hasVolume: boolean;
+    /** 是否有成交额数据 */
+    hasTurnover: boolean;
+    /** 时间戳数组（毫秒） */
+    timestamps: Float64Array;
+    /** 开盘价数组 */
+    opens: Float64Array;
+    /** 最高价数组 */
+    highs: Float64Array;
+    /** 最低价数组 */
+    lows: Float64Array;
+    /** 收盘价数组 */
+    closes: Float64Array;
+    /** 成交量数组（无值时为 0） */
+    volumes: Float64Array;
+    /** 成交额数组（无值时为 0） */
+    turnovers: Float64Array;
+}
+/**
+ * SharedKLineBuffer - K线数据的 SoA 管理类
+ *
+ * 提供 AoS (KLineData[]) 与 SoA 布局之间的转换，
+ * 支持 SharedArrayBuffer（零拷贝）和 ArrayBuffer（降级）
+ */
+export declare class SharedKLineBuffer {
+    /**
+     * 检测 SharedArrayBuffer 是否可用
+     * 需要页面有 COOP/COEP 头支持
+     */
+    static detectSupport(): boolean;
+    /**
+     * 计算 SoA 布局所需的总字节数
+     */
+    static calculateByteLength(length: number): number;
+    /**
+     * 将 KLineData[] 转换为 SoA 布局
+     * @param data K线数据数组（AoS 格式）
+     * @param preferShared 是否优先使用 SharedArrayBuffer（默认 true）
+     * @returns SoA 布局对象
+     */
+    static fromKLineData(data: KLineData[], preferShared?: boolean): KLineSoALayout;
+    /**
+     * 更新现有 SoA 布局的数据（尽可能复用缓冲区）
+     * 如果新数据长度超过原缓冲区，会创建新缓冲区
+     *
+     * @param layout 现有 SoA 布局
+     * @param data 新的 K线数据
+     * @returns 更新后的 SoA 布局（可能是新对象）
+     */
+    static updateExisting(layout: KLineSoALayout, data: KLineData[]): KLineSoALayout;
+    /**
+     * 将 SoA 布局转换回 KLineData[]（用于测试和兼容性）
+     * @param layout SoA 布局
+     * @returns K线数据数组
+     */
+    static toKLineData(layout: KLineSoALayout): KLineData[];
+    /**
+     * 创建子视图（用于 Worker 中处理部分数据范围）
+     * @param layout 原 SoA 布局
+     * @param start 起始索引（包含）
+     * @param end 结束索引（不包含）
+     * @returns 子视图对象（共享同一缓冲区）
+     */
+    static createSubview(layout: KLineSoALayout, start: number, end: number): KLineSoALayout;
+    /**
+     * 获取缓冲区信息（用于调试和序列化）
+     */
+    static getBufferInfo(layout: KLineSoALayout): {
+        byteLength: number;
+        isShared: boolean;
+        length: number;
+        columns: string[];
+    };
+}
+/**
+ * 获取 SoA 布局中 closes 列的视图（最常用列）
+ * 用于指标计算中快速访问收盘价
+ */
+export declare function getClosesView(layout: KLineSoALayout): Float64Array;
+/**
+ * 获取 SoA 布局中 highs/lows 列的视图
+ * 用于需要高低价的指标（如 BOLL、STOCH、WMSR）
+ */
+export declare function getHighsLowsViews(layout: KLineSoALayout): {
+    highs: Float64Array;
+    lows: Float64Array;
+};
+/**
+ * 获取 SoA 布局中 OHLC 四价视图
+ */
+export declare function getOHLCViews(layout: KLineSoALayout): {
+    opens: Float64Array;
+    highs: Float64Array;
+    lows: Float64Array;
+    closes: Float64Array;
+};

package/dist/src/core/indicators/stateComposer.d.ts

@@ -0,0 +1,47 @@
+import { MARenderState } from './maState';
+import { BOLLRenderState } from './bollState';
+import { EXPMARenderState } from './expmaState';
+import { ENERenderState } from './eneState';
+import { RSIRenderState } from './rsiState';
+import { CCIRenderState } from './cciState';
+import { STOCHRenderState } from './stochState';
+import { MOMRenderState } from './momState';
+import { WMSRRenderState } from './wmsrState';
+import { KSTRenderState } from './kstState';
+import { FASTKRenderState } from './fastkState';
+import { MACDRenderState } from './macdState';
+import { IndicatorSeriesBundle } from './workerProtocol';
+/**
+ * 可见范围
+ */
+interface VisibleRange {
+    start: number;
+    end: number;
+}
+/**
+ * 从 series bundle 组装所有 render states
+ * 同时计算 visibleMin/visibleMax 等派生字段
+ */
+export declare function composeRenderStates(bundle: IndicatorSeriesBundle, visibleRange: VisibleRange, timestamp: number): {
+    ma: MARenderState;
+    boll: BOLLRenderState;
+    expma: EXPMARenderState;
+    ene: ENERenderState;
+    rsi: RSIRenderState;
+    cci: CCIRenderState;
+    stoch: STOCHRenderState;
+    mom: MOMRenderState;
+    wmsr: WMSRRenderState;
+    kst: KSTRenderState;
+    fastk: FASTKRenderState;
+    macd: MACDRenderState;
+};
+/**
+ * 计算主图指标价格范围
+ * 用于 Chart.draw() 中的 pane.updateRange
+ */
+export declare function computeMainIndicatorPriceRange(bundle: IndicatorSeriesBundle, visibleRange: VisibleRange, activeMainIndicators: Set<string>): {
+    min: number;
+    max: number;
+} | null;
+export {};

package/dist/src/core/indicators/workerProtocol.d.ts

@@ -0,0 +1,189 @@
+import { KLineData } from '../../types/price';
+import { MAFlags, BOLLPoint, EXPMAPoint, ENEPoint, STOCHPoint, KSTPoint, MACDPoint } from './calculators';
+export interface BOLLSchedulerConfig {
+    period: number;
+    multiplier: number;
+    showUpper: boolean;
+    showMiddle: boolean;
+    showLower: boolean;
+    showBand: boolean;
+}
+export interface EXPMASchedulerConfig {
+    fastPeriod: number;
+    slowPeriod: number;
+}
+export interface ENESchedulerConfig {
+    period: number;
+    deviation: number;
+}
+export interface RSISchedulerConfig {
+    period1: number;
+    period2: number;
+    period3: number;
+    showRSI1: boolean;
+    showRSI2: boolean;
+    showRSI3: boolean;
+}
+export interface CCISchedulerConfig {
+    period: number;
+    showCCI: boolean;
+}
+export interface STOCHSchedulerConfig {
+    n: number;
+    m: number;
+    showK: boolean;
+    showD: boolean;
+}
+export interface MOMSchedulerConfig {
+    period: number;
+    showMOM: boolean;
+}
+export interface WMSRSchedulerConfig {
+    period: number;
+    showWMSR: boolean;
+}
+export interface KSTSchedulerConfig {
+    roc1: number;
+    roc2: number;
+    roc3: number;
+    roc4: number;
+    signalPeriod: number;
+    showKST: boolean;
+    showSignal: boolean;
+}
+export interface FASTKSchedulerConfig {
+    period: number;
+    showFASTK: boolean;
+}
+export interface MACDSchedulerConfig {
+    fastPeriod: number;
+    slowPeriod: number;
+    signalPeriod: number;
+    showDIF: boolean;
+    showDEA: boolean;
+    showBAR: boolean;
+}
+export interface InitRequest {
+    type: 'init';
+    protocolVersion: number;
+}
+export interface SetDataRequest {
+    type: 'setData';
+    dataVersion: number;
+    format: 'aos' | 'soa';
+    data: KLineData[];
+}
+export interface SetConfigRequest {
+    type: 'setConfig';
+    configVersion: number;
+    configs: IndicatorConfigSnapshot;
+}
+export interface ComputeSeriesRequest {
+    type: 'computeSeries';
+    requestId: number;
+    dataVersion: number;
+    configVersion: number;
+}
+export interface DisposeRequest {
+    type: 'dispose';
+}
+export type IndicatorWorkerRequest = InitRequest | SetDataRequest | SetConfigRequest | ComputeSeriesRequest | DisposeRequest;
+export interface ReadyResponse {
+    type: 'ready';
+    protocolVersion: number;
+}
+export interface SeriesResultResponse {
+    type: 'seriesResult';
+    requestId: number;
+    dataVersion: number;
+    configVersion: number;
+    results: IndicatorSeriesBundle;
+    metrics?: {
+        computeMs: number;
+        dataLength: number;
+    };
+}
+export interface ErrorResponse {
+    type: 'error';
+    requestId?: number;
+    stage: 'init' | 'setData' | 'setConfig' | 'computeSeries';
+    message: string;
+}
+export type IndicatorWorkerResponse = ReadyResponse | SeriesResultResponse | ErrorResponse;
+export interface IndicatorConfigSnapshot {
+    ma: MAFlags;
+    boll: BOLLSchedulerConfig;
+    expma: EXPMASchedulerConfig;
+    ene: ENESchedulerConfig;
+    rsi: RSISchedulerConfig;
+    cci: CCISchedulerConfig;
+    stoch: STOCHSchedulerConfig;
+    mom: MOMSchedulerConfig;
+    wmsr: WMSRSchedulerConfig;
+    kst: KSTSchedulerConfig;
+    fastk: FASTKSchedulerConfig;
+    macd: MACDSchedulerConfig;
+    rsiPaneId: string;
+    cciPaneId: string;
+    stochPaneId: string;
+    momPaneId: string;
+    wmsrPaneId: string;
+    kstPaneId: string;
+    fastkPaneId: string;
+    macdPaneId: string;
+}
+export interface IndicatorSeriesBundle {
+    ma: {
+        series: Record<number, (number | undefined)[]>;
+        enabledPeriods: number[];
+    };
+    boll: {
+        series: BOLLPoint[];
+        params: BOLLSchedulerConfig;
+    };
+    expma: {
+        series: EXPMAPoint[];
+        params: EXPMASchedulerConfig;
+    };
+    ene: {
+        series: ENEPoint[];
+        params: ENESchedulerConfig;
+    };
+    rsi: {
+        series: Record<number, (number | undefined)[]>;
+        enabledPeriods: number[];
+        params: RSISchedulerConfig;
+    };
+    cci: {
+        series: (number | undefined)[];
+        params: CCISchedulerConfig;
+    };
+    stoch: {
+        series: STOCHPoint[];
+        params: STOCHSchedulerConfig;
+    };
+    mom: {
+        series: (number | undefined)[];
+        params: MOMSchedulerConfig;
+    };
+    wmsr: {
+        series: (number | undefined)[];
+        params: WMSRSchedulerConfig;
+    };
+    kst: {
+        series: KSTPoint[];
+        params: KSTSchedulerConfig;
+    };
+    fastk: {
+        series: (number | undefined)[];
+        params: FASTKSchedulerConfig;
+    };
+    macd: {
+        series: MACDPoint[];
+        params: MACDSchedulerConfig;
+    };
+    /** 本次计算中实际变更的指标列表 */
+    _changed: string[];
+}
+export declare const PROTOCOL_VERSION = 1;
+export declare function isWorkerResponse(msg: unknown): msg is IndicatorWorkerResponse;