@baron1996/klinecharts-runtime 0.2.3 → 0.4.0

package/README.md

@@ -4,7 +4,7 @@ Browser editing runtime and standard annotation toolbar for deterministic KLineC
 ChartScene files.
 
 ```bash
-npm install --save-exact @baron1996/kline-scene-schema@0.2.3 @baron1996/klinecharts-runtime@0.2.3
+npm install --save-exact @baron1996/kline-scene-schema@0.4.0 @baron1996/klinecharts-runtime@0.4.0
 ```
 
 ```ts

package/dist/drawing/capabilities.d.ts

@@ -0,0 +1,36 @@
+import type { ChartScene, Drawing } from '@baron1996/kline-scene-schema';
+import type { EngineDrawingSnapshot, EnginePixelCoordinate, MainSeriesPresentation } from '@baron1996/klinecharts-adapter';
+import type { HostActionDescriptor, RuntimeCapabilityDescriptor } from './runtime-capability-descriptor.js';
+/** 公共 Drawing 能力；工具栏与所有正式交互式图表 Runtime 共用。 */
+export interface DrawingRuntimeCapability {
+    startDrawing(type: Drawing['type'], options?: {
+        readonly text?: string;
+        readonly id?: string;
+        readonly styles?: Drawing['styles'];
+    }): 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;
+    requestDrawingDelete(id: string): void;
+    selectDrawing(id: string | null): void;
+    getSelectedDrawingId(): string | undefined;
+    hitTestDrawing(point: EnginePixelCoordinate): string | null;
+}
+export interface RuntimeAuxiliaryCapability {
+    getRuntimeCapabilityDescriptor(options?: {
+        readonly hostActions?: readonly HostActionDescriptor[];
+    }): RuntimeCapabilityDescriptor;
+    exportArtifact(fileName?: string): {
+        readonly bytes: Uint8Array;
+        readonly mediaType: 'application/json';
+        readonly fileName: string;
+    };
+    setValueAxisScale(scale: 'linear' | 'logarithmic'): Promise<ChartScene>;
+    setMainSeriesPresentation(presentation: MainSeriesPresentation): {
+        readonly activeType: string;
+    };
+    requestHostAction(actionId: string, drawingId?: string | null): void;
+}
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/drawing/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/drawing/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,OAAO,EACP,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACX,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACX,oBAAoB,EACpB,2BAA2B,EAC3B,MAAM,oCAAoC,CAAC;AAG5C,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACxC,YAAY,CACX,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EACrB,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;KACpC,GACC,MAAM,CAAC;IACV,YAAY,IAAI,SAAS,qBAAqB,EAAE,CAAC;IACjD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;IAC1D,mBAAmB,CAClB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,GACvB,qBAAqB,CAAC;IACzB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAAC;IACnE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACvC,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAAC;IAC3C,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,0BAA0B;IAC1C,8BAA8B,CAAC,OAAO,CAAC,EAAE;QACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;KACvD,GAAG,2BAA2B,CAAC;IAChC,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG;QAClC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;QACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACxE,yBAAyB,CACxB,YAAY,EAAE,sBAAsB,GAClC;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACrE"}

package/dist/drawing/capabilities.js

@@ -0,0 +1 @@
+export {};

package/dist/drawing/legacy-runtime-capability.d.ts

@@ -0,0 +1,8 @@
+import type { Period, SceneOverlay } from '@baron1996/kline-scene-schema';
+import type { EngineDrawingSnapshot } from '@baron1996/klinecharts-adapter';
+/**
+ * Legacy SceneOverlay → 公共 Drawing 快照的只读视图。
+ * 不构造 DrawingDocument，不改动 Legacy 状态与事件。
+ */
+export declare function overlayToDrawingSnapshot(overlay: SceneOverlay, period: Period): EngineDrawingSnapshot;
+//# sourceMappingURL=legacy-runtime-capability.d.ts.map

package/dist/drawing/legacy-runtime-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-runtime-capability.d.ts","sourceRoot":"","sources":["../../src/drawing/legacy-runtime-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,MAAM,EACN,YAAY,EACZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,GACZ,qBAAqB,CAcvB"}

package/dist/drawing/legacy-runtime-capability.js

@@ -0,0 +1,92 @@
+/**
+ * Legacy SceneOverlay → 公共 Drawing 快照的只读视图。
+ * 不构造 DrawingDocument，不改动 Legacy 状态与事件。
+ */
+export function overlayToDrawingSnapshot(overlay, period) {
+    const granularity = structuredClone(period);
+    const geometry = overlayGeometry(overlay, granularity);
+    return {
+        id: overlay.id,
+        type: overlay.type,
+        target: { paneRole: 'candle', yAxisRole: 'primary' },
+        geometry,
+        styles: structuredClone(overlay.styles),
+        locked: overlay.locked,
+        visible: overlay.visible,
+        zLevel: overlay.zLevel,
+        mode: overlay.mode,
+    };
+}
+function overlayGeometry(overlay, granularity) {
+    const result = {};
+    switch (overlay.type) {
+        case 'horizontalStraightLine':
+        case 'priceLine':
+            result.value = overlay.anchor.value;
+            break;
+        case 'simpleTag':
+            result.value = overlay.anchor.value;
+            result.text = overlay.text ?? '';
+            break;
+        case 'verticalStraightLine':
+            result.time = overlay.anchor.timestamp;
+            break;
+        case 'horizontalRayLine':
+        case 'horizontalSegment':
+            result.value = overlay.value;
+            result.startTime = overlay.startTimestamp;
+            result.endTime = overlay.endTimestamp;
+            break;
+        case 'verticalRayLine':
+        case 'verticalSegment':
+            result.time = overlay.timestamp;
+            result.startValue = overlay.startValue;
+            result.endValue = overlay.endValue;
+            break;
+        case 'rayLine':
+        case 'segment':
+        case 'straightLine':
+        case 'fibonacciLine':
+        case 'priceChannelLine':
+        case 'parallelStraightLine':
+        case 'brush':
+            result.points = overlay.points.map((point) => ({
+                timestamp: point.timestamp,
+                value: point.value,
+                granularity: structuredClone(granularity),
+            }));
+            break;
+        case 'simpleAnnotation':
+        case 'callout':
+        case 'text':
+            result.point = {
+                timestamp: overlay.point.timestamp,
+                value: overlay.point.value,
+                granularity: structuredClone(granularity),
+            };
+            result.text = overlay.text ?? '';
+            break;
+        case 'crossLine':
+            result.point = {
+                timestamp: overlay.point.timestamp,
+                value: overlay.point.value,
+                granularity: structuredClone(granularity),
+            };
+            break;
+        case 'rectangle':
+        case 'arrow':
+        case 'priceMeasurement':
+            result.start = {
+                timestamp: overlay.start.timestamp,
+                value: overlay.start.value,
+                granularity: structuredClone(granularity),
+            };
+            result.end = {
+                timestamp: overlay.end.timestamp,
+                value: overlay.end.value,
+                granularity: structuredClone(granularity),
+            };
+            break;
+    }
+    return result;
+}

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

@@ -0,0 +1,80 @@
+import type { Drawing, DrawingDocument, Period, ValueAxis } from '@baron1996/kline-scene-schema';
+import { type ProjectionScene, type ResolvedAxisBinding } from '@baron1996/klinecharts-adapter';
+export type { ProjectionScene } from '@baron1996/klinecharts-adapter';
+export interface DrawingTimeAnchor {
+    readonly timestamp: number;
+    readonly granularity: Period;
+}
+export type ProjectedBucketKind = 'exact' | 'first-child' | 'containing-interval' | 'outside-data-range';
+export interface ProjectedTimeBucket {
+    readonly kind: ProjectedBucketKind;
+    readonly startTimestamp: number;
+    readonly endTimestamp: number;
+    readonly dataIndex: number | null;
+}
+export interface ProjectedAnchor {
+    readonly timestamp: number;
+    readonly granularity: Period;
+    readonly value: number | null;
+    readonly bucket: ProjectedTimeBucket;
+}
+export interface ProjectedDrawing {
+    readonly drawing: Drawing;
+    readonly binding: ResolvedAxisBinding;
+    readonly anchors: readonly ProjectedAnchor[];
+    readonly visible: boolean;
+}
+export interface ProjectedDrawingDocument {
+    readonly scopeKey: string;
+    readonly timezone: string;
+    readonly drawings: readonly ProjectedDrawing[];
+}
+export interface ProjectDrawingInput {
+    readonly scene: ProjectionScene;
+    readonly drawing: Drawing;
+    readonly valueAxes: readonly ValueAxis[];
+    readonly path: string;
+}
+export interface ReverseProjectAnchorInput {
+    readonly original: DrawingTimeAnchor;
+    readonly editingScenePeriod: Period;
+    readonly targetTimestamp: number;
+    readonly data: readonly {
+        readonly timestamp: number;
+    }[];
+    readonly scenePeriod: Period;
+    readonly timezone: string;
+}
+export interface ReverseProjectDrawingInput {
+    readonly scene: ProjectionScene;
+    readonly drawing: Drawing;
+    readonly valueAxes: readonly ValueAxis[];
+    readonly path: string;
+    readonly horizontal?: {
+        readonly targetTimestamp: number;
+        readonly editingScenePeriod: Period;
+    };
+    readonly vertical?: {
+        readonly values: readonly number[];
+    };
+}
+/**
+ * 纯时间桶、22 种几何与反投影核心；不持有 Adapter/引擎，输入输出深拷贝。
+ */
+export declare class DrawingProjectionService {
+    #private;
+    addPeriod(timestamp: number, period: Period, timezone: string): number;
+    projectDrawing(input: ProjectDrawingInput): ProjectedDrawing;
+    projectDocument(input: {
+        readonly scene: ProjectionScene;
+        readonly drawings: DrawingDocument;
+    }): ProjectedDrawingDocument;
+    reverseProjectAnchor(input: ReverseProjectAnchorInput): DrawingTimeAnchor;
+    reverseProjectDrawing(input: ReverseProjectDrawingInput): Drawing;
+}
+interface GeometryAnchorEntry {
+    readonly anchor: DrawingTimeAnchor;
+    readonly value: number | null;
+}
+export declare function geometryAnchors(drawing: Drawing, defaultGranularity: Period): readonly GeometryAnchorEntry[];
+//# sourceMappingURL=projection-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projection-service.d.ts","sourceRoot":"","sources":["../../src/drawing/projection-service.ts"],"names":[],"mappings":"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"}