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

package/dist/src/utils/kLineDraw/axis.d.ts

@@ -1,150 +0,0 @@
-import { KLineData } from '../../types/price';
-export interface PriceAxisOptions {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    priceRange: {
-        maxPrice: number;
-        minPrice: number;
-    };
-    yPaddingPx?: number;
-    dpr: number;
-    ticks?: number;
-    bgColor?: string;
-    textColor?: string;
-    lineColor?: string;
-    fontSize?: number;
-    paddingX?: number;
-    /** 是否绘制左侧边界竖线（默认 true） */
-    drawLeftBorder?: boolean;
-    /** 是否绘制刻度短线（默认 true） */
-    drawTickLines?: boolean;
-    /** 价格偏移量（用于价格轴平移时同步显示） */
-    priceOffset?: number;
-}
-/** 右侧价格轴（固定，不随 translate/scroll 变化） */
-export declare function drawPriceAxis(ctx: CanvasRenderingContext2D, opts: PriceAxisOptions, theme?: 'light' | 'dark'): void;
-export interface TimeAxisOptions {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    data: KLineData[];
-    scrollLeft: number;
-    kWidth: number;
-    kGap: number;
-    startIndex: number;
-    endIndex: number;
-    dpr: number;
-    bgColor?: string;
-    textColor?: string;
-    lineColor?: string;
-    fontSize?: number;
-    /** 左右内边距（逻辑像素），避免月份/年份文字贴边 */
-    paddingX?: number;
-    /** 是否绘制顶部边界线（默认 true，如果主图已有底边框则设为 false 避免重复） */
-    drawTopBorder?: boolean;
-    /** 是否绘制底部边界线（默认 true，如果副图已有下边框则设为 false 避免重复） */
-    drawBottomBorder?: boolean;
-}
-export interface LastPriceLineOptions {
-    /** 绘图区宽度（逻辑像素） */
-    plotWidth: number;
-    /** 绘图区高度（逻辑像素） */
-    plotHeight: number;
-    /** 当前滚动位置（逻辑像素） */
-    scrollLeft: number;
-    /** 可视范围：用于确定虚线的起止 worldX */
-    startIndex: number;
-    endIndex: number;
-    /** K线布局 */
-    kWidth: number;
-    kGap: number;
-    /** 价格范围 */
-    priceRange: {
-        maxPrice: number;
-        minPrice: number;
-    };
-    /** 最新价 */
-    lastPrice: number;
-    /** Y轴 padding（与绘图区一致） */
-    yPaddingPx?: number;
-    dpr: number;
-    color?: string;
-}
-export interface CrosshairPriceLabelOptions {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    /** 十字线的 y（相对该 canvas 的逻辑像素坐标） */
-    crosshairY: number;
-    priceRange: {
-        maxPrice: number;
-        minPrice: number;
-    };
-    yPaddingPx?: number;
-    dpr: number;
-    bgColor?: string;
-    borderColor?: string;
-    textColor?: string;
-    fontSize?: number;
-    paddingX?: number;
-    /** 价格偏移量（用于价格轴平移时同步显示） */
-    priceOffset?: number;
-    /** 优先显示的价格（如十字线已按 active pane 算好） */
-    price?: number;
-    formatPrice?: (price: number) => string;
-}
-export interface CrosshairTimeLabelOptions {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    /** 十字线的 x（相对该 canvas 的逻辑像素坐标） */
-    crosshairX: number;
-    /** 命中的交易日时间戳（毫秒） */
-    timestamp: number;
-    dpr: number;
-    bgColor?: string;
-    textColor?: string;
-    fontSize?: number;
-    paddingX?: number;
-    paddingY?: number;
-}
-export declare function drawCrosshairTimeLabel(ctx: CanvasRenderingContext2D, opts: CrosshairTimeLabelOptions, theme?: 'light' | 'dark'): void;
-export declare function drawCrosshairPriceLabel(ctx: CanvasRenderingContext2D, opts: CrosshairPriceLabelOptions, theme?: 'light' | 'dark'): void;
-/** 绘制"最新价水平虚线"（画在 plotCanvas 的 world 坐标系：需在 translate(-scrollLeft,0) 之后调用） */
-export declare function drawLastPriceDashedLine(ctx: CanvasRenderingContext2D, opts: LastPriceLineOptions, theme?: 'light' | 'dark'): void;
-/** 底部时间轴（X方向随 scrollLeft 变化） */
-export declare function drawTimeAxis(ctx: CanvasRenderingContext2D, opts: TimeAxisOptions, theme?: 'light' | 'dark'): void;
-/** ============ 轴标签绘制函数 ============ */
-export interface AxisPriceLabelOptions {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    priceY: number;
-    price: number;
-    dpr: number;
-    bgColor?: string;
-    borderColor?: string;
-    textColor?: string;
-    fontSize?: number;
-}
-export declare function drawAxisPriceLabel(ctx: CanvasRenderingContext2D, opts: AxisPriceLabelOptions, theme?: 'light' | 'dark'): void;
-export interface AxisTimeLabelOptions {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    labelX: number;
-    timestamp: number;
-    dpr: number;
-    bgColor?: string;
-    textColor?: string;
-    fontSize?: number;
-    paddingX?: number;
-}
-export declare function drawAxisTimeLabel(ctx: CanvasRenderingContext2D, opts: AxisTimeLabelOptions, theme?: 'light' | 'dark'): void;

package/dist/src/utils/kLineDraw/grid.d.ts

@@ -1,30 +0,0 @@
-import { KLineData } from '../../types/price';
-import { drawOption, PriceRange } from './kLine';
-export interface GridOption {
-    /** 网格线颜色 */
-    gridColor?: string;
-    /** 最新价线颜色 */
-    lastPriceColor?: string;
-    /** 文本颜色 */
-    textColor?: string;
-    /** 文字字号 */
-    fontSize?: number;
-    /** 右侧文字 padding */
-    rightTextPadding?: number;
-    /** 底部日期文字 padding */
-    bottomTextPadding?: number;
-    /** 价格刻度档位数（默认 10） */
-    priceTicks?: number;
-}
-/**
- * 价格/日期网格层（绘制在平移后的坐标系：ctx 已 translate(-scrollLeft, 0)）
- * - Y轴：min/max 价格线 + 右侧价格文字
- * - X轴：日期变更处画竖线 + 底部日期文字
- * - 最新价：可视区最后一根 close 在[min,max]内则画横向虚线 + 右侧文字
- */
-export declare function drawGridLayer(ctx: CanvasRenderingContext2D, data: KLineData[], option: drawOption, logicHeight: number, dpr: number, startIndex: number, endIndex: number, priceRange: PriceRange, 
-/**
- * 右侧价格轴所在的"世界坐标X"（在 translate(-scrollLeft, 0) 之后的坐标系里）
- * 通常传入：scrollLeft + viewWidth
- */
-axisRightX: number, gridOpt?: GridOption, theme?: 'light' | 'dark'): void;

package/dist/src/utils/kLineDraw/kLine.d.ts

@@ -1,15 +0,0 @@
-import { KLineData } from '../../types/price';
-export interface drawOption {
-    kWidth: number;
-    kGap: number;
-    yPaddingPx?: number;
-}
-export interface PriceRange {
-    maxPrice: number;
-    minPrice: number;
-}
-/**
- * @deprecated
- * K线图绘制 - 影线固定为 1 物理像素宽
- */
-export declare function kLineDraw(ctx: CanvasRenderingContext2D, data: KLineData[], option: drawOption, logicHeight: number, dpr?: number, startIndex?: number, endIndex?: number, priceRange?: PriceRange, theme?: 'light' | 'dark'): void;

package/dist/src/utils/kline/format.d.ts

@@ -1,11 +0,0 @@
-import { KLineData } from '../../types/price';
-export { formatShanghaiDate } from '../dateFormat';
-export declare function getUpDownColor(delta: number, theme?: 'light' | 'dark'): string;
-/** 成交量/成交额单位换算：万/亿 */
-export declare function formatWanYi(n: number, digits?: number): string;
-export declare function formatSignedNumber(n: number, digits?: number): string;
-export declare function formatPercent(n: number, digits?: number): string;
-export declare function formatSignedPercent(n: number, digits?: number): string;
-export declare function calcOpenColor(k: KLineData, prev?: KLineData, theme?: 'light' | 'dark'): string;
-export declare function calcCloseColor(k: KLineData, theme?: 'light' | 'dark'): string;
-export declare function calcChangeColor(k: KLineData, theme?: 'light' | 'dark'): string;

package/dist/src/utils/kline/viewport.d.ts

@@ -1,10 +0,0 @@
-import { KLineData } from '../../types/price';
-export type PriceRange = {
-    maxPrice: number;
-    minPrice: number;
-};
-export declare function getVisibleRange(scrollLeft: number, viewWidth: number, kWidth: number, kGap: number, totalDataCount: number): {
-    start: number;
-    end: number;
-};
-export declare function getVisiblePriceRange(data: KLineData[], startIndex: number, endIndex: number): PriceRange;

package/dist/src/utils/logger.d.ts

@@ -1,5 +0,0 @@
-type TagLevel = 'info' | 'success' | 'warn' | 'error';
-export declare function reloadConfig(): void;
-export declare function tagLog(level: TagLevel | string, value: unknown): void;
-export declare function tagLogThrottle(level: TagLevel | string, value: unknown, key: string, wait?: number): void;
-export {};

package/dist/src/utils/mock/genRandomPriceData.d.ts

@@ -1,3 +0,0 @@
-import { KLineData } from '../../types/price';
-export declare function genRandomPriceData(count: number): KLineData[];
-export declare function reversalExampleData(): KLineData[];

package/dist/src/utils/priceToY.d.ts

@@ -1,7 +0,0 @@
-export declare function priceToY(price: number, maxPrice: number, minPrice: number, canvasHeight: number, paddingTop: number, paddingBottom: number): number;
-/**
- * 将逻辑像素 y 反算回价格
- * - y 是相对于绘图区顶部的逻辑像素坐标（不含额外 translate）
- * - paddingTop/paddingBottom 需与 priceToY 使用一致
- */
-export declare function yToPrice(y: number, maxPrice: number, minPrice: number, canvasHeight: number, paddingTop: number, paddingBottom: number): number;

package/dist/src/utils/volumePrice.d.ts

@@ -1,54 +0,0 @@
-import { KLineData } from '../types/price';
-import { VolumePriceRelation, VolumePriceConfig, DEFAULT_VOLUME_PRICE_CONFIG } from '../types/volumePrice';
-export { DEFAULT_VOLUME_PRICE_CONFIG };
-/**
- * 成交量前缀和计算器
- * 用于优化成交量移动平均的计算，避免重复遍历
- */
-export declare class VolumePrefixSum {
-    private prefixSum;
-    private dataLength;
-    /**
-     * 构建前缀和数组
-     * @param data - K线数据数组
-     */
-    build(data: KLineData[]): void;
-    /**
-     * 查询区间 [start, end] 的成交量之和
-     * @param start - 起始索引（包含）
-     * @param end - 结束索引（包含）
-     * @returns 区间成交量之和
-     */
-    query(start: number, end: number): number;
-    /**
-     * 计算成交量移动平均
-     * @param index - 当前K线索引
-     * @param period - 计算周期
-     * @returns 成交量移动平均值
-     */
-    getVolumeMA(index: number, period: number): number;
-    /**
-     * 获取数据长度
-     */
-    get length(): number;
-}
-/**
- * 计算量价关系
- *
- * @param data - K线数据数组
- * @param index - 要分析的K线索引
- * @param config - 量价关系计算配置
- * @returns 量价关系类型
- */
-export declare function analyzeVolumePriceRelation(data: KLineData[], index: number, config: VolumePriceConfig): VolumePriceRelation;
-/**
- * 批量计算量价关系（推荐用于渲染器中）
- * 显式传入前缀和实例，避免重复构建
- *
- * @param data - K线数据数组
- * @param startIndex - 起始索引
- * @param endIndex - 结束索引
- * @param config - 量价关系计算配置
- * @returns 量价关系数组
- */
-export declare function analyzeVolumePriceRelationBatch(data: KLineData[], startIndex: number, endIndex: number, config?: VolumePriceConfig): VolumePriceRelation[];