@363045841yyt/klinechart 0.7.1 → 0.7.3-alpha.0

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

@@ -1,18 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-export interface HVRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (number | undefined)[];
-    params: {
-        period: number;
-        annualizationFactor: number;
-        showHV: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createHVStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const DEFAULT_HV_PERIOD = 20;
-export declare const DEFAULT_HV_ANNUALIZATION = 252;
-export declare const EMPTY_HV_STATE: HVRenderState;

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

@@ -1,44 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-/**
- * 一目均衡表数据点：5 条线在同一根 K 线槽位
- * - tenkan (转换线) = (HH9 + LL9) / 2，当根 K 线计算
- * - kijun (基准线) = (HH26 + LL26) / 2，当根 K 线计算
- * - spanA (先行带 A) = (tenkan[t-displacement] + kijun[t-displacement]) / 2，前置位移
- * - spanB (先行带 B) = (HH52[t-displacement] + LL52[t-displacement]) / 2，前置位移
- * - chikou (迟行线) = close[t+displacement]，后置位移
- *
- * 任一字段都可能 undefined（数据不足或位移外）。
- */
-export interface IchimokuPoint {
-    tenkan?: number;
-    kijun?: number;
-    spanA?: number;
-    spanB?: number;
-    chikou?: number;
-}
-export interface IchimokuRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (IchimokuPoint | undefined)[];
-    params: {
-        tenkanPeriod: number;
-        kijunPeriod: number;
-        spanBPeriod: number;
-        displacement: number;
-        showTenkan: boolean;
-        showKijun: boolean;
-        showSpanA: boolean;
-        showSpanB: boolean;
-        showCloud: boolean;
-        showChikou: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createIchimokuStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const DEFAULT_ICHIMOKU_TENKAN = 9;
-export declare const DEFAULT_ICHIMOKU_KIJUN = 26;
-export declare const DEFAULT_ICHIMOKU_SPAN_B = 52;
-export declare const DEFAULT_ICHIMOKU_DISPLACEMENT = 26;
-export declare const EMPTY_ICHIMOKU_STATE: IchimokuRenderState;

package/dist/src/core/indicators/indicator.worker.d.ts

@@ -1,5 +0,0 @@
-/**
- * Indicator Worker 入口
- * 运行在独立线程，负责指标计算
- */
-export {};

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

@@ -1,30 +0,0 @@
-import { IndicatorMetadata, IndicatorCategory, StateKey, RendererFactory } from './indicatorMetadata';
-import { PluginHost } from '../../plugin';
-export interface IndicatorDefinitionConfig {
-    name: string;
-    displayName: string;
-    category: IndicatorCategory;
-    stateKey: StateKey;
-    defaultPaneId: string;
-    paneIdField?: keyof import('./workerProtocol').IndicatorConfigSnapshot;
-    allowMainPane?: boolean;
-    applyResult?: (host: PluginHost, state: unknown, paneId: string) => void;
-}
-type IndicatorDefinitionClass = {
-    new (...args: never[]): unknown;
-    rendererFactory?: RendererFactory;
-};
-/**
- * 标准类装饰器：在模块加载时收集指标定义
- *
- * 使用方式：
- * @Indicator({ name: 'ma', ... })
- * class MADefinition {
- *   static rendererFactory = createMARendererPlugin
- * }
- */
-export declare function Indicator(config: IndicatorDefinitionConfig): <T extends IndicatorDefinitionClass>(value: T, context: ClassDecoratorContext<T>) => T;
-export declare function getRegisteredIndicatorDefinitions(): readonly IndicatorMetadata[];
-export declare function getRegisteredIndicatorDefinition(name: string): IndicatorMetadata | undefined;
-export declare function clearRegisteredIndicatorDefinitionsForTest(): void;
-export {};

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

@@ -1,81 +0,0 @@
-import { PluginHost, RendererPluginWithHost } from '../../plugin';
-import { IndicatorConfigSnapshot } from './workerProtocol';
-/**
- * 指标分类：主图/副图
- */
-export type IndicatorCategory = 'main' | 'sub' | 'oscillator' | 'volume';
-/**
- * State key 生成器类型
- * - 主图指标：常量字符串
- * - 副图指标：函数，接收 paneId 返回 key
- */
-export type StateKey = string | ((paneId: string) => string);
-/**
- * 渲染器工厂函数
- */
-export type RendererFactory = () => RendererPluginWithHost;
-/**
- * 指标元数据接口
- */
-export interface IndicatorMetadata<T = unknown> {
-    /**
-     * 指标唯一标识
-     * 如：'ma', 'boll', 'rsi', 'customIndicator'
-     */
-    name: string;
-    /**
-     * 显示名称（用于日志和调试）
-     */
-    displayName: string;
-    /**
-     * 分类：主图/副图
-     */
-    category: IndicatorCategory;
-    /**
-     * StateStore key
-     * - 主图指标：常量字符串（如 'indicator:ma:main'）
-     * - 副图指标：函数 (paneId) => string
-     */
-    stateKey: StateKey;
-    /**
-     * 在 configSnapshot 中的 paneId 字段名
-     * 用于从配置中获取当前 pane ID
-     */
-    paneIdField?: keyof IndicatorConfigSnapshot;
-    /**
-     * 渲染器工厂函数
-     * 调用时创建该指标的渲染器实例
-     */
-    rendererFactory: RendererFactory;
-    /**
-     * 默认 pane ID
-     * - 主图指标：'main'
-     * - 副图指标：如 'sub_RSI'
-     */
-    defaultPaneId: string;
-    /**
-     * 是否启用（可选条件判断）
-     * 用于副图指标根据配置决定是否参与计算
-     */
-    isEnabled?: (config: IndicatorConfigSnapshot) => boolean;
-    /**
-     * 将指标计算结果写入 StateStore
-     * @param host - PluginHost
-     * @param state - 计算结果（由 composeRenderStates 或 composeVisibleSubIndicatorStates 产出）
-     * @param paneId - 目标 pane ID（从 configSnapshot 读取）
-     */
-    applyResult?: (host: PluginHost, state: unknown, paneId: string) => void;
-    /**
-     * 是否允许在主图显示（部分副图指标可切换至主图）
-     * - true：指标可放置在主图（如 WMA/SAR/Pivot 等叠加类指标）
-     * - false/undefined：仅限副图显示
-     */
-    allowMainPane?: boolean;
-}
-/**
- * 提取 stateKey 对应的实际 key 值
- * @param stateKey - 可以是字符串或函数
- * @param paneId - pane ID（副图指标需要）
- * @returns 实际的 state key 字符串
- */
-export declare function resolveStateKey(stateKey: StateKey, paneId?: string): string;

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

@@ -1,57 +0,0 @@
-import { IndicatorMetadata } from './indicatorMetadata';
-/**
- * IndicatorRegistry - 指标注册表
- *
- * 管理所有已注册指标的元数据
- * 支持运行时动态注册/注销指标
- */
-export declare class IndicatorRegistry {
-    private indicators;
-    /**
-     * 注册指标
-     * @param meta - 指标元数据
-     * @throws 如果 name 为空或元数据无效
-     */
-    register<T>(meta: IndicatorMetadata<T>): void;
-    /**
-     * 注销指标
-     * @param name - 指标名称
-     * @returns 是否成功注销
-     */
-    unregister(name: string): boolean;
-    /**
-     * 获取指定指标的元数据
-     * @param name - 指标名称
-     * @returns 元数据或 undefined
-     */
-    get(name: string): IndicatorMetadata | undefined;
-    /**
-     * 检查指标是否已注册
-     * @param name - 指标名称
-     */
-    has(name: string): boolean;
-    /**
-     * 获取所有已注册指标
-     */
-    getAll(): readonly IndicatorMetadata[];
-    /**
-     * 获取主图指标
-     */
-    getMainIndicators(): readonly IndicatorMetadata[];
-    /**
-     * 获取副图指标
-     */
-    getSubIndicators(): readonly IndicatorMetadata[];
-    /**
-     * 获取指标名称列表
-     */
-    getNames(): string[];
-    /**
-     * 清空所有注册指标
-     */
-    clear(): void;
-    /**
-     * 获取已注册指标数量
-     */
-    get size(): number;
-}

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

@@ -1,126 +0,0 @@
-import { KLineData } from '../../types/price';
-import { IndicatorConfigSnapshot, IndicatorSeriesBundle } from './workerProtocol';
-/**
- * 计算运行时
- * 管理数据、配置、缓存和脏标记
- */
-export declare class IndicatorRuntime {
-    private currentData;
-    private dataVersion;
-    private config;
-    private configVersion;
-    private cachedSeries;
-    private cachedBollSeries;
-    private cachedExpmaSeries;
-    private cachedEneSeries;
-    private cachedRsiSeries;
-    private cachedCciSeries;
-    private cachedStochSeries;
-    private cachedMomSeries;
-    private cachedWmsrSeries;
-    private cachedKstSeries;
-    private cachedFastkSeries;
-    private cachedMacdSeries;
-    private cachedAtrSeries;
-    private cachedWmaSeries;
-    private cachedDemaSeries;
-    private cachedTemaSeries;
-    private cachedHmaSeries;
-    private cachedKamaSeries;
-    private cachedSarSeries;
-    private cachedSupertrendSeries;
-    private cachedKeltnerSeries;
-    private cachedDonchianSeries;
-    private cachedIchimokuSeries;
-    private cachedRocSeries;
-    private cachedTrixSeries;
-    private cachedTrixSignalSeries;
-    private cachedHvSeries;
-    private cachedParkinsonSeries;
-    private cachedChaikinVolSeries;
-    private cachedVmaSeries;
-    private cachedObvSeries;
-    private cachedPvtSeries;
-    private cachedVwapSeries;
-    private cachedCmfSeries;
-    private cachedMfiSeries;
-    private cachedPivotSeries;
-    private cachedFibSeries;
-    private cachedStructureSeries;
-    private cachedZonesSeries;
-    private cachedVolumeProfileSeries;
-    private dirtyData;
-    private dirtyMAConfig;
-    private dirtyBollConfig;
-    private dirtyExpmaConfig;
-    private dirtyEneConfig;
-    private dirtyRsiConfig;
-    private dirtyCciConfig;
-    private dirtyStochConfig;
-    private dirtyMomConfig;
-    private dirtyWmsrConfig;
-    private dirtyKstConfig;
-    private dirtyFastkConfig;
-    private dirtyMacdConfig;
-    private dirtyAtrConfig;
-    private dirtyWmaConfig;
-    private dirtyDemaConfig;
-    private dirtyTemaConfig;
-    private dirtyHmaConfig;
-    private dirtyKamaConfig;
-    private dirtySarConfig;
-    private dirtySupertrendConfig;
-    private dirtyKeltnerConfig;
-    private dirtyDonchianConfig;
-    private dirtyIchimokuConfig;
-    private dirtyRocConfig;
-    private dirtyTrixConfig;
-    private dirtyHvConfig;
-    private dirtyParkinsonConfig;
-    private dirtyChaikinVolConfig;
-    private dirtyVmaConfig;
-    private dirtyObvConfig;
-    private dirtyPvtConfig;
-    private dirtyVwapConfig;
-    private dirtyCmfConfig;
-    private dirtyMfiConfig;
-    private dirtyPivotConfig;
-    private dirtyFibConfig;
-    private dirtyStructureConfig;
-    private dirtyZonesConfig;
-    private dirtyVolumeProfileConfig;
-    private getDefaultConfig;
-    /**
-     * 更新数据
-     */
-    setData(data: KLineData[], version: number): void;
-    /**
-     * 更新配置
-     */
-    private shallowEqual;
-    /**
-     * 更新配置（仅值变更时才设置脏标记）
-     */
-    setConfig(config: Partial<IndicatorConfigSnapshot>, version: number): void;
-    /**
-     * 强制所有指标标记为脏（用于 recompute）
-     */
-    forceDirty(): void;
-    /**
-     * 获取当前数据版本
-     */
-    getDataVersion(): number;
-    /**
-     * 获取当前配置版本
-     */
-    getConfigVersion(): number;
-    /**
-     * 计算所有指标的 series（如果脏了）
-     * 返回结果包，供主线程组装成 render states
-     */
-    computeSeries(): IndicatorSeriesBundle;
-    /**
-     * 获取缓存的 series（用于 visibleRange 变更时扫描极值）
-     */
-    getCachedSeries(): IndicatorSeriesBundle;
-}

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

@@ -1,20 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-export interface KAMARenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (number | undefined)[];
-    params: {
-        period: number;
-        fastPeriod: number;
-        slowPeriod: number;
-        showKAMA: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createKAMAStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const DEFAULT_KAMA_PERIOD = 10;
-export declare const DEFAULT_KAMA_FAST_PERIOD = 2;
-export declare const DEFAULT_KAMA_SLOW_PERIOD = 30;
-export declare const EMPTY_KAMA_STATE: KAMARenderState;

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

@@ -1,27 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-export interface KeltnerPoint {
-    upper: number;
-    middle: number;
-    lower: number;
-}
-export interface KeltnerRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (KeltnerPoint | undefined)[];
-    params: {
-        emaPeriod: number;
-        atrPeriod: number;
-        multiplier: number;
-        showUpper: boolean;
-        showMiddle: boolean;
-        showLower: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createKeltnerStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const DEFAULT_KELTNER_EMA_PERIOD = 20;
-export declare const DEFAULT_KELTNER_ATR_PERIOD = 10;
-export declare const DEFAULT_KELTNER_MULTIPLIER = 2;
-export declare const EMPTY_KELTNER_STATE: KeltnerRenderState;

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

@@ -1,21 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-import { KSTPoint } from './calculators';
-export interface KSTRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: KSTPoint[];
-    params: {
-        roc1: number;
-        roc2: number;
-        roc3: number;
-        roc4: number;
-        signalPeriod: number;
-        showKST: boolean;
-        showSignal: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createKSTStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const EMPTY_KST_STATE: KSTRenderState;

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

@@ -1,26 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-/**
- * MA 渲染器状态（共享给渲染器和图例）
- * 包含全量 MA 数组、启用的周期列表、以及视口极值
- */
-export interface MARenderState extends BaseIndicatorState {
-    timestamp: number;
-    /** period → 全量 MA 数组（用 Record 而非 Map，兼容 JSON 序列化和 postMessage） */
-    series: Record<number, (number | undefined)[]>;
-    /** 当前启用的周期列表（渲染器直接从此字段决定绘制哪些线） */
-    enabledPeriods: number[];
-    /** 视口内所有 MA 线的最低价（供 Y 轴刻度渲染器使用） */
-    visibleMin: number;
-    /** 视口内所有 MA 线的最高价 */
-    visibleMax: number;
-}
-/**
- * MA 状态的 StateStore 键名
- * 格式：indicator:ma:main
- */
-export declare const MA_STATE_KEY: `indicator:${string}:${string}`;
-/**
- * 空数据占位状态
- * 消费者应检查 visibleMin > visibleMax 判断"无有效数据"
- */
-export declare const EMPTY_MA_STATE: MARenderState;

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

@@ -1,58 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-import { MACDPoint } from './calculators';
-/**
- * MACD 调度器配置
- */
-export interface MACDSchedulerConfig {
-    /** 快线周期（默认 12） */
-    fastPeriod: number;
-    /** 慢线周期（默认 26） */
-    slowPeriod: number;
-    /** DEA 周期（默认 9） */
-    signalPeriod: number;
-    /** 是否显示 DIF 线 */
-    showDIF: boolean;
-    /** 是否显示 DEA 线 */
-    showDEA: boolean;
-    /** 是否显示 MACD 柱 */
-    showBAR: boolean;
-}
-/**
- * MACD 渲染器状态
- * 用 Record 而非 Map，兼容 JSON 序列化和 postMessage
- */
-export interface MACDRenderState extends BaseIndicatorState {
-    /** MACD 系列数据，与 K 线数据同长度 */
-    series: MACDPoint[];
-    /** 配置参数 */
-    params: MACDSchedulerConfig;
-    /** 可视范围内的最小值 */
-    visibleMin: number;
-    /** 可视范围内的最大值 */
-    visibleMax: number;
-    /** 固定数值范围最小值 */
-    valueMin: number;
-    /** 固定数值范围最大值 */
-    valueMax: number;
-    /** 最新值 */
-    latestValues?: {
-        dif: number;
-        dea: number;
-        macd: number;
-    };
-}
-/**
- * MACD State 的命名空间 key
- * 格式: indicator:macd:{paneId}
- */
-export declare const MACD_STATE_KEY = "indicator:macd";
-/**
- * 创建 MACD State Key
- * @param paneId pane ID，如 'sub_MACD'
- */
-export declare function createMACDStateKey(paneId: string): string;
-/**
- * 空 MACD State（哨兵值）
- * visibleMin > visibleMax 表示无有效数据
- */
-export declare const EMPTY_MACD_STATE: MACDRenderState;

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

@@ -1,16 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-export interface MFIRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (number | undefined)[];
-    params: {
-        period: number;
-        showMFI: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createMFIStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const DEFAULT_MFI_PERIOD = 14;
-export declare const EMPTY_MFI_STATE: MFIRenderState;

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

@@ -1,15 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-export interface MOMRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (number | undefined)[];
-    params: {
-        period: number;
-        showMOM: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createMOMStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const EMPTY_MOM_STATE: MOMRenderState;

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

@@ -1,14 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-export interface OBVRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (number | undefined)[];
-    params: {
-        showOBV: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createOBVStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const EMPTY_OBV_STATE: OBVRenderState;

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

@@ -1,18 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-export interface ParkinsonRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (number | undefined)[];
-    params: {
-        period: number;
-        annualizationFactor: number;
-        showParkinson: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createParkinsonStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const DEFAULT_PARKINSON_PERIOD = 20;
-export declare const DEFAULT_PARKINSON_ANNUALIZATION = 252;
-export declare const EMPTY_PARKINSON_STATE: ParkinsonRenderState;

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

@@ -1,29 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-export interface PivotPoint {
-    pp: number;
-    r1: number;
-    r2: number;
-    r3: number;
-    s1: number;
-    s2: number;
-    s3: number;
-}
-export interface PivotRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (PivotPoint | undefined)[];
-    params: {
-        showPP: boolean;
-        showR1: boolean;
-        showR2: boolean;
-        showR3: boolean;
-        showS1: boolean;
-        showS2: boolean;
-        showS3: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createPivotStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const EMPTY_PIVOT_STATE: PivotRenderState;

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

@@ -1,14 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-export interface PVTRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (number | undefined)[];
-    params: {
-        showPVT: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createPVTStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const EMPTY_PVT_STATE: PVTRenderState;

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

@@ -1,16 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-export interface ROCRenderState extends BaseIndicatorState {
-    timestamp: number;
-    series: (number | undefined)[];
-    params: {
-        period: number;
-        showROC: boolean;
-    };
-    valueMin: number;
-    valueMax: number;
-    visibleMin: number;
-    visibleMax: number;
-}
-export declare const createROCStateKey: (paneId: string) => `indicator:${string}:${string}`;
-export declare const DEFAULT_ROC_PERIOD = 12;
-export declare const EMPTY_ROC_STATE: ROCRenderState;