@baron1996/klinecharts-adapter 0.9.21 → 0.9.23

package/dist/conversion/log-price-ticks.d.ts

@@ -0,0 +1,7 @@
+import type { AxisCreateTicksParams, AxisTick } from 'klinecharts';
+/** Positive candle prices: fixed log lattice, shared by ticks and grid lines. */
+export declare function createLogPriceTicks({ range, bounding, defaultTicks }: AxisCreateTicksParams, reverse: boolean, presentation?: {
+    textHeight?: number;
+    formatText?: (text: string) => string;
+}): AxisTick[];
+//# sourceMappingURL=log-price-ticks.d.ts.map

package/dist/conversion/log-price-ticks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-price-ticks.d.ts","sourceRoot":"","sources":["../../src/conversion/log-price-ticks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAwBnE,iFAAiF;AACjF,wBAAgB,mBAAmB,CAClC,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,qBAAqB,EACxD,OAAO,EAAE,OAAO,EAChB,YAAY,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAAO,GAC/E,QAAQ,EAAE,CA2BZ"}

package/dist/conversion/log-price-ticks.js

@@ -0,0 +1,52 @@
+const MIN_TICK_SPACING = 48;
+/** Choose density in log space, independent of the translated price bounds. */
+function logStep(span, height, textHeight) {
+    const target = span * Math.max(MIN_TICK_SPACING, textHeight * 3) / height;
+    const magnitude = 10 ** Math.floor(Math.log10(target));
+    const normalized = target / magnitude;
+    // Tolerate floating-point noise at a density boundary across repeated pans.
+    const factor = [1, 2, 2.5, 5, 10].find((value) => value >= normalized * (1 - 1e-10));
+    return Number((factor * magnitude).toPrecision(12));
+}
+function priceText(value, step) {
+    // Retain the usual two decimals; tiny prices/close ticks need enough digits
+    // to avoid adjacent labels becoming identical after rounding.
+    const difference = value * Math.expm1(step * Math.LN10);
+    const precision = Math.max(2, 1 - Math.floor(Math.log10(difference)));
+    return precision > 12 || value >= 1e12
+        ? value.toExponential(6)
+        : value.toFixed(precision);
+}
+/** Positive candle prices: fixed log lattice, shared by ticks and grid lines. */
+export function createLogPriceTicks({ range, bounding, defaultTicks }, reverse, presentation = {}) {
+    const { realFrom, realTo, realRange } = range;
+    const { height } = bounding;
+    if (!(range.from > 0 && range.to > range.from && realRange > 0 && height > 0)
+        || ![realFrom, realTo, realRange, height].every(Number.isFinite)) {
+        return defaultTicks;
+    }
+    const textHeight = presentation.textHeight ?? 12;
+    const step = logStep(realRange, height, textHeight);
+    if (!(step > 0 && Number.isFinite(step)))
+        return defaultTicks;
+    const first = Math.ceil(realFrom / step);
+    const last = Math.floor(realTo / step);
+    if (!Number.isSafeInteger(first) || !Number.isSafeInteger(last))
+        return defaultTicks;
+    const ticks = [];
+    // Anchor to log10(price)=0, not the viewport edge. Compute each tick from
+    // its integer index so newly exposed ticks extend the same price sequence.
+    for (let index = first; index <= last && ticks.length < 1000; index++) {
+        const logValue = Number((index * step).toPrecision(14));
+        const value = 10 ** logValue;
+        const fraction = (logValue - realFrom) / realRange;
+        const coord = Math.round(height * (reverse ? fraction : 1 - fraction));
+        if (coord <= textHeight || coord >= height - textHeight)
+            continue;
+        if (!(value > 0 && Number.isFinite(value)))
+            continue;
+        const text = priceText(value, step);
+        ticks.push({ value, coord, text: presentation.formatText?.(text) ?? text });
+    }
+    return ticks;
+}

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,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;AAS/C,iDAAiD;AACjD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjE;AA2BD,qDAAqD;AACrD,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,aAAa,UAAQ,GACnB,IAAI,CAIN;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CA4EpF"}
+{"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,EAAyB,KAAK,EAAS,MAAM,aAAa,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU/C,iDAAiD;AACjD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjE;AAmCD,qDAAqD;AACrD,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,aAAa,UAAQ,GACnB,IAAI,CAIN;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CA6EpF"}

package/dist/conversion/panes.js

@@ -1,16 +1,24 @@
 import { SceneError } from '@baron1996/kline-scene-schema';
 import { requireMappedId } from './id-map.js';
 import { createPaneIndicators } from './indicators.js';
+import { createLogPriceTicks } from './log-price-ticks.js';
 /** 蜡烛主价格轴默认只格式化展示文本，不改变 Scene 与 Drawing 数值精度。 */
 export function formatDefaultPriceAxisValue(value) {
     const rounded = Number(value.toFixed(2));
     return (Object.is(rounded, -0) ? 0 : rounded).toFixed(2);
 }
-function axisOverride(axis, enginePaneId, engineAxisId, formatAsPrice) {
+function axisOverride(chart, axis, enginePaneId, engineAxisId, formatAsPrice) {
     return {
         id: engineAxisId,
         paneId: enginePaneId,
         name: axis.scale === 'logarithmic' ? 'logarithm' : 'normal',
+        // Explicit passthrough also clears our callback when switching to linear.
+        createTicks: (params) => formatAsPrice && axis.scale === 'logarithmic'
+            ? createLogPriceTicks(params, axis.reverse, {
+                textHeight: chart.getStyles().yAxis.tickText.size,
+                formatText: (text) => chart.getDecimalFold().format(chart.getThousandsSeparator().format(text)),
+            })
+            : params.defaultTicks,
         reverse: axis.reverse,
         inside: axis.inside,
         position: axis.position,
@@ -29,7 +37,7 @@ function axisOverride(axis, enginePaneId, engineAxisId, formatAsPrice) {
 export function overrideSceneYAxis(chart, idMap, axis, paneId, path, formatAsPrice = false) {
     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, formatAsPrice));
+    chart.overrideYAxis(axisOverride(chart, axis, enginePaneId, engineAxisId, formatAsPrice));
 }
 /** 按 Scene 顺序创建 Pane、Y 轴和指标，并核对每个映射。 */
 export function applyPanes(scene, chart, idMap) {
@@ -56,7 +64,7 @@ export function applyPanes(scene, chart, idMap) {
                 continue;
             }
             const engineAxisId = requireMappedId(idMap.yAxisToEngine, axis.id, `/panes/${paneIndex}/yAxes/${axisIndex}/id`, 'Y-axis');
-            const override = axisOverride(axis, enginePaneId, engineAxisId, pane.kind === 'candle' && axis.role === 'primary');
+            const override = axisOverride(chart, axis, enginePaneId, engineAxisId, pane.kind === 'candle' && axis.role === 'primary');
             const axes = chart.getYAxes({ paneId: enginePaneId });
             if (axes.some((candidate) => candidate.id === engineAxisId)) {
                 chart.overrideYAxis(override);

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.21";
+export declare const ADAPTER_PACKAGE_VERSION: "0.9.23";
 /** 唯一允许加载的 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.21';
+export const ADAPTER_PACKAGE_VERSION = '0.9.23';
 /** 唯一允许加载的 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.21",
+  "version": "0.9.23",
   "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.21",
+    "@baron1996/kline-scene-schema": "0.9.23",
     "klinecharts": "10.0.0"
   }
 }