@363045841yyt/klinechart 0.6.5 → 0.6.8

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

@@ -0,0 +1,189 @@
+import { KLineData } from '../../types/price';
+import { MAFlags, BOLLPoint, EXPMAPoint, ENEPoint, STOCHPoint, KSTPoint, MACDPoint } from './calculators';
+export interface BOLLSchedulerConfig {
+    period: number;
+    multiplier: number;
+    showUpper: boolean;
+    showMiddle: boolean;
+    showLower: boolean;
+    showBand: boolean;
+}
+export interface EXPMASchedulerConfig {
+    fastPeriod: number;
+    slowPeriod: number;
+}
+export interface ENESchedulerConfig {
+    period: number;
+    deviation: number;
+}
+export interface RSISchedulerConfig {
+    period1: number;
+    period2: number;
+    period3: number;
+    showRSI1: boolean;
+    showRSI2: boolean;
+    showRSI3: boolean;
+}
+export interface CCISchedulerConfig {
+    period: number;
+    showCCI: boolean;
+}
+export interface STOCHSchedulerConfig {
+    n: number;
+    m: number;
+    showK: boolean;
+    showD: boolean;
+}
+export interface MOMSchedulerConfig {
+    period: number;
+    showMOM: boolean;
+}
+export interface WMSRSchedulerConfig {
+    period: number;
+    showWMSR: boolean;
+}
+export interface KSTSchedulerConfig {
+    roc1: number;
+    roc2: number;
+    roc3: number;
+    roc4: number;
+    signalPeriod: number;
+    showKST: boolean;
+    showSignal: boolean;
+}
+export interface FASTKSchedulerConfig {
+    period: number;
+    showFASTK: boolean;
+}
+export interface MACDSchedulerConfig {
+    fastPeriod: number;
+    slowPeriod: number;
+    signalPeriod: number;
+    showDIF: boolean;
+    showDEA: boolean;
+    showBAR: boolean;
+}
+export interface InitRequest {
+    type: 'init';
+    protocolVersion: number;
+}
+export interface SetDataRequest {
+    type: 'setData';
+    dataVersion: number;
+    format: 'aos' | 'soa';
+    data: KLineData[];
+}
+export interface SetConfigRequest {
+    type: 'setConfig';
+    configVersion: number;
+    configs: IndicatorConfigSnapshot;
+}
+export interface ComputeSeriesRequest {
+    type: 'computeSeries';
+    requestId: number;
+    dataVersion: number;
+    configVersion: number;
+}
+export interface DisposeRequest {
+    type: 'dispose';
+}
+export type IndicatorWorkerRequest = InitRequest | SetDataRequest | SetConfigRequest | ComputeSeriesRequest | DisposeRequest;
+export interface ReadyResponse {
+    type: 'ready';
+    protocolVersion: number;
+}
+export interface SeriesResultResponse {
+    type: 'seriesResult';
+    requestId: number;
+    dataVersion: number;
+    configVersion: number;
+    results: IndicatorSeriesBundle;
+    metrics?: {
+        computeMs: number;
+        dataLength: number;
+    };
+}
+export interface ErrorResponse {
+    type: 'error';
+    requestId?: number;
+    stage: 'init' | 'setData' | 'setConfig' | 'computeSeries';
+    message: string;
+}
+export type IndicatorWorkerResponse = ReadyResponse | SeriesResultResponse | ErrorResponse;
+export interface IndicatorConfigSnapshot {
+    ma: MAFlags;
+    boll: BOLLSchedulerConfig;
+    expma: EXPMASchedulerConfig;
+    ene: ENESchedulerConfig;
+    rsi: RSISchedulerConfig;
+    cci: CCISchedulerConfig;
+    stoch: STOCHSchedulerConfig;
+    mom: MOMSchedulerConfig;
+    wmsr: WMSRSchedulerConfig;
+    kst: KSTSchedulerConfig;
+    fastk: FASTKSchedulerConfig;
+    macd: MACDSchedulerConfig;
+    rsiPaneId: string;
+    cciPaneId: string;
+    stochPaneId: string;
+    momPaneId: string;
+    wmsrPaneId: string;
+    kstPaneId: string;
+    fastkPaneId: string;
+    macdPaneId: string;
+}
+export interface IndicatorSeriesBundle {
+    ma: {
+        series: Record<number, (number | undefined)[]>;
+        enabledPeriods: number[];
+    };
+    boll: {
+        series: BOLLPoint[];
+        params: BOLLSchedulerConfig;
+    };
+    expma: {
+        series: EXPMAPoint[];
+        params: EXPMASchedulerConfig;
+    };
+    ene: {
+        series: ENEPoint[];
+        params: ENESchedulerConfig;
+    };
+    rsi: {
+        series: Record<number, (number | undefined)[]>;
+        enabledPeriods: number[];
+        params: RSISchedulerConfig;
+    };
+    cci: {
+        series: (number | undefined)[];
+        params: CCISchedulerConfig;
+    };
+    stoch: {
+        series: STOCHPoint[];
+        params: STOCHSchedulerConfig;
+    };
+    mom: {
+        series: (number | undefined)[];
+        params: MOMSchedulerConfig;
+    };
+    wmsr: {
+        series: (number | undefined)[];
+        params: WMSRSchedulerConfig;
+    };
+    kst: {
+        series: KSTPoint[];
+        params: KSTSchedulerConfig;
+    };
+    fastk: {
+        series: (number | undefined)[];
+        params: FASTKSchedulerConfig;
+    };
+    macd: {
+        series: MACDPoint[];
+        params: MACDSchedulerConfig;
+    };
+    /** 本次计算中实际变更的指标列表 */
+    _changed: string[];
+}
+export declare const PROTOCOL_VERSION = 1;
+export declare function isWorkerResponse(msg: unknown): msg is IndicatorWorkerResponse;

package/dist/src/core/renderers/Indicator/ene.d.ts

@@ -1,6 +1,5 @@
 import { RendererPluginWithHost } from '../../../plugin';
-/**
- * 创建 ENE（轨道线）渲染器插件（无状态版本）
+/** 创建 ENE（轨道线）渲染器插件（无状态版本）
  *
  * 设计原则：
  * 1. 不持有任何计算缓存或配置状态

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

@@ -1,4 +1,4 @@
-import { RendererPluginWithHost } from '../../../plugin';
+import { RendererPluginWithHost, PluginHost } from '../../../plugin';
 import { KLineData } from '../../../types/price';
 export interface MACDConfig {
     /** 快线周期（默认 12） */
@@ -36,8 +36,9 @@ export declare function calcMACDAtIndex(data: KLineData[], index: number, fastPe
 } | null;
 /**
  * 获取 MACD 标题信息（供 paneTitle 使用）
+ * 从 pluginHost 获取已计算好的数据，避免重复计算
  */
-export declare function getMACDTitleInfo(data: KLineData[], index: number, fastPeriod?: number, slowPeriod?: number, signalPeriod?: number): {
+export declare function getMACDTitleInfo(index: number, fastPeriod: number, slowPeriod: number, signalPeriod: number, pluginHost: PluginHost, paneId?: string): {
     name: string;
     params: number[];
     values: Array<{

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

@@ -1,10 +1,12 @@
-import { RendererPlugin } from '../../../plugin';
+import { RendererPluginWithHost } from '../../../plugin';
 export interface MACDLegendOptions {
     /** Y 轴内边距（与主图保持一致） */
     yPaddingPx?: number;
+    /** 目标 pane ID（默认 'sub'） */
+    paneId?: string;
 }
 /**
  * 创建 MACD 图例渲染器插件
- * 在副图左上角显示当前 MACD 指标值
+ * 从 StateStore 读取 MACD 状态，不再在 draw 时计算
  */
-export declare function createMACDLegendRendererPlugin(options?: MACDLegendOptions): RendererPlugin;
+export declare function createMACDLegendRendererPlugin(options?: MACDLegendOptions): RendererPluginWithHost;

package/dist/src/core/renderers/webgl/candleSurface.d.ts

@@ -11,6 +11,19 @@ type LineStrip = {
     }>;
     width: number;
 };
+type ColoredLineStrip = LineStrip & {
+    color: string;
+};
+type FilledBand = {
+    upperPoints: Array<{
+        x: number;
+        y: number;
+    }>;
+    lowerPoints: Array<{
+        x: number;
+        y: number;
+    }>;
+};
 export declare class CandleWebGLSurface {
     private canvas;
     private handles;
@@ -36,12 +49,18 @@ export declare class LineWebGLSurface {
     private dpr;
     private available;
     private vertexCapacity;
+    private fillScratch;
+    private geoCache;
     constructor(canvas?: HTMLCanvasElement);
     isAvailable(): boolean;
     getCanvas(): HTMLCanvasElement;
     resize(width: number, height: number, dpr: number): void;
     clear(): void;
     drawLineStrip(line: LineStrip, color: string, scrollLeft: number): boolean;
+    drawLineStrips(lines: ColoredLineStrip[], scrollLeft: number): boolean;
+    private getThinLineVertices;
+    private getLineGeometry;
+    drawFilledBand(band: FilledBand, color: string, scrollLeft: number): boolean;
     destroy(): void;
     private initLineHandles;
 }

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

@@ -16,8 +16,8 @@ export interface ZoomResult {
 }
 /** 将缩放级别转换为 K 线宽度（逻辑像素） */
 export declare function zoomLevelToKWidth(level: number, config: ZoomConfig): number;
-/** 由 DPR 推导 K 线间隙（逻辑像素） */
-export declare function kGapFromDpr(dpr: number): number;
+/** 根据K线宽度和DPR推导间隙（逻辑像素），K线越窄间距越小 */
+export declare function kGapFromKWidth(kWidth: number, dpr: number): number;
 /**
  * 缩放一级（+1 放大 / -1 缩小）
  * 返回新状态或 null（已达边界）

package/dist/src/debug/canvasProfiler.d.ts

@@ -17,5 +17,11 @@ declare global {
         resetCanvasReport?: () => void;
     }
 }
+/** 启用/禁用 Canvas Profiler */
+export declare function setCanvasProfilerEnabled(enabled: boolean): void;
+/** 获取 Canvas Profiler 启用状态 */
+export declare function isCanvasProfilerEnabled(): boolean;
 export declare function installCanvasProfiler(): void;
+/** 卸载 Canvas Profiler，恢复原始方法 */
+export declare function uninstallCanvasProfiler(): void;
 export {};

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

@@ -51,7 +51,15 @@ export declare function formatMonthOrYear(timestamp: number): {
  * @example
  * monthKey(1736793600000) // "2025-1"
  */
-export declare function monthKey(timestamp: number): string;
+/**
+ * 生成月份键值用于比较
+ * 返回数字 year * 12 + month，比字符串比较更快且无分配
+ * 使用 new Date 保证本地时区正确（与显示一致）
+ *
+ * @example
+ * monthKey(1736793600000) // 24301 (2025*12 + 0)
+ */
+export declare function monthKey(timestamp: number): number;
 /**
  * formatDateToYYYYMMDD 的别名，保持与历史代码的兼容性
  * timestamp 是"上海时区当天 00:00:00"映射到 UTC 的值；显示时强制按上海时区格式化
@@ -68,13 +76,7 @@ export declare const formatShanghaiDate: typeof formatDateToYYYYMMDD;
 export declare const formatYMDShanghai: typeof formatDateToYYYYMMDD;
 /**
  * 查找每个月份第一个K线的索引
- * @param data - K线数据数组（按时间升序排列）
- * @returns 月边界索引数组，例如 [0, 30, 60] 表示第0、30、60个K线分别是每月的第一个交易日
- *
- * @example
- * // 假设数据：[1/2, 1/3, 2/1, 2/2, 3/1, 3/2]
- * findMonthBoundaries(data) // [0, 2, 4]
- * // 解释：第0个K线是1月第一个，第2个K线是2月第一个，第4个K线是3月第一个
+ * 结果按数据引用缓存，同一份数据多次调用直接返回缓存
  */
 export declare function findMonthBoundaries(data: Array<{
     timestamp: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@363045841yyt/klinechart",
-  "version": "0.6.5",
+  "version": "0.6.8",
   "description": "A lightweight financial K-line charting library with first-class AI Agent support, crisp ResizeObserver-driven rendering, and plugin-based architecture. Focused on quantitative trading scenarios with TradingView-level interaction experience.",
   "author": "363045841 <slslswbsy@qq.com>",
   "license": "MIT",
@@ -12,6 +12,16 @@
   "homepage": "https://363045841.github.io/KLineChartQuant/",
   "keywords": [
     "kline-chart",
+    "plugin-architecture",
+    "webgl",
+    "high-performance",
+    "ai",
+    "crisp-rendering",
+    "sharp-rendering",
+    "agent",
+    "ai-chart",
+    "modern-ui",
+    "device-pixel-ratio",
     "candlestick-chart",
     "financial-chart",
     "tradingview",
@@ -23,19 +33,11 @@
     "chart-drawing",
     "trend-line",
     "fibonacci",
-    "high-performance",
     "pixel-perfect",
-    "crisp-rendering",
-    "sharp-rendering",
-    "device-pixel-ratio",
     "responsive",
-    "modern-ui",
-    "agent",
-    "ai-chart",
     "visualization",
     "quantitative-trading",
     "technical-analysis",
-    "plugin-architecture",
     "typescript"
   ],
   "type": "module",