@netless/app-presentation 0.1.13-beta.3 → 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;
@@ -472,8 +481,8 @@ interface PresentationAppOptions {
     /** useClipView is used to set the presentation use clip view, it will be used in the presentation, and the presentation will be use clip view when the app is initialized */
     useClipView?: boolean;
     /**
-     * Max time (ms) `setup()` waits for the first visible page image to load
-     * before resolving anyway. Default: 5_000.
+     * First-image warning threshold in ms. Default: 5_000. New lazy hosts
+     * await real readiness; legacy/eager hosts resolve on timeout.
      */
     setupReadyTimeout?: number;
     /**
@@ -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;
       }
     }
@@ -2016,9 +2021,10 @@ var NetlessAppPresentation = (function (exports) {
   };
 
   // src/setup-ready.ts
-  var waitForCurrentPageImage = (getImage, timeoutMs, isDisposed) => {
+  var waitForCurrentPageImage = (getImage, timeoutMs, isDisposed, options) => {
     return new Promise((resolve) => {
       let settled = false;
+      let timedOut = false;
       let pollTimer;
       const settle = (result) => {
         if (settled)
@@ -2029,13 +2035,22 @@ var NetlessAppPresentation = (function (exports) {
           window.clearInterval(pollTimer);
         resolve(result);
       };
-      const timeoutTimer = window.setTimeout(() => settle("timeout"), timeoutMs);
+      const timeoutTimer = window.setTimeout(() => {
+        timedOut = true;
+        options == null ? void 0 : options.onTimeout();
+        if (!(options == null ? void 0 : options.waitForReady()))
+          settle("timeout");
+      }, timeoutMs);
       const check = () => {
         var _a, _b;
         if (isDisposed()) {
           settle("disposed");
           return;
         }
+        if (timedOut && !(options == null ? void 0 : options.waitForReady())) {
+          settle("timeout");
+          return;
+        }
         const img = getImage();
         if (img == null ? void 0 : img.complete) {
           if (img.naturalWidth > 0) {
@@ -2109,7 +2124,21 @@ 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;
+    const activityBlocked = () => {
+      var _a, _b;
+      const wm = context.getWindowManager();
+      if ((wm == null ? void 0 : wm.lazySetupInMaximizedMode) !== true)
+        return false;
+      const host = (_a = context.getRuntimeActivity) == null ? void 0 : _a.call(context);
+      if (host)
+        return document.visibilityState === "hidden" || !host.active;
+      return document.visibilityState === "hidden" || wm.boxState === "minimized" || ((_b = wm.attributes) == null ? void 0 : _b.minimized) === true || context.getBoxStatus() === "minimized";
+    };
     let boxBlurred = box.$box.classList.contains(boxBlurClass);
     const setBackgroundSuspended = (suspended) => {
       app.whiteboardDOM.classList.toggle(
@@ -2124,7 +2153,7 @@ var NetlessAppPresentation = (function (exports) {
       const thumbnailURL = page.thumbnail;
       const img = findBackgroundImage(view);
       if (!thumbnailURL || !hasUsableThumbnail(page)) {
-        if (boxBlurred) {
+        if (boxBlurred || activityBlocked()) {
           setBackgroundSuspended(true);
           if (img && resolveImageUrl(img.src) !== resolveImageUrl(TRANSPARENT_BACKGROUND)) {
             img.src = TRANSPARENT_BACKGROUND;
@@ -2146,11 +2175,14 @@ var NetlessAppPresentation = (function (exports) {
       setBackgroundSuspended(false);
     };
     const suspendCachedResources = () => {
-      if (!blurEpisode || !boxBlurred)
+      if (!blurEpisode || !boxBlurred && !activityBlocked())
         return;
-      app.suspendPreviewResources();
+      if (!previewSuspended) {
+        previewSuspended = true;
+        app.suspendPreviewResources();
+      }
       const page = pages[pageIndex$.value];
-      if (!page || !hasUsableThumbnail(page) || reDegradeEnabled) {
+      if (!page || !hasUsableThumbnail(page) || canReDegrade()) {
         degrade();
       }
     };
@@ -2158,7 +2190,8 @@ var NetlessAppPresentation = (function (exports) {
       if (!blurEpisode)
         return;
       blurEpisode = false;
-      reDegradeEnabled = false;
+      failedThumbnailPageIndex = null;
+      previewSuspended = false;
       restore2();
       app.preload.resume(pageIndex$.value);
     };
@@ -2176,40 +2209,57 @@ 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 offFocus = context.emitter.on("focus", (isFocused) => {
+    const applyActivity = () => {
+      var _a;
+      const lazy = ((_a = context.getWindowManager()) == null ? void 0 : _a.lazySetupInMaximizedMode) === true;
+      const isFocused = (!lazy || logicalFocused) && !activityBlocked();
+      if (appliedFocusState === isFocused)
+        return;
+      if (!isFocused && !isBlurDegradationAllowed(context) && !activityBlocked())
+        return;
       if (isFocused) {
         restoreFocusedResources();
       } else {
-        if (!isBlurDegradationAllowed(context))
-          return;
         blurEpisode = true;
-        reDegradeEnabled = true;
+        failedThumbnailPageIndex = null;
         degrade();
         app.preload.pause();
         suspendCachedResources();
       }
+      appliedFocusState = isFocused;
+    };
+    const offFocus = context.emitter.on("focus", (isFocused) => {
+      logicalFocused = isFocused;
+      applyActivity();
     });
     dispose2.add(offFocus);
+    dispose2.add(context.emitter.on("runtimeActivity", applyActivity));
+    document.addEventListener("visibilitychange", applyActivity);
+    dispose2.add(() => document.removeEventListener("visibilitychange", applyActivity));
     const updateBoxBlurred = (blurred) => {
       if (boxBlurred === blurred)
         return;
       boxBlurred = blurred;
       if (blurred)
         suspendCachedResources();
-      else
+      else if (logicalFocused && !activityBlocked())
         restoreFocusedResources();
     };
     const onBoxBlur = () => updateBoxBlurred(true);
@@ -2235,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);
@@ -2319,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,
@@ -2653,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.3";
+      app.contentDOM.dataset.appPresentationVersion = "0.1.13";
       app.scaleDocsToFit = scaleDocsToFit;
       app.log = log;
       app.warn = warn;
@@ -3128,11 +3179,15 @@ var NetlessAppPresentation = (function (exports) {
         const result = await waitForCurrentPageImage(
           () => findBackgroundImage(view),
           setupReadyTimeout,
-          () => disposed
+          () => disposed,
+          {
+            waitForReady: () => Boolean(context.waitForActualSetupReady),
+            onTimeout: () => warn(`[Presentation] setup page image still pending after ${setupReadyTimeout}ms`)
+          }
         );
-        if (result === "timeout" && !disposed) {
-          warn(`[Presentation] setup ready wait timed out after ${setupReadyTimeout}ms`);
-        } else if (result === "error" && !disposed) {
+        if (disposed)
+          throw new Error("[Presentation] disposed before setup ready");
+        if (result === "error") {
           warn("[Presentation] setup page image failed to load; continuing setup");
         }
         return controller;
@@ -3168,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);
@@ -3222,11 +3278,12 @@ var NetlessAppPresentation = (function (exports) {
   };
 
   // src/index.ts
-  var version = "0.1.13-beta.3";
+  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;
     }
   }
@@ -2017,9 +2022,10 @@ var createPresentationRuntimeTeardown = (box, dispose2) => {
 };
 
 // src/setup-ready.ts
-var waitForCurrentPageImage = (getImage, timeoutMs, isDisposed) => {
+var waitForCurrentPageImage = (getImage, timeoutMs, isDisposed, options) => {
   return new Promise((resolve) => {
     let settled = false;
+    let timedOut = false;
     let pollTimer;
     const settle = (result) => {
       if (settled)
@@ -2030,13 +2036,22 @@ var waitForCurrentPageImage = (getImage, timeoutMs, isDisposed) => {
         window.clearInterval(pollTimer);
       resolve(result);
     };
-    const timeoutTimer = window.setTimeout(() => settle("timeout"), timeoutMs);
+    const timeoutTimer = window.setTimeout(() => {
+      timedOut = true;
+      options == null ? void 0 : options.onTimeout();
+      if (!(options == null ? void 0 : options.waitForReady()))
+        settle("timeout");
+    }, timeoutMs);
     const check = () => {
       var _a, _b;
       if (isDisposed()) {
         settle("disposed");
         return;
       }
+      if (timedOut && !(options == null ? void 0 : options.waitForReady())) {
+        settle("timeout");
+        return;
+      }
       const img = getImage();
       if (img == null ? void 0 : img.complete) {
         if (img.naturalWidth > 0) {
@@ -2110,7 +2125,21 @@ 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;
+  const activityBlocked = () => {
+    var _a, _b;
+    const wm = context.getWindowManager();
+    if ((wm == null ? void 0 : wm.lazySetupInMaximizedMode) !== true)
+      return false;
+    const host = (_a = context.getRuntimeActivity) == null ? void 0 : _a.call(context);
+    if (host)
+      return document.visibilityState === "hidden" || !host.active;
+    return document.visibilityState === "hidden" || wm.boxState === "minimized" || ((_b = wm.attributes) == null ? void 0 : _b.minimized) === true || context.getBoxStatus() === "minimized";
+  };
   let boxBlurred = box.$box.classList.contains(boxBlurClass);
   const setBackgroundSuspended = (suspended) => {
     app.whiteboardDOM.classList.toggle(
@@ -2125,7 +2154,7 @@ var setupBlurThumbnailDegradation = (config) => {
     const thumbnailURL = page.thumbnail;
     const img = findBackgroundImage(view);
     if (!thumbnailURL || !hasUsableThumbnail(page)) {
-      if (boxBlurred) {
+      if (boxBlurred || activityBlocked()) {
         setBackgroundSuspended(true);
         if (img && resolveImageUrl(img.src) !== resolveImageUrl(TRANSPARENT_BACKGROUND)) {
           img.src = TRANSPARENT_BACKGROUND;
@@ -2147,11 +2176,14 @@ var setupBlurThumbnailDegradation = (config) => {
     setBackgroundSuspended(false);
   };
   const suspendCachedResources = () => {
-    if (!blurEpisode || !boxBlurred)
+    if (!blurEpisode || !boxBlurred && !activityBlocked())
       return;
-    app.suspendPreviewResources();
+    if (!previewSuspended) {
+      previewSuspended = true;
+      app.suspendPreviewResources();
+    }
     const page = pages[pageIndex$.value];
-    if (!page || !hasUsableThumbnail(page) || reDegradeEnabled) {
+    if (!page || !hasUsableThumbnail(page) || canReDegrade()) {
       degrade();
     }
   };
@@ -2159,7 +2191,8 @@ var setupBlurThumbnailDegradation = (config) => {
     if (!blurEpisode)
       return;
     blurEpisode = false;
-    reDegradeEnabled = false;
+    failedThumbnailPageIndex = null;
+    previewSuspended = false;
     restore2();
     app.preload.resume(pageIndex$.value);
   };
@@ -2177,40 +2210,57 @@ 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 offFocus = context.emitter.on("focus", (isFocused) => {
+  const applyActivity = () => {
+    var _a;
+    const lazy = ((_a = context.getWindowManager()) == null ? void 0 : _a.lazySetupInMaximizedMode) === true;
+    const isFocused = (!lazy || logicalFocused) && !activityBlocked();
+    if (appliedFocusState === isFocused)
+      return;
+    if (!isFocused && !isBlurDegradationAllowed(context) && !activityBlocked())
+      return;
     if (isFocused) {
       restoreFocusedResources();
     } else {
-      if (!isBlurDegradationAllowed(context))
-        return;
       blurEpisode = true;
-      reDegradeEnabled = true;
+      failedThumbnailPageIndex = null;
       degrade();
       app.preload.pause();
       suspendCachedResources();
     }
+    appliedFocusState = isFocused;
+  };
+  const offFocus = context.emitter.on("focus", (isFocused) => {
+    logicalFocused = isFocused;
+    applyActivity();
   });
   dispose2.add(offFocus);
+  dispose2.add(context.emitter.on("runtimeActivity", applyActivity));
+  document.addEventListener("visibilitychange", applyActivity);
+  dispose2.add(() => document.removeEventListener("visibilitychange", applyActivity));
   const updateBoxBlurred = (blurred) => {
     if (boxBlurred === blurred)
       return;
     boxBlurred = blurred;
     if (blurred)
       suspendCachedResources();
-    else
+    else if (logicalFocused && !activityBlocked())
       restoreFocusedResources();
   };
   const onBoxBlur = () => updateBoxBlurred(true);
@@ -2236,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);
@@ -2320,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,
@@ -2654,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.3";
+    app.contentDOM.dataset.appPresentationVersion = "0.1.13";
     app.scaleDocsToFit = scaleDocsToFit;
     app.log = log;
     app.warn = warn;
@@ -3129,11 +3180,15 @@ var NetlessAppPresentation = {
       const result = await waitForCurrentPageImage(
         () => findBackgroundImage(view),
         setupReadyTimeout,
-        () => disposed
+        () => disposed,
+        {
+          waitForReady: () => Boolean(context.waitForActualSetupReady),
+          onTimeout: () => warn(`[Presentation] setup page image still pending after ${setupReadyTimeout}ms`)
+        }
       );
-      if (result === "timeout" && !disposed) {
-        warn(`[Presentation] setup ready wait timed out after ${setupReadyTimeout}ms`);
-      } else if (result === "error" && !disposed) {
+      if (disposed)
+        throw new Error("[Presentation] disposed before setup ready");
+      if (result === "error") {
         warn("[Presentation] setup page image failed to load; continuing setup");
       }
       return controller;
@@ -3169,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);
@@ -3223,11 +3279,12 @@ var install = (register, options = {}) => {
 };
 
 // src/index.ts
-var version = "0.1.13-beta.3";
+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;