@baron1996/klinecharts-runtime 0.3.0 → 0.4.0

package/dist/drawing/workspace-runtime.js

@@ -0,0 +1,328 @@
+import { parseChartScene, parseDrawableWorkspaceDocument, parseDrawingDocument, serializeCanonicalDrawableWorkspace, } from '@baron1996/kline-scene-schema';
+import { MainSeriesPresentationError, STANDARD_CLOSE_LINE_PRESENTATION, } from '@baron1996/klinecharts-adapter';
+import { DrawingProjectionService, } from './projection-service.js';
+import { getSceneRuntime } from './scene-runtime-factory.js';
+import { DrawingSessionController, DrawingSessionError, } from './session-controller.js';
+import { deepFreeze, WORKSPACE_EVENT_PROTOCOL, WORKSPACE_EVENT_PROTOCOL_VERSION, } from './workspace-events.js';
+function drawingToSnapshot(drawing) {
+    return {
+        id: drawing.id,
+        type: drawing.type,
+        target: structuredClone(drawing.target),
+        geometry: structuredClone(drawing.geometry),
+        styles: structuredClone(drawing.styles),
+        locked: drawing.locked,
+        visible: drawing.visible,
+        zLevel: drawing.zLevel,
+        mode: drawing.mode,
+    };
+}
+function snapshotToDrawing(snapshot) {
+    return {
+        id: snapshot.id,
+        type: snapshot.type,
+        target: structuredClone(snapshot.target),
+        geometry: structuredClone(snapshot.geometry),
+        styles: structuredClone(snapshot.styles),
+        locked: snapshot.locked,
+        visible: snapshot.visible,
+        zLevel: snapshot.zLevel,
+        mode: snapshot.mode,
+    };
+}
+/**
+ * 组合 Scene Adapter、Drawing 会话与公共能力的工作区 Runtime。
+ * confirmed 文档唯一权威；宿主持久化只消费候选事件。
+ */
+export class DrawableWorkspaceRuntime {
+    #container;
+    #workspace;
+    #engine;
+    #session;
+    #projectionService = new DrawingProjectionService();
+    #registration;
+    #runtimeId;
+    #listeners = new Set();
+    #sequence = 0;
+    #destroyed = false;
+    #scene;
+    constructor(container, workspace, engine, options) {
+        this.#container = container;
+        this.#workspace = workspace;
+        this.#engine = engine;
+        this.#runtimeId = `drawable-workspace-${Math.random().toString(36).slice(2)}`;
+        this.#scene = workspace.scene.document;
+        this.#registration = getSceneRuntime(workspace.scene.kind);
+        this.#session = new DrawingSessionController({
+            runtimeId: this.#runtimeId,
+            commitMode: options.commitMode,
+            engine,
+            projectionService: this.#projectionService,
+            scene: this.#projectionScene(),
+            valueAxes: workspace.drawings.coordinateSystem.valueAxes,
+            target: this.#registration.defaultTarget,
+            scopeKey: workspace.drawings.scopeKey,
+            timezone: workspace.drawings.coordinateSystem.timezone,
+            buildDocument: (drawings) => this.#buildDocument(drawings),
+            emit: (event) => this.#emit(event),
+        });
+        this.#session.restoreConfirmed(workspace.drawings.drawings.map((drawing) => drawingToSnapshot(drawing)));
+        if (options.onEvent !== undefined) {
+            this.#listeners.add(options.onEvent);
+        }
+    }
+    static async create(container, value, options) {
+        const workspace = parseDrawableWorkspaceDocument(value);
+        const registration = getSceneRuntime(workspace.scene.kind);
+        const engine = await registration.createAdapter(container, workspace);
+        return new DrawableWorkspaceRuntime(container, workspace, engine, options);
+    }
+    startDrawing(type, options) {
+        return this.#session.startCreate(type, options);
+    }
+    listDrawings() {
+        return this.#session.confirmedDrawings;
+    }
+    getDrawing(id) {
+        return this.#session.confirmedDrawings.find((drawing) => drawing.id === id);
+    }
+    updateDrawingStyles(id, styles) {
+        return this.#session.updateDrawingStyles(id, styles);
+    }
+    updateDrawingText(id, text) {
+        return this.#session.updateDrawingText(id, text);
+    }
+    removeDrawing(id) {
+        return this.#session.removeDrawing(id);
+    }
+    requestDrawingDelete(id) {
+        this.removeDrawing(id);
+    }
+    selectDrawing(id) {
+        this.#session.selectDrawing(id);
+    }
+    getSelectedDrawingId() {
+        return this.#session.selectedId ?? undefined;
+    }
+    hitTestDrawing(point) {
+        return this.#engine.hitTestDrawing(point);
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => {
+            this.#listeners.delete(listener);
+        };
+    }
+    getRuntimeCapabilityDescriptor(options = {}) {
+        this.#assertUsable();
+        const kind = this.#sceneKind();
+        const supportedScales = kind === 'chart'
+            ? ['linear', 'logarithmic']
+            : ['linear'];
+        const activeScale = kind === 'chart'
+            ? this.#activeScale()
+            : 'linear';
+        return {
+            drawingTypes: [
+                'horizontalRayLine', 'horizontalSegment', 'horizontalStraightLine',
+                'verticalRayLine', 'verticalSegment', 'verticalStraightLine',
+                'rayLine', 'segment', 'straightLine', 'priceLine',
+                'priceChannelLine', 'parallelStraightLine', 'fibonacciLine', 'brush',
+                'simpleAnnotation', 'simpleTag',
+                'priceMeasurement', 'rectangle', 'arrow', 'crossLine', 'callout', 'text',
+            ],
+            valueAxis: {
+                supportedScales,
+                activeScale,
+                mutable: kind === 'chart',
+            },
+            exportArtifact: {
+                kind: 'drawable-workspace',
+                mediaType: 'application/json',
+                defaultFileName: 'drawable-workspace.json',
+            },
+            mainSeriesPresentation: kind === 'chart'
+                ? {
+                    presentations: [
+                        { type: 'candle_solid' },
+                        { type: 'candle_stroke' },
+                        { type: 'candle_up_stroke' },
+                        { type: 'candle_down_stroke' },
+                        { type: 'ohlc' },
+                        STANDARD_CLOSE_LINE_PRESENTATION,
+                    ],
+                    activeType: this.#scene.chart.candle.type,
+                    mutable: true,
+                }
+                : null,
+            hostActions: options.hostActions ?? [],
+        };
+    }
+    exportDrawingDocument() {
+        this.#assertUsable();
+        return parseDrawingDocument(this.#buildDocument(this.#session.confirmedDrawings));
+    }
+    exportWorkspace() {
+        this.#assertUsable();
+        const drawings = this.exportDrawingDocument();
+        const workspace = {
+            ...structuredClone(this.#workspace),
+            scene: {
+                kind: this.#sceneKind(),
+                document: structuredClone(this.#scene),
+            },
+            drawings,
+            binding: {
+                scopeKey: drawings.scopeKey,
+                timezone: drawings.coordinateSystem.timezone,
+                valueAxes: drawings.coordinateSystem.valueAxes,
+            },
+        };
+        return parseDrawableWorkspaceDocument(workspace);
+    }
+    exportArtifact(fileName = 'drawable-workspace.json') {
+        this.#assertUsable();
+        return {
+            bytes: serializeCanonicalDrawableWorkspace(this.exportWorkspace()),
+            mediaType: 'application/json',
+            fileName,
+        };
+    }
+    async setValueAxisScale(scale) {
+        this.#assertUsable();
+        if (this.#sceneKind() !== 'chart') {
+            throw new Error('VALUE_AXIS_SCALE_UNSUPPORTED: time-series Workspaces are linear-only.');
+        }
+        const scene = this.#scene;
+        const paneIndex = scene.panes.findIndex((pane) => pane.kind === 'candle');
+        const axisIndex = scene.panes[paneIndex].yAxes.findIndex((axis) => axis.role === 'primary');
+        const candidate = parseChartScene({
+            ...structuredClone(scene),
+            panes: scene.panes.map((pane, index) => index === paneIndex
+                ? {
+                    ...structuredClone(pane),
+                    yAxes: pane.yAxes.map((axis, axisIndexValue) => axisIndexValue === axisIndex
+                        ? { ...structuredClone(axis), scale }
+                        : axis),
+                }
+                : pane),
+        });
+        this.#assertSceneProjection(candidate);
+        const engine = this.#engine;
+        await engine.setPriceScale(scale);
+        this.#scene = candidate;
+        this.#emit({ type: 'value-axis-scale-changed', scale });
+        return structuredClone(candidate);
+    }
+    setMainSeriesPresentation(presentation) {
+        this.#assertUsable();
+        if (this.#sceneKind() !== 'chart') {
+            throw new MainSeriesPresentationError('MAIN_SERIES_PRESENTATION_UNSUPPORTED', '/chart/candle', 'time-series Workspaces do not support main series presentation.');
+        }
+        const engine = this.#engine;
+        const result = engine.applyMainSeriesPresentation(presentation);
+        this.#scene = this.#engine.exportScene();
+        this.#emit({
+            type: 'main-series-presentation-changed',
+            activeType: result.activeType,
+        });
+        return result;
+    }
+    replaceScene(scene) {
+        this.#assertUsable();
+        const candidate = this.#registration.parseScene(scene);
+        if ((this.#sceneKind() === 'chart' && !('panes' in candidate)) ||
+            (this.#sceneKind() === 'time-series' && !('series' in candidate))) {
+            throw new Error('DRAWABLE_SCENE_KIND_UNSUPPORTED: cross-kind replacement is rejected.');
+        }
+        this.#assertSceneProjection(candidate);
+        const engine = this.#engine;
+        const applied = engine.replaceScene(candidate);
+        this.#scene = applied;
+        this.#emit({ type: 'scene-replaced', scene: { kind: this.#sceneKind(), document: applied } });
+        return structuredClone(applied);
+    }
+    commitDrawingChange(requestId, canonicalHash) {
+        return this.#session.commitDrawingChange(requestId, canonicalHash);
+    }
+    rejectDrawingChange(requestId) {
+        return this.#session.rejectDrawingChange(requestId);
+    }
+    requestHostAction(actionId, drawingId) {
+        this.#emit({
+            type: 'host-action-requested',
+            actionId,
+            drawingId: drawingId ?? null,
+        });
+    }
+    destroy() {
+        if (this.#destroyed) {
+            return;
+        }
+        this.#destroyed = true;
+        this.#session.destroy();
+        this.#engine.dispose();
+        this.#listeners.clear();
+        this.#emit({ type: 'destroyed' });
+    }
+    #buildDocument(drawings) {
+        const workspace = this.#workspace;
+        return parseDrawingDocument({
+            schema: '@baron1996/drawing-document',
+            version: 1,
+            scopeKey: workspace.drawings.scopeKey,
+            coordinateSystem: structuredClone(workspace.drawings.coordinateSystem),
+            drawings: drawings.map((snapshot) => snapshotToDrawing(snapshot)),
+            metadata: {},
+        });
+    }
+    #projectionScene() {
+        return {
+            kind: this.#sceneKind(),
+            document: this.#scene,
+        };
+    }
+    #assertSceneProjection(scene) {
+        this.#projectionService.projectDocument({
+            scene: {
+                kind: this.#sceneKind(),
+                document: scene,
+            },
+            drawings: this.exportDrawingDocument(),
+        });
+    }
+    #activeScale() {
+        const scene = this.#scene;
+        return scene.panes
+            .find((pane) => pane.kind === 'candle')
+            ?.yAxes.find((axis) => axis.role === 'primary')?.scale ?? 'linear';
+    }
+    #sceneKind() {
+        return 'panes' in this.#scene ? 'chart' : 'time-series';
+    }
+    #emit(event) {
+        const envelope = deepFreeze({
+            protocol: WORKSPACE_EVENT_PROTOCOL,
+            protocolVersion: WORKSPACE_EVENT_PROTOCOL_VERSION,
+            runtimeId: this.#runtimeId,
+            sequence: ++this.#sequence,
+            ...event,
+        });
+        for (const listener of this.#listeners) {
+            try {
+                listener(structuredClone(envelope));
+            }
+            catch {
+                // 单个监听器抛错不改变状态、不阻断其他监听器。
+            }
+        }
+    }
+    #assertUsable() {
+        if (this.#destroyed || this.#session.state === 'terminal-error') {
+            throw new DrawingSessionError('DRAWABLE_WORKSPACE_RUNTIME_DESTROYED', '/', 'The Workspace Runtime is in a destroy-only state.');
+        }
+    }
+}
+export async function createDrawableWorkspaceRuntime(container, workspace, options) {
+    return DrawableWorkspaceRuntime.create(container, workspace, options);
+}

package/dist/index.d.ts

@@ -1,6 +1,13 @@
 /** Web Runtime npm 包版本；ChartScene runtimeVersion 是独立的数据契约版本。 */
-export declare const WEB_RUNTIME_PACKAGE_VERSION: "0.3.0";
+export declare const WEB_RUNTIME_PACKAGE_VERSION: "0.4.0";
 export { SUPPORTED_OVERLAYS } from '@baron1996/klinecharts-adapter';
+export * from './drawing/capabilities.js';
+export * from './drawing/projection-service.js';
+export * from './drawing/runtime-capability-descriptor.js';
+export * from './drawing/scene-runtime-factory.js';
+export * from './drawing/session-controller.js';
+export * from './drawing/workspace-events.js';
+export * from './drawing/workspace-runtime.js';
 export * from './runtime.js';
 export * from './time-series-runtime.js';
 export * from './time-series-types.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,EAAG,OAAgB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,EAAG,OAAgB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -1,6 +1,13 @@
 /** Web Runtime npm 包版本；ChartScene runtimeVersion 是独立的数据契约版本。 */
-export const WEB_RUNTIME_PACKAGE_VERSION = '0.3.0';
+export const WEB_RUNTIME_PACKAGE_VERSION = '0.4.0';
 export { SUPPORTED_OVERLAYS } from '@baron1996/klinecharts-adapter';
+export * from './drawing/capabilities.js';
+export * from './drawing/projection-service.js';
+export * from './drawing/runtime-capability-descriptor.js';
+export * from './drawing/scene-runtime-factory.js';
+export * from './drawing/session-controller.js';
+export * from './drawing/workspace-events.js';
+export * from './drawing/workspace-runtime.js';
 export * from './runtime.js';
 export * from './time-series-runtime.js';
 export * from './time-series-types.js';

package/dist/runtime.d.ts

@@ -1,12 +1,14 @@
-import type { ChartScene, SceneOverlay } from '@baron1996/kline-scene-schema';
-import { type OverlayHitResult, type PixelCoordinate } from '@baron1996/klinecharts-adapter';
+import { type ChartScene, type SceneOverlay } from '@baron1996/kline-scene-schema';
+import { type EngineDrawingSnapshot, type EnginePixelCoordinate, type MainSeriesPresentation, type OverlayHitResult, type PixelCoordinate } from '@baron1996/klinecharts-adapter';
+import type { DrawingRuntimeCapability, RuntimeAuxiliaryCapability } from './drawing/capabilities.js';
+import type { HostActionDescriptor, RuntimeCapabilityDescriptor } from './drawing/runtime-capability-descriptor.js';
 import type { KLineSceneRuntimeListener, KLineSceneRuntimeOptions, PriceScale, StartOverlayDrawingOptions, SupportedOverlayType } from './types.js';
 export declare const DEFAULT_OVERLAY_STYLES: SceneOverlay['styles'];
 /**
  * 面向 Web、离线 HTML 和测试渲染器的纯场景 Runtime。
  * 该类没有撤销/重做栈，也不公开 KLineCharts Chart 实例。
  */
-export declare class KLineSceneRuntime {
+export declare class KLineSceneRuntime implements DrawingRuntimeCapability, RuntimeAuxiliaryCapability {
     #private;
     private constructor();
     static create(container: HTMLElement, value: unknown, options?: KLineSceneRuntimeOptions): Promise<KLineSceneRuntime>;
@@ -19,6 +21,30 @@ export declare class KLineSceneRuntime {
     }, paneId?: string): PixelCoordinate;
     hitTestOverlay(point: PixelCoordinate): OverlayHitResult | null;
     startOverlayDrawing(type: SupportedOverlayType, options?: StartOverlayDrawingOptions): string;
+    getRuntimeCapabilityDescriptor(options?: Readonly<{
+        readonly hostActions?: readonly HostActionDescriptor[];
+    }>): RuntimeCapabilityDescriptor;
+    setValueAxisScale(scale: PriceScale): Promise<ChartScene>;
+    setMainSeriesPresentation(presentation: MainSeriesPresentation): {
+        readonly activeType: string;
+    };
+    startDrawing(type: SupportedOverlayType, options?: Omit<StartOverlayDrawingOptions, 'paneId' | 'text'> & {
+        readonly text?: string;
+    }): string;
+    listDrawings(): readonly EngineDrawingSnapshot[];
+    getDrawing(id: string): EngineDrawingSnapshot | undefined;
+    updateDrawingStyles(id: string, styles: SceneOverlay['styles']): EngineDrawingSnapshot;
+    updateDrawingText(id: string, text: string): EngineDrawingSnapshot;
+    removeDrawing(id: string): boolean;
+    requestDrawingDelete(id: string): void;
+    getSelectedDrawingId(): string | undefined;
+    selectDrawing(id: string | null): void;
+    hitTestDrawing(point: EnginePixelCoordinate): string | null;
+    exportArtifact(fileName?: string): {
+        bytes: Uint8Array;
+        mediaType: 'application/json';
+        fileName: string;
+    };
     addOverlay(overlay: SceneOverlay): SceneOverlay;
     updateOverlay(overlay: SceneOverlay): SceneOverlay;
     updateOverlayStyles(id: string, styles: SceneOverlay['styles']): SceneOverlay;

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,YAAY,EACZ,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EAGN,KAAK,gBAAgB,EAErB,KAAK,eAAe,EACpB,MAAM,gCAAgC,CAAC;AAIxC,OAAO,KAAK,EAEX,yBAAyB,EACzB,wBAAwB,EACxB,UAAU,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,sBAAsB,EAAE,YAAY,CAAC,QAAQ,CAiBzD,CAAC;AAUF;;;GAGG;AACH,qBAAa,iBAAiB;;IAc7B,OAAO;WAsBa,MAAM,CACzB,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,wBAA6B,GACpC,OAAO,CAAC,iBAAiB,CAAC;IAyCtB,QAAQ,IAAI,UAAU;IAKtB,WAAW,IAAI,UAAU;IAInB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAK3D,YAAY,CAClB,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAC7D,MAAM,CAAC,EAAE,MAAM,GACb,eAAe;IAKX,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,GAAG,IAAI;IAK/D,mBAAmB,CACzB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE,0BAA+B,GACtC,MAAM;IA6BF,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY;IAK/C,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY;IAKlD,mBAAmB,CACzB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAC5B,YAAY;IAKR,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAKlC,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAatC,iBAAiB,CACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAM,GAAG,IAA8B,GAChD,IAAI;IAqBA,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAMhD,YAAY,IAAI,SAAS,YAAY,EAAE;IAKvC,oBAAoB,IAAI,MAAM,GAAG,SAAS;IAK1C,SAAS,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,IAAI;IAK1D,OAAO,IAAI,IAAI;CAUtB;AAED,wBAAsB,uBAAuB,CAC5C,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,wBAA6B,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAE5B"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}

package/dist/runtime.js

@@ -1,5 +1,7 @@
+import { serializeCanonicalScene, } from '@baron1996/kline-scene-schema';
 import { parseChartScene, SceneError, } from '@baron1996/kline-scene-schema';
-import { KLineChartsSceneAdapter, } from '@baron1996/klinecharts-adapter';
+import { KLineChartsSceneAdapter, STANDARD_CLOSE_LINE_PRESENTATION, SUPPORTED_OVERLAYS, } from '@baron1996/klinecharts-adapter';
+import { overlayToDrawingSnapshot } from './drawing/legacy-runtime-capability.js';
 import { RuntimeEventBus } from './events.js';
 import { runRuntimeTeardowns } from './lifecycle.js';
 export const DEFAULT_OVERLAY_STYLES = {
@@ -60,6 +62,7 @@ export class KLineSceneRuntime {
             this.#events.emit(toRuntimeEvent(event));
         });
     }
+    #defaultFileName = 'kline-scene.json';
     static async create(container, value, options = {}) {
         try {
             const scene = parseChartScene(value);
@@ -144,6 +147,99 @@ export class KLineSceneRuntime {
         };
         return this.#adapter.startOverlayDrawing(request);
     }
+    getRuntimeCapabilityDescriptor(options = {}) {
+        const scene = this.getScene();
+        const pane = scene.panes.find((candidate) => candidate.kind === 'candle');
+        const primaryAxis = pane?.yAxes.find((axis) => axis.role === 'primary');
+        const supportedScales = scene.runtime.runtimeVersion === '0.2.0'
+            ? ['linear', 'logarithmic']
+            : ['linear'];
+        return {
+            drawingTypes: [...SUPPORTED_OVERLAYS],
+            valueAxis: {
+                supportedScales,
+                activeScale: primaryAxis?.scale ?? 'linear',
+                mutable: true,
+            },
+            exportArtifact: {
+                kind: 'chart-scene',
+                mediaType: 'application/json',
+                defaultFileName: this.#defaultFileName,
+            },
+            hostActions: options.hostActions ?? [],
+            mainSeriesPresentation: {
+                presentations: [
+                    { type: 'candle_solid' },
+                    { type: 'candle_stroke' },
+                    { type: 'candle_up_stroke' },
+                    { type: 'candle_down_stroke' },
+                    { type: 'ohlc' },
+                    STANDARD_CLOSE_LINE_PRESENTATION,
+                ],
+                activeType: scene.chart.candle.type,
+                mutable: true,
+            },
+        };
+    }
+    setValueAxisScale(scale) {
+        return this.setPriceScale(scale);
+    }
+    setMainSeriesPresentation(presentation) {
+        return this.#adapter.applyMainSeriesPresentation(presentation);
+    }
+    startDrawing(type, options) {
+        const resolved = options === undefined
+            ? {}
+            : options;
+        return this.startOverlayDrawing(type, resolved);
+    }
+    listDrawings() {
+        return this.listOverlays().map((overlay) => overlayToDrawingSnapshot(overlay, this.getScene().period));
+    }
+    getDrawing(id) {
+        const overlay = this.getOverlay(id);
+        return overlay === undefined
+            ? undefined
+            : overlayToDrawingSnapshot(overlay, this.getScene().period);
+    }
+    updateDrawingStyles(id, styles) {
+        return overlayToDrawingSnapshot(this.updateOverlayStyles(id, styles), this.getScene().period);
+    }
+    updateDrawingText(id, text) {
+        const overlay = this.getOverlay(id);
+        if (overlay === undefined) {
+            throw new SceneError('INVALID_REFERENCE', `/overlays/${id}`, `Overlay ${id} does not exist.`);
+        }
+        if (overlay.type !== 'simpleTag' &&
+            overlay.type !== 'simpleAnnotation' &&
+            overlay.type !== 'callout' &&
+            overlay.type !== 'text') {
+            throw new SceneError('SCENE_SCHEMA_INVALID', `/overlays/${id}/text`, 'Text updates are only supported on text Drawing types.');
+        }
+        return overlayToDrawingSnapshot(this.updateOverlay({ ...overlay, text }), this.getScene().period);
+    }
+    removeDrawing(id) {
+        return this.removeOverlay(id);
+    }
+    requestDrawingDelete(id) {
+        this.requestOverlayDelete(id);
+    }
+    getSelectedDrawingId() {
+        return this.getSelectedOverlayId();
+    }
+    selectDrawing(id) {
+        this.#adapter.selectDrawing(id);
+    }
+    hitTestDrawing(point) {
+        return this.#adapter.hitTestOverlay(point)?.overlayId ?? null;
+    }
+    exportArtifact(fileName = this.#defaultFileName) {
+        return {
+            bytes: serializeCanonicalScene(this.exportScene()),
+            mediaType: 'application/json',
+            fileName,
+        };
+    }
     addOverlay(overlay) {
         this.#assertActive();
         return structuredClone(this.#adapter.addOverlay(structuredClone(overlay)));

package/dist/toolbar/standard-toolbar-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-toolbar-styles.d.ts","sourceRoot":"","sources":["../../src/toolbar/standard-toolbar-styles.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,QA4PnC,CAAC"}
+{"version":3,"file":"standard-toolbar-styles.d.ts","sourceRoot":"","sources":["../../src/toolbar/standard-toolbar-styles.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,QA8QnC,CAAC"}

package/dist/toolbar/standard-toolbar-styles.js

@@ -250,4 +250,22 @@ export const STANDARD_TOOLBAR_STYLES = String.raw `
 		transition: none;
 	}
 }
+
+.baron-kline-context-menu {
+	position: fixed;
+	z-index: 1000;
+	display: none;
+	flex-direction: column;
+	gap: 8px;
+	min-width: 180px;
+	padding: 10px;
+	border: 1px solid rgba(203, 210, 224, 1);
+	border-radius: 10px;
+	background: rgba(255, 255, 255, 0.98);
+	box-shadow: 0 12px 32px rgba(23, 32, 51, 0.16);
+}
+
+.baron-kline-context-menu--visible {
+	display: flex;
+}
 `;

package/dist/toolbar/standard-toolbar.d.ts

@@ -1,5 +1,7 @@
-import type { KLineSceneRuntime } from '../runtime.js';
+import type { DrawingRuntimeCapability, RuntimeAuxiliaryCapability } from '../drawing/capabilities.js';
 import type { StandardToolbar, StandardToolbarOptions } from '../types.js';
+type StandardDrawingRuntime = DrawingRuntimeCapability & RuntimeAuxiliaryCapability;
 /** 创建不含撤销/重做的标准离线编辑工具栏。 */
-export declare function createStandardToolbar(container: HTMLElement, runtime: KLineSceneRuntime, options?: StandardToolbarOptions): StandardToolbar;
+export declare function createStandardToolbar(container: HTMLElement, runtime: StandardDrawingRuntime, options?: StandardToolbarOptions): StandardToolbar;
+export {};
 //# sourceMappingURL=standard-toolbar.d.ts.map

package/dist/toolbar/standard-toolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-toolbar.d.ts","sourceRoot":"","sources":["../../src/toolbar/standard-toolbar.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EACX,eAAe,EACf,sBAAsB,EAEtB,MAAM,aAAa,CAAC;AA8NrB,2BAA2B;AAC3B,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,sBAA2B,GAClC,eAAe,CA4NjB"}
+{"version":3,"file":"standard-toolbar.d.ts","sourceRoot":"","sources":["../../src/toolbar/standard-toolbar.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACX,eAAe,EACf,sBAAsB,EAEtB,MAAM,aAAa,CAAC;AAyCrB,KAAK,sBAAsB,GAAG,wBAAwB,GAAG,0BAA0B,CAAC;AA0LpF,2BAA2B;AAC3B,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,GAAE,sBAA2B,GAClC,eAAe,CA2YjB"}