@baron1996/klinecharts-adapter 0.1.1 → 0.2.2

package/dist/conversion/overlays.js

@@ -81,6 +81,7 @@ function toPoints(overlay) {
             return [structuredClone(overlay.point ?? {})];
         case 'rectangle':
         case 'arrow':
+        case 'priceMeasurement':
             return [structuredClone(overlay.start ?? {}), structuredClone(overlay.end ?? {})];
     }
 }
@@ -278,6 +279,7 @@ export function fromEngineOverlay(engine, source, idMap, path, pricePrecision) {
             };
         case 'rectangle':
         case 'arrow':
+        case 'priceMeasurement':
             return {
                 ...base,
                 start: readPoint(0, true, true, `${path}/start`),

package/dist/conversion/panes.d.ts

@@ -1,6 +1,8 @@
-import type { ChartScene } from '@baron1996/kline-scene-schema';
+import type { ChartScene, YAxis as SceneYAxis } from '@baron1996/kline-scene-schema';
 import type { Chart } from 'klinecharts';
 import type { EngineIdMap } from './id-map.js';
+/** 原子提交 Scene 前，将单条轴映射到引擎的正式 normal/logarithm 名称。 */
+export declare function overrideSceneYAxis(chart: Chart, idMap: EngineIdMap, axis: SceneYAxis, paneId: string, path: string): void;
 /** 按 Scene 顺序创建 Pane、Y 轴和指标，并核对每个映射。 */
 export declare function applyPanes(scene: ChartScene, chart: Chart, idMap: EngineIdMap): void;
 //# sourceMappingURL=panes.d.ts.map

package/dist/conversion/panes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panes.d.ts","sourceRoot":"","sources":["../../src/conversion/panes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAuB,MAAM,+BAA+B,CAAC;AAErF,OAAO,KAAK,EAAE,KAAK,EAAS,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA8B/C,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAuEpF"}
+{"version":3,"file":"panes.d.ts","sourceRoot":"","sources":["../../src/conversion/panes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAErF,OAAO,KAAK,EAAE,KAAK,EAAS,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA8B/C,qDAAqD;AACrD,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACV,IAAI,CAIN;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAuEpF"}

package/dist/conversion/panes.js

@@ -5,7 +5,7 @@ function axisOverride(axis, enginePaneId, engineAxisId) {
     return {
         id: engineAxisId,
         paneId: enginePaneId,
-        name: 'normal',
+        name: axis.scale === 'logarithmic' ? 'logarithm' : 'normal',
         reverse: axis.reverse,
         inside: axis.inside,
         position: axis.position,
@@ -17,6 +17,12 @@ function axisOverride(axis, enginePaneId, engineAxisId) {
         needWidget: true,
     };
 }
+/** 原子提交 Scene 前，将单条轴映射到引擎的正式 normal/logarithm 名称。 */
+export function overrideSceneYAxis(chart, idMap, axis, paneId, path) {
+    const enginePaneId = requireMappedId(idMap.paneToEngine, paneId, `${path}/paneId`, 'Pane');
+    const engineAxisId = requireMappedId(idMap.yAxisToEngine, axis.id, `${path}/id`, 'Y-axis');
+    chart.overrideYAxis(axisOverride(axis, enginePaneId, engineAxisId));
+}
 /** 按 Scene 顺序创建 Pane、Y 轴和指标，并核对每个映射。 */
 export function applyPanes(scene, chart, idMap) {
     for (let paneIndex = 0; paneIndex < scene.panes.length; paneIndex++) {

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AASzC,MAAM,MAAM,iBAAiB,GAAG,cAAc,aAAa,CAAC,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACnC;AAiBD,qCAAqC;AACrC,wBAAsB,YAAY,CACjC,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,CAAC,CA+BvB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAUzC,MAAM,MAAM,iBAAiB,GAAG,cAAc,aAAa,CAAC,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACnC;AAmBD,qCAAqC;AACrC,wBAAsB,YAAY,CACjC,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,CAAC,CA+BvB"}

package/dist/engine.js

@@ -1,13 +1,13 @@
 import { SceneError } from '@baron1996/kline-scene-schema';
 import { toKLineChartsOptions } from './conversion/chart-options.js';
 import { createStaticDataLoader } from './static-data-loader.js';
-import { KLINECHARTS_ENGINE_VERSION, KLINECHARTS_RUNTIME_VERSION, } from './version.js';
+import { KLINECHARTS_ENGINE_VERSION, KLINECHARTS_RUNTIME_VERSION, SUPPORTED_KLINECHARTS_RUNTIME_VERSIONS, } from './version.js';
 function assertRuntimeIdentity(scene, actualEngineVersion) {
     if (scene.runtime.engine !== 'klinecharts' ||
         scene.runtime.engineVersion !== KLINECHARTS_ENGINE_VERSION ||
         actualEngineVersion !== KLINECHARTS_ENGINE_VERSION ||
-        scene.runtime.runtimeVersion !== KLINECHARTS_RUNTIME_VERSION) {
-        throw new SceneError('ENGINE_VERSION_MISMATCH', '/runtime', `Expected klinecharts ${KLINECHARTS_ENGINE_VERSION} and Runtime ${KLINECHARTS_RUNTIME_VERSION}; received engine ${actualEngineVersion}.`);
+        !SUPPORTED_KLINECHARTS_RUNTIME_VERSIONS.includes(scene.runtime.runtimeVersion)) {
+        throw new SceneError('ENGINE_VERSION_MISMATCH', '/runtime', `Expected klinecharts ${KLINECHARTS_ENGINE_VERSION} and a supported Runtime through ${KLINECHARTS_RUNTIME_VERSION}; received engine ${actualEngineVersion}.`);
     }
 }
 /** 按固定顺序创建并初始化唯一的 KLineCharts 引擎。 */

package/dist/extensions/price-measurement.d.ts

@@ -0,0 +1,13 @@
+import type { registerOverlay } from 'klinecharts';
+type KLineOverlayTemplate = Parameters<typeof registerOverlay>[0];
+export interface PriceMeasurementDisplay {
+    readonly absoluteChange: number;
+    readonly percentageChange: number;
+    readonly label: string;
+}
+/** 仅派生显示值；绝对变化、百分比和 label 永不写入 Scene。 */
+export declare function derivePriceMeasurementDisplay(startValue: number, endValue: number, pricePrecision: number): PriceMeasurementDisplay;
+/** 量度工具只从两个引擎数据点派生显示文字，派生值不进入 Scene。 */
+export declare const priceMeasurementOverlay: KLineOverlayTemplate;
+export {};
+//# sourceMappingURL=price-measurement.d.ts.map

package/dist/extensions/price-measurement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-measurement.d.ts","sourceRoot":"","sources":["../../src/extensions/price-measurement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAOlE,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,yCAAyC;AACzC,wBAAgB,6BAA6B,CAC5C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACpB,uBAAuB,CAsBzB;AAED,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,EAAE,oBA6CrC,CAAC"}

package/dist/extensions/price-measurement.js

@@ -0,0 +1,64 @@
+import { SceneError } from '@baron1996/kline-scene-schema';
+function signedFixed(value, precision) {
+    const prefix = value > 0 ? '+' : '';
+    return `${prefix}${value.toFixed(precision)}`;
+}
+/** 仅派生显示值；绝对变化、百分比和 label 永不写入 Scene。 */
+export function derivePriceMeasurementDisplay(startValue, endValue, pricePrecision) {
+    if (!Number.isFinite(startValue) ||
+        !Number.isFinite(endValue) ||
+        startValue <= 0 ||
+        !Number.isInteger(pricePrecision) ||
+        pricePrecision < 0 ||
+        pricePrecision > 16) {
+        throw new SceneError('SCENE_SCHEMA_INVALID', '/overlays/priceMeasurement', 'Price measurement display inputs must be positive finite prices and a 0..16 precision.');
+    }
+    const absoluteChange = endValue - startValue;
+    const percentageChange = absoluteChange / startValue * 100;
+    return {
+        absoluteChange,
+        percentageChange,
+        label: `${signedFixed(absoluteChange, pricePrecision)} (${signedFixed(percentageChange, 2)}%)`,
+    };
+}
+/** 量度工具只从两个引擎数据点派生显示文字，派生值不进入 Scene。 */
+export const priceMeasurementOverlay = {
+    name: 'priceMeasurement',
+    totalStep: 3,
+    needDefaultPointFigure: true,
+    needDefaultXAxisFigure: true,
+    needDefaultYAxisFigure: true,
+    createPointFigures: ({ chart, coordinates, overlay }) => {
+        const startCoordinate = coordinates[0];
+        const endCoordinate = coordinates[1];
+        const startPoint = overlay.points[0];
+        const endPoint = overlay.points[1];
+        if (startCoordinate === undefined ||
+            endCoordinate === undefined ||
+            startPoint?.value === undefined ||
+            endPoint?.value === undefined) {
+            return [];
+        }
+        const pricePrecision = chart.getSymbol()?.pricePrecision ?? 0;
+        const { label } = derivePriceMeasurementDisplay(startPoint.value, endPoint.value, pricePrecision);
+        return [
+            {
+                key: 'measurement-body',
+                type: 'line',
+                attrs: { coordinates: [startCoordinate, endCoordinate] },
+            },
+            {
+                key: 'measurement-label',
+                type: 'text',
+                attrs: {
+                    x: (startCoordinate.x + endCoordinate.x) / 2 + 8,
+                    y: (startCoordinate.y + endCoordinate.y) / 2 - 8,
+                    text: label,
+                    align: 'left',
+                    baseline: 'bottom',
+                },
+                ignoreEvent: true,
+            },
+        ];
+    },
+};

package/dist/extensions/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/extensions/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQnD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,KAAK,eAAe,GAAG,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAYhE,kCAAkC;AAClC,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAQvE;AAED,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/extensions/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AASnD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,KAAK,eAAe,GAAG,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAahE,kCAAkC;AAClC,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAQvE;AAED,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD"}

package/dist/extensions/register.js

@@ -2,8 +2,10 @@ import { arrowOverlay } from './arrow.js';
 import { calloutOverlay } from './callout.js';
 import { crossLineOverlay } from './cross-line.js';
 import { rectangleOverlay } from './rectangle.js';
+import { priceMeasurementOverlay } from './price-measurement.js';
 import { textOverlay } from './text.js';
 const projectExtensions = [
+    priceMeasurementOverlay,
     rectangleOverlay,
     arrowOverlay,
     crossLineOverlay,

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export * from './adapter.js';
 export * from './errors.js';
 export * from './extensions/register.js';
+export * from './interaction/dragging.js';
+export * from './interaction/hit-testing.js';
 export * from './registry/indicators.js';
 export * from './registry/overlays.js';
 export * from './static-data-loader.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -1,6 +1,8 @@
 export * from './adapter.js';
 export * from './errors.js';
 export * from './extensions/register.js';
+export * from './interaction/dragging.js';
+export * from './interaction/hit-testing.js';
 export * from './registry/indicators.js';
 export * from './registry/overlays.js';
 export * from './static-data-loader.js';

package/dist/interaction/dragging.d.ts

@@ -0,0 +1,12 @@
+import type { SceneOverlay } from '@baron1996/kline-scene-schema';
+export interface DragDataPoint {
+    readonly dataIndex: number;
+    readonly value: number;
+}
+export interface DragTarget {
+    readonly target: 'anchor' | 'body';
+    readonly anchorIndex: number | null;
+}
+/** 根据冻结的绝对平移语义构造未提交候选，不修改输入 Overlay。 */
+export declare function createDragCandidate(before: SceneOverlay, dragTarget: DragTarget, origin: DragDataPoint, current: DragDataPoint, timestamps: readonly number[], pricePrecision: number): SceneOverlay;
+//# sourceMappingURL=dragging.d.ts.map

package/dist/interaction/dragging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dragging.d.ts","sourceRoot":"","sources":["../../src/interaction/dragging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAKlE,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAyBD,wCAAwC;AACxC,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,cAAc,EAAE,MAAM,GACpB,YAAY,CAgFd"}

package/dist/interaction/dragging.js

@@ -0,0 +1,71 @@
+import { SceneError } from '@baron1996/kline-scene-schema';
+import { normalizePriceValue } from '../conversion/price.js';
+function requireDataIndex(value, path) {
+    if (!Number.isFinite(value)) {
+        throw new SceneError('INVALID_REFERENCE', path, 'Drag data index must be finite.');
+    }
+    return Math.round(value);
+}
+function requireTimestamp(timestamps, index, path) {
+    const timestamp = timestamps[index];
+    if (timestamp === undefined) {
+        throw new SceneError('INVALID_REFERENCE', path, 'Drag candidate must remain on an embedded market-data bar.');
+    }
+    return timestamp;
+}
+/** 根据冻结的绝对平移语义构造未提交候选，不修改输入 Overlay。 */
+export function createDragCandidate(before, dragTarget, origin, current, timestamps, pricePrecision) {
+    const deltaValue = current.value - origin.value;
+    if (!Number.isFinite(deltaValue)) {
+        throw new SceneError('SCENE_SCHEMA_INVALID', '/overlays', 'Drag price delta must be finite.');
+    }
+    if (before.type === 'horizontalStraightLine') {
+        const anchor = before.anchor;
+        if (anchor === undefined || !('value' in anchor)) {
+            throw new SceneError('SCENE_SCHEMA_INVALID', '/overlays/anchor', 'Missing price anchor.');
+        }
+        return {
+            ...structuredClone(before),
+            anchor: {
+                value: normalizePriceValue(anchor.value + deltaValue, pricePrecision, '/overlays/anchor/value'),
+            },
+        };
+    }
+    if (before.type !== 'priceMeasurement' || before.start === undefined || before.end === undefined) {
+        throw new SceneError('SCENE_SCHEMA_INVALID', '/overlays/type', 'Controlled M2 dragging only supports horizontalStraightLine and priceMeasurement.');
+    }
+    const candidate = structuredClone(before);
+    if (dragTarget.target === 'anchor') {
+        if (dragTarget.anchorIndex !== 0 && dragTarget.anchorIndex !== 1) {
+            throw new SceneError('INVALID_REFERENCE', '/overlays/anchorIndex', 'Invalid anchor index.');
+        }
+        const index = requireDataIndex(current.dataIndex, '/overlays/anchor/dataIndex');
+        const point = {
+            timestamp: requireTimestamp(timestamps, index, '/overlays/anchor/timestamp'),
+            value: normalizePriceValue(current.value, pricePrecision, '/overlays/anchor/value'),
+        };
+        if (dragTarget.anchorIndex === 0) {
+            candidate.start = point;
+        }
+        else {
+            candidate.end = point;
+        }
+        return candidate;
+    }
+    const startIndex = timestamps.indexOf(before.start.timestamp);
+    const endIndex = timestamps.indexOf(before.end.timestamp);
+    if (startIndex < 0 || endIndex < 0) {
+        throw new SceneError('INVALID_REFERENCE', '/overlays', 'priceMeasurement endpoints must reference embedded bars before dragging.');
+    }
+    const deltaIndex = requireDataIndex(current.dataIndex, '/overlays/body/dataIndex') -
+        requireDataIndex(origin.dataIndex, '/overlays/body/originDataIndex');
+    candidate.start = {
+        timestamp: requireTimestamp(timestamps, startIndex + deltaIndex, '/overlays/start/timestamp'),
+        value: normalizePriceValue(before.start.value + deltaValue, pricePrecision, '/overlays/start/value'),
+    };
+    candidate.end = {
+        timestamp: requireTimestamp(timestamps, endIndex + deltaIndex, '/overlays/end/timestamp'),
+        value: normalizePriceValue(before.end.value + deltaValue, pricePrecision, '/overlays/end/value'),
+    };
+    return candidate;
+}

package/dist/interaction/hit-testing.d.ts

@@ -0,0 +1,26 @@
+export declare const OVERLAY_BODY_HIT_THRESHOLD_CSS_PX = 12;
+export declare const OVERLAY_ANCHOR_HIT_THRESHOLD_CSS_PX = 14;
+export interface PixelCoordinate {
+    readonly x: number;
+    readonly y: number;
+}
+export interface OverlayPixelGeometry {
+    readonly overlayId: string;
+    readonly sceneIndex: number;
+    readonly zLevel: number;
+    readonly locked: boolean;
+    readonly anchors: readonly PixelCoordinate[];
+    readonly bodySegments: readonly (readonly [PixelCoordinate, PixelCoordinate])[];
+}
+export interface OverlayHitResult {
+    readonly overlayId: string;
+    readonly target: 'anchor' | 'body';
+    readonly anchorIndex: number | null;
+    readonly locked: boolean;
+}
+/**
+ * 按冻结契约在 CSS 像素坐标中执行命中测试。
+ * 锚点全局优先于主体；同类再按 zLevel、Scene 后序和锚点低索引排序。
+ */
+export declare function hitTestOverlayGeometries(point: PixelCoordinate, geometries: readonly OverlayPixelGeometry[]): OverlayHitResult | null;
+//# sourceMappingURL=hit-testing.d.ts.map

package/dist/interaction/hit-testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hit-testing.d.ts","sourceRoot":"","sources":["../../src/interaction/hit-testing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iCAAiC,KAAK,CAAC;AACpD,eAAO,MAAM,mCAAmC,KAAK,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;CAChF;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACzB;AAmDD;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,SAAS,oBAAoB,EAAE,GACzC,gBAAgB,GAAG,IAAI,CAgDzB"}

package/dist/interaction/hit-testing.js

@@ -0,0 +1,86 @@
+export const OVERLAY_BODY_HIT_THRESHOLD_CSS_PX = 12;
+export const OVERLAY_ANCHOR_HIT_THRESHOLD_CSS_PX = 14;
+function coordinateDistance(left, right) {
+    return Math.hypot(left.x - right.x, left.y - right.y);
+}
+function segmentDistance(point, start, end) {
+    const dx = end.x - start.x;
+    const dy = end.y - start.y;
+    const lengthSquared = dx * dx + dy * dy;
+    if (lengthSquared === 0) {
+        return coordinateDistance(point, start);
+    }
+    const projection = Math.max(0, Math.min(1, ((point.x - start.x) * dx + (point.y - start.y) * dy) / lengthSquared));
+    return coordinateDistance(point, {
+        x: start.x + projection * dx,
+        y: start.y + projection * dy,
+    });
+}
+function compareHits(left, right) {
+    if (left.zLevel !== right.zLevel) {
+        return right.zLevel - left.zLevel;
+    }
+    if (left.sceneIndex !== right.sceneIndex) {
+        return right.sceneIndex - left.sceneIndex;
+    }
+    if (left.overlayId === right.overlayId &&
+        left.anchorIndex !== null &&
+        right.anchorIndex !== null &&
+        left.anchorIndex !== right.anchorIndex) {
+        return left.anchorIndex - right.anchorIndex;
+    }
+    return left.distance - right.distance;
+}
+/**
+ * 按冻结契约在 CSS 像素坐标中执行命中测试。
+ * 锚点全局优先于主体；同类再按 zLevel、Scene 后序和锚点低索引排序。
+ */
+export function hitTestOverlayGeometries(point, geometries) {
+    const anchorHits = [];
+    const bodyHits = [];
+    for (const geometry of geometries) {
+        for (let anchorIndex = 0; anchorIndex < geometry.anchors.length; anchorIndex++) {
+            const anchor = geometry.anchors[anchorIndex];
+            if (anchor === undefined) {
+                continue;
+            }
+            const distance = coordinateDistance(point, anchor);
+            if (distance <= OVERLAY_ANCHOR_HIT_THRESHOLD_CSS_PX) {
+                anchorHits.push({
+                    overlayId: geometry.overlayId,
+                    target: 'anchor',
+                    anchorIndex,
+                    locked: geometry.locked,
+                    distance,
+                    sceneIndex: geometry.sceneIndex,
+                    zLevel: geometry.zLevel,
+                });
+            }
+        }
+        let distance = Number.POSITIVE_INFINITY;
+        for (const [start, end] of geometry.bodySegments) {
+            distance = Math.min(distance, segmentDistance(point, start, end));
+        }
+        if (distance <= OVERLAY_BODY_HIT_THRESHOLD_CSS_PX) {
+            bodyHits.push({
+                overlayId: geometry.overlayId,
+                target: 'body',
+                anchorIndex: null,
+                locked: geometry.locked,
+                distance,
+                sceneIndex: geometry.sceneIndex,
+                zLevel: geometry.zLevel,
+            });
+        }
+    }
+    const winner = (anchorHits.length > 0 ? anchorHits : bodyHits).sort(compareHits)[0];
+    if (winner === undefined) {
+        return null;
+    }
+    return {
+        overlayId: winner.overlayId,
+        target: winner.target,
+        anchorIndex: winner.anchorIndex,
+        locked: winner.locked,
+    };
+}

package/dist/interaction/selection-arbitration.d.ts

@@ -0,0 +1,6 @@
+import { type OverlayPixelGeometry, type PixelCoordinate } from './hit-testing.js';
+/**
+ * 仅忽略引擎旧命中区域产生的取消选择：回调坐标必须仍命中当前选中 Overlay 的规范几何。
+ */
+export declare function shouldIgnoreStaleOverlayDeselection(selectedOverlayId: string | null, deselectedOverlayId: string, coordinate: PixelCoordinate | undefined, currentGeometries: readonly OverlayPixelGeometry[]): boolean;
+//# sourceMappingURL=selection-arbitration.d.ts.map

package/dist/interaction/selection-arbitration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-arbitration.d.ts","sourceRoot":"","sources":["../../src/interaction/selection-arbitration.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,wBAAgB,mCAAmC,CAClD,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,mBAAmB,EAAE,MAAM,EAC3B,UAAU,EAAE,eAAe,GAAG,SAAS,EACvC,iBAAiB,EAAE,SAAS,oBAAoB,EAAE,GAChD,OAAO,CAKT"}

package/dist/interaction/selection-arbitration.js

@@ -0,0 +1,10 @@
+import { hitTestOverlayGeometries, } from './hit-testing.js';
+/**
+ * 仅忽略引擎旧命中区域产生的取消选择：回调坐标必须仍命中当前选中 Overlay 的规范几何。
+ */
+export function shouldIgnoreStaleOverlayDeselection(selectedOverlayId, deselectedOverlayId, coordinate, currentGeometries) {
+    if (selectedOverlayId !== deselectedOverlayId || coordinate === undefined) {
+        return false;
+    }
+    return hitTestOverlayGeometries(coordinate, currentGeometries)?.overlayId === deselectedOverlayId;
+}

package/dist/registry/overlays.d.ts

@@ -1,6 +1,6 @@
 import type { SceneOverlay } from '@baron1996/kline-scene-schema';
 export declare const BUILT_IN_OVERLAYS: readonly ["horizontalRayLine", "horizontalSegment", "horizontalStraightLine", "verticalRayLine", "verticalSegment", "verticalStraightLine", "rayLine", "segment", "straightLine", "priceLine", "priceChannelLine", "parallelStraightLine", "fibonacciLine", "brush", "simpleAnnotation", "simpleTag"];
-export declare const PROJECT_OVERLAYS: readonly ["rectangle", "arrow", "crossLine", "callout", "text"];
-export declare const SUPPORTED_OVERLAYS: readonly ["horizontalRayLine", "horizontalSegment", "horizontalStraightLine", "verticalRayLine", "verticalSegment", "verticalStraightLine", "rayLine", "segment", "straightLine", "priceLine", "priceChannelLine", "parallelStraightLine", "fibonacciLine", "brush", "simpleAnnotation", "simpleTag", "rectangle", "arrow", "crossLine", "callout", "text"];
+export declare const PROJECT_OVERLAYS: readonly ["priceMeasurement", "rectangle", "arrow", "crossLine", "callout", "text"];
+export declare const SUPPORTED_OVERLAYS: readonly ["horizontalRayLine", "horizontalSegment", "horizontalStraightLine", "verticalRayLine", "verticalSegment", "verticalStraightLine", "rayLine", "segment", "straightLine", "priceLine", "priceChannelLine", "parallelStraightLine", "fibonacciLine", "brush", "simpleAnnotation", "simpleTag", "priceMeasurement", "rectangle", "arrow", "crossLine", "callout", "text"];
 export declare function isSupportedOverlay(name: string): name is SceneOverlay['type'];
 //# sourceMappingURL=overlays.d.ts.map

package/dist/registry/overlays.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlays.d.ts","sourceRoot":"","sources":["../../src/registry/overlays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,eAAO,MAAM,iBAAiB,uSAiBsB,CAAC;AAErD,eAAO,MAAM,gBAAgB,iEAMuB,CAAC;AAErD,eAAO,MAAM,kBAAkB,6VAGqB,CAAC;AAIrD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,YAAY,CAAC,MAAM,CAAC,CAE7E"}
+{"version":3,"file":"overlays.d.ts","sourceRoot":"","sources":["../../src/registry/overlays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,eAAO,MAAM,iBAAiB,uSAiBsB,CAAC;AAErD,eAAO,MAAM,gBAAgB,qFAOuB,CAAC;AAErD,eAAO,MAAM,kBAAkB,iXAGqB,CAAC;AAIrD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,YAAY,CAAC,MAAM,CAAC,CAE7E"}

package/dist/registry/overlays.js

@@ -17,6 +17,7 @@ export const BUILT_IN_OVERLAYS = [
     'simpleTag',
 ];
 export const PROJECT_OVERLAYS = [
+    'priceMeasurement',
     'rectangle',
     'arrow',
     'crossLine',

package/dist/version.d.ts

@@ -1,7 +1,8 @@
 /** Adapter 包版本。 */
-export declare const ADAPTER_PACKAGE_VERSION: "0.1.1";
+export declare const ADAPTER_PACKAGE_VERSION: "0.2.2";
 /** 唯一允许加载的 KLineCharts 引擎版本。 */
 export declare const KLINECHARTS_ENGINE_VERSION: "10.0.0";
 /** 与 ChartScene 绑定的 Runtime 协议版本。 */
-export declare const KLINECHARTS_RUNTIME_VERSION: "0.1.0";
+export declare const KLINECHARTS_RUNTIME_VERSION: "0.2.0";
+export declare const SUPPORTED_KLINECHARTS_RUNTIME_VERSIONS: readonly ["0.1.0", "0.2.0"];
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,eAAO,MAAM,uBAAuB,EAAG,OAAgB,CAAC;AAExD,gCAAgC;AAChC,eAAO,MAAM,0BAA0B,EAAG,QAAiB,CAAC;AAE5D,qCAAqC;AACrC,eAAO,MAAM,2BAA2B,EAAG,OAAgB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,eAAO,MAAM,uBAAuB,EAAG,OAAgB,CAAC;AAExD,gCAAgC;AAChC,eAAO,MAAM,0BAA0B,EAAG,QAAiB,CAAC;AAE5D,qCAAqC;AACrC,eAAO,MAAM,2BAA2B,EAAG,OAAgB,CAAC;AAC5D,eAAO,MAAM,sCAAsC,6BAA8B,CAAC"}

package/dist/version.js

@@ -1,6 +1,7 @@
 /** Adapter 包版本。 */
-export const ADAPTER_PACKAGE_VERSION = '0.1.1';
+export const ADAPTER_PACKAGE_VERSION = '0.2.2';
 /** 唯一允许加载的 KLineCharts 引擎版本。 */
 export const KLINECHARTS_ENGINE_VERSION = '10.0.0';
 /** 与 ChartScene 绑定的 Runtime 协议版本。 */
-export const KLINECHARTS_RUNTIME_VERSION = '0.1.0';
+export const KLINECHARTS_RUNTIME_VERSION = '0.2.0';
+export const SUPPORTED_KLINECHARTS_RUNTIME_VERSIONS = ['0.1.0', '0.2.0'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baron1996/klinecharts-adapter",
-  "version": "0.1.1",
+  "version": "0.2.2",
   "description": "Controlled ChartScene adapter for KLineCharts.",
   "type": "module",
   "license": "Apache-2.0",
@@ -38,7 +38,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@baron1996/kline-scene-schema": "0.1.0",
+    "@baron1996/kline-scene-schema": "0.2.2",
     "klinecharts": "10.0.0"
   }
 }