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

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): number;
-/**
- * 将逻辑坐标对齐到物理像素中心（用于 1px 线条）
- * @param value - 逻辑坐标值
- * @param dpr - 设备像素比
- * @returns 对齐后的逻辑坐标
- */
-export declare function alignToPhysicalPixelCenter(value: number, dpr: number): 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): {
-    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): {
-    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): {
-    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): {
-    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): {
-    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;