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

package/dist/src/core/controller/interaction.d.ts

@@ -1,167 +0,0 @@
-import { Chart } from '../chart';
-import { MarkerEntity, CustomMarkerEntity } from '../marker/registry';
-import { ChartSettings } from '../../config/chartSettings';
-export interface InteractionSnapshot {
-    crosshairPos: {
-        x: number;
-        y: number;
-    } | null;
-    crosshairIndex: number | null;
-    crosshairPrice: number | null;
-    hoveredIndex: number | null;
-    activePaneId: string | null;
-    tooltipPos: {
-        x: number;
-        y: number;
-    };
-    tooltipAnchorPlacement: 'right-bottom' | 'left-bottom';
-    hoveredMarkerData: MarkerEntity | null;
-    hoveredCustomMarker: CustomMarkerEntity | null;
-    isDragging: boolean;
-    isResizingPaneBoundary: boolean;
-    isHoveringPaneBoundary: boolean;
-    hoveredPaneBoundaryId: string | null;
-    isHoveringRightAxis: boolean;
-}
-/**
- * 交互控制器，处理拖拽滚动、缩放、十字线 hover 等交互逻辑
- */
-export declare class InteractionController {
-    private chart;
-    private isDragging;
-    private dragMode;
-    private dragStartX;
-    private scrollStartX;
-    private applyPanScroll;
-    /** 垂直拖动相关 */
-    private dragStartY;
-    private activePaneIdOnDrag;
-    /** 分隔线拖拽相关 */
-    private activeSeparatorUpperPaneId;
-    private hoveredSeparatorUpperPaneId;
-    /** 右轴悬浮相关 */
-    private hoveredRightAxisPaneId;
-    /** [触屏]:触摸会话标记，避免触摸触发的模拟 mouse 事件干扰 */
-    private isTouchSession;
-    private pinchTracker;
-    /** 十字线位置 */
-    crosshairPos: {
-        x: number;
-        y: number;
-    } | null;
-    /** 十字线当前指向的 K 线索引 */
-    crosshairIndex: number | null;
-    /** 十字线指向的价格（用于价格轴平移时跟随） */
-    crosshairPrice: number | null;
-    /** 鼠标悬停的 K 线索引（命中 candle 时有效） */
-    hoveredIndex: number | null;
-    /** 当前活跃的 pane ID */
-    activePaneId: string | null;
-    /** tooltip 位置 */
-    tooltipPos: {
-        x: number;
-        y: number;
-    };
-    /** tooltip 尺寸 */
-    tooltipSize: {
-        width: number;
-        height: number;
-    };
-    /** tooltip 锚定位放置方向 */
-    tooltipAnchorPlacement: 'right-bottom' | 'left-bottom';
-    /** 是否使用 CSS 锚定位 */
-    private useTooltipAnchorPositioning;
-    /** 统一交互状态变更回调 */
-    private onInteractionChangeCallback?;
-    /** 用户设置 */
-    private settings;
-    private markerState;
-    /** 当前帧的 K 线起始 x 坐标数组 */
-    private kLinePositions;
-    /** 当前帧的可见 K 线索引范围 */
-    private visibleRange;
-    /** hover 去重快照 */
-    private lastHoverRenderKey;
-    /** K 线宽度（物理像素），用于计算 K 线中心偏移 */
-    private kWidthPx;
-    constructor(chart: Chart);
-    setOnPinchZoom(callback: (delta: number, centerX: number) => void): void;
-    /** 更新用户设置 */
-    updateSettings(settings: ChartSettings): void;
-    getInteractionSnapshot(): InteractionSnapshot;
-    setOnInteractionChange(callback: (snapshot: InteractionSnapshot) => void): void;
-    private notifyInteractionChange;
-    private getHoverRenderKey;
-    /**
-     * [触屏]:处理 Pointer 按下事件
-     * @param e PointerEvent
-     */
-    onPointerDown(e: PointerEvent): void;
-    /**
-     * 设置 tooltip 尺寸
-     * @param size 宽高对象
-     */
-    setTooltipSize(size: {
-        width: number;
-        height: number;
-    }): void;
-    setTooltipAnchorPositioning(enabled: boolean): void;
-    /**
-     * 处理 Pointer 抬起事件
-     * @param e PointerEvent
-     */
-    onPointerUp(e: PointerEvent): void;
-    /**
-     * 处理 Pointer 离开事件
-     * @param e PointerEvent
-     */
-    onPointerLeave(e: PointerEvent): void;
-    /** 处理滚动事件 */
-    onScroll(): void;
-    /**
-     * 处理 Pointer 移动事件（支持鼠标和触屏）
-     * @param e PointerEvent
-     */
-    onPointerMove(e: PointerEvent): void;
-    /**
-     * 设置当前帧的 K 线起始 x 坐标数组和可见范围
-     * @param positions K 线起始 x 坐标数组
-     * @param visibleRange 可见 K 线索引范围
-     * @param kWidthPx K 线宽度（物理像素）
-     */
-    setKLinePositions(positions: number[] | null, visibleRange: {
-        start: number;
-        end: number;
-    } | null, kWidthPx?: number): void;
-    onRightAxisPointerDown(e: PointerEvent): void;
-    onRightAxisPointerMove(e: PointerEvent): void;
-    onRightAxisPointerUp(e: PointerEvent): void;
-    onRightAxisPointerLeave(e: PointerEvent): void;
-    /** 检查是否正在拖拽 */
-    isDraggingState(): boolean;
-    setOnMarkerHover(callback: (marker: MarkerEntity | null) => void): void;
-    setOnMarkerClick(callback: (marker: MarkerEntity) => void): void;
-    setOnCustomMarkerHover(callback: (marker: CustomMarkerEntity | null) => void): void;
-    setOnCustomMarkerClick(callback: (marker: CustomMarkerEntity) => void): void;
-    /** 命中可拖拽分隔线（返回上方 paneId） */
-    private hitTestPaneSeparator;
-    private getPaneByY;
-    private getPlotPointerLocation;
-    private getRightAxisPointerLocation;
-    private beginScalePriceDrag;
-    clearHover(): void;
-    private clearSeparatorState;
-    /**
-     * 从屏幕坐标更新 hover 状态
-     * @param clientX 屏幕 x 坐标
-     * @param clientY 屏幕 y 坐标
-     */
-    private updateRightAxisHoverFromPoint;
-    private updatePlotHoverFromPoint;
-    /**
-     * 重置所有交互状态（数据更新时调用）
-     */
-    reset(): void;
-    /** 获取十字线指向的 K 线索引 */
-    getCrosshairIndex(): number | null;
-}

package/dist/src/core/controller/markerInteraction.d.ts

@@ -1,28 +0,0 @@
-import { MarkerEntity, CustomMarkerEntity, MarkerManager } from '../marker/registry';
-/** Marker交互状态，管理标记 hover/click 状态和回调，与 InteractionController 正交。 */
-export declare class MarkerInteractionState {
-    hoveredMarkerId: string | null;
-    clickedMarkerId: string | null;
-    hoveredMarkerData: MarkerEntity | null;
-    clickedMarkerData: MarkerEntity | null;
-    hoveredCustomMarker: CustomMarkerEntity | null;
-    private onMarkerHoverCallback?;
-    private onMarkerClickCallback?;
-    private onCustomMarkerHoverCallback?;
-    private onCustomMarkerClickCallback?;
-    setOnMarkerHover(callback: (marker: MarkerEntity | null) => void): void;
-    setOnMarkerClick(callback: (marker: MarkerEntity) => void): void;
-    setOnCustomMarkerHover(callback: (marker: CustomMarkerEntity | null) => void): void;
-    setOnCustomMarkerClick(callback: (marker: CustomMarkerEntity) => void): void;
-    handleClick(hitMarker: MarkerEntity): void;
-    /** 从坐标更新 hover 状态。返回 true 表示命中 marker/custom-marker，调用方应跳过后续 hover 逻辑。 */
-    updateHoverFromPoint(worldX: number, mouseX: number, mouseY: number, markerManager: MarkerManager): boolean;
-    private enterMarkerHover;
-    private leaveMarkerHover;
-    private enterCustomMarkerHover;
-    private leaveCustomMarkerHover;
-    /** 清空 hover 状态并触发回调（拖拽/离开时调用）。需要 markerManager 以便同步清除 Native hover。 */
-    clearAll(markerManager: MarkerManager): void;
-    /** 全量重置（数据更新时调用，不触发热点回调） */
-    reset(): void;
-}

package/dist/src/core/controller/pinchTracker.d.ts

@@ -1,18 +0,0 @@
-/** 触屏双指捏合跟踪，与 InteractionController 正交。 */
-export declare class PinchTracker {
-    private activePointers;
-    private lastPinchDistance;
-    private pinchCenter;
-    private isPinching;
-    private onPinchZoomCallback?;
-    setOnPinchZoom(callback: (delta: number, centerX: number) => void): void;
-    getIsPinching(): boolean;
-    getPointerCount(): number;
-    /** Returns true if pinch started (caller should early-return, not process drag). */
-    handlePointerDown(e: PointerEvent, isTouchSession: boolean): boolean;
-    handlePointerUp(e: PointerEvent): void;
-    handlePointerLeave(e: PointerEvent): void;
-    /** Returns true if pinch zoom was processed (caller should skip further pointer-move handling). */
-    handlePointerMove(e: PointerEvent): boolean;
-    reset(): void;
-}

package/dist/src/core/controller/tooltipPosition.d.ts

@@ -1,21 +0,0 @@
-export interface TooltipPositionInput {
-    mouseX: number;
-    mouseY: number;
-    viewWidth: number;
-    viewHeight: number;
-    plotWidth: number;
-    plotHeight: number;
-    tooltipSize: {
-        width: number;
-        height: number;
-    };
-    useAnchorPositioning: boolean;
-}
-export interface TooltipPositionOutput {
-    pos: {
-        x: number;
-        y: number;
-    };
-    anchorPlacement?: 'right-bottom' | 'left-bottom';
-}
-export declare function computeTooltipPosition(input: TooltipPositionInput): TooltipPositionOutput;

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

@@ -1,114 +0,0 @@
-/**
- * 像素对齐工具函数 - 逻辑像素空间（配合 ctx.scale(dpr) 使用）
- */
-/**
- * 将逻辑坐标对齐到物理像素边界（用于矩形填充）
- * @param value - 逻辑坐标值
- * @param dpr - 设备像素比
- * @returns 对齐后的逻辑坐标
- */
-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, theme?: 'light' | 'dark'): number;
-/**
- * 对齐矩形到物理像素边界
- * @param x - 矩形左边界 X 坐标
- * @param y - 矩形顶部 Y 坐标
- * @param width - 矩形宽度
- * @param height - 矩形高度
- * @param dpr - 设备像素比
- * @returns 对齐后的矩形信息
- */
-export declare function alignRect(x: number, y: number, width: number, height: number, dpr: number, theme?: 'light' | 'dark'): {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-};
-/**
- * 创建用于绘制垂直线的矩形（1 物理像素宽）
- * @param centerX - 垂直线中心 X 坐标
- * @param y1 - 垂直线起始点 Y 坐标
- * @param y2 - 垂直线结束点 Y 坐标
- * @param dpr - 设备像素比
- * @returns 对齐到物理像素的矩形信息，如果 y1 和 y2 相等则返回 null
- */
-export declare function createVerticalLineRect(centerX: number, y1: number, y2: number, dpr: number, theme?: 'light' | 'dark'): {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-} | null;
-/**
- * 创建用于绘制水平线的矩形（1 物理像素高）
- * @param x1 - 水平线起始点的 X 坐标
- * @param x2 - 水平线结束点的 X 坐标
- * @param centerY - 水平线中心 Y 坐标
- * @param dpr - 设备像素比
- * @returns 对齐到物理像素的矩形信息，如果 x1 和 x2 相等则返回 null
- */
-export declare function createHorizontalLineRect(x1: number, x2: number, centerY: number, dpr: number, theme?: 'light' | 'dark'): {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-} | null;
-/**
- * 创建对齐的K线实体和影线
- * @param rectX - 实体左边界 X 坐标（逻辑像素）
- * @param rectY - 实体顶部 Y 坐标（逻辑像素）
- * @param kWidth - 实体宽度（逻辑像素）
- * @param height - 实体高度（逻辑像素）
- * @param dpr - 设备像素比
- * @returns 对齐后的实体和影线信息
- */
-export declare function createAlignedKLine(rectX: number, rectY: number, kWidth: number, height: number, dpr: number, theme?: 'light' | 'dark'): {
-    bodyRect: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    physBodyLeft: number;
-    physBodyRight: number;
-    physBodyWidth: number;
-    physBodyCenter: number;
-    physWickX: number;
-    wickRect: {
-        x: number;
-        width: number;
-    };
-    isPerfectlyAligned: boolean;
-};
-/**
- * 创建对齐的K线实体和影线（物理像素直接版）
- * @param leftPx - 实体左边界物理像素坐标（整数）
- * @param rectY - 实体顶部 Y 坐标（逻辑像素）
- * @param widthPx - 实体宽度物理像素（奇数）
- * @param height - 实体高度（逻辑像素）
- * @param dpr - 设备像素比
- * @returns 对齐后的实体和影线信息
- */
-export declare function createAlignedKLineFromPx(leftPx: number, rectY: number, widthPx: number, height: number, dpr: number, theme?: 'light' | 'dark'): {
-    bodyRect: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    physBodyLeft: number;
-    physBodyRight: number;
-    physBodyWidth: number;
-    physBodyCenter: number;
-    physWickX: number;
-    wickRect: {
-        x: number;
-        width: number;
-    };
-    isPerfectlyAligned: boolean;
-};

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

@@ -1,47 +0,0 @@
-import { DrawingObject, DrawingKind, DrawingDefinition, DrawingComputeContext, DrawingGeometry, DrawingStyle, PointPrimitive, LinePrimitive, AreaPrimitive, TextPrimitive } from '../../plugin';
-export type { DrawingObject, DrawingKind, DrawingDefinition, DrawingComputeContext, DrawingGeometry, DrawingStyle, PointPrimitive, LinePrimitive, AreaPrimitive, TextPrimitive, };
-export declare class DrawingStore {
-    private drawings;
-    private selectedId;
-    getSelectedId(): string | null;
-    setSelectedId(id: string | null): void;
-    getAll(): DrawingObject[];
-    getVisibleByPane(paneId: string): DrawingObject[];
-    setAll(drawings: DrawingObject[]): void;
-    upsert(drawing: DrawingObject): void;
-    remove(id: string): void;
-    clear(): void;
-}
-export declare class DrawingDefinitionRegistry {
-    private definitions;
-    register<TParams = Record<string, unknown>>(definition: DrawingDefinition<TParams>): void;
-    get(kind: DrawingKind): DrawingDefinition | undefined;
-    compute(drawing: DrawingObject, context: DrawingComputeContext): DrawingGeometry | null;
-}
-export type PrimitiveRendererSet = {
-    point: (ctx: CanvasRenderingContext2D, primitive: PointPrimitive, dpr: number) => void;
-    line: (ctx: CanvasRenderingContext2D, primitive: LinePrimitive, viewportClip: {
-        left: number;
-        top: number;
-        right: number;
-        bottom: number;
-    }, dpr: number) => void;
-    area: (ctx: CanvasRenderingContext2D, primitive: AreaPrimitive, dpr: number) => void;
-    text: (ctx: CanvasRenderingContext2D, primitive: TextPrimitive, dpr: number) => void;
-};
-export declare function computeLinearRegression(values: number[]): {
-    slope: number;
-    intercept: number;
-    stdDev: number;
-} | null;
-export declare function createDefaultPrimitiveRendererSet(): PrimitiveRendererSet;
-export declare function createTwoPointLineDefinition(kind: DrawingKind, extend: LinePrimitive['extend']): DrawingDefinition;
-export declare function createSingleAnchorLineDefinition(kind: DrawingKind): DrawingDefinition;
-export declare function createInfoLineDefinition(): DrawingDefinition;
-export declare function createParallelChannelDefinition(): DrawingDefinition;
-export declare function createFlatLineDefinition(): DrawingDefinition;
-export declare function createDisjointChannelDefinition(): DrawingDefinition;
-export declare function createRegressionChannelDefinition(): DrawingDefinition;
-export declare function registerDefaultDrawingDefinitions(registry: DrawingDefinitionRegistry): void;
-export { DrawingInteractionController } from './interaction';
-export type { DrawingToolId, DrawingAnchorInput, DrawingInteractionCallbacks } from './interaction';

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

@@ -1,75 +0,0 @@
-import { DrawingObject, DrawingStyle } from '../../plugin';
-import { Chart } from '../chart';
-export type DrawingToolId = 'cursor' | 'trend-line' | 'ray' | 'h-line' | 'h-ray' | 'v-line' | 'crosshair-line' | 'info-line' | 'parallel-channel' | 'regression-channel' | 'flat-line' | 'disjoint-channel';
-export interface DrawingAnchorInput {
-    index: number;
-    time?: number;
-    price: number;
-}
-export interface DrawingInteractionCallbacks {
-    onDrawingCreated?: (drawing: DrawingObject) => void;
-    onToolChange?: (toolId: DrawingToolId) => void;
-    onDrawingSelected?: (drawing: DrawingObject | null) => void;
-}
-/**
- * 绘图交互控制器
- * 封装绘图工具的交互逻辑，与 Vue 组件解耦
- */
-export declare class DrawingInteractionController {
-    private chart;
-    private activeTool;
-    private pendingAnchors;
-    private drawings;
-    private callbacks;
-    private previewDrawingId;
-    private dragState;
-    private selectedDrawingId;
-    private static readonly SINGLE_ANCHOR_TOOLS;
-    private static readonly DOUBLE_ANCHOR_TOOLS;
-    private static readonly TRIPLE_ANCHOR_TOOLS;
-    constructor(chart: Chart);
-    setCallbacks(callbacks: DrawingInteractionCallbacks): void;
-    getActiveTool(): DrawingToolId;
-    setTool(toolId: DrawingToolId): void;
-    getDrawings(): DrawingObject[];
-    setDrawings(drawings: DrawingObject[]): void;
-    clear(): void;
-    getSelectedDrawing(): DrawingObject | null;
-    updateDrawingStyle(drawingId: string, style: Partial<DrawingStyle>): void;
-    removeDrawing(drawingId: string): void;
-    /**
-     * 处理指针移动事件
-     * @returns 是否处理了事件（阻止冒泡）
-     */
-    onPointerMove(e: PointerEvent, container: HTMLElement): boolean;
-    /**
-     * 处理指针按下事件
-     * @returns 是否处理了事件（阻止冒泡）
-     */
-    onPointerDown(e: PointerEvent, container: HTMLElement): boolean;
-    /**
-     * 处理指针释放事件
-     * @returns 是否处理了事件（阻止冒泡）
-     */
-    onPointerUp(_e: PointerEvent, _container: HTMLElement): boolean;
-    private handleCursorDown;
-    private handleDragMove;
-    private handlePreviewMove;
-    private hitTest;
-    private getDrawingLineSegments;
-    /**
-     * regression-channel 专用：回归线端点也是可拖拽的锚点区域
-     * 回归线端点可能远离存储的锚点，需要额外检测
-     */
-    private hitTestRegressionEndpoints;
-    private getRegressionChannelGeometry;
-    private getExtendMode;
-    private anchorToScreen;
-    private screenToAnchor;
-    private setSelected;
-    private removePreview;
-    private resolveAnchorFromPointer;
-    private createSingleAnchorDrawing;
-    private createMultiAnchorDrawing;
-    private getDrawingKind;
-}

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

@@ -1,27 +0,0 @@
-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/atrState.d.ts

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

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

@@ -1,34 +0,0 @@
-import { BaseIndicatorState } from '../../plugin';
-import { BOLLPoint } from './calculators';
-/**
- * BOLL 渲染器状态（共享给渲染器和图例）
- * 包含全量 BOLL 数组、计算参数、以及视口极值
- */
-export interface BOLLRenderState extends BaseIndicatorState {
-    timestamp: number;
-    /** 全量 BOLL 数组（稀疏：前 period-1 个为 undefined） */
-    series: BOLLPoint[];
-    /** 计算和渲染参数（渲染器从此读取 showUpper/showMiddle/showLower/showBand） */
-    params: {
-        period: number;
-        multiplier: number;
-        showUpper: boolean;
-        showMiddle: boolean;
-        showLower: boolean;
-        showBand: boolean;
-    };
-    /** 视口内所有 BOLL 线的最低价 */
-    visibleMin: number;
-    /** 视口内所有 BOLL 线的最高价 */
-    visibleMax: number;
-}
-/**
- * BOLL 状态的 StateStore 键名
- * 格式：indicator:boll:main
- */
-export declare const BOLL_STATE_KEY: `indicator:${string}:${string}`;
-/**
- * 空数据占位状态
- * 消费者应检查 visibleMin > visibleMax 判断"无有效数据"
- */
-export declare const EMPTY_BOLL_STATE: BOLLRenderState;