@363045841yyt/klinechart 0.4.0 → 0.4.1

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/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

@@ -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;

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