@netless/app-presentation 0.1.13-beta.4 → 0.1.13

package/dist/index.d.ts

@@ -276,6 +276,7 @@ interface PresentationConfig {
     readonly pages: PresentationPage[];
     readonly readonly?: boolean;
     readonly thumbnail?: (src: string) => string;
+    readonly onThumbnailError?: (error: unknown) => void;
 }
 /**
  * Standalone presentation slide viewer.
@@ -316,6 +317,7 @@ declare class Presentation implements IDisposable<void> {
     readonly dispose: DisposableStore;
     readonly pages: PresentationPage[];
     readonly preload: Preload;
+    readonly onThumbnailError?: (error: unknown) => void;
     dom: Element | DocumentFragment;
     contentDOM: HTMLDivElement;
     previewDOM: HTMLDivElement;
@@ -429,6 +431,13 @@ declare class Scrollbar {
 }
 
 type Logger = (...data: any[]) => void;
+interface PresentationDiagnosticLogger {
+    info(event: string, payload?: unknown): void;
+    warn(event: string, payload?: unknown): void;
+    error(event: string, error: unknown, payload?: unknown): void;
+    debouncedInfo(event: string, payload?: unknown): void;
+    flush(): void;
+}
 interface PresentationAttributes {
     /** Shared logical camera reference size. New pages are proportionally contained within it. */
     originSize?: Size | null;
@@ -555,6 +564,7 @@ declare const setupBlurThumbnailDegradation: (config: {
     app: Presentation;
     dispose: ReturnType<typeof disposableStore>;
 }) => void;
+declare const createDiagnosticLogger: (context: AppContext) => PresentationDiagnosticLogger;
 declare const NetlessAppPresentation: NetlessApp<PresentationAttributes, {}, PresentationAppOptions, PresentationController> & {
     teardown(context: AppContext): void;
 };
@@ -582,5 +592,5 @@ declare const install: (register: RegisterFn, options?: InstallOptions) => Promi
 
 declare const version: string;
 
-export { NetlessAppPresentation, Presentation, Scrollbar, NetlessAppPresentation as default, install, setupBlurThumbnailDegradation, version };
+export { NetlessAppPresentation, Presentation, Scrollbar, createDiagnosticLogger, NetlessAppPresentation as default, install, setupBlurThumbnailDegradation, version };
 export type { InstallOptions, Logger, PresentationAppOptions, PresentationAttributes, PresentationConfig, PresentationController, PresentationPage, RegisterFn, ScrollbarEventCallback, ScrollbarOption };

package/dist/index.global.js

@@ -1304,6 +1304,7 @@ var NetlessAppPresentation = (function (exports) {
       var _a;
       this.pages = config.pages;
       this.preload = new Preload(this.pages);
+      this.onThumbnailError = config.onThumbnailError;
       if (config.thumbnail)
         this.thumbnail = config.thumbnail;
       this.dispose.add(this.preload);
@@ -1519,12 +1520,16 @@ var NetlessAppPresentation = (function (exports) {
     }
     /** Returns a modified URL that points to the thumbnail image. */
     thumbnail(src) {
+      var _a;
       try {
         const url = new URL(src);
         url.searchParams.set("x-oss-process", "image/resize,l_50");
         return url.toString();
       } catch (err) {
-        console.error(err);
+        try {
+          (_a = this.onThumbnailError) == null ? void 0 : _a.call(this, err);
+        } catch (e) {
+        }
         return src;
       }
     }
@@ -2119,7 +2124,8 @@ var NetlessAppPresentation = (function (exports) {
     const box = context.getBox();
     const boxBlurClass = box.wrapClassName("blur");
     let blurEpisode = false;
-    let reDegradeEnabled = false;
+    let failedThumbnailPageIndex = null;
+    const canReDegrade = () => blurEpisode && failedThumbnailPageIndex !== pageIndex$.value;
     let previewSuspended = false;
     let appliedFocusState = true;
     let logicalFocused = true;
@@ -2176,7 +2182,7 @@ var NetlessAppPresentation = (function (exports) {
         app.suspendPreviewResources();
       }
       const page = pages[pageIndex$.value];
-      if (!page || !hasUsableThumbnail(page) || reDegradeEnabled) {
+      if (!page || !hasUsableThumbnail(page) || canReDegrade()) {
         degrade();
       }
     };
@@ -2184,7 +2190,7 @@ var NetlessAppPresentation = (function (exports) {
       if (!blurEpisode)
         return;
       blurEpisode = false;
-      reDegradeEnabled = false;
+      failedThumbnailPageIndex = null;
       previewSuspended = false;
       restore2();
       app.preload.resume(pageIndex$.value);
@@ -2203,18 +2209,22 @@ var NetlessAppPresentation = (function (exports) {
       return !!(el && el.contains(target));
     };
     const onImgLoad = (ev) => {
-      if (!blurEpisode || !reDegradeEnabled)
+      if (!canReDegrade())
         return;
       if (!ownsTarget(ev.target))
         return;
       degrade();
     };
     const onImgError = (ev) => {
-      if (!blurEpisode || !reDegradeEnabled)
+      var _a;
+      if (!canReDegrade())
         return;
       if (!ownsTarget(ev.target))
         return;
-      reDegradeEnabled = false;
+      const thumbnailURL = (_a = pages[pageIndex$.value]) == null ? void 0 : _a.thumbnail;
+      if (thumbnailURL && resolveImageUrl(ev.target.src) === resolveImageUrl(thumbnailURL)) {
+        failedThumbnailPageIndex = pageIndex$.value;
+      }
     };
     const applyActivity = () => {
       var _a;
@@ -2228,7 +2238,7 @@ var NetlessAppPresentation = (function (exports) {
         restoreFocusedResources();
       } else {
         blurEpisode = true;
-        reDegradeEnabled = true;
+        failedThumbnailPageIndex = null;
         degrade();
         app.preload.pause();
         suspendCachedResources();
@@ -2275,26 +2285,21 @@ var NetlessAppPresentation = (function (exports) {
       document.removeEventListener("error", onImgError, true);
     });
   };
-  var createLogger = (room) => {
-    if (room && room.logger) {
-      return (...args) => room.logger.info(...args);
-    } else {
-      return (...args) => console.log(...args);
-    }
+  var getLogger = (context) => {
+    var _a, _b, _c;
+    return (_c = (_a = context.getWindowManager()) == null ? void 0 : _a.Logger) != null ? _c : (_b = context.getRoom()) == null ? void 0 : _b.logger;
+  };
+  var createLogger = (context) => {
+    return (...args) => {
+      var _a, _b;
+      return (_b = (_a = getLogger(context)) == null ? void 0 : _a.info) == null ? void 0 : _b.call(_a, ...args);
+    };
   };
   var createDiagnosticLogger = (context) => {
-    var _a;
-    const createAppLogger = context.createLogger;
-    if (typeof createAppLogger === "function") {
-      return createAppLogger.call(context, "camera", {
-        debounceTime: 300,
-        maxWaitTime: 2e3
-      });
-    }
-    const roomLogger = (_a = context.getRoom()) == null ? void 0 : _a.logger;
     const prefix = `[Presentation][${context.appId}][camera]`;
     const emit = (level, event, ...data) => {
       try {
+        const roomLogger = getLogger(context);
         const printer = roomLogger == null ? void 0 : roomLogger[level];
         if (typeof printer === "function")
           printer.call(roomLogger, `${prefix}[${event}]`, ...data);
@@ -2359,9 +2364,11 @@ var NetlessAppPresentation = (function (exports) {
         );
       const options = context.getAppOptions() || {};
       const room = context.getRoom();
-      const log = options.log || createLogger(room);
-      const roomLogger = room == null ? void 0 : room.logger;
-      const warn = (...data) => (roomLogger == null ? void 0 : roomLogger.warn) ? roomLogger.warn(...data) : log(...data);
+      const log = options.log || createLogger(context);
+      const warn = (...data) => {
+        var _a2, _b2;
+        return (_b2 = (_a2 = getLogger(context)) == null ? void 0 : _a2.warn) == null ? void 0 : _b2.call(_a2, ...data);
+      };
       const configuredOriginSize = context.storage.state.originSize;
       const originSize = isValidSize(configuredOriginSize) ? {
         width: configuredOriginSize.width,
@@ -2693,10 +2700,14 @@ var NetlessAppPresentation = (function (exports) {
           pageIndex$,
           view,
           options.thumbnail,
-          options.useClipView
+          options.useClipView,
+          (error) => {
+            var _a2, _b2;
+            return (_b2 = (_a2 = getLogger(context)) == null ? void 0 : _a2.error) == null ? void 0 : _b2.call(_a2, "[Presentation] thumbnail URL parsing failed", context.appId, error);
+          }
         )
       );
-      app.contentDOM.dataset.appPresentationVersion = "0.1.13-beta.4";
+      app.contentDOM.dataset.appPresentationVersion = "0.1.13";
       app.scaleDocsToFit = scaleDocsToFit;
       app.log = log;
       app.warn = warn;
@@ -3176,10 +3187,7 @@ var NetlessAppPresentation = (function (exports) {
         );
         if (disposed)
           throw new Error("[Presentation] disposed before setup ready");
-        if (result === "error" && context.waitForActualSetupReady) {
-          throw new Error("[Presentation] setup page image failed to load");
-        }
-        if (result === "error" && !disposed) {
+        if (result === "error") {
           warn("[Presentation] setup page image failed to load; continuing setup");
         }
         return controller;
@@ -3215,13 +3223,14 @@ var NetlessAppPresentation = (function (exports) {
       }
     }
   };
-  function createPresentation(box, pages, jumpPage, pageIndex$, view, thumbnail, useClipView) {
+  function createPresentation(box, pages, jumpPage, pageIndex$, view, thumbnail, useClipView, onThumbnailError) {
     box.mountStyles(style_default);
     const app = new AppPresentation({
       pages,
       readonly: box.readonly,
       jumpPage,
-      thumbnail
+      thumbnail,
+      onThumbnailError
     });
     app.box = box;
     box.mountContent(app.contentDOM);
@@ -3269,11 +3278,12 @@ var NetlessAppPresentation = (function (exports) {
   };
 
   // src/index.ts
-  var version = "0.1.13-beta.4";
+  var version = "0.1.13";
 
   exports.NetlessAppPresentation = NetlessAppPresentation;
   exports.Presentation = Presentation;
   exports.Scrollbar = Scrollbar;
+  exports.createDiagnosticLogger = createDiagnosticLogger;
   exports.default = NetlessAppPresentation;
   exports.install = install;
   exports.setupBlurThumbnailDegradation = setupBlurThumbnailDegradation;

package/dist/index.js

@@ -1305,6 +1305,7 @@ var Presentation = class {
     var _a;
     this.pages = config.pages;
     this.preload = new Preload(this.pages);
+    this.onThumbnailError = config.onThumbnailError;
     if (config.thumbnail)
       this.thumbnail = config.thumbnail;
     this.dispose.add(this.preload);
@@ -1520,12 +1521,16 @@ var Presentation = class {
   }
   /** Returns a modified URL that points to the thumbnail image. */
   thumbnail(src) {
+    var _a;
     try {
       const url = new URL(src);
       url.searchParams.set("x-oss-process", "image/resize,l_50");
       return url.toString();
     } catch (err) {
-      console.error(err);
+      try {
+        (_a = this.onThumbnailError) == null ? void 0 : _a.call(this, err);
+      } catch (e) {
+      }
       return src;
     }
   }
@@ -2120,7 +2125,8 @@ var setupBlurThumbnailDegradation = (config) => {
   const box = context.getBox();
   const boxBlurClass = box.wrapClassName("blur");
   let blurEpisode = false;
-  let reDegradeEnabled = false;
+  let failedThumbnailPageIndex = null;
+  const canReDegrade = () => blurEpisode && failedThumbnailPageIndex !== pageIndex$.value;
   let previewSuspended = false;
   let appliedFocusState = true;
   let logicalFocused = true;
@@ -2177,7 +2183,7 @@ var setupBlurThumbnailDegradation = (config) => {
       app.suspendPreviewResources();
     }
     const page = pages[pageIndex$.value];
-    if (!page || !hasUsableThumbnail(page) || reDegradeEnabled) {
+    if (!page || !hasUsableThumbnail(page) || canReDegrade()) {
       degrade();
     }
   };
@@ -2185,7 +2191,7 @@ var setupBlurThumbnailDegradation = (config) => {
     if (!blurEpisode)
       return;
     blurEpisode = false;
-    reDegradeEnabled = false;
+    failedThumbnailPageIndex = null;
     previewSuspended = false;
     restore2();
     app.preload.resume(pageIndex$.value);
@@ -2204,18 +2210,22 @@ var setupBlurThumbnailDegradation = (config) => {
     return !!(el && el.contains(target));
   };
   const onImgLoad = (ev) => {
-    if (!blurEpisode || !reDegradeEnabled)
+    if (!canReDegrade())
       return;
     if (!ownsTarget(ev.target))
       return;
     degrade();
   };
   const onImgError = (ev) => {
-    if (!blurEpisode || !reDegradeEnabled)
+    var _a;
+    if (!canReDegrade())
       return;
     if (!ownsTarget(ev.target))
       return;
-    reDegradeEnabled = false;
+    const thumbnailURL = (_a = pages[pageIndex$.value]) == null ? void 0 : _a.thumbnail;
+    if (thumbnailURL && resolveImageUrl(ev.target.src) === resolveImageUrl(thumbnailURL)) {
+      failedThumbnailPageIndex = pageIndex$.value;
+    }
   };
   const applyActivity = () => {
     var _a;
@@ -2229,7 +2239,7 @@ var setupBlurThumbnailDegradation = (config) => {
       restoreFocusedResources();
     } else {
       blurEpisode = true;
-      reDegradeEnabled = true;
+      failedThumbnailPageIndex = null;
       degrade();
       app.preload.pause();
       suspendCachedResources();
@@ -2276,26 +2286,21 @@ var setupBlurThumbnailDegradation = (config) => {
     document.removeEventListener("error", onImgError, true);
   });
 };
-var createLogger = (room) => {
-  if (room && room.logger) {
-    return (...args) => room.logger.info(...args);
-  } else {
-    return (...args) => console.log(...args);
-  }
+var getLogger = (context) => {
+  var _a, _b, _c;
+  return (_c = (_a = context.getWindowManager()) == null ? void 0 : _a.Logger) != null ? _c : (_b = context.getRoom()) == null ? void 0 : _b.logger;
+};
+var createLogger = (context) => {
+  return (...args) => {
+    var _a, _b;
+    return (_b = (_a = getLogger(context)) == null ? void 0 : _a.info) == null ? void 0 : _b.call(_a, ...args);
+  };
 };
 var createDiagnosticLogger = (context) => {
-  var _a;
-  const createAppLogger = context.createLogger;
-  if (typeof createAppLogger === "function") {
-    return createAppLogger.call(context, "camera", {
-      debounceTime: 300,
-      maxWaitTime: 2e3
-    });
-  }
-  const roomLogger = (_a = context.getRoom()) == null ? void 0 : _a.logger;
   const prefix = `[Presentation][${context.appId}][camera]`;
   const emit = (level, event, ...data) => {
     try {
+      const roomLogger = getLogger(context);
       const printer = roomLogger == null ? void 0 : roomLogger[level];
       if (typeof printer === "function")
         printer.call(roomLogger, `${prefix}[${event}]`, ...data);
@@ -2360,9 +2365,11 @@ var NetlessAppPresentation = {
       );
     const options = context.getAppOptions() || {};
     const room = context.getRoom();
-    const log = options.log || createLogger(room);
-    const roomLogger = room == null ? void 0 : room.logger;
-    const warn = (...data) => (roomLogger == null ? void 0 : roomLogger.warn) ? roomLogger.warn(...data) : log(...data);
+    const log = options.log || createLogger(context);
+    const warn = (...data) => {
+      var _a2, _b2;
+      return (_b2 = (_a2 = getLogger(context)) == null ? void 0 : _a2.warn) == null ? void 0 : _b2.call(_a2, ...data);
+    };
     const configuredOriginSize = context.storage.state.originSize;
     const originSize = isValidSize(configuredOriginSize) ? {
       width: configuredOriginSize.width,
@@ -2694,10 +2701,14 @@ var NetlessAppPresentation = {
         pageIndex$,
         view,
         options.thumbnail,
-        options.useClipView
+        options.useClipView,
+        (error) => {
+          var _a2, _b2;
+          return (_b2 = (_a2 = getLogger(context)) == null ? void 0 : _a2.error) == null ? void 0 : _b2.call(_a2, "[Presentation] thumbnail URL parsing failed", context.appId, error);
+        }
       )
     );
-    app.contentDOM.dataset.appPresentationVersion = "0.1.13-beta.4";
+    app.contentDOM.dataset.appPresentationVersion = "0.1.13";
     app.scaleDocsToFit = scaleDocsToFit;
     app.log = log;
     app.warn = warn;
@@ -3177,10 +3188,7 @@ var NetlessAppPresentation = {
       );
       if (disposed)
         throw new Error("[Presentation] disposed before setup ready");
-      if (result === "error" && context.waitForActualSetupReady) {
-        throw new Error("[Presentation] setup page image failed to load");
-      }
-      if (result === "error" && !disposed) {
+      if (result === "error") {
         warn("[Presentation] setup page image failed to load; continuing setup");
       }
       return controller;
@@ -3216,13 +3224,14 @@ var AppPresentation = class extends Presentation {
     }
   }
 };
-function createPresentation(box, pages, jumpPage, pageIndex$, view, thumbnail, useClipView) {
+function createPresentation(box, pages, jumpPage, pageIndex$, view, thumbnail, useClipView, onThumbnailError) {
   box.mountStyles(style_default);
   const app = new AppPresentation({
     pages,
     readonly: box.readonly,
     jumpPage,
-    thumbnail
+    thumbnail,
+    onThumbnailError
   });
   app.box = box;
   box.mountContent(app.contentDOM);
@@ -3270,11 +3279,12 @@ var install = (register, options = {}) => {
 };
 
 // src/index.ts
-var version = "0.1.13-beta.4";
+var version = "0.1.13";
 
 exports.NetlessAppPresentation = NetlessAppPresentation;
 exports.Presentation = Presentation;
 exports.Scrollbar = Scrollbar;
+exports.createDiagnosticLogger = createDiagnosticLogger;
 exports.default = NetlessAppPresentation;
 exports.install = install;
 exports.setupBlurThumbnailDegradation = setupBlurThumbnailDegradation;