@363045841yyt/klinechart-core 0.7.3

package/dist/engine/layout/pane.d.ts

@@ -0,0 +1,104 @@
+import type { KLineData } from '../../types/price';
+import type { PriceRange } from '../scale/price';
+import { PriceScale } from '../scale/priceScale';
+import type { MarkerManager } from '../marker/registry';
+import type { PaneCapabilities, PaneRole } from '../../plugin';
+/**
+ * 更新级别枚举 - 用于双层 Canvas 架构
+ * Main: 只更新主画布（K线、指标等静态内容）
+ * Overlay: 只更新覆盖层（十字线、Tooltip等动态内容）
+ * All: 更新所有层
+ */
+export declare enum UpdateLevel {
+    Main = "main",
+    Overlay = "overlay",
+    All = "all"
+}
+export type VisibleRange = {
+    start: number;
+    end: number;
+};
+export interface PaneInitOptions {
+    role?: PaneRole;
+    capabilities?: Partial<PaneCapabilities>;
+}
+/**
+ * Pane 级渲染器接口：在单个 pane 的坐标系中绘制内容
+ */
+export interface PaneRenderer {
+    /**
+     * 在指定 pane 坐标系中绘制内容
+     * @param ctx Canvas 绘图上下文，Chart 已执行 translate(0, pane.top)，y=0 对应 pane 顶部
+     * @param pane 当前 pane 实例
+     * @param data 全量 K 线数据
+     * @param range 当前视口可见的索引范围
+     * @param scrollLeft 滚动偏移量，renderer 内部如需 world 坐标需执行 ctx.translate(-scrollLeft, 0)
+     * @param kWidth K 线宽度
+     * @param kGap K 线间隔
+     * @param dpr 设备像素比
+     * @param paneWidth pane 宽度
+     * @param kLinePositions 可选，K 线起始 x 坐标数组（由 Chart 统一计算）
+     */
+    draw(args: {
+        ctx: CanvasRenderingContext2D;
+        pane: Pane;
+        data: KLineData[];
+        range: VisibleRange;
+        scrollLeft: number;
+        kWidth: number;
+        kGap: number;
+        dpr: number;
+        paneWidth: number;
+        kLinePositions: number[];
+        markerManager?: MarkerManager;
+    }): void;
+}
+/**
+ * Pane：代表一个"窗口区域"（主图 / 副图）
+ */
+export declare class Pane {
+    readonly id: string;
+    readonly role: PaneRole;
+    readonly capabilities: PaneCapabilities;
+    top: number;
+    height: number;
+    /** 当前 pane 的可视价格范围（用于右侧轴、以及渲染器内部） */
+    priceRange: PriceRange;
+    /** pane 独立 Y 轴 */
+    readonly yAxis: PriceScale;
+    /** 该 pane 的渲染器列表 */
+    readonly renderers: PaneRenderer[];
+    /**
+     * 创建 pane 实例
+     * @param id pane 标识符（例如 'main'、'sub'），用于在 Chart/Interaction 中识别 pane
+     */
+    constructor(id: string, options?: PaneInitOptions);
+    /**
+     * 设置 pane 的垂直布局
+     * @param top 相对 plotCanvas 顶部的偏移（逻辑像素）
+     * @param height pane 高度（逻辑像素）
+     */
+    setLayout(top: number, height: number): void;
+    /**
+     * 设置 Y 轴上下 padding
+     * @param top 上内边距，影响 priceToY 映射的顶部留白
+     * @param bottom 下内边距，影响 priceToY 映射的底部留白
+     */
+    setPadding(top: number, bottom: number): void;
+    /**
+     * 注册一个 pane 级渲染器
+     * @param renderer pane 级渲染器实例
+     */
+    addRenderer(renderer: PaneRenderer): void;
+    /**
+     * 根据当前可见索引区间更新 priceRange 并同步到 yAxis
+     * @param data 全量 K 线数据
+     * @param range 当前视口可见的索引范围（由 getVisibleRange 计算）
+     * @param indicatorRange 可选的指标极值范围，与K线极值合并
+     */
+    updateRange(data: KLineData[], range: VisibleRange, indicatorRange?: {
+        min: number;
+        max: number;
+    } | null): void;
+}
+//# sourceMappingURL=pane.d.ts.map

package/dist/engine/layout/pane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pane.d.ts","sourceRoot":"","sources":["../../../src/engine/layout/pane.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE9D;;;;;GAKG;AACH,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,GAAG,QAAQ;CACZ;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,YAAY,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;CACzC;AA2BD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,IAAI,EAAE;QACT,GAAG,EAAE,wBAAwB,CAAA;QAC7B,IAAI,EAAE,IAAI,CAAA;QACV,IAAI,EAAE,SAAS,EAAE,CAAA;QACjB,KAAK,EAAE,YAAY,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,EAAE,CAAA;QACxB,aAAa,CAAC,EAAE,aAAa,CAAA;KAC9B,GAAG,IAAI,CAAA;CACT;AAED;;GAEG;AACH,qBAAa,IAAI;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAA;IACvC,GAAG,SAAI;IACP,MAAM,SAAI;IAEV,qCAAqC;IACrC,UAAU,EAAE,UAAU,CAAiC;IAEvD,kBAAkB;IAClB,QAAQ,CAAC,KAAK,aAAmB;IAEjC,oBAAoB;IACpB,QAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,CAAK;IAEvC;;;OAGG;gBACS,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;IASrD;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMrC;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAItC;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,YAAY;IAIlC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAWzG"}

package/dist/engine/layout/pane.js

@@ -0,0 +1,107 @@
+import { getVisiblePriceRange } from '../viewport/viewport';
+import { PriceScale } from '../scale/priceScale';
+/**
+ * 更新级别枚举 - 用于双层 Canvas 架构
+ * Main: 只更新主画布（K线、指标等静态内容）
+ * Overlay: 只更新覆盖层（十字线、Tooltip等动态内容）
+ * All: 更新所有层
+ */
+export var UpdateLevel;
+(function (UpdateLevel) {
+    UpdateLevel["Main"] = "main";
+    UpdateLevel["Overlay"] = "overlay";
+    UpdateLevel["All"] = "all";
+})(UpdateLevel || (UpdateLevel = {}));
+function defaultCapabilitiesByRole(role) {
+    if (role === 'price') {
+        return {
+            showPriceAxisTicks: true,
+            showCrosshairPriceLabel: true,
+            candleHitTest: true,
+            supportsPriceTranslate: true,
+        };
+    }
+    if (role === 'indicator') {
+        return {
+            showPriceAxisTicks: false,
+            showCrosshairPriceLabel: true,
+            candleHitTest: false,
+            supportsPriceTranslate: true,
+        };
+    }
+    return {
+        showPriceAxisTicks: false,
+        showCrosshairPriceLabel: false,
+        candleHitTest: false,
+        supportsPriceTranslate: false,
+    };
+}
+/**
+ * Pane：代表一个"窗口区域"（主图 / 副图）
+ */
+export class Pane {
+    id;
+    role;
+    capabilities;
+    top = 0;
+    height = 0;
+    /** 当前 pane 的可视价格范围（用于右侧轴、以及渲染器内部） */
+    priceRange = { maxPrice: 100, minPrice: 0 };
+    /** pane 独立 Y 轴 */
+    yAxis = new PriceScale();
+    /** 该 pane 的渲染器列表 */
+    renderers = [];
+    /**
+     * 创建 pane 实例
+     * @param id pane 标识符（例如 'main'、'sub'），用于在 Chart/Interaction 中识别 pane
+     */
+    constructor(id, options = {}) {
+        this.id = id;
+        this.role = options.role ?? (id === 'main' ? 'price' : 'indicator');
+        this.capabilities = {
+            ...defaultCapabilitiesByRole(this.role),
+            ...(options.capabilities ?? {}),
+        };
+    }
+    /**
+     * 设置 pane 的垂直布局
+     * @param top 相对 plotCanvas 顶部的偏移（逻辑像素）
+     * @param height pane 高度（逻辑像素）
+     */
+    setLayout(top, height) {
+        this.top = top;
+        this.height = Math.max(1, height);
+        this.yAxis.setHeight(this.height);
+    }
+    /**
+     * 设置 Y 轴上下 padding
+     * @param top 上内边距，影响 priceToY 映射的顶部留白
+     * @param bottom 下内边距，影响 priceToY 映射的底部留白
+     */
+    setPadding(top, bottom) {
+        this.yAxis.setPadding(top, bottom);
+    }
+    /**
+     * 注册一个 pane 级渲染器
+     * @param renderer pane 级渲染器实例
+     */
+    addRenderer(renderer) {
+        this.renderers.push(renderer);
+    }
+    /**
+     * 根据当前可见索引区间更新 priceRange 并同步到 yAxis
+     * @param data 全量 K 线数据
+     * @param range 当前视口可见的索引范围（由 getVisibleRange 计算）
+     * @param indicatorRange 可选的指标极值范围，与K线极值合并
+     */
+    updateRange(data, range, indicatorRange) {
+        this.priceRange = getVisiblePriceRange(data, range.start, range.end);
+        // 如果有指标极值，合并到价格范围
+        if (indicatorRange && Number.isFinite(indicatorRange.min) && Number.isFinite(indicatorRange.max)) {
+            this.priceRange.minPrice = Math.min(this.priceRange.minPrice, indicatorRange.min);
+            this.priceRange.maxPrice = Math.max(this.priceRange.maxPrice, indicatorRange.max);
+        }
+        this.yAxis.setRange(this.priceRange);
+    }
+}
+//# sourceMappingURL=pane.js.map

package/dist/engine/layout/pane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pane.js","sourceRoot":"","sources":["../../../src/engine/layout/pane.ts"],"names":[],"mappings":"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"}

package/dist/engine/marker/registry.d.ts

@@ -0,0 +1,175 @@
+/**
+ * 标记类型
+ */
+export type MarkerShape = 'triangle' | 'circle';
+/**
+ * 标记状态
+ */
+export type MarkerState = 'normal' | 'hovered';
+/**
+ * 标记类型描述注册表
+ */
+export declare const MARKER_TYPE_DESCRIPTIONS: Record<string, string>;
+/**
+ * 注册新的标记类型描述
+ * @param type 标记类型
+ * @param description 描述文本
+ */
+export declare function registerMarkerTypeDescription(type: string, description: string): void;
+/**
+ * 标记实体
+ */
+export interface MarkerEntity {
+    id: string;
+    type: MarkerShape;
+    /** 标记类型描述 */
+    markerType: string;
+    /** 包围盒左上角 x 坐标 */
+    x: number;
+    /** 包围盒左上角 y 坐标 */
+    y: number;
+    /** 包围盒宽度 */
+    width: number;
+    /** 包围盒高度 */
+    height: number;
+    /** 对应的 K 线索引 */
+    dataIndex: number;
+    /** 额外元数据（如量价关系类型等） */
+    metadata: Record<string, any>;
+}
+/** 自定义标记形状 */
+export type CustomMarkerShape = 'arrow_up' | 'arrow_down' | 'flag' | 'circle' | 'rectangle' | 'diamond';
+/** 自定义标记样式 */
+export interface CustomMarkerStyle {
+    fillColor?: string;
+    strokeColor?: string;
+    textColor?: string;
+    size?: number;
+    lineWidth?: number;
+    opacity?: number;
+}
+/** 自定义标记标签 */
+export interface CustomMarkerLabel {
+    text: string;
+    position?: 'left' | 'right' | 'top' | 'bottom' | 'inside';
+    align?: 'start' | 'center' | 'end';
+    fontSize?: number;
+    offset?: {
+        x?: number;
+        y?: number;
+    };
+}
+/** 自定义标记实体 */
+export interface CustomMarkerEntity {
+    id: string;
+    /**
+     * 日期时间字符串
+     * - 日K/周K/月K: "YYYY-MM-DD"
+     * - 分钟K: "YYYY-MM-DD HH:mm"
+     */
+    date: string;
+    /** Unix 毫秒时间戳（由 date 解析生成，用于二分查找） */
+    timestamp: number;
+    shape: CustomMarkerShape;
+    groupKey?: string;
+    offset?: {
+        x?: number;
+        y?: number;
+    };
+    style?: CustomMarkerStyle;
+    label?: CustomMarkerLabel;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 标记 Manager
+ */
+export declare class MarkerManager {
+    /** 当前帧可见的标记集合（key: marker.id） */
+    private markers;
+    /** 当前 hover 的标记 ID（跨帧持久） */
+    private hoveredMarkerId;
+    /** 上一帧 hover 的标记 ID（用于触发 enter/leave 事件） */
+    private lastHoveredId;
+    /** 自定义标记集合 */
+    private customMarkers;
+    /** 自定义标记位置缓存（用于 hitTest） */
+    private customMarkerPositions;
+    /**
+     * 清空标记集合
+     * 注意：不清除 hoveredMarkerId，保持 hover 状态跨帧持久
+     */
+    clear(): void;
+    /**
+     * 注册标记
+     * @param marker 标记实体
+     */
+    register(marker: MarkerEntity): void;
+    /**
+     * 获取标记状态
+     * @param id 标记 ID
+     * @returns 'hovered' 或 'normal'
+     */
+    getState(id: string): MarkerState;
+    /**
+     * 命中测试
+     * @param x 鼠标 x 坐标
+     * @param y 鼠标 y 坐标
+     * @param padding 命中区域扩展（默认 3px）
+     * @returns 命中的标记，未命中返回 null
+     */
+    hitTest(x: number, y: number, padding?: number): MarkerEntity | null;
+    /**
+     * 设置 hover 状态
+     * @param id 标记 ID，null 表示清除 hover
+     */
+    setHover(id: string | null): void;
+    /**
+     * 验证 hover 状态
+     * 检查当前 hover 的标记是否仍在视口内，不在则清除
+     */
+    validateHoverState(): void;
+    /**
+     * 获取当前 hover 的标记实体
+     * @returns hover 的标记，不存在返回 null
+     */
+    getHoveredMarker(): MarkerEntity | null;
+    /**
+     * 获取上一帧 hover 的标记 ID
+     * 用于检测 hover 状态变化
+     * @returns 上一帧的 hover ID
+     */
+    getLastHoverId(): string | null;
+    /**
+     * 获取所有当前可见的标记
+     * @returns 标记数组
+     */
+    getAllMarkers(): MarkerEntity[];
+    /**
+     * 注册自定义标记
+     */
+    registerCustomMarker(marker: CustomMarkerEntity): void;
+    /**
+     * 批量设置自定义标记
+     */
+    setCustomMarkers(markers: CustomMarkerEntity[]): void;
+    /**
+     * 清空自定义标记（含位置缓存）
+     */
+    clearCustomMarkers(): void;
+    /**
+     * 获取所有自定义标记
+     */
+    getCustomMarkers(): CustomMarkerEntity[];
+    /**
+     * 记录自定义标记位置（render 时调用）
+     */
+    setCustomMarkerPosition(id: string, x: number, y: number, size: number, shape: CustomMarkerShape): void;
+    /**
+     * 自定义标记点击测试
+     * @param x 鼠标 x 坐标
+     * @param y 鼠标 y 坐标
+     * @returns 命中的自定义标记，未命中返回 null
+     */
+    hitTestCustomMarker(x: number, y: number): CustomMarkerEntity | null;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/engine/marker/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/engine/marker/registry.ts"],"names":[],"mappings":"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"}

package/dist/engine/marker/registry.js

@@ -0,0 +1,171 @@
+import { hitTestShape } from '../../semantic/drawShape';
+/**
+ * 标记类型描述注册表
+ */
+export const MARKER_TYPE_DESCRIPTIONS = {
+    'RISE_WITH_VOLUME': '量价齐升',
+    'RISE_WITHOUT_VOLUME': '量缩价升',
+    'FALL_WITH_VOLUME': '量价齐缩',
+    'FALL_WITHOUT_VOLUME': '量升价缩',
+};
+/**
+ * 注册新的标记类型描述
+ * @param type 标记类型
+ * @param description 描述文本
+ */
+export function registerMarkerTypeDescription(type, description) {
+    MARKER_TYPE_DESCRIPTIONS[type] = description;
+}
+/**
+ * 标记 Manager
+ */
+export class MarkerManager {
+    /** 当前帧可见的标记集合（key: marker.id） */
+    markers = new Map();
+    /** 当前 hover 的标记 ID（跨帧持久） */
+    hoveredMarkerId = null;
+    /** 上一帧 hover 的标记 ID（用于触发 enter/leave 事件） */
+    lastHoveredId = null;
+    // ============ 自定义标记状态管理 ============
+    /** 自定义标记集合 */
+    customMarkers = new Map();
+    /** 自定义标记位置缓存（用于 hitTest） */
+    customMarkerPositions = new Map();
+    /**
+     * 清空标记集合
+     * 注意：不清除 hoveredMarkerId，保持 hover 状态跨帧持久
+     */
+    clear() {
+        this.markers.clear();
+    }
+    /**
+     * 注册标记
+     * @param marker 标记实体
+     */
+    register(marker) {
+        this.markers.set(marker.id, marker);
+    }
+    /**
+     * 获取标记状态
+     * @param id 标记 ID
+     * @returns 'hovered' 或 'normal'
+     */
+    getState(id) {
+        if (this.hoveredMarkerId === id) {
+            return 'hovered';
+        }
+        return 'normal';
+    }
+    /**
+     * 命中测试
+     * @param x 鼠标 x 坐标
+     * @param y 鼠标 y 坐标
+     * @param padding 命中区域扩展（默认 3px）
+     * @returns 命中的标记，未命中返回 null
+     */
+    hitTest(x, y, padding = 3) {
+        for (const marker of this.markers.values()) {
+            if (x >= marker.x - padding && x <= marker.x + marker.width + padding &&
+                y >= marker.y - padding && y <= marker.y + marker.height + padding) {
+                return marker;
+            }
+        }
+        return null;
+    }
+    /**
+     * 设置 hover 状态
+     * @param id 标记 ID，null 表示清除 hover
+     */
+    setHover(id) {
+        this.hoveredMarkerId = id;
+        this.lastHoveredId = id;
+    }
+    /**
+     * 验证 hover 状态
+     * 检查当前 hover 的标记是否仍在视口内，不在则清除
+     */
+    validateHoverState() {
+        if (this.hoveredMarkerId !== null && !this.markers.has(this.hoveredMarkerId)) {
+            this.hoveredMarkerId = null;
+        }
+    }
+    /**
+     * 获取当前 hover 的标记实体
+     * @returns hover 的标记，不存在返回 null
+     */
+    getHoveredMarker() {
+        if (this.hoveredMarkerId !== null) {
+            return this.markers.get(this.hoveredMarkerId) || null;
+        }
+        return null;
+    }
+    /**
+     * 获取上一帧 hover 的标记 ID
+     * 用于检测 hover 状态变化
+     * @returns 上一帧的 hover ID
+     */
+    getLastHoverId() {
+        return this.lastHoveredId;
+    }
+    /**
+     * 获取所有当前可见的标记
+     * @returns 标记数组
+     */
+    getAllMarkers() {
+        return Array.from(this.markers.values());
+    }
+    // ============ 自定义标记管理方法 ============
+    /**
+     * 注册自定义标记
+     */
+    registerCustomMarker(marker) {
+        this.customMarkers.set(marker.id, marker);
+    }
+    /**
+     * 批量设置自定义标记
+     */
+    setCustomMarkers(markers) {
+        this.clearCustomMarkers();
+        for (const marker of markers) {
+            this.customMarkers.set(marker.id, marker);
+        }
+    }
+    /**
+     * 清空自定义标记（含位置缓存）
+     */
+    clearCustomMarkers() {
+        this.customMarkers.clear();
+        this.customMarkerPositions.clear();
+    }
+    /**
+     * 获取所有自定义标记
+     */
+    getCustomMarkers() {
+        return Array.from(this.customMarkers.values());
+    }
+    /**
+     * 记录自定义标记位置（render 时调用）
+     */
+    setCustomMarkerPosition(id, x, y, size, shape) {
+        this.customMarkerPositions.set(id, { x, y, size, shape });
+    }
+    /**
+     * 自定义标记点击测试
+     * @param x 鼠标 x 坐标
+     * @param y 鼠标 y 坐标
+     * @returns 命中的自定义标记，未命中返回 null
+     */
+    hitTestCustomMarker(x, y) {
+        for (const marker of this.customMarkers.values()) {
+            const pos = this.customMarkerPositions.get(marker.id);
+            if (pos) {
+                // 使用实际渲染的大小进行命中测试
+                if (hitTestShape(x, y, pos.shape, pos.x, pos.y, pos.size)) {
+                    return marker;
+                }
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/engine/marker/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/engine/marker/registry.ts"],"names":[],"mappings":"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"}

package/dist/engine/paneRenderer.d.ts

@@ -0,0 +1,46 @@
+import { CandleWebGLSurface, LineWebGLSurface } from './renderers/webgl/candleSurface';
+import type { SharedWebGLSurface, WebGLRegion } from './renderers/webgl/sharedWebGLSurface';
+export type PaneRendererDom = {
+    mainCanvas: HTMLCanvasElement;
+    overlayCanvas: HTMLCanvasElement;
+    yAxisCanvas: HTMLCanvasElement;
+};
+export type PaneRendererContexts = {
+    mainCtx: CanvasRenderingContext2D | null;
+    overlayCtx: CanvasRenderingContext2D | null;
+    yAxisCtx: CanvasRenderingContext2D | null;
+};
+export type PaneRendererOptions = {
+    rightAxisWidth: number;
+    yPaddingPx: number;
+    priceLabelWidth?: number;
+};
+export type PaneRendererWebGLHandles = {
+    candleSurface: CandleWebGLSurface | null;
+    lineSurface: LineWebGLSurface | null;
+};
+export declare class PaneRenderer {
+    private dom;
+    private pane;
+    private opt;
+    private contexts;
+    private webgl;
+    constructor(dom: PaneRendererDom, pane: import('./layout/pane').Pane, opt: PaneRendererOptions, sharedWebGLSurface: SharedWebGLSurface);
+    /** 获取关联的 Pane 实例 */
+    getPane(): import('./layout/pane').Pane;
+    /** 获取 DOM 元素 */
+    getDom(): PaneRendererDom;
+    getContexts(): PaneRendererContexts;
+    getWebGL(): PaneRendererWebGLHandles;
+    setWebGLRegion(region: WebGLRegion): void;
+    /**
+     * 调整 Canvas 尺寸
+     * @param width pane 宽度（逻辑像素）
+     * @param height pane 高度（逻辑像素）
+     * @param dpr 设备像素比
+     */
+    resize(width: number, height: number, dpr: number): void;
+    /** 销毁 PaneRenderer 实例 */
+    destroy(): void;
+}
+//# sourceMappingURL=paneRenderer.d.ts.map

package/dist/engine/paneRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paneRenderer.d.ts","sourceRoot":"","sources":["../../src/engine/paneRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AACtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAA;AAE3F,MAAM,MAAM,eAAe,GAAG;IAC1B,UAAU,EAAE,iBAAiB,CAAA;IAC7B,aAAa,EAAE,iBAAiB,CAAA;IAChC,WAAW,EAAE,iBAAiB,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAC/B,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAA;IACxC,UAAU,EAAE,wBAAwB,GAAG,IAAI,CAAA;IAC3C,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACnC,aAAa,EAAE,kBAAkB,GAAG,IAAI,CAAA;IACxC,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACvC,CAAA;AAOD,qBAAa,YAAY;IACrB,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,KAAK,CAA0B;gBAGnC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,OAAO,eAAe,EAAE,IAAI,EAClC,GAAG,EAAE,mBAAmB,EACxB,kBAAkB,EAAE,kBAAkB;IAc1C,oBAAoB;IACpB,OAAO,IAAI,OAAO,eAAe,EAAE,IAAI;IAIvC,gBAAgB;IAChB,MAAM,IAAI,eAAe;IAIzB,WAAW,IAAI,oBAAoB;IAWnC,QAAQ,IAAI,wBAAwB;IAIpC,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKzC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAsEjD,yBAAyB;IACzB,OAAO;CAKV"}