@netless/appliance-plugin 1.1.41 → 1.1.42-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, onInitLoadingChange?: ApplianceAdaptor["onInitLoadingChange"]) => void;
+    static createCurrentManager: (remake: WindowManager, options: RequiredAppliancePluginOptions, plugin: ApplianceMultiPlugin, callbacks?: ApplianceAdaptor["callbacks"]) => 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, onInitLoadingChange?: ApplianceAdaptor["onInitLoadingChange"]) => void;
+    static createCurrentManager: (displayer: Displayer, options: RequiredAppliancePluginOptions, plugin?: ApplianceSinglePlugin, callbacks?: ApplianceAdaptor["callbacks"]) => void;
     /**
      * 房间实例化时，将当前实例对displayer外部API的添加内部处理逻辑;
      * @param displayer

package/dist/plugin/baseApplianceManager.d.ts

@@ -1,5 +1,5 @@
 import EventEmitter2 from "eventemitter2";
-import { EStrokeType, MemberState, AppliancePluginLike, ApplianceInitLoadingChangeInfo, ApplianceFontFaceLoadState, ApplianceFontFaceRenderState, ApplianceRefreshRenderState } from "./types";
+import { EStrokeType, MemberState, AppliancePluginLike, ApplianceInitLoadingChangeInfo, ApplianceFontFaceLoadState, ApplianceFontFaceRenderState, ApplianceRefreshRenderState, CallbacksFun } from "./types";
 import { Collector, ViewId } from "../collector";
 import { RoomMemberManager } from "../members";
 import { TextEditorManager } from "../component/textEditor";
@@ -23,7 +23,7 @@ export interface BaseApplianceManagerProps {
     displayer: Displayer<DisplayerCallbacks>;
     plugin?: AppliancePluginLike;
     options: RequiredAppliancePluginOptions;
-    onInitLoadingChange?: (info: ApplianceInitLoadingChangeInfo) => void;
+    callbacks?: CallbacksFun;
 }
 /** 插件管理器 */
 export declare abstract class BaseApplianceManager {
@@ -54,6 +54,7 @@ export declare abstract class BaseApplianceManager {
     private _disableCameraTransform?;
     private initFontFaceTextRenderGate;
     private initFontFaceTextRenderSkipped;
+    private readonly mainViewMountedReady;
     effectResolve?: (value: boolean) => void;
     readonly hotkeyManager: HotkeyManager;
     readonly pluginOptions: RequiredAppliancePluginOptions;
@@ -67,7 +68,7 @@ export declare abstract class BaseApplianceManager {
     readonly renderControl: RenderCotrolImple;
     readonly miniMapManager?: MiniMapManagerImpl;
     readonly pluginManager?: PluginManager;
-    readonly onInitLoadingChange?: (info: ApplianceInitLoadingChangeInfo) => void;
+    readonly callbacks?: CallbacksFun;
     /** WB-429: selector 公开 API / 事件实现入口 */
     selectorApi?: SelectorApiManager;
     /** WB-429: selector API 事件派发用，指向 BaseApplianceManager.PublicMsgEmitter */
@@ -77,6 +78,15 @@ export declare abstract class BaseApplianceManager {
     private _isPolyfill;
     constructor(params: BaseApplianceManagerProps);
     emitInitLoadingChange(info: ApplianceInitLoadingChangeInfo): void;
+    /**
+     * 主视图 displayer 真正创建完成（WindowManager.bindMainView 或
+     * ApplianceSigleWrapper 绑定 main view）后由 viewContainerManager 通知。
+     * 与 WindowManager 的延迟 bindContainer 模式对齐：getInstance 在
+     * 主视图尚未挂载时不再阻塞等待 render-init ack，等挂载后补齐。
+     */
+    notifyMainViewMounted(): void;
+    isMainViewMounted(): boolean;
+    waitForMainViewMounted(timeoutMs?: number): Promise<"ready" | "cancelled" | "timeout">;
     emitFontFaceLoadState(info: ApplianceFontFaceLoadState): void;
     emitFontFaceRenderState(info: ApplianceFontFaceRenderState): void;
     hasPolyfillMethod(methodName: "requestIdleCallback" | "cancelIdleCallback"): boolean;

package/dist/plugin/renderingCompatibility.d.ts

@@ -32,12 +32,13 @@ export type RenderingCompatibilityDecision = {
     effectiveImageBitmapFeatureLevel?: WorkerImageBitmapFeatureBlacklistLevel;
     issues: string[];
 };
-type BlacklistKind = "renderMode" | "canvasContext" | "maskTextureFormat" | "maskTextureUpload" | "imageBitmapFeature";
+type BlacklistKind = "renderMode" | "canvasContext" | "maskTextureFormat" | "maskTextureUpload" | "imageBitmapFeature" | "fontFaceFallback";
 export declare function normalizeVersion(value: string): string | undefined;
 export declare function compareVersions(left: string, right: string): number;
 export declare function detectRenderingRuntime(userAgent?: string): RenderingRuntime | undefined;
 export declare function resolveVersionBlacklistLevel(currentVersion: string, rules: VersionWorkerBlacklist | undefined, kind: BlacklistKind, issues?: string[]): number | undefined;
 export declare function mergeWorkerBlacklists(builtin: WorkerBlacklistByRuntime | undefined, injected: WorkerBlacklistByRuntime | undefined, kind: BlacklistKind): WorkerBlacklistByRuntime;
+export declare function isFontFaceFallbackBlacklisted(blacklist: WorkerBlacklistByRuntime | undefined, userAgent?: string): boolean;
 export declare function detectRenderCapabilities(workerUrl?: boolean): RenderCapabilities;
 export declare function resolveRenderingCompatibility(input: {
     useWorker: "auto" | "mainThread";

package/dist/plugin/types.d.ts

@@ -159,11 +159,16 @@ export type ApplianceFontFaceRenderState = {
 export type ApplianceRefreshRenderState = {
     status: "success" | "error";
 };
+/** Runtime callbacks. These are deliberately outside options/extras so options remain JSON-serializable. */
+export type CallbacksFun = {
+    onInitLoadingChange?: (info: ApplianceInitLoadingChangeInfo) => void;
+    onBackgroundImageLoadEvent?: (event: BackgroundImageLoadEvent) => void;
+};
 export type ApplianceAdaptor = {
     options: AppliancePluginOptions;
     logger?: Logger;
     cursorAdapter?: CursorAdapter;
-    onInitLoadingChange?: (info: ApplianceInitLoadingChangeInfo) => void;
+    callbacks?: CallbacksFun;
 };
 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" | "hasBackgroundImage" | "blurText" | "insertMarkmap" | "updateMarkmap" | "insertBackgroundImage" | "getSelectedElements" | "updateSelectedElements" | "copySelectedElements" | "deleteSelectedElements" | "getFloatbarContainer" | "getViewOffsetToContainer">;
 export interface AppliancePluginInstance {
@@ -421,6 +426,9 @@ export declare enum WorkerMaskTextureUploadBlacklistLevel {
 export declare enum WorkerImageBitmapFeatureBlacklistLevel {
     DirtyRect = 1
 }
+export declare enum FontFaceFallbackBlacklistLevel {
+    RefreshTextRender = 1
+}
 export type VersionWorkerBlacklist = Record<string, number>;
 export type WorkerBlacklistByRuntime = {
     androidWebView?: VersionWorkerBlacklist;
@@ -451,6 +459,8 @@ export type ExtrasOptions = {
     workerMaskTextureUploadBlacklist?: WorkerBlacklistByRuntime;
     /** API 可用但 ImageBitmap crop 行为异常的运行时版本 */
     workerImageBitmapFeatureBlacklist?: WorkerBlacklistByRuntime;
+    /** 按运行时版本启用字体加载失败后的文本补绘兜底 */
+    fontFaceFallbackBlacklist?: WorkerBlacklistByRuntime;
     /** 是否使用背景Svg功能, 默认值为 ``false`` */
     useBackgroundThread?: boolean;
     /** 同步数据配置项 */
@@ -485,8 +495,6 @@ export type ExtrasOptions = {
     overwriteSelectorStyles?: SelectorStyleOverrides;
     /** 可见背景图片的超时与重试策略。 */
     backgroundImageLoadOptions?: BackgroundImageLoadOptions;
-    /** Bridge 等集成层使用的背景图片加载事件入口。 */
-    onBackgroundImageLoadEvent?: (event: BackgroundImageLoadEvent) => void;
 };
 export type SelectorStyleOverrides = {
     /** `.appliance-plugin-highlight-box` 外框样式 */
@@ -565,6 +573,7 @@ export type RequiredExtrasOptions = {
     workerMaskTextureFormatBlacklist: WorkerBlacklistByRuntime;
     workerMaskTextureUploadBlacklist: WorkerBlacklistByRuntime;
     workerImageBitmapFeatureBlacklist: WorkerBlacklistByRuntime;
+    fontFaceFallbackBlacklist: WorkerBlacklistByRuntime;
     useBackgroundThread: Required<boolean>;
     syncOpt: Required<SyncOpt>;
     syncLogger: Required<SyncLoggerOpt>;
@@ -582,7 +591,6 @@ export type RequiredExtrasOptions = {
     markmap: Required<MarkmapOpt>;
     overwriteSelectorStyles: SelectorStyleOverrides;
     backgroundImageLoadOptions: Required<BackgroundImageLoadOptions>;
-    onBackgroundImageLoadEvent?: (event: BackgroundImageLoadEvent) => void;
 };
 export type RequiredAppliancePluginOptions = {
     cdn: CdnOpt;