@netless/window-manager 1.0.13-test.9 → 1.0.14

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, Logger, 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>;
 };
@@ -435,7 +440,6 @@ type ISize = Size & {
 declare class AttributesDelegate {
     private context;
     static readonly kind = "AttributesDelegate";
-    private setMainViewCameraConsole;
     constructor(context: StoreContext);
     setContext(context: StoreContext): void;
     get attributes(): any;
@@ -769,11 +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;
@@ -782,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;
@@ -809,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;
@@ -968,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;
@@ -1312,9 +1369,9 @@ declare class WindowManager extends InvisiblePlugin<WindowMangerAttributes, any>
     containerSizeRatio: number;
     private extendPluginManager?;
     private _roomLogger?;
+    attributesDeboundceLog?: ArgusLog;
     get Logger(): Logger | undefined;
     constructor(context: InvisiblePluginContext);
-    private visibleStateListener;
     static onCreate(manager: WindowManager): void;
     static mount(params: MountParams, extendClass?: ExtendClass$1): Promise<WindowManager>;
     onMainViewScenePathChangeHandler: (scenePath: string) => void;