@netless/app-presentation 0.1.13-beta.1 → 0.1.13-beta.2

package/dist/index.mjs

@@ -1313,10 +1313,7 @@ var Presentation = class {
     if (this.initialized)
       return;
     this.initialized = true;
-    this.dispose.add(() => {
-      var _a2;
-      return (_a2 = this.previewLazyload) == null ? void 0 : _a2.destroy();
-    });
+    this.dispose.add(() => this.destroyPreviewLazyload());
     this.contentDOM.classList.toggle(this.c("readonly"), this.readonly);
     this.dom.appendChild(this.contentDOM);
     const previewMask = this.contentDOM.appendChild(document.createElement("div"));
@@ -1469,6 +1466,17 @@ var Presentation = class {
       }
     }
   }
+  /** Release preview images while this presentation stays in the runtime cache. */
+  suspendPreviewResources() {
+    this.togglePreview(false);
+    this.destroyPreviewLazyload();
+    this.previewDOM.querySelectorAll("img").forEach((img) => {
+      img.removeAttribute("src");
+      img.removeAttribute("srcset");
+      img.removeAttribute("sizes");
+      LazyLoad.resetStatus(img);
+    });
+  }
   // [origin] means the cause:
   // - navigation: user clicked on the left / right button on footer
   // - input: user filled the bottom-right page number input box
@@ -1503,6 +1511,11 @@ var Presentation = class {
       return src;
     }
   }
+  destroyPreviewLazyload() {
+    var _a;
+    (_a = this.previewLazyload) == null ? void 0 : _a.destroy();
+    this.previewLazyload = null;
+  }
   c(className) {
     return `${this.namespace}-${className}`;
   }
@@ -1515,7 +1528,7 @@ var Presentation = class {
 };
 
 // src/style.scss?inline
-var style_default = ".netless-app-presentation{height:100%;display:flex;flex-flow:column nowrap}.netless-app-presentation-content{position:relative;height:100%;overflow:hidden}.netless-app-presentation-preview-mask{display:none;position:absolute;z-index:200;top:0;left:0;width:100%;height:100%}.netless-app-presentation-preview{display:flex;flex-direction:column;align-items:center;position:absolute;z-index:300;top:0;left:0;width:33%;max-width:200px;height:100%;padding-top:10px;transform:translate(-100%);background:#ededf0e6;box-shadow:inset -1px 0 #0000001c;transition:transform .4s;overflow:auto;overflow-y:scroll}.netless-app-presentation-preview-active .netless-app-presentation-preview-mask{display:block}.netless-app-presentation-preview-active .netless-app-presentation-preview{transform:translate(0)}.netless-app-presentation-preview-page{position:relative;display:block;width:55%;margin-bottom:10px;font-size:0;color:#0000;outline:none;border:7px solid rgba(0,0,0,0);border-radius:4px;transition:border-color .3s;user-select:none}.netless-app-presentation-preview-page:hover,.netless-app-presentation-preview-page.netless-app-presentation-preview-page-active{border-color:#444e601a}.netless-app-presentation-preview-page>img{width:100%;height:auto;box-sizing:border-box;border:1px solid rgba(0,0,0,.5);border-radius:1px;background-color:#fff;box-shadow:0 2px 8px #0000004d}.netless-app-presentation-preview-page-name{position:absolute;top:1px;left:-10px;transform:translate(-100%);text-align:right;font-size:12px;color:#5f5f5f;user-select:none}.netless-app-presentation-footer{box-sizing:border-box;height:26px;display:flex;align-items:center;padding:0 16px;border-top:1px solid #eeeef7;color:#191919}.netless-app-presentation-float-footer{width:100%;min-height:26px;position:absolute;left:0;bottom:0;z-index:2000;background:#f9f9fce6;transition:opacity .4s}.netless-app-presentation-footer-btn{box-sizing:border-box;width:26px;height:26px;font-size:0;margin:0;padding:3px;border:none;border-radius:1px;outline:none;color:currentColor;background:#0000;transition:background .4s;cursor:pointer;user-select:none;-webkit-tap-highlight-color:rgba(0,0,0,0)}.netless-app-presentation-footer-btn:hover{background:#ededf0e6}@media (hover: none){.netless-app-presentation-footer-btn:hover{background:#0000!important}}.netless-app-presentation-footer-btn>svg{width:100%;height:100%}.netless-app-presentation-footer-btn>svg:nth-of-type(2){display:none}.netless-app-presentation-footer-btn.netless-app-presentation-footer-btn-playing>svg:nth-of-type(1){display:none}.netless-app-presentation-footer-btn.netless-app-presentation-footer-btn-playing>svg:nth-of-type(2){display:initial}.netless-app-presentation-footer-btn~.netless-app-presentation-footer-btn{margin-left:15px}.netless-app-presentation-page-jumps{flex:1;display:flex;justify-content:center;align-items:center}.netless-app-presentation-page-number{margin-left:auto;font-size:13px;user-select:none;white-space:nowrap;word-break:keep-all}.netless-app-presentation-page-number-input{border:none;outline:none;width:3em;margin:0;padding:0 2px;text-align:right;font-size:13px;line-height:1;font-weight:400;font-family:inherit;border-radius:2px;color:currentColor;background:#0000;transition:background .4s;user-select:text;-webkit-tap-highlight-color:rgba(0,0,0,0)}.netless-app-presentation-page-number-input:hover,.netless-app-presentation-page-number-input:focus,.netless-app-presentation-page-number-input:active{background:#fff;box-shadow:#63636333 0 2px 8px}.netless-app-presentation-readonly.netless-app-presentation-footer{display:none}.netless-app-presentation-wb-view{position:absolute;top:0;left:0;width:100%;height:100%;z-index:100;overflow:hidden;transition:opacity .2s}.netless-app-presentation-image{width:100%;height:100%;display:flex;align-items:center;justify-content:center}.netless-app-presentation-image>img{max-width:100%;max-height:100%;object-fit:contain}.telebox-color-scheme-dark .netless-app-presentation-page-number-input{color:#a6a6a8}.telebox-color-scheme-dark .netless-app-presentation-page-number-input:active,.telebox-color-scheme-dark .netless-app-presentation-page-number-input:focus,.telebox-color-scheme-dark .netless-app-presentation-page-number-input:hover{color:#222}.telebox-color-scheme-dark .netless-app-presentation-footer{color:#a6a6a8;background:#2d2d33;border-top:none}.telebox-color-scheme-dark .netless-app-presentation-footer-btn:hover{background:#212126}.telebox-color-scheme-dark .netless-app-presentation-preview{background:#323232e6}.netless-app-presentation-scrollbar-container{position:absolute;left:0;top:0;width:100%;height:100%;pointer-events:none;z-index:101}.netless-app-presentation-scrollbar-container-x,.netless-app-presentation-scrollbar-container-y{position:absolute;pointer-events:none;display:flex;justify-content:center;box-sizing:border-box;padding:0}.netless-app-presentation-scrollbar-container-x{bottom:0;left:0;height:6px;width:100%;padding-right:6px}.netless-app-presentation-scrollbar-container-y{top:0;right:0;width:6px;height:100%;flex-direction:column;padding-bottom:6px}.netless-app-presentation-scrollbar-x,.netless-app-presentation-scrollbar-y{border-radius:2px;background-color:#1b1f4d4d;pointer-events:auto;cursor:default}.netless-app-presentation-scrollbar-x{height:6px}.netless-app-presentation-scrollbar-y{width:6px}";
+var style_default = ".netless-app-presentation{height:100%;display:flex;flex-flow:column nowrap}.netless-app-presentation-content{position:relative;height:100%;overflow:hidden}.netless-app-presentation-background-suspended .background{display:none!important}.netless-app-presentation-preview-mask{display:none;position:absolute;z-index:200;top:0;left:0;width:100%;height:100%}.netless-app-presentation-preview{display:flex;flex-direction:column;align-items:center;position:absolute;z-index:300;top:0;left:0;width:33%;max-width:200px;height:100%;padding-top:10px;transform:translate(-100%);background:#ededf0e6;box-shadow:inset -1px 0 #0000001c;transition:transform .4s;overflow:auto;overflow-y:scroll}.netless-app-presentation-preview-active .netless-app-presentation-preview-mask{display:block}.netless-app-presentation-preview-active .netless-app-presentation-preview{transform:translate(0)}.netless-app-presentation-preview-page{position:relative;display:block;width:55%;margin-bottom:10px;font-size:0;color:#0000;outline:none;border:7px solid rgba(0,0,0,0);border-radius:4px;transition:border-color .3s;user-select:none}.netless-app-presentation-preview-page:hover,.netless-app-presentation-preview-page.netless-app-presentation-preview-page-active{border-color:#444e601a}.netless-app-presentation-preview-page>img{width:100%;height:auto;box-sizing:border-box;border:1px solid rgba(0,0,0,.5);border-radius:1px;background-color:#fff;box-shadow:0 2px 8px #0000004d}.netless-app-presentation-preview-page-name{position:absolute;top:1px;left:-10px;transform:translate(-100%);text-align:right;font-size:12px;color:#5f5f5f;user-select:none}.netless-app-presentation-footer{box-sizing:border-box;height:26px;display:flex;align-items:center;padding:0 16px;border-top:1px solid #eeeef7;color:#191919}.netless-app-presentation-float-footer{width:100%;min-height:26px;position:absolute;left:0;bottom:0;z-index:2000;background:#f9f9fce6;transition:opacity .4s}.netless-app-presentation-footer-btn{box-sizing:border-box;width:26px;height:26px;font-size:0;margin:0;padding:3px;border:none;border-radius:1px;outline:none;color:currentColor;background:#0000;transition:background .4s;cursor:pointer;user-select:none;-webkit-tap-highlight-color:rgba(0,0,0,0)}.netless-app-presentation-footer-btn:hover{background:#ededf0e6}@media (hover: none){.netless-app-presentation-footer-btn:hover{background:#0000!important}}.netless-app-presentation-footer-btn>svg{width:100%;height:100%}.netless-app-presentation-footer-btn>svg:nth-of-type(2){display:none}.netless-app-presentation-footer-btn.netless-app-presentation-footer-btn-playing>svg:nth-of-type(1){display:none}.netless-app-presentation-footer-btn.netless-app-presentation-footer-btn-playing>svg:nth-of-type(2){display:initial}.netless-app-presentation-footer-btn~.netless-app-presentation-footer-btn{margin-left:15px}.netless-app-presentation-page-jumps{flex:1;display:flex;justify-content:center;align-items:center}.netless-app-presentation-page-number{margin-left:auto;font-size:13px;user-select:none;white-space:nowrap;word-break:keep-all}.netless-app-presentation-page-number-input{border:none;outline:none;width:3em;margin:0;padding:0 2px;text-align:right;font-size:13px;line-height:1;font-weight:400;font-family:inherit;border-radius:2px;color:currentColor;background:#0000;transition:background .4s;user-select:text;-webkit-tap-highlight-color:rgba(0,0,0,0)}.netless-app-presentation-page-number-input:hover,.netless-app-presentation-page-number-input:focus,.netless-app-presentation-page-number-input:active{background:#fff;box-shadow:#63636333 0 2px 8px}.netless-app-presentation-readonly.netless-app-presentation-footer{display:none}.netless-app-presentation-wb-view{position:absolute;top:0;left:0;width:100%;height:100%;z-index:100;overflow:hidden;transition:opacity .2s}.netless-app-presentation-image{width:100%;height:100%;display:flex;align-items:center;justify-content:center}.netless-app-presentation-image>img{max-width:100%;max-height:100%;object-fit:contain}.telebox-color-scheme-dark .netless-app-presentation-page-number-input{color:#a6a6a8}.telebox-color-scheme-dark .netless-app-presentation-page-number-input:active,.telebox-color-scheme-dark .netless-app-presentation-page-number-input:focus,.telebox-color-scheme-dark .netless-app-presentation-page-number-input:hover{color:#222}.telebox-color-scheme-dark .netless-app-presentation-footer{color:#a6a6a8;background:#2d2d33;border-top:none}.telebox-color-scheme-dark .netless-app-presentation-footer-btn:hover{background:#212126}.telebox-color-scheme-dark .netless-app-presentation-preview{background:#323232e6}.netless-app-presentation-scrollbar-container{position:absolute;left:0;top:0;width:100%;height:100%;pointer-events:none;z-index:101}.netless-app-presentation-scrollbar-container-x,.netless-app-presentation-scrollbar-container-y{position:absolute;pointer-events:none;display:flex;justify-content:center;box-sizing:border-box;padding:0}.netless-app-presentation-scrollbar-container-x{bottom:0;left:0;height:6px;width:100%;padding-right:6px}.netless-app-presentation-scrollbar-container-y{top:0;right:0;width:6px;height:100%;flex-direction:column;padding-bottom:6px}.netless-app-presentation-scrollbar-x,.netless-app-presentation-scrollbar-y{border-radius:2px;background-color:#1b1f4d4d;pointer-events:auto;cursor:default}.netless-app-presentation-scrollbar-x{height:6px}.netless-app-presentation-scrollbar-y{width:6px}";
 
 // src/store.ts
 function noop() {
@@ -1961,6 +1974,23 @@ function cameraToSharedViewport(camera, viewSize, referenceSize) {
   };
 }
 
+// src/runtime-lifecycle.ts
+var createPresentationRuntimeTeardown = (box, dispose2) => {
+  let tornDown = false;
+  return () => {
+    if (tornDown)
+      return;
+    tornDown = true;
+    try {
+      dispose2();
+    } finally {
+      box.unmountContent();
+      box.unmountFooter();
+      box.unmountStyles();
+    }
+  };
+};
+
 // src/app-presentation.ts
 var import_debounce2 = __toESM(require_debounce());
 var emptySceneName = "$$empty$$";
@@ -1977,6 +2007,10 @@ var findBackgroundImage = (view) => {
   return container.querySelector('img[alt="background"]');
 };
 var isBlurDegradationAllowed = (context) => {
+  var _a;
+  if (((_a = context.getWindowManager()) == null ? void 0 : _a.lazySetupInMaximizedMode) !== true) {
+    return false;
+  }
   const boxStatus = context.getBoxStatus();
   if (boxStatus) {
     return boxStatus !== "normal";
@@ -2022,17 +2056,55 @@ var resolveImageUrl = (url) => {
     return url;
   }
 };
+var TRANSPARENT_BACKGROUND = "data:image/gif;base64,R0lGODlhAQABAAD/ACwAAAAAAQABAAACADs=";
+var BACKGROUND_SUSPENDED_CLASS = "netless-app-presentation-background-suspended";
+var hasUsableThumbnail = (page) => {
+  const thumbnailURL = page.thumbnail;
+  if (!thumbnailURL)
+    return false;
+  try {
+    const source = new URL(page.src, window.location.href);
+    const thumbnail = new URL(thumbnailURL, window.location.href);
+    const sameResourcePath = source.origin === thumbnail.origin && source.pathname === thumbnail.pathname;
+    if (/\.gif$/i.test(source.pathname) && sameResourcePath)
+      return false;
+  } catch (e) {
+    if (/\.gif(?:$|[?#])/i.test(page.src))
+      return false;
+  }
+  return resolveImageUrl(thumbnailURL) !== resolveImageUrl(page.src);
+};
 var setupBlurThumbnailDegradation = (config) => {
   const { context, view, pages, pageIndex$, app, dispose: dispose2 } = config;
+  const box = context.getBox();
+  const boxBlurClass = box.wrapClassName("blur");
   let blurEpisode = false;
   let reDegradeEnabled = false;
+  let boxBlurred = box.$box.classList.contains(boxBlurClass);
+  const setBackgroundSuspended = (suspended) => {
+    app.whiteboardDOM.classList.toggle(
+      BACKGROUND_SUSPENDED_CLASS,
+      suspended
+    );
+  };
   const degrade = () => {
     const page = pages[pageIndex$.value];
-    if (!(page == null ? void 0 : page.thumbnail))
+    if (!page)
       return;
+    const thumbnailURL = page.thumbnail;
     const img = findBackgroundImage(view);
-    if (img && resolveImageUrl(img.src) !== resolveImageUrl(page.thumbnail)) {
-      img.src = page.thumbnail;
+    if (!thumbnailURL || !hasUsableThumbnail(page)) {
+      if (boxBlurred) {
+        setBackgroundSuspended(true);
+        if (img && resolveImageUrl(img.src) !== resolveImageUrl(TRANSPARENT_BACKGROUND)) {
+          img.src = TRANSPARENT_BACKGROUND;
+        }
+      }
+      return;
+    }
+    setBackgroundSuspended(false);
+    if (img && resolveImageUrl(img.src) !== resolveImageUrl(thumbnailURL)) {
+      img.src = thumbnailURL;
     }
   };
   const restore2 = () => {
@@ -2041,6 +2113,24 @@ var setupBlurThumbnailDegradation = (config) => {
     if (page && img && resolveImageUrl(img.src) !== resolveImageUrl(page.src)) {
       img.src = page.src;
     }
+    setBackgroundSuspended(false);
+  };
+  const suspendCachedResources = () => {
+    if (!blurEpisode || !boxBlurred)
+      return;
+    app.suspendPreviewResources();
+    const page = pages[pageIndex$.value];
+    if (!page || !hasUsableThumbnail(page) || reDegradeEnabled) {
+      degrade();
+    }
+  };
+  const restoreFocusedResources = () => {
+    if (!blurEpisode)
+      return;
+    blurEpisode = false;
+    reDegradeEnabled = false;
+    restore2();
+    app.preload.resume(pageIndex$.value);
   };
   const isBackgroundImg = (target) => {
     var _a;
@@ -2049,28 +2139,29 @@ var setupBlurThumbnailDegradation = (config) => {
       el && el.tagName === "IMG" && ((_a = el.matches) == null ? void 0 : _a.call(el, 'img[alt="background"]'))
     );
   };
+  const ownsTarget = (target) => {
+    if (!isBackgroundImg(target))
+      return false;
+    const el = view.divElement;
+    return !!(el && el.contains(target));
+  };
   const onImgLoad = (ev) => {
     if (!blurEpisode || !reDegradeEnabled)
       return;
-    if (!isBackgroundImg(ev.target))
+    if (!ownsTarget(ev.target))
       return;
     degrade();
   };
   const onImgError = (ev) => {
     if (!blurEpisode || !reDegradeEnabled)
       return;
-    if (!isBackgroundImg(ev.target))
+    if (!ownsTarget(ev.target))
       return;
     reDegradeEnabled = false;
   };
   const offFocus = context.emitter.on("focus", (isFocused) => {
     if (isFocused) {
-      if (blurEpisode) {
-        blurEpisode = false;
-        reDegradeEnabled = false;
-        restore2();
-        app.preload.resume(pageIndex$.value);
-      }
+      restoreFocusedResources();
     } else {
       if (!isBlurDegradationAllowed(context))
         return;
@@ -2078,29 +2169,41 @@ var setupBlurThumbnailDegradation = (config) => {
       reDegradeEnabled = true;
       degrade();
       app.preload.pause();
+      suspendCachedResources();
     }
   });
   dispose2.add(offFocus);
-  const viewEl = view.divElement;
-  if (viewEl && typeof viewEl.addEventListener === "function") {
-    viewEl.addEventListener("load", onImgLoad, true);
-    viewEl.addEventListener("error", onImgError, true);
-    dispose2.add(() => {
-      viewEl.removeEventListener("load", onImgLoad, true);
-      viewEl.removeEventListener("error", onImgError, true);
-    });
-  } else {
-    warnOnceMissingViewContainer(view);
-  }
-};
-var degradedWarnedViews = /* @__PURE__ */ new WeakSet();
-var warnOnceMissingViewContainer = (view) => {
-  if (degradedWarnedViews.has(view))
-    return;
-  degradedWarnedViews.add(view);
-  console.warn(
-    "[Presentation]: blur thumbnail degradation runs without re-degrade coverage (view container unavailable)"
-  );
+  const updateBoxBlurred = (blurred) => {
+    if (boxBlurred === blurred)
+      return;
+    boxBlurred = blurred;
+    if (blurred)
+      suspendCachedResources();
+    else
+      restoreFocusedResources();
+  };
+  const onBoxBlur = () => updateBoxBlurred(true);
+  const onBoxFocus = () => updateBoxBlurred(false);
+  box.events.on("blur", onBoxBlur);
+  box.events.on("focus", onBoxFocus);
+  dispose2.add(() => {
+    box.events.off("blur", onBoxBlur);
+    box.events.off("focus", onBoxFocus);
+  });
+  const boxClassObserver = new MutationObserver(() => {
+    updateBoxBlurred(box.$box.classList.contains(boxBlurClass));
+  });
+  boxClassObserver.observe(box.$box, {
+    attributes: true,
+    attributeFilter: ["class"]
+  });
+  dispose2.add(() => boxClassObserver.disconnect());
+  document.addEventListener("load", onImgLoad, true);
+  document.addEventListener("error", onImgError, true);
+  dispose2.add(() => {
+    document.removeEventListener("load", onImgLoad, true);
+    document.removeEventListener("error", onImgError, true);
+  });
 };
 var createLogger = (room) => {
   if (room && room.logger) {
@@ -2523,7 +2626,7 @@ var NetlessAppPresentation = {
         options.useClipView
       )
     );
-    app.contentDOM.dataset.appPresentationVersion = "0.1.13-beta.1";
+    app.contentDOM.dataset.appPresentationVersion = "0.1.13-beta.2";
     app.scaleDocsToFit = scaleDocsToFit;
     app.log = log;
     app.warn = warn;
@@ -2765,6 +2868,10 @@ var NetlessAppPresentation = {
     };
     let disposed = false;
     let offDestroy;
+    const teardownRuntime = createPresentationRuntimeTeardown(
+      box,
+      dispose2
+    );
     const teardown = () => {
       if (disposed)
         return;
@@ -2772,7 +2879,7 @@ var NetlessAppPresentation = {
       const removeDestroy = offDestroy;
       offDestroy = void 0;
       removeDestroy == null ? void 0 : removeDestroy();
-      dispose2();
+      teardownRuntime();
     };
     offDestroy = context.emitter.on("destroy", teardown);
     teardownByContext.set(context, teardown);
@@ -2989,7 +3096,7 @@ var NetlessAppPresentation = {
     const setupReadyTimeout = (_d = options.setupReadyTimeout) != null ? _d : DEFAULT_SETUP_READY_TIMEOUT;
     return prepareScenesPromise.then(async () => {
       const loaded = await waitForCurrentPageImage(view, setupReadyTimeout, () => disposed);
-      if (!loaded) {
+      if (!loaded && !disposed) {
         warn(`[Presentation] setup ready wait timed out after ${setupReadyTimeout}ms`);
       }
       return controller;
@@ -3079,7 +3186,7 @@ var install = (register, options = {}) => {
 };
 
 // src/index.ts
-var version = "0.1.13-beta.1";
+var version = "0.1.13-beta.2";
 
-export { NetlessAppPresentation, Presentation, Scrollbar, NetlessAppPresentation as default, install, version };
+export { NetlessAppPresentation, Presentation, Scrollbar, NetlessAppPresentation as default, install, setupBlurThumbnailDegradation, version };
 //# sourceMappingURL=index.mjs.map