@363045841yyt/klinechart 0.1.4 → 0.2.0

package/dist/klinechart.css

@@ -1,2 +1,2 @@
-.kline-tooltip[data-v-95daa55c]{z-index:10;color:#000000c7;pointer-events:none;-webkit-backdrop-filter:blur(6px);backdrop-filter:blur(6px);background:#ffffffeb;border:1px solid #0000001f;border-radius:8px;min-width:200px;max-width:260px;padding:10px 12px;font-size:12px;line-height:1.4;position:absolute;box-shadow:0 6px 18px #0000001f}.kline-tooltip__title[data-v-95daa55c]{justify-content:space-between;gap:10px;margin-bottom:6px;font-weight:600;display:flex}.kline-tooltip__grid[data-v-95daa55c]{grid-template-columns:1fr;gap:2px;display:grid}.kline-tooltip__grid .row[data-v-95daa55c]{justify-content:space-between;gap:10px;display:flex}.kline-tooltip__grid .row span[data-v-95daa55c]:first-child{color:#0000008f}.indicator-selector[data-v-7578161a]{width:80%;margin:20px}.indicator-scroll-container[data-v-7578161a]{white-space:nowrap;-webkit-overflow-scrolling:touch;scrollbar-width:none;justify-content:center;width:100%;display:flex;overflow:auto hidden}.indicator-scroll-container[data-v-7578161a]::-webkit-scrollbar{display:none}.indicator-list[data-v-7578161a]{gap:8px;padding:2px;display:flex}.indicator-btn[data-v-7578161a]{color:#666;cursor:pointer;white-space:nowrap;background:#fff;border:1px solid #d0d0d0;border-radius:16px;flex-shrink:0;padding:6px 16px;font-size:13px;font-weight:500;transition:all .2s}.indicator-btn[data-v-7578161a]:hover{color:#333;background:#f0f0f0;border-color:#b0b0b0}.indicator-btn.active[data-v-7578161a]{color:#fff;background:#1890ff;border-color:#1890ff}.indicator-btn.active[data-v-7578161a]:hover{background:#40a9ff;border-color:#40a9ff}.chart-wrapper[data-v-42ce96d4]{flex-direction:column;justify-content:center;align-items:center;width:100%;height:100%;display:flex}.chart-container[data-v-42ce96d4]{scrollbar-width:none;-ms-overflow-style:none;-webkit-touch-callout:none;-webkit-user-select:none;user-select:none;touch-action:none;width:80%;height:80%;position:relative;overflow:auto hidden}.chart-container[data-v-42ce96d4]::-webkit-scrollbar{display:none}.chart-container[data-v-42ce96d4]:hover{cursor:grab}.chart-container[data-v-42ce96d4]:active{cursor:grabbing}.scroll-content[data-v-42ce96d4]{height:100%;min-height:inherit;position:relative}.canvas-layer[data-v-42ce96d4]{pointer-events:none;position:sticky;top:0;left:0}.plot-canvas[data-v-42ce96d4]{display:block;position:absolute;top:0;left:0}.y-axis-canvas[data-v-42ce96d4]{display:block;position:absolute;top:0;right:0}.x-axis-canvas[data-v-42ce96d4]{display:block;position:absolute;bottom:0;left:0}
+.kline-tooltip[data-v-95daa55c]{z-index:10;color:#000000c7;pointer-events:none;-webkit-backdrop-filter:blur(6px);backdrop-filter:blur(6px);background:#ffffffeb;border:1px solid #0000001f;border-radius:8px;min-width:200px;max-width:260px;padding:10px 12px;font-size:12px;line-height:1.4;position:absolute;box-shadow:0 6px 18px #0000001f}.kline-tooltip__title[data-v-95daa55c]{justify-content:space-between;gap:10px;margin-bottom:6px;font-weight:600;display:flex}.kline-tooltip__grid[data-v-95daa55c]{grid-template-columns:1fr;gap:2px;display:grid}.kline-tooltip__grid .row[data-v-95daa55c]{justify-content:space-between;gap:10px;display:flex}.kline-tooltip__grid .row span[data-v-95daa55c]:first-child{color:#0000008f}.marker-tooltip[data-v-dd43da4f]{z-index:10;color:#000000c7;pointer-events:none;-webkit-backdrop-filter:blur(6px);backdrop-filter:blur(6px);background:#ffffffeb;border:1px solid #0000001f;border-radius:8px;min-width:180px;max-width:260px;padding:10px 12px;font-size:12px;line-height:1.4;position:absolute;box-shadow:0 6px 18px #0000001f}.marker-tooltip__title[data-v-dd43da4f]{justify-content:space-between;gap:10px;margin-bottom:6px;font-weight:600;display:flex}.marker-tooltip__content[data-v-dd43da4f]{grid-template-columns:1fr;gap:2px;display:grid}.marker-tooltip__content .row[data-v-dd43da4f]{justify-content:space-between;gap:10px;display:flex}.marker-tooltip__content .row span[data-v-dd43da4f]:first-child{color:#0000008f}.params-overlay[data-v-730f2212]{-webkit-backdrop-filter:blur(4px);backdrop-filter:blur(4px);z-index:1000;background:#0000004d;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.indicator-params[data-v-730f2212]{background:#fff;border:1px solid #e0e0e0;border-radius:12px;width:90vw;min-width:340px;max-width:420px;overflow:hidden;box-shadow:0 8px 40px #00000026}.params-header[data-v-730f2212]{background:#f8f8f8;border-bottom:1px solid #e8e8e8;justify-content:space-between;align-items:center;padding:16px 20px;display:flex}.header-left[data-v-730f2212]{align-items:baseline;gap:8px;display:flex}.header-right[data-v-730f2212]{align-items:center;gap:8px;display:flex}.params-title[data-v-730f2212]{color:#1a1a1a;letter-spacing:.2px;font-size:14px;font-weight:600}.params-subtitle[data-v-730f2212]{color:#999;font-size:11px}.toggle-desc-btn[data-v-730f2212]{cursor:pointer;color:#888;background:#fff;border:1px solid #e0e0e0;border-radius:6px;justify-content:center;align-items:center;width:28px;height:28px;padding:0;transition:all .2s;display:flex}.toggle-desc-btn[data-v-730f2212]:hover{color:#555;background:#f0f0f0;border-color:#ccc}.toggle-desc-btn.active[data-v-730f2212]{color:#fff;background:#1a1a1a;border-color:#1a1a1a}.toggle-desc-btn svg[data-v-730f2212]{width:14px;height:14px}.params-close[data-v-730f2212]{cursor:pointer;color:#888;background:#fff;border:1px solid #e0e0e0;border-radius:6px;justify-content:center;align-items:center;width:26px;height:26px;padding:0;transition:background .15s,color .15s,border-color .15s;display:flex}.params-close[data-v-730f2212]:hover{color:#333;background:#f0f0f0;border-color:#ccc}.params-close svg[data-v-730f2212]{width:13px;height:13px}.indicator-description[data-v-730f2212]{background:#f0f7ff;border-bottom:1px solid #d6e8f5;padding:12px 20px}.indicator-description p[data-v-730f2212]{color:#2c5282;margin:0;font-size:12px;line-height:1.6}.params-body[data-v-730f2212]{flex-direction:column;gap:10px;padding:16px 20px;display:flex}.param-item[data-v-730f2212]{background:#f8f8f8;border:1px solid #e8e8e8;border-radius:8px;padding:10px 14px;transition:border-color .2s}.param-item[data-v-730f2212]:has(.param-input:focus){border-color:#bbb}.param-item.has-desc[data-v-730f2212]{padding:10px 14px 8px}.param-header[data-v-730f2212]{justify-content:space-between;align-items:center;gap:16px;display:flex}.param-label[data-v-730f2212]{flex-direction:column;gap:3px;display:flex}.param-label-text[data-v-730f2212]{color:#333;font-size:13px;font-weight:500}.param-range[data-v-730f2212]{color:#999;font-size:11px}.param-description[data-v-730f2212]{color:#666;border-top:1px dashed #e0e0e0;margin-top:8px;padding-top:8px;font-size:11px;line-height:1.5}.input-wrapper[data-v-730f2212]{background:#fff;border:1px solid #d0d0d0;border-radius:7px;align-items:stretch;height:32px;transition:border-color .2s;display:flex;overflow:hidden}.input-wrapper[data-v-730f2212]:focus-within{border-color:#999}.stepper-btn[data-v-730f2212]{cursor:pointer;color:#666;background:#f0f0f0;border:none;flex-shrink:0;justify-content:center;align-items:center;width:28px;font-size:15px;font-weight:400;line-height:1;transition:background .15s,color .15s;display:flex}.stepper-btn[data-v-730f2212]:hover:not(:disabled){color:#333;background:#e0e0e0}.stepper-btn[data-v-730f2212]:disabled{color:#ccc;cursor:not-allowed}.param-input[data-v-730f2212]{text-align:center;color:#1a1a1a;appearance:textfield;background:0 0;border:none;border-left:1px solid #e8e8e8;border-right:1px solid #e8e8e8;width:60px;font-size:13px;font-weight:600}.param-input[data-v-730f2212]::-webkit-inner-spin-button{-webkit-appearance:none}.param-input[data-v-730f2212]::-webkit-outer-spin-button{-webkit-appearance:none}.param-input[data-v-730f2212]:focus{outline:none}.params-footer[data-v-730f2212]{background:#f8f8f8;border-top:1px solid #e8e8e8;justify-content:space-between;align-items:center;padding:12px 20px;display:flex}.footer-right[data-v-730f2212]{gap:8px;display:flex}.params-btn[data-v-730f2212]{cursor:pointer;border:1px solid #0000;border-radius:7px;align-items:center;gap:5px;padding:6px 14px;font-size:13px;font-weight:500;line-height:1.4;transition:all .15s;display:flex}.params-btn svg[data-v-730f2212]{flex-shrink:0;width:12px;height:12px}.params-btn.reset[data-v-730f2212]{color:#666;background:0 0;border-color:#d0d0d0}.params-btn.reset[data-v-730f2212]:hover{color:#e74c3c;background:#e74c3c14;border-color:#c0392b}.params-btn.cancel[data-v-730f2212]{color:#666;background:0 0;border-color:#d0d0d0}.params-btn.cancel[data-v-730f2212]:hover{color:#333;background:#f0f0f0;border-color:#bbb}.params-btn.confirm[data-v-730f2212]{color:#fff;background:#1a1a1a;border-color:#1a1a1a}.params-btn.confirm[data-v-730f2212]:hover{background:#333;border-color:#333;transform:translateY(-1px);box-shadow:0 2px 10px #00000026}.params-btn.confirm[data-v-730f2212]:active{box-shadow:none;transform:translateY(0)}.overlay-enter-active[data-v-730f2212],.overlay-leave-active[data-v-730f2212]{transition:opacity .2s}.overlay-enter-from[data-v-730f2212],.overlay-leave-to[data-v-730f2212]{opacity:0}.modal-enter-active[data-v-730f2212]{transition:all .22s cubic-bezier(.34,1.56,.64,1)}.modal-leave-active[data-v-730f2212]{transition:all .16s ease-in}.modal-enter-from[data-v-730f2212]{opacity:0;transform:scale(.88)translateY(-16px)}.modal-leave-to[data-v-730f2212]{opacity:0;transform:scale(.94)translateY(8px)}.slide-enter-active[data-v-730f2212],.slide-leave-active[data-v-730f2212]{transition:all .2s;overflow:hidden}.slide-enter-from[data-v-730f2212],.slide-leave-to[data-v-730f2212]{opacity:0;max-height:0;margin-top:0;padding-top:0;padding-bottom:0}.indicator-selector[data-v-bd302de5]{width:80%;margin:20px;position:relative}.indicator-scroll-container[data-v-bd302de5]{white-space:nowrap;-webkit-overflow-scrolling:touch;scrollbar-width:none;justify-content:center;width:100%;display:flex;overflow:auto hidden}.indicator-scroll-container[data-v-bd302de5]::-webkit-scrollbar{display:none}.indicator-list[data-v-bd302de5]{gap:8px;padding:2px;display:flex}.indicator-item[data-v-bd302de5]{align-items:center;gap:4px;display:flex}.indicator-btn[data-v-bd302de5]{color:#666;cursor:pointer;white-space:nowrap;background:#fff;border:1px solid #e0e0e0;border-radius:16px;flex-shrink:0;align-items:center;gap:4px;padding:6px 16px;font-size:13px;font-weight:500;transition:all .45s cubic-bezier(.4,0,.2,1);display:flex}.indicator-btn[data-v-bd302de5]:hover{color:#333;background:#f8f8f8;border-color:#ccc}.indicator-btn.active[data-v-bd302de5]{color:#1a1a1a;background:#f8f8f8;border-color:#ccc}.indicator-btn.active[data-v-bd302de5]:hover{background:#f0f0f0;border-color:#bbb}.param-hint[data-v-bd302de5]{opacity:.85;font-size:11px}.settings-btn[data-v-bd302de5]{color:#999;cursor:pointer;background:#fff;border:1px solid #e0e0e0;border-radius:50%;justify-content:center;align-items:center;width:24px;height:24px;padding:0;font-size:12px;transition:all .2s;display:flex}.settings-btn[data-v-bd302de5]:hover{color:#333;background:#f8f8f8;border-color:#333}.chart-wrapper[data-v-379dcd6f]{flex-direction:column;justify-content:center;align-items:center;width:100%;height:100%;display:flex}.chart-container[data-v-379dcd6f]{scrollbar-width:none;-ms-overflow-style:none;-webkit-touch-callout:none;-webkit-user-select:none;user-select:none;touch-action:none;width:95%;height:85%;position:relative;overflow:auto hidden}.chart-container[data-v-379dcd6f]::-webkit-scrollbar{display:none}.chart-container[data-v-379dcd6f]:hover{cursor:grab}.chart-container[data-v-379dcd6f]:active{cursor:grabbing}.scroll-content[data-v-379dcd6f]{height:100%;min-height:inherit;position:relative}.canvas-layer[data-v-379dcd6f]{pointer-events:none;position:sticky;top:0;left:0}.plot-canvas[data-v-379dcd6f]{display:block;position:absolute;top:0;left:0}.y-axis-canvas[data-v-379dcd6f]{display:block;position:absolute;top:0;right:0}.x-axis-canvas[data-v-379dcd6f]{display:block;position:absolute;left:0}
 /*$vite$:1*/

package/dist/plugin/ConfigManager.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 配置管理器
+ */
+export declare class ConfigManager {
+    private configs;
+    private defaults;
+    /**
+     * 注册插件的默认配置
+     */
+    registerDefaults(pluginName: string, defaults: Record<string, unknown>): void;
+    /**
+     * 获取配置
+     */
+    get<K = unknown>(pluginName: string, key: string, defaultValue?: K): K;
+    /**
+     * 设置配置
+     */
+    set(pluginName: string, key: string, value: unknown): void;
+    /**
+     * 批量设置配置
+     */
+    setAll(pluginName: string, config: Record<string, unknown>): void;
+    /**
+     * 获取插件所有配置
+     */
+    getAll(pluginName: string): Record<string, unknown>;
+    /**
+     * 清除插件配置
+     */
+    clear(pluginName?: string): void;
+}

package/dist/plugin/EventBus.d.ts

@@ -0,0 +1,34 @@
+import { EventHandler } from './types';
+export declare class EventBus {
+    private listeners;
+    /**
+     * 订阅事件
+     */
+    on<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * 取消订阅
+     */
+    off<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * 发布事件
+     */
+    emit<T = unknown>(event: string, data: T): void;
+    /**
+     * 订阅一次性事件
+     *
+     * 注册一个仅在事件首次触发时执行的回调。回调执行后会自动从监听队列中移除，
+     * 确保后续相同事件的 emit 不会再触发该逻辑。
+     *
+     * @param event - 事件名称
+     * @param handler - 待执行的回调函数
+     */
+    once<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * 清除所有事件监听
+     */
+    clear(): void;
+    /**
+     * 获取事件的监听器数量
+     */
+    listenerCount(event: string): number;
+}

package/dist/plugin/HookSystem.d.ts

@@ -0,0 +1,28 @@
+import { HookFn } from './types';
+export declare class HookSystem {
+    private 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[];
+    /**
+     * 清除所有钩子
+     */
+    clear(): void;
+    /**
+     * 获取钩子数量
+     */
+    hookCount(hookName: string): number;
+}

package/dist/plugin/PluginHost.d.ts

@@ -0,0 +1,47 @@
+import { Plugin, PluginConfig, PluginHost, PluginState } from './types';
+export declare class PluginHostImpl implements PluginHost {
+    private registry;
+    private eventBus;
+    private hookSystem;
+    private configManager;
+    private isDestroyed;
+    constructor();
+    readonly events: {
+        on: <T = unknown>(event: string, handler: (data: T) => void) => void;
+        off: <T = unknown>(event: string, handler: (data: T) => void) => void;
+        emit: <T = unknown>(event: string, data: T) => void;
+        once: <T = unknown>(event: string, handler: (data: T) => void) => void;
+    };
+    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[];
+    };
+    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;
+    /**
+     * 安装插件
+     */
+    use(plugin: Plugin, config?: PluginConfig): Promise<void>;
+    /**
+     * 移除插件
+     */
+    remove(name: string): Promise<void>;
+    /**
+     * 获取所有插件
+     */
+    getPlugins(): import('./types').PluginDescriptor[];
+    /**
+     * 获取插件状态
+     */
+    getState(name: string): PluginState | undefined;
+    /**
+     * 销毁宿主
+     */
+    destroy(): Promise<void>;
+    private ensureNotDestroyed;
+}
+export declare function createPluginHost(): PluginHostImpl;

package/dist/plugin/PluginRegistry.d.ts

@@ -0,0 +1,40 @@
+import { Plugin, PluginDescriptor, PluginState } from './types';
+export declare class PluginRegistry {
+    private plugins;
+    /**
+     * 注册插件
+     */
+    register(plugin: Plugin, config?: Record<string, unknown>): PluginDescriptor;
+    /**
+     * 注销插件
+     */
+    unregister(name: string): boolean;
+    /**
+     * 获取插件描述符
+     */
+    get(name: string): PluginDescriptor | undefined;
+    /**
+     * 获取插件实例
+     */
+    getPlugin<T extends Plugin = Plugin>(name: string): T | undefined;
+    /**
+     * 获取所有插件
+     */
+    getAll(): PluginDescriptor[];
+    /**
+     * 获取所有已启用的插件
+     */
+    getEnabled(): PluginDescriptor[];
+    /**
+     * 更新插件状态
+     */
+    updateState(name: string, state: PluginState, error?: Error): void;
+    /**
+     * 检查插件是否存在
+     */
+    has(name: string): boolean;
+    /**
+     * 清除所有插件
+     */
+    clear(): void;
+}

package/dist/plugin/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 插件系统入口
+ */
+export * from './types';
+export { PluginRegistry } from './PluginRegistry';
+export { PluginHostImpl, createPluginHost } from './PluginHost';
+export { EventBus } from './EventBus';
+export { HookSystem } from './HookSystem';
+export { ConfigManager } from './ConfigManager';
+export { RendererPluginManager } from './rendererPluginManager';
+export type { RendererErrorEvent } from './rendererPluginManager';

package/dist/plugin/rendererPluginManager.d.ts

@@ -0,0 +1,73 @@
+import { RendererPlugin, RenderContext, PaneInfo, RendererPluginWithHost, PluginHost } from './types';
+/** 渲染器错误事件（裁剪后，不含大数据） */
+export interface RendererErrorEvent {
+    name: string;
+    error: {
+        message: string;
+        stack?: string;
+    };
+    paneId: string;
+    timestamp: number;
+}
+/**
+ * 渲染器插件管理器
+ *
+ * 启用状态优先级：
+ * 1. setEnabled() 运行时设置的状态（enabledState 中存在）
+ * 2. 插件初始 enabled 字段
+ * 3. 默认启用（enabled !== false）
+ */
+export declare class RendererPluginManager {
+    private plugins;
+    private pluginHost;
+    private enabledState;
+    private groupCache;
+    private mergedCache;
+    private knownPaneIds;
+    private cacheInvalid;
+    private onInvalidate;
+    /** 设置重绘回调（由 Chart 注入） */
+    setInvalidateCallback(cb: () => void): void;
+    /** 设置 PluginHost（用于支持 RendererPluginWithHost） */
+    setPluginHost(host: PluginHost): void;
+    /** 添加已知的 paneId */
+    addKnownPaneId(paneId: string): void;
+    /** 移除 paneId */
+    removeKnownPaneId(paneId: string): void;
+    /** 获取所有已知的 paneId */
+    getKnownPaneIds(): string[];
+    /** 注册渲染器插件 */
+    register(plugin: RendererPlugin | RendererPluginWithHost): void;
+    /** 移除渲染器插件 */
+    unregister(name: string): void;
+    /** 清空所有插件 */
+    clear(): void;
+    /**
+     * 归并两个已排序数组 O(n)
+     * 优先级相同时，pane 专属渲染器（a）先于 global 渲染器（b）
+     */
+    private mergeSorted;
+    /** 重建缓存（统一管理所有缓存逻辑） */
+    private rebuildCache;
+    /** 获取指定 pane 的渲染器（已缓存，无穿透） */
+    getRenderers(paneId: string): RendererPlugin[];
+    /** 渲染指定 pane（带错误隔离） */
+    render(paneId: string, context: RenderContext): RendererErrorEvent[];
+    /** 渲染指定名称的插件（带错误隔离，用于系统渲染器） */
+    renderPlugin(name: string, context: RenderContext): RendererErrorEvent[];
+    /** 启用/禁用渲染器（修改独立状态，不影响原始插件对象） */
+    setEnabled(name: string, enabled: boolean): void;
+    /** 更新配置（自动触发重绘） */
+    updateConfig(name: string, config: Record<string, unknown>): boolean;
+    /** 获取所有渲染器插件 */
+    getAllPlugins(): RendererPlugin[];
+    /** 获取指定渲染器 */
+    getPlugin<T extends RendererPlugin = RendererPlugin>(name: string): T | undefined;
+    /** 通知数据更新（跳过禁用的插件） */
+    notifyDataUpdate(data: unknown[], range: {
+        start: number;
+        end: number;
+    }): void;
+    /** 通知尺寸变化 */
+    notifyResize(paneId: string, pane: PaneInfo): void;
+}

package/dist/plugin/types.d.ts

@@ -0,0 +1,185 @@
+/**
+ * 插件系统核心类型定义
+ */
+/** 插件生命周期状态 */
+export declare enum PluginState {
+    Registered = "registered",
+    Installed = "installed",
+    Error = "error"
+}
+/** 插件配置 */
+export interface PluginConfig {
+    enabled?: boolean;
+    priority?: number;
+    [key: string]: unknown;
+}
+/** 插件元信息 */
+export interface PluginMeta {
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+}
+/** 插件接口 */
+export interface Plugin extends PluginMeta {
+    /** 安装插件 */
+    install(host: PluginHost, config?: Record<string, unknown>): void | Promise<void>;
+    /** 卸载插件 */
+    uninstall?(): void | Promise<void>;
+}
+/** 插件描述符（注册时使用） */
+export interface PluginDescriptor {
+    plugin: Plugin;
+    config?: PluginConfig;
+    state: PluginState;
+    error?: Error;
+}
+/** Hook 函数类型 */
+export type HookFn<T = unknown, R = unknown> = (context: T) => R | Promise<R>;
+/** Hook 描述符 */
+export interface HookDescriptor<T = unknown, R = unknown> {
+    name: string;
+    fn: HookFn<T, R>;
+    priority: number;
+}
+/** 事件处理器 */
+export type EventHandler<T = unknown> = (data: T) => void;
+/** 插件宿主接口（暴露给插件使用的 API） */
+export interface PluginHost {
+    /** 事件总线 */
+    readonly events: {
+        on<T = unknown>(event: string, handler: EventHandler<T>): void;
+        off<T = unknown>(event: string, handler: EventHandler<T>): void;
+        emit<T = unknown>(event: string, data: T): void;
+        once<T = unknown>(event: string, handler: EventHandler<T>): void;
+    };
+    /** Hook 系统 */
+    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[];
+    };
+    /** 获取配置 */
+    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;
+}
+/** Pane 信息接口 */
+export interface PaneInfo {
+    id: string;
+    top: number;
+    height: number;
+    yAxis: {
+        priceToY(price: number): number;
+        yToPrice(y: number): number;
+        getPaddingTop(): number;
+        getPaddingBottom(): number;
+    };
+    priceRange: {
+        maxPrice: number;
+        minPrice: number;
+    };
+}
+/**
+ * 创建 PaneInfo 的只读包装
+ *
+ * 设计决策：
+ * - 使用 Readonly<T> 类型标注而非 Object.freeze，避免热路径上的运行时开销
+ * - yAxis 方法通过闭包包装，隔离原始函数引用
+ * - 依赖团队代码规范约束插件行为，而非运行时强制
+ */
+export declare function wrapPaneInfo(pane: {
+    id: string;
+    top: number;
+    height: number;
+    yAxis: PaneInfo['yAxis'];
+    priceRange: PaneInfo['priceRange'];
+}): Readonly<PaneInfo>;
+/** 渲染上下文 */
+/** MarkerManager 接口（用于 RenderContext） */
+export interface MarkerManagerLike {
+    getCustomMarkers(): unknown[];
+    setCustomMarkerPosition(id: string, x: number, y: number, size: number, shape: string): void;
+}
+export interface RenderContext {
+    ctx: CanvasRenderingContext2D;
+    pane: PaneInfo;
+    data: unknown[];
+    range: {
+        start: number;
+        end: number;
+    };
+    scrollLeft: number;
+    kWidth: number;
+    kGap: number;
+    dpr: number;
+    paneWidth: number;
+    kLinePositions: number[];
+    markerManager?: MarkerManagerLike;
+    yAxisCtx?: CanvasRenderingContext2D;
+    xAxisCtx?: CanvasRenderingContext2D;
+    borderCtx?: CanvasRenderingContext2D;
+}
+/** 全局 Pane ID（渲染到所有 pane） */
+export declare const GLOBAL_PANE_ID: unique symbol;
+/** 优先级推荐范围 */
+export declare const RENDERER_PRIORITY: {
+    readonly SYSTEM_YAXIS: -20;
+    readonly SYSTEM_XAXIS: -20;
+    readonly BACKGROUND: 0;
+    readonly GRID: 10;
+    readonly INDICATOR: 30;
+    readonly MAIN: 50;
+    readonly OVERLAY: 80;
+    readonly FOREGROUND: 100;
+    readonly SYSTEM_BORDER: 120;
+    readonly SYSTEM_CROSSHAIR: 150;
+};
+/** 渲染器插件接口（独立定义，不继承 Plugin） */
+export interface RendererPlugin {
+    /** 唯一标识 */
+    readonly name: string;
+    /** 版本号 */
+    readonly version?: string;
+    /** 描述 */
+    readonly description?: string;
+    /** 调试用显示名称 */
+    readonly debugName?: string;
+    /** 渲染目标 pane（'main' | 'sub' | GLOBAL_PANE_ID 表示所有） */
+    paneId: string | symbol;
+    /** 渲染优先级（数字越大越后渲染） */
+    priority: number;
+    /** 是否启用（仅作为初始值，运行时状态由 Manager 管理） */
+    enabled?: boolean;
+    /**
+     * 是否为系统渲染器
+     * 系统渲染器不会通过 getRenderers() 返回，只能通过 renderPlugin() 单独渲染
+     * 用于时间轴、全局边框等需要单独控制渲染时机的场景
+     */
+    isSystem?: boolean;
+    /** 渲染方法 */
+    draw(context: RenderContext): void;
+    /** 数据更新时回调 */
+    onDataUpdate?(data: unknown[], range: {
+        start: number;
+        end: number;
+    }): void;
+    /** 容器尺寸变化时回调 */
+    onResize?(pane: PaneInfo): void;
+    /** 获取配置 */
+    getConfig?(): Record<string, unknown>;
+    /** 设置配置 */
+    setConfig?(config: Record<string, unknown>): void;
+    /** 卸载时清理资源 */
+    onUninstall?(): void;
+}
+/** 带插件系统能力的渲染器（可选） */
+export interface RendererPluginWithHost extends RendererPlugin {
+    /** 安装时获取 PluginHost 访问权限 */
+    onInstall?(host: PluginHost): void;
+}

package/dist/semantic/controller.d.ts

@@ -0,0 +1,29 @@
+import { Chart } from '../core/chart';
+import { SemanticChartConfig, ApplyResult } from './types';
+/** 状态事件类型 */
+export type SemanticEventType = 'config:loading' | 'config:ready' | 'config:error';
+export declare class SemanticChartController {
+    private chart;
+    private validator;
+    private events;
+    constructor(chart: Chart);
+    /**
+     * 应用语义化配置
+     */
+    applyConfig(config: SemanticChartConfig): Promise<ApplyResult>;
+    /**
+     * 订阅状态事件
+     */
+    on(event: SemanticEventType, handler: (data?: unknown) => void): void;
+    /**
+     * 取消订阅
+     */
+    off(event: SemanticEventType, handler: (data?: unknown) => void): void;
+    private doApplyConfig;
+    private applyIndicators;
+    private applyMAIndicator;
+    private applyBOLLIndicator;
+    private applySubIndicator;
+    private applyMarkers;
+    private applyChartOptions;
+}

package/dist/semantic/drawShape.d.ts

@@ -0,0 +1,14 @@
+import { MarkerShapeType, MarkerStyle, MarkerLabel } from './types';
+/**
+ * 绘制标记形状
+ */
+export declare function drawShape(ctx: CanvasRenderingContext2D, shape: MarkerShapeType, x: number, y: number, size: number, style: MarkerStyle): void;
+/**
+ * 绘制文本标注
+ * @param isAboveMarker 标记是否在K线上方（true → 文字在标记上方，false → 文字在标记下方）
+ */
+export declare function drawLabel(ctx: CanvasRenderingContext2D, label: MarkerLabel, x: number, y: number, markerSize: number, style: MarkerStyle, isAboveMarker?: boolean): void;
+/**
+ * 点击测试（判断点是否在形状内）
+ */
+export declare function hitTestShape(mx: number, my: number, shape: MarkerShapeType, x: number, y: number, size: number): boolean;

package/dist/semantic/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 语义化图表配置模块
+ * 用于 Agent 通过 JSON 控制图表渲染
+ */
+export type { SemanticChartConfig, DataConfig, IndicatorsConfig, MainIndicatorConfig, SubIndicatorConfig, SubIndicatorType, MAParams, BOLLParams, MarkersConfig, CustomMarker, MarkerShapeType, MarkerStyle, MarkerLabel, LegendConfig, ChartOptions, ThemeConfig, ApplyResult, ValidationResult, SecurityResult, } from './types';
+export { SemanticChartController, type SemanticEventType } from './controller';
+export { SemanticConfigValidator, sanitizeParams, sanitizeColor, validateColor, validateSymbol, } from './validator';
+export { drawShape, drawLabel, hitTestShape } from './drawShape';