@baron1996/klinecharts-adapter 0.2.3 → 0.4.0

package/dist/drawing/overlay-conversion.js

@@ -0,0 +1,245 @@
+/**
+ * Drawing 业务几何 ↔ 旧 SceneOverlay 兼容几何的纯数据映射。
+ * 不写回 dataIndex、paneId、yAxisId 或任何引擎内部 ID。
+ */
+export function drawingToSceneOverlay(drawing, paneId) {
+    const base = {
+        id: drawing.id,
+        type: drawing.type,
+        paneId,
+        visible: drawing.visible,
+        locked: drawing.locked,
+        zLevel: drawing.zLevel,
+        mode: drawing.mode,
+        styles: structuredClone(drawing.styles),
+    };
+    if (drawing.groupId !== undefined) {
+        base.groupId = drawing.groupId;
+    }
+    if (drawing.metadata !== undefined) {
+        base.metadata = structuredClone(drawing.metadata);
+    }
+    switch (drawing.type) {
+        case 'horizontalStraightLine':
+        case 'priceLine':
+            return { ...base, anchor: { value: drawing.geometry.value } };
+        case 'simpleTag':
+            return {
+                ...base,
+                anchor: { value: drawing.geometry.value },
+                text: drawing.geometry.text,
+            };
+        case 'verticalStraightLine':
+            return { ...base, anchor: { timestamp: drawing.geometry.time } };
+        case 'horizontalRayLine':
+        case 'horizontalSegment':
+            return {
+                ...base,
+                value: drawing.geometry.value,
+                startTimestamp: drawing.geometry.startTime,
+                endTimestamp: drawing.geometry.endTime,
+            };
+        case 'verticalRayLine':
+        case 'verticalSegment':
+            return {
+                ...base,
+                timestamp: drawing.geometry.time,
+                startValue: drawing.geometry.startValue,
+                endValue: drawing.geometry.endValue,
+            };
+        case 'rayLine':
+        case 'segment':
+        case 'straightLine':
+        case 'fibonacciLine':
+        case 'priceChannelLine':
+        case 'parallelStraightLine':
+        case 'brush':
+            return {
+                ...base,
+                points: drawing.geometry.points.map((point) => ({
+                    timestamp: point.timestamp,
+                    value: point.value,
+                })),
+            };
+        case 'simpleAnnotation':
+        case 'callout':
+        case 'text':
+            return {
+                ...base,
+                point: {
+                    timestamp: drawing.geometry.point.timestamp,
+                    value: drawing.geometry.point.value,
+                },
+                text: drawing.geometry.text,
+            };
+        case 'crossLine':
+            return {
+                ...base,
+                point: {
+                    timestamp: drawing.geometry.point.timestamp,
+                    value: drawing.geometry.point.value,
+                },
+            };
+        case 'rectangle':
+        case 'arrow':
+        case 'priceMeasurement':
+            return {
+                ...base,
+                start: {
+                    timestamp: drawing.geometry.start.timestamp,
+                    value: drawing.geometry.start.value,
+                },
+                end: {
+                    timestamp: drawing.geometry.end.timestamp,
+                    value: drawing.geometry.end.value,
+                },
+            };
+    }
+}
+function drawingText(drawing) {
+    switch (drawing.type) {
+        case 'simpleTag':
+        case 'simpleAnnotation':
+        case 'callout':
+        case 'text':
+            return drawing.geometry.text;
+        default:
+            return undefined;
+    }
+}
+/** 用引擎归一化后的 SceneOverlay 几何重建 Drawing；granularity 从源 Drawing 恢复。 */
+export function sceneOverlayToDrawing(overlay, source) {
+    const text = overlay.type === 'simpleTag'
+        || overlay.type === 'simpleAnnotation'
+        || overlay.type === 'callout'
+        || overlay.type === 'text'
+        ? overlay.text
+        : drawingText(source);
+    const result = {
+        id: overlay.id,
+        target: structuredClone(source.target),
+        visible: overlay.visible,
+        locked: overlay.locked,
+        zLevel: overlay.zLevel,
+        mode: overlay.mode,
+        styles: structuredClone(overlay.styles),
+        type: overlay.type,
+    };
+    if (overlay.groupId !== undefined) {
+        result.groupId = overlay.groupId;
+    }
+    if (overlay.metadata !== undefined) {
+        result.metadata = structuredClone(overlay.metadata);
+    }
+    switch (overlay.type) {
+        case 'horizontalStraightLine':
+        case 'priceLine':
+            result.geometry = { value: overlay.anchor.value };
+            break;
+        case 'simpleTag':
+            result.geometry = {
+                value: overlay.anchor.value,
+                text: overlay.text ?? '',
+            };
+            break;
+        case 'verticalStraightLine':
+            result.geometry = {
+                time: overlay.anchor.timestamp,
+            };
+            break;
+        case 'horizontalRayLine':
+        case 'horizontalSegment':
+            result.geometry = {
+                value: overlay.value,
+                startTime: overlay.startTimestamp,
+                endTime: overlay.endTimestamp,
+            };
+            break;
+        case 'verticalRayLine':
+        case 'verticalSegment':
+            result.geometry = {
+                time: overlay.timestamp,
+                startValue: overlay.startValue,
+                endValue: overlay.endValue,
+            };
+            break;
+        case 'rayLine':
+        case 'segment':
+        case 'straightLine':
+        case 'fibonacciLine':
+        case 'priceChannelLine':
+        case 'parallelStraightLine':
+        case 'brush':
+            result.geometry = {
+                points: overlay.points.map((point, index) => ({
+                    timestamp: point.timestamp,
+                    value: point.value,
+                    granularity: structuredClone(pointGranularity(source, index)),
+                })),
+            };
+            break;
+        case 'simpleAnnotation':
+        case 'callout':
+        case 'text':
+            result.geometry = {
+                point: {
+                    timestamp: overlay.point.timestamp,
+                    value: overlay.point.value,
+                    granularity: structuredClone(pointGranularity(source, 0)),
+                },
+                text: overlay.text ?? '',
+            };
+            break;
+        case 'crossLine':
+            result.geometry = {
+                point: {
+                    timestamp: overlay.point.timestamp,
+                    value: overlay.point.value,
+                    granularity: structuredClone(pointGranularity(source, 0)),
+                },
+            };
+            break;
+        case 'rectangle':
+        case 'arrow':
+        case 'priceMeasurement':
+            result.geometry = {
+                start: {
+                    timestamp: overlay.start.timestamp,
+                    value: overlay.start.value,
+                    granularity: structuredClone(pointGranularity(source, 0)),
+                },
+                end: {
+                    timestamp: overlay.end.timestamp,
+                    value: overlay.end.value,
+                    granularity: structuredClone(pointGranularity(source, 1)),
+                },
+            };
+            break;
+    }
+    return result;
+}
+function pointGranularity(source, index) {
+    if (source.type === 'rayLine' ||
+        source.type === 'segment' ||
+        source.type === 'straightLine' ||
+        source.type === 'fibonacciLine' ||
+        source.type === 'priceChannelLine' ||
+        source.type === 'parallelStraightLine' ||
+        source.type === 'brush') {
+        const point = source.geometry.points[index] ?? source.geometry.points[0];
+        return structuredClone(point?.granularity ?? { type: 'day', span: 1 });
+    }
+    if (source.type === 'simpleAnnotation' ||
+        source.type === 'callout' ||
+        source.type === 'text' ||
+        source.type === 'crossLine') {
+        return structuredClone(source.geometry.point.granularity);
+    }
+    if (source.type === 'rectangle' ||
+        source.type === 'arrow' ||
+        source.type === 'priceMeasurement') {
+        const anchor = index === 0 ? source.geometry.start : source.geometry.end;
+        return structuredClone(anchor.granularity);
+    }
+    return { type: 'day', span: 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/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,10 +1,18 @@
 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';
 export * from './registry/indicators.js';
 export * from './registry/overlays.js';
 export * from './static-data-loader.js';
+export * from './time-series/adapter.js';
 export * from './version.js';
 //# sourceMappingURL=index.d.ts.map

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,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,9 +1,17 @@
 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';
 export * from './registry/indicators.js';
 export * from './registry/overlays.js';
 export * from './static-data-loader.js';
+export * from './time-series/adapter.js';
 export * from './version.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

@@ -0,0 +1,41 @@
+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 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;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}