@363045841yyt/klinechart 0.6.3 → 0.6.6

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

@@ -1,4 +1,4 @@
-import { RendererPluginWithHost, BaseIndicatorState } from '../../../plugin';
+import { RendererPluginWithHost } from '../../../plugin';
 import { KLineData } from '../../../types/price';
 export interface MACDConfig {
     /** 快线周期（默认 12） */
@@ -14,16 +14,6 @@ export interface MACDConfig {
     /** 是否显示 MACD 柱 */
     showBAR?: boolean;
 }
-/** MACD 渲染器状态（共享给刻度渲染器） */
-export interface MACDRenderState extends BaseIndicatorState {
-    valueMin: number;
-    valueMax: number;
-    latestValues?: {
-        dif: number;
-        dea: number;
-        macd: number;
-    };
-}
 export interface MACDRendererOptions {
     /** 目标 pane ID（默认 'sub'） */
     paneId?: string;
@@ -32,10 +22,12 @@ export interface MACDRendererOptions {
 }
 /**
  * 创建 MACD 渲染器插件
+ * 从 StateStore 读取 MACD 状态，不再内联计算
  */
 export declare function createMACDRendererPlugin(options?: MACDRendererOptions): RendererPluginWithHost;
 /**
  * 计算指定索引处的 MACD 值（供图例使用）
+ * 使用 calculators.ts 中的计算函数
  */
 export declare function calcMACDAtIndex(data: KLineData[], index: number, fastPeriod?: number, slowPeriod?: number, signalPeriod?: number): {
     dif: number;

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/Indicator/rsi.d.ts

@@ -1,4 +1,8 @@
 import { RendererPluginWithHost, PluginHost } from '../../../plugin';
+type LinePoint = {
+    x: number;
+    y: number;
+};
 export interface RSIRendererOptions {
     /** 目标 pane ID（默认 'sub'） */
     paneId?: string;
@@ -11,6 +15,11 @@ export declare function createRSIRendererPlugin(options?: RSIRendererOptions): R
  * 获取 RSI 标题信息（供 paneTitle 使用）
  * 从 StateStore 读取已计算的 RSI 数据
  */
+export declare function drawRSILinesWithCanvas2D(ctx: CanvasRenderingContext2D, scrollLeft: number, rsi1Points: LinePoint[], rsi2Points: LinePoint[], rsi3Points: LinePoint[], params: {
+    showRSI1: boolean;
+    showRSI2: boolean;
+    showRSI3: boolean;
+}): void;
 export declare function getRSITitleInfo(index: number, period1: number, period2: number, period3: number, pluginHost: PluginHost, paneId?: string): {
     name: string;
     params: number[];
@@ -20,3 +29,4 @@ export declare function getRSITitleInfo(index: number, period1: number, period2:
         color: string;
     }>;
 } | null;
+export {};

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

@@ -17,6 +17,8 @@ export declare class CandleWebGLSurface {
     private logicalWidth;
     private logicalHeight;
     private available;
+    private rectCapacity;
+    private rectScratch;
     constructor(canvas?: HTMLCanvasElement);
     isAvailable(): boolean;
     getCanvas(): HTMLCanvasElement;
@@ -33,6 +35,8 @@ export declare class LineWebGLSurface {
     private logicalHeight;
     private dpr;
     private available;
+    private vertexCapacity;
+    private geoCache;
     constructor(canvas?: HTMLCanvasElement);
     isAvailable(): boolean;
     getCanvas(): HTMLCanvasElement;

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/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.3",
+  "version": "0.6.6",
   "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",