@netless/window-manager 1.0.12 → 1.0.13-bate.1

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as lodash from 'lodash';
 import * as white_web_sdk from 'white-web-sdk';
-import { SceneDefinition, SceneState, DisplayerState, View, ApplianceNames, ViewVisionMode, CameraState, RoomMember, Camera, Size, Event as Event$1, Scope, EventPhase, MagixEventListenerOptions as MagixEventListenerOptions$1, toJS, listenUpdated, unlistenUpdated, listenDisposed, unlistenDisposed, Room, ViewMode, Displayer, MemberState, AnimationMode, InvisiblePlugin, InvisiblePluginContext, Player, Rectangle, Point, CameraBound, ImageInformation } from 'white-web-sdk';
+import { SceneDefinition, SceneState, DisplayerState, View, ApplianceNames, ViewVisionMode, CameraState, RoomMember, Camera, Size, Event as Event$1, Scope, EventPhase, MagixEventListenerOptions as MagixEventListenerOptions$1, toJS, listenUpdated, unlistenUpdated, listenDisposed, unlistenDisposed, Room, ViewMode, Displayer, MemberState, Logger, AnimationMode, InvisiblePlugin, InvisiblePluginContext, Player, Rectangle, Point, CameraBound, ImageInformation } from 'white-web-sdk';
 export { AnimationMode, Displayer, Player, Room, SceneDefinition, SceneState, View } from 'white-web-sdk';
 import { TELE_BOX_STATE, TeleBoxRect, TeleBoxState, TeleBoxColorScheme, NotMinimizedBoxState, TeleBoxManager, TeleBoxCollector, ReadonlyTeleBox, TeleBoxManagerUpdateConfig, TeleBoxConfig } from '@netless/telebox-insider';
 export { ReadonlyTeleBox, TeleBoxCollector, TeleBoxManager, TeleBoxRect } from '@netless/telebox-insider';
@@ -327,6 +327,11 @@ type EmitterEvent = {
     changePageState: undefined;
     writableChange: boolean;
     containerSizeRatioUpdate: number;
+    wrapperRectChange: {
+        width: number;
+        height: number;
+        origin?: string;
+    };
     boxesStatusChange: Map<string, TeleBoxState>;
     lastNotMinimizedBoxesStatusChange: Map<string, NotMinimizedBoxState>;
 };
@@ -727,6 +732,7 @@ declare class AppProxy implements PageRemoveService {
     get isWritable(): boolean;
     get attributes(): any;
     get appAttributes(): AppSyncAttributes;
+    get Logger(): white_web_sdk.Logger | undefined;
     getFullScenePath(): string | undefined;
     private getFullScenePathFromScenes;
     setFullPath(path: string): void;
@@ -767,10 +773,17 @@ declare class MainViewProxy {
     private scale?;
     private started;
     private mainViewIsAddListener;
+    private isForcingMainViewDivElement;
+    private wrapperRectWorkaroundFrame;
+    private pendingWrapperRectChange?;
     private mainView;
     private store;
     private viewMode;
     private sideEffectManager;
+    private playgroundSizeChangeListenerLocalConsole;
+    private sizeUpdatedLocalConsole;
+    private cameraUpdatedLocalConsole;
+    private cameraReactionLocalConsole;
     constructor(manager: AppManager);
     private syncCamera;
     private startListenWritableChange;
@@ -779,6 +792,9 @@ declare class MainViewProxy {
     private get mainViewSize();
     private get didRelease();
     private moveCameraSizeByAttributes;
+    private onWrapperRectChange;
+    private runWrapperRectWorkaround;
+    private forceSyncMainViewDivElement;
     start(): void;
     addCameraReaction: () => void;
     setCameraAndSize(): void;
@@ -806,7 +822,9 @@ declare class MainViewProxy {
     private addCameraListener;
     private removeCameraListener;
     private _syncMainViewTimer;
-    private onCameraOrSizeUpdated;
+    private handleCameraOrSizeUpdated;
+    private onCameraUpdated;
+    private onSizeUpdated;
     private ensureMainViewSize;
     private syncMainView;
     moveCameraToContian(size: Size): void;
@@ -903,6 +921,7 @@ declare class AppManager {
     set polling(b: boolean);
     get focusApp(): AppProxy | undefined;
     get uid(): string;
+    get Logger(): white_web_sdk.Logger | undefined;
     getMainViewSceneDir(): string;
     private onCreated;
     private onBoxMove;
@@ -936,6 +955,8 @@ declare class AppManager {
     private onAppDelete;
     private closeAll;
     bindMainView(divElement: HTMLDivElement, disableCameraTransform: boolean): void;
+    private hasRoot;
+    private getRectByDivElement;
     setMainViewFocusPath(scenePath?: string): boolean | undefined;
     private resetScenePath;
     addApp(params: AddAppParams, isDynamicPPT: boolean): Promise<string | undefined>;
@@ -962,6 +983,48 @@ declare class AppManager {
     destroy(): void;
 }
 
+/**
+ * 按 `[WindowManager][tagName]` 前缀输出。
+ * 若传入 `debounceTime`（毫秒）：窗口内多次 `log` 不立即输出，只在连续停止调用满 `debounceTime` 后输出**最后一次**的参数（尾部 debounce）。
+ */
+declare class ArgusLog {
+    private readonly logger;
+    private readonly name;
+    private readonly debounceTime?;
+    private pendingArgs;
+    private flushTimer;
+    /** debounce 窗口内按一层 key 合并；同 key 后者覆盖；非普通对象则整段待输出被本次值替换 */
+    private pendingShallowMerge;
+    private shallowMergeTimer;
+    /** debounce 窗口内 safeUpdateAttributes：同 keys 数组则只更新 value，否则追加一段，flush 时拼成一条 */
+    private pendingUpdateSegments;
+    private updateMergeTimer;
+    constructor(logger: Logger, name: string, debounceTime?: number | undefined);
+    private emitInfo;
+    private flush;
+    private flushShallowMerge;
+    log(...args: unknown[]): void;
+    /**
+     * 带 debounce 时：窗口内多次调用会把「一层 key」合并进同一条日志（不同 key 并存，同 key 取最后一次）。
+     * `payload` 为普通对象时做浅合并；否则视为原子值，覆盖当前待合并状态（丢弃此前累积的对象 key）。
+     * 无 debounce 或时间为 0 时立即输出。
+     */
+    logDebouncedShallowMerge(label: string, payload: unknown): void;
+    private flushUpdateAttributesMerge;
+    /**
+     * 带 debounce 时：连续调用若 `keys` 与上一段完全相同则覆盖该段的 `value`；否则追加一段。
+     * flush 时输出一条日志，多段用 ` | ` 连接。
+     */
+    logDebouncedUpdateAttributes(keys: string[], value: unknown): void;
+    /**
+     * 销毁：清除所有 `setTimeout` debounce 定时器，并丢弃尚未输出的暂存日志（不补打日志）。
+     * WindowManager 销毁时应调用，避免泄漏与销毁后仍触发 `logger.info`。
+     */
+    destroy(): void;
+    /** 与 `destroy()` 相同，保留旧名以兼容 */
+    dispose(): void;
+}
+
 declare class AppListeners {
     private manager;
     private displayer;
@@ -1305,9 +1368,13 @@ declare class WindowManager extends InvisiblePlugin<WindowMangerAttributes, any>
     private containerResizeObserver?;
     containerSizeRatio: number;
     private extendPluginManager?;
+    private _roomLogger?;
+    attributesDeboundceLog?: ArgusLog;
+    get Logger(): Logger | undefined;
     constructor(context: InvisiblePluginContext);
     static onCreate(manager: WindowManager): void;
     static mount(params: MountParams, extendClass?: ExtendClass$1): Promise<WindowManager>;
+    onMainViewScenePathChangeHandler: (scenePath: string) => void;
     private static initManager;
     private static initContainer;
     static get registered(): Map<string, RegisterParams>;