@netless/window-manager 0.3.18 → 0.4.0-canary.11

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.4.0
+
+1. 废弃 `WindowManager.mount` 的多参数类型
+2. 添加 `bindContainer` 接口，`mount` 时 `container` 参数不再是必选
+
+
 ## 0.3.18
 
 1. 修复最小化时刷新页面 box 位置错误的问题

package/README.md

@@ -2,54 +2,14 @@
 
 - 目录
   - [references](docs/api.md)
+  - [从白板迁移](docs/migrate.md)
 ## MainView
 
 `MainView` 也就是主白板, 是垫在所有窗口下面的主白板
 
 因为多窗口的原因，所以抽象出来一个主白板, 并且把以前部分对 `room` 的操作, 迁移到对 `mainView` 操作
 
-### 注意事项
-
-多窗口模式必须开启白板的 `useMultiViews` 和 `useMobXState` 选项
-
-会造成原本以下 `room` 上的一些方法和 `state` 失效
-
-`方法`
-
--   `room.bindHtmlElement()` 用 `WindowManager.mount()` 代替
--   `room.scalePptToFit()` 暂无代替,不再推荐调用 `scalePptToFit`
--   `room.setScenePath()` 用 `manager.setMainViewScenePath()` 代替
--   `room.setSceneIndex()` 用 `manager.setMainViewSceneIndex()` 代替
-
-> 为了方便使用 `manager` 替换了 `room` 上的一些方法可以直接对 `mainView` 生效
-
--   `room.disableCameraTransform`
--   `room.moveCamera`
--   `room.moveCameraToContain`
--   `room.convertToPointInWorld`
--   `room.setCameraBound`
-
-`camera`
-
--   `room.state.cameraState` 用 `manager.mainView.camera` 和 `manager.mainView.size` 代替
-
-想要监听主白板 `camera` 的变化, 请使用如下方式代替
-
-```javascript
-manager.mainView.callbacks.on("onCameraUpdated", camera => {
-    console.log(camera);
-});
-```
-
-监听主白板 `size` 变化
-
-```javascript
-manager.mainView.callbacks.on("onSizeUpdated", size => {
-    console.log(size);
-});
-```
-
-### 接入
+### 快速开始
 
 ```javascript
 import { WhiteWebSdk } from "white-web-sdk";
@@ -58,7 +18,7 @@ import "@netless/window-manager/dist/style.css";
 
 const sdk = new WhiteWebSdk({
     appIdentifier: "appIdentifier",
-    useMobXState: true
+    useMobXState: true // 请确保打开这个选项
 });
 
 sdk.joinRoom({
@@ -66,6 +26,7 @@ sdk.joinRoom({
     roomToken: "room token",
     invisiblePlugins: [WindowManager],
     useMultiViews: true, // 多窗口必须用开启 useMultiViews
+    disableMagixEventDispatchLimit: true, // 请确保打开这个选项
 }).then(async room => {
     const manager = await WindowManager.mount(
         room,

package/dist/App/MagixEvent/index.d.ts

@@ -0,0 +1,28 @@
+import type { MagixEventListenerOptions as WhiteMagixListenerOptions, Event as WhiteEvent, EventPhase as WhiteEventPhase, Scope as WhiteScope } from "white-web-sdk";
+export interface MagixEventListenerOptions extends WhiteMagixListenerOptions {
+    /**
+     * Rapid emitted callbacks will be slowed down to this interval (in ms).
+     */
+    fireInterval?: number;
+    /**
+     * If `true`, sent events will reach self-listeners after committed to server.
+     * Otherwise the events will reach self-listeners immediately.
+     */
+    fireSelfEventAfterCommit?: boolean;
+}
+export interface MagixEventMessage<TPayloads = any, TEvent extends MagixEventTypes<TPayloads> = MagixEventTypes<TPayloads>> extends Omit<WhiteEvent, "scope" | "phase"> {
+    /** Event name */
+    event: TEvent;
+    /** Event Payload */
+    payload: TPayloads[TEvent];
+    /** Whiteboard ID of the client who dispatched the event. It will be AdminObserverId for system events. */
+    authorId: number;
+    scope: `${WhiteScope}`;
+    phase: `${WhiteEventPhase}`;
+}
+export declare type MagixEventTypes<TPayloads = any> = Extract<keyof TPayloads, string>;
+export declare type MagixEventPayload<TPayloads = any, TEvent extends MagixEventTypes<TPayloads> = MagixEventTypes<TPayloads>> = TPayloads[TEvent];
+export declare type MagixEventDispatcher<TPayloads = any> = <TEvent extends MagixEventTypes<TPayloads> = MagixEventTypes<TPayloads>>(event: TEvent, payload: TPayloads[TEvent]) => void;
+export declare type MagixEventHandler<TPayloads = any, TEvent extends MagixEventTypes<TPayloads> = MagixEventTypes<TPayloads>> = (message: MagixEventMessage<TPayloads, TEvent>) => void;
+export declare type MagixEventAddListener<TPayloads = any> = <TEvent extends MagixEventTypes<TPayloads> = MagixEventTypes<TPayloads>>(event: TEvent, handler: MagixEventHandler<TPayloads, TEvent>, options?: MagixEventListenerOptions | undefined) => void;
+export declare type MagixEventRemoveListener<TPayloads = any> = <TEvent extends MagixEventTypes<TPayloads> = MagixEventTypes<TPayloads>>(event: TEvent, handler?: MagixEventHandler<TPayloads, TEvent>) => void;

package/dist/App/Storage/StorageEvent.d.ts

@@ -0,0 +1,8 @@
+export declare type StorageEventListener<T> = (event: T) => void;
+export declare class StorageEvent<TMessage> {
+    listeners: Set<StorageEventListener<TMessage>>;
+    get length(): number;
+    dispatch(message: TMessage): void;
+    addListener(listener: StorageEventListener<TMessage>): void;
+    removeListener(listener: StorageEventListener<TMessage>): void;
+}

package/dist/App/Storage/index.d.ts

@@ -0,0 +1,38 @@
+import type { AppContext } from "../../AppContext";
+import type { Diff } from "./typings";
+import { StorageEvent } from "./StorageEvent";
+export * from './typings';
+export declare const STORAGE_NS = "_WM-STORAGE_";
+export declare class Storage<TState extends Record<string, any> = any> implements Storage<TState> {
+    readonly id: string | null;
+    private readonly _context;
+    private readonly _sideEffect;
+    private _state;
+    private _destroyed;
+    private _refMap;
+    /**
+     * `setState` alters local state immediately before sending to server. This will cache the old value for onStateChanged diffing.
+     */
+    private _lastValue;
+    constructor(context: AppContext, id?: string, defaultState?: TState);
+    get state(): Readonly<TState>;
+    readonly onStateChanged: StorageEvent<Diff<TState>>;
+    ensureState(state: Partial<TState>): void;
+    setState(state: Partial<TState>): void;
+    /**
+     * Empty storage data.
+     */
+    emptyStorage(): void;
+    /**
+     * Delete storage index with all of its data and destroy the Storage instance.
+     */
+    deleteStorage(): void;
+    get destroyed(): boolean;
+    /**
+     * Destroy the Storage instance. The data will be kept.
+     */
+    destroy(): void;
+    private _getRawState;
+    private _setRawState;
+    private _updateProperties;
+}

package/dist/App/Storage/typings.d.ts

@@ -0,0 +1,21 @@
+import type { StorageEventListener } from "./StorageEvent";
+export declare type RefValue<TValue = any> = {
+    k: string;
+    v: TValue;
+    __isRef: true;
+};
+export declare type ExtractRawValue<TValue> = TValue extends RefValue<infer TRefValue> ? TRefValue : TValue;
+export declare type AutoRefValue<TValue> = RefValue<ExtractRawValue<TValue>>;
+export declare type MaybeRefValue<TValue> = TValue | AutoRefValue<TValue>;
+export declare type DiffOne<T> = {
+    oldValue?: T;
+    newValue?: T;
+};
+export declare type Diff<T> = {
+    [K in keyof T]?: DiffOne<T[K]>;
+};
+export declare type StorageOnSetStatePayload<TState = unknown> = {
+    [K in keyof TState]?: MaybeRefValue<TState[K]>;
+};
+export declare type StorageStateChangedEvent<TState = any> = Diff<TState>;
+export declare type StorageStateChangedListener<TState = any> = StorageEventListener<StorageStateChangedEvent<TState>>;

package/dist/App/Storage/utils.d.ts

@@ -0,0 +1,5 @@
+import type { AutoRefValue, RefValue } from "./typings";
+export declare const plainObjectKeys: <T>(o: T) => Extract<keyof T, string>[];
+export declare function isRef<TValue = unknown>(e: unknown): e is RefValue<TValue>;
+export declare function makeRef<TValue>(v: TValue): RefValue<TValue>;
+export declare function makeAutoRef<TValue>(v: TValue): AutoRefValue<TValue>;

package/dist/AppContext.d.ts

@@ -2,15 +2,19 @@ import { autorun, listenDisposed, listenUpdated, reaction, unlistenDisposed, unl
 import type { Room, SceneDefinition, View } from "white-web-sdk";
 import type { ReadonlyTeleBox } from "@netless/telebox-insider";
 import type Emittery from "emittery";
+import type { BoxManager } from "./BoxManager";
 import type { AppEmitterEvent } from "./index";
 import type { AppManager } from "./AppManager";
 import type { AppProxy } from "./AppProxy";
-export declare class AppContext<TAttrs extends Record<string, any>, AppOptions = any> {
+import { Storage } from './App/Storage';
+import type { MagixEventAddListener, MagixEventDispatcher, MagixEventRemoveListener } from './App/MagixEvent';
+export declare class AppContext<TAttributes = any, TMagixEventPayloads = any, TAppOptions = any> {
     private manager;
+    private boxManager;
     appId: string;
     private appProxy;
     private appOptions?;
-    readonly emitter: Emittery<AppEmitterEvent<TAttrs>>;
+    readonly emitter: Emittery<AppEmitterEvent<TAttributes>>;
     readonly mobxUtils: {
         autorun: typeof autorun;
         reaction: typeof reaction;
@@ -22,22 +26,43 @@ export declare class AppContext<TAttrs extends Record<string, any>, AppOptions =
         listenDisposed: typeof listenDisposed;
         unlistenDisposed: typeof unlistenDisposed;
     };
-    private boxManager;
     private store;
     readonly isAddApp: boolean;
     readonly isReplay: boolean;
-    constructor(manager: AppManager, appId: string, appProxy: AppProxy, appOptions?: AppOptions | (() => AppOptions) | undefined);
-    getDisplayer(): import("white-web-sdk").Displayer<import("white-web-sdk").DisplayerCallbacks>;
-    getAttributes(): TAttrs | undefined;
-    getScenes(): SceneDefinition[] | undefined;
-    getView(): View | undefined;
-    getInitScenePath(): string | undefined;
-    getIsWritable(): boolean;
-    getBox(): ReadonlyTeleBox;
-    getRoom(): Room | undefined;
-    setAttributes(attributes: TAttrs): void;
-    updateAttributes(keys: string[], value: any): void;
-    setScenePath(scenePath: string): Promise<void>;
-    mountView(dom: HTMLDivElement): void;
-    getAppOptions(): AppOptions | undefined;
+    constructor(manager: AppManager, boxManager: BoxManager, appId: string, appProxy: AppProxy, appOptions?: TAppOptions | (() => TAppOptions) | undefined);
+    getDisplayer: () => import("white-web-sdk").Displayer<import("white-web-sdk").DisplayerCallbacks>;
+    /** @deprecated Use context.storage.state instead. */
+    getAttributes: () => TAttributes | undefined;
+    getScenes: () => SceneDefinition[] | undefined;
+    getView: () => View | undefined;
+    getInitScenePath: () => string | undefined;
+    /** Get App writable status. */
+    getIsWritable: () => boolean;
+    /** Get the App Window UI box. */
+    getBox: () => ReadonlyTeleBox;
+    getRoom: () => Room | undefined;
+    /** @deprecated Use context.storage.setState instead. */
+    setAttributes: (attributes: TAttributes) => void;
+    /** @deprecated Use context.storage.setState instead. */
+    updateAttributes: (keys: string[], value: any) => void;
+    setScenePath: (scenePath: string) => Promise<void>;
+    mountView: (dom: HTMLDivElement) => void;
+    /** Get the local App options. */
+    getAppOptions: () => TAppOptions | undefined;
+    private _storage?;
+    /** Main Storage for attributes. */
+    get storage(): Storage<TAttributes>;
+    /**
+     * Create separated storages for flexible state management.
+     * @param storeId Namespace for the storage. Storages of the same namespace share the same data.
+     * @param defaultState Default state for initial storage creation.
+     * @returns
+     */
+    createStorage: <TState>(storeId: string, defaultState?: TState | undefined) => Storage<TState>;
+    /** Dispatch events to other clients (and self). */
+    dispatchMagixEvent: MagixEventDispatcher<TMagixEventPayloads>;
+    /** Listen to events from others clients (and self messages). */
+    addMagixEventListener: MagixEventAddListener<TMagixEventPayloads>;
+    /** Remove a Magix event listener. */
+    removeMagixEventListener: MagixEventRemoveListener<TMagixEventPayloads>;
 }

package/dist/AppListener.d.ts

@@ -2,14 +2,14 @@ import type { AppManager } from "./AppManager";
 export declare class AppListeners {
     private manager;
     private displayer;
-    private boxManager;
     constructor(manager: AppManager);
+    private get boxManager();
     addListeners(): void;
     removeListeners(): void;
     private mainMagixEventListener;
     private appMoveHandler;
     private appResizeHandler;
-    private switchViewsToFreedomHandler;
     private boxStateChangeHandler;
     private setMainViewScenePathHandler;
+    private moveCameraToContainHandler;
 }

package/dist/AppManager.d.ts

@@ -1,28 +1,27 @@
 import { AppStatus, Events } from "./constants";
 import { AppProxy } from "./AppProxy";
-import { AttributesDelegate } from "./AttributesDelegate";
-import { BoxManager } from "./BoxManager";
-import { CameraStore } from "./Utils/CameraStore";
-import { MainViewProxy } from "./MainView";
-import { ReconnectRefresher } from "./ReconnectRefresher";
-import { ViewManager } from "./ViewManager";
+import { WindowManager } from "./index";
+import { MainViewProxy } from "./View/MainView";
+import { ViewManager } from "./View/ViewManager";
+import type { ReconnectRefresher } from "./ReconnectRefresher";
+import type { BoxManager } from "./BoxManager";
 import type { Displayer, Room } from "white-web-sdk";
-import type { CreateTeleBoxManagerConfig } from "./BoxManager";
-import type { AddAppParams, WindowManager, TeleBoxRect } from "./index";
+import type { AddAppParams, TeleBoxRect } from "./index";
 export declare class AppManager {
     windowManger: WindowManager;
     displayer: Displayer;
-    boxManager: BoxManager;
-    cameraStore: CameraStore;
     viewManager: ViewManager;
     appProxies: Map<string, AppProxy>;
     appStatus: Map<string, AppStatus>;
-    store: AttributesDelegate;
+    store: import("./AttributesDelegate").AttributesDelegate;
     mainViewProxy: MainViewProxy;
     refresher?: ReconnectRefresher;
     isReplay: boolean;
     private appListeners;
-    constructor(windowManger: WindowManager, options: CreateTeleBoxManagerConfig);
+    boxManager?: BoxManager;
+    private _prevSceneIndex;
+    private _prevFocused;
+    constructor(windowManger: WindowManager);
     private onCreated;
     /**
      * 插件更新 attributes 时的回调
@@ -31,15 +30,20 @@ export declare class AppManager {
      * @memberof WindowManager
      */
     attributesUpdateCallback(apps: any): Promise<void>;
+    refresh(): void;
+    setBoxManager(boxManager: BoxManager): void;
+    resetMaximized(): void;
+    resetMinimized(): void;
     private onAppDelete;
     bindMainView(divElement: HTMLDivElement, disableCameraTransform: boolean): void;
+    setMainViewFocusPath(): void;
     addApp(params: AddAppParams, isDynamicPPT: boolean): Promise<string | undefined>;
     private beforeAddApp;
     private afterAddApp;
     closeApp(appId: string): Promise<void>;
     private baseInsertApp;
     private displayerStateListener;
-    private displayerWritableListener;
+    displayerWritableListener: (isReadonly: boolean) => void;
     private get eventName();
     get attributes(): import("./index").WindowMangerAttributes;
     get canOperate(): boolean;
@@ -55,7 +59,7 @@ export declare class AppManager {
     safeDispatchMagixEvent(event: string, payload: any): void;
     private boxEventListener;
     focusByAttributes(apps: any): void;
-    notifyReconnected(): Promise<void>;
+    onReconnected(): Promise<void>;
     notifyContainerRectUpdate(rect: TeleBoxRect): void;
     dispatchInternalEvent(event: Events, payload: any): void;
     destroy(): void;

package/dist/AppProxy.d.ts

@@ -15,10 +15,12 @@ export declare class AppProxy extends Base {
     private boxManager;
     private appProxies;
     private viewManager;
-    private cameraStore;
     private kind;
     isAddApp: boolean;
     private status;
+    private stateKey;
+    private appResult?;
+    private appContext?;
     constructor(params: BaseInsertParams, manager: AppManager, appId: string, isAddApp: boolean);
     private initScenes;
     get view(): View | undefined;
@@ -26,8 +28,9 @@ export declare class AppProxy extends Base {
     get attributes(): any;
     get appAttributes(): import("./index").AppSyncAttributes;
     getFullScenePath(): string | undefined;
+    private getFullScenePathFromScenes;
     setFullPath(path: string): void;
-    baseInsertApp(skipUpdate?: boolean, focus?: boolean): Promise<{
+    baseInsertApp(skipUpdate?: boolean): Promise<{
         appId: string;
         app: NetlessApp;
     }>;
@@ -39,7 +42,6 @@ export declare class AppProxy extends Base {
     private afterSetupApp;
     onSeek(time: number): void;
     onReconnected(): Promise<void>;
-    switchToWritable(): void;
     getAppInitState: (id: string) => AppInitState | undefined;
     emitAppSceneStateChange(sceneState: SceneState): void;
     emitAppIsWritableChange(): void;

package/dist/AttributesDelegate.d.ts

@@ -1,7 +1,6 @@
 import { AppAttributes } from "./constants";
 import type { AddAppParams, AppSyncAttributes } from "./index";
-import type { Camera, Size } from "white-web-sdk";
-import type { AppManager } from "./AppManager";
+import type { Camera, Size, View } from "white-web-sdk";
 import type { Cursor } from "./Cursor/Cursor";
 export declare enum Fields {
     Apps = "apps",
@@ -26,14 +25,22 @@ export declare type Position = {
     id?: string;
 };
 export declare type PositionType = "main" | "app";
+export declare type StoreContext = {
+    getAttributes: () => any;
+    safeUpdateAttributes: (keys: string[], value: any) => void;
+    safeSetAttributes: (attributes: any) => void;
+};
 export declare class AttributesDelegate {
-    private manager;
-    constructor(manager: AppManager);
+    private context;
+    constructor(context: StoreContext);
+    setContext(context: StoreContext): void;
+    get attributes(): any;
     apps(): Apps;
     get focus(): string | undefined;
     getAppAttributes(id: string): AppSyncAttributes;
     getAppState(id: string): any;
-    getMaximized(): boolean | undefined;
+    getMaximized(): any;
+    getMinimized(): any;
     setupAppAttributes(params: AddAppParams, id: string, isDynamicPPT: boolean): void;
     updateAppState(appId: string, stateName: AppAttributes, state: any): void;
     cleanAppAttributes(id: string): void;
@@ -42,23 +49,23 @@ export declare class AttributesDelegate {
     getAppScenePath(id: string): any;
     getMainViewScenePath(): any;
     getMainViewSceneIndex(): any;
-    getBoxState(): import("@netless/telebox-insider").TELE_BOX_STATE;
+    getBoxState(): any;
     setMainViewScenePath(scenePath: string): void;
     setMainViewSceneIndex(index: number): void;
     getMainViewCamera(): MainViewCamera;
     getMainViewSize(): MainViewSize;
-    setMainViewCamera(camera: Camera & {
+    setMainViewCamera(camera: (Camera & {
         id: string;
-    } | undefined): void;
-    setMainViewSize(size: Size & {
+    }) | undefined): void;
+    setMainViewSize(size: (Size & {
         id: string;
-    } | undefined): void;
+    }) | undefined): void;
     setAppFocus(appId: string, focus: boolean): void;
     updateCursor(uid: string, position: Position): void;
     updateCursorState(uid: string, cursorState: string | undefined): void;
     getCursorState(uid: string): any;
     cleanCursor(uid: string): void;
-    setMainViewFocusPath(): void;
+    setMainViewFocusPath(mainView: View): void;
 }
 export declare type MainViewSize = {
     id: string;
@@ -74,3 +81,4 @@ export declare type MainViewCamera = {
 export declare type Cursors = {
     [key: string]: Cursor;
 };
+export declare const store: AttributesDelegate;

package/dist/Base/Context.d.ts

@@ -8,6 +8,5 @@ export declare class Context {
     findMemberByUid: (uid: string) => import("white-web-sdk").RoomMember | undefined;
     updateManagerRect(): void;
     blurFocusBox(): void;
-    switchAppToWriter(id: string): void;
 }
 export declare const createContext: (manager: AppManager) => Context;

package/dist/Base/index.d.ts

@@ -1,8 +1,7 @@
 import type { AppManager } from "../AppManager";
-import { AttributesDelegate } from "../AttributesDelegate";
 export declare class Base {
     manager: AppManager;
-    store: AttributesDelegate;
+    store: import("../AttributesDelegate").AttributesDelegate;
     context: import("./Context").Context;
     constructor(manager: AppManager);
 }

package/dist/BoxManager.d.ts

@@ -1,8 +1,9 @@
+import { AppAttributes } from "./constants";
 import { TELE_BOX_STATE, TeleBoxManager } from "@netless/telebox-insider";
-import type { AddAppOptions, AppInitState } from "./index";
-import type { TeleBoxManagerUpdateConfig, ReadonlyTeleBox, TeleBoxColorScheme } from "@netless/telebox-insider";
+import { WindowManager } from "./index";
+import type { AddAppOptions, AppInitState, EmitterType, CallbacksType } from "./index";
+import type { TeleBoxManagerUpdateConfig, ReadonlyTeleBox, TeleBoxColorScheme, TeleBoxRect } from "@netless/telebox-insider";
 import type Emittery from "emittery";
-import type { AppManager } from "./AppManager";
 import type { NetlessApp } from "./typings";
 import type { View } from "white-web-sdk";
 export { TELE_BOX_STATE };
@@ -39,20 +40,35 @@ export declare type CreateTeleBoxManagerConfig = {
     collectorStyles?: Partial<CSSStyleDeclaration>;
     prefersColorScheme?: TeleBoxColorScheme;
 };
+export declare type BoxManagerContext = {
+    safeSetAttributes: (attributes: any) => void;
+    getMainView: () => View;
+    updateAppState: (appId: string, field: AppAttributes, value: any) => void;
+    emitter: EmitterType;
+    callbacks: CallbacksType;
+    canOperate: () => boolean;
+    notifyContainerRectUpdate: (rect: TeleBoxRect) => void;
+    cleanFocus: () => void;
+};
+export declare const createBoxManager: (manager: WindowManager, callbacks: CallbacksType, emitter: EmitterType, options: CreateTeleBoxManagerConfig) => BoxManager;
 export declare class BoxManager {
-    private manager;
+    private context;
+    private createTeleBoxManagerConfig?;
     teleBoxManager: TeleBoxManager;
-    appBoxMap: Map<string, string>;
-    private mainView;
-    constructor(manager: AppManager, createTeleBoxManagerConfig?: CreateTeleBoxManagerConfig);
+    constructor(context: BoxManagerContext, createTeleBoxManagerConfig?: CreateTeleBoxManagerConfig | undefined);
+    private playgroundSizeChangeListener;
+    private get mainView();
+    private get canOperate();
     get boxState(): "normal" | "minimized" | "maximized";
     get maximized(): boolean;
     get minimized(): boolean;
     get darkMode(): boolean;
     get prefersColorScheme(): TeleBoxColorScheme;
+    get boxSize(): number;
     createBox(params: CreateBoxParams): void;
     setBoxInitState(appId: string): void;
     setupBoxManager(createTeleBoxManagerConfig?: CreateTeleBoxManagerConfig): TeleBoxManager;
+    setCollectorContainer(container: HTMLElement): void;
     getBox(appId: string): ReadonlyTeleBox | undefined;
     closeBox(appId: string, skipUpdate?: boolean): ReadonlyTeleBox | undefined;
     boxIsFocus(appId: string): boolean | undefined;
@@ -72,5 +88,6 @@ export declare class BoxManager {
     focusTopBox(): void;
     setReadonly(readonly: boolean): void;
     setPrefersColorScheme(colorScheme: TeleBoxColorScheme): void;
+    setZIndex(id: string, zIndex: number, skipUpdate?: boolean): void;
     destroy(): void;
 }

package/dist/BuiltinApps.d.ts

@@ -0,0 +1,6 @@
+import "@netless/app-docs-viewer/dist/style.css";
+export declare const setupBuiltin: () => void;
+export declare const BuiltinApps: {
+    DocsViewer: string;
+    MediaPlayer: string;
+};

package/dist/ContainerResizeObserver.d.ts

@@ -0,0 +1,10 @@
+import type { EmitterType } from "./index";
+export declare class ContainerResizeObserver {
+    private emitter;
+    private containerResizeObserver?;
+    constructor(emitter: EmitterType);
+    static create(container: HTMLElement, sizer: HTMLElement, wrapper: HTMLDivElement, emitter: EmitterType): ContainerResizeObserver;
+    observePlaygroundSize(container: HTMLElement, sizer: HTMLElement, wrapper: HTMLDivElement): void;
+    private updateSizer;
+    disconnect(): void;
+}

package/dist/Cursor/Cursor.d.ts

@@ -13,11 +13,10 @@ export declare class Cursor extends Base {
     private cursorManager;
     private wrapper?;
     private member?;
-    private disposer;
     private timer?;
     private component?;
-    constructor(manager: AppManager, cursors: any, memberId: string, cursorManager: CursorManager, wrapper?: HTMLElement | undefined);
-    private startReaction;
+    constructor(manager: AppManager, addCursorChangeListener: (uid: string, callback: (position: Position, state: CursorState) => void) => void, cursors: any, memberId: string, cursorManager: CursorManager, wrapper?: HTMLElement | undefined);
+    private onCursorChange;
     private moveCursor;
     get memberApplianceName(): ApplianceNames | undefined;
     get memberColor(): string;

package/dist/Cursor/index.d.ts

@@ -1,6 +1,7 @@
-import { Base } from '../Base';
-import { Cursor } from './Cursor';
-import type { PositionType } from "../AttributesDelegate";
+import { Base } from "../Base";
+import { Cursor } from "./Cursor";
+import { CursorState } from "../constants";
+import type { PositionType, Position } from "../AttributesDelegate";
 import type { RoomMember, View } from "white-web-sdk";
 import type { AppManager } from "../AppManager";
 export declare type EventType = {
@@ -19,16 +20,17 @@ export declare class CursorManager extends Base {
     cursorInstances: Map<string, Cursor>;
     roomMembers?: readonly RoomMember[];
     private mainViewElement?;
+    private sideEffectManager;
     constructor(appManager: AppManager);
+    setupWrapper(wrapper: HTMLElement): void;
     setMainViewDivElement(div: HTMLDivElement): void;
     private startReaction;
     private getUids;
     private handleRoomMembersChange;
     get cursors(): any;
-    get boxState(): import("@netless/telebox-insider").TELE_BOX_STATE;
+    get boxState(): any;
     get focusView(): View | undefined;
     private mouseMoveListener;
-    private touchMoveListener;
     private updateCursor;
     private getPoint;
     /**
@@ -43,5 +45,7 @@ export declare class CursorManager extends Base {
     deleteCursor(uid: string): void;
     hideCursor(uid: string): void;
     cleanMemberAttributes(members: readonly RoomMember[]): void;
+    onReconnect(): void;
+    addCursorChangeListener: (uid: string, callback: (position: Position, state: CursorState) => void) => void;
     destroy(): void;
 }

package/dist/Helper.d.ts

@@ -0,0 +1,6 @@
+export declare const setupWrapper: (root: HTMLElement) => {
+    playground: HTMLDivElement;
+    wrapper: HTMLDivElement;
+    sizer: HTMLDivElement;
+    mainViewElement: HTMLDivElement;
+};

package/dist/ReconnectRefresher.d.ts

@@ -1,16 +1,22 @@
 import type { Room } from "white-web-sdk";
-import type { AppManager } from './AppManager';
+import type { EmitterType } from "./index";
+export declare type ReconnectRefresherContext = {
+    emitter: EmitterType;
+};
 export declare class ReconnectRefresher {
-    private manager;
+    private ctx;
     private phase?;
     private room;
     private reactors;
     private disposers;
-    constructor(room: Room | undefined, manager: AppManager);
+    constructor(ctx: ReconnectRefresherContext);
+    setRoom(room: Room | undefined): void;
+    setContext(ctx: ReconnectRefresherContext): void;
     private onPhaseChanged;
     private onReconnected;
     private releaseDisposers;
     add(id: string, func: any): void;
     remove(id: string): void;
+    hasReactor(id: string): boolean;
     destroy(): void;
 }