@netless/appliance-plugin 1.1.35 → 1.1.36-beta.1

package/READMA.zh-CN.md

@@ -47,6 +47,10 @@ appliance-plugin 是一个高性能的白板绘制插件，依赖 [white-web-sdk
 npm install @netless/appliance-plugin
 ```
 
+> **Fastboard full 包说明：** 如果你是通过 `@netless/fastboard-full` 或 `@netless/fastboard-react-full` 配合 `enableAppliancePlugin` 使用，请安装带有 `./bridge` 导出的 `@netless/appliance-plugin` 版本，建议 `>= 1.1.35`（`./bridge` 首次出现在 `>= 1.1.34-beta.2`）。
+>
+> 业务代码继续引用 `@netless/appliance-plugin` 即可，不需要也不建议手动改成 `@netless/appliance-plugin/bridge`。`@netless/appliance-plugin/bridge` 由 fastboard full 在内部加载，用来复用 full 内部已经 bundled 的 `white-web-sdk` runtime。
+
 ### 注册插件
 
 插件可以支持两种场景,它们接入插件命名不同:
@@ -156,6 +160,8 @@ const fastboard = await createFastboard({
   });
 ```
 
+> **注意：** 在 fastboard full 模式下，`@netless/fastboard-full` / `@netless/fastboard-react-full` 会在内部加载 `@netless/appliance-plugin/bridge`。业务代码只需要配置 `enableAppliancePlugin` 并提供 worker 地址，同时继续引用 `@netless/appliance-plugin` 即可；不需要也不建议手动引入 `@netless/appliance-plugin/bridge`。
+
 #### 多窗口(直接对接window-manager)
 
 ```js
@@ -330,6 +336,36 @@ injectMethodToObject(windowmanager.mainView,'setMemberState');
 - `updateMarkmap` - 修改白板中的markdow文本 (Version >=1.1.32) **该方法需要开启extras.useBackgroundThread**
 - `insertBackgroundImage` - 插入白板的背景图片 (Version >=1.1.32) **该方法需要开启extras.useBackgroundThread**
 
+6. Selector / Element 扩展接口
+- `getSelectedElements(viewId?)` - 获取当前 selector 选中快照
+- `blurSelector(viewId?)` - 取消当前 selector 选中
+- `updateSelectedElements(viewId?, changes)` - 更新当前 selector 选中集的属性
+- `copySelectedElements(viewId?)` - 复制当前 selector 选中集
+- `deleteSelectedElements(viewId?)` - 删除当前 selector 选中集
+- `updateElement(elementId, scenePath, viewId, updateElementInfo, useUndoRedoStack?)` - 单元素最终态更新接口，返回 `Promise<boolean>`
+
+其中需要注意：
+
+- `updateSelectedElements(...)` 是 selector-only 能力，只处理当前选中的 selector 集合
+- `updateElement(...)` 是 storage-first 的单元素最终态更新通知接口
+- `updateElement(...)` 不表达调用返回时已经渲染完成
+- `updateElement(...)` 不支持 selector
+- `updateElementInfo` 需要显式携带 `toolsType`，并按教具类型声明对应字段
+- `updateElement(...)` 返回 `Promise<boolean>`，仅表示本次调用是否通过基础校验并成功发起
+
+7. Selector 扩展事件
+- `selectedElementsChange`
+  - 只在 `selectedIds` 变化时触发
+  - 只表示最终选中集合变化
+- `selectorGeometryChange`
+  - 只表示最终几何结果变化
+  - 坐标统一为 `viewRect`
+- `selectorTransformChange`
+  - 只表示拖拽、拉伸、旋转、端点编辑等过程态
+  - 只暴露 `viewId + emitEventType + workState`
+- `remoteSelectorChange`
+  - 表示远端 / 被同步端 selector 的同步结果变化
+
 5. 不兼容接口
 - [`exportScene`](https://doc.shengwang.cn/api-ref/whiteboard/javascript/interfaces/room#exportScene) - appliance-plugin 开启后，笔记不能按 room 的方式导出
 - [服务端截图](https://doc.shengwang.cn/doc/whiteboard/restful/fastboard-sdk/restful-wb/operations/post-v5-rooms-uuid-screenshots) - appliance-plugin 开启后，笔记不能通过调用服务端截图方式获取截图，而需要改用 `screenshotToCanvasAsync` 获取

package/README.md

@@ -47,6 +47,10 @@ The plugin supports the following drawing tools:
 npm install @netless/appliance-plugin
 ```
 
+> **Fastboard full packages:** If you are using `@netless/fastboard-full` or `@netless/fastboard-react-full` together with `enableAppliancePlugin`, install an `@netless/appliance-plugin` version that exposes `./bridge`. We recommend `>= 1.1.35` (`./bridge` first appeared in `>= 1.1.34-beta.2`).
+>
+> Keep importing `@netless/appliance-plugin` in app code. You do not need, and generally should not, replace it with `@netless/appliance-plugin/bridge`. The `/bridge` entry is loaded internally by fastboard full to reuse the bundled `white-web-sdk` runtime.
+
 ### Register Plugin
 
 Plugins can support two scenarios, they have different plugin names:
@@ -157,6 +161,8 @@ const fastboard = await createFastboard({
   });
 ```
 
+> **Note:** In fastboard full mode, `@netless/fastboard-full` / `@netless/fastboard-react-full` load `@netless/appliance-plugin/bridge` internally. App code only needs to configure `enableAppliancePlugin`, provide worker URLs, and keep importing `@netless/appliance-plugin`; do not manually switch your import to `@netless/appliance-plugin/bridge`.
+
 #### Multi-window (Direct integration with window-manager)
 
 ```js

package/cdn/cdn.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r="/fullWorker-BBlLKX.js",o="/subWorker-CoPwom.js";exports.fullWorkerUrl=r;exports.subWorkerUrl=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r="/fullWorker-uAwmRi.js",e="/subWorker-BVNpAC.js";exports.fullWorkerUrl=r;exports.subWorkerUrl=e;