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

package/dist/src/core/renderers/yAxis.d.ts

@@ -1,14 +0,0 @@
-import { RendererPlugin } from '../../plugin';
-/**
- * 创建 Y 轴渲染器插件
- * 按 pane capability 决定是否绘制刻度与价格标签
- */
-export declare function createYAxisRendererPlugin(options: {
-    axisWidth: number;
-    yPaddingPx: number;
-    getCrosshair?: () => {
-        y: number;
-        price: number;
-        activePaneId: string | null;
-    } | null;
-}): RendererPlugin;

package/dist/src/core/scale/logFormula.d.ts

@@ -1,66 +0,0 @@
-import { PriceRange } from './price';
-/**
- * LogFormula 接口
- * 用于对数变换的动态偏移，保证极小值下的精度
- *
- * - logicalOffset: 逻辑偏移，使输出值落在合理范围
- * - coordOffset: 坐标偏移，避免 log10(0) 并提升精度
- */
-export interface LogFormula {
-    logicalOffset: number;
-    coordOffset: number;
-}
-/**
- * 真实价格 → log 逻辑空间
- * 公式: sign(price) * (log10(|price| + coordOffset) + logicalOffset)
- *
- * @param price 真实价格（可为负数）
- * @param f LogFormula
- * @returns log 逻辑空间值
- */
-export declare function toLog(price: number, f: LogFormula): number;
-/**
- * log 逻辑空间 → 真实价格
- * 公式: sign(logical) * (10^(|logical| - logicalOffset) - coordOffset)
- *
- * @param logical log 逻辑空间值
- * @param f LogFormula
- * @returns 真实价格
- */
-export declare function fromLog(logical: number, f: LogFormula): number;
-/**
- * 根据价格范围动态计算 LogFormula
- *
- * 对于常规价格范围 (diff >= 1)，使用默认值。
- * 对于极小价格范围 (diff < 1)，自动增大 logicalOffset 以维持精度。
- *
- * @param range 价格范围，可为 null
- * @returns 最优的 LogFormula
- */
-export declare function logFormulaForPriceRange(range: PriceRange | null): LogFormula;
-/**
- * 范围转 log 空间
- * 将价格的 min/max 都转换到 log 空间
- *
- * @param range 真实价格范围
- * @param f LogFormula
- * @returns log 空间的价格范围
- */
-export declare function convertPriceRangeToLog(range: PriceRange, f: LogFormula): PriceRange;
-/**
- * 范围从 log 空间转回
- * 将 log 空间的 min/max 转换回真实价格
- *
- * @param range log 空间的价格范围
- * @param f LogFormula
- * @returns 真实价格范围
- */
-export declare function convertPriceRangeFromLog(range: PriceRange, f: LogFormula): PriceRange;
-/**
- * 判断两个 LogFormula 是否相同
- *
- * @param a LogFormula A
- * @param b LogFormula B
- * @returns 是否相同
- */
-export declare function logFormulasAreSame(a: LogFormula, b: LogFormula): boolean;

package/dist/src/core/scale/price.d.ts

@@ -1,11 +0,0 @@
-export type PriceRange = {
-    maxPrice: number;
-    minPrice: number;
-};
-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/core/scale/priceScale.d.ts

@@ -1,87 +0,0 @@
-import { PriceRange } from './price';
-import { ScaleType } from '../utils/tickPosition';
-/**
- * Pane 级别的价格坐标系（价格 -> pane 内 Y）
- * - y=0 在 pane 顶部，y=height 在 pane 底部
- */
-export declare class PriceScale {
-    private range;
-    private height;
-    private paddingTop;
-    private paddingBottom;
-    /** 价格偏移量（用于上下拖动平移价格轴）
-     * 在对数模式下，此偏移量为 log 空间偏移 */
-    private priceOffset;
-    /** 垂直缩放系数（1=默认，>1 放大，<1 缩小） */
-    private verticalScale;
-    /** 刻度类型：线性或对数 */
-    private scaleType;
-    /** 对数变换公式（动态计算，适配极小价格） */
-    private logFormula;
-    setRange(r: PriceRange): void;
-    setHeight(h: number): void;
-    setPadding(top: number, bottom: number): void;
-    getRange(): PriceRange;
-    getPaddingTop(): number;
-    getPaddingBottom(): number;
-    /**
-     * 设置价格偏移量
-     * @param offset 价格偏移
-     *   - 线性模式：真实价格的线性偏移
-     *   - 对数模式：log 空间的偏移量
-     */
-    setPriceOffset(offset: number): void;
-    /**
-     * 获取当前价格偏移量
-     */
-    getPriceOffset(): number;
-    /**
-     * 重置价格偏移量
-     */
-    resetPriceOffset(): void;
-    /**
-     * 根据当前 range 和 verticalScale 对 priceOffset 进行 clamp，
-     * 防止视口完全离开数据范围。
-     */
-    private clampOffset;
-    /**
-     * 按拖拽位移缩放 Y 轴（deltaY < 0 放大，deltaY > 0 缩小）
-     */
-    scaleByDelta(deltaY: number): void;
-    getVerticalScale(): number;
-    /**
-     * 设置刻度类型
-     * 切换时会自动转换 priceOffset 以保持视口位置
-     */
-    setScaleType(type: ScaleType): void;
-    /**
-     * 获取当前刻度类型
-     */
-    getScaleType(): ScaleType;
-    /**
-     * 获取显示范围（考虑 priceOffset 和 verticalScale）
-     *
-     * 对数模式下：
-     * - 内部计算在 log 空间进行
-     * - 返回的价格为真实价格
-     */
-    getDisplayRange(baseRange?: PriceRange): PriceRange;
-    /**
-     * 价格 → Y 坐标
-     * 统一使用 getDisplayRange 的结果进行映射
-     */
-    priceToY(price: number): number;
-    /**
-     * Y 坐标 → 价格
-     * 统一使用 getDisplayRange 的结果进行映射
-     */
-    yToPrice(y: number): number;
-    /**
-     * 根据像素偏移计算价格偏移
-     * @param deltaY Y轴像素偏移（正数向下拖动）
-     * @returns 对应的价格偏移量
-     *   - 线性模式：真实价格的偏移
-     *   - 对数模式：log 空间的偏移
-     */
-    deltaYToPriceOffset(deltaY: number): number;
-}

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

@@ -1,22 +0,0 @@
-import { Chart } from './chart';
-import { SubIndicatorType } from './renderers/Indicator';
-export interface SubPaneEntry {
-    paneId: string;
-    indicatorId: SubIndicatorType;
-    params: Record<string, unknown>;
-    rendererName: string;
-    scaleRendererName: string;
-}
-export declare class SubPaneManager {
-    private entries;
-    create(chart: Chart, paneId: string, indicatorId: SubIndicatorType, params: Record<string, unknown>): boolean;
-    remove(chart: Chart, paneId: string): void;
-    replaceIndicator(chart: Chart, paneId: string, newIndicatorId: SubIndicatorType, newParams: Record<string, unknown>): void;
-    updateParams(chart: Chart, paneId: string, params: Record<string, unknown>): void;
-    getByPaneId(paneId: string): SubPaneEntry | undefined;
-    getAll(): SubPaneEntry[];
-    getPaneIds(): string[];
-    clear(chart: Chart): void;
-    private syncSchedulerConfig;
-    private mountScaleRenderer;
-}

package/dist/src/core/theme/colors.d.ts

@@ -1,222 +0,0 @@
-/**
- * 主题感知颜色配置
- * 所有颜色通过 getColors(theme) 获取，支持 light/dark 双主题
- */
-/** 主题类型 */
-export type ChartTheme = 'light' | 'dark';
-/** 文本颜色 */
-export interface TextColors {
-    PRIMARY: string;
-    SECONDARY: string;
-    TERTIARY: string;
-    WEAK: string;
-    WHITE: string;
-}
-/** 涨跌价格颜色 */
-export interface PriceColors {
-    UP: string;
-    UP_LIGHT: string;
-    UP_TICK: string;
-    DOWN: string;
-    DOWN_LIGHT: string;
-    DOWN_TICK: string;
-    NEUTRAL: string;
-    LAST_PRICE: string;
-}
-/** 标签背景颜色 */
-export interface TagBgColors {
-    WHITE: string;
-    LIGHT_GRAY: string;
-    PURE_WHITE: string;
-    TRANSPARENT: string;
-    ACTIVE: string;
-    ACTIVE_HOVER: string;
-    HOVER: string;
-}
-/** 边框颜色 */
-export interface BorderColors {
-    DARK: string;
-    MEDIUM: string;
-    LIGHT: string;
-    SEPARATOR: string;
-    BUTTON: string;
-}
-/** 网格线颜色 */
-export interface GridColors {
-    HORIZONTAL: string;
-    VERTICAL: string;
-}
-/** 十字线颜色 */
-export interface CrosshairColors {
-    LINE: string;
-    LABEL_BG: string;
-    LABEL_TEXT: string;
-}
-/** 均线颜色 */
-export interface MAColors {
-    MA5: string;
-    MA10: string;
-    MA20: string;
-    MA30: string;
-    MA60: string;
-}
-/** 布林带颜色 */
-export interface BOLLColors {
-    UPPER: string;
-    MIDDLE: string;
-    LOWER: string;
-    BAND_FILL: string;
-}
-/** MACD 颜色 */
-export interface MACDColors {
-    DIF: string;
-    DEA: string;
-    BAR_UP: string;
-    BAR_UP_LIGHT: string;
-    BAR_DOWN: string;
-    BAR_DOWN_LIGHT: string;
-}
-/** 成交量颜色 */
-export interface VolumeColors {
-    UP: string;
-    DOWN: string;
-    NEUTRAL: string;
-}
-/** RSI 颜色 */
-export interface RSIColors {
-    RSI1: string;
-    RSI2: string;
-    RSI3: string;
-}
-/** CCI 颜色 */
-export interface CCIColors {
-    CCI: string;
-    OVERBOUGHT: string;
-    OVERSOLD: string;
-}
-/** KDJ/STOCH 颜色 */
-export interface KDJColors {
-    K: string;
-    D: string;
-    J: string;
-}
-/** MOM 颜色 */
-export interface MOMColors {
-    MOM: string;
-    ZERO: string;
-}
-/** WMSR 颜色 */
-export interface WMSRColors {
-    WMSR: string;
-    OVERBOUGHT: string;
-    OVERSOLD: string;
-}
-/** KST 颜色 */
-export interface KSTColors {
-    KST: string;
-    SIGNAL: string;
-}
-/** EXPMA 颜色 */
-export interface EXPMAColors {
-    FAST: string;
-    SLOW: string;
-}
-/** ENE 颜色 */
-export interface ENEColors {
-    UPPER: string;
-    MIDDLE: string;
-    LOWER: string;
-    BAND_FILL: string;
-}
-/** 标签专用颜色（收敛硬编码） */
-export interface LabelColors {
-    BG: string;
-    TEXT: string;
-}
-/** 最新价标签颜色 */
-export interface LastPriceLabelColors {
-    BG: string;
-}
-/** 成交量价格标记颜色 */
-export interface VolumePriceColors {
-    RISE_WITH: string;
-    RISE_WITHOUT: string;
-    FALL_WITH: string;
-    FALL_WITHOUT: string;
-}
-/** Structure 指标颜色 */
-export interface StructureColors {
-    HH: string;
-    HL: string;
-    LH: string;
-    LL: string;
-    CHOCH: string;
-    BOS: string;
-}
-/** Zones 指标颜色 */
-export interface ZonesColors {
-    FVG_BULL_FILL: string;
-    FVG_BEAR_FILL: string;
-    FVG_BULL_BORDER: string;
-    FVG_BEAR_BORDER: string;
-    OB_BULL_FILL: string;
-    OB_BEAR_FILL: string;
-}
-/** 主题色值集合 */
-export interface ThemeColors {
-    TEXT: TextColors;
-    PRICE: PriceColors;
-    TAG_BG: TagBgColors;
-    BORDER: BorderColors;
-    GRID: GridColors;
-    CROSSHAIR: CrosshairColors;
-    MA: MAColors;
-    BOLL: BOLLColors;
-    MACD: MACDColors;
-    VOLUME: VolumeColors;
-    RSI: RSIColors;
-    CCI: CCIColors;
-    KDJ: KDJColors;
-    MOM: MOMColors;
-    WMSR: WMSRColors;
-    KST: KSTColors;
-    EXPMA: EXPMAColors;
-    ENE: ENEColors;
-    /** 收敛的硬编码色值 */
-    LABEL: LabelColors;
-    LAST_PRICE_LABEL: LastPriceLabelColors;
-    VOLUME_PRICE: VolumePriceColors;
-    STRUCTURE: StructureColors;
-    ZONES: ZonesColors;
-    WMSR_GRID: string;
-}
-/**
- * 根据主题获取颜色配置
- * @param theme - 主题类型 'light' | 'dark'
- * @returns 主题色值集合
- */
-export declare function getColors(theme: ChartTheme): ThemeColors;
-/**
- * 日志颜色（与主题无关，保留常量导出）
- */
-export declare const LOG_COLORS: {
-    readonly INFO: "background:#164586;color:#fff;";
-    readonly SUCCESS: "background:#389e0d;color:#fff;";
-    readonly WARN: "background:#d46b08;color:#fff;";
-    readonly ERROR: "background:#cf1322;color:#fff;";
-    readonly CONSOLE: "#666";
-};
-/**
- * 工具函数：根据涨跌返回颜色
- * @param type - 涨跌类型
- * @param theme - 主题类型
- * @returns 对应颜色
- */
-export declare function getPriceColor(type: 'up' | 'down' | 'neutral', theme?: ChartTheme): string;
-/**
- * 工具函数：根据涨跌百分比返回颜色
- * @param changePercent - 涨跌百分比
- * @param theme - 主题类型
- * @returns 对应颜色
- */
-export declare function getTickColor(changePercent: number, theme?: ChartTheme): string;

package/dist/src/core/theme/fonts.d.ts

@@ -1,12 +0,0 @@
-/**
- * 图表字体配置
- * 字体栈：Trebuchet MS (Windows系统字体) -> Roboto -> Ubuntu -> 通用无衬线字体
- * 通过 Google Fonts CDN 加载 Roboto 和 Ubuntu
- */
-/** 数字和文本的标准字体栈 */
-export declare const FONT_FAMILY = "\"Trebuchet MS\", Roboto, Ubuntu, sans-serif";
-/** 获取指定字号的字体字符串，用于 Canvas ctx.font */
-export declare function getFont(size: number, options?: {
-    bold?: boolean;
-}): string;
-export declare function setCanvasFont(ctx: CanvasRenderingContext2D, font: string): void;

package/dist/src/core/utils/klineConfig.d.ts

@@ -1,28 +0,0 @@
-/**
- * K 线物理像素配置工具函数
- * 用于统一渲染、交互、视口计算的坐标系统
- */
-/**
- * 计算奇数化后的 K 线宽度（物理像素），确保影线能完美居中显示
- * @param kWidth K 线宽度（逻辑像素）
- * @param dpr 设备像素比
- * @returns 奇数化后的物理像素宽度
- */
-export declare function calcKWidthPx(kWidth: number, dpr: number): number;
-/**
- * 获取图表渲染使用的物理像素配置
- * @param kWidth K 线宽度（逻辑像素）
- * @param kGap K 线间隙（逻辑像素）
- * @param dpr 设备像素比
- * @returns 物理像素和逻辑像素的配置对象
- */
-export declare function getPhysicalKLineConfig(kWidth: number, kGap: number, dpr: number): {
-    kWidthPx: number;
-    kGapPx: number;
-    unitPx: number;
-    startXPx: number;
-    kWidthLogical: number;
-    kGapLogical: number;
-    unitLogical: number;
-    startXLogical: number;
-};

package/dist/src/core/utils/tickCount.d.ts

@@ -1,8 +0,0 @@
-/**
- * 根据面板高度计算网格线/价格标签数量
- * 刻度间距固定约 60px
- * @param height 面板高度（逻辑像素）
- * @param isMain 是否为主图面板（暂未使用，保留参数兼容）
- * @returns tick 数量
- */
-export declare function calculateTickCount(height: number, isMain?: boolean): number;

package/dist/src/core/utils/tickPosition.d.ts

@@ -1,24 +0,0 @@
-export interface TickPosition {
-    index: number;
-    t: number;
-    y: number;
-}
-export type ScaleType = 'linear' | 'log';
-export interface CalculateTickPositionsOptions {
-    height: number;
-    paddingTop: number;
-    paddingBottom: number;
-    isMain?: boolean;
-    hideEdgeTicks?: boolean;
-    scaleType?: ScaleType;
-}
-export declare function calculateTickPositions(options: CalculateTickPositionsOptions): TickPosition[];
-export interface TickPositionWithValue extends TickPosition {
-    value: number;
-}
-export interface CalculateValueTickPositionsOptions extends CalculateTickPositionsOptions {
-    valueMin: number;
-    valueMax: number;
-    logBase?: number;
-}
-export declare function calculateValueTickPositions(options: CalculateValueTickPositionsOptions): TickPositionWithValue[];

package/dist/src/core/utils/zoom.d.ts

@@ -1,30 +0,0 @@
-/**
- * 缩放计算纯函数
- * 无副作用、无 DOM 访问，供 Vue 层直接调用
- */
-export interface ZoomConfig {
-    minKWidth: number;
-    maxKWidth: number;
-    zoomLevelCount: number;
-    dpr: number;
-}
-export interface ZoomResult {
-    targetLevel: number;
-    newKWidth: number;
-    newKGap: number;
-    newScrollLeft: number;
-}
-/** 将缩放级别转换为 K 线宽度（逻辑像素） */
-export declare function zoomLevelToKWidth(level: number, config: ZoomConfig): number;
-/** 根据K线宽度和DPR推导间隙（逻辑像素），K线越窄间距越小 */
-export declare function kGapFromKWidth(kWidth: number, dpr: number): number;
-/**
- * 缩放一级（+1 放大 / -1 缩小）
- * 返回新状态或 null（已达边界）
- */
-export declare function computeZoom(delta: number, mouseX: number, scrollLeft: number, currentLevel: number, currentKWidth: number, currentKGap: number, config: ZoomConfig): ZoomResult | null;
-/**
- * 缩放到指定级别
- * 返回新状态或 null（级别不变或无效）
- */
-export declare function computeZoomToLevel(targetLevel: number, anchorX: number, scrollLeft: number, currentLevel: number, currentKWidth: number, currentKGap: number, config: ZoomConfig): ZoomResult | null;

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

@@ -1,31 +0,0 @@
-import { KLineData } from '../../types/price';
-import { PriceRange } from '../scale/price';
-/**
- * 计算当前视口可见的 K 线索引范围（使用物理像素对齐）。
- *
- * - 所有计算在物理像素空间进行，确保与 calcKLinePositions 一致
- * - 会额外在左右各扩展 1 根（start-1/end+1），用于避免边缘裁剪带来的”断线/缺一根”观感
- *
- * @param scrollLeft 容器当前横向滚动量（逻辑像素）
- * @param viewWidth  绘图区域宽度（plotWidth，逻辑像素，不含右侧 yAxis）
- * @param kWidth     单根 K 线宽度（逻辑像素）
- * @param kGap       K 线间距（逻辑像素）
- * @param totalDataCount 数据总条数
- * @param dpr        设备像素比
- */
-export declare function getVisibleRange(scrollLeft: number, viewWidth: number, kWidth: number, kGap: number, totalDataCount: number, dpr?: number): {
-    start: number;
-    end: number;
-};
-/**
- * 计算指定索引区间内的价格范围（max/min）。
- *
- * 主要用途：
- * - 为 pane 的 y 轴缩放与刻度提供 priceRange
- * - 为渲染器（网格线、极值标注等）提供可视区参考范围
- *
- * 注意：
- * - `endIndex` 为开区间（不包含）
- * - 若区间内无有效数据，会返回兜底范围 `{ maxPrice: 100, minPrice: 0 }`
- */
-export declare function getVisiblePriceRange(data: KLineData[], startIndex: number, endIndex: number): PriceRange;

package/dist/src/index.d.ts

@@ -1,8 +0,0 @@
-import { App } from 'vue';
-import { KLineChart } from './components';
-export * from './plugin';
-export { KLineChart };
-export type { KLineData } from './types/price';
-export declare const KMapPlugin: {
-    install(app: App): void;
-};

package/dist/src/plugin/ConfigManager.d.ts

@@ -1,31 +0,0 @@
-/**
- * 配置管理器
- */
-export declare class ConfigManager {
-    private configs;
-    private defaults;
-    /**
-     * 注册插件的默认配置
-     */
-    registerDefaults(pluginName: string, defaults: Record<string, unknown>): void;
-    /**
-     * 获取配置
-     */
-    get<K = unknown>(pluginName: string, key: string, defaultValue?: K): K;
-    /**
-     * 设置配置
-     */
-    set(pluginName: string, key: string, value: unknown): void;
-    /**
-     * 批量设置配置
-     */
-    setAll(pluginName: string, config: Record<string, unknown>): void;
-    /**
-     * 获取插件所有配置
-     */
-    getAll(pluginName: string): Record<string, unknown>;
-    /**
-     * 清除插件配置
-     */
-    clear(pluginName?: string): void;
-}

package/dist/src/plugin/EventBus.d.ts

@@ -1,34 +0,0 @@
-import { EventHandler } from './types';
-export declare class EventBus {
-    private listeners;
-    /**
-     * 订阅事件
-     */
-    on<T = unknown>(event: string, handler: EventHandler<T>): void;
-    /**
-     * 取消订阅
-     */
-    off<T = unknown>(event: string, handler: EventHandler<T>): void;
-    /**
-     * 发布事件
-     */
-    emit<T = unknown>(event: string, data: T): void;
-    /**
-     * 订阅一次性事件
-     *
-     * 注册一个仅在事件首次触发时执行的回调。回调执行后会自动从监听队列中移除，
-     * 确保后续相同事件的 emit 不会再触发该逻辑。
-     *
-     * @param event - 事件名称
-     * @param handler - 待执行的回调函数
-     */
-    once<T = unknown>(event: string, handler: EventHandler<T>): void;
-    /**
-     * 清除所有事件监听
-     */
-    clear(): void;
-    /**
-     * 获取事件的监听器数量
-     */
-    listenerCount(event: string): number;
-}

package/dist/src/plugin/HookSystem.d.ts

@@ -1,28 +0,0 @@
-import { HookCallOptions, HookFn } from './types';
-export declare class HookSystem {
-    private hooks;
-    /**
-     * 注册钩子
-     */
-    tap<T = unknown, R = unknown>(hookName: string, fn: HookFn<T, R>, priority?: number): void;
-    /**
-     * 移除钩子
-     */
-    untap(hookName: string, fn: HookFn): void;
-    /**
-     * 触发钩子（异步）
-     */
-    call<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): Promise<R[]>;
-    /**
-     * 触发钩子（同步）
-     */
-    callSync<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): R[];
-    /**
-     * 清除所有钩子
-     */
-    clear(): void;
-    /**
-     * 获取钩子数量
-     */
-    hookCount(hookName: string): number;
-}