@netless/appliance-plugin 1.1.42 → 1.1.43-beta.0

package/READMA.zh-CN.md

@@ -302,7 +302,7 @@ injectMethodToObject(windowmanager.mainView,'setMemberState');
 - `addListener` - 添加 appliance-plugin 内部事件监听器
 - `removeListener` - 移除 appliance-plugin 内部事件监听器
 - `disableDeviceInputs` - 替代接口 [room.disableDeviceInputs](https://doc.shengwang.cn/api-ref/whiteboard/javascript/interfaces/room#disableDeviceInputs)
-- `disableEraseImage` - 替代接口 [room.disableEraseImage](https://doc.shengwang.cn/api-ref/whiteboard/javascript/interfaces/room#disableEraseImage) **该方法只禁止整体擦除的橡皮擦对图片的擦除，局部橡皮擦无效**
+- `disableEraseImage` - 替代接口 [room.disableEraseImage](https://doc.shengwang.cn/api-ref/whiteboard/javascript/interfaces/room#disableEraseImage)。该配置只控制整体橡皮擦（`ApplianceNames.eraser`）是否删除图片；Bitmap Eraser（`ApplianceNames.pencilEraser` 且 `useBitMap: true`）命中图片后仍会直接擦除：Doing 阶段先隐藏，Done 阶段从白板中删除。
 - `disableCameraTransform` - 替代接口 [room.disableCameraTransform](https://doc.shengwang.cn/api-ref/whiteboard/javascript/interfaces/room#disableCameraTransform) (Version >=1.1.17)
 - `insertText` - 在指定位置插入文字 (Version >=1.1.18)
 - `updateText` - 编辑指定文字的内容 (Version >=1.1.18)
@@ -892,6 +892,28 @@ plugin.insertBackgroundImage(viewId, {
     - `logger?: Logger` - 非必填，配置日志打印器对象。不填写默认在本地 console 输出，如果需要把日志上传到指定 server，则需要手动配置。
         > 如需要上传到白板日志服务器，可以把 `room.logger` 配置到该项目。
 
+### Bitmap Eraser 配置
+
+Bitmap Eraser 统一使用事务级 FullLayer 透明 Mask 作为 Doing 预览，MainThread、Simple Worker 和 Full Worker 使用同一套处理逻辑。命中 Pencil/Shape 时，Done 阶段会把擦除结果分别固化到每个教具的 `eraserFaces`；命中 Image/Text 时，Doing 阶段先隐藏，Done 或达到点数上限触发 force-Done 后直接删除。
+
+```ts
+const plugin = await ApplianceSinglePlugin.getInstance(room, {
+  options: {
+    extras: {
+      pencilEraser: {
+        useBitMap: true,
+        // 单个事务最多接收的逻辑输入点数，默认 500；达到上限后自动 force-Done。
+        fullLayerDoingMaskMaxInputPoints: 500,
+        // 完全擦除 Pencil/Shape 时是否删除该教具，默认 true。
+        removeOnDone: true,
+      },
+    },
+  },
+});
+```
+
+不需要配置 `fullLayerDoingMask`。该旧字段仅保留兼容读取，无论传入 `true` 还是 `false`，当前实现都统一使用 FullLayer Doing Mask。`disableEraseImage` 不影响 Bitmap Eraser 对 Image 的直接擦除。
+
 ### 前端调试
 
 对接过程中如果想了解和跟踪插件内部状态，可以通过以下几个控制台指令，查看内部数据。

package/README.md

@@ -294,7 +294,7 @@ The following interfaces are involved:
 - `addListener` - Add appliance-plugin internal event listener
 - `removeListener` - Remove appliance-plugin internal event listener
 - `disableDeviceInputs` - Replace interface [room.disableDeviceInputs](https://api-ref.agora.io/en/interactive-whiteboard-sdk/web/2.x/interfaces/room.html#disabledeviceinputs)
-- `disableEraseImage` - Replace interface [room.disableEraseImage](https://api-ref.agora.io/en/interactive-whiteboard-sdk/web/2.x/interfaces/room.html#disableeraseimage) **This method only prohibits the eraser that erases the entire image from erasing images, partial eraser is invalid**
+- `disableEraseImage` - Replaces [room.disableEraseImage](https://api-ref.agora.io/en/interactive-whiteboard-sdk/web/2.x/interfaces/room.html#disableeraseimage). This option only controls whether the whole-object eraser (`ApplianceNames.eraser`) can delete images. The Bitmap Eraser (`ApplianceNames.pencilEraser` with `useBitMap: true`) still erases an intersected image directly: it hides the image during Doing and removes it from the whiteboard on Done.
 - `disableCameraTransform` - Replace interface [room.disableCameraTransform](https://api-ref.agora.io/en/interactive-whiteboard-sdk/web/2.x/interfaces/room.html#disablecameratransform) (Version >=1.1.17)
 - `insertText` - Insert text at the specified position (Version >=1.1.18)
 - `updateText` - Edit the content of the specified text (Version >=1.1.18)
@@ -938,6 +938,29 @@ plugin.usePlugin(autoDrawPlugin);
     - `logger?: Logger` - Optional, configure log printer object. If not provided, defaults to local console output. If logs need to be uploaded to a specified server, manual configuration is required.
         > If you need to upload to the whiteboard log server, you can configure `room.logger` to this item.
 
+### Bitmap Eraser options
+
+The Bitmap Eraser always uses a transaction-scoped transparent FullLayer mask for its Doing preview. MainThread, Simple Worker, and Full Worker use the same processing model. On Done, Pencil/Shape results are persisted separately in each appliance's `eraserFaces`. Intersected Image/Text appliances are hidden during Doing and removed on Done, or when the input limit forces the transaction to finish.
+
+```ts
+const plugin = await ApplianceSinglePlugin.getInstance(room, {
+  options: {
+    extras: {
+      pencilEraser: {
+        useBitMap: true,
+        // Maximum logical input points per transaction. Defaults to 500.
+        // Reaching the limit automatically force-finishes the transaction.
+        fullLayerDoingMaskMaxInputPoints: 500,
+        // Remove a fully erased Pencil/Shape appliance. Defaults to true.
+        removeOnDone: true,
+      },
+    },
+  },
+});
+```
+
+Do not configure `fullLayerDoingMask`. The legacy field is accepted only for compatibility; both `true` and `false` now use the single FullLayer Doing Mask path. `disableEraseImage` does not prevent the Bitmap Eraser from directly erasing Image appliances.
+
 ### Front-end Debugging
 During the integration process, if you want to understand and track the internal status of the plugin, you can view internal data through the following console commands.
 ```js

package/dist/appliance-plugin.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index--wqREfHK.js");exports.ActiveContainerType=e.ActiveContainerType;exports.ApplianceMultiPlugin=e.ApplianceMultiPlugin;exports.ApplianceNames=e.ApplianceNames;exports.AppliancePluginCursorNames=e.AppliancePluginCursorNames;exports.ApplianceSigleWrapper=e.ApplianceSigleWrapper;exports.ApplianceSinglePlugin=e.ApplianceSinglePlugin;exports.Cursor_Hover_Id=e.Cursor_Hover_Id;exports.ECanvasShowType=e.ECanvasShowType;exports.EDataType=e.EDataType;exports.EForceStopReason=e.EForceStopReason;exports.EImageType=e.EImageType;exports.EMatrixrRelationType=e.EMatrixrRelationType;exports.EOperationType=e.EOperationType;exports.EPostMessageType=e.EPostMessageType;exports.ERenderFilterType=e.ERenderFilterType;exports.ESVGType=e.ESVGType;exports.EScaleType=e.EScaleType;exports.EStrokeType=e.EStrokeType;exports.EToolsKey=e.EToolsKey;exports.ElayerType=e.ElayerType;exports.EmitEventType=e.EmitEventType;exports.EventMessageType=e.EventMessageType;exports.EventWorkState=e.EventWorkState;exports.EvevtWorkState=e.EventWorkState;exports.FontFaceFallbackBlacklistLevel=e.FontFaceFallbackBlacklistLevel;exports.InternalMsgEmitterType=e.InternalMsgEmitterType;exports.Main_View_Id=e.Main_View_Id;exports.Plugin=e.Plugin;exports.ShapeType=e.ShapeType;exports.Task_Time_Interval=e.Task_Time_Interval;exports.WorkerCanvasContextBlacklistLevel=e.WorkerCanvasContextBlacklistLevel;exports.WorkerImageBitmapFeatureBlacklistLevel=e.WorkerImageBitmapFeatureBlacklistLevel;exports.WorkerMaskTextureFormatBlacklistLevel=e.WorkerMaskTextureFormatBlacklistLevel;exports.WorkerMaskTextureUploadBlacklistLevel=e.WorkerMaskTextureUploadBlacklistLevel;exports.WorkerRenderModeBlacklistLevel=e.WorkerRenderModeBlacklistLevel;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-DFo0Gmfx.js");exports.ActiveContainerType=e.ActiveContainerType;exports.ApplianceMultiPlugin=e.ApplianceMultiPlugin;exports.ApplianceNames=e.ApplianceNames;exports.AppliancePluginCursorNames=e.AppliancePluginCursorNames;exports.ApplianceSigleWrapper=e.ApplianceSigleWrapper;exports.ApplianceSinglePlugin=e.ApplianceSinglePlugin;exports.Camera_Ack_Slow_Timeout=e.Camera_Ack_Slow_Timeout;exports.Camera_Transport_Fallback_Timeout=e.Camera_Transport_Fallback_Timeout;exports.Camera_Update_Business_Timeout=e.Camera_Update_Business_Timeout;exports.Cursor_Hover_Id=e.Cursor_Hover_Id;exports.ECanvasShowType=e.ECanvasShowType;exports.EDataType=e.EDataType;exports.EForceStopReason=e.EForceStopReason;exports.EImageType=e.EImageType;exports.EMatrixrRelationType=e.EMatrixrRelationType;exports.EOperationType=e.EOperationType;exports.EPostMessageType=e.EPostMessageType;exports.ERenderFilterType=e.ERenderFilterType;exports.ESVGType=e.ESVGType;exports.EScaleType=e.EScaleType;exports.EStrokeType=e.EStrokeType;exports.EToolsKey=e.EToolsKey;exports.ElayerType=e.ElayerType;exports.EmitEventType=e.EmitEventType;exports.EventMessageType=e.EventMessageType;exports.EventWorkState=e.EventWorkState;exports.EvevtWorkState=e.EventWorkState;exports.FontFaceFallbackBlacklistLevel=e.FontFaceFallbackBlacklistLevel;exports.InternalMsgEmitterType=e.InternalMsgEmitterType;exports.Main_View_Id=e.Main_View_Id;exports.Plugin=e.Plugin;exports.Renderer_Business_Default_Timeout=e.Renderer_Business_Default_Timeout;exports.ShapeType=e.ShapeType;exports.Task_Time_Interval=e.Task_Time_Interval;exports.WorkerCanvasContextBlacklistLevel=e.WorkerCanvasContextBlacklistLevel;exports.WorkerMaskTextureFormatBlacklistLevel=e.WorkerMaskTextureFormatBlacklistLevel;exports.WorkerMaskTextureUploadBlacklistLevel=e.WorkerMaskTextureUploadBlacklistLevel;exports.WorkerRenderModeBlacklistLevel=e.WorkerRenderModeBlacklistLevel;

package/dist/appliance-plugin.mjs

@@ -1,38 +1,41 @@
-import { I as s, J as l, K as t, L as r, N as p, P as i, C as n, p as o, b as T, Q as E, w as k, z as y, R as c, a as v, U as g, d as u, W as m, X as S, c as M, Y as W, E as d, Z as B, e as C, e as F, _ as I, $ as L, u as _, a0 as A, a1 as P, T as x, a2 as R, a3 as w, a4 as N, a5 as b, a6 as h } from "./index-B-tFucpi.mjs";
+import { Y as s, Z as t, _ as r, $ as l, a0 as i, a1 as p, a2 as o, a3 as n, a4 as T, C as E, s as c, b as k, a5 as y, H as _, K as u, a6 as m, a as v, a7 as g, d as S, a8 as d, a9 as C, c as M, aa as A, E as B, ab as F, e as W, e as x, ac as I, ad as L, y as P, ae as R, af as b, ag as f, T as h, ah as w, ai as D, aj as H, ak as K } from "./index-NG5kKK1W.mjs";
 export {
   s as ActiveContainerType,
-  l as ApplianceMultiPlugin,
-  t as ApplianceNames,
-  r as AppliancePluginCursorNames,
-  p as ApplianceSigleWrapper,
-  i as ApplianceSinglePlugin,
-  n as Cursor_Hover_Id,
-  o as ECanvasShowType,
-  T as EDataType,
-  E as EForceStopReason,
-  k as EImageType,
-  y as EMatrixrRelationType,
-  c as EOperationType,
+  t as ApplianceMultiPlugin,
+  r as ApplianceNames,
+  l as AppliancePluginCursorNames,
+  i as ApplianceSigleWrapper,
+  p as ApplianceSinglePlugin,
+  o as Camera_Ack_Slow_Timeout,
+  n as Camera_Transport_Fallback_Timeout,
+  T as Camera_Update_Business_Timeout,
+  E as Cursor_Hover_Id,
+  c as ECanvasShowType,
+  k as EDataType,
+  y as EForceStopReason,
+  _ as EImageType,
+  u as EMatrixrRelationType,
+  m as EOperationType,
   v as EPostMessageType,
   g as ERenderFilterType,
-  u as ESVGType,
-  m as EScaleType,
-  S as EStrokeType,
+  S as ESVGType,
+  d as EScaleType,
+  C as EStrokeType,
   M as EToolsKey,
-  W as ElayerType,
-  d as EmitEventType,
-  B as EventMessageType,
-  C as EventWorkState,
-  F as EvevtWorkState,
+  A as ElayerType,
+  B as EmitEventType,
+  F as EventMessageType,
+  W as EventWorkState,
+  x as EvevtWorkState,
   I as FontFaceFallbackBlacklistLevel,
   L as InternalMsgEmitterType,
-  _ as Main_View_Id,
-  A as Plugin,
-  P as ShapeType,
-  x as Task_Time_Interval,
-  R as WorkerCanvasContextBlacklistLevel,
-  w as WorkerImageBitmapFeatureBlacklistLevel,
-  N as WorkerMaskTextureFormatBlacklistLevel,
-  b as WorkerMaskTextureUploadBlacklistLevel,
-  h as WorkerRenderModeBlacklistLevel
+  P as Main_View_Id,
+  R as Plugin,
+  b as Renderer_Business_Default_Timeout,
+  f as ShapeType,
+  h as Task_Time_Interval,
+  w as WorkerCanvasContextBlacklistLevel,
+  D as WorkerMaskTextureFormatBlacklistLevel,
+  H as WorkerMaskTextureUploadBlacklistLevel,
+  K as WorkerRenderModeBlacklistLevel
 };

package/dist/{bridge-C8yT2GqS.js → bridge-D68E09T9.js}

@@ -1 +1 @@
-"use strict";var l=Object.defineProperty;var o=(i,e,t)=>e in i?l(i,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):i[e]=t;var n=(i,e,t)=>o(i,typeof e!="symbol"?e+"":e,t);let r;function c(i){r=i}function u(){if(!r)throw new Error("[@netless/appliance-plugin/bridge] white-web-sdk runtime has not been bound yet.");return r}class h{constructor(){n(this,"control");n(this,"_listeners",{})}_inject(e){this.control=e}_onEvent(e,t){this._listeners[e]&&this._listeners[e](...t)}callbacks(e,t){this._listeners[e]=t}removeCallback(e){delete this._listeners[e]}}class g{constructor(e){n(this,"control");n(this,"worker");n(this,"publicMsgEmitter");n(this,"plugins",new Map);const{control:t,publicMsgEmitter:s}=e;this.control=t,this.publicMsgEmitter=s,this.worker=t.worker}use(e){this.plugins.set(e.kind,e),e._inject(this.control),e.onCreate()}destroy(){this.plugins.forEach(e=>{this.plugins.delete(e.kind),e.onDestroy()})}dispatchPluginEvent(e,...t){this.plugins.forEach(s=>{s._onEvent(e,t)})}}async function a(i){return c(i),Promise.resolve().then(()=>require("./index-CfIWmlMn.js")).then(e=>e.index)}exports.Plugin=h;exports.PluginManager=g;exports.getWhiteWebSdkBridgeRuntime=u;exports.loadAppliancePluginBridge=a;
+"use strict";var l=Object.defineProperty;var o=(i,e,t)=>e in i?l(i,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):i[e]=t;var n=(i,e,t)=>o(i,typeof e!="symbol"?e+"":e,t);let r;function c(i){r=i}function u(){if(!r)throw new Error("[@netless/appliance-plugin/bridge] white-web-sdk runtime has not been bound yet.");return r}class h{constructor(){n(this,"control");n(this,"_listeners",{})}_inject(e){this.control=e}_onEvent(e,t){this._listeners[e]&&this._listeners[e](...t)}callbacks(e,t){this._listeners[e]=t}removeCallback(e){delete this._listeners[e]}}class g{constructor(e){n(this,"control");n(this,"worker");n(this,"publicMsgEmitter");n(this,"plugins",new Map);const{control:t,publicMsgEmitter:s}=e;this.control=t,this.publicMsgEmitter=s,this.worker=t.worker}use(e){this.plugins.set(e.kind,e),e._inject(this.control),e.onCreate()}destroy(){this.plugins.forEach(e=>{this.plugins.delete(e.kind),e.onDestroy()})}dispatchPluginEvent(e,...t){this.plugins.forEach(s=>{s._onEvent(e,t)})}}async function a(i){return c(i),Promise.resolve().then(()=>require("./index-C2AHqjj8.js")).then(e=>e.index)}exports.Plugin=h;exports.PluginManager=g;exports.getWhiteWebSdkBridgeRuntime=u;exports.loadAppliancePluginBridge=a;

package/dist/{bridge-DLGOhX8U.mjs → bridge-DcVN05tP.mjs}

@@ -54,7 +54,7 @@ class g {
   }
 }
 async function d(i) {
-  return c(i), import("./index-HAZlgByL.mjs").then((t) => t.J);
+  return c(i), import("./index-B_vZ9d3x.mjs").then((t) => t.Z);
 }
 export {
   g as P,

package/dist/bridge.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./bridge-C8yT2GqS.js");exports.Plugin=e.Plugin;exports.loadAppliancePluginBridge=e.loadAppliancePluginBridge;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./bridge-D68E09T9.js");exports.Plugin=e.Plugin;exports.loadAppliancePluginBridge=e.loadAppliancePluginBridge;

package/dist/bridge.mjs

@@ -1,4 +1,4 @@
-import { a as i, l as e } from "./bridge-DLGOhX8U.mjs";
+import { a as i, l as e } from "./bridge-DcVN05tP.mjs";
 export {
   i as Plugin,
   e as loadAppliancePluginBridge

package/dist/collector/collector.d.ts

@@ -1,5 +1,5 @@
 import { EOperationType, ERenderFilterType } from "../core/enum";
-import { BaseCollectorReducerAction, Diff, DiffAuthPage, DiffAuthRender, ISerializableAuthData, ISerializableStorageData, ISerializableStorageViewData, ISerializableUndoRedoStackViewData, ISerializableUndoStackId, ScenePath, Uid, ViewId, WorkId, DiffGlobalUndoRedoStack } from "./types";
+import { BaseCollectorReducerAction, Diff, DiffAuthPage, DiffAuthRender, ISerializableAuthData, ISerializableStorageData, ISerializableStorageScenePathData, ISerializableStorageViewData, ISerializableUndoRedoStackViewData, ISerializableUndoStackId, ScenePath, Uid, ViewId, WorkId, DiffGlobalUndoRedoStack } from "./types";
 import { BaseCollector } from "./base";
 import type { _SetTrue, AppliancePluginLike } from "../plugin/types";
 import { BaseApplianceManager } from "../plugin/baseApplianceManager";
@@ -23,10 +23,34 @@ export declare class Collector extends BaseCollector<ISerializableStorageViewDat
     private stateDisposer;
     private authDisposer;
     private asyncClockState;
+    /** Updates received while the shared sync callback is pending. */
+    private pendingSyncViews;
+    private pendingSyncStorage?;
     private limitNums;
+    private destroyed;
+    private storageRevision;
+    private viewStorageRevisions;
+    private sceneStorageRevisions;
+    /** View-local terminal fence for idle sync callbacks after delete-storage. */
+    private discardedSyncViews;
     private syncInterval;
     constructor(control: BaseApplianceManager, plugin: AppliancePluginLike, syncInterval: number);
-    get Logger(): import("..").Logger;
+    get Logger(): import("../plugin/utils").LoggerUtils;
+    discardViewPendingSync(viewId: string): void;
+    restoreViewPendingSync(viewId: string): void;
+    isViewPendingSyncDiscarded(viewId: string): boolean;
+    private canRunSync;
+    private getSceneRevisionKey;
+    private getSceneDiffKey;
+    private getDataDiffKey;
+    private bumpStorageRevision;
+    /**
+     * A deferred sync may hold a snapshot captured before closeApp/delete-storage.
+     * Filter terminal Views at the last possible moment so a later update from a
+     * different View cannot re-create the deleted View on the remote side.
+     * Nested scene/record objects are intentionally shared read-only references.
+     */
+    private filterDiscardedViews;
     hasId(viewId: string, scenePath: string, key: string): boolean;
     private getLimitNum;
     private getLimitNums;
@@ -38,6 +62,19 @@ export declare class Collector extends BaseCollector<ISerializableStorageViewDat
         scenePath: string | undefined;
     };
     getStorageData(viewId: string, scenePath: string): ISerializableStorageData | undefined;
+    /**
+     * Return a synchronous, read-only, deep copy of all service storage for one
+     * View. Init Padding uses this as its single authoritative baseline.
+     */
+    getServiceStorageViewSnapshot(viewId: string): ISerializableStorageScenePathData;
+    readViewStorageSnapshot(viewId: string): {
+        revision: number;
+        storage: ISerializableStorageScenePathData;
+    };
+    readSceneStorageSnapshot(viewId: string, scenePath: string): {
+        revision: number;
+        storage: ISerializableStorageData;
+    };
     hasSelector(viewId: string, scenePath: string): boolean;
     hasIncludeSelector(targetKey: string, targetViewId?: string, targetScenePath?: string): boolean;
     addStorageStateListener(callBack: (diff: Diff) => void): void;
@@ -62,7 +99,18 @@ export declare class Collector extends BaseCollector<ISerializableStorageViewDat
         isSync?: boolean;
         storage?: ISerializableStorageViewData;
         onApplied?: () => void;
+        preserveLastOperator?: boolean;
     }): void;
+    /**
+     * Repair-only update. Unlike updateValue(), this never creates a missing
+     * View or Scene, so closeApp/delete-storage can win a concurrent repair.
+     */
+    updateExistingValue(key: string, value: any, options: {
+        viewId: string;
+        scenePath: string;
+        isSync?: boolean;
+        preserveLastOperator?: boolean;
+    }): boolean;
     private runSyncService;
     private syncSerivice;
     private logLocalSyncChanges;

package/dist/collector/types.d.ts

@@ -10,12 +10,16 @@ export declare type DiffOneScenePath<ISerializableStorageScenePathData> = {
     oldValue?: ISerializableStorageScenePathData;
     newValue?: ISerializableStorageScenePathData;
     viewId: string;
+    /** Logical scene path; the containing map key is collision-safe, not public data. */
+    scenePath?: string;
 };
 export declare type DiffOneData<ISerializableStorageData> = {
     oldValue: ISerializableStorageData;
     newValue: ISerializableStorageData;
     viewId: string;
     scenePath: string;
+    /** Logical storage key; the containing map key is collision-safe. */
+    storageKey?: string;
 };
 export declare type DiffView<ISerializableStorageViewData> = {
     [K in keyof ISerializableStorageViewData]?: DiffOneView<ISerializableStorageViewData[K]>;
@@ -37,6 +41,8 @@ export interface INormalPushMsg {
     toolsType?: EToolsKey;
     opt?: ShapeOptions;
     uid?: string;
+    /** Stable room user id of the last writer of this persisted record. */
+    lastOperator?: string;
     taskId?: number;
     namespace?: string;
     op?: number[];

package/dist/component/svg/manager.d.ts

@@ -21,6 +21,7 @@ export declare class BackgroundThreadEngineImpl implements BackgroundThreadEngin
     master: MasterControlForWorker;
     private cameraOpt?;
     private methodBuilder;
+    private destroyed;
     constructor(viewId: string, opt: IBackgroundThreadInitOption);
     get camera(): ICameraOpt;
     get view(): View | undefined;

package/dist/component/svg/snapshot.d.ts

@@ -13,10 +13,13 @@ export declare class BackgroundSnapshotThreadImpl {
     private cameraOpt?;
     readonly opt: IBackgroundThreadInitOption;
     workShapes: Map<string, BaseShapeTool>;
+    private destroyed;
+    private activeRequest?;
     get camera(): ICameraOpt;
     get view(): View | undefined;
     get markmapOptions(): Partial<IMarkmapOptions> | undefined;
     constructor(viewId: string, opt: IBackgroundThreadInitOption);
+    private reportRequestFailure;
     createOffscreenCanvas(opt: IBackgroundThreadInitOption): void;
     setCameraOpt(cameraOpt: ICameraOpt): Promise<void>;
     getPagePoint(x: number, y: number): {
@@ -27,5 +30,5 @@ export declare class BackgroundSnapshotThreadImpl {
     private createWorkShapeNode;
     private setFullWork;
     runFullWork(data: IWorkerMessage): Promise<void>;
-    destroy(): void;
+    destroy(reason?: string): void;
 }

package/dist/component/textEditor/manager.d.ts

@@ -23,6 +23,8 @@ export interface TextEditorManager {
     computeTextActive(point: [number, number], viewId: string): void;
     /** 校验是否删除空文本或事失焦 */
     checkEmptyTextBlur(): void;
+    /** 生命周期边界立即收口指定 View 的全部本地 Text。 */
+    forceDoneLocalText(targetViewIds?: readonly string[]): void;
     /** 激活文本编辑组件 */
     active(workId: string, undoTickerId?: number): void;
     /** 不激活文本编辑组件 */
@@ -109,6 +111,7 @@ export declare class TextEditorManagerImpl implements TextEditorManager {
     computeTextActive(point: [number, number], viewId: string): void;
     checkLocalTextBlur: import("lodash").DebouncedFunc<() => void>;
     checkEmptyTextBlur(): void;
+    forceDoneLocalText(targetViewIds?: readonly string[]): void;
     onCameraChange(cameraOpt: ICameraOpt, viewId: string): void;
     deriveTextEditorInfoFromServiceData(data: IWorkerMessage, options?: {
         canWorker?: boolean;

package/dist/core/backGroundThread/index.d.ts

@@ -19,17 +19,22 @@ export interface BackgroundThreadManager {
     createSnapshotThread(viewId: string, opt: IBackgroundThreadInitOption): BackgroundSnapshotThreadImpl;
     consume(msg: Set<IWorkerMessage>): Promise<void>;
     post(sp: Omit<IBatchMainMessage, "render">): void;
+    discardView(viewId: string): void;
     destroy(): void;
 }
 export declare class BackgroundThreadManagerImpl implements BackgroundThreadManager {
     backgroundThreadMap: Map<string, BackgroundThreadEngineImpl>;
-    private snapshotThread?;
+    private snapshotThreadsByRequest;
+    private destroyed;
     master: MasterControlForWorker;
     constructor(master: MasterControlForWorker);
     createBackgroundThread(viewId: string, opt: IBackgroundThreadInitOption): BackgroundThreadEngineImpl;
     createSnapshotThread(viewId: string, opt: IBackgroundThreadInitOption): BackgroundSnapshotThreadImpl;
+    private getSnapshotRequestKey;
+    private disposeSnapshotThread;
     consume(msg: Set<IWorkerMessage>): Promise<void>;
     consumeTargetOne(viewId: string, msg: IWorkerMessage): Promise<void>;
     post: (msg: Omit<IBatchMainMessage, "render">) => void;
+    discardView(viewId: string): void;
     destroy(): void;
 }

package/dist/core/cameraTask.d.ts

@@ -0,0 +1,45 @@
+import type { CameraTaskStatus, ICameraTaskError } from "./types";
+/**
+ * A valid downstream error payload takes precedence over the protocol's
+ * default-success status. Explicit failure statuses remain terminal even when
+ * an older renderer omitted the optional payload.
+ */
+export declare function normalizeCameraTaskError(status: CameraTaskStatus | undefined, error?: ICameraTaskError, workerType?: string): ICameraTaskError | undefined;
+export type CameraUpdateTaskStage = "update-camera" | "blocking-works" | "prepare-render";
+export interface CameraUpdateTaskContext {
+    readonly cameraTaskId?: number;
+    readonly startedAt: number;
+    readonly deadlineAt: number;
+    readonly abortPromise: Promise<void>;
+    /** Cancelled by the owning View when it is destroyed. */
+    abort?: () => void;
+    aborted: boolean;
+    stage: CameraUpdateTaskStage;
+    blockingWorks?: string[];
+}
+export declare class CameraUpdateTimeoutError extends Error {
+    readonly code = "RENDERER_BUSINESS_TIMEOUT";
+    readonly business = "updateCamera";
+    readonly cameraTaskId?: number;
+    readonly elapsedMs: number;
+    readonly stage: CameraUpdateTaskStage;
+    readonly blockingWorks?: string[];
+    constructor(context: CameraUpdateTaskContext, timeoutMs: number);
+}
+/**
+ * The owning renderer was destroyed while a Camera business operation was
+ * still waiting on a non-cancellable platform Promise. This is a local
+ * lifecycle failure, not a renderer timeout; callers still publish a failed
+ * Camera ACK so the queue can advance.
+ */
+export declare class CameraUpdateAbortedError extends Error {
+    readonly code = "RENDERER_BUSINESS_ABORTED";
+    readonly business = "updateCamera";
+    readonly cameraTaskId?: number;
+    readonly stage: CameraUpdateTaskStage;
+    readonly blockingWorks?: string[];
+    constructor(context: CameraUpdateTaskContext);
+}
+export declare function runCameraUpdateWithTimeout(cameraTaskId: number | undefined, run: (context: CameraUpdateTaskContext) => Promise<void>, timeoutMs?: number): Promise<void>;
+export declare function waitForCameraUpdateTask(context: CameraUpdateTaskContext, task: Promise<unknown>, stage: CameraUpdateTaskStage): Promise<boolean>;
+export declare function isCameraUpdateTimeoutError(error: unknown): error is CameraUpdateTimeoutError;

package/dist/core/const.d.ts

@@ -1,3 +1,7 @@
 export declare const Cursor_Hover_Id = "cursorhover";
 export declare const Task_Time_Interval = 20;
 export declare const Main_View_Id = "mainView";
+export declare const Renderer_Business_Default_Timeout = 500;
+export declare const Camera_Update_Business_Timeout = 500;
+export declare const Camera_Ack_Slow_Timeout = 500;
+export declare const Camera_Transport_Fallback_Timeout = 1000;

package/dist/core/enum.d.ts

@@ -140,7 +140,11 @@ export declare enum EPostMessageType {
     /** 内部文字刷新绘制完成 */
     RefreshTextRender = 37,
     /** 在 Worker 自身上下文探测渲染能力 */
-    ProbeRenderCapabilities = 38
+    ProbeRenderCapabilities = 38,
+    /** 初始化 service snapshot 已完成 renderer 提交 */
+    ServiceSyncCommit = 39,
+    /** 取消尚未完成的字体加载请求，仅用于内部 Worker 协议 */
+    CancelFontFace = 40
 }
 export type ECanvasContextType = "webgl2" | "webgl" | "2d";
 export declare enum ECanvasShowType {

package/dist/core/error.d.ts

@@ -0,0 +1 @@
+export declare function getErrorMessage(error: unknown): string;

package/dist/core/fontFace.d.ts

@@ -12,14 +12,15 @@ export declare class FontFaceManager {
     private readonly getSubWorker;
     private readonly indexDBUtils;
     private fontFaceWorkerResolveMap;
-    private fontFacesLoadingPromise?;
+    private fontFaceLoadGeneration;
+    private activeFontFaceAttempt?;
     private lastFontFacesAlreadyReady;
-    private fontFaceLoadStateStarted;
     private documentFontsReadyLogged;
+    private readonly documentFontsReadyWaiters;
     constructor(props: FontFaceManagerProps);
     destroy(): void;
     private get Logger();
-    waitDocumentFontsReady(reason: string): Promise<void>;
+    waitDocumentFontsReady(reason: string, timeoutMs?: number, signal?: AbortSignal): Promise<void>;
     clearFontCache(): Promise<boolean>;
     getFontCacheStatus(): Promise<{
         count: number;
@@ -34,6 +35,7 @@ export declare class FontFaceManager {
     private getWorkers;
     private areWorkerFontFacesReady;
     private waitWorkerReadyForFontFaces;
+    private assertAttemptActive;
     private getRuntimeFontFacesReadyState;
     private loadFontFaceBuffers;
     private setDocumentFontFaces;