@363045841yyt/klinechart 0.5.6 → 0.6.1

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

@@ -1,41 +1,17 @@
-import { RendererPluginWithHost, BaseIndicatorState } 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 RSIRenderState extends BaseIndicatorState {
-    valueMin: number;
-    valueMax: number;
-}
+import { RendererPluginWithHost, PluginHost } from '../../../plugin';
 export interface RSIRendererOptions {
     /** 目标 pane ID（默认 'sub'） */
     paneId?: string;
-    /** 初始配置 */
-    config?: RSIConfig;
 }
 /**
  * 创建 RSI 渲染器插件
  */
 export declare function createRSIRendererPlugin(options?: RSIRendererOptions): RendererPluginWithHost;
-/**
- * 计算指定索引处的 RSI 值
- */
-export declare function calcRSIAtIndex(data: KLineData[], index: number, period: number): number | undefined;
 /**
  * 获取 RSI 标题信息（供 paneTitle 使用）
+ * 从 StateStore 读取已计算的 RSI 数据
  */
-export declare function getRSITitleInfo(data: KLineData[], index: number, period1?: number, period2?: number, period3?: number): {
+export declare function getRSITitleInfo(index: number, period1: number, period2: number, period3: number, pluginHost: PluginHost, paneId?: string): {
     name: string;
     params: number[];
     values: Array<{

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

@@ -1,41 +1,16 @@
-import { RendererPluginWithHost, BaseIndicatorState } 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 STOCHRenderState extends BaseIndicatorState {
-    valueMin: number;
-    valueMax: number;
-}
+import { RendererPluginWithHost, PluginHost } from '../../../plugin';
 export interface STOCHRendererOptions {
     /** 目标 pane ID（默认 'sub'） */
     paneId?: string;
-    /** 初始配置 */
-    config?: STOCHConfig;
 }
 /**
  * 创建 STOCH 渲染器插件
  */
 export declare function createSTOCHRendererPlugin(options?: STOCHRendererOptions): RendererPluginWithHost;
-/**
- * 计算指定索引处的 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): {
+export declare function getSTOCHTitleInfo(index: number, n: number, m: number, pluginHost: PluginHost, paneId?: string): {
     name: string;
     params: number[];
     values: Array<{
@@ -44,4 +19,3 @@ export declare function getSTOCHTitleInfo(data: KLineData[], index: number, n?:
         color: string;
     }>;
 } | null;
-export {};

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

@@ -1,33 +1,16 @@
-import { RendererPluginWithHost, BaseIndicatorState } from '../../../plugin';
-import { KLineData } from '../../../types/price';
-export interface WMSRConfig {
-    /** 周期（默认 14） */
-    period?: number;
-    /** 是否显示 WMSR 线 */
-    showWMSR?: boolean;
-}
-export interface WMSRRenderState extends BaseIndicatorState {
-    valueMin: number;
-    valueMax: number;
-}
+import { RendererPluginWithHost, PluginHost } from '../../../plugin';
 export interface WMSRRendererOptions {
     /** 目标 pane ID（默认 'sub'） */
     paneId?: string;
-    /** 初始配置 */
-    config?: WMSRConfig;
 }
 /**
  * 创建 WMSR 渲染器插件
  */
 export declare function createWMSRRendererPlugin(options?: WMSRRendererOptions): RendererPluginWithHost;
-/**
- * 计算指定索引处的 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): {
+export declare function getWMSRTitleInfo(index: number, period: number, pluginHost: PluginHost, paneId?: string): {
     name: string;
     params: number[];
     values: Array<{

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

@@ -9,3 +9,4 @@ export declare const FONT_FAMILY = "\"Trebuchet MS\", Roboto, Ubuntu, sans-serif
 export declare function getFont(size: number, options?: {
     bold?: boolean;
 }): string;
+export declare function setCanvasFont(ctx: CanvasRenderingContext2D, font: string): void;

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

@@ -0,0 +1,21 @@
+type MetricEntry = {
+    count: number;
+    totalTime: number;
+};
+type MetricBucket = Record<string, MetricEntry>;
+type CanvasProfilerMetrics = {
+    ctxMethods: MetricBucket;
+    ctxProps: MetricBucket;
+    canvasProps: MetricBucket;
+    ctxMethodSources: Record<string, MetricBucket>;
+};
+declare global {
+    interface Window {
+        __KMAP_CANVAS_PROFILER_INSTALLED__?: boolean;
+        __KMAP_CANVAS_PROFILER_METRICS__?: CanvasProfilerMetrics;
+        showCanvasReport?: () => void;
+        resetCanvasReport?: () => void;
+    }
+}
+export declare function installCanvasProfiler(): void;
+export {};

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

@@ -1,4 +1,5 @@
 import { RendererPlugin, RenderContext, PaneInfo, RendererPluginWithHost, PluginHost } from './types';
+import { UpdateLevel } from '../core/layout/pane';
 /** 渲染器错误事件（裁剪后，不含大数据） */
 export interface RendererErrorEvent {
     name: string;
@@ -55,8 +56,8 @@ export declare class RendererPluginManager {
     private getMergedRenderers;
     /** 获取指定 pane 的渲染器（已缓存，无穿透） */
     getRenderers(paneId: string): RendererPlugin[];
-    /** 渲染指定 pane（带错误隔离） */
-    render(paneId: string, context: RenderContext): RendererErrorEvent[];
+    /** 渲染指定 pane（带错误隔离，支持按 UpdateLevel 过滤） */
+    render(paneId: string, context: RenderContext, level?: UpdateLevel): RendererErrorEvent[];
     /** 渲染指定名称的插件（带错误隔离，用于系统渲染器） */
     renderPlugin(name: string, context: RenderContext): RendererErrorEvent[];
     /** 启用/禁用渲染器（修改独立状态，不影响原始插件对象） */

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

@@ -226,6 +226,8 @@ export interface RenderContext {
     yAxisCtx?: CanvasRenderingContext2D;
     xAxisCtx?: CanvasRenderingContext2D;
     borderCtx?: CanvasRenderingContext2D;
+    /** 覆盖层 Canvas 上下文（用于十字线、Tooltip 等动态内容） */
+    overlayCtx?: CanvasRenderingContext2D;
     /** 当前缩放级别（1 ~ zoomLevels） */
     zoomLevel?: number;
     /** 总缩放级别数 */
@@ -396,6 +398,13 @@ export interface RendererPlugin {
      * 用于时间轴、全局边框等需要单独控制渲染时机的场景
      */
     isSystem?: boolean;
+    /**
+     * 渲染器所属层，决定 UpdateLevel 过滤行为
+     * - 'main': 低频/静态内容，随主画布一起渲染
+     * - 'overlay': 高频/动态内容，可在 overlay-only 更新时独立重绘
+     * 未指定时默认为 'main'（向后兼容）
+     */
+    layer?: 'main' | 'overlay';
     /** 渲染方法 */
     draw(context: RenderContext): void;
     /** 数据更新时回调 */

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

@@ -113,15 +113,7 @@ export interface CrosshairTimeLabelOptions {
     paddingX?: number;
     paddingY?: number;
 }
-/**
- * 在底部时间轴上绘制"十字线日期标签"
- * 说明：该函数假设时间轴背景/刻度已绘制完（即 drawTimeAxis 之后调用）。
- */
 export declare function drawCrosshairTimeLabel(ctx: CanvasRenderingContext2D, opts: CrosshairTimeLabelOptions): void;
-/**
- * 在右侧价格轴上绘制"十字线价格标签"
- * 说明：该函数假设价格轴背景/刻度已绘制完（即 drawPriceAxis 之后调用）。
- */
 export declare function drawCrosshairPriceLabel(ctx: CanvasRenderingContext2D, opts: CrosshairPriceLabelOptions): void;
 /** 绘制"最新价水平虚线"（画在 plotCanvas 的 world 坐标系：需在 translate(-scrollLeft,0) 之后调用） */
 export declare function drawLastPriceDashedLine(ctx: CanvasRenderingContext2D, opts: LastPriceLineOptions): void;
@@ -141,10 +133,6 @@ export interface AxisPriceLabelOptions {
     textColor?: string;
     fontSize?: number;
 }
-/**
- * 在右侧价格轴上绘制价格标签
- * 与 drawCrosshairPriceLabel 类似，但简化了参数（价格直接传入，无需计算）
- */
 export declare function drawAxisPriceLabel(ctx: CanvasRenderingContext2D, opts: AxisPriceLabelOptions): void;
 export interface AxisTimeLabelOptions {
     x: number;
@@ -159,8 +147,4 @@ export interface AxisTimeLabelOptions {
     fontSize?: number;
     paddingX?: number;
 }
-/**
- * 在底部时间轴上绘制时间标签
- * 与 drawCrosshairTimeLabel 类似，但 labelX 是屏幕坐标（已处理 scrollLeft）
- */
 export declare function drawAxisTimeLabel(ctx: CanvasRenderingContext2D, opts: AxisTimeLabelOptions): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@363045841yyt/klinechart",
-  "version": "0.5.6",
+  "version": "0.6.1",
   "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",
@@ -51,6 +51,7 @@
     "build-only": "vite build",
     "build:demo": "vite build --config vite.demo.config.ts",
     "preview": "vite preview",
+    "preview:demo": "vite preview --config vite.demo.config.ts",
     "type-check": "vue-tsc --build",
     "test:unit": "vitest",
     "format": "prettier --write --experimental-cli src/",

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

@@ -1,2 +0,0 @@
-import { KLineData } from '../../types/price';
-export declare function calcMAAtIndex(data: KLineData[], index: number, period: number): number | undefined;