@netless/app-slide 0.2.106-beta.1 → 0.2.106-beta.3

package/README-zh.md

@@ -72,6 +72,17 @@ manager.addApp({
 
    用于匹配课件笔记的固定白板分辨率。添加 app 时传入主白板尺寸；传入 `null` 时使用 PPT 自身分辨率。
 
+5. (可选) `navigationButtonMode`
+
+   底部左右按钮的导航模式，默认值为 `"page"`。
+
+   ```ts
+   appOptions: {
+     navigationButtonMode: "page", // 上一页/下一页
+     // navigationButtonMode: "step", // 上一步/下一步
+   }
+   ```
+
 ### 协议
 
 MIT @ [netless](https://github.com/netless-io)

package/README.md

@@ -85,6 +85,17 @@ Parameters:
 
    Fixed whiteboard resolution used to fit the slide notes. Pass the main view size when adding the app; use `null` to use the slide resolution.
 
+5. (optional) `navigationButtonMode`
+
+   Controls the footer left/right buttons. It defaults to `"page"`.
+
+   ```ts
+   appOptions: {
+     navigationButtonMode: "page", // previous/next page
+     // navigationButtonMode: "step", // previous/next animation step
+   }
+   ```
+
 ### Preview
 
 ```ts

package/dist/index.d.ts

@@ -1032,6 +1032,7 @@ declare class SlideControllerBase {
     protected syncStateOnceFlag: boolean;
     protected visible: boolean;
     protected savedIsFrozen: boolean;
+    protected focused: boolean;
     protected invisibleBehavior: "frozen" | "pause";
     previewList: string[];
     constructor(props: SlideControllerOptions);
@@ -1057,7 +1058,13 @@ declare class SlideControllerBase {
     destroy(): Promise<void>;
     timestamp: () => number;
     isFrozen: boolean;
+    private resourceStateUnknown;
+    private managedActivity;
     protected _toFreeze: -1 | 0 | 1;
+    setFocusedState: (focused: boolean) => Promise<void>;
+    private resourceTransition;
+    private shouldBeActive;
+    reconcileActivity: (force?: boolean) => Promise<void>;
     freeze: () => Promise<void>;
     unfreeze: () => Promise<void>;
     protected bindAppStateChangeEvent: () => void;
@@ -1067,6 +1074,7 @@ declare class SlideControllerBase {
         status: "normal" | "minimized" | "maximized";
     }) => void;
     protected getAppStatus: () => "normal" | "minimized" | "maximized" | undefined;
+    protected isLazySetupMode: () => boolean;
     protected onVisibilityChange: () => Promise<void>;
 }
 declare class SlideController extends SlideControllerBase {
@@ -1130,6 +1138,7 @@ interface SlideDocsViewerConfig {
     appId: string;
     urlInterrupter?: (url: string) => Promise<string>;
     enableScale?: boolean;
+    navigationButtonMode?: NavigationButtonMode;
     onPagesReady?: (pages: DocsViewerPage[]) => void;
     onNavigate?: (index: number, origin?: string) => void;
 }
@@ -1147,6 +1156,7 @@ declare class SlideDocsViewer {
     protected isViewMounted: boolean;
     protected justSildeReadonly: boolean;
     protected syncEventQueuePolicy: SyncEventQueuePolicy;
+    private readonly navigationButtonMode;
     private enableScale;
     private boxSizeEventCount;
     private latestBoxSize;
@@ -1155,7 +1165,7 @@ declare class SlideDocsViewer {
     private lastAppliedSource;
     private offBoxSizeChange;
     private contentResizeObserver;
-    constructor({ context, box, view, mountSlideController, mountWhiteboard, baseScenePath, appId, urlInterrupter, enableScale, onPagesReady, onNavigate, }: SlideDocsViewerConfig);
+    constructor({ context, box, view, mountSlideController, mountWhiteboard, baseScenePath, appId, urlInterrupter, enableScale, navigationButtonMode, onPagesReady, onNavigate, }: SlideDocsViewerConfig);
     $slide: HTMLDivElement;
     $whiteboardView: HTMLDivElement;
     $overlay: HTMLDivElement;
@@ -1187,6 +1197,8 @@ declare class SlideDocsViewer {
     protected _onPageChanged: () => void;
     protected refreshPages: () => void;
     protected getPageIndex(page: number): number;
+    protected unmountPromise?: Promise<this>;
+    protected destroyPromise?: Promise<void>;
     unmount(): Promise<this>;
     setReadonly(readonly: boolean): void;
     destroy(): Promise<void>;
@@ -1297,6 +1309,7 @@ declare class SlidePreviewer {
 declare const usePlugin: (plugin: any) => any;
 declare const version: string;
 
+type NavigationButtonMode = "page" | "step";
 interface AppOptions extends Pick<ISlideConfig, "rtcAudio" | "useLocalCache" | "resourceTimeout" | "loaderDelegate" | "urlInterrupter" | "navigatorDelegate" | "fixedFrameSize" | "logger" | "enableGlobalClick" | "skipActionWhenFrozen" | "syncEventQueuePolicy"> {
     /** show debug controller */
     debug?: boolean;
@@ -1326,12 +1339,14 @@ interface AppOptions extends Pick<ISlideConfig, "rtcAudio" | "useLocalCache" | "
     invisibleBehavior?: "frozen" | "pause";
     /** just readonly, no operate silder */
     justSildeReadonly?: true;
+    /** footer navigation button behavior @default 'page' */
+    navigationButtonMode?: NavigationButtonMode;
     enableScale?: boolean;
     resourceMaxRetries?: number;
     onResourceMaxRetries: (url: string, error: Error) => void;
     /**
-     * Max time (ms) `setup()` waits for the first `renderEnd` before resolving
-     * anyway (the slide keeps loading in background). Default: 5_000.
+     * First-render warning threshold in ms. Default: 5_000. New lazy hosts
+     * continue awaiting real readiness; legacy/eager hosts resolve on timeout.
      */
     setupReadyTimeout?: number;
 }
@@ -1364,4 +1379,4 @@ declare const SlideApp: NetlessApp<Attributes, MagixEvents, AppOptions, AppResul
 };
 
 export { DefaultUrl, DocsViewer, FreezerLength, SideEffectManager, Slide, SlideController, SlideControllerBase, SlideDocsViewer, SlidePreviewer, addHooks, apps, SlideApp as default, getFreezerLength, log, logger, onCreated, onDestroyed, previewSlide, setFreezerLength, syncSceneWithSlide, useFreezer, usePlugin, version };
-export type { AddHooks, AppOptions, AppResult, Attributes, FreezableSlide, ILogger, PreviewParams };
+export type { AddHooks, AppOptions, AppResult, Attributes, FreezableSlide, ILogger, NavigationButtonMode, PreviewParams };