@363045841yyt/klinechart 0.4.0 → 0.4.2

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

@@ -1,5 +1,5 @@
-import { RendererPlugin } from '../../../../plugin';
-import { KLineData } from '../../../../types/price';
+import { RendererPluginWithHost, BaseIndicatorState } from '../../../plugin';
+import { KLineData } from '../../../types/price';
 export interface STOCHConfig {
     /** K 周期（默认 9） */
     n?: number;
@@ -14,6 +14,10 @@ interface STOCHPoint {
     k: number;
     d: number;
 }
+export interface STOCHRenderState extends BaseIndicatorState {
+    valueMin: number;
+    valueMax: number;
+}
 export interface STOCHRendererOptions {
     /** 目标 pane ID（默认 'sub'） */
     paneId?: string;
@@ -23,7 +27,7 @@ export interface STOCHRendererOptions {
 /**
  * 创建 STOCH 渲染器插件
  */
-export declare function createSTOCHRendererPlugin(options?: STOCHRendererOptions): RendererPlugin;
+export declare function createSTOCHRendererPlugin(options?: STOCHRendererOptions): RendererPluginWithHost;
 /**
  * 计算指定索引处的 STOCH 值
  */

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

@@ -1,11 +1,15 @@
-import { RendererPlugin } from '../../../../plugin';
-import { KLineData } from '../../../../types/price';
+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;
+}
 export interface WMSRRendererOptions {
     /** 目标 pane ID（默认 'sub'） */
     paneId?: string;
@@ -15,7 +19,7 @@ export interface WMSRRendererOptions {
 /**
  * 创建 WMSR 渲染器插件
  */
-export declare function createWMSRRendererPlugin(options?: WMSRRendererOptions): RendererPlugin;
+export declare function createWMSRRendererPlugin(options?: WMSRRendererOptions): RendererPluginWithHost;
 /**
  * 计算指定索引处的 WMSR 值
  */

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

@@ -1,6 +1,6 @@
-import { RendererPlugin } from '../../../plugin';
-import { VolumePriceRelation } from '../../../types/volumePrice';
-import { MarkerManager } from '../../../core/marker/registry';
+import { RendererPlugin } from '../../plugin';
+import { VolumePriceRelation } from '../../types/volumePrice';
+import { MarkerManager } from '../marker/registry';
 /**
  * 创建 K 线蜡烛图渲染器插件
  */

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

@@ -1,4 +1,4 @@
-import { RendererPlugin } from '../../../plugin';
+import { RendererPlugin } from '../../plugin';
 /**
  * 创建十字线渲染器插件
  * 垂直线绘制到所有面板，水平线只绘制到活跃面板

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

@@ -1,4 +1,4 @@
-import { RendererPlugin } from '../../../plugin';
+import { RendererPlugin } from '../../plugin';
 /**
  * 创建自定义标记渲染器插件
  * 负责渲染 semanticConfig 中配置的 customMarkers

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

@@ -1,4 +1,4 @@
-import { RendererPlugin } from '../../../plugin';
+import { RendererPlugin } from '../../plugin';
 /**
  * 创建可视区最高/最低价标注渲染器插件
  */

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

@@ -1,4 +1,4 @@
-import { RendererPlugin } from '../../../plugin';
+import { RendererPlugin } from '../../plugin';
 /**
  * 创建网格线渲染器插件
  * 横向按像素均分铺满整个绘图区高度，纵向按月分割（使用预计算的月边界，网格线对齐到K线实体中部）

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

@@ -1,4 +1,4 @@
-import { RendererPlugin } from '../../../plugin';
+import { RendererPlugin } from '../../plugin';
 /**
  * 创建最新价虚线渲染器插件
  */

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

@@ -1,4 +1,4 @@
-import { RendererPlugin } from '../../../plugin';
+import { RendererPlugin } from '../../plugin';
 /**
  * 单个数值项
  */

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

@@ -1,4 +1,4 @@
-import { RendererPlugin } from '../../../plugin';
+import { RendererPlugin } from '../../plugin';
 export interface VolumeRendererOptions {
     /** 目标 pane ID（默认 'sub'） */
     paneId?: string;

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

@@ -1,4 +1,4 @@
-import { RendererPlugin } from '../../../plugin';
+import { RendererPlugin } from '../../plugin';
 /** 时间轴面板 ID（特殊标识，用于单独渲染） */
 export declare const TIME_AXIS_PANE_ID: unique symbol;
 /**

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

@@ -1,7 +1,7 @@
-import { RendererPlugin } from '../../../plugin';
+import { RendererPlugin } from '../../plugin';
 /**
  * 创建 Y 轴渲染器插件
- * 渲染到所有面板的 Y 轴区域
+ * 按 pane capability 决定是否绘制刻度与价格标签
  */
 export declare function createYAxisRendererPlugin(options: {
     axisWidth: number;
@@ -9,5 +9,6 @@ export declare function createYAxisRendererPlugin(options: {
     getCrosshair?: () => {
         y: number;
         price: number;
+        activePaneId: string | null;
     } | null;
 }): RendererPlugin;

package/dist/src/core/viewport/viewport.d.ts

@@ -1,5 +1,5 @@
-import { KLineData } from '../../../types/price';
-import { PriceRange } from '../../../core/scale/price';
+import { KLineData } from '../../types/price';
+import { PriceRange } from '../scale/price';
 /**
  * 计算当前视口可见的 K 线索引范围（使用物理像素对齐）。
  *

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

@@ -1,4 +1,4 @@
-import { HookFn } from './types';
+import { HookCallOptions, HookFn } from './types';
 export declare class HookSystem {
     private hooks;
     /**
@@ -12,11 +12,11 @@ export declare class HookSystem {
     /**
      * 触发钩子（异步）
      */
-    call<T = unknown, R = unknown>(hookName: string, context: T): Promise<R[]>;
+    call<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): Promise<R[]>;
     /**
      * 触发钩子（同步）
      */
-    callSync<T = unknown, R = unknown>(hookName: string, context: T): R[];
+    callSync<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): R[];
     /**
      * 清除所有钩子
      */

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

@@ -1,4 +1,4 @@
-import { Plugin, PluginConfig, PluginHost, PluginState, BaseIndicatorState } from './types';
+import { Plugin, PluginConfig, PluginHost, PluginState, BaseIndicatorState, PluginLogger, HookCallOptions } from './types';
 export declare class PluginHostImpl implements PluginHost {
     private registry;
     private eventBus;
@@ -6,7 +6,8 @@ export declare class PluginHostImpl implements PluginHost {
     private configManager;
     private stateStore;
     private isDestroyed;
-    constructor();
+    private logger;
+    constructor(logger?: PluginLogger);
     readonly events: {
         on: <T = unknown>(event: string, handler: (data: T) => void) => void;
         off: <T = unknown>(event: string, handler: (data: T) => void) => void;
@@ -16,8 +17,8 @@ export declare class PluginHostImpl implements PluginHost {
     readonly hooks: {
         tap: <T = unknown, R = unknown>(hookName: string, fn: (context: T) => R | Promise<R>, priority?: number) => void;
         untap: (hookName: string, fn: (context: unknown) => unknown) => void;
-        call: <T = unknown, R = unknown>(hookName: string, context: T) => Promise<R[]>;
-        callSync: <T = unknown, R = unknown>(hookName: string, context: T) => R[];
+        call: <T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions) => Promise<R[]>;
+        callSync: <T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions) => R[];
     };
     getConfig<K = unknown>(pluginName: string, key: string, defaultValue?: K): K;
     setConfig(pluginName: string, key: string, value: unknown): void;
@@ -50,4 +51,4 @@ export declare class PluginHostImpl implements PluginHost {
     destroy(): Promise<void>;
     private ensureNotDestroyed;
 }
-export declare function createPluginHost(): PluginHostImpl;
+export declare function createPluginHost(logger?: PluginLogger): PluginHostImpl;

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

@@ -34,8 +34,8 @@ export declare class RendererPluginManager {
     addKnownPaneId(paneId: string): void;
     /** 移除 paneId */
     removeKnownPaneId(paneId: string): void;
-    /** 获取所有已知的 paneId */
-    getKnownPaneIds(): string[];
+    /** 覆盖已知 paneId 集合 */
+    setKnownPaneIds(paneIds: string[]): void;
     /** 注册渲染器插件 */
     register(plugin: RendererPlugin | RendererPluginWithHost): void;
     /** 移除渲染器插件 */
@@ -49,6 +49,10 @@ export declare class RendererPluginManager {
     private mergeSorted;
     /** 重建缓存（统一管理所有缓存逻辑） */
     private rebuildCache;
+    /** 判断渲染器是否启用 */
+    private isRendererEnabled;
+    /** 获取指定 pane 的合并渲染器（包含 system 渲染器） */
+    private getMergedRenderers;
     /** 获取指定 pane 的渲染器（已缓存，无穿透） */
     getRenderers(paneId: string): RendererPlugin[];
     /** 渲染指定 pane（带错误隔离） */

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

@@ -36,6 +36,10 @@ export interface PluginDescriptor {
 }
 /** Hook 函数类型 */
 export type HookFn<T = unknown, R = unknown> = (context: T) => R | Promise<R>;
+/** Hook 调用选项 */
+export interface HookCallOptions {
+    throwOnError?: boolean;
+}
 /** Hook 描述符 */
 export interface HookDescriptor<T = unknown, R = unknown> {
     name: string;
@@ -44,6 +48,12 @@ export interface HookDescriptor<T = unknown, R = unknown> {
 }
 /** 事件处理器 */
 export type EventHandler<T = unknown> = (data: T) => void;
+/** 插件日志器 */
+export interface PluginLogger {
+    info(message?: unknown, ...optionalParams: unknown[]): void;
+    warn(message?: unknown, ...optionalParams: unknown[]): void;
+    error(message?: unknown, ...optionalParams: unknown[]): void;
+}
 /** 插件宿主接口（暴露给插件使用的 API） */
 export interface PluginHost {
     /** 事件总线 */
@@ -57,8 +67,8 @@ export interface PluginHost {
     readonly hooks: {
         tap<T = unknown, R = unknown>(hookName: string, fn: HookFn<T, R>, priority?: number): void;
         untap(hookName: string, fn: HookFn): void;
-        call<T = unknown, R = unknown>(hookName: string, context: T): Promise<R[]>;
-        callSync<T = unknown, R = unknown>(hookName: string, context: T): R[];
+        call<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): Promise<R[]>;
+        callSync<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): R[];
     };
     /** 获取配置 */
     getConfig<K = unknown>(pluginName: string, key: string, defaultValue?: K): K;
@@ -79,9 +89,20 @@ export interface PluginHost {
     /** 按拥有者清除状态 */
     clearByOwner(ownerId: string): void;
 }
+/** Pane 角色 */
+export type PaneRole = 'price' | 'indicator' | 'auxiliary';
+/** Pane 能力开关 */
+export interface PaneCapabilities {
+    showPriceAxisTicks: boolean;
+    showCrosshairPriceLabel: boolean;
+    candleHitTest: boolean;
+    supportsPriceTranslate: boolean;
+}
 /** Pane 信息接口 */
 export interface PaneInfo {
     id: string;
+    role: PaneRole;
+    capabilities: PaneCapabilities;
     top: number;
     height: number;
     yAxis: {
@@ -106,6 +127,8 @@ export interface PaneInfo {
  */
 export declare function wrapPaneInfo(pane: {
     id: string;
+    role: PaneRole;
+    capabilities: PaneCapabilities;
     top: number;
     height: number;
     yAxis: PaneInfo['yAxis'];

package/dist/src/semantic/controller.d.ts

@@ -1,4 +1,4 @@
-import { Chart } from '../../core/chart';
+import { Chart } from '../core/chart';
 import { SemanticChartConfig, ApplyResult } from './types';
 /** 状态事件类型 */
 export type SemanticEventType = 'config:loading' | 'config:ready' | 'config:error';

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

@@ -1,4 +1,4 @@
-import { KLineData } from '../../../types/price';
+import { KLineData } from '../../types/price';
 import { drawOption, PriceRange } from './kLine';
 export declare const MA5_COLOR: "rgba(255, 193, 37, 1)";
 export declare const MA10_COLOR: "rgba(190, 131, 12, 1)";

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

@@ -1,4 +1,4 @@
-import { KLineData } from '../../../types/price';
+import { KLineData } from '../../types/price';
 export interface PriceAxisOptions {
     x: number;
     y: number;
@@ -90,6 +90,10 @@ export interface CrosshairPriceLabelOptions {
     textColor?: string;
     fontSize?: number;
     paddingX?: number;
+    /** 价格偏移量（用于价格轴平移时同步显示） */
+    priceOffset?: number;
+    /** 优先显示的价格（如十字线已按 active pane 算好） */
+    price?: number;
 }
 export interface CrosshairTimeLabelOptions {
     x: number;

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

@@ -1,4 +1,4 @@
-import { KLineData } from '../../../types/price';
+import { KLineData } from '../../types/price';
 import { drawOption, PriceRange } from './kLine';
 export interface GridOption {
     /** 网格线颜色 */

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

@@ -1,4 +1,4 @@
-import { KLineData } from '../../../types/price';
+import { KLineData } from '../../types/price';
 export interface drawOption {
     kWidth: number;
     kGap: number;

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

@@ -1,5 +1,5 @@
-import { KLineData } from '../../../types/price';
-export { formatShanghaiDate } from '../../../utils/dateFormat';
+import { KLineData } from '../../types/price';
+export { formatShanghaiDate } from '../dateFormat';
 export declare const UP_COLOR: "rgba(214, 10, 34, 1)";
 export declare const DOWN_COLOR: "rgba(3, 123, 102, 1)";
 export declare const NEUTRAL_COLOR: "rgba(0, 0, 0, 0.78)";

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

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

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

@@ -1,4 +1,4 @@
-import { KLineData } from '../../../types/price';
+import { KLineData } from '../../types/price';
 export type PriceRange = {
     maxPrice: number;
     minPrice: number;

package/dist/src/utils/mock/genRandomPriceData.d.ts

@@ -1,3 +1,3 @@
-import { KLineData } from '../../../types/price';
+import { KLineData } from '../../types/price';
 export declare function genRandomPriceData(count: number): KLineData[];
 export declare function reversalExampleData(): KLineData[];

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

@@ -1,5 +1,5 @@
-import { KLineData } from '../../types/price';
-import { VolumePriceRelation, VolumePriceConfig, DEFAULT_VOLUME_PRICE_CONFIG } from '../../types/volumePrice';
+import { KLineData } from '../types/price';
+import { VolumePriceRelation, VolumePriceConfig, DEFAULT_VOLUME_PRICE_CONFIG } from '../types/volumePrice';
 export { DEFAULT_VOLUME_PRICE_CONFIG };
 /**
  * 成交量前缀和计算器

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@363045841yyt/klinechart",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "engines": {
     "node": "^20.19.0 || >=22.12.0"