@netless/appliance-plugin 1.1.37 → 1.1.38-beta.1

package/dist/plugin/applianceMultiPlugin.d.ts

@@ -12,7 +12,7 @@ export declare class ApplianceMultiPlugin extends InvisiblePlugin<AppliancePlugi
     static getInstance(remake: WindowManager, adaptor: ApplianceAdaptor): Promise<AppliancePluginInstance>;
     static onCreate(plugin: InvisiblePlugin<AppliancePluginAttributes, any>): void;
     static createApplianceMultiPlugin(d: Room, kind: string): Promise<ApplianceMultiPlugin>;
-    static createCurrentManager: (remake: WindowManager, options: RequiredAppliancePluginOptions, plugin: ApplianceMultiPlugin) => void;
+    static createCurrentManager: (remake: WindowManager, options: RequiredAppliancePluginOptions, plugin: ApplianceMultiPlugin, onInitLoadingChange?: ApplianceAdaptor["onInitLoadingChange"]) => void;
     private get isReplay();
     private get callbackName();
     init(displayer: Displayer): void;

package/dist/plugin/applianceSinglePlugin.d.ts

@@ -12,7 +12,7 @@ export declare class ApplianceSinglePlugin extends InvisiblePlugin<AppliancePlug
     static getInstance(remake: Player | Room, adaptor: ApplianceAdaptor): Promise<AppliancePluginInstance>;
     static onCreate(plugin: InvisiblePlugin<AppliancePluginAttributes, any>): void;
     static createAppliancePlugin(d: Room, kind: string): Promise<ApplianceSinglePlugin>;
-    static createCurrentManager: (displayer: Displayer, options: RequiredAppliancePluginOptions, plugin?: ApplianceSinglePlugin) => void;
+    static createCurrentManager: (displayer: Displayer, options: RequiredAppliancePluginOptions, plugin?: ApplianceSinglePlugin, onInitLoadingChange?: ApplianceAdaptor["onInitLoadingChange"]) => void;
     /**
      * 房间实例化时，将当前实例对displayer外部API的添加内部处理逻辑;
      * @param displayer

package/dist/plugin/baseApplianceManager.d.ts

@@ -1,5 +1,5 @@
 import EventEmitter2 from "eventemitter2";
-import { EStrokeType, MemberState, AppliancePluginLike } from "./types";
+import { EStrokeType, MemberState, AppliancePluginLike, ApplianceInitLoadingChangeInfo, ApplianceFontFaceLoadState, ApplianceFontFaceRenderState, ApplianceRefreshRenderState } from "./types";
 import { Collector, ViewId } from "../collector";
 import { RoomMemberManager } from "../members";
 import { TextEditorManager } from "../component/textEditor";
@@ -19,6 +19,7 @@ export interface BaseApplianceManagerProps {
     displayer: Displayer<DisplayerCallbacks>;
     plugin?: AppliancePluginLike;
     options: RequiredAppliancePluginOptions;
+    onInitLoadingChange?: (info: ApplianceInitLoadingChangeInfo) => void;
 }
 /** 插件管理器 */
 export declare abstract class BaseApplianceManager {
@@ -37,6 +38,8 @@ export declare abstract class BaseApplianceManager {
     private _disableEraseText?;
     private _disableCameraTransform?;
     private _disableUseWorker?;
+    private initFontFaceTextRenderGate;
+    private initFontFaceTextRenderSkipped;
     effectResolve?: (value: boolean) => void;
     readonly hotkeyManager: HotkeyManager;
     readonly pluginOptions: RequiredAppliancePluginOptions;
@@ -48,6 +51,7 @@ export declare abstract class BaseApplianceManager {
     readonly renderControl: RenderCotrolImple;
     readonly miniMapManager?: MiniMapManagerImpl;
     readonly pluginManager?: PluginManager;
+    readonly onInitLoadingChange?: (info: ApplianceInitLoadingChangeInfo) => void;
     /** WB-429: selector 公开 API / 事件实现入口 */
     selectorApi?: SelectorApiManager;
     /** WB-429: selector API 事件派发用，指向 BaseApplianceManager.PublicMsgEmitter */
@@ -56,6 +60,9 @@ export declare abstract class BaseApplianceManager {
     get internalMsgEmitter(): EventEmitter2;
     private _isPolyfill;
     constructor(params: BaseApplianceManagerProps);
+    emitInitLoadingChange(info: ApplianceInitLoadingChangeInfo): void;
+    emitFontFaceLoadState(info: ApplianceFontFaceLoadState): void;
+    emitFontFaceRenderState(info: ApplianceFontFaceRenderState): void;
     hasPolyfillMethod(methodName: "requestIdleCallback" | "cancelIdleCallback"): boolean;
     registerPolyfillMethod(methodName: "requestIdleCallback" | "cancelIdleCallback"): void;
     get hasExtendFontFaces(): boolean;
@@ -64,6 +71,23 @@ export declare abstract class BaseApplianceManager {
         src: string;
     }[];
     get loadFontFacesTimeout(): number;
+    loadFontFaces(): Promise<ApplianceFontFaceLoadState>;
+    beginInitFontFaceTextRenderGate(): void;
+    markInitFontFaceTextRenderSkipped(): void;
+    shouldHoldServiceTextRenderForFontFace(): boolean;
+    hasInitFontFaceTextRenderSkipped(): boolean;
+    endInitFontFaceTextRenderGate(): void;
+    startInitFontFaceLoadAndRender(): void;
+    private waitNextFrame;
+    private getSortedRefreshViews;
+    private escapeCssIdentifier;
+    private getTextEditorElement;
+    private measureViewTextEditorsForRender;
+    private refreshViewTextRenderInternal;
+    refreshViewTextRender(viewId: string, emitState?: boolean): Promise<ApplianceRefreshRenderState>;
+    refreshTextRender(): Promise<ApplianceRefreshRenderState>;
+    refreshViewRender(viewId: string): Promise<ApplianceRefreshRenderState>;
+    refreshRender(): Promise<ApplianceRefreshRenderState>;
     get disableEraseText(): boolean;
     set disableEraseText(bol: boolean);
     get disableEraseImage(): boolean;

package/dist/plugin/baseViewContainerManager.d.ts

@@ -86,7 +86,11 @@ export declare abstract class ViewContainerManager {
     /** 是否显示浮动选框按钮 */
     showFloatBarBtn(viewId: string, isShow: boolean): void;
     /** 更新文字编辑器信息 */
-    updateTextEditorInfo(viewId: string, activeTextId?: string): void;
+    updateTextEditorInfo(viewId: string, activeTextId?: string, callback?: () => void): void;
+    /** 只触发文字编辑器层按当前 manager state 重新 render */
+    renderTextEditorInfo(viewId: string, activeTextId?: string, callback?: () => void): void;
+    renderTextEditorInfoAsync(viewId: string, activeTextId?: string): Promise<void>;
+    updateTextEditorInfoAsync(viewId: string, activeTextId?: string): Promise<void>;
     setActiveMiniMap(viewId: string, show?: boolean): void;
 }
 export declare abstract class BaseViewDisplayerManager {

package/dist/plugin/displayerView.d.ts

@@ -56,7 +56,8 @@ export declare class BaseViewDisplayer extends React.Component<BaseDisplayerProp
     showFloatBar(show: boolean, value?: Partial<ShowFloatBarMsgValue>): void;
     activeTextEditor(): void;
     unActiveTextEditor(): void;
-    updateTextEditorInfo(activeTextId?: string): void;
+    updateTextEditorInfo(activeTextId?: string, callback?: () => void): void;
+    renderTextEditorInfo(activeTextId?: string, callback?: () => void): void;
     setFloatBarData(data: Partial<ShowFloatBarMsgValue>): void;
     private setAngle;
     private setOperationType;

package/dist/plugin/types.d.ts

@@ -130,10 +130,27 @@ export interface BaseSubWorkModuleProps {
     internalMsgEmitter: EventEmitter2;
     publicMsgEmitter: EventEmitter2;
 }
+export type ApplianceInitLoadingPhase = "plugin" | "worker" | "scene" | "ready";
+export type ApplianceInitLoadingStatus = "start" | "success" | "timeout" | "error";
+export type ApplianceInitLoadingChangeInfo = {
+    loading: boolean;
+    phase: ApplianceInitLoadingPhase;
+    status: ApplianceInitLoadingStatus;
+};
+export type ApplianceFontFaceLoadState = {
+    status: "start" | "success" | "timeout" | "error";
+};
+export type ApplianceFontFaceRenderState = {
+    status: "start" | "success" | "error";
+};
+export type ApplianceRefreshRenderState = {
+    status: "success" | "error";
+};
 export type ApplianceAdaptor = {
     options: AppliancePluginOptions;
     logger?: Logger;
     cursorAdapter?: CursorAdapter;
+    onInitLoadingChange?: (info: ApplianceInitLoadingChangeInfo) => void;
 };
 export type canBindMethodType = keyof Omit<AppliancePluginInstance, "displayer" | "windowManager" | "disableDeviceInputs" | "disableEraseImage" | "disableCameraTransform" | "injectMethodToObject" | "callbacksOn" | "callbacksOnce" | "callbacksOff" | "_injectTargetObject" | "createMiniMap" | "destroyMiniMap" | "filterRenderByUid" | "cancelFilterRender" | "addListener" | "removeListener" | "usePlugin" | "stopDraw" | "setViewLocalScenePathChange" | "getElements" | "hasElements" | "blurText" | "insertMarkmap" | "updateMarkmap" | "insertBackgroundImage" | "getSelectedElements" | "updateSelectedElements" | "copySelectedElements" | "deleteSelectedElements" | "getFloatbarContainer" | "getViewOffsetToContainer">;
 export interface AppliancePluginInstance {
@@ -293,6 +310,16 @@ export interface AppliancePluginInstance {
     getElements(scenePath?: string, filter?: (toolsType: EToolsKey) => boolean): BaseCollectorReducerAction[];
     /** 停止Draw事件 */
     stopDraw(viewId: string): Promise<void>;
+    /** 加载自定义字体，不阻塞插件初始化 */
+    loadFontFaces(): Promise<ApplianceFontFaceLoadState>;
+    /** 刷新指定 view 的 canvas 与文字 DOM 渲染 */
+    refreshViewRender(viewId: string): Promise<ApplianceRefreshRenderState>;
+    /** 刷新所有 view 的 canvas 与文字 DOM 渲染，优先刷新 focused view */
+    refreshRender(): Promise<ApplianceRefreshRenderState>;
+    /** 仅刷新指定 view 的文字 DOM 渲染 */
+    refreshViewTextRender(viewId: string): Promise<ApplianceRefreshRenderState>;
+    /** 仅刷新所有 view 的文字 DOM 渲染，优先刷新 focused view */
+    refreshTextRender(): Promise<ApplianceRefreshRenderState>;
     /** 设置白板本地场景路径变化 */
     setViewLocalScenePathChange(viewId: string, scenePath: string): Promise<void>;
     /** 插入markmap */
@@ -712,6 +739,10 @@ export type PublicListener = {
     workState: (workState: EventWorkState, viewId: string) => void;
     /** 强制中断 */
     forceStop: (reason: EForceStopReason, viewId: string) => void;
+    /** 自定义字体加载状态 */
+    fontFaceLoadState: (info: ApplianceFontFaceLoadState) => void;
+    /** 自定义字体加载后的文字重渲染状态 */
+    fontFaceRenderState: (info: ApplianceFontFaceRenderState) => void;
     /** auto shape 调试信息 */
     autoShape: (info: AutoShapeDebugInfo) => void;
     /** 同步数据变化 */