@embedpdf/plugin-selection 2.5.0 → 2.6.1

package/dist/index.js

@@ -329,36 +329,38 @@ function mergeAdjacentRects(textRuns) {
 function createTextSelectionHandler(opts) {
   return {
     onPointerDown: (point, evt, modeId) => {
+      var _a;
+      if (evt.target === evt.currentTarget) {
+        (_a = opts.onEmptySpaceClick) == null ? void 0 : _a.call(opts, modeId);
+      }
       if (!opts.isEnabled(modeId)) return;
-      opts.onClear();
+      opts.onClear(modeId);
       const geo = opts.getGeometry();
       if (geo) {
         const g = glyphAt(geo, point);
         if (g !== -1) {
-          opts.onBegin(g);
-          evt.stopImmediatePropagation();
+          opts.onBegin(g, modeId);
         }
       }
     },
-    onPointerMove: (point, evt, modeId) => {
+    onPointerMove: (point, _evt, modeId) => {
       if (!opts.isEnabled(modeId)) return;
       const geo = opts.getGeometry();
       if (geo) {
         const g = glyphAt(geo, point);
         opts.setCursor(g !== -1 ? "text" : null);
         if (opts.isSelecting() && g !== -1) {
-          opts.onUpdate(g);
-          evt.stopImmediatePropagation();
+          opts.onUpdate(g, modeId);
         }
       }
     },
     onPointerUp: (_point, _evt, modeId) => {
       if (!opts.isEnabled(modeId)) return;
-      opts.onEnd();
+      opts.onEnd(modeId);
     },
     onHandlerActiveEnd: (modeId) => {
       if (!opts.isEnabled(modeId)) return;
-      opts.onClear();
+      opts.onClear(modeId);
     }
   };
 }
@@ -368,12 +370,13 @@ function createMarqueeSelectionHandler(opts) {
   let last = null;
   return {
     onPointerDown: (pos, evt, modeId) => {
-      var _a;
+      var _a, _b;
       if (!opts.isEnabled(modeId)) return;
+      if ((_a = opts.isTextSelecting) == null ? void 0 : _a.call(opts)) return;
       start = pos;
       last = { origin: { x: pos.x, y: pos.y }, size: { width: 0, height: 0 } };
-      opts.onBegin(pos);
-      (_a = evt.setPointerCapture) == null ? void 0 : _a.call(evt);
+      opts.onBegin(pos, modeId);
+      (_b = evt.setPointerCapture) == null ? void 0 : _b.call(evt);
     },
     onPointerMove: (pos, _evt, modeId) => {
       if (!start || !opts.isEnabled(modeId)) return;
@@ -383,7 +386,7 @@ function createMarqueeSelectionHandler(opts) {
         origin: { x: Math.min(start.x, x), y: Math.min(start.y, y) },
         size: { width: Math.abs(x - start.x), height: Math.abs(y - start.y) }
       };
-      opts.onChange(last);
+      opts.onChange(last, modeId);
     },
     onPointerUp: (_pos, evt, modeId) => {
       var _a;
@@ -391,9 +394,9 @@ function createMarqueeSelectionHandler(opts) {
       if (last && start) {
         const dragPx = Math.max(last.size.width, last.size.height) * scale;
         if (dragPx > minDragPx) {
-          opts.onEnd(last);
+          opts.onEnd(last, modeId);
         } else {
-          opts.onCancel();
+          opts.onCancel(modeId);
         }
       }
       start = null;
@@ -405,7 +408,7 @@ function createMarqueeSelectionHandler(opts) {
       if (!opts.isEnabled(modeId)) return;
       start = null;
       last = null;
-      opts.onCancel();
+      opts.onCancel(modeId);
       (_a = evt.releasePointerCapture) == null ? void 0 : _a.call(evt);
     }
   };
@@ -417,11 +420,14 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     this.enabledModesPerDoc = /* @__PURE__ */ new Map();
     this.selecting = /* @__PURE__ */ new Map();
     this.anchor = /* @__PURE__ */ new Map();
-    this.marqueeEnabled = /* @__PURE__ */ new Map();
     this.marqueePage = /* @__PURE__ */ new Map();
     this.pageCallbacks = /* @__PURE__ */ new Map();
     this.menuPlacement$ = createScopedEmitter((documentId, placement) => ({ documentId, placement }));
-    this.selChange$ = createScopedEmitter((documentId, selection) => ({ documentId, selection }));
+    this.selChange$ = createScopedEmitter((documentId, selection) => ({
+      documentId,
+      selection,
+      modeId: this.interactionManagerCapability.forDocument(documentId).getActiveMode()
+    }));
     this.textRetrieved$ = createScopedEmitter(
       (documentId, text) => ({ documentId, text })
     );
@@ -429,19 +435,41 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
       (documentId, text) => ({ documentId, text }),
       { cache: false }
     );
-    this.beginSelection$ = createScopedEmitter((documentId, data) => ({ documentId, page: data.page, index: data.index }), { cache: false });
-    this.endSelection$ = createScopedEmitter(
-      (documentId) => ({ documentId }),
+    this.beginSelection$ = createScopedEmitter(
+      (documentId, data) => ({
+        documentId,
+        page: data.page,
+        index: data.index,
+        modeId: data.modeId
+      }),
+      { cache: false }
+    );
+    this.endSelection$ = createScopedEmitter((documentId, data) => ({ documentId, modeId: data.modeId }), { cache: false });
+    this.marqueeChange$ = createScopedEmitter(
+      (documentId, data) => ({
+        documentId,
+        pageIndex: data.pageIndex,
+        rect: data.rect,
+        modeId: data.modeId
+      }),
       { cache: false }
     );
-    this.marqueeChange$ = createScopedEmitter((documentId, data) => ({ documentId, pageIndex: data.pageIndex, rect: data.rect }), {
-      cache: false
-    });
     this.marqueeEnd$ = createScopedEmitter(
-      (documentId, data) => ({ documentId, pageIndex: data.pageIndex, rect: data.rect }),
-      {
-        cache: false
-      }
+      (documentId, data) => ({
+        documentId,
+        pageIndex: data.pageIndex,
+        rect: data.rect,
+        modeId: data.modeId
+      }),
+      { cache: false }
+    );
+    this.emptySpaceClick$ = createScopedEmitter(
+      (documentId, data) => ({
+        documentId,
+        pageIndex: data.pageIndex,
+        modeId: data.modeId
+      }),
+      { cache: false }
     );
     this.viewportCapability = null;
     this.scrollCapability = null;
@@ -474,16 +502,26 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
   }
   /* ── life-cycle ────────────────────────────────────────── */
   onDocumentLoadingStarted(documentId) {
+    var _a;
     this.dispatch(initSelectionState(documentId, initialSelectionDocumentState));
+    const marqueeEnabled = ((_a = this.config.marquee) == null ? void 0 : _a.enabled) !== false;
     this.enabledModesPerDoc.set(
       documentId,
-      /* @__PURE__ */ new Map([["pointerMode", { showRects: true }]])
+      /* @__PURE__ */ new Map([
+        [
+          "pointerMode",
+          {
+            enableSelection: true,
+            showSelectionRects: true,
+            enableMarquee: marqueeEnabled,
+            showMarqueeRects: true
+          }
+        ]
+      ])
     );
     this.pageCallbacks.set(documentId, /* @__PURE__ */ new Map());
     this.selecting.set(documentId, false);
     this.anchor.set(documentId, void 0);
-    const marqueeConfig = this.config.marquee;
-    this.marqueeEnabled.set(documentId, (marqueeConfig == null ? void 0 : marqueeConfig.enabled) !== false);
   }
   onDocumentClosed(documentId) {
     this.dispatch(cleanupSelectionState(documentId));
@@ -491,7 +529,6 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     this.pageCallbacks.delete(documentId);
     this.selecting.delete(documentId);
     this.anchor.delete(documentId);
-    this.marqueeEnabled.delete(documentId);
     this.marqueePage.delete(documentId);
     this.selChange$.clearScope(documentId);
     this.textRetrieved$.clearScope(documentId);
@@ -501,6 +538,7 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     this.menuPlacement$.clearScope(documentId);
     this.marqueeChange$.clearScope(documentId);
     this.marqueeEnd$.clearScope(documentId);
+    this.emptySpaceClick$.clearScope(documentId);
   }
   async initialize() {
   }
@@ -513,6 +551,7 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     this.menuPlacement$.clear();
     this.marqueeChange$.clear();
     this.marqueeEnd$.clear();
+    this.emptySpaceClick$.clear();
     super.destroy();
   }
   /* ── capability exposed to UI / other plugins ─────────── */
@@ -532,13 +571,12 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
       getState: (docId) => this.getDocumentState(getDocId(docId)),
       enableForMode: (modeId, options, docId) => {
         var _a;
-        return (_a = this.enabledModesPerDoc.get(getDocId(docId))) == null ? void 0 : _a.set(modeId, { showRects: true, ...options });
+        return (_a = this.enabledModesPerDoc.get(getDocId(docId))) == null ? void 0 : _a.set(modeId, { ...options });
       },
       isEnabledForMode: (modeId, docId) => {
         var _a;
         return ((_a = this.enabledModesPerDoc.get(getDocId(docId))) == null ? void 0 : _a.has(modeId)) ?? false;
       },
-      // Marquee selection
       setMarqueeEnabled: (enabled, docId) => this.setMarqueeEnabled(getDocId(docId), enabled),
       isMarqueeEnabled: (docId) => this.isMarqueeEnabled(getDocId(docId)),
       // Document-scoped operations
@@ -551,7 +589,9 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
       onEndSelection: this.endSelection$.onGlobal,
       // Marquee selection events
       onMarqueeChange: this.marqueeChange$.onGlobal,
-      onMarqueeEnd: this.marqueeEnd$.onGlobal
+      onMarqueeEnd: this.marqueeEnd$.onGlobal,
+      // Empty space click event
+      onEmptySpaceClick: this.emptySpaceClick$.onGlobal
     };
   }
   createSelectionScope(documentId) {
@@ -574,7 +614,8 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
       onBeginSelection: this.beginSelection$.forScope(documentId),
       onEndSelection: this.endSelection$.forScope(documentId),
       onMarqueeChange: this.marqueeChange$.forScope(documentId),
-      onMarqueeEnd: this.marqueeEnd$.forScope(documentId)
+      onMarqueeEnd: this.marqueeEnd$.forScope(documentId),
+      onEmptySpaceClick: this.emptySpaceClick$.forScope(documentId)
     };
   }
   getDocumentState(documentId) {
@@ -620,13 +661,18 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     });
     const textHandler = createTextSelectionHandler({
       getGeometry: () => this.getDocumentState(documentId).geometry[pageIndex],
-      isEnabled: (modeId) => (enabledModes == null ? void 0 : enabledModes.has(modeId)) ?? false,
-      onBegin: (g) => this.beginSelection(documentId, pageIndex, g),
-      onUpdate: (g) => this.updateSelection(documentId, pageIndex, g),
-      onEnd: () => this.endSelection(documentId),
-      onClear: () => this.clearSelection(documentId),
+      isEnabled: (modeId) => {
+        const config = enabledModes == null ? void 0 : enabledModes.get(modeId);
+        if (!config) return false;
+        return config.enableSelection !== false;
+      },
+      onBegin: (g, modeId) => this.beginSelection(documentId, pageIndex, g, modeId),
+      onUpdate: (g, modeId) => this.updateSelection(documentId, pageIndex, g, modeId),
+      onEnd: (modeId) => this.endSelection(documentId, modeId),
+      onClear: (modeId) => this.clearSelection(documentId, modeId),
       isSelecting: () => this.selecting.get(documentId) ?? false,
-      setCursor: (cursor) => cursor ? interactionScope.setCursor("selection-text", cursor, 10) : interactionScope.removeCursor("selection-text")
+      setCursor: (cursor) => cursor ? interactionScope.setCursor("selection-text", cursor, 10) : interactionScope.removeCursor("selection-text"),
+      onEmptySpaceClick: (modeId) => this.emptySpaceClick$.emit(documentId, { pageIndex, modeId })
     });
     const unregisterHandlers = this.interactionManagerCapability.registerAlways({
       scope: { type: "page", documentId, pageIndex },
@@ -640,8 +686,8 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     };
   }
   /**
-   * Register marquee selection on a page. Uses `registerHandlers` with `pointerMode`
-   * only - marquee selection is only active in the default pointer mode.
+   * Register marquee selection on a page. Uses `registerAlways` so any plugin
+   * can enable marquee selection for their mode via `enableForMode({ enableMarquee: true })`.
    */
   registerMarqueeOnPage(opts) {
     var _a;
@@ -678,29 +724,38 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     }
     const pageSize = page.size;
     const minDragPx = ((_a = this.config.marquee) == null ? void 0 : _a.minDragPx) ?? 5;
+    const shouldShowRect = () => {
+      var _a2;
+      const mode = this.interactionManagerCapability.forDocument(documentId).getActiveMode();
+      const config = (_a2 = this.enabledModesPerDoc.get(documentId)) == null ? void 0 : _a2.get(mode);
+      return (config == null ? void 0 : config.showMarqueeRects) !== false;
+    };
     const marqueeHandler = createMarqueeSelectionHandler({
       pageSize,
       scale,
       minDragPx,
-      isEnabled: () => this.marqueeEnabled.get(documentId) !== false,
-      onBegin: (pos) => this.beginMarquee(documentId, pageIndex, pos),
-      onChange: (rect) => {
-        this.updateMarquee(documentId, pageIndex, rect);
-        onRectChange(rect);
+      isEnabled: (modeId) => {
+        var _a2;
+        const config = (_a2 = this.enabledModesPerDoc.get(documentId)) == null ? void 0 : _a2.get(modeId);
+        return (config == null ? void 0 : config.enableMarquee) === true;
       },
-      onEnd: (rect) => {
-        this.endMarquee(documentId, pageIndex, rect);
+      isTextSelecting: () => this.selecting.get(documentId) ?? false,
+      onBegin: (pos, modeId) => this.beginMarquee(documentId, pageIndex, pos, modeId),
+      onChange: (rect, modeId) => {
+        this.updateMarquee(documentId, pageIndex, rect, modeId);
+        onRectChange(shouldShowRect() ? rect : null);
+      },
+      onEnd: (rect, modeId) => {
+        this.endMarquee(documentId, pageIndex, rect, modeId);
         onRectChange(null);
       },
-      onCancel: () => {
-        this.cancelMarquee(documentId);
+      onCancel: (modeId) => {
+        this.cancelMarquee(documentId, modeId);
         onRectChange(null);
       }
     });
-    const unregisterHandlers = this.interactionManagerCapability.registerHandlers({
-      documentId,
-      pageIndex,
-      modeId: "pointerMode",
+    const unregisterHandlers = this.interactionManagerCapability.registerAlways({
+      scope: { type: "page", documentId, pageIndex },
       handlers: marqueeHandler
     });
     return unregisterHandlers;
@@ -726,21 +781,33 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
       isTopVisible: rectTopInView >= 0 && rectTopInView < vpMetrics.clientHeight
     };
   }
+  emitMenuPlacement(documentId, placement) {
+    this.menuPlacement$.emit(documentId, placement);
+    if (placement) {
+      this.interactionManagerCapability.claimPageActivity(
+        documentId,
+        "selection-menu",
+        placement.pageIndex
+      );
+    } else {
+      this.interactionManagerCapability.releasePageActivity(documentId, "selection-menu");
+    }
+  }
   recalculateMenuPlacement(documentId) {
     const docState = this.state.documents[documentId];
     if (!docState) return;
     if (docState.selecting || docState.selection === null) {
-      this.menuPlacement$.emit(documentId, null);
+      this.emitMenuPlacement(documentId, null);
       return;
     }
     const bounds = selectBoundingRectsForAllPages(docState);
     if (bounds.length === 0) {
-      this.menuPlacement$.emit(documentId, null);
+      this.emitMenuPlacement(documentId, null);
       return;
     }
     const tail = bounds[bounds.length - 1];
     if (!this.viewportCapability || !this.scrollCapability) {
-      this.menuPlacement$.emit(documentId, {
+      this.emitMenuPlacement(documentId, {
         pageIndex: tail.page,
         rect: tail.rect,
         spaceAbove: 0,
@@ -759,7 +826,7 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     const headMetrics = this.getPlacementMetrics(documentId, head.page, head.rect, vpMetrics);
     if (tailMetrics) {
       if (tailMetrics.isBottomVisible && tailMetrics.spaceBelow > this.menuHeight) {
-        this.menuPlacement$.emit(documentId, {
+        this.emitMenuPlacement(documentId, {
           ...tailMetrics,
           suggestTop: false,
           isVisible: true
@@ -769,7 +836,7 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     }
     if (headMetrics) {
       if (headMetrics.isTopVisible) {
-        this.menuPlacement$.emit(documentId, {
+        this.emitMenuPlacement(documentId, {
           ...headMetrics,
           suggestTop: true,
           isVisible: true
@@ -778,14 +845,14 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
       }
     }
     if (tailMetrics && tailMetrics.isBottomVisible) {
-      this.menuPlacement$.emit(documentId, {
+      this.emitMenuPlacement(documentId, {
         ...tailMetrics,
         suggestTop: false,
         isVisible: true
       });
       return;
     }
-    this.menuPlacement$.emit(documentId, null);
+    this.emitMenuPlacement(documentId, null);
   }
   notifyPage(documentId, pageIndex) {
     var _a, _b;
@@ -794,7 +861,7 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
       const docState = this.getDocumentState(documentId);
       const mode = this.interactionManagerCapability.forDocument(documentId).getActiveMode();
       const modeConfig = (_b = this.enabledModesPerDoc.get(documentId)) == null ? void 0 : _b.get(mode);
-      const shouldShowRects = modeConfig && modeConfig.showRects !== false;
+      const shouldShowRects = modeConfig && (modeConfig.showSelectionRects ?? modeConfig.showRects) !== false;
       if (shouldShowRects) {
         callback({
           rects: selectRectsForPage(docState, pageIndex),
@@ -829,29 +896,29 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     return this.getNewPageGeometryAndCache(documentId, pageIdx);
   }
   /* ── selection state updates ───────────────────────────── */
-  beginSelection(documentId, page, index) {
+  beginSelection(documentId, page, index, modeId) {
     this.selecting.set(documentId, true);
     this.anchor.set(documentId, { page, index });
     this.dispatch(startSelection(documentId));
-    this.beginSelection$.emit(documentId, { page, index });
+    this.beginSelection$.emit(documentId, { page, index, modeId });
     this.recalculateMenuPlacement(documentId);
   }
-  endSelection(documentId) {
+  endSelection(documentId, modeId) {
     this.selecting.set(documentId, false);
     this.anchor.set(documentId, void 0);
     this.dispatch(endSelection(documentId));
-    this.endSelection$.emit(documentId);
+    this.endSelection$.emit(documentId, { modeId });
     this.recalculateMenuPlacement(documentId);
   }
-  clearSelection(documentId) {
+  clearSelection(documentId, _modeId) {
     this.selecting.set(documentId, false);
     this.anchor.set(documentId, void 0);
     this.dispatch(clearSelection(documentId));
     this.selChange$.emit(documentId, null);
-    this.menuPlacement$.emit(documentId, null);
+    this.emitMenuPlacement(documentId, null);
     this.notifyAllPages(documentId);
   }
-  updateSelection(documentId, page, index) {
+  updateSelection(documentId, page, index, modeId) {
     if (!this.selecting.get(documentId) || !this.anchor.get(documentId)) return;
     const a = this.anchor.get(documentId);
     const forward = page > a.page || page === a.page && index >= a.index;
@@ -927,29 +994,40 @@ const _SelectionPlugin = class _SelectionPlugin extends BasePlugin {
     }, ignore);
   }
   /* ── marquee selection state updates ─────────────────────── */
-  beginMarquee(documentId, pageIndex, _startPos) {
+  beginMarquee(documentId, pageIndex, _startPos, _modeId) {
     this.marqueePage.set(documentId, pageIndex);
   }
-  updateMarquee(documentId, pageIndex, rect) {
-    this.marqueeChange$.emit(documentId, { pageIndex, rect });
+  updateMarquee(documentId, pageIndex, rect, modeId) {
+    this.marqueeChange$.emit(documentId, { pageIndex, rect, modeId });
   }
-  endMarquee(documentId, pageIndex, rect) {
-    this.marqueeEnd$.emit(documentId, { pageIndex, rect });
-    this.marqueeChange$.emit(documentId, { pageIndex, rect: null });
+  endMarquee(documentId, pageIndex, rect, modeId) {
+    this.marqueeEnd$.emit(documentId, { pageIndex, rect, modeId });
+    this.marqueeChange$.emit(documentId, { pageIndex, rect: null, modeId });
     this.marqueePage.delete(documentId);
   }
-  cancelMarquee(documentId) {
+  cancelMarquee(documentId, modeId) {
     const pageIndex = this.marqueePage.get(documentId);
     if (pageIndex !== void 0) {
-      this.marqueeChange$.emit(documentId, { pageIndex, rect: null });
+      this.marqueeChange$.emit(documentId, { pageIndex, rect: null, modeId });
       this.marqueePage.delete(documentId);
     }
   }
+  /** @deprecated — shim for backward compat; delegates to pointerMode config */
   setMarqueeEnabled(documentId, enabled) {
-    this.marqueeEnabled.set(documentId, enabled);
+    const modes = this.enabledModesPerDoc.get(documentId);
+    if (!modes) return;
+    const current = modes.get("pointerMode");
+    if (current) {
+      current.enableMarquee = enabled;
+    } else if (enabled) {
+      modes.set("pointerMode", { enableMarquee: true });
+    }
   }
+  /** @deprecated — shim for backward compat; reads pointerMode config */
   isMarqueeEnabled(documentId) {
-    return this.marqueeEnabled.get(documentId) !== false;
+    var _a;
+    const config = (_a = this.enabledModesPerDoc.get(documentId)) == null ? void 0 : _a.get("pointerMode");
+    return (config == null ? void 0 : config.enableMarquee) !== false;
   }
 };
 _SelectionPlugin.id = "selection";