@363045841yyt/klinechart 0.5.5 → 0.6.0

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/scale/logFormula.d.ts

@@ -0,0 +1,66 @@
+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/priceScale.d.ts

@@ -1,4 +1,5 @@
 import { PriceRange } from './price';
+import { ScaleType } from '../utils/tickPosition';
 /**
  * Pane 级别的价格坐标系（价格 -> pane 内 Y）
  * - y=0 在 pane 顶部，y=height 在 pane 底部
@@ -8,10 +9,15 @@ export declare class PriceScale {
     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;
@@ -20,7 +26,9 @@ export declare class PriceScale {
     getPaddingBottom(): number;
     /**
      * 设置价格偏移量
-     * @param offset 价格偏移（正数向上平移，负数向下平移）
+     * @param offset 价格偏移
+     *   - 线性模式：真实价格的线性偏移
+     *   - 对数模式：log 空间的偏移量
      */
     setPriceOffset(offset: number): void;
     /**
@@ -41,13 +49,39 @@ export declare class PriceScale {
      */
     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/theme/fonts.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 图表字体配置
+ * 字体栈：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;

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

@@ -0,0 +1,24 @@
+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/plugin/types.d.ts

@@ -116,6 +116,7 @@ export interface PaneInfo {
             maxPrice: number;
             minPrice: number;
         };
+        getScaleType(): 'linear' | 'log';
     };
     priceRange: {
         maxPrice: number;
@@ -147,6 +148,8 @@ export interface YAxisLabel {
     price: number;
     /** 标签在轴上的Y坐标（世界坐标，相对pane） */
     y: number;
+    /** 标签类型，用于区分不同渲染外观 */
+    type?: 'lastPrice' | 'extrema' | 'anchor' | string;
     /** 标签样式覆盖 */
     style?: {
         bgColor?: string;
@@ -350,6 +353,7 @@ export interface DrawingDefinition<TParams = Record<string, unknown>> {
 export declare const GLOBAL_PANE_ID: unique symbol;
 /** 优先级推荐范围 */
 export declare const RENDERER_PRIORITY: {
+    readonly LAST_PRICE_LABEL: -25;
     readonly SYSTEM_YAXIS: -20;
     readonly SYSTEM_XAXIS: -20;
     readonly BACKGROUND: 0;

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "@363045841yyt/klinechart",
-  "version": "0.5.5",
+  "version": "0.6.0",
+  "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",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/363045841/KLineChartQuant.git"
+  },
+  "bugs": "https://github.com/363045841/KLineChartQuant/issues",
+  "homepage": "https://363045841.github.io/KLineChartQuant/",
   "keywords": [
     "kline-chart",
     "candlestick-chart",

package/dist/src/semantic/schema.json.d.ts

@@ -1,259 +0,0 @@
-declare const _default: {
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://kmap.dev/schemas/semantic-chart-config/1.0.0",
-  "title": "SemanticChartConfig",
-  "description": "Agent 语义化图表配置",
-  "type": "object",
-  "required": ["version", "data"],
-  "additionalProperties": false,
-  "properties": {
-    "version": {
-      "type": "string",
-      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
-      "description": "semver 版本号"
-    },
-    "data": { "$ref": "#/$defs/DataConfig" },
-    "indicators": { "$ref": "#/$defs/IndicatorsConfig" },
-    "markers": { "$ref": "#/$defs/MarkersConfig" },
-    "chart": { "$ref": "#/$defs/ChartOptions" },
-    "theme": { "$ref": "#/$defs/ThemeConfig" }
-  },
-  "$defs": {
-    "DataConfig": {
-      "type": "object",
-      "required": ["source", "symbol", "startDate", "endDate", "period", "adjust"],
-      "additionalProperties": false,
-      "properties": {
-        "source": { "type": "string", "enum": ["baostock", "dongcai"] },
-        "symbol": { "type": "string", "pattern": "^[0-9]{6}$" },
-        "exchange": { "type": "string", "enum": ["SH", "SZ", "BJ"] },
-        "startDate": { "type": "string", "format": "date" },
-        "endDate": { "type": "string", "format": "date" },
-        "period": {
-          "type": "string",
-          "enum": ["daily", "weekly", "monthly", "5min", "15min", "30min", "60min"]
-        },
-        "adjust": { "type": "string", "enum": ["qfq", "hfq", "none"] }
-      }
-    },
-    "IndicatorsConfig": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "main": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/MainIndicatorConfig" },
-          "maxItems": 5
-        },
-        "sub": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/SubIndicatorConfig" },
-          "maxItems": 5
-        }
-      }
-    },
-    "MainIndicatorConfig": {
-      "type": "object",
-      "required": ["type", "enabled"],
-      "additionalProperties": false,
-      "properties": {
-        "type": { "type": "string", "enum": ["MA", "BOLL"] },
-        "enabled": { "type": "boolean" },
-        "params": { "type": "object" }
-      },
-      "allOf": [
-        {
-          "if": {
-            "properties": { "type": { "const": "MA" } },
-            "required": ["type"]
-          },
-          "then": {
-            "properties": {
-              "params": {
-                "type": "object",
-                "additionalProperties": false,
-                "properties": {
-                  "periods": {
-                    "type": "array",
-                    "items": { "type": "integer", "minimum": 1, "maximum": 250 },
-                    "minItems": 1,
-                    "maxItems": 5
-                  }
-                }
-              }
-            }
-          },
-          "else": {
-            "properties": {
-              "params": {
-                "type": "object",
-                "additionalProperties": false,
-                "properties": {
-                  "period": { "type": "integer", "minimum": 1, "maximum": 100 },
-                  "multiplier": { "type": "number", "minimum": 0.1, "maximum": 5 }
-                }
-              }
-            }
-          }
-        }
-      ]
-    },
-    "SubIndicatorConfig": {
-      "type": "object",
-      "required": ["type", "enabled"],
-      "additionalProperties": false,
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": ["VOLUME", "MACD", "RSI", "CCI", "STOCH", "MOM", "WMSR", "KST", "FASTK"]
-        },
-        "enabled": { "type": "boolean" },
-        "params": { "type": "object" }
-      },
-      "allOf": [
-        {
-          "if": { "properties": { "type": { "const": "MACD" } } },
-          "then": {
-            "properties": {
-              "params": {
-                "type": "object",
-                "additionalProperties": false,
-                "properties": {
-                  "fast": { "type": "integer", "minimum": 1, "maximum": 50 },
-                  "slow": { "type": "integer", "minimum": 1, "maximum": 100 },
-                  "signal": { "type": "integer", "minimum": 1, "maximum": 50 }
-                }
-              }
-            }
-          }
-        },
-        {
-          "if": { "properties": { "type": { "const": "RSI" } } },
-          "then": {
-            "properties": {
-              "params": {
-                "type": "object",
-                "additionalProperties": false,
-                "properties": {
-                  "period1": { "type": "integer", "minimum": 1, "maximum": 100 },
-                  "period2": { "type": "integer", "minimum": 1, "maximum": 100 },
-                  "period3": { "type": "integer", "minimum": 1, "maximum": 100 }
-                }
-              }
-            }
-          }
-        }
-      ]
-    },
-    "MarkersConfig": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "showVolumePriceMarkers": { "type": "boolean" },
-        "showExtremaMarkers": { "type": "boolean" },
-        "customMarkers": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/CustomMarker" },
-          "maxItems": 100
-        },
-        "legend": { "$ref": "#/$defs/LegendConfig" }
-      }
-    },
-    "CustomMarker": {
-      "type": "object",
-      "required": ["id", "date", "shape"],
-      "additionalProperties": false,
-      "properties": {
-        "id": { "type": "string", "maxLength": 64 },
-        "date": {
-          "type": "string",
-          "description": "日期时间字符串，日K用 YYYY-MM-DD，分钟K用 YYYY-MM-DD HH:mm",
-          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}( [0-9]{2}:[0-9]{2})?$"
-        },
-        "shape": {
-          "type": "string",
-          "enum": ["arrow_up", "arrow_down", "flag", "circle", "rectangle", "diamond"]
-        },
-        "groupKey": { "type": "string", "maxLength": 32 },
-        "offset": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "x": { "type": "number", "minimum": -500, "maximum": 500 },
-            "y": { "type": "number", "minimum": -500, "maximum": 500 }
-          }
-        },
-        "style": { "$ref": "#/$defs/MarkerStyle" },
-        "label": { "$ref": "#/$defs/MarkerLabel" },
-        "metadata": {
-          "type": "object",
-          "maxProperties": 20,
-          "additionalProperties": {
-            "type": ["string", "number", "boolean", "null"],
-            "maxLength": 200
-          }
-        }
-      }
-    },
-    "MarkerStyle": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "fillColor": { "type": "string", "pattern": "^(#[0-9a-fA-F]{3,8}|rgb\\(\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*\\)|rgba\\(\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*[\\d.]+\\s*\\))$" },
-        "strokeColor": { "type": "string", "pattern": "^(#[0-9a-fA-F]{3,8}|rgb\\(\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*\\)|rgba\\(\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*[\\d.]+\\s*\\))$" },
-        "textColor": { "type": "string", "pattern": "^(#[0-9a-fA-F]{3,8}|rgb\\(\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*\\)|rgba\\(\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*[\\d.]+\\s*\\))$" },
-        "size": { "type": "number", "minimum": 4, "maximum": 50 },
-        "lineWidth": { "type": "number", "minimum": 0.5, "maximum": 10 },
-        "opacity": { "type": "number", "minimum": 0, "maximum": 1 }
-      }
-    },
-    "MarkerLabel": {
-      "type": "object",
-      "required": ["text"],
-      "additionalProperties": false,
-      "properties": {
-        "text": { "type": "string", "maxLength": 50 },
-        "position": { "type": "string", "enum": ["left", "right", "top", "bottom", "inside"] },
-        "align": { "type": "string", "enum": ["start", "center", "end"] },
-        "fontSize": { "type": "number", "minimum": 8, "maximum": 24 },
-        "offset": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "x": { "type": "number", "minimum": -500, "maximum": 500 },
-            "y": { "type": "number", "minimum": -500, "maximum": 500 }
-          }
-        }
-      }
-    },
-    "LegendConfig": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": { "type": "boolean" },
-        "position": { "type": "string", "enum": ["bottom-right", "bottom-left", "top-right", "top-left"] },
-        "onClick": { "type": "string", "enum": ["highlight", "toggle", "none"] }
-      }
-    },
-    "ChartOptions": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "kWidth": { "type": "number", "minimum": 2, "maximum": 50 },
-        "kGap": { "type": "number", "minimum": 0, "maximum": 20 },
-        "autoScrollToRight": { "type": "boolean" }
-      }
-    },
-    "ThemeConfig": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "priceUpColor": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" },
-        "priceDownColor": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }
-      }
-    }
-  }
-}
-;
-
-export default _default;

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;