pdfjs-reader-core 0.5.9 → 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") {
@@ -13140,8 +13149,8 @@ var ACCENT_SOFT = "rgba(176, 74, 26, 0.18)";
 var ACCENT_GLOW = "rgba(176, 74, 26, 0.35)";
 var SERIF = "'Iowan Old Style', 'Palatino Linotype', Palatino, 'Book Antiqua', 'EB Garamond', 'Hoefler Text', Georgia, serif";
 var EASE_OUT_EXPO = [0.22, 1, 0.36, 1];
-var PILL_FONT_CAPS = "clamp(10.5px, 0.55vw + 8.5px, 14.5px)";
-var PILL_FONT_BODY = "clamp(12px, 0.6vw + 10px, 16.5px)";
+var PILL_FONT_CAPS = "clamp(9px, 0.55vw + 7px, 13px)";
+var PILL_FONT_BODY = "clamp(10.5px, 0.6vw + 8.5px, 15px)";
 var PILL_FONT_DISPLAY = "clamp(14px, 0.75vw + 12px, 19px)";
 var PILL_MAX_W_CAPS = "clamp(180px, 26vw, 380px)";
 var PILL_MAX_W_BODY = "clamp(200px, 28vw, 440px)";
@@ -13152,8 +13161,8 @@ function resolveMaxPillW(viewportWidthPx) {
   return clamp(0.26 * viewportWidthPx, 180, 380);
 }
 function resolveMaxPillH(viewportWidthPx) {
-  const font = clamp(55e-4 * viewportWidthPx + 8.5, 10.5, 14.5);
-  return clamp(font * 2.6, 28, 42);
+  const font = clamp(55e-4 * viewportWidthPx + 7, 9, 13);
+  return clamp(font * 2.6, 24, 36);
 }
 function clamp(v, lo, hi) {
   return Math.min(hi, Math.max(lo, v));
@@ -14409,13 +14418,14 @@ function StickyLabel({ screenAnchor, action }) {
               textTransform: "uppercase",
               fontWeight: 500,
               // Wrap instead of truncating with an ellipsis. Short labels stay
-              // single-line naturally; longer ones grow in height rather than
-              // losing their tail. `overflowWrap: 'anywhere'` keeps a stray
-              // long word from pushing the pill past `maxWidth` (normal word
-              // breaking stops at whitespace and can't break inside words).
+              // single-line; longer ones grow in height rather than losing
+              // their tail. `overflowWrap: 'break-word'` respects min-content
+              // sizing so a single overflowing word mid-breaks at a safe
+              // boundary — unlike `anywhere`, which would collapse the pill
+              // to 1-char min width and stack every letter on its own line.
               maxWidth: PILL_MAX_W_BODY,
               whiteSpace: "normal",
-              overflowWrap: "anywhere",
+              overflowWrap: "break-word",
               // Warm two-layer shadow (matches GhostReference's palette).
               boxShadow: "0 1px 2px rgba(42, 36, 32, 0.12), 0 8px 18px -6px rgba(42, 36, 32, 0.22)",
               // Internal left accent rule — a 2px terracotta stripe.
@@ -14714,11 +14724,13 @@ function CalloutLabelPill({
         fontWeight: 500,
         // Wrap instead of truncating. Short labels stay single-line;
         // longer ones grow taller rather than losing their tail to an
-        // ellipsis. `overflowWrap: 'anywhere'` guards against a stray
-        // long word pushing the pill past `maxWidth`.
+        // ellipsis. `overflowWrap: 'break-word'` respects min-content
+        // sizing — `anywhere` here caused the pill to collapse to 1-char
+        // width and stack each letter on its own line when the clamped
+        // maxWidth was narrow.
         maxWidth: PILL_MAX_W_CAPS,
         whiteSpace: "normal",
-        overflowWrap: "anywhere",
+        overflowWrap: "break-word",
         boxShadow: "0 1px 2px rgba(42, 36, 32, 0.12), 0 8px 18px -6px rgba(42, 36, 32, 0.22)",
         // Accent rule on the "inward" edge (the one closest to the arrow).
         backgroundImage: spec.accentGradient,
@@ -14808,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) {
@@ -14827,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
@@ -14996,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);