pdfjs-reader-core 0.5.10 → 0.5.11

package/dist/index.d.cts

@@ -2031,6 +2031,22 @@ interface EngineDeps {
      * visually in a narration context. Default: 3500ms.
      */
     minOverlayDurationMs?: number;
+    /**
+     * When true, only ONE annotation overlay is on-screen at any time: every
+     * new overlay-emitting step first clears all prior overlays and their
+     * auto-removal timers.
+     *
+     * Defaults to `isIOSMobile()` — on iOS Safari/WebKit, stacking 2-3 overlays
+     * (e.g. highlight + box + underline + callout) on the same anchor is the
+     * single biggest remaining crash vector we've measured. The GPU
+     * compositor rejects the layer combination long before the canvas cap
+     * kicks in. Dropping to one overlay at a time sacrifices overlay chaining
+     * on iOS for a hard stability guarantee.
+     *
+     * Pass `false` explicitly to force multi-overlay mode even on iOS (e.g.
+     * for tests or a deliberate opt-out in the consumer).
+     */
+    singleActiveOverlay?: boolean;
 }
 declare class StoryboardEngine {
     private deps;
@@ -2049,6 +2065,13 @@ declare class StoryboardEngine {
      */
     private overlayRemovalTimers;
     private currentStoryboardId;
+    /**
+     * Resolved value of `deps.singleActiveOverlay`. Cached at construction so
+     * each step dispatch is a single branch rather than a per-call
+     * userAgent sniff, and so the policy stays stable for the engine's
+     * lifetime (a viewport flip that recreates the engine will re-evaluate).
+     */
+    private readonly singleActiveOverlay;
     constructor(deps: EngineDeps);
     /**
      * Execute a new storyboard. Cancels in-flight steps from the previous storyboard

package/dist/index.d.ts

@@ -2031,6 +2031,22 @@ interface EngineDeps {
      * visually in a narration context. Default: 3500ms.
      */
     minOverlayDurationMs?: number;
+    /**
+     * When true, only ONE annotation overlay is on-screen at any time: every
+     * new overlay-emitting step first clears all prior overlays and their
+     * auto-removal timers.
+     *
+     * Defaults to `isIOSMobile()` — on iOS Safari/WebKit, stacking 2-3 overlays
+     * (e.g. highlight + box + underline + callout) on the same anchor is the
+     * single biggest remaining crash vector we've measured. The GPU
+     * compositor rejects the layer combination long before the canvas cap
+     * kicks in. Dropping to one overlay at a time sacrifices overlay chaining
+     * on iOS for a hard stability guarantee.
+     *
+     * Pass `false` explicitly to force multi-overlay mode even on iOS (e.g.
+     * for tests or a deliberate opt-out in the consumer).
+     */
+    singleActiveOverlay?: boolean;
 }
 declare class StoryboardEngine {
     private deps;
@@ -2049,6 +2065,13 @@ declare class StoryboardEngine {
      */
     private overlayRemovalTimers;
     private currentStoryboardId;
+    /**
+     * Resolved value of `deps.singleActiveOverlay`. Cached at construction so
+     * each step dispatch is a single branch rather than a per-call
+     * userAgent sniff, and so the policy stays stable for the engine's
+     * lifetime (a viewport flip that recreates the engine will re-evaluate).
+     */
+    private readonly singleActiveOverlay;
     constructor(deps: EngineDeps);
     /**
      * Execute a new storyboard. Cancels in-flight steps from the previous storyboard

package/dist/index.js

@@ -1879,6 +1879,15 @@ function detectDeviceCapabilities() {
     screenSize
   };
 }
+function isIOSMobile() {
+  if (typeof window === "undefined" || typeof navigator === "undefined") {
+    return false;
+  }
+  const ua = navigator.userAgent || "";
+  if (/iPhone|iPad|iPod/i.test(ua)) return true;
+  const isAppleTouch = /Mac/i.test(ua) && typeof navigator.maxTouchPoints === "number" && navigator.maxTouchPoints > 1;
+  return isAppleTouch;
+}
 function getRenderConfig(quality = "auto", capabilities) {
   const caps = capabilities ?? detectDeviceCapabilities();
   if (quality === "auto") {
@@ -14811,6 +14820,7 @@ function SubtitleBar({ text }) {
 // src/director/storyboard-engine.ts
 init_narration_store();
 init_camera_math();
+init_mobile_config();
 var DEFAULT_MIN_OVERLAY_MS = 3500;
 var StoryboardEngine = class {
   constructor(deps) {
@@ -14830,6 +14840,7 @@ var StoryboardEngine = class {
     this.overlayRemovalTimers = /* @__PURE__ */ new Map();
     this.currentStoryboardId = 0;
     this.deps = deps;
+    this.singleActiveOverlay = deps.singleActiveOverlay ?? isIOSMobile();
   }
   /**
    * Execute a new storyboard. Cancels in-flight steps from the previous storyboard
@@ -14999,6 +15010,10 @@ var StoryboardEngine = class {
       createdAt: Date.now(),
       expiresAt: Date.now() + visibleMs
     };
+    if (this.singleActiveOverlay) {
+      this.cancelAllRemovalTimers();
+      narrationStore.getState().clearOverlays();
+    }
     narrationStore.getState().addOverlay(overlay);
     const timer = setTimeout(() => {
       narrationStore.getState().removeOverlay(overlay.id);