@363045841yyt/klinechart 0.6.10 → 0.7.1

package/dist/src/core/chart.d.ts

@@ -1,7 +1,8 @@
 import { KLineData } from '../types/price';
 import { ChartSettings } from '../config/chartSettings';
+import { Signal } from '../../packages/core/src/reactivity/signal';
 import { VisibleRange, UpdateLevel } from './layout/pane';
-import { InteractionController } from './controller/interaction';
+import { InteractionController, InteractionSnapshot } from './controller/interaction';
 import { PaneRenderer } from './paneRenderer';
 import { MarkerManager, CustomMarkerEntity } from './marker/registry';
 import { getPhysicalKLineConfig, calcKWidthPx } from './utils/klineConfig';
@@ -9,6 +10,7 @@ import { IndicatorScheduler } from './indicators/scheduler';
 import { SubPaneEntry } from './subPaneManager';
 import { PluginHostImpl, RendererPlugin, RendererPluginWithHost, PaneRole, PaneCapabilities } from '../plugin';
 import { SubIndicatorType } from './renderers/Indicator';
+export type { InteractionSnapshot };
 export { getPhysicalKLineConfig, calcKWidthPx };
 /**
  * 图表 DOM 元素引用
@@ -92,10 +94,10 @@ type ResolvedChartOptions = Omit<ChartOptions, 'kWidth' | 'kGap'> & {
 export declare class Chart {
     private dom;
     private opt;
-    private data;
+    private _internalData;
     private raf;
     private pendingUpdateLevel;
-    private viewport;
+    private _internalViewport;
     private paneRenderers;
     private markerManager;
     private drawingStore;
@@ -119,7 +121,7 @@ export declare class Chart {
     /** 用户设置配置（传递给渲染器） */
     private settings;
     /** pane ratio 状态（按 paneId 维护，sum=1 仅对可见 pane） */
-    private paneRatios;
+    private _internalPaneRatios;
     /** 视口变化回调（供外部同步 DPR/尺寸） */
     private onViewportChange?;
     /** 共享 X 轴上下文缓存 */
@@ -150,11 +152,11 @@ export declare class Chart {
     private mainIndicatorParams;
     /**
      * 启用主图指标
-     * @param indicatorId 指标ID: 'MA' | 'BOLL' | 'EXPMA' | 'ENE'
+     * @param indicatorId 指标ID
      * @param params 可选的指标参数
      * @returns 是否成功启用
      */
-    enableMainIndicator(indicatorId: string, params?: Record<string, number | boolean>): boolean;
+    enableMainIndicator(indicatorId: string, params?: Record<string, number | boolean | string>): boolean;
     /**
      * 禁用主图指标
      * @param indicatorId 指标ID
@@ -182,12 +184,12 @@ export declare class Chart {
      * @param indicatorId 指标ID
      * @param params 参数对象
      */
-    updateMainIndicatorParams(indicatorId: string, params: Record<string, number | boolean>): void;
+    updateMainIndicatorParams(indicatorId: string, params: Record<string, number | boolean | string>): void;
     /**
      * 获取主图指标参数
      * @param indicatorId 指标ID
      */
-    getMainIndicatorParams(indicatorId: string): Record<string, number | boolean> | null;
+    getMainIndicatorParams(indicatorId: string): Record<string, number | boolean | string> | null;
     /**
      * 清除所有主图指标
      */
@@ -214,6 +216,7 @@ export declare class Chart {
      * @param opt 初始配置
      */
     constructor(dom: ChartDom, opt: ChartOptions);
+    private initCoreRenderers;
     private initResizeObserver;
     private updateObservedMetrics;
     private getEffectiveDpr;
@@ -284,12 +287,16 @@ export declare class Chart {
     updateOptions(partial: Partial<ChartOptions>): void;
     /** 更新 pane 布局配置
      * @param panes 新的 pane 配置数组
+     *
+     * 显式整盘替换：清空之前 user-resize 留下的 paneRatios 缓存，让 spec 中的 ratio
+     * 真正生效。`addPane`/`upsertPane`/`removePaneDefinition` 走 `applyPaneLayoutSpecs`
+     * 时仍保留 prev 值以记住用户拖拽过的高度——只有显式的 layout replacement 才重置。
      */
     updatePaneLayout(panes: PaneSpec[]): void;
     setPaneDefinitions(defs: PaneSpec[]): void;
     upsertPane(def: PaneSpec): void;
     removePaneDefinition(paneId: string): void;
-    bindIndicatorToPane(paneId: string, indicatorId: SubIndicatorType, params?: Record<string, number | boolean>): void;
+    bindIndicatorToPane(paneId: string, indicatorId: SubIndicatorType, params?: Record<string, number | boolean | string>): void;
     /** 更新绘图对象 */
     setDrawings(drawings: import('../plugin').DrawingObject[]): void;
     /** 更新选中的绘图 ID */
@@ -323,7 +330,7 @@ export declare class Chart {
      * @param params 指标参数
      * @returns 是否创建成功
      */
-    createSubPane(paneId: string, indicatorId: SubIndicatorType, params?: Record<string, number | boolean>): boolean;
+    createSubPane(paneId: string, indicatorId: SubIndicatorType, params?: Record<string, number | boolean | string>): boolean;
     /**
      * 移除副图面板及其渲染器
      * @param paneId 副图实例标识符
@@ -335,7 +342,7 @@ export declare class Chart {
      * @param newIndicatorId 新的指标类型
      * @param params 新指标参数
      */
-    replaceSubPaneIndicator(paneId: string, newIndicatorId: SubIndicatorType, params?: Record<string, number | boolean>): void;
+    replaceSubPaneIndicator(paneId: string, newIndicatorId: SubIndicatorType, params?: Record<string, number | boolean | string>): void;
     /**
      * 更新副图指标参数
      * @param paneId 副图实例标识符
@@ -417,4 +424,194 @@ export declare class Chart {
     /** 计算每个 pane 的布局（top 和 height） */
     private layoutPanes;
     private computeViewport;
+    private _viewportSignal;
+    private _dataSignal;
+    private _themeSignal;
+    private _indicatorsSignal;
+    private _subPanesSignal;
+    private _drawingToolSignal;
+    private _drawingsSignal;
+    private _paneRatiosSignal;
+    private _interactionSignal;
+    /** 视口状态信号 */
+    get viewport(): Signal<ViewportState>;
+    /** 数据信号 */
+    get data(): Signal<ReadonlyArray<KLineData>>;
+    /** 主题信号 */
+    get theme(): Signal<'light' | 'dark'>;
+    /** 指标实例列表信号 */
+    get indicators(): Signal<ReadonlyArray<IndicatorInstance>>;
+    /** 子图信息信号 */
+    get subPanes(): Signal<ReadonlyArray<SubPaneInfo>>;
+    /** 当前绘图工具信号 */
+    get drawingTool(): Signal<DrawingToolType | null>;
+    /** 绘图对象列表信号 */
+    get drawings(): Signal<ReadonlyArray<import('../plugin').DrawingObject>>;
+    /** 面板比例信号 */
+    get paneRatios(): Signal<Readonly<Record<string, number>>>;
+    /** 交互状态信号 */
+    get interactionState(): Signal<InteractionSnapshot>;
+    /**
+     * 设置数据（高层 API）
+     * 内部调用 updateData，并更新 data signal
+     */
+    setData(data: KLineData[]): void;
+    /**
+     * 追加数据（高层 API）
+     * 合并现有数据并更新
+     */
+    appendData(newData: KLineData[]): void;
+    /**
+     * 设置主题（高层 API）
+     */
+    setTheme(theme: 'light' | 'dark'): void;
+    /**
+     * 缩放到指定级别（高层 API）
+     * 计算并应用新的 render state，更新 viewport signal
+     */
+    zoomToLevel(level: number, anchorX?: number): void;
+    /**
+     * 放大（高层 API）
+     */
+    zoomIn(anchorX?: number): void;
+    /**
+     * 缩小（高层 API）
+     */
+    zoomOut(anchorX?: number): void;
+    /**
+     * 内部缩放实现
+     * 使用 computeZoom 纯函数计算精确的 scrollLeft
+     */
+    private applyZoom;
+    /**
+     * 统一指针事件处理（零配置）
+     * 自动判断区域并分发给 interaction controller
+     *
+     * @param e 指针事件
+     * @param drawingController 可选的绘图控制器，如果提供，会优先让绘图控制器处理事件
+     * @returns 是否被处理（如果 drawingController 处理了返回 true，否则返回 false）
+     */
+    handlePointerEvent(e: PointerEvent, drawingController?: {
+        onPointerDown?: (e: PointerEvent, container: HTMLElement) => boolean;
+        onPointerMove?: (e: PointerEvent, container: HTMLElement) => boolean;
+        onPointerUp?: (e: PointerEvent, container: HTMLElement) => boolean;
+    }): boolean;
+    /**
+     * 滚轮事件处理（高层 API）
+     * 使用 computeZoom 计算精确的 scrollLeft，更新 viewport signal
+     */
+    handleWheelEvent(e: WheelEvent): void;
+    /**
+     * 滚动事件处理（高层 API）
+     * 更新缓存的 scrollLeft 并触发交互 controller
+     */
+    handleScrollEvent(): void;
+    /**
+     * 双指捏合缩放处理（高层 API）
+     * @param delta 缩放增量（+1 放大 / -1 缩小）
+     * @param centerClientX 捏合中心在视口中的 X 坐标
+     */
+    handlePinchZoom(delta: number, centerClientX: number): void;
+    /**
+     * 更新 viewport signal（用于滚动事件，不更新 desiredScrollLeft）
+     */
+    private updateViewportSignal;
+    /**
+     * 添加指标（高层 API，显式指定 role）
+     * @param definitionId 指标定义 ID（如 'MA', 'MACD'）
+     * @param role 'main' 主图指标 或 'sub' 副图指标
+     * @param params 指标参数
+     * @returns 实例 ID（成功）或 null（失败）
+     */
+    addIndicator(definitionId: string, role: 'main' | 'sub', params?: Record<string, unknown>): string | null;
+    /**
+     * 移除指标（高层 API）
+     * @param instanceId 指标实例 ID
+     * @returns 是否成功移除
+     */
+    removeIndicator(instanceId: string): boolean;
+    /**
+     * 更新指标参数（高层 API）
+     * @param instanceId 指标实例 ID
+     * @param params 新参数
+     * @returns 是否成功更新
+     */
+    updateIndicatorParams(instanceId: string, params: Record<string, unknown>): boolean;
+    /**
+     * 重新排序指标（高层 API）
+     * @param orderedInstanceIds 排序后的指标实例 ID 数组
+     * @returns 是否成功
+     */
+    reorderIndicators(orderedInstanceIds: string[]): boolean;
+    /**
+     * 同步 indicators signal
+     */
+    private syncIndicatorsSignal;
+    /**
+     * 同步 sub panes signal
+     */
+    private syncSubPanesSignal;
+    /**
+     * 调整子图大小（高层 API）
+     * @param paneId 面板 ID
+     * @param deltaY 垂直偏移量
+     * @returns 是否成功
+     */
+    resizeSubPane(paneId: string, deltaY: number): boolean;
+    /**
+     * 设置当前绘图工具（高层 API）
+     * @param tool 工具类型或 null 取消选择
+     */
+    setDrawingTool(tool: DrawingToolType | null): void;
+    /**
+     * 移除绘图（高层 API）
+     * @param drawingId 绘图 ID
+     */
+    removeDrawing(drawingId: string): void;
+    /**
+     * 清除所有绘图（高层 API）
+     */
+    clearDrawings(): void;
+    /**
+     * 更新设置（高层 API）
+     * 代理到现有的 updateSettings
+     */
+    updateSettingsFacade(settings: Record<string, unknown>): void;
+    /**
+     * 更新选项（高层 API）
+     * 代理到现有的 updateOptions
+     */
+    updateOptionsFacade(options: Partial<ChartOptions>): void;
+}
+export type ViewportState = {
+    zoomLevel: number;
+    plotWidth: number;
+    plotHeight: number;
+    dpr: number;
+    visibleFrom: number;
+    visibleTo: number;
+    desiredScrollLeft: number | undefined;
+    kWidth: number;
+    kGap: number;
+};
+export type IndicatorRole = 'main' | 'sub';
+export interface IndicatorInstance {
+    id: string;
+    definitionId: string;
+    label: string;
+    name: string;
+    role: IndicatorRole;
+    paneId?: string;
+    params: Record<string, unknown>;
+}
+export interface SubPaneInfo {
+    paneId: string;
+    indicatorId: string;
+    params: Record<string, unknown>;
+    ratio: number;
+}
+export type DrawingToolType = 'trendline' | 'horizontal' | 'fib' | 'rectangle' | 'arrow';
+export interface DrawingObject {
+    id: string;
+    type: DrawingToolType;
 }

package/dist/src/core/draw/pixelAlign.d.ts

@@ -7,14 +7,14 @@
  * @param dpr - 设备像素比
  * @returns 对齐后的逻辑坐标
  */
-export declare function roundToPhysicalPixel(value: number, dpr: number): number;
+export declare function roundToPhysicalPixel(value: number, dpr: number, theme?: 'light' | 'dark'): number;
 /**
  * 将逻辑坐标对齐到物理像素中心（用于 1px 线条）
  * @param value - 逻辑坐标值
  * @param dpr - 设备像素比
  * @returns 对齐后的逻辑坐标
  */
-export declare function alignToPhysicalPixelCenter(value: number, dpr: number): number;
+export declare function alignToPhysicalPixelCenter(value: number, dpr: number, theme?: 'light' | 'dark'): number;
 /**
  * 对齐矩形到物理像素边界
  * @param x - 矩形左边界 X 坐标
@@ -24,7 +24,7 @@ export declare function alignToPhysicalPixelCenter(value: number, dpr: number):
  * @param dpr - 设备像素比
  * @returns 对齐后的矩形信息
  */
-export declare function alignRect(x: number, y: number, width: number, height: number, dpr: number): {
+export declare function alignRect(x: number, y: number, width: number, height: number, dpr: number, theme?: 'light' | 'dark'): {
     x: number;
     y: number;
     width: number;
@@ -38,7 +38,7 @@ export declare function alignRect(x: number, y: number, width: number, height: n
  * @param dpr - 设备像素比
  * @returns 对齐到物理像素的矩形信息，如果 y1 和 y2 相等则返回 null
  */
-export declare function createVerticalLineRect(centerX: number, y1: number, y2: number, dpr: number): {
+export declare function createVerticalLineRect(centerX: number, y1: number, y2: number, dpr: number, theme?: 'light' | 'dark'): {
     x: number;
     y: number;
     width: number;
@@ -52,7 +52,7 @@ export declare function createVerticalLineRect(centerX: number, y1: number, y2:
  * @param dpr - 设备像素比
  * @returns 对齐到物理像素的矩形信息，如果 x1 和 x2 相等则返回 null
  */
-export declare function createHorizontalLineRect(x1: number, x2: number, centerY: number, dpr: number): {
+export declare function createHorizontalLineRect(x1: number, x2: number, centerY: number, dpr: number, theme?: 'light' | 'dark'): {
     x: number;
     y: number;
     width: number;
@@ -67,7 +67,7 @@ export declare function createHorizontalLineRect(x1: number, x2: number, centerY
  * @param dpr - 设备像素比
  * @returns 对齐后的实体和影线信息
  */
-export declare function createAlignedKLine(rectX: number, rectY: number, kWidth: number, height: number, dpr: number): {
+export declare function createAlignedKLine(rectX: number, rectY: number, kWidth: number, height: number, dpr: number, theme?: 'light' | 'dark'): {
     bodyRect: {
         x: number;
         y: number;
@@ -94,7 +94,7 @@ export declare function createAlignedKLine(rectX: number, rectY: number, kWidth:
  * @param dpr - 设备像素比
  * @returns 对齐后的实体和影线信息
  */
-export declare function createAlignedKLineFromPx(leftPx: number, rectY: number, widthPx: number, height: number, dpr: number): {
+export declare function createAlignedKLineFromPx(leftPx: number, rectY: number, widthPx: number, height: number, dpr: number, theme?: 'light' | 'dark'): {
     bodyRect: {
         x: number;
         y: number;

package/dist/src/core/drawing/plugin.d.ts

@@ -1,8 +1,27 @@
 import { RendererPlugin } from '../../plugin';
 import { DrawingStore, DrawingDefinitionRegistry, PrimitiveRendererSet } from './index';
+/**
+ * 创建绘图渲染器插件（主层，负责绘制 shape）
+ * 注意：此插件不再推送轴标签，标签由 createDrawingLabelOverlayPlugin 负责
+ */
 export declare function createDrawingRendererPlugin(options: {
     store: DrawingStore;
     paneId?: string;
     definitions?: DrawingDefinitionRegistry;
     renderers?: PrimitiveRendererSet;
 }): RendererPlugin;
+/**
+ * 创建绘图标签 Overlay 插件
+ *
+ * ⚠️ 警告：此插件必须在 All 和 Overlay 更新级别运行
+ * 当前代码库中没有 UpdateLevel.Main 的触发点，因此此插件设置为 layer: 'overlay' 是安全的
+ * 如果将来添加 Main 级别的更新，此插件会被跳过，导致选中绘图的轴标签消失
+ *
+ * 解决方案：如果将来需要使用 Main 级别，请将此插件改为同时在 main 和 overlay 层注册，
+ * 或移除分层过滤让此插件在所有级别运行
+ */
+export declare function createDrawingLabelOverlayPlugin(options: {
+    store: DrawingStore;
+    paneId?: string;
+    definitions?: DrawingDefinitionRegistry;
+}): RendererPlugin;

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

@@ -334,3 +334,132 @@ export interface DonchianPoint {
 export declare const DEFAULT_DONCHIAN_PERIOD = 20;
 export declare function calcDonchianData(data: KLineData[], period: number): (DonchianPoint | undefined)[];
 export declare function calcDonchianDataSoA(layout: KLineSoALayout, period: number): (DonchianPoint | undefined)[];
+export interface IchimokuPoint {
+    tenkan?: number;
+    kijun?: number;
+    spanA?: number;
+    spanB?: number;
+    chikou?: number;
+}
+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 function calcIchimokuData(data: KLineData[], tenkanPeriod: number, kijunPeriod: number, spanBPeriod: number, displacement: number): (IchimokuPoint | undefined)[];
+export declare function calcIchimokuDataSoA(layout: KLineSoALayout, tenkanPeriod: number, kijunPeriod: number, spanBPeriod: number, displacement: number): (IchimokuPoint | undefined)[];
+export declare const DEFAULT_ROC_PERIOD = 12;
+export declare function calcROCData(data: KLineData[], period: number): (number | undefined)[];
+export declare function calcROCDataSoA(layout: KLineSoALayout, period: number): (number | undefined)[];
+export interface TRIXResult {
+    series: (number | undefined)[];
+    signalSeries: (number | undefined)[];
+}
+export declare const DEFAULT_TRIX_PERIOD = 15;
+export declare const DEFAULT_TRIX_SIGNAL_PERIOD = 9;
+export declare function calcTRIXData(data: KLineData[], period: number, signalPeriod: number): TRIXResult;
+export declare function calcTRIXDataSoA(layout: KLineSoALayout, period: number, signalPeriod: number): TRIXResult;
+export declare const DEFAULT_HV_PERIOD = 20;
+export declare const DEFAULT_HV_ANNUALIZATION = 252;
+export declare function calcHVData(data: KLineData[], period: number, annualizationFactor: number): (number | undefined)[];
+export declare function calcHVDataSoA(layout: KLineSoALayout, period: number, annualizationFactor: number): (number | undefined)[];
+export declare const DEFAULT_PARKINSON_PERIOD = 20;
+export declare const DEFAULT_PARKINSON_ANNUALIZATION = 252;
+export declare function calcParkinsonData(data: KLineData[], period: number, annualizationFactor: number): (number | undefined)[];
+export declare function calcParkinsonDataSoA(layout: KLineSoALayout, period: number, annualizationFactor: number): (number | undefined)[];
+export declare const DEFAULT_CHAIKIN_VOL_EMA_PERIOD = 10;
+export declare const DEFAULT_CHAIKIN_VOL_ROC_PERIOD = 10;
+export declare function calcChaikinVolData(data: KLineData[], emaPeriod: number, rocPeriod: number): (number | undefined)[];
+export declare function calcChaikinVolDataSoA(layout: KLineSoALayout, emaPeriod: number, rocPeriod: number): (number | undefined)[];
+export declare const DEFAULT_VMA_PERIOD = 5;
+export declare function calcVMAData(data: KLineData[], period: number): (number | undefined)[];
+export declare function calcVMADataSoA(layout: KLineSoALayout, period: number): (number | undefined)[];
+export declare function calcOBVData(data: KLineData[]): (number | undefined)[];
+export declare function calcOBVDataSoA(layout: KLineSoALayout): (number | undefined)[];
+export declare function calcPVTData(data: KLineData[]): (number | undefined)[];
+export declare function calcPVTDataSoA(layout: KLineSoALayout): (number | undefined)[];
+export declare const DEFAULT_VWAP_SESSION_GAP_MS = 0;
+export declare function calcVWAPData(data: KLineData[], sessionResetGapMs: number): (number | undefined)[];
+export declare function calcVWAPDataSoA(layout: KLineSoALayout, sessionResetGapMs: number): (number | undefined)[];
+export declare const DEFAULT_CMF_PERIOD = 20;
+export declare function calcCMFData(data: KLineData[], period: number): (number | undefined)[];
+export declare function calcCMFDataSoA(layout: KLineSoALayout, period: number): (number | undefined)[];
+export declare const DEFAULT_MFI_PERIOD = 14;
+export declare function calcMFIData(data: KLineData[], period: number): (number | undefined)[];
+export declare function calcMFIDataSoA(layout: KLineSoALayout, period: number): (number | undefined)[];
+export interface PivotPoint {
+    pp: number;
+    r1: number;
+    r2: number;
+    r3: number;
+    s1: number;
+    s2: number;
+    s3: number;
+}
+export declare function calcPivotData(data: KLineData[]): (PivotPoint | undefined)[];
+export declare function calcPivotDataSoA(layout: KLineSoALayout): (PivotPoint | undefined)[];
+export interface FibPoint {
+    high: number;
+    low: number;
+    direction: 'up' | 'down';
+    level236: number;
+    level382: number;
+    level500: number;
+    level618: number;
+    level786: number;
+}
+export declare const DEFAULT_FIB_PERIOD = 50;
+export declare function calcFibData(data: KLineData[], period: number): (FibPoint | undefined)[];
+export declare function calcFibDataSoA(layout: KLineSoALayout, period: number): (FibPoint | undefined)[];
+export interface SwingPoint {
+    index: number;
+    price: number;
+    kind: 'high' | 'low';
+    label: 'HH' | 'HL' | 'LH' | 'LL';
+    confirmed: boolean;
+}
+export type StructureEventKind = 'BOS' | 'CHOCH';
+export interface StructureEvent {
+    kind: StructureEventKind;
+    index: number;
+    triggerPrice: number;
+    brokenLevel: number;
+    brokenSwingIndex: number;
+    direction: 'up' | 'down';
+}
+export interface StructureSnapshot {
+    swings: SwingPoint[];
+    events: StructureEvent[];
+    trend: 'up' | 'down' | 'range';
+}
+export declare const DEFAULT_STRUCTURE_LEFT = 2;
+export declare const DEFAULT_STRUCTURE_RIGHT = 2;
+export declare function calcStructureData(data: KLineData[], leftWindow: number, rightWindow: number, breakoutSource: 'close' | 'wick'): StructureSnapshot;
+export declare function calcStructureDataSoA(layout: KLineSoALayout, leftWindow: number, rightWindow: number, breakoutSource: 'close' | 'wick'): StructureSnapshot;
+export type ZoneKind = 'FVG_BULL' | 'FVG_BEAR' | 'OB_BULL' | 'OB_BEAR';
+export interface Zone {
+    kind: ZoneKind;
+    startIndex: number;
+    endIndex?: number;
+    high: number;
+    low: number;
+}
+export declare const DEFAULT_ZONES_OB_LOOKBACK = 5;
+export declare function calcZonesData(data: KLineData[], obLookback: number, structureLeftWindow: number, structureRightWindow: number, breakoutSource: 'close' | 'wick'): Zone[];
+export declare function calcZonesDataSoA(layout: KLineSoALayout, obLookback: number, structureLeftWindow: number, structureRightWindow: number, breakoutSource: 'close' | 'wick'): Zone[];
+export interface VolumeProfileBin {
+    priceLow: number;
+    priceHigh: number;
+    volume: number;
+}
+export interface VolumeProfileResult {
+    bins: VolumeProfileBin[];
+    poc: number;
+    vah: number;
+    val: number;
+    totalVolume: number;
+}
+export declare const DEFAULT_VP_BINS = 24;
+export declare const DEFAULT_VP_LOOKBACK = 0;
+export declare const DEFAULT_VP_VALUE_AREA = 0.7;
+export declare function calcVolumeProfileData(data: KLineData[], bins: number, lookback: number, valueAreaPercent: number): VolumeProfileResult;
+export declare function calcVolumeProfileDataSoA(layout: KLineSoALayout, bins: number, lookback: number, valueAreaPercent: number): VolumeProfileResult;

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

@@ -0,0 +1,18 @@
+import { BaseIndicatorState } from '../../plugin';
+export interface ChaikinVolRenderState extends BaseIndicatorState {
+    timestamp: number;
+    series: (number | undefined)[];
+    params: {
+        emaPeriod: number;
+        rocPeriod: number;
+        showChaikinVol: boolean;
+    };
+    valueMin: number;
+    valueMax: number;
+    visibleMin: number;
+    visibleMax: number;
+}
+export declare const createChaikinVolStateKey: (paneId: string) => `indicator:${string}:${string}`;
+export declare const DEFAULT_CHAIKIN_VOL_EMA_PERIOD = 10;
+export declare const DEFAULT_CHAIKIN_VOL_ROC_PERIOD = 10;
+export declare const EMPTY_CHAIKIN_VOL_STATE: ChaikinVolRenderState;

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

@@ -0,0 +1,16 @@
+import { BaseIndicatorState } from '../../plugin';
+export interface CMFRenderState extends BaseIndicatorState {
+    timestamp: number;
+    series: (number | undefined)[];
+    params: {
+        period: number;
+        showCMF: boolean;
+    };
+    valueMin: number;
+    valueMax: number;
+    visibleMin: number;
+    visibleMax: number;
+}
+export declare const createCMFStateKey: (paneId: string) => `indicator:${string}:${string}`;
+export declare const DEFAULT_CMF_PERIOD = 20;
+export declare const EMPTY_CMF_STATE: CMFRenderState;

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

@@ -0,0 +1,26 @@
+import { BaseIndicatorState } from '../../plugin';
+export interface FibPoint {
+    high: number;
+    low: number;
+    direction: 'up' | 'down';
+    level236: number;
+    level382: number;
+    level500: number;
+    level618: number;
+    level786: number;
+}
+export interface FibRenderState extends BaseIndicatorState {
+    timestamp: number;
+    series: (FibPoint | undefined)[];
+    params: {
+        period: number;
+        showLevels: boolean;
+    };
+    valueMin: number;
+    valueMax: number;
+    visibleMin: number;
+    visibleMax: number;
+}
+export declare const createFibStateKey: (paneId: string) => `indicator:${string}:${string}`;
+export declare const DEFAULT_FIB_PERIOD = 50;
+export declare const EMPTY_FIB_STATE: FibRenderState;

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

@@ -0,0 +1,18 @@
+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

@@ -0,0 +1,44 @@
+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;