@363045841yyt/klinechart 0.1.4 → 0.2.0

package/dist/core/renderers/Indicator/fastk.d.ts

@@ -0,0 +1,34 @@
+import { RendererPlugin } from '../../../plugin';
+import { KLineData } from '../../../types/price';
+export interface FASTKConfig {
+    /** 周期（默认 9） */
+    period?: number;
+    /** 是否显示 FASTK 线 */
+    showFASTK?: boolean;
+}
+export interface FASTKRendererOptions {
+    /** 目标 pane ID（默认 'sub'） */
+    paneId?: string;
+    /** 初始配置 */
+    config?: FASTKConfig;
+}
+/**
+ * 创建 FASTK 渲染器插件
+ */
+export declare function createFASTKRendererPlugin(options?: FASTKRendererOptions): RendererPlugin;
+/**
+ * 计算指定索引处的 FASTK 值
+ */
+export declare function calcFASTKAtIndex(data: KLineData[], index: number, period: number): number | undefined;
+/**
+ * 获取 FASTK 标题信息（供 paneTitle 使用）
+ */
+export declare function getFASTKTitleInfo(data: KLineData[], index: number, period?: number): {
+    name: string;
+    params: number[];
+    values: Array<{
+        label: string;
+        value: number;
+        color: string;
+    }>;
+} | null;

package/dist/core/renderers/Indicator/index.d.ts

@@ -0,0 +1,31 @@
+import { RendererPlugin } from '../../../plugin';
+export { createMARendererPlugin, type MAFlags } from './ma';
+export { createMALegendRendererPlugin } from './maLegend';
+export { createBOLLRendererPlugin, calcBOLLAtIndex, type BOLLConfig } from './boll';
+export { createBOLLLegendRendererPlugin, type BOLLLegendConfig } from './bollLegend';
+export { createMACDRendererPlugin, calcMACDAtIndex, type MACDConfig, type MACDRendererOptions, getMACDTitleInfo } from './macd';
+export { createMACDLegendRendererPlugin, type MACDLegendOptions } from './macdLegend';
+export { createRSIRendererPlugin, calcRSIAtIndex, type RSIConfig, type RSIRendererOptions, getRSITitleInfo } from './rsi';
+export { createCCIRendererPlugin, calcCCIAtIndex, type CCIConfig, type CCIRendererOptions, getCCITitleInfo } from './cci';
+export { createSTOCHRendererPlugin, calcSTOCHAtIndex, type STOCHConfig, type STOCHRendererOptions, getSTOCHTitleInfo } from './stoch';
+export { createMOMRendererPlugin, calcMOMAtIndex, type MOMConfig, type MOMRendererOptions, getMOMTitleInfo } from './mom';
+export { createWMSRRendererPlugin, calcWMSRAtIndex, type WMSRConfig, type WMSRRendererOptions, getWMSRTitleInfo } from './wmsr';
+export { createKSTRendererPlugin, calcKSTAtIndex, type KSTConfig, type KSTRendererOptions, getKSTTitleInfo } from './kst';
+export { createFASTKRendererPlugin, calcFASTKAtIndex, type FASTKConfig, type FASTKRendererOptions, getFASTKTitleInfo } from './fastk';
+/**
+ * 副图指标类型
+ */
+export type SubIndicatorType = 'VOLUME' | 'MACD' | 'RSI' | 'CCI' | 'STOCH' | 'MOM' | 'WMSR' | 'KST' | 'FASTK';
+/**
+ * 渲染器工厂选项
+ */
+export interface IndicatorRendererOptions {
+    /** 指标类型 */
+    indicatorId: SubIndicatorType;
+    /** 目标 pane ID */
+    paneId: string;
+}
+/**
+ * 创建副图指标渲染器（统一工厂函数）
+ */
+export declare function createSubIndicatorRenderer(options: IndicatorRendererOptions): RendererPlugin;

package/dist/core/renderers/Indicator/kst.d.ts

@@ -0,0 +1,49 @@
+import { RendererPlugin } from '../../../plugin';
+import { KLineData } from '../../../types/price';
+export interface KSTConfig {
+    /** ROC1 周期（默认 10） */
+    roc1?: number;
+    /** ROC2 周期（默认 15） */
+    roc2?: number;
+    /** ROC3 周期（默认 20） */
+    roc3?: number;
+    /** ROC4 周期（默认 30） */
+    roc4?: number;
+    /** 信号线周期（默认 9） */
+    signalPeriod?: number;
+    /** 是否显示 KST 线 */
+    showKST?: boolean;
+    /** 是否显示信号线 */
+    showSignal?: boolean;
+}
+interface KSTPoint {
+    kst: number;
+    signal: number;
+}
+export interface KSTRendererOptions {
+    /** 目标 pane ID（默认 'sub'） */
+    paneId?: string;
+    /** 初始配置 */
+    config?: KSTConfig;
+}
+/**
+ * 创建 KST 渲染器插件
+ */
+export declare function createKSTRendererPlugin(options?: KSTRendererOptions): RendererPlugin;
+/**
+ * 计算指定索引处的 KST 值
+ */
+export declare function calcKSTAtIndex(data: KLineData[], index: number, roc1: number, roc2: number, roc3: number, roc4: number, signalPeriod: number): KSTPoint | undefined;
+/**
+ * 获取 KST 标题信息（供 paneTitle 使用）
+ */
+export declare function getKSTTitleInfo(data: KLineData[], index: number, roc1?: number, roc2?: number, roc3?: number, roc4?: number, signalPeriod?: number): {
+    name: string;
+    params: number[];
+    values: Array<{
+        label: string;
+        value: number;
+        color: string;
+    }>;
+} | null;
+export {};

package/dist/core/renderers/Indicator/ma.d.ts

@@ -0,0 +1,12 @@
+import { RendererPlugin } from '../../../plugin';
+export type MAFlags = {
+    ma5?: boolean;
+    ma10?: boolean;
+    ma20?: boolean;
+    ma30?: boolean;
+    ma60?: boolean;
+};
+/**
+ * 创建 MA 均线渲染器插件
+ */
+export declare function createMARendererPlugin(showMA?: MAFlags): RendererPlugin;

package/dist/core/renderers/Indicator/maLegend.d.ts

@@ -0,0 +1,9 @@
+import { RendererPlugin } from '../../../plugin';
+import { MAFlags } from './ma';
+/**
+ * 创建 MA 图例渲染器插件
+ */
+export declare function createMALegendRendererPlugin(options: {
+    yPaddingPx: number;
+    showMA?: MAFlags;
+}): RendererPlugin;

package/dist/core/renderers/Indicator/macd.d.ts

@@ -0,0 +1,46 @@
+import { RendererPlugin } from '../../../plugin';
+import { KLineData } from '../../../types/price';
+export interface MACDConfig {
+    /** 快线周期（默认 12） */
+    fastPeriod?: number;
+    /** 慢线周期（默认 26） */
+    slowPeriod?: number;
+    /** DEA 周期（默认 9） */
+    signalPeriod?: number;
+    /** 是否显示 DIF 线 */
+    showDIF?: boolean;
+    /** 是否显示 DEA 线 */
+    showDEA?: boolean;
+    /** 是否显示 MACD 柱 */
+    showBAR?: boolean;
+}
+export interface MACDRendererOptions {
+    /** 目标 pane ID（默认 'sub'） */
+    paneId?: string;
+    /** 初始配置 */
+    config?: MACDConfig;
+}
+/**
+ * 创建 MACD 渲染器插件
+ */
+export declare function createMACDRendererPlugin(options?: MACDRendererOptions): RendererPlugin;
+/**
+ * 计算指定索引处的 MACD 值（供图例使用）
+ */
+export declare function calcMACDAtIndex(data: KLineData[], index: number, fastPeriod?: number, slowPeriod?: number, signalPeriod?: number): {
+    dif: number;
+    dea: number;
+    macd: number;
+} | null;
+/**
+ * 获取 MACD 标题信息（供 paneTitle 使用）
+ */
+export declare function getMACDTitleInfo(data: KLineData[], index: number, fastPeriod?: number, slowPeriod?: number, signalPeriod?: number): {
+    name: string;
+    params: number[];
+    values: Array<{
+        label: string;
+        value: number;
+        color: string;
+    }>;
+} | null;

package/dist/core/renderers/Indicator/macdLegend.d.ts

@@ -0,0 +1,10 @@
+import { RendererPlugin } from '../../../plugin';
+export interface MACDLegendOptions {
+    /** Y 轴内边距（与主图保持一致） */
+    yPaddingPx?: number;
+}
+/**
+ * 创建 MACD 图例渲染器插件
+ * 在副图左上角显示当前 MACD 指标值
+ */
+export declare function createMACDLegendRendererPlugin(options?: MACDLegendOptions): RendererPlugin;

package/dist/core/renderers/Indicator/mom.d.ts

@@ -0,0 +1,34 @@
+import { RendererPlugin } from '../../../plugin';
+import { KLineData } from '../../../types/price';
+export interface MOMConfig {
+    /** 周期（默认 10） */
+    period?: number;
+    /** 是否显示 MOM 线 */
+    showMOM?: boolean;
+}
+export interface MOMRendererOptions {
+    /** 目标 pane ID（默认 'sub'） */
+    paneId?: string;
+    /** 初始配置 */
+    config?: MOMConfig;
+}
+/**
+ * 创建 MOM 渲染器插件
+ */
+export declare function createMOMRendererPlugin(options?: MOMRendererOptions): RendererPlugin;
+/**
+ * 计算指定索引处的 MOM 值
+ */
+export declare function calcMOMAtIndex(data: KLineData[], index: number, period: number): number | undefined;
+/**
+ * 获取 MOM 标题信息（供 paneTitle 使用）
+ */
+export declare function getMOMTitleInfo(data: KLineData[], index: number, period?: number): {
+    name: string;
+    params: number[];
+    values: Array<{
+        label: string;
+        value: number;
+        color: string;
+    }>;
+} | null;

package/dist/core/renderers/Indicator/rsi.d.ts

@@ -0,0 +1,42 @@
+import { RendererPlugin } from '../../../plugin';
+import { KLineData } from '../../../types/price';
+export interface RSIConfig {
+    /** 第一条 RSI 周期（默认 6） */
+    period1?: number;
+    /** 第二条 RSI 周期（默认 12） */
+    period2?: number;
+    /** 第三条 RSI 周期（默认 24） */
+    period3?: number;
+    /** 是否显示 RSI1 */
+    showRSI1?: boolean;
+    /** 是否显示 RSI2 */
+    showRSI2?: boolean;
+    /** 是否显示 RSI3 */
+    showRSI3?: boolean;
+}
+export interface RSIRendererOptions {
+    /** 目标 pane ID（默认 'sub'） */
+    paneId?: string;
+    /** 初始配置 */
+    config?: RSIConfig;
+}
+/**
+ * 创建 RSI 渲染器插件
+ */
+export declare function createRSIRendererPlugin(options?: RSIRendererOptions): RendererPlugin;
+/**
+ * 计算指定索引处的 RSI 值
+ */
+export declare function calcRSIAtIndex(data: KLineData[], index: number, period: number): number | undefined;
+/**
+ * 获取 RSI 标题信息（供 paneTitle 使用）
+ */
+export declare function getRSITitleInfo(data: KLineData[], index: number, period1?: number, period2?: number, period3?: number): {
+    name: string;
+    params: number[];
+    values: Array<{
+        label: string;
+        value: number;
+        color: string;
+    }>;
+} | null;

package/dist/core/renderers/Indicator/stoch.d.ts

@@ -0,0 +1,43 @@
+import { RendererPlugin } from '../../../plugin';
+import { KLineData } from '../../../types/price';
+export interface STOCHConfig {
+    /** K 周期（默认 9） */
+    n?: number;
+    /** D 周期（默认 3） */
+    m?: number;
+    /** 是否显示 K 线 */
+    showK?: boolean;
+    /** 是否显示 D 线 */
+    showD?: boolean;
+}
+interface STOCHPoint {
+    k: number;
+    d: number;
+}
+export interface STOCHRendererOptions {
+    /** 目标 pane ID（默认 'sub'） */
+    paneId?: string;
+    /** 初始配置 */
+    config?: STOCHConfig;
+}
+/**
+ * 创建 STOCH 渲染器插件
+ */
+export declare function createSTOCHRendererPlugin(options?: STOCHRendererOptions): RendererPlugin;
+/**
+ * 计算指定索引处的 STOCH 值
+ */
+export declare function calcSTOCHAtIndex(data: KLineData[], index: number, n: number, m: number): STOCHPoint | undefined;
+/**
+ * 获取 STOCH 标题信息（供 paneTitle 使用）
+ */
+export declare function getSTOCHTitleInfo(data: KLineData[], index: number, n?: number, m?: number): {
+    name: string;
+    params: number[];
+    values: Array<{
+        label: string;
+        value: number;
+        color: string;
+    }>;
+} | null;
+export {};

package/dist/core/renderers/Indicator/wmsr.d.ts

@@ -0,0 +1,34 @@
+import { RendererPlugin } from '../../../plugin';
+import { KLineData } from '../../../types/price';
+export interface WMSRConfig {
+    /** 周期（默认 14） */
+    period?: number;
+    /** 是否显示 WMSR 线 */
+    showWMSR?: boolean;
+}
+export interface WMSRRendererOptions {
+    /** 目标 pane ID（默认 'sub'） */
+    paneId?: string;
+    /** 初始配置 */
+    config?: WMSRConfig;
+}
+/**
+ * 创建 WMSR 渲染器插件
+ */
+export declare function createWMSRRendererPlugin(options?: WMSRRendererOptions): RendererPlugin;
+/**
+ * 计算指定索引处的 WMSR 值
+ */
+export declare function calcWMSRAtIndex(data: KLineData[], index: number, period: number): number | undefined;
+/**
+ * 获取 WMSR 标题信息（供 paneTitle 使用）
+ */
+export declare function getWMSRTitleInfo(data: KLineData[], index: number, period?: number): {
+    name: string;
+    params: number[];
+    values: Array<{
+        label: string;
+        value: number;
+        color: string;
+    }>;
+} | null;

package/dist/core/renderers/candle.d.ts

@@ -1,6 +1,19 @@
-import { PaneRenderer } from '../layout/pane';
+import { RendererPlugin } from '../../plugin';
+import { VolumePriceRelation } from '../../types/volumePrice';
+import { MarkerManager } from '../marker/registry';
 /**
- * Candle 渲染器：在单个 pane 中绘制 K 线蜡烛图
- * 依赖 pane.yAxis 做 price->y 坐标映射，使用物理像素空间计算避免浮点误差
+ * 创建 K 线蜡烛图渲染器插件
  */
-export declare const CandleRenderer: PaneRenderer;
+export declare function createCandleRenderer(): RendererPlugin;
+/**
+* 绘制量价关系标记
+* 在K线图上标注量价关系标记符号
+*
+* @param ctx - Canvas绘图上下文
+* @param x - 标记的x坐标（三角形水平中心）
+* @param y - 标记的y坐标（三角形底边/顶点与K线的接触点）
+* @param relation - 量价关系类型
+* @param kWidth - K线宽度，作为三角形边长
+* @param gap - 三角形与K线的间距，默认为4
+*/
+export declare function drawVolumePriceMarker(ctx: CanvasRenderingContext2D, x: number, y: number, relation: VolumePriceRelation, kIndex: number, kWidth: number, gap: number | undefined, markerManager: MarkerManager): void;

package/dist/core/renderers/crosshair.d.ts

@@ -1,22 +1,15 @@
+import { RendererPlugin } from '../../plugin';
 /**
- * 绘制十字线
- * ctx 处于 plotCanvas 的屏幕坐标（不带 translate(-scrollLeft,0)），x/y 是相对 plot 区域左上角的坐标
- * @param ctx Canvas 绘图上下文
- * @param plotWidth 绘图区宽度
- * @param plotHeight 绘图区高度
- * @param dpr 设备像素比
- * @param x 十字线横坐标
- * @param y 十字线纵坐标
- * @param drawVertical 是否绘制垂直线
- * @param drawHorizontal 是否绘制水平线
+ * 创建十字线渲染器插件
+ * 垂直线绘制到所有面板，水平线只绘制到活跃面板
  */
-export declare function drawCrosshair(args: {
-    ctx: CanvasRenderingContext2D;
-    plotWidth: number;
-    plotHeight: number;
-    dpr: number;
-    x: number;
-    y: number;
-    drawVertical?: boolean;
-    drawHorizontal?: boolean;
-}): void;
+export declare function createCrosshairRendererPlugin(options: {
+    getCrosshairState: () => {
+        pos: {
+            x: number;
+            y: number;
+        } | null;
+        activePaneId: string | null;
+        isDragging: boolean;
+    };
+}): RendererPlugin;

package/dist/core/renderers/customMarkers.d.ts

@@ -0,0 +1,6 @@
+import { RendererPlugin } from '../../plugin';
+/**
+ * 创建自定义标记渲染器插件
+ * 负责渲染 semanticConfig 中配置的 customMarkers
+ */
+export declare function createCustomMarkersRenderer(): RendererPlugin;

package/dist/core/renderers/extremaMarkers.d.ts

@@ -1,6 +1,5 @@
-import { PaneRenderer } from '../layout/pane';
+import { RendererPlugin } from '../../plugin';
 /**
- * 可视区最高/最低价标注渲染器（仅绘制标注，不绘制蜡烛）
- * 使用 pane.yAxis.priceToY 作为 Y 映射（与当前 pane 的 priceRange 一致），world 坐标绘制（会 translate(-scrollLeft, 0)）
+ * 创建可视区最高/最低价标注渲染器插件
  */
-export declare const ExtremaMarkersRenderer: PaneRenderer;
+export declare function createExtremaMarkersRendererPlugin(): RendererPlugin;

package/dist/core/renderers/globalBorders.d.ts

@@ -1,18 +1,13 @@
+import { RendererPlugin } from '../../plugin';
+/** 全局边框面板 ID（特殊标识，用于最后渲染） */
+export declare const GLOBAL_BORDERS_PANE_ID: unique symbol;
 /**
- * 绘制所有 pane 的外边框
- * @param ctx Canvas 绘图上下文
- * @param dpr 设备像素比
- * @param plotWidth 绘图区宽度
- * @param panes pane 数组，每个包含 top 和 height 属性
- * @param color 边框颜色
+ * 创建全局边框渲染器插件
+ * 绘制所有面板的外边框
  */
-export declare function drawAllPanesBorders(args: {
-    ctx: CanvasRenderingContext2D;
-    dpr: number;
-    plotWidth: number;
-    panes: Array<{
+export declare function createGlobalBordersRendererPlugin(options: {
+    getPaneInfos: () => Array<{
         top: number;
         height: number;
     }>;
-    color?: string;
-}): void;
+}): RendererPlugin;

package/dist/core/renderers/gridLines.d.ts

@@ -1,6 +1,7 @@
-import { PaneRenderer } from '../layout/pane';
+import { RendererPlugin } from '../../plugin';
 /**
- * 网格线渲染器（不绘制文字刻度）
+ * 创建网格线渲染器插件
  * 横向按像素均分铺满整个绘图区高度，纵向按月分割（使用预计算的月边界，网格线对齐到K线实体中部）
+ * 渲染到所有 pane（使用 GLOBAL_PANE_ID）
  */
-export declare const GridLinesRenderer: PaneRenderer;
+export declare function createGridLinesRendererPlugin(): RendererPlugin;

package/dist/core/renderers/lastPrice.d.ts

@@ -1,5 +1,5 @@
-import { PaneRenderer } from '../layout/pane';
+import { RendererPlugin } from '../../plugin';
 /**
- * 最新价虚线渲染器，绘制在 plotCanvas 的 world 坐标系（需 translate(-scrollLeft,0)）
+ * 创建最新价虚线渲染器插件
  */
-export declare const LastPriceLineRenderer: PaneRenderer;
+export declare function createLastPriceLineRendererPlugin(): RendererPlugin;

package/dist/core/renderers/paneTitle.d.ts

@@ -1,13 +1,40 @@
+import { RendererPlugin } from '../../plugin';
 /**
- * 绘制 pane 标题
- * @param ctx Canvas 上下文
- * @param dpr 设备像素比
- * @param paneTop pane 顶部偏移
- * @param title 标题文本
+ * 单个数值项
  */
-export declare function drawPaneTitle(args: {
-    ctx: CanvasRenderingContext2D;
-    dpr: number;
-    paneTop: number;
+export interface TitleValueItem {
+    /** 标签（如 "DIF"、"DEA"） */
+    label: string;
+    /** 数值 */
+    value: number;
+    /** 颜色 */
+    color: string;
+}
+/**
+ * 标题信息（由指标渲染器提供）
+ */
+export interface TitleInfo {
+    /** 指标名称（如 "MACD"） */
+    name: string;
+    /** 参数列表（如 [12, 26, 9]） */
+    params?: number[];
+    /** 数值项列表 */
+    values?: TitleValueItem[];
+}
+export interface PaneTitleOptions {
+    /** 面板 ID */
+    paneId: string;
+    /** 标题文本（静态模式） */
     title: string;
-}): void;
+    /** 副标题/描述 */
+    description?: string;
+    /** Y 偏移（逻辑像素） */
+    yOffset?: number;
+    /** 动态标题信息提供函数 */
+    getTitleInfo?: () => TitleInfo | null;
+}
+/**
+ * 创建面板标题渲染器插件
+ * 在面板左上角显示标题，支持动态指标数值显示
+ */
+export declare function createPaneTitleRendererPlugin(options: PaneTitleOptions): RendererPlugin;

package/dist/core/renderers/subVolume.d.ts

@@ -1,5 +1,9 @@
-import { PaneRenderer } from '../layout/pane';
+import { RendererPlugin } from '../../plugin';
+export interface VolumeRendererOptions {
+    /** 目标 pane ID（默认 'sub'） */
+    paneId?: string;
+}
 /**
- * 副图成交量渲染器
+ * 创建副图成交量渲染器插件
  */
-export declare const subVolumeRenderer: PaneRenderer;
+export declare function createVolumeRendererPlugin(options?: VolumeRendererOptions): RendererPlugin;

package/dist/core/renderers/timeAxis.d.ts

@@ -1,27 +1,14 @@
-import { KLineData } from '../../types/price';
+import { RendererPlugin } from '../../plugin';
+/** 时间轴面板 ID（特殊标识，用于单独渲染） */
+export declare const TIME_AXIS_PANE_ID: unique symbol;
 /**
- * 绘制时间轴层
- * @param ctx Canvas 绘图上下文
- * @param data K 线数据
- * @param scrollLeft 滚动偏移量
- * @param kWidth K 线宽度
- * @param kGap K 线间隔
- * @param startIndex 起始索引
- * @param endIndex 结束索引
- * @param dpr 设备像素比
- * @param crosshair 十字线信息，包含横坐标和索引
+ * 创建时间轴渲染器插件
+ * 注意：时间轴渲染到 xAxisCanvas，需要特殊处理
  */
-export declare function drawTimeAxisLayer(args: {
-    ctx: CanvasRenderingContext2D;
-    data: KLineData[];
-    scrollLeft: number;
-    kWidth: number;
-    kGap: number;
-    startIndex: number;
-    endIndex: number;
-    dpr: number;
-    crosshair?: {
+export declare function createTimeAxisRendererPlugin(options: {
+    height: number;
+    getCrosshair?: () => {
         x: number;
         index: number;
     } | null;
-}): void;
+}): RendererPlugin;

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

@@ -1,16 +1,9 @@
-import { PaneRenderer } from '../layout/pane';
+import { RendererPlugin } from '../../plugin';
 /**
- * 创建 Y 轴渲染器，每个 pane 各画一段，复用 drawPriceAxis
- * @param opts 配置选项
- * @param opts.axisX 轴的横坐标
- * @param opts.axisWidth 轴宽度
- * @param opts.yPaddingPx 垂直内边距
- * @param opts.ticks 刻度数量（可选，默认根据 pane 高度自动计算）
- * @returns PaneRenderer 实例
+ * 创建 Y 轴渲染器插件
+ * 渲染到所有面板的 Y 轴区域
  */
-export declare function createYAxisRenderer(opts: {
-    axisX: number;
+export declare function createYAxisRendererPlugin(options: {
     axisWidth: number;
     yPaddingPx: number;
-    ticks?: number;
-}): PaneRenderer;
+}): RendererPlugin;

package/dist/core/scale/priceScale.d.ts

@@ -15,4 +15,5 @@ export declare class PriceScale {
     getPaddingTop(): number;
     getPaddingBottom(): number;
     priceToY(price: number): number;
+    yToPrice(y: number): number;
 }