@netless/appliance-plugin 1.1.22-beta.0 → 1.1.22-beta.10

package/dist/plugin/baseApplianceManager.d.ts

@@ -3,7 +3,7 @@ import { MemberState, AppliancePluginLike } from "./types";
 import { Collector, ViewId } from "../collector";
 import { RoomMemberManager } from "../members";
 import { TextEditorManager } from "../component/textEditor";
-import type { Camera, Displayer, DisplayerCallbacks, IconifyInformation, Player, PriorityType, Rectangle, RequiredAppliancePluginOptions, Room, RoomMember, _ArrayTrue } from "./types";
+import type { Camera, Displayer, DisplayerCallbacks, IconifyInformation, Player, Rectangle, RequiredAppliancePluginOptions, Room, RoomMember, _ArrayTrue } from "./types";
 import { CursorManager } from "../cursors";
 import { ViewContainerManager } from "./baseViewContainerManager";
 import { MasterControlForWorker } from "../core/mainEngine";
@@ -35,7 +35,6 @@ export declare abstract class BaseApplianceManager {
     private _disableEraseText?;
     private _disableCameraTransform?;
     private _disableUseWorker?;
-    priority: PriorityType;
     effectResolve?: (value: boolean) => void;
     readonly hotkeyManager: HotkeyManager;
     readonly pluginOptions: RequiredAppliancePluginOptions;
@@ -45,12 +44,18 @@ export declare abstract class BaseApplianceManager {
     readonly worker: MasterControlForWorker;
     abstract readonly viewContainerManager: ViewContainerManager;
     readonly renderControl: RenderCotrolImple;
-    readonly miniMapManager: MiniMapManagerImpl;
-    readonly pluginManager: PluginManager;
+    readonly miniMapManager?: MiniMapManagerImpl;
+    readonly pluginManager?: PluginManager;
     private _isPolyfill;
     constructor(params: BaseApplianceManagerProps);
     hasPolyfillMethod(methodName: "requestIdleCallback" | "cancelIdleCallback"): boolean;
     registerPolyfillMethod(methodName: "requestIdleCallback" | "cancelIdleCallback"): void;
+    get hasExtendFontFaces(): boolean;
+    get extendFontFaces(): {
+        fontFamily: string;
+        src: string;
+    }[];
+    get loadFontFacesTimeout(): number;
     get disableEraseText(): boolean;
     set disableEraseText(bol: boolean);
     get disableEraseImage(): boolean;
@@ -61,8 +66,11 @@ export declare abstract class BaseApplianceManager {
     set disableCameraTransform(bol: boolean);
     get disableUseWorker(): boolean;
     set disableUseWorker(bol: boolean);
-    setPriority(priority: PriorityType): void;
-    hasOffscreenCanvas(): boolean;
+    get hasOffscreenCanvas(): boolean;
+    get canUseTransferControlToOffscreen(): boolean;
+    get isUseOffscreenTransfer(): boolean;
+    /** 是否使用简单模式, 简单模式则无需开启 miniMap 和 plugin */
+    get isUseSimple(): boolean;
     bindPlugin(plugin: AppliancePluginLike): void;
     /** 激活 plugin */
     abstract activePlugin(): void;
@@ -122,5 +130,6 @@ export declare abstract class BaseApplianceManager {
     createMiniMap(viewId: string, div: HTMLElement): Promise<void>;
     destroyMiniMap(viewId: string): Promise<void>;
     insertIconify(viewId: string, iconifyInfo: IconifyInformation): void;
-    usePlugin(plugin: Plugin): void;
+    usePlugin(plugin: Plugin): void | undefined;
+    stopDraw(viewId: string): Promise<void>;
 }

package/dist/plugin/baseViewContainerManager.d.ts

@@ -2,6 +2,8 @@ import type EventEmitter2 from "eventemitter2";
 import { ICameraOpt, ILayerOptionType, IMainMessageRenderData, IOffscreenCanvasOptionType, ViewWorkerOptions } from "../core/types";
 import { BaseSubWorkModuleProps, ApplianceManagerLike } from "./types";
 import type { CameraState, View } from "./types";
+import type { DebouncedFunc, DebouncedFuncLeading } from "lodash";
+import { EToolsKey } from "../core/enum";
 import { ShowFloatBarMsgValue } from "../displayer/types";
 import { UndoRedoMethod } from "../undo";
 import { BaseViewDisplayer } from "./displayerView";
@@ -66,9 +68,7 @@ export declare abstract class ViewContainerManager {
     updateTextEditorInfo(viewId: string, activeTextId?: string): void;
     setActiveMiniMap(viewId: string, show?: boolean): void;
 }
-/** appView容器管理器抽象 */
-export declare abstract class AppViewDisplayerManager {
-    viewId: string;
+export declare abstract class BaseViewDisplayerManager {
     abstract dpr: number;
     abstract width: number;
     abstract height: number;
@@ -78,8 +78,8 @@ export declare abstract class AppViewDisplayerManager {
     abstract vDom?: BaseViewDisplayer;
     abstract eventTragetElement?: HTMLDivElement;
     abstract canvasContainerRef: React.RefObject<HTMLDivElement>;
-    abstract subLocalCanvasContainerRef: React.RefObject<HTMLDivElement>;
-    abstract canvasTopRef: React.RefObject<HTMLCanvasElement>;
+    abstract subLocalCanvasContainerRef?: React.RefObject<HTMLDivElement>;
+    abstract canvasTopRef?: React.RefObject<HTMLCanvasElement>;
     abstract canvasServiceFloatRef: React.RefObject<HTMLCanvasElement>;
     abstract canvasFloatRef: React.RefObject<HTMLCanvasElement>;
     abstract canvasBgRef: React.RefObject<HTMLCanvasElement>;
@@ -88,25 +88,42 @@ export declare abstract class AppViewDisplayerManager {
         x: number;
         y: number;
     };
-    private cachePoint?;
-    private cacheCursorPoint?;
-    private active;
-    private toolsKey?;
-    constructor(viewId: string, control: ApplianceManagerLike, internalMsgEmitter: EventEmitter2);
-    get worker(): import("../core/mainEngine").MasterControlForWorker;
+    protected cachePoint?: [number, number];
+    protected cacheCursorPoint?: [number | undefined, number | undefined];
+    protected active: boolean;
+    protected toolsKey?: EToolsKey;
+    protected cursorMouseMove: (e: MouseEvent) => void;
+    protected cursorMouseMoveDebounced: DebouncedFunc<(e: MouseEvent) => void>;
+    protected cursorMouseMoveThrottled: DebouncedFuncLeading<(e: MouseEvent) => void>;
+    protected cursorMouseMoveFun: (e: MouseEvent) => void;
+    private _transferControlToOffscreenCanvas?;
+    get moveDelayTime(): number;
+    constructor(control: ApplianceManagerLike, internalMsgEmitter: EventEmitter2, viewId: string);
+    protected cursorMouseLeave: () => void;
     abstract setCanvassStyle(): void;
+    setTransferControlToOffscreenCanvas(canvas: {
+        bgCanvas: HTMLCanvasElement;
+        serviceCanvas: HTMLCanvasElement;
+        localCanvas: HTMLCanvasElement;
+    }): void;
+    get transferControlToOffscreenCanvas(): {
+        bgCanvas: OffscreenCanvas;
+        serviceCanvas: OffscreenCanvas;
+        localCanvas: OffscreenCanvas;
+    } | undefined;
+    get worker(): import("../core/mainEngine").MasterControlForWorker;
     bindToolsClass(): void;
     mountView(): void;
-    reflashContainerOffset(): void;
     updateSize(): void;
-    setViewId(viewId: string): void;
+    reflashContainerOffset(): void;
     get parentElement(): HTMLElement | null | undefined;
     destroy(): void;
     getPoint(e: any): [number, number] | undefined;
-    getActive(): void;
+    getActive(): boolean;
     setActive(bol: boolean): void;
+    focusElement(): void;
     stopEventHandler(): Promise<void>;
-    private getTranslate;
+    protected getTranslate(element: any): any[];
     protected getContainerOffset(eventTraget: HTMLDivElement, offset: {
         x: number;
         y: number;
@@ -114,82 +131,33 @@ export declare abstract class AppViewDisplayerManager {
         x: any;
         y: any;
     };
-    get isBezier(): boolean;
-    get maxDrawCount(): number;
-    private checkConsumeCount;
+    abstract get viewId(): string;
     protected mousedown: (e: MouseEvent) => void;
     protected mousemove: (e: MouseEvent) => void;
     protected mouseup: (e: MouseEvent) => void;
     protected touchstart: (e: TouchEvent) => void;
     protected touchmove: (e: TouchEvent) => void;
     protected touchend: (e: TouchEvent) => void;
-    cursorMouseMove: import("lodash").DebouncedFunc<(e: MouseEvent) => void>;
-    protected cursorMouseLeave: import("lodash").DebouncedFunc<() => void>;
     protected keydown: (e: KeyboardEvent) => void;
     protected bindDisplayerEvent(div: HTMLDivElement): void;
     protected removeDisplayerEvent(div: HTMLDivElement): void;
+    get isBezier(): boolean;
+    get maxDrawCount(): number;
+    /** 检查是否超过最大绘制数量 */
+    checkConsumeCount(): boolean;
+}
+/** appView容器管理器抽象 */
+export declare abstract class AppViewDisplayerManager extends BaseViewDisplayerManager {
+    private _viewId;
+    constructor(viewId: string, control: ApplianceManagerLike, internalMsgEmitter: EventEmitter2);
+    get viewId(): string;
+    setViewId(viewId: string): void;
 }
 /** 主容器管理器抽象 */
-export declare abstract class MainViewDisplayerManager {
-    readonly viewId: string;
-    readonly control: ApplianceManagerLike;
-    readonly internalMsgEmitter: EventEmitter2;
-    readonly commiter: UndoRedoMethod;
-    abstract dpr: number;
-    abstract width: number;
-    abstract height: number;
-    abstract vDom?: BaseViewDisplayer;
-    abstract eventTragetElement?: HTMLDivElement;
+export declare abstract class MainViewDisplayerManager extends BaseViewDisplayerManager {
     abstract snapshotContainerRef?: React.RefObject<HTMLDivElement>;
-    abstract canvasContainerRef: React.RefObject<HTMLDivElement>;
-    abstract subLocalCanvasContainerRef: React.RefObject<HTMLDivElement>;
-    abstract canvasTopRef: React.RefObject<HTMLCanvasElement>;
-    abstract canvasServiceFloatRef: React.RefObject<HTMLCanvasElement>;
-    abstract canvasFloatRef: React.RefObject<HTMLCanvasElement>;
-    abstract canvasBgRef: React.RefObject<HTMLCanvasElement>;
-    abstract floatBarRef: React.RefObject<HTMLDivElement>;
-    abstract containerOffset: {
-        x: number;
-        y: number;
-    };
-    private cachePoint?;
-    private cacheCursorPoint?;
-    private active;
-    private toolsKey?;
     constructor(control: ApplianceManagerLike, internalMsgEmitter: EventEmitter2);
-    abstract setCanvassStyle(): void;
-    get worker(): import("../core/mainEngine").MasterControlForWorker;
-    bindToolsClass(): void;
-    mountView(): void;
+    get viewId(): string;
     updateSize(): void;
-    reflashContainerOffset(): void;
-    get parentElement(): HTMLElement | null | undefined;
     destroy(): void;
-    getPoint(e: any): [number, number] | undefined;
-    getActive(): boolean;
-    setActive(bol: boolean): void;
-    stopEventHandler(): Promise<void>;
-    private getTranslate;
-    protected getContainerOffset(eventTraget: HTMLDivElement, offset: {
-        x: number;
-        y: number;
-    }): {
-        x: any;
-        y: any;
-    };
-    get isBezier(): boolean;
-    get maxDrawCount(): number;
-    /** 检查是否超过最大绘制数量 */
-    private checkConsumeCount;
-    protected mousedown: (e: MouseEvent) => void;
-    protected mousemove: (e: MouseEvent) => void;
-    protected mouseup: (e: MouseEvent) => void;
-    protected touchstart: (e: TouchEvent) => void;
-    protected touchmove: (e: TouchEvent) => void;
-    protected touchend: (e: TouchEvent) => void;
-    cursorMouseMove: import("lodash").DebouncedFunc<(e: MouseEvent) => void>;
-    protected cursorMouseLeave: import("lodash").DebouncedFunc<() => void>;
-    protected keydown: (e: KeyboardEvent) => void;
-    protected bindDisplayerEvent(div: HTMLDivElement): void;
-    protected removeDisplayerEvent(div: HTMLDivElement): void;
 }

package/dist/plugin/displayerView.d.ts

@@ -8,11 +8,11 @@ export interface BaseDisplayerProps {
     refs: {
         snapshotContainerRef?: React.RefObject<HTMLDivElement>;
         canvasContainerRef: React.RefObject<HTMLDivElement>;
-        subLocalCanvasContainerRef: React.RefObject<HTMLDivElement>;
+        subLocalCanvasContainerRef?: React.RefObject<HTMLDivElement>;
         canvasServiceFloatRef: React.RefObject<HTMLCanvasElement>;
         canvasFloatRef: React.RefObject<HTMLCanvasElement>;
         canvasBgRef: React.RefObject<HTMLCanvasElement>;
-        canvasTopRef: React.RefObject<HTMLCanvasElement>;
+        canvasTopRef?: React.RefObject<HTMLCanvasElement>;
         floatBarRef: React.RefObject<HTMLDivElement>;
     };
 }

package/dist/plugin/multi/displayer/appViewDisplayerManager.d.ts

@@ -10,8 +10,8 @@ export declare class AppViewDisplayerManagerImpl extends AppViewDisplayerManager
     vDom?: BaseViewDisplayer;
     eventTragetElement?: HTMLDivElement;
     canvasContainerRef: React.RefObject<HTMLDivElement>;
-    subLocalCanvasContainerRef: React.RefObject<HTMLDivElement>;
-    canvasTopRef: React.RefObject<HTMLCanvasElement>;
+    subLocalCanvasContainerRef?: React.RefObject<HTMLDivElement>;
+    canvasTopRef?: React.RefObject<HTMLCanvasElement>;
     canvasServiceFloatRef: React.RefObject<HTMLCanvasElement>;
     canvasFloatRef: React.RefObject<HTMLCanvasElement>;
     canvasBgRef: React.RefObject<HTMLCanvasElement>;

package/dist/plugin/multi/displayer/mainViewDisplayerManager.d.ts

@@ -11,8 +11,8 @@ export declare class MainViewMultiDisplayerManager extends MainViewDisplayerMana
     eventTragetElement?: HTMLDivElement;
     snapshotContainerRef?: React.RefObject<HTMLDivElement>;
     canvasContainerRef: React.RefObject<HTMLDivElement>;
-    subLocalCanvasContainerRef: React.RefObject<HTMLDivElement>;
-    canvasTopRef: React.RefObject<HTMLCanvasElement>;
+    subLocalCanvasContainerRef?: React.RefObject<HTMLDivElement>;
+    canvasTopRef?: React.RefObject<HTMLCanvasElement>;
     canvasServiceFloatRef: React.RefObject<HTMLCanvasElement>;
     canvasFloatRef: React.RefObject<HTMLCanvasElement>;
     canvasBgRef: React.RefObject<HTMLCanvasElement>;

package/dist/plugin/single/displayer/mainViewDisplayerManager.d.ts

@@ -8,12 +8,11 @@ export declare class MainViewSingleDisplayerManager extends MainViewDisplayerMan
     height: number;
     dpr: number;
     vDom?: BaseViewDisplayer;
-    viewId: string;
     eventTragetElement?: HTMLDivElement;
     snapshotContainerRef?: React.RefObject<HTMLDivElement>;
     canvasContainerRef: React.RefObject<HTMLDivElement>;
-    subLocalCanvasContainerRef: React.RefObject<HTMLDivElement>;
-    canvasTopRef: React.RefObject<HTMLCanvasElement>;
+    subLocalCanvasContainerRef?: React.RefObject<HTMLDivElement>;
+    canvasTopRef?: React.RefObject<HTMLCanvasElement>;
     canvasServiceFloatRef: React.RefObject<HTMLCanvasElement>;
     canvasFloatRef: React.RefObject<HTMLCanvasElement>;
     canvasBgRef: React.RefObject<HTMLCanvasElement>;

package/dist/plugin/types.d.ts

@@ -1,4 +1,4 @@
-import type { ISerializableEventData, ISerializableStorageViewData, Uid } from "../collector/types";
+import type { BaseCollectorReducerAction, ISerializableEventData, ISerializableStorageViewData, Uid } from "../collector/types";
 import type { Cursor, View, CameraState, DisplayerCallbacks, HotKeys, Player, Room, Point, RoomMember, RoomState, Size, Callbacks, Camera, Color, CursorAdapter, Displayer, ImageInformation, Rectangle, RenderEngine, MemberState as _MemberState } from "white-web-sdk";
 import type EventEmitter2 from "eventemitter2";
 import type { ApplianceSingleManager } from "./single/applianceSingleManager";
@@ -208,12 +208,6 @@ export interface AppliancePluginInstance {
     setWritable(writable: boolean): Promise<void>;
     /** setMemberState */
     setMemberState(modifyState: Partial<MemberState>): void;
-    /** 设置性能优先项
-     * @param priority 优先项, 可以是 ``ui`` 或 ``cpu``
-     * ui: 优先绘制UI，适用于需要绘制高跟手度
-     * cpu: 优先降低主进程CPU消耗，适用于底端设备
-     */
-    setPerformancePriority(priority: PriorityType): void;
     /** 获取undo */
     canUndoSteps(): number;
     /** 获取redo */
@@ -284,6 +278,15 @@ export interface AppliancePluginInstance {
      * @returns 是否存在元素
      */
     hasElements(scenePath?: string, filter?: (toolsType: EToolsKey) => boolean): boolean;
+    /**
+     * 获取场景下的所有元素
+     * @param scenePath 场景路径, 默认取当前聚焦的场景
+     * @param filter 过滤条件
+     * @returns 所有元素
+     */
+    getElements(scenePath?: string, filter?: (toolsType: EToolsKey) => boolean): BaseCollectorReducerAction[];
+    /** 停止Draw事件 */
+    stopDraw(viewId: string): Promise<void>;
 }
 export type Logger = {
     readonly info: (...messages: any[]) => void;
@@ -296,6 +299,8 @@ export type ExtrasOptions = {
      * mainThread: 使用主线程
      */
     useWorker?: UseWorkerType;
+    /** 是否使用简单模式, 默认值为 ``false`` */
+    useSimple?: boolean;
     /** 同步数据配置项 */
     syncOpt?: SyncOpt;
     /** 画布配置项 */
@@ -321,6 +326,7 @@ export type AppliancePluginOptions = {
 };
 export type RequiredExtrasOptions = {
     useWorker: Required<UseWorkerType>;
+    useSimple: Required<boolean>;
     syncOpt: Required<SyncOpt>;
     canvasOpt: Required<CanvasOpt>;
     cursor: Required<CursorOpt>;
@@ -398,6 +404,8 @@ export type CursorOpt = {
     enable: boolean;
     /** 指针消失过期时间 */
     expirationTime?: number;
+    /** 指针移动延迟时间 */
+    moveDelayTime?: number;
 };
 export type BufferSizeOpt = {
     /** 分配给绘制完整数据cancanvas 缓存大小 */
@@ -430,6 +438,13 @@ export type TextEditorOpt = {
     canSelectorSwitch?: boolean;
     /** 是否右边界自动换行 */
     rightBoundBreak?: boolean;
+    /** 扩展字体列表 */
+    extendFontFaces?: {
+        fontFamily: string;
+        src: string;
+    }[];
+    /** 加载字体超时时间，单位：毫秒 */
+    loadFontFacesTimeout?: number;
 };
 export type StrokeWidthOpt = {
     /** 最小线宽 */
@@ -500,7 +515,6 @@ export declare enum ActiveContainerType {
 }
 export type SpeechBalloonPlacement = "top" | "left" | "right" | "bottom" | "topLeft" | "topRight" | "bottomLeft" | "bottomRight" | "leftTop" | "leftBottom" | "rightTop" | "rightBottom";
 export type TeleBoxState = "normal" | "minimized" | "maximized";
-export type PriorityType = "ui" | "cpu";
 export type FilterRenderType = "show" | "hide";
 export type FilterPublishAutType = "write" | "readOnly";
 export type FilterRenderDataType = "page" | "uid";