@363045841yyt/klinechart 0.5.4 → 0.5.5

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

@@ -139,6 +139,57 @@ export declare function wrapPaneInfo(pane: {
     yAxis: PaneInfo['yAxis'];
     priceRange: PaneInfo['priceRange'];
 }): Readonly<PaneInfo>;
+/** Y轴标签（价格标签） */
+export interface YAxisLabel {
+    /** 关联的数据索引 */
+    dataIndex: number;
+    /** 价格值 */
+    price: number;
+    /** 标签在轴上的Y坐标（世界坐标，相对pane） */
+    y: number;
+    /** 标签样式覆盖 */
+    style?: {
+        bgColor?: string;
+        borderColor?: string;
+        textColor?: string;
+    };
+}
+/** X轴标签（时间标签） */
+export interface XAxisLabel {
+    /** 关联的数据索引 */
+    dataIndex: number;
+    /** 时间戳（毫秒） */
+    timestamp: number;
+    /** 标签在轴上的X坐标（世界坐标，未减去scrollLeft） */
+    x: number;
+    /** 标签样式覆盖 */
+    style?: {
+        bgColor?: string;
+        textColor?: string;
+    };
+}
+/** Y轴范围带（半透明填充区域） */
+export interface YAxisRange {
+    /** 范围上界Y坐标（相对pane，canvas方向：小值=上方） */
+    topY: number;
+    /** 范围下界Y坐标（相对pane，canvas方向：大值=下方） */
+    bottomY: number;
+    /** 填充颜色（hex 或 rgba） */
+    color: string;
+    /** 填充不透明度 */
+    opacity: number;
+}
+/** X轴范围带（半透明填充区域） */
+export interface XAxisRange {
+    /** 范围左界X坐标（世界坐标，未减去scrollLeft） */
+    leftX: number;
+    /** 范围右界X坐标（世界坐标，未减去scrollLeft） */
+    rightX: number;
+    /** 填充颜色（hex 或 rgba） */
+    color: string;
+    /** 填充不透明度 */
+    opacity: number;
+}
 /** 渲染上下文 */
 /** MarkerManager 接口（用于 RenderContext） */
 export interface MarkerManagerLike {
@@ -159,6 +210,13 @@ export interface RenderContext {
     dpr: number;
     paneWidth: number;
     kLinePositions: number[];
+    /** 每根K线柱中心的X坐标（物理像素对齐后，逻辑像素） */
+    kLineCenters: number[];
+    /** 每根K线对应柱的X/宽度（物理像素对齐后，逻辑像素），供柱状图使用 */
+    kBarRects: Array<{
+        x: number;
+        width: number;
+    }>;
     markerManager?: MarkerManagerLike;
     /** 十字线指向的 K 线索引（无十字线时为 null） */
     crosshairIndex?: number | null;
@@ -174,6 +232,16 @@ export interface RenderContext {
         plotWidth: number;
         plotHeight: number;
     };
+    /** 用户设置配置（渲染器只读） */
+    settings?: Record<string, boolean>;
+    /** 需要在Y轴上绘制的标签列表（由各类标记渲染器填充） */
+    yAxisLabels?: YAxisLabel[];
+    /** 需要在X轴上绘制的标签列表（由各类标记渲染器填充） */
+    xAxisLabels?: XAxisLabel[];
+    /** 需要在Y轴上绘制的范围带列表（由绘图渲染器填充，先于标签绘制） */
+    yAxisRanges?: YAxisRange[];
+    /** 需要在X轴上绘制的范围带列表（由绘图渲染器填充，先于标签绘制） */
+    xAxisRanges?: XAxisRange[];
 }
 export type DrawingAnchor = {
     id: string;
@@ -245,6 +313,7 @@ export type DrawingGeometry = {
         bottom: number;
     };
     meta?: Record<string, unknown>;
+    computedAnchors?: DrawingAnchor[];
 };
 export type DrawingComputeContext = {
     pane: PaneInfo;
@@ -255,6 +324,11 @@ export type DrawingComputeContext = {
         end: number;
     };
     kLinePositions: number[];
+    kLineCenters: number[];
+    kBarRects: Array<{
+        x: number;
+        width: number;
+    }>;
     kWidth: number;
     kGap: number;
     dpr: number;

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

@@ -127,3 +127,40 @@ export declare function drawCrosshairPriceLabel(ctx: CanvasRenderingContext2D, o
 export declare function drawLastPriceDashedLine(ctx: CanvasRenderingContext2D, opts: LastPriceLineOptions): void;
 /** 底部时间轴（X方向随 scrollLeft 变化） */
 export declare function drawTimeAxis(ctx: CanvasRenderingContext2D, opts: TimeAxisOptions): void;
+/** ============ 轴标签绘制函数 ============ */
+export interface AxisPriceLabelOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    priceY: number;
+    price: number;
+    dpr: number;
+    bgColor?: string;
+    borderColor?: string;
+    textColor?: string;
+    fontSize?: number;
+}
+/**
+ * 在右侧价格轴上绘制价格标签
+ * 与 drawCrosshairPriceLabel 类似，但简化了参数（价格直接传入，无需计算）
+ */
+export declare function drawAxisPriceLabel(ctx: CanvasRenderingContext2D, opts: AxisPriceLabelOptions): void;
+export interface AxisTimeLabelOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    labelX: number;
+    timestamp: number;
+    dpr: number;
+    bgColor?: string;
+    textColor?: string;
+    fontSize?: number;
+    paddingX?: number;
+}
+/**
+ * 在底部时间轴上绘制时间标签
+ * 与 drawCrosshairTimeLabel 类似，但 labelX 是屏幕坐标（已处理 scrollLeft）
+ */
+export declare function drawAxisTimeLabel(ctx: CanvasRenderingContext2D, opts: AxisTimeLabelOptions): void;

package/package.json

@@ -1,7 +1,35 @@
 {
   "name": "@363045841yyt/klinechart",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "license": "MIT",
+  "keywords": [
+    "kline-chart",
+    "candlestick-chart",
+    "financial-chart",
+    "tradingview",
+    "canvas",
+    "rendering-engine",
+    "resizeobserver",
+    "device-pixel-content-box",
+    "drawing-tools",
+    "chart-drawing",
+    "trend-line",
+    "fibonacci",
+    "high-performance",
+    "pixel-perfect",
+    "crisp-rendering",
+    "sharp-rendering",
+    "device-pixel-ratio",
+    "responsive",
+    "modern-ui",
+    "agent",
+    "ai-chart",
+    "visualization",
+    "quantitative-trading",
+    "technical-analysis",
+    "plugin-architecture",
+    "typescript"
+  ],
   "type": "module",
   "engines": {
     "node": "^20.19.0 || >=22.12.0"