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

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

@@ -1130,6 +1130,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 +1148,7 @@ declare class SlideDocsViewer {
     protected isViewMounted: boolean;
     protected justSildeReadonly: boolean;
     protected syncEventQueuePolicy: SyncEventQueuePolicy;
+    private readonly navigationButtonMode;
     private enableScale;
     private boxSizeEventCount;
     private latestBoxSize;
@@ -1155,7 +1157,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 +1189,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 +1301,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,6 +1331,8 @@ 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;
@@ -1364,4 +1371,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 };