@baron1996/klinecharts-adapter 0.9.20 → 0.9.22

package/dist/engine-pan.d.ts

@@ -0,0 +1,16 @@
+import type { Chart, YAxis, AxisRange } from 'klinecharts';
+interface PanAxis extends YAxis {
+    getRange(): AxisRange;
+    setRange(range: AxisRange): void;
+}
+/** Translate in the coordinate system used by convertToPixel, not in raw prices. */
+export declare function translatePanRange(axis: Pick<PanAxis, 'name' | 'reverse' | 'realValueToValue' | 'realValueToDisplayValue'>, start: AxisRange, deltaY: number, height: number): AxisRange | null;
+/**
+ * KLineCharts 10.0.0 has no public pan-range hook. Like the click arbitration
+ * bridge, this instance-local compatibility shim is guarded by engine identity
+ * and fails explicitly if the private event boundary changes.
+ * Axis zoom, drawings and pointer arbitration remain owned by the engine.
+ */
+export declare function installScalePreservingPan(chart: Chart): void;
+export {};
+//# sourceMappingURL=engine-pan.d.ts.map

package/dist/engine-pan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-pan.d.ts","sourceRoot":"","sources":["../src/engine-pan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI3D,UAAU,OAAQ,SAAQ,KAAK;IAC9B,QAAQ,IAAI,SAAS,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACjC;AAkBD,oFAAoF;AACpF,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,GAAG,yBAAyB,CAAC,EACxF,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,SAAS,GAAG,IAAI,CAqBlB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAgD5D"}

package/dist/engine-pan.js

@@ -0,0 +1,83 @@
+import { SceneError } from '@baron1996/kline-scene-schema';
+import { KLINECHARTS_ENGINE_VERSION } from './version.js';
+/** Translate in the coordinate system used by convertToPixel, not in raw prices. */
+export function translatePanRange(axis, start, deltaY, height) {
+    if (!(height > 0) || !(start.realRange > 0))
+        return null;
+    const shift = (axis.reverse ? -deltaY : deltaY) / height * start.realRange;
+    const realFrom = start.realFrom + shift;
+    const realTo = start.realTo + shift;
+    // KLineCharts 10's signed logarithm inverse treats negative log coordinates
+    // as negative prices. Positive prices below 1 still need the positive inverse.
+    const positiveLog = axis.name === 'logarithm' && start.from > 0 && start.to > 0;
+    const from = positiveLog ? 10 ** realFrom : axis.realValueToValue(realFrom, { range: start });
+    const to = positiveLog ? 10 ** realTo : axis.realValueToValue(realTo, { range: start });
+    const displayFrom = positiveLog ? from : axis.realValueToDisplayValue(realFrom, { range: start });
+    const displayTo = positiveLog ? to : axis.realValueToDisplayValue(realTo, { range: start });
+    const result = {
+        from, to, range: to - from,
+        realFrom, realTo, realRange: start.realRange,
+        displayFrom, displayTo, displayRange: displayTo - displayFrom,
+    };
+    // Never commit an overflowed/collapsed range after an extreme drag.
+    return Object.values(result).every(Number.isFinite) && to > from && realTo > realFrom
+        ? result
+        : null;
+}
+/**
+ * KLineCharts 10.0.0 has no public pan-range hook. Like the click arbitration
+ * bridge, this instance-local compatibility shim is guarded by engine identity
+ * and fails explicitly if the private event boundary changes.
+ * Axis zoom, drawings and pointer arbitration remain owned by the engine.
+ */
+export function installScalePreservingPan(chart) {
+    const internal = chart;
+    const events = internal._chartEvent;
+    if (events === undefined ||
+        typeof events._processMainScrollingEvent !== 'function' ||
+        !('_startScrollCoordinate' in events) ||
+        typeof internal.getChartStore !== 'function') {
+        throw new SceneError('RUNTIME_INIT_FAILED', '/runtime', `KLineCharts ${KLINECHARTS_ENGINE_VERSION} pan compatibility hook is unavailable.`);
+    }
+    const store = internal.getChartStore();
+    let gesture = null;
+    let ranges = new Map();
+    events._processMainScrollingEvent = (widget, event) => {
+        const start = events._startScrollCoordinate;
+        if (start === null || !chart.isScrollEnabled())
+            return;
+        const deltaX = event.x - start.x;
+        const deltaY = event.y - start.y;
+        if (gesture !== start) {
+            // A click (or an overlay consuming the gesture) must not disable auto-fit.
+            if (deltaX === 0 && deltaY === 0)
+                return;
+            gesture = start;
+            ranges = new Map();
+            // All panes share X. Freeze their enabled Y axes before scrolling can
+            // recalculate visible extrema, including a gesture starting in auto-fit.
+            for (const item of chart.getYAxes({})) {
+                const axis = item;
+                if (!axis.scrollZoomEnabled)
+                    continue;
+                const range = { ...axis.getRange() };
+                if (!Object.values(range).every(Number.isFinite) || !(range.realRange > 0))
+                    continue;
+                ranges.set(axis, range);
+                axis.setRange(range);
+            }
+        }
+        event.preventDefault?.();
+        for (const axis of widget.getPane().getYAxisComponents()) {
+            const range = ranges.get(axis);
+            if (range === undefined || !axis.scrollZoomEnabled)
+                continue;
+            const translated = translatePanRange(axis, range, deltaY, widget.getBounding().height);
+            if (translated !== null)
+                axis.setRange(translated);
+        }
+        // This preserves the engine's bounds, historical loading and scroll events.
+        // Keep the ranges manual on release; double-clicking Y restores auto-fit.
+        store.scroll(deltaX);
+    };
+}

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;AAWzC,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;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,IAAI,CAAC;IAC3C,kCAAkC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACpE,gCAAgC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAqFD,qCAAqC;AACrC,wBAAsB,YAAY,CACjC,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,YAAY,CAAC,CAyCvB"}
+{"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;AAYzC,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;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,IAAI,CAAC;IAC3C,kCAAkC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACpE,gCAAgC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAqFD,qCAAqC;AACrC,wBAAsB,YAAY,CACjC,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,YAAY,CAAC,CA0CvB"}

package/dist/engine.js

@@ -2,6 +2,7 @@ import { SceneError } from '@baron1996/kline-scene-schema';
 import { toKLineChartsOptions } from './conversion/chart-options.js';
 import { createStaticDataLoader } from './static-data-loader.js';
 import { engineDataForScene } from './gap-aware-series.js';
+import { installScalePreservingPan } from './engine-pan.js';
 import { KLINECHARTS_ENGINE_VERSION, KLINECHARTS_RUNTIME_VERSION, SUPPORTED_KLINECHARTS_RUNTIME_VERSIONS, } from './version.js';
 function resolveMouseInteractionDispatch(chart) {
     const chartEvent = chart._chartEvent;
@@ -56,6 +57,7 @@ export async function createEngine(container, scene, options) {
         throw new SceneError('RUNTIME_INIT_FAILED', '/', 'KLineCharts did not create an interactive chart root.');
     }
     engineRoot.style.touchAction = 'none';
+    installScalePreservingPan(chart);
     chart.setSymbol({
         ticker: scene.symbol.ticker,
         pricePrecision: scene.symbol.pricePrecision,

package/dist/version.d.ts

@@ -1,5 +1,5 @@
 /** Adapter 包版本。 */
-export declare const ADAPTER_PACKAGE_VERSION: "0.9.20";
+export declare const ADAPTER_PACKAGE_VERSION: "0.9.22";
 /** 唯一允许加载的 KLineCharts 引擎版本。 */
 export declare const KLINECHARTS_ENGINE_VERSION: "10.0.0";
 /** 与 ChartScene 绑定的 Runtime 协议版本。 */

package/dist/version.js

@@ -1,5 +1,5 @@
 /** Adapter 包版本。 */
-export const ADAPTER_PACKAGE_VERSION = '0.9.20';
+export const ADAPTER_PACKAGE_VERSION = '0.9.22';
 /** 唯一允许加载的 KLineCharts 引擎版本。 */
 export const KLINECHARTS_ENGINE_VERSION = '10.0.0';
 /** 与 ChartScene 绑定的 Runtime 协议版本。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baron1996/klinecharts-adapter",
-  "version": "0.9.20",
+  "version": "0.9.22",
   "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.9.20",
+    "@baron1996/kline-scene-schema": "0.9.22",
     "klinecharts": "10.0.0"
   }
 }