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

package/dist/index.mjs

@@ -1147,6 +1147,9 @@ var _Preload = class _Preload {
     // 当前触摸的索引
     this.touchIndex = 0;
     this.preloadSize = 0;
+    // 暂停后不再创建预加载链接（app 失焦降级时调用）；已插入的 link 会被移除，
+    // 挂起的 idle 回调重新进入 touch() 时也会被跳过
+    this.paused = false;
     this.preloadMap = new Map(pages.map((e, index) => [index, {
       src: e.src,
       state: 0 /* unloaded */
@@ -1154,7 +1157,21 @@ var _Preload = class _Preload {
     this.preloadSize = this.preloadMap.size;
     this.touch(0, true);
   }
+  pause() {
+    if (this.paused)
+      return;
+    this.paused = true;
+    this.destroySomeLink();
+  }
+  resume(index) {
+    if (!this.paused)
+      return;
+    this.paused = false;
+    this.touch(index != null ? index : this.touchIndex, true);
+  }
   touch(index, force = false) {
+    if (this.paused)
+      return;
     if (index >= this.preloadSize) {
       this.touchIndex = 0;
     } else {
@@ -1953,6 +1970,138 @@ var ppt2page = (ppt, name, originSize) => {
   const size = fitPageSizeToOrigin(ppt, originSize);
   return __spreadProps(__spreadValues({}, size), { src: ppt.src, thumbnail: ppt.previewURL, name });
 };
+var findBackgroundImage = (view) => {
+  const container = view.divElement;
+  if (!container || typeof container.querySelector !== "function")
+    return null;
+  return container.querySelector('img[alt="background"]');
+};
+var isBlurDegradationAllowed = (context) => {
+  const boxStatus = context.getBoxStatus();
+  if (boxStatus) {
+    return boxStatus !== "normal";
+  }
+  const boxState = context.getWindowManager().boxState;
+  return boxState !== void 0 && boxState !== "normal";
+};
+var DEFAULT_SETUP_READY_TIMEOUT = 5e3;
+var waitForCurrentPageImage = (view, timeoutMs, isDisposed) => {
+  return new Promise((resolve) => {
+    let settled = false;
+    let pollTimer;
+    const settle = (loaded) => {
+      if (settled)
+        return;
+      settled = true;
+      window.clearTimeout(timeoutTimer);
+      if (pollTimer !== void 0)
+        window.clearInterval(pollTimer);
+      resolve(loaded);
+    };
+    const timeoutTimer = window.setTimeout(() => settle(false), timeoutMs);
+    const check = () => {
+      if (isDisposed()) {
+        settle(false);
+        return;
+      }
+      const img = findBackgroundImage(view);
+      if (img && img.complete && img.naturalWidth > 0) {
+        settle(true);
+      }
+    };
+    check();
+    if (!settled) {
+      pollTimer = window.setInterval(check, 100);
+    }
+  });
+};
+var resolveImageUrl = (url) => {
+  try {
+    return new URL(url, window.location.href).href;
+  } catch (e) {
+    return url;
+  }
+};
+var setupBlurThumbnailDegradation = (config) => {
+  const { context, view, pages, pageIndex$, app, dispose: dispose2 } = config;
+  let blurEpisode = false;
+  let reDegradeEnabled = false;
+  const degrade = () => {
+    const page = pages[pageIndex$.value];
+    if (!(page == null ? void 0 : page.thumbnail))
+      return;
+    const img = findBackgroundImage(view);
+    if (img && resolveImageUrl(img.src) !== resolveImageUrl(page.thumbnail)) {
+      img.src = page.thumbnail;
+    }
+  };
+  const restore2 = () => {
+    const page = pages[pageIndex$.value];
+    const img = findBackgroundImage(view);
+    if (page && img && resolveImageUrl(img.src) !== resolveImageUrl(page.src)) {
+      img.src = page.src;
+    }
+  };
+  const isBackgroundImg = (target) => {
+    var _a;
+    const el = target;
+    return Boolean(
+      el && el.tagName === "IMG" && ((_a = el.matches) == null ? void 0 : _a.call(el, 'img[alt="background"]'))
+    );
+  };
+  const onImgLoad = (ev) => {
+    if (!blurEpisode || !reDegradeEnabled)
+      return;
+    if (!isBackgroundImg(ev.target))
+      return;
+    degrade();
+  };
+  const onImgError = (ev) => {
+    if (!blurEpisode || !reDegradeEnabled)
+      return;
+    if (!isBackgroundImg(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);
+      }
+    } else {
+      if (!isBlurDegradationAllowed(context))
+        return;
+      blurEpisode = true;
+      reDegradeEnabled = true;
+      degrade();
+      app.preload.pause();
+    }
+  });
+  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)"
+  );
+};
 var createLogger = (room) => {
   if (room && room.logger) {
     return (...args) => room.logger.info(...args);
@@ -2028,7 +2177,7 @@ var teardownByContext = /* @__PURE__ */ new WeakMap();
 var NetlessAppPresentation = {
   kind: "Presentation",
   setup(context) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d;
     const diagnosticLogger = createDiagnosticLogger(context);
     const view = context.getView();
     if (!view)
@@ -2374,10 +2523,13 @@ var NetlessAppPresentation = {
         options.useClipView
       )
     );
-    app.contentDOM.dataset.appPresentationVersion = "0.1.13-beta.0";
+    app.contentDOM.dataset.appPresentationVersion = "0.1.13-beta.1";
     app.scaleDocsToFit = scaleDocsToFit;
     app.log = log;
     app.warn = warn;
+    if (pageIndex$.value !== 0) {
+      app.preload.touch(pageIndex$.value, true);
+    }
     const getCameraDiagnosticState = (reason, requestedCamera) => {
       const page = app.page();
       const pageSize = page && isValidSize(page) ? { width: page.width, height: page.height } : void 0;
@@ -2434,8 +2586,8 @@ var NetlessAppPresentation = {
       app.setDocsViewReadonly(true);
     }
     const goToPageByClick = () => {
-      var _a2, _b2, _c2, _d;
-      const currentApplianceName = (_d = (_c2 = (_b2 = (_a2 = context.getRoom()) == null ? void 0 : _a2.state) == null ? void 0 : _b2.memberState) == null ? void 0 : _c2.currentApplianceName) != null ? _d : "";
+      var _a2, _b2, _c2, _d2;
+      const currentApplianceName = (_d2 = (_c2 = (_b2 = (_a2 = context.getRoom()) == null ? void 0 : _a2.state) == null ? void 0 : _b2.memberState) == null ? void 0 : _c2.currentApplianceName) != null ? _d2 : "";
       if (!app.readonly && currentApplianceName === "clicker") {
         nextPage();
       }
@@ -2482,6 +2634,9 @@ var NetlessAppPresentation = {
         app.setReadonly(!isWritable);
       })
     );
+    if (!options.disableBlurThumbnailDegradation) {
+      setupBlurThumbnailDegradation({ context, view, pages, pageIndex$, app, dispose: dispose2 });
+    }
     const getOriginScale = () => {
       const page = app.page();
       if (!page || !isValidSize(page))
@@ -2831,9 +2986,14 @@ var NetlessAppPresentation = {
         }
       )
     );
-    return prepareScenesPromise.then(
-      () => controller
-    );
+    const setupReadyTimeout = (_d = options.setupReadyTimeout) != null ? _d : DEFAULT_SETUP_READY_TIMEOUT;
+    return prepareScenesPromise.then(async () => {
+      const loaded = await waitForCurrentPageImage(view, setupReadyTimeout, () => disposed);
+      if (!loaded) {
+        warn(`[Presentation] setup ready wait timed out after ${setupReadyTimeout}ms`);
+      }
+      return controller;
+    });
   },
   teardown(context) {
     var _a;
@@ -2919,7 +3079,7 @@ var install = (register, options = {}) => {
 };
 
 // src/index.ts
-var version = "0.1.13-beta.0";
+var version = "0.1.13-beta.1";
 
 export { NetlessAppPresentation, Presentation, Scrollbar, NetlessAppPresentation as default, install, version };
 //# sourceMappingURL=index.mjs.map