@baron1996/klinecharts-adapter 0.3.0 → 0.4.1

package/dist/drawing/projection-policy.d.ts

@@ -0,0 +1,34 @@
+import type { ChartScene, Drawing, TimeSeriesScene, ValueAxis } from '@baron1996/kline-scene-schema';
+export type DrawingProjectionErrorCode = 'DRAWING_TARGET_INVALID' | 'DRAWING_PROJECTION_INVALID' | 'VALUE_AXIS_SCALE_UNSUPPORTED';
+export declare class DrawingProjectionError extends Error {
+    readonly code: DrawingProjectionErrorCode;
+    readonly path: string;
+    constructor(code: DrawingProjectionErrorCode, path: string, message: string);
+}
+export type ProjectionScene = {
+    readonly kind: 'chart';
+    readonly document: ChartScene;
+} | {
+    readonly kind: 'time-series';
+    readonly document: TimeSeriesScene;
+};
+export interface ResolvedAxisBinding {
+    readonly paneRole: string;
+    readonly yAxisRole: 'primary';
+    readonly valuePrecision: number;
+    readonly scale: 'linear' | 'logarithmic';
+}
+export interface ResolveAxisBindingInput {
+    readonly scene: ProjectionScene;
+    readonly drawing: Drawing;
+    readonly valueAxes: readonly ValueAxis[];
+    readonly path: string;
+}
+/**
+ * 纯 Drawing 轴绑定策略：只解析 paneRole/yAxisRole/valuePrecision/scale，
+ * 不持有引擎、不实现时间/几何算法，不接收引擎实例或像素输入。
+ */
+export interface DrawingProjectionPolicy {
+    resolveAxisBinding(input: ResolveAxisBindingInput): ResolvedAxisBinding;
+}
+//# sourceMappingURL=projection-policy.d.ts.map

package/dist/drawing/projection-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-policy.d.ts","sourceRoot":"","sources":["../../src/drawing/projection-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,OAAO,EACP,eAAe,EACf,SAAS,EACT,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,0BAA0B,GACnC,wBAAwB,GACxB,4BAA4B,GAC5B,8BAA8B,CAAC;AAElC,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,SAAgB,IAAI,EAAE,0BAA0B,CAAC;IACjD,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAMlF;AAED,MAAM,MAAM,eAAe,GACxB;IACA,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;CAC7B,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CAClC,CAAC;AAEL,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACvC,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,mBAAmB,CAAC;CACxE"}

package/dist/drawing/projection-policy.js

@@ -0,0 +1,10 @@
+export class DrawingProjectionError extends Error {
+    code;
+    path;
+    constructor(code, path, message) {
+        super(message);
+        this.name = 'DrawingProjectionError';
+        this.code = code;
+        this.path = path;
+    }
+}

package/dist/drawing/time-series-projection-policy.d.ts

@@ -0,0 +1,6 @@
+import { type DrawingProjectionPolicy, type ResolveAxisBindingInput, type ResolvedAxisBinding } from './projection-policy.js';
+/** 时间序列场景薄绑定策略；只接受公共 time-series / primary 轴。 */
+export declare class TimeSeriesDrawingProjectionPolicy implements DrawingProjectionPolicy {
+    resolveAxisBinding(input: ResolveAxisBindingInput): ResolvedAxisBinding;
+}
+//# sourceMappingURL=time-series-projection-policy.d.ts.map

package/dist/drawing/time-series-projection-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-series-projection-policy.d.ts","sourceRoot":"","sources":["../../src/drawing/time-series-projection-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,iDAAiD;AACjD,qBAAa,iCAAkC,YAAW,uBAAuB;IACzE,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,mBAAmB;CA2C9E"}

package/dist/drawing/time-series-projection-policy.js

@@ -0,0 +1,28 @@
+import { DrawingProjectionError, } from './projection-policy.js';
+/** 时间序列场景薄绑定策略；只接受公共 time-series / primary 轴。 */
+export class TimeSeriesDrawingProjectionPolicy {
+    resolveAxisBinding(input) {
+        const { scene, drawing, valueAxes, path } = input;
+        if (scene.kind !== 'time-series') {
+            throw new DrawingProjectionError('DRAWING_PROJECTION_INVALID', path, 'TimeSeriesDrawingProjectionPolicy requires a time-series Scene.');
+        }
+        const target = drawing.target;
+        if (target.paneRole !== 'time-series' ||
+            target.yAxisRole !== 'primary') {
+            throw new DrawingProjectionError('DRAWING_TARGET_INVALID', `${path}/target`, 'TimeSeries drawings must target time-series / primary.');
+        }
+        const sharedPrecision = scene.document.series[0]?.precision;
+        const axis = valueAxes.find((candidate) => candidate.paneRole === 'time-series' &&
+            candidate.yAxisRole === 'primary');
+        if (axis === undefined ||
+            axis.valuePrecision !== sharedPrecision) {
+            throw new DrawingProjectionError('DRAWING_TARGET_INVALID', `${path}/target`, 'TimeSeries primary binding precision must equal the shared series precision.');
+        }
+        return {
+            paneRole: 'time-series',
+            yAxisRole: 'primary',
+            valuePrecision: axis.valuePrecision,
+            scale: 'linear',
+        };
+    }
+}

package/dist/engine.d.ts

@@ -4,6 +4,8 @@ export type KLineChartsModule = typeof import('klinecharts');
 export interface EngineHandle {
     readonly chart: Chart;
     readonly module: KLineChartsModule;
+    /** 显式复位引擎点击仲裁状态；每次绘制开始前调用，避免快速连续绘制的首击被吞。 */
+    readonly resetClickArbitration: () => void;
 }
 /** 按固定顺序创建并初始化唯一的 KLineCharts 引擎。 */
 export declare function createEngine(container: HTMLElement, scene: ChartScene): Promise<EngineHandle>;

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;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"}
+{"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;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,IAAI,CAAC;CAC3C;AA+CD,qCAAqC;AACrC,wBAAsB,YAAY,CACjC,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,CAAC,CAmCvB"}

package/dist/engine.js

@@ -2,6 +2,15 @@ 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, SUPPORTED_KLINECHARTS_RUNTIME_VERSIONS, } from './version.js';
+function resolveClickArbitrationReset(chart) {
+    const eventHandler = chart
+        ._chartEvent?._event;
+    const reset = eventHandler?._resetClickTimeout;
+    if (eventHandler === undefined || typeof reset !== 'function') {
+        throw new SceneError('RUNTIME_INIT_FAILED', '/runtime', `KLineCharts ${KLINECHARTS_ENGINE_VERSION} 内部点击仲裁复位钩子不可用；引擎私有结构可能已变化。`);
+    }
+    return reset.bind(eventHandler);
+}
 function assertRuntimeIdentity(scene, actualEngineVersion) {
     if (scene.runtime.engine !== 'klinecharts' ||
         scene.runtime.engineVersion !== KLINECHARTS_ENGINE_VERSION ||
@@ -33,5 +42,9 @@ export async function createEngine(container, scene) {
     });
     chart.setPeriod(structuredClone(scene.period));
     chart.setDataLoader(createStaticDataLoader(scene.data));
-    return { chart, module: engine };
+    return {
+        chart,
+        module: engine,
+        resetClickArbitration: resolveClickArbitrationReset(chart),
+    };
 }

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

@@ -2,7 +2,7 @@ import type { registerOverlay } from 'klinecharts';
 type KLineOverlayTemplate = Parameters<typeof registerOverlay>[0];
 export interface PriceMeasurementDisplay {
     readonly absoluteChange: number;
-    readonly percentageChange: number;
+    readonly percentageChange: number | null;
     readonly label: string;
 }
 /** 仅派生显示值；绝对变化、百分比和 label 永不写入 Scene。 */

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

@@ -1 +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"}
+{"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,GAAG,IAAI,CAAC;IACzC,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,CA4BzB;AAED,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,EAAE,oBA6CrC,CAAC"}

package/dist/extensions/price-measurement.js

@@ -7,13 +7,19 @@ function signedFixed(value, precision) {
 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.');
+        throw new SceneError('SCENE_SCHEMA_INVALID', '/overlays/priceMeasurement', 'Price measurement display inputs must be finite numbers and a 0..16 precision.');
     }
     const absoluteChange = endValue - startValue;
+    if (startValue === 0) {
+        return {
+            absoluteChange,
+            percentageChange: null,
+            label: `${signedFixed(absoluteChange, pricePrecision)} (—%)`,
+        };
+    }
     const percentageChange = absoluteChange / startValue * 100;
     return {
         absoluteChange,

package/dist/index.d.ts

@@ -1,5 +1,12 @@
 export * from './adapter.js';
+export * from './drawing/kline-projection-policy.js';
+export * from './drawing/engine-port.js';
+export * from './drawing/interaction-normalization.js';
+export * from './drawing/overlay-conversion.js';
+export * from './drawing/projection-policy.js';
+export * from './drawing/time-series-projection-policy.js';
 export * from './errors.js';
+export * from './main-series-presentation.js';
 export * from './extensions/register.js';
 export * from './interaction/dragging.js';
 export * from './interaction/hit-testing.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,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sCAAsC,CAAC;AACrD,cAAc,0BAA0B,CAAC;AACzC,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,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,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -1,5 +1,12 @@
 export * from './adapter.js';
+export * from './drawing/kline-projection-policy.js';
+export * from './drawing/engine-port.js';
+export * from './drawing/interaction-normalization.js';
+export * from './drawing/overlay-conversion.js';
+export * from './drawing/projection-policy.js';
+export * from './drawing/time-series-projection-policy.js';
 export * from './errors.js';
+export * from './main-series-presentation.js';
 export * from './extensions/register.js';
 export * from './interaction/dragging.js';
 export * from './interaction/hit-testing.js';

package/dist/main-series-presentation.d.ts

@@ -0,0 +1,35 @@
+import type { ChartScene } from '@baron1996/kline-scene-schema';
+export type MainSeriesPresentationErrorCode = 'MAIN_SERIES_PRESENTATION_INVALID' | 'MAIN_SERIES_PRESENTATION_UNSUPPORTED' | 'MAIN_SERIES_PRESENTATION_APPLY_FAILED' | 'MAIN_SERIES_PRESENTATION_ROLLBACK_FAILED';
+export declare class MainSeriesPresentationError extends Error {
+    readonly code: MainSeriesPresentationErrorCode;
+    readonly path: string;
+    constructor(code: MainSeriesPresentationErrorCode, path: string, message: string);
+}
+/** 产品唯一 area 收盘价折线展示配置；值来源固定为 close。 */
+export declare const STANDARD_CLOSE_LINE_PRESENTATION: {
+    readonly type: "area";
+    readonly value: "close";
+    readonly line: {
+        readonly color: "rgba(41, 98, 255, 1)";
+        readonly size: 2;
+    };
+    readonly backgroundColor: "rgba(0, 0, 0, 0)";
+    readonly smooth: false;
+    readonly pointVisible: false;
+};
+export type MainSeriesPresentation = {
+    readonly type: 'candle_solid' | 'candle_stroke' | 'candle_up_stroke' | 'candle_down_stroke' | 'ohlc';
+} | typeof STANDARD_CLOSE_LINE_PRESENTATION;
+export type ActiveMainSeriesType = 'candle_solid' | 'candle_stroke' | 'candle_up_stroke' | 'candle_down_stroke' | 'ohlc' | 'area';
+export interface MainSeriesPresentationResult {
+    readonly activeType: ActiveMainSeriesType;
+}
+/**
+ * 主序列展示端口；只由 K 线 Adapter 实现，与 Drawing 引擎端口分离。
+ * 输入必须是完整 discriminated union，禁止从其他字段或引擎默认值兜底。
+ */
+export interface MainSeriesPresentationPort {
+    applyMainSeriesPresentation(presentation: MainSeriesPresentation): MainSeriesPresentationResult;
+}
+export declare function presentationToSceneCandle(scene: ChartScene, presentation: MainSeriesPresentation): ChartScene;
+//# sourceMappingURL=main-series-presentation.d.ts.map

package/dist/main-series-presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-series-presentation.d.ts","sourceRoot":"","sources":["../src/main-series-presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM,MAAM,+BAA+B,GACxC,kCAAkC,GAClC,sCAAsC,GACtC,uCAAuC,GACvC,0CAA0C,CAAC;AAE9C,qBAAa,2BAA4B,SAAQ,KAAK;IACrD,SAAgB,IAAI,EAAE,+BAA+B,CAAC;IACtD,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAG5B,IAAI,EAAE,+BAA+B,EACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM;CAOhB;AAED,wCAAwC;AACxC,eAAO,MAAM,gCAAgC;;;;;;;;;;CAOnC,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAC/B;IACA,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,kBAAkB,GACjE,oBAAoB,GAAG,MAAM,CAAC;CAChC,GACD,OAAO,gCAAgC,CAAC;AAE3C,MAAM,MAAM,oBAAoB,GAC7B,cAAc,GACd,eAAe,GACf,kBAAkB,GAClB,oBAAoB,GACpB,MAAM,GACN,MAAM,CAAC;AAEV,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IAC1C,2BAA2B,CAC1B,YAAY,EAAE,sBAAsB,GAClC,4BAA4B,CAAC;CAChC;AAED,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,sBAAsB,GAClC,UAAU,CAgCZ"}

package/dist/main-series-presentation.js

@@ -0,0 +1,52 @@
+export class MainSeriesPresentationError extends Error {
+    code;
+    path;
+    constructor(code, path, message) {
+        super(message);
+        this.name = 'MainSeriesPresentationError';
+        this.code = code;
+        this.path = path;
+    }
+}
+/** 产品唯一 area 收盘价折线展示配置；值来源固定为 close。 */
+export const STANDARD_CLOSE_LINE_PRESENTATION = {
+    type: 'area',
+    value: 'close',
+    line: { color: 'rgba(41, 98, 255, 1)', size: 2 },
+    backgroundColor: 'rgba(0, 0, 0, 0)',
+    smooth: false,
+    pointVisible: false,
+};
+export function presentationToSceneCandle(scene, presentation) {
+    if (presentation.type === 'area') {
+        return {
+            ...structuredClone(scene),
+            chart: {
+                ...structuredClone(scene.chart),
+                candle: {
+                    ...structuredClone(scene.chart.candle),
+                    type: 'area',
+                    area: {
+                        value: presentation.value,
+                        line: {
+                            color: presentation.line.color,
+                            size: presentation.line.size,
+                        },
+                        backgroundColor: presentation.backgroundColor,
+                        smooth: presentation.smooth,
+                        pointVisible: presentation.pointVisible,
+                    },
+                },
+            },
+        };
+    }
+    const candle = structuredClone(scene.chart.candle);
+    delete candle.area;
+    return {
+        ...structuredClone(scene),
+        chart: {
+            ...structuredClone(scene.chart),
+            candle: { ...candle, type: presentation.type },
+        },
+    };
+}

package/dist/time-series/adapter.d.ts

@@ -1,17 +1,40 @@
-import type { TimeSeriesPoint, TimeSeriesScene } from '@baron1996/kline-scene-schema';
+import type { Drawing, TimeSeriesPoint, TimeSeriesScene } from '@baron1996/kline-scene-schema';
+import type { DrawingEnginePort, EngineDrawingEvent, EngineDrawingSnapshot, EngineDrawingStartRequest, EnginePixelCoordinate, EnginePointProjection } from '../drawing/engine-port.js';
 export interface TimeSeriesAdapterCrosshair {
     readonly timestamp: number | null;
     readonly values: Readonly<Record<string, number | null>> | null;
 }
 export type TimeSeriesAdapterCrosshairListener = (event: TimeSeriesAdapterCrosshair) => void;
 /** TimeSeriesScene 与 KLineCharts 之间的唯一受控边界。 */
-export declare class TimeSeriesChartsAdapter {
+export declare class TimeSeriesChartsAdapter implements DrawingEnginePort {
     #private;
     private constructor();
     static create(container: HTMLElement, value: unknown): Promise<TimeSeriesChartsAdapter>;
+    /** 显式 Workspace factory：时间序列场景 + DrawingDocument。 */
+    static createWorkspace(container: HTMLElement, value: unknown): Promise<TimeSeriesChartsAdapter>;
+    get sceneKind(): 'chart' | 'time-series';
+    restoreDrawings(drawings: readonly EngineDrawingSnapshot[]): void;
+    startDrawing(request: EngineDrawingStartRequest): string;
+    listDrawings(): readonly EngineDrawingSnapshot[];
+    getDrawing(id: string): EngineDrawingSnapshot | undefined;
+    updateDrawingStyles(id: string, styles: Drawing['styles']): EngineDrawingSnapshot;
+    updateDrawingText(id: string, text: string): EngineDrawingSnapshot;
+    removeDrawing(id: string): boolean;
+    restoreDrawing(snapshot: EngineDrawingSnapshot): void;
+    selectDrawing(id: string | null): void;
+    hitTestDrawing(point: EnginePixelCoordinate): string | null;
+    projectToPixel(anchor: {
+        readonly timestamp?: number;
+        readonly value?: number;
+    }, _paneRole: string): EnginePointProjection;
+    unprojectFromPixel(point: EnginePixelCoordinate, _paneRole: string): EnginePointProjection;
+    setMutationsEnabled(enabled: boolean): void;
+    subscribeDrawingEvents(listener: (event: EngineDrawingEvent) => void): () => void;
     subscribeCrosshair(listener: TimeSeriesAdapterCrosshairListener): () => void;
     setSeriesVisible(seriesId: string, visible: boolean): TimeSeriesScene;
     replaceData(data: readonly TimeSeriesPoint[]): TimeSeriesScene;
+    /** 同结构场景替换：period/data/viewport 原子更新，series 结构必须一致。 */
+    replaceScene(value: TimeSeriesScene): TimeSeriesScene;
     exportScene(): TimeSeriesScene;
     dispose(): void;
 }

package/dist/time-series/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/time-series/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,eAAe,EACf,MAAM,+BAA+B,CAAC;AAqBvC,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;CAChE;AAED,MAAM,MAAM,kCAAkC,GAAG,CAChD,KAAK,EAAE,0BAA0B,KAC7B,IAAI,CAAC;AAqFV,+CAA+C;AAC/C,qBAAa,uBAAuB;;IAoBnC,OAAO;WAwBa,MAAM,CACzB,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,uBAAuB,CAAC;IA4I5B,kBAAkB,CACxB,QAAQ,EAAE,kCAAkC,GAC1C,MAAM,IAAI;IAMN,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe;IAqCrE,WAAW,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,eAAe;IA2C9D,WAAW,IAAI,eAAe;IAK9B,OAAO,IAAI,IAAI;CAgBtB"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/time-series/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,OAAO,EAEP,eAAe,EACf,eAAe,EAEf,MAAM,+BAA+B,CAAC;AAsCvC,OAAO,KAAK,EACX,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,MAAM,2BAA2B,CAAC;AAUnC,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;CAChE;AAED,MAAM,MAAM,kCAAkC,GAAG,CAChD,KAAK,EAAE,0BAA0B,KAC7B,IAAI,CAAC;AAoIV,+CAA+C;AAC/C,qBAAa,uBAAwB,YAAW,iBAAiB;;IA+ChE,OAAO;WA4Ba,MAAM,CACzB,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,uBAAuB,CAAC;IA8EnC,qDAAqD;WACjC,eAAe,CAClC,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,uBAAuB,CAAC;IA6vBnC,IAAW,SAAS,IAAI,OAAO,GAAG,aAAa,CAE9C;IAEM,eAAe,CACrB,QAAQ,EAAE,SAAS,qBAAqB,EAAE,GACxC,IAAI;IAQA,YAAY,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM;IA6BxD,YAAY,IAAI,SAAS,qBAAqB,EAAE;IAQhD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAMzD,mBAAmB,CACzB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,GACvB,qBAAqB;IA8BjB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB;IA2BlE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAKlC,cAAc,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAiCrD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAKtC,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI;IAM3D,cAAc,CACpB,MAAM,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAChE,SAAS,EAAE,MAAM,GACf,qBAAqB;IAKjB,kBAAkB,CACxB,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,MAAM,GACf,qBAAqB;IAKjB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAK3C,sBAAsB,CAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC3C,MAAM,IAAI;IAON,kBAAkB,CACxB,QAAQ,EAAE,kCAAkC,GAC1C,MAAM,IAAI;IAMN,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe;IAqCrE,WAAW,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,eAAe;IA2CrE,uDAAuD;IAChD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe;IA6CrD,WAAW,IAAI,eAAe;IAK9B,OAAO,IAAI,IAAI;CAmBtB"}