@baron1996/klinecharts-runtime 0.5.1 → 0.7.1

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.5.1 @baron1996/klinecharts-runtime@0.5.1
+npm install --save-exact @baron1996/kline-scene-schema@0.6.0 @baron1996/klinecharts-runtime@0.7.1
 ```
 
 ```ts
@@ -45,3 +45,53 @@ Runtime `0.2.0` events are structured-cloneable pure data with
 `sceneVersion: 1` and `runtimeVersion: '0.2.0'`. Measurement scenes persist only
 their two data-coordinate endpoints, styles, and opaque metadata; displayed absolute
 and percentage changes are derived.
+
+## Cross-period Drawing orchestration
+
+Cross-period Drawing uses the existing `DrawableWorkspaceRuntime` in explicit
+`host-confirmed` mode. The coordinator binds a host-owned stable instrument key to
+the Workspace `scopeKey`, loads a complete replacement Scene through a host port,
+and commits a Drawing candidate only after the persistence receipt returns the exact
+Runtime canonical hash.
+
+```ts
+import {
+  createCrossPeriodDrawingCoordinator,
+  createDrawableWorkspaceRuntime,
+} from '@baron1996/klinecharts-runtime';
+
+const runtime = await createDrawableWorkspaceRuntime(container, loadedWorkspace, {
+  commitMode: 'host-confirmed',
+});
+
+const coordinator = createCrossPeriodDrawingCoordinator(
+  runtime,
+  {
+    instrumentKey: 'CN:600519',
+    scopeKey: loadedWorkspace.drawings.scopeKey,
+  },
+  {
+    initialRevision: loadedRevision,
+    async loadScene({ binding, period, currentWorkspace }) {
+      // The host assembles a complete Scene. Financial market data must come
+      // through fxxking-data.
+      return hostSceneLoader.load({ binding, period, currentWorkspace });
+    },
+    async persistCandidate(request) {
+      // owner, permissions, audit and database transactions stay in the host.
+      return drawingRepository.compareAndSet(request);
+    },
+  },
+);
+
+await coordinator.switchPeriod({ type: 'week', span: 1 });
+await coordinator.waitForIdle();
+
+coordinator.destroy();
+runtime.destroy();
+```
+
+The coordinator never derives `scopeKey` from `scene.symbol.ticker`, never accesses
+the KLineCharts `Chart`, and never converts legacy `ChartScene.overlays` into a
+Workspace. A Scene switch changes only `workspace.scene`; the confirmed
+`DrawingDocument` remains byte-identical.

package/dist/cross-period/coordinator.d.ts

@@ -0,0 +1,110 @@
+import type { ChartScene, DrawableWorkspaceDocument, DrawingDocument, Period, TimeSeriesScene } from '@baron1996/kline-scene-schema';
+import type { WorkspaceDrawingOperation, WorkspaceRuntimeListener } from '../drawing/workspace-events.js';
+export type CrossPeriodDrawingState = 'ready' | 'switching-period' | 'persisting-drawing' | 'terminal-error' | 'destroyed';
+export type CrossPeriodDrawingErrorCode = 'CROSS_PERIOD_INVALID_BINDING' | 'CROSS_PERIOD_SCOPE_MISMATCH' | 'CROSS_PERIOD_RUNTIME_MODE_UNSUPPORTED' | 'CROSS_PERIOD_OPERATION_IN_PROGRESS' | 'CROSS_PERIOD_RUNTIME_DESTROYED' | 'CROSS_PERIOD_PERSISTENCE_FAILED' | 'CROSS_PERIOD_PERSISTENCE_HASH_MISMATCH' | 'CROSS_PERIOD_COMMIT_AFTER_PERSIST_FAILED' | 'CROSS_PERIOD_CANDIDATE_RESTORE_FAILED' | 'CROSS_PERIOD_SCENE_PERIOD_MISMATCH' | 'CROSS_PERIOD_SCENE_SWITCH_FAILED';
+export declare class CrossPeriodDrawingError extends Error {
+    readonly code: CrossPeriodDrawingErrorCode;
+    readonly path: string;
+    constructor(code: CrossPeriodDrawingErrorCode, path: string, message: string);
+}
+export interface CrossPeriodInstrumentBinding {
+    /** 宿主提供的稳定标的身份；不得由 ticker 或展示名称推断。 */
+    readonly instrumentKey: string;
+    /** 与 DrawingDocument.scopeKey 一对一绑定的不透明范围键。 */
+    readonly scopeKey: string;
+}
+export type CrossPeriodRevision = string | null;
+export interface CrossPeriodSceneLoadRequest {
+    readonly binding: CrossPeriodInstrumentBinding;
+    readonly period: Period;
+    readonly currentWorkspace: DrawableWorkspaceDocument;
+}
+export type CrossPeriodSceneLoader = (request: CrossPeriodSceneLoadRequest) => Promise<ChartScene | TimeSeriesScene>;
+export interface CrossPeriodDrawingPersistenceRequest {
+    readonly binding: CrossPeriodInstrumentBinding;
+    readonly requestId: string;
+    readonly operation: WorkspaceDrawingOperation;
+    readonly canonicalHash: string;
+    readonly idempotencyKey: string;
+    readonly expectedRevision: CrossPeriodRevision;
+    readonly candidateDocument: DrawingDocument;
+    readonly candidateWorkspace: DrawableWorkspaceDocument;
+}
+export interface CrossPeriodDrawingPersistenceReceipt {
+    readonly canonicalHash: string;
+    readonly revision: CrossPeriodRevision;
+}
+export type CrossPeriodDrawingPersistencePort = (request: CrossPeriodDrawingPersistenceRequest) => Promise<CrossPeriodDrawingPersistenceReceipt>;
+/**
+ * 跨周期层使用的最小 Workspace Runtime 端口。
+ * 端口只含公共文档与事务操作，不暴露 Adapter、Chart 或投影实现。
+ */
+export interface CrossPeriodWorkspaceRuntimePort {
+    readonly commitMode: 'immediate' | 'host-confirmed';
+    exportWorkspace(): DrawableWorkspaceDocument;
+    replaceScene(scene: ChartScene | TimeSeriesScene): ChartScene | TimeSeriesScene;
+    commitDrawingChange(requestId: string, canonicalHash: string): boolean;
+    rejectDrawingChange(requestId: string): boolean;
+    subscribe(listener: WorkspaceRuntimeListener): () => void;
+}
+export interface CrossPeriodDrawingCoordinatorOptions {
+    readonly initialRevision: CrossPeriodRevision;
+    readonly loadScene: CrossPeriodSceneLoader;
+    readonly persistCandidate: CrossPeriodDrawingPersistencePort;
+    readonly onEvent?: CrossPeriodDrawingCoordinatorListener;
+}
+export type CrossPeriodDrawingCoordinatorEvent = {
+    readonly type: 'state-changed';
+    readonly state: CrossPeriodDrawingState;
+} | {
+    readonly type: 'drawing-persistence-started';
+    readonly requestId: string;
+    readonly canonicalHash: string;
+    readonly expectedRevision: CrossPeriodRevision;
+} | {
+    readonly type: 'drawing-persistence-committed';
+    readonly requestId: string;
+    readonly canonicalHash: string;
+    readonly revision: CrossPeriodRevision;
+} | {
+    readonly type: 'drawing-persistence-rejected';
+    readonly requestId: string;
+    readonly canonicalHash: string;
+    readonly code: CrossPeriodDrawingErrorCode;
+    readonly message: string;
+} | {
+    readonly type: 'period-switch-started';
+    readonly period: Period;
+} | {
+    readonly type: 'period-switch-completed';
+    readonly period: Period;
+    readonly scene: ChartScene | TimeSeriesScene;
+} | {
+    readonly type: 'period-switch-failed';
+    readonly period: Period;
+    readonly code: CrossPeriodDrawingErrorCode;
+    readonly message: string;
+} | {
+    readonly type: 'terminal-error';
+    readonly code: CrossPeriodDrawingErrorCode;
+    readonly message: string;
+} | {
+    readonly type: 'destroyed';
+};
+export type CrossPeriodDrawingCoordinatorListener = (event: CrossPeriodDrawingCoordinatorEvent) => void;
+/**
+ * 只负责编排 scope、周期切换和宿主持久化；所有画线事实与事务仍由 Workspace Runtime 权威管理。
+ */
+export declare class CrossPeriodDrawingCoordinator {
+    #private;
+    constructor(runtime: CrossPeriodWorkspaceRuntimePort, binding: CrossPeriodInstrumentBinding, options: CrossPeriodDrawingCoordinatorOptions);
+    get state(): CrossPeriodDrawingState;
+    get currentRevision(): CrossPeriodRevision;
+    get instrumentBinding(): CrossPeriodInstrumentBinding;
+    subscribe(listener: CrossPeriodDrawingCoordinatorListener): () => void;
+    switchPeriod(period: Period): Promise<ChartScene | TimeSeriesScene>;
+    waitForIdle(): Promise<void>;
+    destroy(): void;
+}
+export declare function createCrossPeriodDrawingCoordinator(runtime: CrossPeriodWorkspaceRuntimePort, binding: CrossPeriodInstrumentBinding, options: CrossPeriodDrawingCoordinatorOptions): CrossPeriodDrawingCoordinator;
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/cross-period/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/cross-period/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,yBAAyB,EACzB,eAAe,EACf,MAAM,EACN,eAAe,EACf,MAAM,+BAA+B,CAAC;AAMvC,OAAO,KAAK,EACX,yBAAyB,EAEzB,wBAAwB,EACxB,MAAM,gCAAgC,CAAC;AAGxC,MAAM,MAAM,uBAAuB,GAChC,OAAO,GACP,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,GAChB,WAAW,CAAC;AAEf,MAAM,MAAM,2BAA2B,GACpC,8BAA8B,GAC9B,6BAA6B,GAC7B,uCAAuC,GACvC,oCAAoC,GACpC,gCAAgC,GAChC,iCAAiC,GACjC,wCAAwC,GACxC,0CAA0C,GAC1C,uCAAuC,GACvC,oCAAoC,GACpC,kCAAkC,CAAC;AAEtC,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,SAAgB,IAAI,EAAE,2BAA2B,CAAC;IAClD,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAG5B,IAAI,EAAE,2BAA2B,EACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM;CAOhB;AAED,MAAM,WAAW,4BAA4B;IAC5C,sCAAsC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAC;AAEhD,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;CACrD;AAED,MAAM,MAAM,sBAAsB,GAAG,CACpC,OAAO,EAAE,2BAA2B,KAChC,OAAO,CAAC,UAAU,GAAG,eAAe,CAAC,CAAC;AAE3C,MAAM,WAAW,oCAAoC;IACpD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,eAAe,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;CACvD;AAED,MAAM,WAAW,oCAAoC;IACpD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACvC;AAED,MAAM,MAAM,iCAAiC,GAAG,CAC/C,OAAO,EAAE,oCAAoC,KACzC,OAAO,CAAC,oCAAoC,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,gBAAgB,CAAC;IACpD,eAAe,IAAI,yBAAyB,CAAC;IAC7C,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,GAAG,UAAU,GAAG,eAAe,CAAC;IAChF,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IACvE,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,SAAS,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,oCAAoC;IACpD,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,qCAAqC,CAAC;CACzD;AAED,MAAM,MAAM,kCAAkC,GAC3C;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAA;CAAE,GAC3E;IACA,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;CAC9C,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACtC,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACxB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnE;IACA,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CAAC;CAC5C,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACxB,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACxB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,qCAAqC,GAAG,CACnD,KAAK,EAAE,kCAAkC,KACrC,IAAI,CAAC;AAsDV;;GAEG;AACH,qBAAa,6BAA6B;;gBAiBxC,OAAO,EAAE,+BAA+B,EACxC,OAAO,EAAE,4BAA4B,EACrC,OAAO,EAAE,oCAAoC;IAuB9C,IAAW,KAAK,IAAI,uBAAuB,CAE1C;IAED,IAAW,eAAe,IAAI,mBAAmB,CAEhD;IAED,IAAW,iBAAiB,IAAI,4BAA4B,CAE3D;IAEM,SAAS,CAAC,QAAQ,EAAE,qCAAqC,GAAG,MAAM,IAAI;IAQtE,YAAY,CAClB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,GAAG,eAAe,CAAC;IAS3B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,OAAO,IAAI,IAAI;CA2TtB;AAED,wBAAgB,mCAAmC,CAClD,OAAO,EAAE,+BAA+B,EACxC,OAAO,EAAE,4BAA4B,EACrC,OAAO,EAAE,oCAAoC,GAC3C,6BAA6B,CAE/B"}

package/dist/cross-period/coordinator.js

@@ -0,0 +1,328 @@
+import { parseDrawableWorkspaceDocument, serializeCanonicalDrawingDocument, } from '@baron1996/kline-scene-schema';
+import { deepFreeze } from '../drawing/workspace-events.js';
+export class CrossPeriodDrawingError extends Error {
+    code;
+    path;
+    constructor(code, path, message) {
+        super(message);
+        this.name = 'CrossPeriodDrawingError';
+        this.code = code;
+        this.path = path;
+    }
+}
+function assertBinding(binding) {
+    if (typeof binding.instrumentKey !== 'string' ||
+        binding.instrumentKey.length === 0 ||
+        binding.instrumentKey.length > 256) {
+        throw new CrossPeriodDrawingError('CROSS_PERIOD_INVALID_BINDING', '/instrumentKey', 'instrumentKey must be a non-empty string with at most 256 characters.');
+    }
+    if (typeof binding.scopeKey !== 'string' ||
+        binding.scopeKey.length === 0 ||
+        binding.scopeKey.length > 256) {
+        throw new CrossPeriodDrawingError('CROSS_PERIOD_INVALID_BINDING', '/scopeKey', 'scopeKey must be a non-empty string with at most 256 characters.');
+    }
+}
+function sameBytes(left, right) {
+    if (left.byteLength !== right.byteLength) {
+        return false;
+    }
+    for (let index = 0; index < left.byteLength; index += 1) {
+        if (left[index] !== right[index]) {
+            return false;
+        }
+    }
+    return true;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function idempotencyKey(binding, canonicalHash) {
+    return [
+        'cross-period-drawing',
+        encodeURIComponent(binding.scopeKey),
+        canonicalHash,
+    ].join(':');
+}
+/**
+ * 只负责编排 scope、周期切换和宿主持久化；所有画线事实与事务仍由 Workspace Runtime 权威管理。
+ */
+export class CrossPeriodDrawingCoordinator {
+    /** 唯一 Workspace 事务入口；不包含 Adapter 或 Chart。 */
+    #runtime;
+    /** 宿主显式提供且全生命周期不可变的标的范围绑定。 */
+    #binding;
+    /** 行情 Scene 加载与持久化副作用均通过宿主端口注入。 */
+    #options;
+    #listeners = new Set();
+    /** 用于 waitForIdle 覆盖 Scene 加载和异步 Drawing 确认。 */
+    #pendingOperations = new Set();
+    #unsubscribeRuntime;
+    /** 编排状态与 DrawingSessionController 状态相互独立，不取代其权威。 */
+    #state = 'ready';
+    /** 最近一次成功持久化并完成 Runtime commit 后的宿主 revision。 */
+    #revision;
+    constructor(runtime, binding, options) {
+        assertBinding(binding);
+        if (runtime.commitMode !== 'host-confirmed') {
+            throw new CrossPeriodDrawingError('CROSS_PERIOD_RUNTIME_MODE_UNSUPPORTED', '/commitMode', 'Cross-period persistence requires a host-confirmed Workspace Runtime.');
+        }
+        this.#assertWorkspaceScope(runtime.exportWorkspace(), binding);
+        this.#runtime = runtime;
+        this.#binding = structuredClone(binding);
+        this.#options = options;
+        this.#revision = options.initialRevision;
+        if (options.onEvent !== undefined) {
+            this.#listeners.add(options.onEvent);
+        }
+        this.#unsubscribeRuntime = runtime.subscribe((event) => this.#onWorkspaceEvent(event));
+    }
+    get state() {
+        return this.#state;
+    }
+    get currentRevision() {
+        return this.#revision;
+    }
+    get instrumentBinding() {
+        return structuredClone(this.#binding);
+    }
+    subscribe(listener) {
+        this.#assertUsable();
+        this.#listeners.add(listener);
+        return () => {
+            this.#listeners.delete(listener);
+        };
+    }
+    switchPeriod(period) {
+        this.#assertReady();
+        const requestedPeriod = structuredClone(period);
+        this.#setState('switching-period');
+        const operation = this.#performPeriodSwitch(requestedPeriod);
+        this.#track(operation.then(() => undefined, () => undefined));
+        return operation;
+    }
+    async waitForIdle() {
+        while (this.#pendingOperations.size > 0) {
+            await Promise.all([...this.#pendingOperations]);
+        }
+    }
+    destroy() {
+        if (this.#state === 'destroyed') {
+            return;
+        }
+        if (this.#state === 'terminal-error') {
+            this.#unsubscribeRuntime();
+            this.#state = 'destroyed';
+            this.#emit({ type: 'destroyed' });
+            this.#listeners.clear();
+            return;
+        }
+        if (this.#state !== 'ready' || this.#pendingOperations.size > 0) {
+            throw new CrossPeriodDrawingError('CROSS_PERIOD_OPERATION_IN_PROGRESS', '/', 'Cross-period coordinator cannot be destroyed while an operation is pending.');
+        }
+        this.#unsubscribeRuntime();
+        this.#state = 'destroyed';
+        this.#emit({ type: 'destroyed' });
+        this.#listeners.clear();
+    }
+    async #performPeriodSwitch(period) {
+        this.#emit({ type: 'period-switch-started', period: structuredClone(period) });
+        try {
+            const before = this.#runtime.exportWorkspace();
+            this.#assertWorkspaceScope(before, this.#binding);
+            const drawingBytes = serializeCanonicalDrawingDocument(before.drawings);
+            const scene = await this.#options.loadScene({
+                binding: structuredClone(this.#binding),
+                period: structuredClone(period),
+                currentWorkspace: structuredClone(before),
+            });
+            if (this.#state !== 'switching-period') {
+                throw new CrossPeriodDrawingError('CROSS_PERIOD_OPERATION_IN_PROGRESS', '/', 'Period switching was interrupted by another coordinator state.');
+            }
+            if (scene.period.type !== period.type ||
+                scene.period.span !== period.span) {
+                throw new CrossPeriodDrawingError('CROSS_PERIOD_SCENE_PERIOD_MISMATCH', '/scene/period', 'The loaded Scene period does not match the requested period.');
+            }
+            const applied = this.#runtime.replaceScene(scene);
+            const after = this.#runtime.exportWorkspace();
+            this.#assertWorkspaceScope(after, this.#binding);
+            if (!sameBytes(drawingBytes, serializeCanonicalDrawingDocument(after.drawings))) {
+                throw this.#enterTerminalError('CROSS_PERIOD_SCENE_SWITCH_FAILED', 'Period switching changed the confirmed DrawingDocument.');
+            }
+            this.#emit({
+                type: 'period-switch-completed',
+                period: structuredClone(period),
+                scene: structuredClone(applied),
+            });
+            return structuredClone(applied);
+        }
+        catch (error) {
+            const normalized = error instanceof CrossPeriodDrawingError
+                ? error
+                : new CrossPeriodDrawingError('CROSS_PERIOD_SCENE_SWITCH_FAILED', '/scene', errorMessage(error));
+            this.#emit({
+                type: 'period-switch-failed',
+                period: structuredClone(period),
+                code: normalized.code,
+                message: normalized.message,
+            });
+            throw normalized;
+        }
+        finally {
+            if (this.#state === 'switching-period') {
+                this.#setState('ready');
+            }
+        }
+    }
+    #onWorkspaceEvent(event) {
+        if (event.type !== 'drawing-candidate' ||
+            this.#state === 'destroyed' ||
+            this.#state === 'terminal-error') {
+            return;
+        }
+        if (this.#state !== 'ready') {
+            const rejection = Promise.resolve().then(() => {
+                this.#rejectCandidate(event, new CrossPeriodDrawingError('CROSS_PERIOD_OPERATION_IN_PROGRESS', '/drawings', 'A Drawing candidate was received while cross-period orchestration was busy.'));
+            });
+            this.#track(rejection);
+            return;
+        }
+        this.#setState('persisting-drawing');
+        const persistence = Promise.resolve().then(() => this.#persistCandidate(event));
+        this.#track(persistence);
+    }
+    async #persistCandidate(event) {
+        this.#emit({
+            type: 'drawing-persistence-started',
+            requestId: event.requestId,
+            canonicalHash: event.canonicalHash,
+            expectedRevision: this.#revision,
+        });
+        let receipt;
+        try {
+            const candidateWorkspace = this.#candidateWorkspace(event.candidateDocument);
+            receipt = await this.#options.persistCandidate({
+                binding: structuredClone(this.#binding),
+                requestId: event.requestId,
+                operation: event.operation,
+                canonicalHash: event.canonicalHash,
+                idempotencyKey: idempotencyKey(this.#binding, event.canonicalHash),
+                expectedRevision: this.#revision,
+                candidateDocument: structuredClone(event.candidateDocument),
+                candidateWorkspace,
+            });
+        }
+        catch (error) {
+            this.#rejectCandidate(event, new CrossPeriodDrawingError('CROSS_PERIOD_PERSISTENCE_FAILED', '/drawings', errorMessage(error)));
+            this.#restoreReadyAfterPersistence();
+            return;
+        }
+        if (receipt.canonicalHash !== event.canonicalHash) {
+            this.#rejectCandidate(event, new CrossPeriodDrawingError('CROSS_PERIOD_PERSISTENCE_HASH_MISMATCH', '/drawings', 'The persistence receipt hash does not match the Runtime candidate hash.'));
+            this.#restoreReadyAfterPersistence();
+            return;
+        }
+        try {
+            if (!this.#runtime.commitDrawingChange(event.requestId, event.canonicalHash)) {
+                throw new Error('Workspace Runtime did not commit the persisted candidate.');
+            }
+        }
+        catch (error) {
+            this.#enterTerminalError('CROSS_PERIOD_COMMIT_AFTER_PERSIST_FAILED', `Persistence succeeded but Runtime commit failed: ${errorMessage(error)}`);
+            return;
+        }
+        this.#revision = receipt.revision;
+        this.#emit({
+            type: 'drawing-persistence-committed',
+            requestId: event.requestId,
+            canonicalHash: event.canonicalHash,
+            revision: this.#revision,
+        });
+        this.#restoreReadyAfterPersistence();
+    }
+    #candidateWorkspace(document) {
+        if (document.scopeKey !== this.#binding.scopeKey) {
+            throw new CrossPeriodDrawingError('CROSS_PERIOD_SCOPE_MISMATCH', '/drawings/scopeKey', 'Drawing candidate scopeKey does not match the instrument binding.');
+        }
+        const current = this.#runtime.exportWorkspace();
+        this.#assertWorkspaceScope(current, this.#binding);
+        return parseDrawableWorkspaceDocument({
+            ...structuredClone(current),
+            drawings: structuredClone(document),
+            binding: {
+                scopeKey: document.scopeKey,
+                timezone: document.coordinateSystem.timezone,
+                valueAxes: structuredClone(document.coordinateSystem.valueAxes),
+            },
+        });
+    }
+    #rejectCandidate(event, error) {
+        try {
+            if (!this.#runtime.rejectDrawingChange(event.requestId)) {
+                throw new Error('Workspace Runtime could not restore the rejected candidate.');
+            }
+        }
+        catch (rejectionError) {
+            this.#enterTerminalError('CROSS_PERIOD_CANDIDATE_RESTORE_FAILED', `Candidate rejection failed: ${errorMessage(rejectionError)}`);
+            return;
+        }
+        this.#emit({
+            type: 'drawing-persistence-rejected',
+            requestId: event.requestId,
+            canonicalHash: event.canonicalHash,
+            code: error.code,
+            message: error.message,
+        });
+    }
+    #restoreReadyAfterPersistence() {
+        if (this.#state === 'persisting-drawing') {
+            this.#setState('ready');
+        }
+    }
+    #assertWorkspaceScope(workspace, binding) {
+        if (workspace.drawings.scopeKey !== binding.scopeKey ||
+            workspace.binding.scopeKey !== binding.scopeKey) {
+            throw new CrossPeriodDrawingError('CROSS_PERIOD_SCOPE_MISMATCH', '/scopeKey', 'Workspace scopeKey does not match the explicit instrument binding.');
+        }
+    }
+    #assertReady() {
+        this.#assertUsable();
+        if (this.#state !== 'ready') {
+            throw new CrossPeriodDrawingError('CROSS_PERIOD_OPERATION_IN_PROGRESS', '/', `Cross-period coordinator is ${this.#state}.`);
+        }
+    }
+    #assertUsable() {
+        if (this.#state === 'destroyed' || this.#state === 'terminal-error') {
+            throw new CrossPeriodDrawingError('CROSS_PERIOD_RUNTIME_DESTROYED', '/', 'The cross-period coordinator is in a destroy-only state.');
+        }
+    }
+    #enterTerminalError(code, message) {
+        const error = new CrossPeriodDrawingError(code, '/', message);
+        this.#setState('terminal-error');
+        this.#emit({ type: 'terminal-error', code, message });
+        return error;
+    }
+    #setState(state) {
+        this.#state = state;
+        this.#emit({ type: 'state-changed', state });
+    }
+    #track(operation) {
+        this.#pendingOperations.add(operation);
+        void operation.finally(() => {
+            this.#pendingOperations.delete(operation);
+        });
+    }
+    #emit(event) {
+        const snapshot = deepFreeze(structuredClone(event));
+        for (const listener of this.#listeners) {
+            try {
+                listener(structuredClone(snapshot));
+            }
+            catch {
+                // 宿主监听器不能改变编排状态或阻断其他监听器。
+            }
+        }
+    }
+}
+export function createCrossPeriodDrawingCoordinator(runtime, binding, options) {
+    return new CrossPeriodDrawingCoordinator(runtime, binding, options);
+}

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

@@ -17,6 +17,10 @@ export interface MainSeriesPresentationCapability {
 export interface HostActionDescriptor {
     readonly actionId: string;
     readonly label: string;
+    readonly pressed?: boolean;
+    readonly disabled?: boolean;
+    readonly pending?: boolean;
+    readonly errorMessage?: string;
 }
 export interface RuntimeCapabilityDescriptor {
     readonly drawingTypes: readonly string[];

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

@@ -1 +1 @@
-{"version":3,"file":"runtime-capability-descriptor.d.ts","sourceRoot":"","sources":["../../src/drawing/runtime-capability-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC,QAAQ,GAAG,aAAa,CAAC,EAAE,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,QAAQ,GAAG,aAAa,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,oBAAoB,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,aAAa,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC1D,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,+BAA+B,CAAC;IACzD,QAAQ,CAAC,sBAAsB,EAAE,gCAAgC,GAAG,IAAI,CAAC;IACzE,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACtD"}
+{"version":3,"file":"runtime-capability-descriptor.d.ts","sourceRoot":"","sources":["../../src/drawing/runtime-capability-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC,QAAQ,GAAG,aAAa,CAAC,EAAE,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,QAAQ,GAAG,aAAa,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,oBAAoB,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,aAAa,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC1D,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,+BAA+B,CAAC;IACzD,QAAQ,CAAC,sBAAsB,EAAE,gCAAgC,GAAG,IAAI,CAAC;IACzE,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACtD"}

package/dist/drawing/session-controller.d.ts

@@ -35,6 +35,8 @@ export declare class DrawingSessionController {
     get state(): DrawingSessionState;
     get confirmedDrawings(): readonly EngineDrawingSnapshot[];
     get selectedId(): string | null;
+    /** 当前已确认的投影 Scene；仅返回深拷贝，协调层不能取得引擎对象。 */
+    get projectionScene(): ProjectionScene;
     restoreConfirmed(drawings: readonly EngineDrawingSnapshot[]): void;
     startCreate(type: string, options?: {
         readonly text?: string;
@@ -45,6 +47,13 @@ export declare class DrawingSessionController {
     updateDrawingText(id: string, text: string): EngineDrawingSnapshot;
     removeDrawing(id: string): boolean;
     selectDrawing(id: string | null): void;
+    /**
+     * 在同一个 Adapter 内原子替换 Scene 投影上下文。
+     * 候选 Scene 先以 confirmed Drawing 全量验证，成功应用引擎后才提升为当前投影 Scene。
+     */
+    replaceProjectionScene<T>(scene: ProjectionScene, apply: () => T): T;
+    /** 异步版本用于轴等需要等待 Adapter 原子应用完成的 Scene 事务。 */
+    replaceProjectionSceneAsync<T>(scene: ProjectionScene, apply: () => Promise<T>): Promise<T>;
     commitDrawingChange(requestId: string, canonicalHash: string): boolean;
     rejectDrawingChange(requestId: string): boolean;
     enterTerminalError(code: string, message: string): void;

package/dist/drawing/session-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-controller.d.ts","sourceRoot":"","sources":["../../src/drawing/session-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAIhF,OAAO,KAAK,EACX,iBAAiB,EAEjB,qBAAqB,EACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACN,wBAAwB,EACxB,KAAK,eAAe,EACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAEX,qBAAqB,EACrB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,MAAM,mBAAmB,GAC5B,OAAO,GACP,aAAa,GACb,4BAA4B,GAC5B,cAAc,GACd,gBAAgB,GAChB,WAAW,CAAC;AAEf,MAAM,MAAM,uBAAuB,GAChC,4BAA4B,GAC5B,8BAA8B,GAC9B,yBAAyB,GACzB,4BAA4B,GAC5B,sCAAsC,CAAC;AAE1C,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,SAAgB,IAAI,EAAE,uBAAuB,CAAC;IAC9C,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM/E;AAWD,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,gBAAgB,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE;QAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;KAC9B,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,KAAK,eAAe,CAAC;IACxF,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACtD;AAED;;;GAGG;AACH,qBAAa,wBAAwB;;gBAUjB,OAAO,EAAE,+BAA+B;IAO3D,IAAW,KAAK,IAAI,mBAAmB,CAEtC;IAED,IAAW,iBAAiB,IAAI,SAAS,qBAAqB,EAAE,CAG/D;IAED,IAAW,UAAU,IAAI,MAAM,GAAG,IAAI,CAErC;IAEM,gBAAgB,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI;IAWlE,WAAW,CACjB,IAAI,EAAE,MAAM,EACZ,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,qBAAqB,CAAC,QAAQ,CAAC,CAAC;KAClD,GACC,MAAM;IAiBF,mBAAmB,CACzB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,GACrC,qBAAqB;IAKjB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB;IAKlE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAKlC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAUtC,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO;IA4BtE,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IA0C/C,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIvD,OAAO,IAAI,IAAI;CAwOtB"}
+{"version":3,"file":"session-controller.d.ts","sourceRoot":"","sources":["../../src/drawing/session-controller.ts"],"names":[],"mappings":"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"}

package/dist/drawing/session-controller.js

@@ -17,6 +17,8 @@ export class DrawingSessionError extends Error {
  */
 export class DrawingSessionController {
     #options;
+    /** 后续 Drawing 候选投影必须使用的当前已确认 Scene。 */
+    #scene;
     #state = 'ready';
     #confirmed = [];
     #candidate = null;
@@ -26,6 +28,7 @@ export class DrawingSessionController {
     #unsubscribeEngine;
     constructor(options) {
         this.#options = options;
+        this.#scene = structuredClone(options.scene);
         this.#unsubscribeEngine = options.engine.subscribeDrawingEvents((event) => this.#handleEngineEvent(event));
     }
     get state() {
@@ -38,6 +41,11 @@ export class DrawingSessionController {
     get selectedId() {
         return this.#selectedId;
     }
+    /** 当前已确认的投影 Scene；仅返回深拷贝，协调层不能取得引擎对象。 */
+    get projectionScene() {
+        this.#assertUsable();
+        return structuredClone(this.#scene);
+    }
     restoreConfirmed(drawings) {
         this.#assertUsable();
         this.#suppressEngineEvents = true;
@@ -87,6 +95,69 @@ export class DrawingSessionController {
             id,
         });
     }
+    /**
+     * 在同一个 Adapter 内原子替换 Scene 投影上下文。
+     * 候选 Scene 先以 confirmed Drawing 全量验证，成功应用引擎后才提升为当前投影 Scene。
+     */
+    replaceProjectionScene(scene, apply) {
+        this.#assertReady();
+        const candidate = structuredClone(scene);
+        this.#options.projectionService.projectDocument({
+            scene: candidate,
+            drawings: this.#options.buildDocument(this.#confirmed),
+        });
+        this.#state = 'reprojecting';
+        let mutationsDisabled = false;
+        try {
+            this.#options.engine.setMutationsEnabled(false);
+            mutationsDisabled = true;
+            const result = apply();
+            this.#scene = candidate;
+            return result;
+        }
+        finally {
+            if (mutationsDisabled) {
+                try {
+                    this.#options.engine.setMutationsEnabled(true);
+                }
+                catch (error) {
+                    this.#enterTerminalError('DRAWING_PROJECTION_INVALID', `Failed to restore Drawing mutations after Scene replacement: ${String(error)}`);
+                    throw new DrawingSessionError('DRAWING_PROJECTION_INVALID', '/scene', 'The Drawing engine could not leave the Scene replacement state.');
+                }
+            }
+            this.#state = 'ready';
+        }
+    }
+    /** 异步版本用于轴等需要等待 Adapter 原子应用完成的 Scene 事务。 */
+    async replaceProjectionSceneAsync(scene, apply) {
+        this.#assertReady();
+        const candidate = structuredClone(scene);
+        this.#options.projectionService.projectDocument({
+            scene: candidate,
+            drawings: this.#options.buildDocument(this.#confirmed),
+        });
+        this.#state = 'reprojecting';
+        let mutationsDisabled = false;
+        try {
+            this.#options.engine.setMutationsEnabled(false);
+            mutationsDisabled = true;
+            const result = await apply();
+            this.#scene = candidate;
+            return result;
+        }
+        finally {
+            if (mutationsDisabled) {
+                try {
+                    this.#options.engine.setMutationsEnabled(true);
+                }
+                catch (error) {
+                    this.#enterTerminalError('DRAWING_PROJECTION_INVALID', `Failed to restore Drawing mutations after Scene replacement: ${String(error)}`);
+                    throw new DrawingSessionError('DRAWING_PROJECTION_INVALID', '/scene', 'The Drawing engine could not leave the Scene replacement state.');
+                }
+            }
+            this.#state = 'ready';
+        }
+    }
     commitDrawingChange(requestId, canonicalHash) {
         this.#assertUsable();
         if (this.#state !== 'awaiting-host-confirmation') {
@@ -225,7 +296,7 @@ export class DrawingSessionController {
         const candidateDocument = this.#options.buildDocument(this.#confirmedWith(input.operation, input.before, input.after));
         try {
             const projected = this.#options.projectionService.projectDocument({
-                scene: this.#options.scene,
+                scene: this.#scene,
                 drawings: candidateDocument,
             });
             if (input.after !== undefined && input.operation !== 'delete') {

package/dist/drawing/workspace-runtime.d.ts

@@ -2,6 +2,7 @@ import type { ChartScene, DrawableWorkspaceDocument, Drawing, DrawingDocument, T
 import type { EngineDrawingSnapshot, MainSeriesPresentation } from '@baron1996/klinecharts-adapter';
 import type { DrawingRuntimeCapability, RuntimeAuxiliaryCapability } from './capabilities.js';
 import type { HostActionDescriptor, RuntimeCapabilityDescriptor } from './runtime-capability-descriptor.js';
+import { DrawingSessionController } from './session-controller.js';
 import { type WorkspaceRuntimeListener } from './workspace-events.js';
 export interface DrawableWorkspaceRuntimeOptions {
     readonly commitMode: 'immediate' | 'host-confirmed';
@@ -18,6 +19,10 @@ export declare class DrawableWorkspaceRuntime implements DrawableWorkspaceRuntim
     #private;
     private constructor();
     static create(container: HTMLElement, value: unknown, options: DrawableWorkspaceRuntimeOptions): Promise<DrawableWorkspaceRuntime>;
+    /** 跨周期等宿主编排只能连接显式 host-confirmed Runtime。 */
+    get commitMode(): DrawableWorkspaceRuntimeOptions['commitMode'];
+    /** 只暴露公共会话状态，不暴露 Adapter 或 Chart。 */
+    getDrawingSessionState(): DrawingSessionController['state'];
     startDrawing(type: Drawing['type'], options?: {
         readonly text?: string;
         readonly id?: string;

package/dist/drawing/workspace-runtime.d.ts.map

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

package/dist/drawing/workspace-runtime.js

@@ -42,6 +42,8 @@ export class DrawableWorkspaceRuntime {
     #projectionService = new DrawingProjectionService();
     #registration;
     #runtimeId;
+    /** 宿主确认策略在 Runtime 生命周期内不可切换。 */
+    #commitMode;
     #listeners = new Set();
     #sequence = 0;
     #destroyed = false;
@@ -50,6 +52,7 @@ export class DrawableWorkspaceRuntime {
         this.#container = container;
         this.#workspace = workspace;
         this.#engine = engine;
+        this.#commitMode = options.commitMode;
         this.#runtimeId = `drawable-workspace-${Math.random().toString(36).slice(2)}`;
         this.#scene = workspace.scene.document;
         this.#registration = getSceneRuntime(workspace.scene.kind);
@@ -77,6 +80,14 @@ export class DrawableWorkspaceRuntime {
         const engine = await registration.createAdapter(container, workspace);
         return new DrawableWorkspaceRuntime(container, workspace, engine, options);
     }
+    /** 跨周期等宿主编排只能连接显式 host-confirmed Runtime。 */
+    get commitMode() {
+        return this.#commitMode;
+    }
+    /** 只暴露公共会话状态，不暴露 Adapter 或 Chart。 */
+    getDrawingSessionState() {
+        return this.#session.state;
+    }
     startDrawing(type, options) {
         return this.#session.startCreate(type, options);
     }
@@ -209,7 +220,10 @@ export class DrawableWorkspaceRuntime {
         });
         this.#assertSceneProjection(candidate);
         const engine = this.#engine;
-        await engine.setPriceScale(scale);
+        await this.#session.replaceProjectionSceneAsync({
+            kind: 'chart',
+            document: candidate,
+        }, () => engine.setPriceScale(scale));
         this.#scene = candidate;
         this.#emit({ type: 'value-axis-scale-changed', scale });
         return structuredClone(candidate);
@@ -235,9 +249,11 @@ export class DrawableWorkspaceRuntime {
             (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);
+        const applied = this.#session.replaceProjectionScene({
+            kind: this.#sceneKind(),
+            document: candidate,
+        }, () => engine.replaceScene(candidate));
         this.#scene = applied;
         this.#emit({ type: 'scene-replaced', scene: { kind: this.#sceneKind(), document: applied } });
         return structuredClone(applied);

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 /** Web Runtime npm 包版本；ChartScene runtimeVersion 是独立的数据契约版本。 */
-export declare const WEB_RUNTIME_PACKAGE_VERSION: "0.5.1";
+export declare const WEB_RUNTIME_PACKAGE_VERSION: "0.7.1";
 export { SUPPORTED_OVERLAYS } from '@baron1996/klinecharts-adapter';
+export * from './cross-period/coordinator.js';
 export * from './drawing/capabilities.js';
 export * from './drawing/projection-service.js';
 export * from './drawing/runtime-capability-descriptor.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,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"}
+{"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,+BAA+B,CAAC;AAC9C,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,7 @@
 /** Web Runtime npm 包版本；ChartScene runtimeVersion 是独立的数据契约版本。 */
-export const WEB_RUNTIME_PACKAGE_VERSION = '0.5.1';
+export const WEB_RUNTIME_PACKAGE_VERSION = '0.7.1';
 export { SUPPORTED_OVERLAYS } from '@baron1996/klinecharts-adapter';
+export * from './cross-period/coordinator.js';
 export * from './drawing/capabilities.js';
 export * from './drawing/projection-service.js';
 export * from './drawing/runtime-capability-descriptor.js';

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,QA8QnC,CAAC"}
+{"version":3,"file":"standard-toolbar-styles.d.ts","sourceRoot":"","sources":["../../src/toolbar/standard-toolbar-styles.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,QAkTnC,CAAC"}

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

@@ -88,6 +88,19 @@ export const STANDARD_TOOLBAR_STYLES = String.raw `
 	font-size: 11px;
 }
 
+.baron-kline-toolbar__host-action-error {
+	flex: 0 0 auto;
+	max-width: 260px;
+	padding: 0 6px;
+	color: rgba(194, 57, 52, 1);
+	font-size: 11px;
+	line-height: 1.35;
+}
+
+.baron-kline-toolbar__host-action-error[hidden] {
+	display: none;
+}
+
 .baron-kline-toolbar__button {
 	position: relative;
 	display: grid;
@@ -113,6 +126,29 @@ export const STANDARD_TOOLBAR_STYLES = String.raw `
 	transform: translateY(-1px);
 }
 
+.baron-kline-toolbar__button:disabled {
+	cursor: not-allowed;
+	opacity: 0.5;
+	transform: none;
+}
+
+.baron-kline-toolbar__button[aria-busy="true"]::after {
+	width: 10px;
+	height: 10px;
+	margin-left: 5px;
+	content: "";
+	border: 1.5px solid currentcolor;
+	border-right-color: transparent;
+	border-radius: 50%;
+	animation: baron-kline-toolbar-spin 700ms linear infinite;
+}
+
+@keyframes baron-kline-toolbar-spin {
+	to {
+		transform: rotate(360deg);
+	}
+}
+
 .baron-kline-toolbar__button:focus-visible {
 	outline: 2px solid rgba(41, 98, 255, 1);
 	outline-offset: 2px;

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":"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"}
+{"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;AA4ErB,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,CA4ajB"}

package/dist/toolbar/standard-toolbar.js

@@ -4,6 +4,28 @@ import { createToolbarIcon } from './toolbar-icons.js';
 import { STANDARD_TOOLBAR_STYLES } from './standard-toolbar-styles.js';
 import { OVERLAY_TOOL_PRESENTATIONS, TEXT_OVERLAY_TYPES, TOOLBAR_ACTIONS, TOOLBAR_GROUPS, } from './toolbar-tools.js';
 let nextToolbarId = 1;
+function applyHostActionState(control, state) {
+    if (state.pressed !== undefined) {
+        control.button.setAttribute('aria-pressed', String(state.pressed));
+    }
+    if (state.disabled !== undefined) {
+        control.button.disabled = state.disabled;
+    }
+    if (state.pending !== undefined) {
+        control.button.setAttribute('aria-busy', String(state.pending));
+    }
+    if ('errorMessage' in state) {
+        const message = state.errorMessage?.trim() ?? '';
+        control.error.textContent = message;
+        control.error.hidden = message.length === 0;
+        if (message.length === 0) {
+            control.button.removeAttribute('aria-errormessage');
+        }
+        else {
+            control.button.setAttribute('aria-errormessage', control.error.id);
+        }
+    }
+}
 /** 将 HTML color 控件的 #RRGGBB 边界值归一化为 Scene v1 唯一的 rgba 表示。 */
 function htmlHexColorToSceneRgba(value) {
     const match = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i.exec(value);
@@ -153,6 +175,13 @@ function createInputControl(labelText, action, type) {
 /** 创建不含撤销/重做的标准离线编辑工具栏。 */
 export function createStandardToolbar(container, runtime, options = {}) {
     const descriptor = runtime.getRuntimeCapabilityDescriptor(options.hostActions === undefined ? {} : { hostActions: options.hostActions });
+    const hostActionIds = new Set();
+    for (const hostAction of descriptor.hostActions) {
+        if (hostActionIds.has(hostAction.actionId)) {
+            throw new TypeError(`STANDARD_TOOLBAR_DUPLICATE_HOST_ACTION: ${hostAction.actionId}`);
+        }
+        hostActionIds.add(hostAction.actionId);
+    }
     const defaultFileName = options.downloadFileName
         ?? descriptor.exportArtifact.defaultFileName;
     const toolbarId = nextToolbarId++;
@@ -172,6 +201,7 @@ export function createStandardToolbar(container, runtime, options = {}) {
     const tooltip = createTooltip(viewport, `baron-kline-toolbar-tooltip-${toolbarId}`);
     const cleanupCallbacks = [];
     const overlayButtons = [];
+    const hostActionControls = new Map();
     const textInput = document.createElement('input');
     textInput.type = 'text';
     textInput.className = 'baron-kline-toolbar__text-input';
@@ -408,9 +438,22 @@ export function createStandardToolbar(container, runtime, options = {}) {
                 button.dataset.hostAction = hostAction.actionId;
                 button.textContent = hostAction.label;
                 button.setAttribute('aria-label', hostAction.label);
+                button.setAttribute('aria-pressed', String(hostAction.pressed ?? false));
+                button.setAttribute('aria-busy', String(hostAction.pending ?? false));
+                button.disabled = hostAction.disabled ?? false;
+                const error = document.createElement('span');
+                error.id = `baron-kline-toolbar-host-action-error-${toolbarId}-${hostActionControls.size}`;
+                error.className = 'baron-kline-toolbar__host-action-error';
+                error.setAttribute('role', 'alert');
+                error.setAttribute('aria-live', 'assertive');
+                const control = { button, error };
+                hostActionControls.set(hostAction.actionId, control);
+                applyHostActionState(control, {
+                    errorMessage: hostAction.errorMessage ?? null,
+                });
                 const action = () => runtime.requestHostAction(hostAction.actionId, runtime.getSelectedDrawingId() ?? null);
                 button.addEventListener('click', action);
-                groupElement.append(button);
+                groupElement.append(button, error);
                 cleanupCallbacks.push(() => button.removeEventListener('click', action));
             }
         }
@@ -451,6 +494,16 @@ export function createStandardToolbar(container, runtime, options = {}) {
     let unregisterRuntime = () => { };
     const toolbar = {
         element: root,
+        setHostActionState(actionId, state) {
+            if (destroyed) {
+                throw new Error('STANDARD_TOOLBAR_DESTROYED');
+            }
+            const control = hostActionControls.get(actionId);
+            if (control === undefined) {
+                throw new TypeError(`STANDARD_TOOLBAR_UNKNOWN_HOST_ACTION: ${actionId}`);
+            }
+            applyHostActionState(control, state);
+        },
         destroy() {
             if (destroyed) {
                 return;

package/dist/types.d.ts

@@ -121,6 +121,12 @@ export interface StandardToolbarOptions {
 }
 export interface StandardToolbar {
     readonly element: HTMLElement;
+    setHostActionState(actionId: string, state: {
+        readonly pressed?: boolean;
+        readonly disabled?: boolean;
+        readonly pending?: boolean;
+        readonly errorMessage?: string | null;
+    }): void;
     destroy(): void;
 }
 export {};

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baron1996/klinecharts-runtime",
-  "version": "0.5.1",
+  "version": "0.7.1",
   "description": "Web runtime for deterministic KLineCharts scenes.",
   "type": "module",
   "license": "Apache-2.0",
@@ -39,8 +39,8 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@baron1996/kline-scene-schema": "0.5.1",
-    "@baron1996/klinecharts-adapter": "0.5.1",
+    "@baron1996/kline-scene-schema": "0.6.0",
+    "@baron1996/klinecharts-adapter": "0.6.0",
     "@js-temporal/polyfill": "0.5.1"
   }
 }