@363045841yyt/klinechart 0.3.1 → 0.4.1

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 轴区域
+ * 仅渲染主图价格刻度；副图刻度由指标刻度插件负责
  */
 export declare function createYAxisRendererPlugin(options: {
     axisWidth: number;

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

@@ -1,7 +1,8 @@
 /**
  * 根据面板高度计算网格线/价格标签数量
+ * 刻度间距固定约 60px
  * @param height 面板高度（逻辑像素）
- * @param isMain 是否为主图面板
+ * @param isMain 是否为主图面板（暂未使用，保留参数兼容）
  * @returns tick 数量
  */
-export declare function calculateTickCount(height: number, isMain: boolean): number;
+export declare function calculateTickCount(height: number, isMain?: boolean): number;

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,11 +1,13 @@
-import { Plugin, PluginConfig, PluginHost, PluginState } from './types';
+import { Plugin, PluginConfig, PluginHost, PluginState, BaseIndicatorState, PluginLogger, HookCallOptions } from './types';
 export declare class PluginHostImpl implements PluginHost {
     private registry;
     private eventBus;
     private hookSystem;
     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;
@@ -15,13 +17,18 @@ 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;
     getPlugin<T extends Plugin = Plugin>(name: string): T | undefined;
     log(level: 'info' | 'warn' | 'error', message: string, ...args: unknown[]): void;
+    setSharedState<T extends BaseIndicatorState>(namespace: string, state: T, ownerId?: string): void;
+    getSharedState<T extends BaseIndicatorState>(namespace: string): T | undefined;
+    clearSharedState(namespace: string): void;
+    registerStateOwner(ownerId: string, namespaces: string[]): void;
+    clearByOwner(ownerId: string): void;
     /**
      * 安装插件
      */
@@ -44,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/StateStore.d.ts

@@ -0,0 +1,37 @@
+import { BaseIndicatorState } from './types';
+export declare class StateStore {
+    private states;
+    private ownerNamespaces;
+    /**
+     * 设置状态
+     * @param namespace 状态命名空间
+     * @param state 状态值
+     * @param ownerId 可选的拥有者 ID（用于冲突检测）
+     */
+    setState<T extends BaseIndicatorState>(namespace: string, state: T, ownerId?: string): void;
+    /**
+     * 获取状态
+     * @param namespace 状态命名空间
+     */
+    getState<T extends BaseIndicatorState>(namespace: string): T | undefined;
+    /**
+     * 清除指定命名空间的状态
+     * @param namespace 状态命名空间
+     */
+    clearState(namespace: string): void;
+    /**
+     * 注册状态拥有者
+     * @param ownerId 拥有者 ID（通常是渲染器名称）
+     * @param namespaces 声明的命名空间列表
+     */
+    registerStateOwner(ownerId: string, namespaces: string[]): void;
+    /**
+     * 按拥有者清除所有状态
+     * @param ownerId 拥有者 ID
+     */
+    clearByOwner(ownerId: string): void;
+    /**
+     * 清空所有状态
+     */
+    clear(): void;
+}

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

@@ -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/stateKeys.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 状态命名空间工厂函数
+ * 用于生成渲染器间共享状态的键名
+ */
+/** 创建指标状态键 */
+export declare const createIndicatorStateKey: (type: string, paneId: string) => `indicator:${string}:${string}`;

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;
@@ -68,6 +78,16 @@ export interface PluginHost {
     getPlugin<T extends Plugin = Plugin>(name: string): T | undefined;
     /** 日志工具 */
     log(level: 'info' | 'warn' | 'error', message: string, ...args: unknown[]): void;
+    /** 设置共享状态 */
+    setSharedState<T extends BaseIndicatorState>(namespace: string, state: T, ownerId?: string): void;
+    /** 获取共享状态 */
+    getSharedState<T extends BaseIndicatorState>(namespace: string): T | undefined;
+    /** 清除共享状态 */
+    clearSharedState(namespace: string): void;
+    /** 注册状态拥有者 */
+    registerStateOwner(ownerId: string, namespaces: string[]): void;
+    /** 按拥有者清除状态 */
+    clearByOwner(ownerId: string): void;
 }
 /** Pane 信息接口 */
 export interface PaneInfo {
@@ -134,7 +154,17 @@ export declare const RENDERER_PRIORITY: {
     readonly SYSTEM_XAXIS: -20;
     readonly BACKGROUND: 0;
     readonly GRID: 10;
+    /**
+     * 指标渲染器（MACD, RSI 等）
+     * 所有指标渲染器必须使用此优先级或 ≤30 的值
+     */
     readonly INDICATOR: 30;
+    /**
+     * 指标刻度渲染器（依赖于前方 INDICATOR 的状态）
+     * 所有刻度渲染器必须使用此优先级或 ≥35 的值，
+     * 确保每次绘制时指标更新先于刻度。
+     */
+    readonly INDICATOR_SCALE: 35;
     readonly MAIN: 50;
     readonly OVERLAY: 80;
     readonly FOREGROUND: 100;
@@ -183,4 +213,10 @@ export interface RendererPlugin {
 export interface RendererPluginWithHost extends RendererPlugin {
     /** 安装时获取 PluginHost 访问权限 */
     onInstall?(host: PluginHost): void;
+    /** 声明该渲染器所拥有的状态命名空间，卸载时框架会自动清理 */
+    getDeclaredNamespaces?(): string[];
+}
+/** 指标渲染器状态基类 */
+export interface BaseIndicatorState {
+    timestamp: number;
 }

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;

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.3.1",
+  "version": "0.4.1",
   "type": "module",
   "engines": {
     "node": "^20.19.0 || >=22.12.0"